internal/

Package bench measures what the MCP surface costs and whether it works: it drives a complete lifecycle over a generated fixture workspace through the REAL tool surface and meters every result byte, then verifies the workspace actually reached the states the workflow promises.

Package benchmark implements the first-class benchmark record type (P-01KYJMVX2Q): entries compare implementations against each other on a FRAME SYSTEM, keyed uniquely by canonicalized name+frame, with bounded per-key version history (default 1 — the latest is what the codebase cares about; benchmarks.history raises it).

Package budget implements token estimation, record-boundary truncation and resume cursors.

Package cache is the local, NON-versioned index at .spectackle/cache/index.db (pure-Go SQLite via modernc.org/sqlite, FTS5).

Package coord is the shared multi-agent coordination DB — the "swarm brain".

Package cspan implements the brace-counting body-span scanner shared by internal/langspec (the primary parsing pass) and internal/resolve (the FFI bridging resolver).

Package drift binds EARS rules to code spans and detects when either side moves out from under the other.

Package ears implements the semantic pillar: classification and linting of requirements written in EARS (Easy Approach to Requirements Syntax).

Package evidence computes review evidence the author cannot fake, scoped to an item's declared targets (T-01KYD88KE): the B-0009 class (exported, declared, never consumed) and the B-0003 class (one call site diverging from twenty siblings).

Package forge is spectackle's one seam onto a pull-request host: open a draft PR for a branch, flip it ready, merge it, or find the one already open for a branch — nothing else.

Package graph holds the cross-language symbol graph: nodes are symbols (functions, types, kernels, asm procedures), edges are structural or cross-language binding relations.

Package ids defines the minting and validation rules for the two kinds of identifier the system hands to an LLM: node IDs for code symbols and record IDs for lifecycle records.

Package ignore answers "is this repo-relative path gitignored" by asking git, not by reimplementing gitignore.

Package index defines the indexing pipeline: walk -> hash -> parse (per language) -> resolve cross-language bindings -> populate the graph.

Package item persists lifecycle items (proposals, tasks, bugs, research) as `##`-anchored blocks in the per-context work.md — ACTIVE items only.

Package journal is the append-only event log — one journal.ndjson per .spectackle folder, one JSON object per line.

Package knowledge lifts the reusable part of one repository's spec/item corpus into a portable artifact, and condenses several such artifacts into one.

Package langspec is a data-driven framework for line-oriented language parsers: a language is defined by exactly one Spec value (a set of regex Defs plus a qualification mode), not by a new Go type.

Package lifecycle implements the item state machine and its persistence effects.

Package mcpclient is spectackle's own MCP client: it lets the binary make a headless tool call against a spectackle server (spawned over stdio, or a resident server reached over Streamable HTTP) without an external wrapper script (CLI-002).

Package mcpserver exposes spectackle over the Model Context Protocol.

Package migrate upgrades a .spectackle workspace from an older schema stamp to the current one, in place, when the workspace is opened.

Package plan9 scans Plan 9 assembly (Go's asm dialect) source for TEXT and GLOBL symbol definitions.

Package relnotes derives release notes from the journal's archive tombstones (T-01KYGCJ6): the archive note is the training signal, and here it doubles as the change log — no hand-written drift by construction.

Package replay merges a worktree's .spectackle state onto main SEMANTICALLY: journal events are the operation log (CRDT-style), main's spec.md/work.md are materialized views, and replay re-applies the worktree's event delta through the same code paths the tools use.

Package resolve defines the cross-language binding resolvers — the piece that turns per-language symbol islands into one connected graph.

Package spec implements the topological pillar: cascading, directory-scoped spec bundles.

Package store defines the content-hash-keyed persistent cache used by the indexer to skip re-parsing unchanged files.

Package sync keeps the non-versioned cache consistent with the versioned .spectackle files (which are the source of truth).

Package workspace implements root detection and the .spectackle folder contract: every file the server writes lives inside a .spectackle/ folder (root or nested context dirs); the rest of the workspace is never touched.

Package wt wraps the git operations behind worktree orchestration.