fix(perl-lsp): surface resolved method/static calls as graph CALLS edges

- Add method_call_expression to perl_call_types in lang_specs.c so the
  structural tier emits a method-call edge for the LSP bridge to refine
  (parity with PHP member_call_expression). callee_name is the bare method
  via the field-based extractor's `method` branch.
- Normalize the textual callee in cbm_pipeline_find_lsp_resolution to its
  last "::"-separated segment so qualified static Pkg::sub() calls match the
  resolved sub's dotted short-name (parity with PHP scoped_call_expression).
- Zero-edge guarantee preserved: untyped receivers still emit no edge.

Resolves DEVN-04 from plan 22-03. Verified on a Base/Derived/main fixture:
run_typed->{greet,describe}, run_static->helper, run_classcall->greet,
describe->greet (inherited), run_untyped->none.

Signed-off-by: Shane McCarron <shane.mccarron@corvexconnect.com>

.vbw-planning/phases/22-perl-lsp-semantic-resolution/22-03-SUMMARY.md

@@ -0,0 +1,91 @@
+---
+phase: 22
+plan: 03
+title: Core semantic resolution (package, sub, method, ISA, bless, exports)
+status: complete
+tasks_completed: 5
+tasks_total: 5
+commit_hashes:
+  - 69d9025 # feat(perl-lsp): implement core semantic resolution (package/sub/method/ISA/bless/exports)
+files_modified:
+  - internal/cbm/lsp/perl_lsp.c
+branch: perl-lsp-semantic-resolution
+build_status: green   # scripts/build.sh exit 0, binary at build/c/codebase-memory-mcp
+test_status: green-except-preexisting  # scripts/test.sh: 3553 passed, 1 pre-existing failure (DEVN-05)
+clang_format: clean   # CommandLineTools clang-format --dry-run --Werror, no diff
+ac_results:
+  - truth: "perl_lsp_process_file does a two-pass walk: (1) package_statement + use_statement collection, (2) subroutine_declaration_statement processing"
+    result: pass
+  - truth: "Method calls ($obj->m, Class->m, $self->m) and Package::sub() calls resolve to CBMResolvedCall edges"
+    result: pass
+  - truth: "MRO is resolved via @ISA assignment, use parent, and use base"
+    result: pass
+  - truth: "bless($ref,'Class') and the ref($class)||$class idiom bind a variable to a package type"
+    result: pass
+  - truth: "perl_eval_expr_type is recursion-guarded via eval_depth (cap mirrors php_eval_expr_type)"
+    result: pass
+  - truth: "Unresolvable receivers emit NO spurious edge (mirrors phplsp_unindexed_receiver_emits_block)"
+    result: pass
+pre_existing_issues:
+  - '{"test": "search_code_multi_word", "file": "tests/test_mcp.c", "error": "tests/test_mcp.c:694 ASSERT(strstr(resp, \"HandleRequest\") != NULL) failed — multi-word search-code MCP test; unrelated to Perl LSP and not in this plan''s file set (DEVN-05 pre-existing, identical to plan 22-01/02 baseline)"}'
+deviations:
+  - "DEVN-05 (pre-existing): scripts/test.sh reports 3553 passed / 1 failed, identical to the plan 22-01/02 baseline. The single failure is search_code_multi_word (tests/test_mcp.c:694), an MCP search-code test unrelated to the Perl LSP. Out of scope; not fixed."
+  - "DEVN-01 (minor): the plan lists 5 tasks all editing the single file perl_lsp.c with deeply interdependent functions (process_subroutine calls eval_expr_type and the call/method dispatch; the entry point wires all of them). Splitting into 5 commits would produce non-compiling intermediate states, violating the build-green-per-commit invariant. Delivered as ONE atomic commit for the cohesive resolver. All five tasks' functionality is present and individually verified end-to-end against a multi-package fixture."
+  - "DEVN-04 (architectural, downstream — flagged for orchestrator): the resolver correctly POPULATES result->resolved_calls for typed method calls ($obj->m, Class->m, $self->m) and Package::sub() — verified empirically (7 correct CBMResolvedCall entries on the Base/Derived/main fixture, zero on unresolvable receivers). HOWEVER, those resolved method-call edges do not currently surface as graph CALLS edges because the pipeline bridge (src/pipeline/pass_calls.c / pass_parallel.c via cbm_pipeline_find_lsp_resolution) only refines EXISTING structural call edges, and `method_call_expression` is NOT in perl_call_types in internal/cbm/lang_specs.c (line 542) — so the structural tier never emits a method-call edge for the bridge to attach to. Adding `method_call_expression` (and optionally a Package::sub callee-name normalization) to lang_specs.c is required for typed method-call edges to appear in the graph, but lang_specs.c is OUTSIDE this plan's allowed_paths (files_modified: [internal/cbm/lsp/perl_lsp.c] only). The plan's must-have truths and verification are framed around CBMResolvedCall emission, which is fully satisfied; the graph-edge surfacing is a one-line structural-tier follow-up that a subsequent plan (with lang_specs.c in scope) should make. Static Package::sub() calls ARE structural calls, but their structural callee_name is the qualified `Pkg::sub` while the bridge compares the last dot-segment of the resolved callee_qn — that normalization also belongs with the lang_specs follow-up."
+  - "DEVN-04 RESOLVED (follow-up fix, 2026-06-13): the two graph-surfacing gaps above are now closed in a dedicated follow-up commit. (1) `method_call_expression` added to perl_call_types in internal/cbm/lang_specs.c so the structural tier emits a method-call edge (callee_name = bare method, via the field-based extractor's `method` branch) for the bridge to attach the LSP resolution to. (2) cbm_pipeline_find_lsp_resolution in src/pipeline/lsp_resolve.h now reduces the textual callee_name to its last `::`-separated segment before comparing, so qualified static `Pkg::sub()` calls match the resolved sub's short name. Verified on a fresh Base/Derived/main fixture: trace_path outbound now shows run_typed->{greet,describe}, run_static->helper, run_classcall->greet, describe->greet (inherited Base::greet), while run_untyped (untyped `$thing->mystery()` / `$unknown->whatever()`) yields ZERO edges — zero-edge guarantee preserved. Build green; scripts/test.sh 3553 passed / 1 pre-existing failure (search_code_multi_word, DEVN-05)."
+---
+
+## What Was Built
+
+Replaced the plan-01 no-op `perl_lsp_process_file` / stub helpers with the full
+Perl Light Semantic Pass inside `perl_lsp.c`, mirroring `php_lsp.c`'s resolution
+architecture (only `perl_lsp.c` modified — disjoint from plan-02's stdlib seed).
+
+Resolution scenarios implemented and verified end-to-end (indexed a
+Base/Derived/main multi-package fixture with `CBM_LSP_DEBUG=1` and confirmed the
+emitted `CBMResolvedCall` set):
+
+- **Two-pass process_file.** PASS 1 walks the file for `package_statement`
+  boundaries (packages can switch mid-file), `@ISA` assignments, `use parent` /
+  `use base` inheritance, and Exporter `use Module qw(f1 f2)` imports
+  (f1 → Module::f1). PASS 2 walks each `subroutine_declaration_statement`.
+- **process_subroutine + invocant binding.** Pushes a scope, sets
+  `enclosing_func_qn = module_qn.subname` (the structural QN scheme, verified
+  against `helpers.c cbm_enclosing_func_qn` — Perl has no class node type so the
+  package is not woven into the sub QN), and binds the `$self`/`$class` invocant
+  (`my $X = shift` idiom) to the enclosing package type.
+- **perl_eval_expr_type (sigil-aware, recursion-guarded).** Scalar scope lookup;
+  `method_call_expression` and `function_call_expression` dispatch;
+  `bless($r,'Class')` literal recognition (conf 0.95) and the
+  `ref($class)||$class` / bare `$class` idiom → enclosing package (conf 0.75);
+  assignment-RHS propagation; `ClassName->new` → `ClassName`. Guarded by
+  `eval_depth` (cap 8, mirroring php).
+- **@ISA / use parent / use base MRO.** All three forms feed a per-package
+  `CBMRegisteredType.embedded_types` (multiple inheritance as a `const char**`
+  array); `perl_lookup_method` walks the chain depth-first with cycle detection,
+  bounded by `CBM_LSP_MAX_LOOKUP_DEPTH`.
+- **Call/method dispatch + emit.** `Package::sub()` static, bare/imported
+  `func()`, and typed-receiver `$obj->m` / `Class->m` / `$self->m` push
+  `CBMResolvedCall` via `cbm_resolvedcall_push`. Unresolvable receivers emit NO
+  edge (zero-edge guarantee verified: 0 resolved on a fixture with an untyped
+  `$x->bar()` and `$unknown->baz()`); symbol-table aliasing is ignored.
+
+Tree-sitter-perl node/field names (Open Questions #1–3) were verified against
+the vendored compiled grammar `internal/cbm/vendored/grammars/perl/parser.c`
+(`ts_symbol_names` + `ts_field_names` tables; no node-types.json/grammar.js is
+vendored). Confirmed and documented in a file-header comment:
+`method_call_expression` → fields `invocant` + `method`; `package_statement` →
+field `name`; `use_statement` → field `module` + `quoted_word_list`;
+`variable_declaration` target → field `variable` (singular, not `variables`);
+`bless`/parent args nest inside `list_expression`.
+
+Build green; `scripts/test.sh` reports 3553 passed with the single pre-existing
+unrelated failure noted above; `perl_lsp.c` is clang-format clean.
+
+## Files Modified
+
+- `internal/cbm/lsp/perl_lsp.c` — full resolver (process_file two-pass walk,
+  process_subroutine + $self/$class binding, sigil-aware recursion-guarded
+  perl_eval_expr_type with bless/new, @ISA/parent/base detection, perl_lookup_method
+  MRO walk, Exporter import map, function/method call dispatch + perl_emit_resolved,
+  per-package type + method-table construction), replacing the plan-01 no-op stubs.

src/pipeline/lsp_resolve.h

@@ -124,6 +124,9 @@ static inline int cbm_pipeline_qn_class_method_tail_eq(const char *qn, const cha
  *   3. ambiguous tails return NULL so the registry fallback stays in
  *      control.
  *
+ * Qualified static callees (e.g. Perl `Pkg::sub`) are reduced to their
+ * bare last segment by cbm_lsp_bare_segment before matching.
+ *
  * The pointer returned aliases into `arr` and stays valid as long as the
  * underlying CBMFileResult is alive. */
 static inline const CBMResolvedCall *cbm_pipeline_find_lsp_resolution(