/**
 * @fileoverview RunScope augmentation for graph.
 *
 * D7 (tool subscopes via module augmentation, per the RunScope/
 * Registry architecture): tool-specific concerns nest under the
 * tool's name on `RunScope` and
 * are added via TypeScript module augmentation from the tool's own
 * package. Core never imports graph-shaped types — the layer rule
 * stays intact (`core ← contracts ← {graph, ...}`).
 *
 * Two singletons used to hang off this package as module-level state:
 *
 *   - lang-adapter `registry` — per-process language adapter registry.
 *   - rules `registry`        — per-process rule registry (seeded with
 *                              the built-in rules at construction).
 *
 * Both are now per-RunScope. The graph tool's `contributeScope` hook (in
 * `tool.ts`) instantiates fresh registries and attaches them to
 * `scope.graph` once per CLI invocation. Tools and library code read
 * via `currentScope()?.graph?.{adapters,rules}`.
 *
 * The `graph` slot is intentionally optional and mutable (no
 * `readonly`) on the augmented interface: the kernel doesn't construct
 * it, and only the graph tool's `contributeScope` writes to it during
 * scope construction. A run that doesn't load the graph tool carries
 * no `scope.graph`, and reads return `undefined`.
 */
import type { ContextRunState } from './context-run-state.js';
import type { GraphAdapterRegistry } from './lang-adapter/registry.js';
import type { ContextCatalogAccessor } from './read/catalog.js';
import type { ContextSnapshotAccessor } from './read/context-snapshot.js';
import type { GraphRecipeRegistry } from './recipes/registry.js';
import type { GraphRulesRegistry } from './rules/registry.js';
/**
 * Per-RunScope graph state. Constructed by the graph tool's
 * `contributeScope()` hook and attached to `scope.graph`.
 */
export interface GraphSubscope {
    /** Language-adapter registry — populated when first-party graph
     *  adapter packages (graph-typescript, graph-python, graph-rust)
     *  register via the CLI's discovery walker. */
    readonly adapters: GraphAdapterRegistry;
    /** Rule registry — pre-seeded with the built-in rules. */
    readonly rules: GraphRulesRegistry;
    /** Recipe registry — pre-seeded with the built-in graph recipes. */
    readonly recipes: GraphRecipeRegistry;
    /** Lazy immutable snapshot persistence/read seam for context producers. */
    readonly contextSnapshots: ContextSnapshotAccessor;
    /** Lazy canonical catalog persistence seam for context producers. */
    readonly contextCatalog: ContextCatalogAccessor;
    /** Exact prior-step identities for this invocation's context chain. */
    readonly contextRun: ContextRunState;
}
declare module '@opensip-cli/core' {
    interface ScopeContribution {
        /**
         * Graph tool's per-run state. Returned by the graph tool's
         * `contributeScope` hook and installed by the kernel; absent in runs
         * where the graph tool is not registered. Consumers MUST null-check
         * before reading. Augments `ScopeContribution`, which `ToolScope`/
         * `RunScope` extend — so `cli.scope.graph` / `currentScope()?.graph`
         * stay readable (audit 2026-05-29, M4).
         */
        graph?: GraphSubscope;
    }
}
//# sourceMappingURL=scope-augmentation.d.ts.map