GitNexus/docs/languages/cobol-ingestion-gaps.md
Gergő Magyar 48f108a58a
docs: simplify guides and verify receiver gaps (#3694)
* docs: align resolution architecture and roadmap

* docs: add language ingestion gap inventories

* test: audit receiver gap targets and coverage

Check exact declaration IDs, expose the Dart await wrong-owner edge, and execute previously excluded C++, Rust, PHP, Dart and Vue shapes. Refresh the baseline and all language inventories from fresh measurements; call-drop counts remain unchanged.

* docs: focus roadmap and shorten project README

Keep the resolution roadmap limited to future work and acceptance criteria. Move detailed editor, CLI, MCP, deployment and wiki instructions into linked guides, preserve their command examples, and correct stale onboarding claims.

* docs: correct setup and audit descriptions

---------

Co-authored-by: Gergo Magyar <gergomagyar0@gmail.com>
2026-10-23 09:06:03 +01:00

5 KiB

COBOL Ingestion Gaps

Audited on 2026-10-23 with freshly built production sources at c35806d24 and the accompanying benchmark changes. See the measurement audit for commands, target checks, exclusions and test limits. Historical reports below remain separate from freshly measured receiver cases; broader ingestion is not exhaustively assessed.

Receiver shape snapshot

States below come from baseline.json. The harness defines each spelling and its N/A reason. RESOLVES requires the exact expected declaration ID and no same-named call to a different owner. WRONG-TARGET records incorrect edges.

Shape Recorded state Expression or exclusion
plainChain N/A The COBOL provider models structural/procedure-pointer calls, not object-oriented receiver chains; those calls have separate integration coverage.
plainDeepChain N/A The COBOL provider models structural/procedure-pointer calls, not object-oriented receiver chains; those calls have separate integration coverage.
optionalChain N/A The COBOL provider models structural/procedure-pointer calls, not object-oriented receiver chains; those calls have separate integration coverage.
nonNullAssert N/A The COBOL provider models structural/procedure-pointer calls, not object-oriented receiver chains; those calls have separate integration coverage.
awaitParen N/A The COBOL provider models structural/procedure-pointer calls, not object-oriented receiver chains; those calls have separate integration coverage.
explicitTypeArgs N/A The COBOL provider models structural/procedure-pointer calls, not object-oriented receiver chains; those calls have separate integration coverage.
indexElement N/A The COBOL provider models structural/procedure-pointer calls, not object-oriented receiver chains; those calls have separate integration coverage.
fieldReceiverCall N/A The COBOL provider models structural/procedure-pointer calls, not object-oriented receiver chains; those calls have separate integration coverage.
decoratedReceiverBase N/A The COBOL provider models structural/procedure-pointer calls, not object-oriented receiver chains; those calls have separate integration coverage.
decoratedFieldType N/A The COBOL provider models structural/procedure-pointer calls, not object-oriented receiver chains; those calls have separate integration coverage.

The receiver benchmark marks COBOL N/A because its emitter has no method-call receiver chains. The registered resolver uses scopeResolutionEdgeMode: callable-flow-only: it contributes procedure-pointer CALLS while the established COBOL processor owns structural CALLS and IMPORTS.

Planning candidates

ID Evidence Gap or boundary Next planning step and acceptance
COBOL-01 Coverage gap OO receiver shapes do not measure COBOL call resolution. Inventory direct CALL, procedure-pointer, PERFORM and COPY cases against the existing suites; add a measurement only where coverage is missing.
COBOL-02 Boundary audit Structural and callable-flow edges have separate production owners. Compare exact target identities, qualified data names and duplicate program names. Assert neither path introduces duplicate or unjustified call edges.

Code and regression entry points

Evidence details: receiver baseline notes and current roadmap.