@spikedpunch/mast 0.1.0

package/dist/ast/types.d.ts

@@ -0,0 +1,586 @@
+/** All domain types shared across MAST subsystems. */
+export type ChunkType = 'function' | 'method' | 'class_shell' | 'interface' | 'type' | 'export' | 'block'
+/** Markdown document section (heading-based chunking, §10.1). */
+ | 'doc';
+export type Language = 'typescript' | 'javascript' | 'markdown';
+/**
+ * A single indexed code chunk — maps to one AST declaration (or a sub-chunk
+ * when the declaration exceeds `chunk_split_threshold` lines).
+ *
+ * `start_line` / `end_line` always reflect AST declaration boundaries.
+ * `content` may extend `context_lines` beyond those boundaries for display.
+ */
+export interface Chunk {
+    readonly chunk_id: string;
+    readonly file_path: string;
+    readonly start_line: number;
+    readonly end_line: number;
+    readonly content: string;
+    readonly chunk_type: ChunkType;
+    readonly symbol_name: string | null;
+    /** Enclosing class name for `method` chunks; null for all others. */
+    readonly parent_symbol: string | null;
+    readonly is_exported: boolean;
+    readonly language: Language;
+    readonly file_mtime: number;
+    /**
+     * sha256 of the symbol's signature (declaration up to, not including, the
+     * body). Transient: computed from the AST during extraction and consumed by
+     * `symbolsFromChunks`; NOT persisted to chunks.lance. Undefined on
+     * `block` chunks and on chunks reconstructed from the store.
+     */
+    readonly declaration_hash?: string;
+    /**
+     * sha256 of the symbol's body. For `class_shell`, the sorted member
+     * signatures (no method bodies), per §10.1. Transient — see `declaration_hash`.
+     */
+    readonly body_hash?: string;
+}
+/** Stability hashes stored per chunk for incremental reindex optimisation. */
+export interface ChunkHashes {
+    readonly chunk_id: string;
+    /** sha256 of signature text only (excludes body). */
+    readonly declaration_hash: string;
+    /** sha256 of body text; for class_shell, over sorted member signatures. */
+    readonly body_hash: string;
+}
+export interface SymbolRecord {
+    readonly name: string;
+    /** `function | class | interface | type | const | method` */
+    readonly kind: string;
+    readonly line: number;
+    readonly isExported: boolean;
+    /** sha256 of signature text only (excludes body). */
+    readonly declarationHash: string | null;
+    /** sha256 of body text; for class_shell, over sorted member signatures. */
+    readonly bodyHash: string | null;
+}
+export interface ImportRecord {
+    readonly module: string;
+    readonly symbols: readonly string[];
+    readonly isExternal: boolean;
+    /** Resolved relative path for intra-monorepo imports; null for external. */
+    readonly resolvedPath: string | null;
+}
+export interface EdgeRecord {
+    readonly fromName: string;
+    readonly toName: string;
+    readonly edgeType: string;
+    /** How a POTENTIAL_CALL receiver was statically linked (§10.3.1). */
+    readonly resolution?: CallerResolution;
+    /** 1-indexed source line of the call site (POTENTIAL_CALL only). */
+    readonly callLine?: number;
+    /** Trimmed source text of the call-site line (POTENTIAL_CALL only). */
+    readonly context?: string;
+    /**
+     * RE_EXPORTS only: the re-export's own module specifier resolved to a real
+     * indexed file (null for an external/unresolvable module). This is the file
+     * evidence `insertEdges` must use to pick the target when two files export a
+     * same-named symbol — without it, resolution falls back to a bare-name match
+     * across the whole graph, which races on insertion order (the RE_EXPORTS
+     * sibling of the POTENTIAL_CALL false-green fixed in `populate.ts`;
+     * IMPLEMENTATION_PLAN_VEXP.md §P, "Sibling false-green"). Undefined for
+     * every other edge type.
+     */
+    readonly toResolvedPath?: string | null;
+}
+export interface MastConfig {
+    readonly state_dir: string;
+    readonly project_root: string;
+    readonly file_extensions: readonly string[];
+    readonly exclude_patterns: readonly string[];
+    /** Reciprocal Rank Fusion constant k (default 60). */
+    readonly rrf_k: number;
+    /**
+     * F18 kill-switch (M2 decision memo condition 3): fuses the declaration-exact
+     * ranker (ranker D, `src/search/declex.ts`) into `mast_search` ranking as a
+     * third RRF input. Default true. Set false to restore pre-F18 ranking
+     * without a code change.
+     */
+    readonly declaration_exact_ranker: boolean;
+    /** Lines above which a declaration is split into overlapping sub-chunks. */
+    readonly chunk_split_threshold: number;
+    /** Source lines before/after AST boundaries included in stored content. */
+    readonly context_lines: number;
+    /**
+     * Maximum ATX heading level that starts a new markdown doc chunk (§10.1).
+     * Headings deeper than this fold into their enclosing section. Default 2 —
+     * "one chunk per `##` section".
+     */
+    readonly markdown_heading_depth: number;
+}
+export interface IndexMeta {
+    schema_version: string;
+    last_indexed: string | null;
+    file_count: number;
+    chunk_count: number;
+    parse_errors?: number;
+    write_errors?: number;
+    seed_commit?: string;
+}
+/** Attached to every read-tool response to track token savings. */
+export interface ToolStats {
+    readonly tool: string;
+    readonly tokens_returned: number;
+    readonly tokens_full_file_upper_bound: number;
+    readonly files_referenced: readonly string[];
+    /** 1 - (tokens_returned / tokens_full_file_upper_bound) */
+    readonly efficiency_ratio: number;
+    readonly duration_ms: number;
+}
+export interface SearchInput {
+    readonly query: string;
+    readonly limit?: number;
+    readonly language?: Language | null;
+    readonly file_pattern?: string | null;
+    readonly chunk_type?: ChunkType | null;
+    readonly only_exported?: boolean;
+}
+/**
+ * Presentation hint attached by the post-RRF shell/method dedup pass
+ * (§9 mast_search). Exactly one shape:
+ * - a surviving `method` whose class shell was suppressed carries
+ *   `{ parent_symbol }` — "the class outline also matched";
+ * - a surviving `class_shell` whose methods were suppressed carries
+ *   `{ methods_matched }` — the qualified method names that also matched.
+ */
+export type RelatedHint = {
+    readonly parent_symbol: string;
+} | {
+    readonly methods_matched: readonly string[];
+};
+export interface SearchResult {
+    readonly file_path: string;
+    readonly start_line: number;
+    readonly end_line: number;
+    readonly content: string;
+    readonly chunk_type: ChunkType;
+    readonly symbol_name: string | null;
+    readonly parent_symbol: string | null;
+    readonly is_exported: boolean;
+    readonly match_score: number | null;
+    readonly rank: number;
+    readonly match_snippet: string | null;
+    /** Present only when the shell/method dedup pass suppressed a counterpart. */
+    readonly related?: RelatedHint;
+    /**
+     * Stat-and-flag staleness (F7, split into its own field by C1). Set when
+     * this result's `file_path` stat'd newer-on-disk than its indexed mtime,
+     * or the stat failed (file deleted/renamed) — `mast_search` can return
+     * results spanning dozens of files, so unlike the single-file JIT-refresh
+     * tools (whose `file_busy_returning_stale_cache` field means a refresh was
+     * ATTEMPTED and lost to contention) no refresh is ever attempted here: no
+     * lock is taken, no re-parse happens, only a `statSync`. Treat this
+     * result's line coordinates as untrustworthy until a `mast_reindex` call,
+     * or any JIT-refreshing tool call against the file, heals it — staleness
+     * is NOT self-healing across repeated `mast_search` calls on its own.
+     * Omitted when false, never present-and-false. See MAST_SPEC.md §9.0's
+     * "Confidence signals (C1)" table for how this relates to the other
+     * confidence fields.
+     */
+    readonly stale?: true;
+}
+/**
+ * A "did you mean" candidate surfaced when a search returns no results.
+ * Advisory only — suggestions are never counted as results (§9 mast_search).
+ */
+export interface SearchSuggestion {
+    readonly symbol: string;
+    readonly file_path: string;
+    /**
+     * Why this symbol is a candidate — e.g. "similar symbol name",
+     * "matched split query terms", "identifier near-miss".
+     */
+    readonly reason: string;
+}
+export interface SearchResponse {
+    readonly results: readonly SearchResult[];
+    /**
+     * Present (possibly empty) only when `results` is empty — the zero-result
+     * assist path ran. Omitted entirely when results were found.
+     */
+    readonly suggestions?: readonly SearchSuggestion[];
+    /**
+     * M6 (`eval/GITNEXUS_COMPARISON.md` §13.8 item 4, MAST_SPEC.md §9.0 "Empty-index
+     * signal"). Present (`true`) only when the primary result set (`results`
+     * here) came back empty AND the `chunks` table has zero rows at that
+     * moment — i.e. this response's emptiness is explained (at least in part)
+     * by "nothing is indexed yet, or you pointed at the wrong state dir", not
+     * merely "no match". An ordinary zero-result query against a populated
+     * index never carries this flag. Independent of `suggestions` — a truly
+     * empty index yields no suggestions either, but the two fields are not
+     * coupled; either may be present without the other. Omitted entirely when
+     * false, never present-and-false (the `stale` field's omitted-when-false
+     * convention, §9.0). Computed by `mcp/tools/_helpers.ts`'s `isIndexEmpty`,
+     * called only on the empty-result path so a non-empty response pays
+     * nothing extra.
+     */
+    readonly index_empty?: true;
+    readonly _stats: ToolStats;
+}
+export interface ProjectSkeletonInput {
+    readonly directory?: string | null;
+    readonly max_depth?: number;
+    readonly file_pattern?: string | null;
+}
+export interface FileSkeleton {
+    readonly file_path: string;
+    readonly exports: readonly string[];
+}
+export interface ProjectSkeletonResponse {
+    readonly files: readonly FileSkeleton[];
+    /** @see {@link SearchResponse.index_empty} — same empty-index signal, keyed on `files`. */
+    readonly index_empty?: true;
+    readonly _stats: ToolStats;
+}
+export interface ExportsInput {
+    readonly file_path: string;
+}
+export interface ExportEntry {
+    readonly name: string;
+    readonly kind: string;
+    readonly signature: string;
+    readonly line: number;
+    readonly doc: string | null;
+}
+export interface ExportsResponse {
+    readonly file_path: string;
+    readonly exports: readonly ExportEntry[];
+    /**
+     * §9.0 TOCTOU policy. `mast_exports` describes exactly one file and JITs it
+     * with a single `checkAndRefreshIfStale` call, so staleness is a property
+     * of the whole response, not of any one `ExportEntry` — set here rather
+     * than per-entry. Present (`true`) only when the file was stale and the
+     * JIT re-parse could not acquire `structure.lock`; omitted otherwise.
+     */
+    readonly file_busy_returning_stale_cache?: true;
+    /** @see {@link SearchResponse.index_empty} — same empty-index signal, keyed on `exports`. */
+    readonly index_empty?: true;
+    readonly _stats: ToolStats;
+}
+export interface SignatureInput {
+    readonly symbol: string;
+    readonly file_path?: string | null;
+}
+export interface ParamEntry {
+    readonly name: string;
+    readonly type: string;
+}
+export interface TypeContextEntry {
+    readonly name: string;
+    readonly signature: string;
+    readonly file_path: string;
+    readonly line: number;
+    readonly truncated: boolean;
+}
+export interface SignatureResult {
+    readonly symbol: string;
+    readonly file_path: string;
+    readonly line: number;
+    readonly signature: string;
+    readonly doc: string | null;
+    readonly params: readonly ParamEntry[];
+    readonly return_type: string | null;
+    readonly type_context: readonly TypeContextEntry[];
+    readonly file_busy_returning_stale_cache?: true;
+}
+export interface SignatureResponse {
+    readonly results: readonly SignatureResult[];
+    /**
+     * §9.0 TOCTOU policy, empty-result case (F14). The busy signal normally
+     * rides on each {@link SignatureResult}; with zero results it has no
+     * carrier, and "no results" from a stale, un-refreshable file would read
+     * as "symbol doesn't exist". Present (`true`) only when a
+     * `file_path`-narrowed query returned no results AND that file's JIT
+     * re-parse could not acquire `structure.lock`; omitted otherwise —
+     * non-empty responses carry the flag per-result, never here.
+     */
+    readonly file_busy_returning_stale_cache?: true;
+    /** @see {@link SearchResponse.index_empty} — same empty-index signal, keyed on `results`. Independent of the `file_busy_returning_stale_cache` envelope flag above; either, both, or neither may be present. */
+    readonly index_empty?: true;
+    readonly _stats: ToolStats;
+}
+export interface CallersInput {
+    readonly symbol: string;
+    readonly file_path?: string | null;
+    readonly transitive?: boolean;
+    readonly include_potential?: boolean;
+}
+export type CallerResolution = 'import' | 'field_type' | 'parameter_type' | 'new_expression' | 'same_file'
+/**
+ * Additive (Stage 1.2, `mast index --checker`): the tree-sitter heuristic
+ * left this call site as a `potential_match` (no static resolution rule
+ * applied), and an opt-in TypeScript-checker pass resolved it to the
+ * queried declaration via `ts.TypeChecker.getSymbolAtLocation` (following
+ * alias chains). See MAST_SPEC §10.3.2.
+ */
+ | 'checker'
+/**
+ * Additive (F4, Stage 3): `this.foo()` inside a class method body,
+ * resolved to the enclosing class's qualified method via a receiver
+ * binding seeded per method (`emitClassEdges`), not inference. Excludes
+ * calls inside a nested non-arrow function/generator body — those have
+ * their own dynamic `this` and are never seeded (§10.3.1). See
+ * MAST_SPEC.md §10.3.1 "Method calls on super and this".
+ */
+ | 'this_method'
+/**
+ * Additive (F4, Stage 3): `super.foo()` inside a class method body,
+ * resolved to the parent class named in the `extends` clause. Only seeded
+ * when an `extends` clause exists; a class with no parent never produces
+ * this resolution (falls to the `identifier_fts` potential set instead).
+ * See MAST_SPEC.md §10.3.1 "Method calls on super and this".
+ */
+ | 'super_method';
+export interface VerifiedCaller {
+    readonly file_path: string;
+    readonly line: number;
+    readonly caller_symbol: string;
+    readonly context: string;
+    readonly resolution: CallerResolution;
+    readonly file_busy_returning_stale_cache?: true;
+}
+export interface PotentialMatch {
+    readonly file_path: string;
+    readonly line: number;
+    readonly context: string;
+    readonly reason: 'identifier_match_no_resolved_edge';
+}
+export interface CallersResponse {
+    readonly verified_callers: readonly VerifiedCaller[];
+    readonly potential_matches: readonly PotentialMatch[];
+    /**
+     * §9.0 TOCTOU policy. `mast_callers` JITs only the FILE THAT DECLARES the
+     * queried symbol (when `file_path` disambiguates it) — not the files each
+     * caller lives in. Staleness there means the target-symbol resolution
+     * itself may be stale, which taints the whole response (which edges were
+     * even considered), not one caller's line number. That is a different
+     * file than `VerifiedCaller.file_path`, so `VerifiedCaller`'s own
+     * (currently unused) per-entry flag would misleadingly imply the CALLER's
+     * file is stale — set here at the envelope instead. Present (`true`) only
+     * when that JIT re-parse could not acquire `structure.lock`.
+     */
+    readonly file_busy_returning_stale_cache?: true;
+    /** @see {@link SearchResponse.index_empty} — same empty-index signal; set only when BOTH `verified_callers` and `potential_matches` are empty. */
+    readonly index_empty?: true;
+    readonly summary: {
+        readonly verified_count: number;
+        readonly potential_count: number;
+        readonly transitive: boolean;
+        /**
+         * Candidates the checker pass classified as NOT a call site (comment,
+         * string, or type position) and dropped out of `potential_matches` —
+         * additive, always 0 when `mast index --checker` has never run.
+         */
+        readonly checker_classified_non_call_site: number;
+        /**
+         * Candidates the checker pass resolved to a DIFFERENT declaration (a
+         * same-name collision) and dropped out of `potential_matches` — additive,
+         * always 0 when `mast index --checker` has never run.
+         */
+        readonly checker_classified_different_declaration: number;
+        /**
+         * F10 (Stage 3): present ONLY when the raw `identifier_fts` match count
+         * for this symbol exceeded the capped fetch (50 entries) — carries the
+         * real, uncapped count. See MAST_SPEC.md §9.0's Confidence signals (C1)
+         * table.
+         *
+         * **Precision note**: this reports RAW FTS-match truncation only.
+         * `potential_matches` itself may still be smaller than the fetch cap even
+         * when this field is present — verified-overlap exclusion and
+         * checker-verdict filtering both run AFTER the capped fetch. Those are
+         * *filtering*, not truncation, and are already visible via
+         * `checker_classified_non_call_site` / `checker_classified_different_declaration`
+         * above. Omitted when the fetch came back under the cap (the fetch count
+         * already IS the real count) — same omitted-when-false convention as
+         * `file_busy_returning_stale_cache` / `index_empty` above.
+         */
+        readonly potential_truncated?: number;
+    };
+    readonly _stats: ToolStats;
+}
+export interface RenameImpactInput {
+    readonly symbol: string;
+    readonly file_path?: string | null;
+}
+export interface DeclarationSite {
+    readonly file_path: string;
+    readonly line: number;
+    readonly kind: string;
+    readonly is_exported: boolean;
+}
+export interface BarrelExportSite {
+    readonly file_path: string;
+    /** Line of the re-export specifier; null for star barrels (file-level). */
+    readonly line: number | null;
+    /** Name the barrel exposes — differs from the symbol name when aliased. */
+    readonly exported_as: string;
+    readonly via: 'named' | 'star';
+}
+/**
+ * Composed refactor checklist for renaming a symbol (§9 mast_rename_impact).
+ * Every section reuses an existing query capability — declarations from the
+ * symbols table, callers from POTENTIAL_CALL edges, review sites from
+ * identifier_fts, barrels from RE_EXPORTS + re_export_files.
+ */
+export interface RenameImpactResponse {
+    readonly symbol: string;
+    readonly declaration_sites: readonly DeclarationSite[];
+    readonly verified_callers: readonly VerifiedCaller[];
+    readonly potential_matches: readonly PotentialMatch[];
+    readonly barrel_exports: readonly BarrelExportSite[];
+    /** See {@link CallersResponse.file_busy_returning_stale_cache} — same envelope-vs-per-entry reasoning; `mast_rename_impact` shares `mast_callers`' JIT policy. */
+    readonly file_busy_returning_stale_cache?: true;
+    /** @see {@link SearchResponse.index_empty} — same empty-index signal; set only when ALL FOUR of `declaration_sites`, `verified_callers`, `potential_matches`, and `barrel_exports` are empty. */
+    readonly index_empty?: true;
+    readonly summary: {
+        readonly declaration_count: number;
+        readonly verified_count: number;
+        readonly potential_count: number;
+        readonly barrel_count: number;
+        /** Human-readable framing: "N verified…, M review-required…, K barrel…". */
+        readonly checklist: string;
+        /** See {@link CallersResponse.summary.checker_classified_non_call_site}. */
+        readonly checker_classified_non_call_site: number;
+        /** See {@link CallersResponse.summary.checker_classified_different_declaration}. */
+        readonly checker_classified_different_declaration: number;
+        /** See {@link CallersResponse.summary.potential_truncated} — same signal, same precision note. */
+        readonly potential_truncated?: number;
+    };
+    readonly _stats: ToolStats;
+}
+export interface DependenciesInput {
+    readonly file_path: string;
+}
+export interface DependencyEntry {
+    readonly module: string;
+    readonly symbols: readonly string[];
+    readonly is_external: boolean;
+    readonly resolved_path?: string;
+}
+export interface DependenciesResponse {
+    readonly file_path: string;
+    readonly imports: readonly DependencyEntry[];
+    /** See {@link ExportsResponse.file_busy_returning_stale_cache} — same single-file envelope reasoning. */
+    readonly file_busy_returning_stale_cache?: true;
+    /** @see {@link SearchResponse.index_empty} — same empty-index signal, keyed on `imports`. */
+    readonly index_empty?: true;
+    readonly _stats: ToolStats;
+}
+export interface ImplementorsInput {
+    readonly interface_name: string;
+}
+export interface ImplementorResult {
+    readonly class_name: string;
+    readonly file_path: string;
+    readonly line: number;
+    readonly methods: readonly string[];
+    /**
+     * Stat-and-flag staleness (F7, split into its own field by C1). Set when
+     * this result's `file_path` stat'd newer-on-disk than its indexed mtime,
+     * or the stat failed (file deleted/renamed) — `mast_implementors` can
+     * return implementors spanning many files, so unlike the single-file
+     * JIT-refresh tools (whose `file_busy_returning_stale_cache` field means a
+     * refresh was ATTEMPTED and lost to contention) no refresh is ever
+     * attempted here: no lock is taken and the line coordinates are not
+     * re-parsed, only flagged via `statSync`. Refreshing here would mean up to
+     * ~50 `structure.lock` acquisitions per call and could invalidate the
+     * graph query that already selected these results (§9.0;
+     * `eval/GITNEXUS_COMPARISON.md` §13.7). Treat this result's coordinates as
+     * untrustworthy until a `mast_reindex` call, or any JIT-refreshing tool
+     * call against the file, heals it. Omitted when false, never
+     * present-and-false. See MAST_SPEC.md §9.0's "Confidence signals (C1)"
+     * table.
+     */
+    readonly stale?: true;
+}
+export interface ImplementorsResponse {
+    readonly results: readonly ImplementorResult[];
+    /** @see {@link SearchResponse.index_empty} — same empty-index signal, keyed on `results`. */
+    readonly index_empty?: true;
+    readonly _stats: ToolStats;
+}
+export interface ReindexInput {
+    readonly full?: boolean;
+}
+export interface ReindexResult {
+    readonly files_indexed: number;
+    readonly files_skipped: number;
+    readonly chunks_added: number;
+    readonly chunks_removed: number;
+    readonly parse_errors: number;
+    readonly write_errors: number;
+    /**
+     * Files whose write was refused by the monotonic write-guard because the
+     * stored row already carried a newer mtime. NOT a failure — the index is
+     * correct — but the file was not written by THIS run, so it is excluded
+     * from `files_indexed` and reported here instead of vanishing from the
+     * accounting entirely (D039).
+     */
+    readonly stale_write_rejections: number;
+    /**
+     * Count of imports that resolved only because the filesystem ignored their
+     * casing — broken on a case-sensitive filesystem. The count alone travels on
+     * the wire; `mast index` prints the offending files.
+     */
+    readonly miscased_imports: number;
+    readonly duration_ms: number;
+}
+/**
+ * Why the index is not fully fresh (null when it is). Stage 7.2
+ * (IMPLEMENTATION_PLAN.md "Stage 7: Vector-store deletion") removed
+ * `'embedding_backlog'`/`'both'` — the Phase 2 embedder that could produce a
+ * backlog distinct from Phase 1 (chunk line coordinates lagging disk,
+ * corrected by JIT on read) no longer exists, so a two-cause union asserted a
+ * distinction the code can no longer draw.
+ */
+export type FreshnessCause = 'phase1_stale' | null;
+export interface StatusResult {
+    readonly state_dir: string;
+    /**
+     * `CURRENT_SCHEMA_VERSION` as compiled into the **running binary** — not the
+     * value stored in `index.json`.
+     *
+     * After a normal startup the two are equal, because §7.4 Step 2's guard wipes
+     * derived state on a mismatch. They diverge in exactly the case worth
+     * detecting (D8): a long-lived process still executing an older build while
+     * the state directory it holds open has since been migrated by a newer one.
+     * Sourcing this from disk would report the migrated value and hide that
+     * divergence, so it is deliberately read from the binary's own constant.
+     */
+    readonly schema_version: string;
+    readonly last_indexed: string | null;
+    readonly indexed_files: number;
+    readonly chunk_count: number;
+    /**
+     * Files whose on-disk state the index does not reflect: content changed
+     * since it was indexed, plus files present on disk but absent from the index
+     * (never indexed, or lost to a failed run), plus files the index still knows
+     * about that are gone from disk. Produced by `indexer/freshness.ts`
+     * `measureFreshness`, which `mast status` shares — the two surfaces answer
+     * one question and computed it differently until 2026-08-20
+     * (`docs/defects/LEDGER.md` D035).
+     */
+    readonly stale_files: number;
+    readonly parse_errors: number;
+    readonly write_errors: number;
+    readonly index_fresh: boolean;
+    readonly freshness_cause: FreshnessCause;
+    readonly seed_commit?: string;
+}
+export interface EfficiencyInput {
+    readonly scope: 'session' | 'global';
+    readonly since_minutes?: number;
+}
+export interface EfficiencyResult {
+    readonly scope: 'session' | 'global';
+    readonly window_started_at: string;
+    readonly tokens_returned: number;
+    readonly tokens_full_file_upper_bound: number;
+    readonly efficiency_ratio: number;
+    readonly calls_total: number;
+    readonly calls_by_tool: Readonly<Record<string, number>>;
+    readonly tokenizer: string;
+    readonly counterfactual: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ast/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ast/types.ts"],"names":[],"mappings":"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"}

package/dist/ast/types.js

@@ -0,0 +1,3 @@
+/** All domain types shared across MAST subsystems. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ast/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ast/types.ts"],"names":[],"mappings":"AAAA,sDAAsD"}

package/dist/cli/docs-cmd.d.ts

@@ -0,0 +1,22 @@
+import type { Command } from 'commander';
+/**
+ * `mast docs` and `mast skill` — documentation that is version-matched by construction.
+ *
+ * Both read files shipped inside the installed package rather than pointing at a
+ * website, so what a user (or an agent) reads is what their binary does. Looking up
+ * "which release am I on, and which docs go with it" is exactly the step this removes,
+ * and it is the step where a reader silently ends up on docs for a different version.
+ */
+export declare class DocsError extends Error {
+}
+export interface DocTopic {
+    readonly name: string;
+    readonly file: string;
+    readonly summary: string;
+}
+export declare const DOC_TOPICS: readonly DocTopic[];
+export declare function readDoc(name: string): string;
+export declare function listDocs(): string;
+export declare function registerDocsCommand(program: Command): void;
+export declare function registerSkillCommand(program: Command): void;
+//# sourceMappingURL=docs-cmd.d.ts.map

package/dist/cli/docs-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-cmd.d.ts","sourceRoot":"","sources":["../../src/cli/docs-cmd.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC;;;;;;;GAOG;AACH,qBAAa,SAAU,SAAQ,KAAK;CAAG;AAMvC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAIzC,CAAC;AAEF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAc5C;AAED,wBAAgB,QAAQ,IAAI,MAAM,CASjC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAY1D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwC3D"}