Skip to content

docs(language-status): add agc_assembly coverage doc - #1947

Merged
squid-protocol merged 2 commits into
mainfrom
docs/language-status-agc-assembly
Aug 20, 2026
Merged

docs(language-status): add agc_assembly coverage doc#1947
squid-protocol merged 2 commits into
mainfrom
docs/language-status-agc-assembly

Conversation

@squid-protocol

Copy link
Copy Markdown
Owner

Summary

  • Adds docs/language_status/agc_assembly.md (sections 1-8, following the language-status skill's structure) — the first status doc for a Phase-1-through-5-wired historical/esoteric language in this series (abap, c, cobol, javascript, python already done).
  • Marks agc_assembly's row **written** with a link in docs/language_status/README.md's index table.

Notable findings while gathering material

  • 39/48 rule keys wired. Of the 9 None keys, only class_start has an inline rationale comment ("AGC lacks native objects" — assembly has no OO/class construct at all). The other 8 (closures, decorators, generics, comprehensions, ssr_boundaries, dependency_injection, inline_asm, test_skip) have no comment; the doc states plainly why each doesn't apply to hardware-level 1960s assembly.
  • No known_limitation-named tests exist for this language in either test file — the doc says so explicitly rather than omitting the section.
  • 231 dedicated tests (155 extraction-gauntlet + 76 strict), both fully migrated to per-language files — no leftover cases in the old monolithic gauntlet dicts.
  • Real-world evidence exists, contrary to the "possibly nothing AGC-specific" expectation going in: gitgalaxy-raw-output's v2.4.7/Apollo-11/ is a real scan of chrislgarry/Apollo-11 (74,063 LOC, Luminary 099 + Comanche 055 program listings). The local language-crucible/data/agc_assembly/apollo-11/ corpus (10 real .agc files) is documented as the second, complementary evidence source — the same corpus the extraction-hardening PRs (Fix #572: Strict parsing tests for agc_assembly structural signatures #743, test(extraction): harden agc_assembly extraction coverage (#857) #931) used for their before/after validation.
  • §7 turned up a real cross-file bug not specific to agc_assembly's own rules: detector.py's MAX_SATELLITES = 250 cap (bug(core): MAX_SATELLITES cap silently truncates function extraction in dense files #1054, fixed by fix(core): remove MAX_SATELLITES cap on function extraction #1063) had silently frozen the function count of agc_assembly's own apollo-11/PINBALL_GAME_BUTTONS_AND_LIGHTS.agc at exactly 250 — one of only 5 files across the whole ~935-file corpus that ever hit it.

Section 9 (measured accuracy vs. ctags — agc_assembly has no tree-sitter grammar) is intentionally left out; a separate tri-comparison-ledger-sweep investigation is producing it directly and will append it to this file afterward.

Test plan

  • Documentation-only change (no parsing logic touched) — crucible_check.py/audit_check.py not required per repo convention.
  • Verified rule-key wired/total count (39/48) and both test-file collection counts (155, 76) directly against current main.

Co-Authored-By: Claude Sonnet 5 noreply@anthropic.com

squid-protocol and others added 2 commits August 20, 2026 14:51
Adds docs/language_status/agc_assembly.md (sections 1-8, per the
language-status skill) and marks agc_assembly written in the README
index. Section 9 (measured accuracy vs. ctags) is being produced
separately via the tri-comparison-ledger-sweep investigation and will
be appended after this lands.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Appends the measured tri-comparison section left open for the parallel
tri-comparison-ledger-sweep investigation: GitGalaxy vs. ctags (agc_assembly
has no tree-sitter grammar). Summarizes the two validated ledger shapes --
GitGalaxy's confirmed win on hyphenated/digit-leading AGC label syntax ctags'
generic Asm parser can't tag, and the mixed-cause ctags-solo shape (genuine
data-label-vs-code-label precision distinction plus a real detector.py bug).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

🐦‍⬛ Muninn Security Scan

✅ No security issues found.

🐦‍⬛ Powered by Muninn · Skald Lab

@squid-protocol
squid-protocol merged commit 0b6da5f into main Aug 20, 2026
2 checks passed
@squid-protocol
squid-protocol deleted the docs/language-status-agc-assembly branch August 20, 2026 18:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant