modelrig 0.1.0 → 0.2.0

package/dist/index.js

@@ -3,45 +3,76 @@
  * modelrig public surface — plan step 7.
  * Usage sketch (normative):
  *   const rig = createRig(loadConfigFromEnv());
- *   const result = await rig.run("research.growth_scenarios", {
- *     input: { ticker, financials, priorSteps },
- *     tags: { run_id, step: "growth_scenarios", ticker },
+ *   const result = await rig.run("example.support_summarize", {
+ *     input: { ticket, product, priorContext },
+ *     tags: { run_id, step: "summarize" },
  *     budget: { envelope: run_id },
  *   });
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.readObjectLiteral = exports.findCallSitesInText = exports.scanRepoForCallSites = exports.capabilitiesFor = exports.routeNameFor = exports.buildMigrationMarkdown = exports.runInit = exports.loadRoutes = exports.RouteConfigError = exports.renderFailureForTerminal = exports.teach = exports.FAILURE_TEACHING = exports.isRigFailure = exports.RigFailureError = exports.extractCitations = exports.createTavilySearchProvider = exports.wilson95 = exports.aggregateVariantMetrics = exports.OUTPUT_MAX_BYTES = exports.retentionExpiry = exports.truncateOutput = exports.selectArmsToKeep = exports.buildBakeoffSamples = exports.createBakeoffSamplesClient = exports.computeProposal = exports.mirrorBakeoff = exports.runBakeoff = exports.replayVariant = exports.openTelemetryStore = exports.openCaptureStore = exports.KEY_SHAPED_PREFIXES = exports.containsKeyShapedString = exports.scrubSecrets = exports.hasScope = exports.parseScopes = exports.redactApiKey = exports.looksLikeApiKey = exports.hashApiKeySecret = exports.API_KEY_SECRET_BYTES = exports.API_KEY_SCOPES = exports.API_KEY_PREFIX = exports.createDirectSink = exports.createApiSink = exports.createTelemetryExporter = exports.DEFAULT_INGEST_URL = exports.INGEST_PROTOCOL_VERSION = exports.INGEST_PATH = exports.foreignOrgFeedback = exports.stampBatch = exports.loadConfigFromEnv = void 0;
-exports.runWatchCycle = exports.assertTransition = exports.createProposalsClient = exports.PROPOSAL_TTL_DAYS = exports.triggerHash = exports.evaluateEvents = exports.RUNG1_MIN_FEEDBACK = exports.computeCoverage = exports.buildFeedbackRow = exports.ALL_CAPABILITY_FLAGS = exports.computeParity = exports.factsUnderCredential = exports.factsFor = exports.PROBE_FRESHNESS_SLO_DAYS = exports.stalenessSentence = exports.probeFreshness = exports.callNotesFor = exports.PREDICATE_GLOSS = exports.ALL_CAPABILITY_PREDICATES = exports.explainEmptySelection = exports.hasCapability = exports.selectModels = exports.parseCapabilityQuery = exports.capabilityFactsFromEntry = exports.loadRegistryFacts = exports.fingerprintSchema = exports.loadManifest = exports.estimateCostUsd = exports.getPricing = exports.resolveCandidates = exports.OPENAI_COMPAT_HOSTS = exports.shapeFireworksModelId = exports.classifyCompatFailure = exports.buildOpenAICompatParams = exports.createOpenAICompatAdapter = exports.createGrokAdapter = exports.createAnthropicAdapter = exports.createDeepSeekAdapter = exports.createOpenAIAdapter = exports.createGeminiAdapter = exports.PROVIDER_KEY_ENV = exports.serveabilityWarnings = exports.checkServeability = exports.writeRouteDraft = exports.buildRouteDraft = exports.splitModelKey = exports.seedCandidates = exports.loadRegistryRows = exports.signatureFor = exports.PROVIDER_SIGNATURES = void 0;
-exports.computeOdometer = exports.createSwapsClient = exports.executeSwap = exports.buildSwapChange = exports.runTelemetryQuery = exports.QueryGrammarError = exports.compileQuery = exports.writePriorsCells = exports.aggregatePairwiseFromTelemetry = exports.aggregatePriors = exports.DEFAULT_WATCH_MONTHLY_USD = exports.watchEnvelopeKey = exports.reserveWatchBudget = exports.WATCH_STATE_KEY = exports.createFileWatchStateStore = exports.createControlPlaneWatchStateStore = exports.createWatchStateStore = exports.saveWatchState = exports.loadWatchState = exports.computeWatchEvents = exports.buildPriceUniverse = void 0;
+exports.replayVariant = exports.openTelemetryStore = exports.openCaptureStore = exports.SSE_DONE = exports.MODELRIG_REQUEST_HEADERS = exports.MODELRIG_HEADERS = exports.GATEWAY_PROTOCOL_VERSION = exports.MODELS_PATH = exports.CHAT_COMPLETIONS_PATH = exports.classifyLane = exports.PROVIDER_IDS = exports.runRawStream = exports.runRaw = exports.bundleFromResolved = exports.runStream = exports.KEY_SHAPED_PREFIXES = exports.containsKeyShapedString = exports.scrubSecrets = exports.hasScope = exports.parseScopes = exports.redactApiKey = exports.looksLikeApiKey = exports.hashApiKeySecret = exports.API_KEY_SECRET_BYTES = exports.API_KEY_SCOPES = exports.API_KEY_PREFIX = exports.resolveArtifactsConfig = exports.resolveOtlpConfig = exports.parseOtlpHeaders = exports.decodeOtlpProtobufTraces = exports.looksLikeLogsPayload = exports.normalizeOtlpTraces = exports.startOtlpEmitterIfConfigured = exports.createOtlpEmitter = exports.TRACEPARENT_TAG = exports.parseTraceparent = exports.buildExportTraceRequest = exports.inferenceToSpan = exports.SEMCONV_VERSION = exports.SinkSendError = exports.createDirectSink = exports.createApiSink = exports.createTelemetryExporter = exports.DEFAULT_INGEST_URL = exports.INGEST_PROTOCOL_VERSION_V1 = exports.INGEST_PROTOCOL_VERSION = exports.INGEST_PATH = exports.foreignOrgFeedback = exports.stampBatch = exports.loadConfigFromEnv = void 0;
+exports.createOpenAICompatAdapter = exports.createGrokAdapter = exports.createAnthropicAdapter = exports.createDeepSeekAdapter = exports.createOpenAIAdapter = exports.createGeminiAdapter = exports.PROVIDER_KEY_ENV = exports.serveabilityWarnings = exports.checkServeability = exports.writeRouteDraft = exports.buildRouteDraft = exports.splitModelKey = exports.seedCandidates = exports.loadRegistryRows = exports.signatureFor = exports.PROVIDER_SIGNATURES = exports.readObjectLiteral = exports.findCallSitesInText = exports.scanRepoForCallSites = exports.capabilitiesFor = exports.routeNameFor = exports.buildMigrationMarkdown = exports.runInit = exports.renderConfigErrorForTerminal = exports.describeConfigFailure = exports.teachConfigError = exports.classifyConfigProblem = exports.CONFIG_TEACHING = exports.mergeLoadedRoutes = exports.loadRoutesWithExtra = exports.loadRoutes = exports.RouteConfigError = exports.renderFailureForTerminal = exports.teach = exports.FAILURE_TEACHING = exports.isRigFailure = exports.RigFailureError = exports.extractCitations = exports.createTavilySearchProvider = exports.wilson95 = exports.aggregateVariantMetrics = exports.OUTPUT_MAX_BYTES = exports.retentionExpiry = exports.truncateOutput = exports.selectArmsToKeep = exports.buildBakeoffSamples = exports.createBakeoffSamplesClient = exports.computeProposal = exports.mirrorBakeoff = exports.runBakeoff = void 0;
+exports.runWatchCycle = exports.DEFAULT_MONITOR_CONFIG = exports.createMonitorReads = exports.rollupConformRate = exports.evaluateConformDegradation = exports.runMonitorCycle = exports.assertTransition = exports.createProposalsClient = exports.explainCacheContext = exports.PROPOSAL_TTL_DAYS = exports.triggerHash = exports.evaluateEvents = exports.RUNG1_MIN_FEEDBACK = exports.computeCoverage = exports.buildFeedbackRow = exports.ALL_CAPABILITY_FLAGS = exports.computeParity = exports.factsUnderCredential = exports.factsFor = exports.PROBE_FRESHNESS_SLO_DAYS = exports.stalenessSentence = exports.probeFreshness = exports.callNotesFor = exports.PREDICATE_GLOSS = exports.ALL_CAPABILITY_PREDICATES = exports.explainEmptySelection = exports.hasCapability = exports.selectModels = exports.parseCapabilityQuery = exports.capabilityFactsFromEntry = exports.loadRegistryFacts = exports.fingerprintSchema = exports.loadManifest = exports.SNAPSHOT_BASIS = exports.describePricingV2 = exports.tierRates = exports.synthesizeFromFlat = exports.seededCachePolicyProviders = exports.getCachePolicy = exports.DEFAULT_CACHE_HYSTERESIS = exports.classifyCacheVerdict = exports.effectiveInputRate = exports.estimateCostUsd = exports.getPricingV2 = exports.getPricing = exports.resolveCandidates = exports.OPENAI_COMPAT_HOSTS = exports.shapeFireworksModelId = exports.classifyCompatFailure = exports.buildOpenAICompatParams = void 0;
+exports.computeOdometer = exports.createSwapsClient = exports.executeSwap = exports.buildRestoreYaml = exports.buildSwapChange = exports.runTelemetryQuery = exports.QueryGrammarError = exports.compileQuery = exports.writePriorsCells = exports.aggregatePairwiseFromTelemetry = exports.aggregatePriors = exports.DEFAULT_WATCH_MONTHLY_USD = exports.watchEnvelopeKey = exports.reserveWatchBudget = exports.WATCH_STATE_KEY = exports.createFileWatchStateStore = exports.createControlPlaneWatchStateStore = exports.createWatchStateStore = exports.saveWatchState = exports.loadWatchState = exports.computeWatchEvents = exports.buildPriceUniverse = void 0;
 exports.createRig = createRig;
-const anthropic_1 = require("./adapters/anthropic");
-const deepseek_1 = require("./adapters/deepseek");
-const gemini_1 = require("./adapters/gemini");
-const grok_1 = require("./adapters/grok");
-const openai_1 = require("./adapters/openai");
-const openai_compat_1 = require("./adapters/openai-compat");
+const build_adapters_1 = require("./adapters/build-adapters");
 const loader_1 = require("./routes/loader");
+const resolved_bundle_1 = require("./routes/resolved-bundle");
 const serveability_1 = require("./routes/serveability");
 const manifest_1 = require("./routes/manifest");
 const run_1 = require("./run/run");
+const stream_1 = require("./run/stream");
+const raw_1 = require("./run/raw");
 const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
 const grounding_1 = require("./run/grounding");
 const capture_1 = require("./telemetry/capture");
 const store_1 = require("./telemetry/store");
+const artifact_store_1 = require("./telemetry/artifact-store");
+const artifacts_1 = require("./artifacts");
 const exporter_1 = require("./telemetry/exporter");
-const sinks_1 = require("./telemetry/sinks");
-const constants_1 = require("./tenancy/constants");
+const exporter_setup_1 = require("./telemetry/exporter-setup");
+const load_error_report_1 = require("./telemetry/load-error-report");
+const api_fetcher_1 = require("./settings/api-fetcher");
+const status_1 = require("./status");
+const deprecations_1 = require("./deprecations");
+const otlp_emitter_1 = require("./telemetry/otlp-emitter");
 const feedback_1 = require("./feedback/feedback");
 const facts_1 = require("./registry/facts");
 const engine_1 = require("./bakeoff/engine");
 const replay_1 = require("./bakeoff/replay");
 const samples_1 = require("./bakeoff/samples");
+const eval_cases_1 = require("./bakeoff/eval-cases");
+const verify_1 = require("./verify/verify");
 const provider_1 = require("./types/provider");
 /** Per-variant replay spend ceiling when the caller doesn't set one. */
 const DEFAULT_REPLAY_ENVELOPE_USD = 10;
 function createRig(config) {
-    const routes = (0, loader_1.loadRoutes)(config.routesDir);
+    let routes;
+    try {
+        routes = (0, loader_1.loadRoutesWithExtra)(config.routesDir, config.extraRoutesDir);
+    }
+    catch (err) {
+        // A malformed bundle is teachable, not just fatal: mirror the diagnosis to
+        // the console before re-throwing (the rig still cannot serve).
+        if (err instanceof loader_1.RouteConfigError)
+            (0, load_error_report_1.reportLoadError)(config, err);
+        throw err;
+    }
     // rig.yaml lives at the rig dir root, one level above routes/
     // (modelrig/rig.yaml next to modelrig/routes/ — cost-dimensions-design §2a).
     const manifest = (0, manifest_1.loadManifest)((0, node_path_1.dirname)(config.routesDir));
@@ -49,33 +80,7 @@ function createRig(config) {
     // capability profile from the registry, never from the dialect.
     const registryFacts = (0, facts_1.loadRegistryFacts)(config.registryPath);
     const COMPAT_STATIC = new Set(["json_mode"]);
-    const adapters = new Map();
-    if (config.keys.gemini)
-        adapters.set("gemini", (0, gemini_1.createGeminiAdapter)({ apiKey: config.keys.gemini }));
-    if (config.keys.openai)
-        adapters.set("openai", (0, openai_1.createOpenAIAdapter)({ apiKey: config.keys.openai }));
-    if (config.keys.deepseek) {
-        adapters.set("deepseek", (0, deepseek_1.createDeepSeekAdapter)({ apiKey: config.keys.deepseek }));
-    }
-    if (config.keys.anthropic) {
-        adapters.set("anthropic", (0, anthropic_1.createAnthropicAdapter)({ apiKey: config.keys.anthropic }));
-    }
-    if (config.keys.grok)
-        adapters.set("grok", (0, grok_1.createGrokAdapter)({ apiKey: config.keys.grok }));
-    // A1 aggregator hosts behind the generic openai-compatible adapter.
-    for (const hostId of ["deepinfra", "fireworks"]) {
-        const apiKey = config.keys[hostId];
-        if (!apiKey)
-            continue;
-        const host = openai_compat_1.OPENAI_COMPAT_HOSTS[hostId];
-        adapters.set(hostId, (0, openai_compat_1.createOpenAICompatAdapter)({
-            providerId: hostId,
-            baseUrl: host.baseUrl,
-            apiKey,
-            ...(host.shapeModelId !== undefined ? { shapeModelId: host.shapeModelId } : {}),
-            capabilityProfile: (model) => registryFacts.flagsFor(hostId, model, COMPAT_STATIC) ?? COMPAT_STATIC,
-        }));
-    }
+    const adapters = (0, build_adapters_1.buildAdapters)(config, registryFacts, COMPAT_STATIC);
     // Load-time serveability (Phase 4 resilience): a keyless declared
     // candidate is INERT, not fatal — warn and keep serving on keyed
     // candidates; only a route with ZERO serveable candidates is a hard error.
@@ -102,10 +107,21 @@ function createRig(config) {
         return registryFacts.flagsFor(provider, model, staticFlags) ?? staticFlags;
     };
     const telemetry = (0, store_1.openTelemetryStore)(config.telemetryDbPath);
-    // Local-only capture store (Phase 3 WS4): opened only when a bundle opts
-    // in; a SEPARATE handle over the same file — the exporter cannot reach it.
+    // Artifact / execution-graph namespace (Expansion E2) — bound to this rig's
+    // telemetry buffer and gated by config. Disabled ⇒ run.start is a no-op, the
+    // ambient run context is never set, and rig.run's auto-step is never reached.
+    const artifactsEnabled = config.artifacts?.enabled === true;
+    // Artifact metadata buffer (chunk B) — separate handle over the same file.
+    const artifactStore = artifactsEnabled ? (0, artifact_store_1.openArtifactStore)(config.telemetryDbPath) : null;
+    const { namespace: artifactNamespace, onArtifactsFlushed } = (0, artifacts_1.wireRigArtifacts)({
+        buffer: telemetry,
+        enabled: artifactsEnabled,
+        artifactStore,
+        ...(config.artifacts !== undefined ? { artifacts: config.artifacts } : {}),
+    });
+    // Local-only capture store (Phase 3/§1.5): a YAML opt-in OR api mode — a console flip needs a destination.
     let captures = null;
-    if (routes.list().some((b) => b.capture)) {
+    if (routes.list().some((b) => b.capture) || config.export?.mode === "api") {
         captures = (0, capture_1.openCaptureStore)(config.telemetryDbPath);
     }
     // Grounding-inject search provider (Phase 3 WS3).
@@ -121,53 +137,32 @@ function createRig(config) {
         })
         : null;
     // Cloud sink (optional, fire-and-forget): the run loop never blocks on or
-    // fails because of it — the exporter swallows all sink errors.
-    let exporter = null;
-    if (config.export !== undefined) {
-        const exportConfig = config.export;
-        const sourceId = exportConfig.sourceId ?? (0, node_os_1.hostname)();
-        const sink = exportConfig.mode === "api"
-            ? (0, sinks_1.createApiSink)({
-                ingestUrl: exportConfig.ingestUrl,
-                apiKey: exportConfig.apiKey,
-                // A batch the server partly refused comes back 200. Without this,
-                // a customer whose rows are being dropped would find out by
-                // noticing a gap in a chart weeks later.
-                onOutcome: (outcome) => {
-                    const dropped = Object.values(outcome.dropped).reduce((a, b) => a + b, 0);
-                    if (dropped === 0)
-                        return;
-                    const reasons = Object.entries(outcome.reasons)
-                        .map(([reason, count]) => `${reason}×${count}`)
-                        .join(", ");
-                    console.warn(`[modelrig exporter] ingest dropped ${dropped} row(s): ${reasons}`);
-                },
-            })
-            : (0, sinks_1.createDirectSink)({
-                supabaseUrl: exportConfig.supabaseUrl,
-                serviceRoleKey: exportConfig.serviceRoleKey,
-                tenancy: {
-                    org_id: exportConfig.orgId ?? constants_1.HOUSE_ORG_ID,
-                    project_id: exportConfig.projectId ?? null,
-                    source_id: sourceId,
-                },
-            });
-        exporter = (0, exporter_1.createTelemetryExporter)(telemetry, {
-            sink,
-            sourceId,
-            ...(exportConfig.batchSize !== undefined ? { batchSize: exportConfig.batchSize } : {}),
-            ...(exportConfig.intervalMs !== undefined ? { intervalMs: exportConfig.intervalMs } : {}),
-            routes: routes.list().map((b) => ({
-                route: b.route,
-                version: b.version,
-                candidates: b.candidates.map((c) => ({ provider: c.provider, model: c.model })),
-                capture: b.capture,
-            })),
+    // fails because of it — the exporter swallows all sink errors. Built + started
+    // by startTelemetryExporter (extracted to keep this file under the LOC cap).
+    const exporter = config.export !== undefined
+        ? (0, exporter_setup_1.startTelemetryExporter)(telemetry, config.export, {
+            routes: (0, exporter_1.buildExportedRouteMirrors)(routes.list()),
             manifest,
             serveability,
-        });
-        exporter.start();
-    }
+            artifactsEnabled,
+            artifactStore,
+            ...(onArtifactsFlushed !== undefined ? { onArtifactsFlushed } : {}),
+        })
+        : null;
+    // Control-plane settings resolver (§1.5) — api mode only; refreshes task
+    // settings on the exporter interval, fail-open, so a console flip is honored
+    // without a redeploy. null for local-only/direct (env/YAML their mechanism).
+    const settings = (0, api_fetcher_1.startApiSettings)(config, exporter_1.DEFAULT_INTERVAL_MS);
+    // Boot banner (§2) + one-time deprecation warnings (§3): posture, plus a loud
+    // notice if YAML `capture:` is being ignored under a control plane, or the
+    // `direct` sink is in use. Silent for a pure local-only rig.
+    (0, status_1.emitBootBanner)(config);
+    (0, deprecations_1.warnDirectSinkDeprecated)(config);
+    (0, deprecations_1.warnYamlCaptureDeprecated)(routes.list(), config.export !== undefined);
+    // OTLP span emission (E1) — ADDITIVE, alongside (never instead of) the
+    // exporter, constructed ONLY when an endpoint is configured (spec §6a). Same
+    // source identity as the exporter (and works with no control-plane export).
+    const otlpEmitter = (0, otlp_emitter_1.startOtlpEmitterIfConfigured)(telemetry, config.otlp, config.export?.sourceId ?? (0, node_os_1.hostname)());
     const deps = {
         routes,
         adapters,
@@ -176,6 +171,7 @@ function createRig(config) {
         manifest,
         captures,
         search,
+        settings, // §1.5 resolver (null local-only); capture-WRITE gate consults it
         ...(config.envelopeBudgetUsd !== undefined
             ? { envelopeBudgetUsd: config.envelopeBudgetUsd }
             : {}),
@@ -183,6 +179,14 @@ function createRig(config) {
             ? { unpricedRateUsdPerMTok: config.unpricedRateUsdPerMTok }
             : {}),
     };
+    // Raw-lane deps (Phase C): telemetry + unpriced rate only — the raw lane
+    // builds its own throwaway keyed adapter per call, off the route/adapter map.
+    const rawDeps = {
+        telemetry,
+        ...(config.unpricedRateUsdPerMTok !== undefined
+            ? { unpricedRateUsdPerMTok: config.unpricedRateUsdPerMTok }
+            : {}),
+    };
     // Replay reads captures even when no route currently opts in to writing
     // them — open the read handle lazily.
     function captureStoreForReplay() {
@@ -191,30 +195,42 @@ function createRig(config) {
         }
         return captures;
     }
-    // Bake-off review-sample sink (addendum A3): persists retained outputs to
-    // the SEPARATE bakeoff_samples store (service role; deny-anon RLS). Only
-    // exists when the control plane is configured — captures never touch it.
-    //
-    // DIRECT MODE ONLY, and that is a real limitation, not an oversight:
-    // `bakeoff_samples` has no ingest route (telemetry-ingestion-boundary.md §2
-    // covers telemetry, not review samples), so an api-mode rig keeps its
-    // retained outputs local. Flagged for the architect in the WS2 report
-    // rather than papered over — a silent no-op here would look like data loss.
-    const directExport = config.export?.mode === "direct" ? config.export : undefined;
-    const samplesSink = directExport !== undefined
-        ? async ({ bakeoffId, route, arms }) => {
-            const rows = (0, samples_1.buildBakeoffSamples)(bakeoffId, route, arms, (0, samples_1.retentionExpiry)(Date.now()));
-            await (0, samples_1.createBakeoffSamplesClient)({
-                supabaseUrl: directExport.supabaseUrl,
-                serviceRoleKey: directExport.serviceRoleKey,
-            }).insert(rows);
-        }
-        : undefined;
+    // Bake-off review-sample sink (addendum A3) — direct mode only; see
+    // buildDirectSamplesSink for the rationale. Undefined for an api/local rig.
+    const samplesSink = config.export?.mode === "direct" ? (0, samples_1.buildDirectSamplesSink)(config.export) : undefined;
     return {
         serveability,
+        artifacts: artifactNamespace,
+        exporterStats: () => (exporter !== null ? exporter.stats() : { poisonSkipped: {} }),
+        status: () => (0, status_1.buildRigStatus)(config, settings?.snapshot() ?? new Map()),
         run(route, opts) {
+            // Track the task (= route handle) so its control-plane settings stay
+            // fresh on the exporter interval (§1.5). Fire-and-forget, fail-open.
+            // EVERY route-carrying entry point tracks — a streaming- or gateway-only
+            // deployment must honor a console flip too (acceptance d).
+            settings?.track(route);
             return (0, run_1.run)(deps, route, opts);
         },
+        runStream(route, opts) {
+            settings?.track(route);
+            return (0, stream_1.runStream)(deps, route, opts);
+        },
+        runBundle(bundle, opts) {
+            // The ONLY difference from run(): a one-bundle store instead of local
+            // routes. Everything downstream is the shared, verified pipeline (§13.1).
+            settings?.track(bundle.route);
+            return (0, run_1.run)({ ...deps, routes: (0, resolved_bundle_1.singleRouteStore)(bundle) }, bundle.route, opts);
+        },
+        runBundleStream(bundle, opts) {
+            settings?.track(bundle.route);
+            return (0, stream_1.runStream)({ ...deps, routes: (0, resolved_bundle_1.singleRouteStore)(bundle) }, bundle.route, opts);
+        },
+        runRaw(input) {
+            return (0, raw_1.runRaw)(rawDeps, input);
+        },
+        runRawStream(input) {
+            return (0, raw_1.runRawStream)(rawDeps, input);
+        },
         feedback(target, opts) {
             const row = (0, feedback_1.buildFeedbackRow)(target, opts);
             telemetry.recordFeedback(row);
@@ -237,14 +253,33 @@ function createRig(config) {
                 ...(opts.keepOutputs !== undefined ? { keepOutputs: opts.keepOutputs } : {}),
             }, samplesSink);
         },
+        verifySwap(route, fixture, opts) {
+            settings?.track(route);
+            return (0, verify_1.verifySwap)(deps, { route, fixture, ...(opts?.envelopeUsd !== undefined ? { envelopeUsd: opts.envelopeUsd } : {}) });
+        },
+        bakeoffFromEvalCases(task, opts) {
+            return (0, eval_cases_1.runBakeoffFromEvalCases)(deps, { artifacts: artifactStore, telemetry, captures: captureStoreForReplay }, {
+                task,
+                variants: opts.variants,
+                envelopeUsdPerVariant: opts.envelopeUsdPerVariant ?? DEFAULT_REPLAY_ENVELOPE_USD,
+                ...(opts.keepOutputs !== undefined ? { keepOutputs: opts.keepOutputs } : {}),
+            }, samplesSink);
+        },
         close() {
-            captures?.close();
-            if (exporter !== null) {
-                // Final best-effort flush; sink errors are swallowed by the exporter.
-                void exporter.stop().finally(() => telemetry.close());
-                return;
+            settings?.stop(); // stop the settings refresh loop (§1.5)
+            // DRAIN FIRST, close stores LAST (H1): the final flush reads the artifact
+            // store + captures — closing first lost the final rows (walkthrough 2026-08-20).
+            const closeStores = () => { captures?.close(); artifactStore?.close(); telemetry.close(); };
+            const stops = [];
+            if (exporter !== null)
+                stops.push(exporter.stop());
+            if (otlpEmitter !== null)
+                stops.push(otlpEmitter.stop());
+            if (stops.length > 0) {
+                return Promise.allSettled(stops).finally(closeStores).then(() => undefined);
             }
-            telemetry.close();
+            closeStores();
+            return Promise.resolve();
         },
     };
 }
@@ -254,17 +289,51 @@ Object.defineProperty(exports, "loadConfigFromEnv", { enumerable: true, get: fun
 // COMPILES AGAINST IT: one definition of a batch and one mapper from batch to
 // database rows, shared by the SDK's two sinks and the ingest endpoint. A
 // second copy on the server side is exactly the drift this prevents.
+// prettier-ignore
 var ingest_protocol_1 = require("./telemetry/ingest-protocol");
 Object.defineProperty(exports, "stampBatch", { enumerable: true, get: function () { return ingest_protocol_1.stampBatch; } });
 Object.defineProperty(exports, "foreignOrgFeedback", { enumerable: true, get: function () { return ingest_protocol_1.foreignOrgFeedback; } });
 Object.defineProperty(exports, "INGEST_PATH", { enumerable: true, get: function () { return ingest_protocol_1.INGEST_PATH; } });
 Object.defineProperty(exports, "INGEST_PROTOCOL_VERSION", { enumerable: true, get: function () { return ingest_protocol_1.INGEST_PROTOCOL_VERSION; } });
+Object.defineProperty(exports, "INGEST_PROTOCOL_VERSION_V1", { enumerable: true, get: function () { return ingest_protocol_1.INGEST_PROTOCOL_VERSION_V1; } });
 Object.defineProperty(exports, "DEFAULT_INGEST_URL", { enumerable: true, get: function () { return ingest_protocol_1.DEFAULT_INGEST_URL; } });
 var exporter_2 = require("./telemetry/exporter");
 Object.defineProperty(exports, "createTelemetryExporter", { enumerable: true, get: function () { return exporter_2.createTelemetryExporter; } });
-var sinks_2 = require("./telemetry/sinks");
-Object.defineProperty(exports, "createApiSink", { enumerable: true, get: function () { return sinks_2.createApiSink; } });
-Object.defineProperty(exports, "createDirectSink", { enumerable: true, get: function () { return sinks_2.createDirectSink; } });
+var sinks_1 = require("./telemetry/sinks");
+Object.defineProperty(exports, "createApiSink", { enumerable: true, get: function () { return sinks_1.createApiSink; } });
+Object.defineProperty(exports, "createDirectSink", { enumerable: true, get: function () { return sinks_1.createDirectSink; } });
+Object.defineProperty(exports, "SinkSendError", { enumerable: true, get: function () { return sinks_1.SinkSendError; } });
+// OTLP out (E1). The gateway imports `parseTraceparent` + `TRACEPARENT_TAG` so
+// the SDK and server agree on the propagation format (single-definition rule).
+var otel_map_1 = require("./telemetry/otel-map");
+Object.defineProperty(exports, "SEMCONV_VERSION", { enumerable: true, get: function () { return otel_map_1.SEMCONV_VERSION; } });
+Object.defineProperty(exports, "inferenceToSpan", { enumerable: true, get: function () { return otel_map_1.inferenceToSpan; } });
+Object.defineProperty(exports, "buildExportTraceRequest", { enumerable: true, get: function () { return otel_map_1.buildExportTraceRequest; } });
+Object.defineProperty(exports, "parseTraceparent", { enumerable: true, get: function () { return otel_map_1.parseTraceparent; } });
+Object.defineProperty(exports, "TRACEPARENT_TAG", { enumerable: true, get: function () { return otel_map_1.TRACEPARENT_TAG; } });
+var otlp_emitter_2 = require("./telemetry/otlp-emitter");
+Object.defineProperty(exports, "createOtlpEmitter", { enumerable: true, get: function () { return otlp_emitter_2.createOtlpEmitter; } });
+Object.defineProperty(exports, "startOtlpEmitterIfConfigured", { enumerable: true, get: function () { return otlp_emitter_2.startOtlpEmitterIfConfigured; } });
+// OTLP IN v0 (E3-Harvest): modelrig-server turns foreign OTLP traces into
+// attested runs/steps — structure/identity/usage ONLY, zero content.
+var otel_normalize_1 = require("./telemetry/otel-normalize");
+Object.defineProperty(exports, "normalizeOtlpTraces", { enumerable: true, get: function () { return otel_normalize_1.normalizeOtlpTraces; } });
+Object.defineProperty(exports, "looksLikeLogsPayload", { enumerable: true, get: function () { return otel_normalize_1.looksLikeLogsPayload; } });
+var otlp_proto_1 = require("./telemetry/otlp-proto");
+Object.defineProperty(exports, "decodeOtlpProtobufTraces", { enumerable: true, get: function () { return otlp_proto_1.decodeOtlpProtobufTraces; } });
+var config_2 = require("./config");
+Object.defineProperty(exports, "parseOtlpHeaders", { enumerable: true, get: function () { return config_2.parseOtlpHeaders; } });
+Object.defineProperty(exports, "resolveOtlpConfig", { enumerable: true, get: function () { return config_2.resolveOtlpConfig; } });
+// Artifact / execution-graph namespace (Expansion E2) — the barrel re-exports
+// step/run-context/types; the run lifecycle is bound per-rig via rig.artifacts.
+__exportStar(require("./artifacts"), exports);
+var config_3 = require("./config");
+Object.defineProperty(exports, "resolveArtifactsConfig", { enumerable: true, get: function () { return config_3.resolveArtifactsConfig; } });
+// Control-plane settings resolution (settings-plane §1.5) — the gateway + any
+// future capture-write consume `effectiveCapture`; the server shares the types.
+__exportStar(require("./settings"), exports);
+// Runtime posture (§2) — the boot banner + `/status`.
+__exportStar(require("./status"), exports);
 // The rig_sk_ key FORMAT (not minting — that is the control plane's). Shared
 // so the SDK, the server and the oracle cannot disagree about what a key is.
 var api_key_format_1 = require("./tenancy/api-key-format");
@@ -282,6 +351,29 @@ var scrub_1 = require("./tenancy/scrub");
 Object.defineProperty(exports, "scrubSecrets", { enumerable: true, get: function () { return scrub_1.scrubSecrets; } });
 Object.defineProperty(exports, "containsKeyShapedString", { enumerable: true, get: function () { return scrub_1.containsKeyShapedString; } });
 Object.defineProperty(exports, "KEY_SHAPED_PREFIXES", { enumerable: true, get: function () { return scrub_1.KEY_SHAPED_PREFIXES; } });
+// Streaming surface (G-1/G-5 Phase A).
+var stream_2 = require("./run/stream");
+Object.defineProperty(exports, "runStream", { enumerable: true, get: function () { return stream_2.runStream; } });
+// Resolved-bundle round-trip (Phase D, spec §13) — the server rebuilds mirrored
+// bundles with `bundleFromResolved` and serves them via `rig.runBundle`.
+var resolved_bundle_2 = require("./routes/resolved-bundle");
+Object.defineProperty(exports, "bundleFromResolved", { enumerable: true, get: function () { return resolved_bundle_2.bundleFromResolved; } });
+// G-1/G-5 Phase C — the raw-lane BYOK passthrough (spec §4.2).
+var raw_2 = require("./run/raw");
+Object.defineProperty(exports, "runRaw", { enumerable: true, get: function () { return raw_2.runRaw; } });
+Object.defineProperty(exports, "runRawStream", { enumerable: true, get: function () { return raw_2.runRawStream; } });
+var provider_2 = require("./types/provider");
+Object.defineProperty(exports, "PROVIDER_IDS", { enumerable: true, get: function () { return provider_2.PROVIDER_IDS; } });
+// The HTTP gateway wire contract (G-1/G-5) — shared with modelrig-server, like
+// ingest-protocol.ts. Types + the lane-disambiguation rule + header names.
+var http_protocol_1 = require("./gateway/http-protocol");
+Object.defineProperty(exports, "classifyLane", { enumerable: true, get: function () { return http_protocol_1.classifyLane; } });
+Object.defineProperty(exports, "CHAT_COMPLETIONS_PATH", { enumerable: true, get: function () { return http_protocol_1.CHAT_COMPLETIONS_PATH; } });
+Object.defineProperty(exports, "MODELS_PATH", { enumerable: true, get: function () { return http_protocol_1.MODELS_PATH; } });
+Object.defineProperty(exports, "GATEWAY_PROTOCOL_VERSION", { enumerable: true, get: function () { return http_protocol_1.GATEWAY_PROTOCOL_VERSION; } });
+Object.defineProperty(exports, "MODELRIG_HEADERS", { enumerable: true, get: function () { return http_protocol_1.MODELRIG_HEADERS; } });
+Object.defineProperty(exports, "MODELRIG_REQUEST_HEADERS", { enumerable: true, get: function () { return http_protocol_1.MODELRIG_REQUEST_HEADERS; } });
+Object.defineProperty(exports, "SSE_DONE", { enumerable: true, get: function () { return http_protocol_1.SSE_DONE; } });
 var capture_2 = require("./telemetry/capture");
 Object.defineProperty(exports, "openCaptureStore", { enumerable: true, get: function () { return capture_2.openCaptureStore; } });
 var store_2 = require("./telemetry/store");
@@ -302,6 +394,8 @@ Object.defineProperty(exports, "OUTPUT_MAX_BYTES", { enumerable: true, get: func
 var stats_1 = require("./bakeoff/stats");
 Object.defineProperty(exports, "aggregateVariantMetrics", { enumerable: true, get: function () { return stats_1.aggregateVariantMetrics; } });
 Object.defineProperty(exports, "wilson95", { enumerable: true, get: function () { return stats_1.wilson95; } });
+// Shadow-equivalence verifier (Expansion §9, Tier 2) — the skill's verify step.
+__exportStar(require("./verify"), exports);
 var grounding_2 = require("./run/grounding");
 Object.defineProperty(exports, "createTavilySearchProvider", { enumerable: true, get: function () { return grounding_2.createTavilySearchProvider; } });
 Object.defineProperty(exports, "extractCitations", { enumerable: true, get: function () { return grounding_2.extractCitations; } });
@@ -316,6 +410,16 @@ Object.defineProperty(exports, "renderFailureForTerminal", { enumerable: true, g
 var loader_2 = require("./routes/loader");
 Object.defineProperty(exports, "RouteConfigError", { enumerable: true, get: function () { return loader_2.RouteConfigError; } });
 Object.defineProperty(exports, "loadRoutes", { enumerable: true, get: function () { return loader_2.loadRoutes; } });
+Object.defineProperty(exports, "loadRoutesWithExtra", { enumerable: true, get: function () { return loader_2.loadRoutesWithExtra; } });
+Object.defineProperty(exports, "mergeLoadedRoutes", { enumerable: true, get: function () { return loader_2.mergeLoadedRoutes; } });
+// Errors that teach, for LOAD-TIME config problems (onboarding-redesign §7 G2)
+// — the RouteConfigError shapes a first-time author hits before any call runs.
+var config_teaching_1 = require("./types/config-teaching");
+Object.defineProperty(exports, "CONFIG_TEACHING", { enumerable: true, get: function () { return config_teaching_1.CONFIG_TEACHING; } });
+Object.defineProperty(exports, "classifyConfigProblem", { enumerable: true, get: function () { return config_teaching_1.classifyConfigProblem; } });
+Object.defineProperty(exports, "teachConfigError", { enumerable: true, get: function () { return config_teaching_1.teachConfigError; } });
+Object.defineProperty(exports, "describeConfigFailure", { enumerable: true, get: function () { return config_teaching_1.describeConfigFailure; } });
+Object.defineProperty(exports, "renderConfigErrorForTerminal", { enumerable: true, get: function () { return config_teaching_1.renderConfigErrorForTerminal; } });
 // `modelrig init` (Phase 5 WS2) — repo scan → drafted route bundles.
 var run_2 = require("./init/run");
 Object.defineProperty(exports, "runInit", { enumerable: true, get: function () { return run_2.runInit; } });
@@ -341,32 +445,47 @@ Object.defineProperty(exports, "writeRouteDraft", { enumerable: true, get: funct
 var serveability_2 = require("./routes/serveability");
 Object.defineProperty(exports, "checkServeability", { enumerable: true, get: function () { return serveability_2.checkServeability; } });
 Object.defineProperty(exports, "serveabilityWarnings", { enumerable: true, get: function () { return serveability_2.serveabilityWarnings; } });
-var config_2 = require("./config");
-Object.defineProperty(exports, "PROVIDER_KEY_ENV", { enumerable: true, get: function () { return config_2.PROVIDER_KEY_ENV; } });
+var config_4 = require("./config");
+Object.defineProperty(exports, "PROVIDER_KEY_ENV", { enumerable: true, get: function () { return config_4.PROVIDER_KEY_ENV; } });
 // Probe-suite surface (Phase 2 plan §4: probes drive adapters DIRECTLY, and
 // mint CandidateRefs through resolveCandidates — the single brand site —
 // against their own single-candidate probe routes).
-var gemini_2 = require("./adapters/gemini");
-Object.defineProperty(exports, "createGeminiAdapter", { enumerable: true, get: function () { return gemini_2.createGeminiAdapter; } });
-var openai_2 = require("./adapters/openai");
-Object.defineProperty(exports, "createOpenAIAdapter", { enumerable: true, get: function () { return openai_2.createOpenAIAdapter; } });
-var deepseek_2 = require("./adapters/deepseek");
-Object.defineProperty(exports, "createDeepSeekAdapter", { enumerable: true, get: function () { return deepseek_2.createDeepSeekAdapter; } });
-var anthropic_2 = require("./adapters/anthropic");
-Object.defineProperty(exports, "createAnthropicAdapter", { enumerable: true, get: function () { return anthropic_2.createAnthropicAdapter; } });
-var grok_2 = require("./adapters/grok");
-Object.defineProperty(exports, "createGrokAdapter", { enumerable: true, get: function () { return grok_2.createGrokAdapter; } });
-var openai_compat_2 = require("./adapters/openai-compat");
-Object.defineProperty(exports, "createOpenAICompatAdapter", { enumerable: true, get: function () { return openai_compat_2.createOpenAICompatAdapter; } });
-Object.defineProperty(exports, "buildOpenAICompatParams", { enumerable: true, get: function () { return openai_compat_2.buildOpenAICompatParams; } });
-Object.defineProperty(exports, "classifyCompatFailure", { enumerable: true, get: function () { return openai_compat_2.classifyCompatFailure; } });
-Object.defineProperty(exports, "shapeFireworksModelId", { enumerable: true, get: function () { return openai_compat_2.shapeFireworksModelId; } });
-Object.defineProperty(exports, "OPENAI_COMPAT_HOSTS", { enumerable: true, get: function () { return openai_compat_2.OPENAI_COMPAT_HOSTS; } });
+var gemini_1 = require("./adapters/gemini");
+Object.defineProperty(exports, "createGeminiAdapter", { enumerable: true, get: function () { return gemini_1.createGeminiAdapter; } });
+var openai_1 = require("./adapters/openai");
+Object.defineProperty(exports, "createOpenAIAdapter", { enumerable: true, get: function () { return openai_1.createOpenAIAdapter; } });
+var deepseek_1 = require("./adapters/deepseek");
+Object.defineProperty(exports, "createDeepSeekAdapter", { enumerable: true, get: function () { return deepseek_1.createDeepSeekAdapter; } });
+var anthropic_1 = require("./adapters/anthropic");
+Object.defineProperty(exports, "createAnthropicAdapter", { enumerable: true, get: function () { return anthropic_1.createAnthropicAdapter; } });
+var grok_1 = require("./adapters/grok");
+Object.defineProperty(exports, "createGrokAdapter", { enumerable: true, get: function () { return grok_1.createGrokAdapter; } });
+var openai_compat_1 = require("./adapters/openai-compat");
+Object.defineProperty(exports, "createOpenAICompatAdapter", { enumerable: true, get: function () { return openai_compat_1.createOpenAICompatAdapter; } });
+Object.defineProperty(exports, "buildOpenAICompatParams", { enumerable: true, get: function () { return openai_compat_1.buildOpenAICompatParams; } });
+Object.defineProperty(exports, "classifyCompatFailure", { enumerable: true, get: function () { return openai_compat_1.classifyCompatFailure; } });
+Object.defineProperty(exports, "shapeFireworksModelId", { enumerable: true, get: function () { return openai_compat_1.shapeFireworksModelId; } });
+Object.defineProperty(exports, "OPENAI_COMPAT_HOSTS", { enumerable: true, get: function () { return openai_compat_1.OPENAI_COMPAT_HOSTS; } });
 var resolve_1 = require("./run/resolve");
 Object.defineProperty(exports, "resolveCandidates", { enumerable: true, get: function () { return resolve_1.resolveCandidates; } });
 var pricing_1 = require("./registry/pricing");
 Object.defineProperty(exports, "getPricing", { enumerable: true, get: function () { return pricing_1.getPricing; } });
+Object.defineProperty(exports, "getPricingV2", { enumerable: true, get: function () { return pricing_1.getPricingV2; } });
 Object.defineProperty(exports, "estimateCostUsd", { enumerable: true, get: function () { return pricing_1.estimateCostUsd; } });
+var effective_rate_1 = require("./registry/effective-rate");
+Object.defineProperty(exports, "effectiveInputRate", { enumerable: true, get: function () { return effective_rate_1.effectiveInputRate; } });
+Object.defineProperty(exports, "classifyCacheVerdict", { enumerable: true, get: function () { return effective_rate_1.classifyCacheVerdict; } });
+Object.defineProperty(exports, "DEFAULT_CACHE_HYSTERESIS", { enumerable: true, get: function () { return effective_rate_1.DEFAULT_CACHE_HYSTERESIS; } });
+// Cache Policy Registry (cache-aware-routing §3, WS-A) — for the cache-stats route + status posture.
+var cache_policy_1 = require("./registry/cache-policy");
+Object.defineProperty(exports, "getCachePolicy", { enumerable: true, get: function () { return cache_policy_1.getCachePolicy; } });
+Object.defineProperty(exports, "seededCachePolicyProviders", { enumerable: true, get: function () { return cache_policy_1.seededCachePolicyProviders; } });
+// First-class pricing shape (pricing-first-class spec §2.1) — ADDITIVE export.
+var pricing_shape_1 = require("./registry/pricing-shape");
+Object.defineProperty(exports, "synthesizeFromFlat", { enumerable: true, get: function () { return pricing_shape_1.synthesizeFromFlat; } });
+Object.defineProperty(exports, "tierRates", { enumerable: true, get: function () { return pricing_shape_1.tierRates; } });
+Object.defineProperty(exports, "describePricingV2", { enumerable: true, get: function () { return pricing_shape_1.describePricingV2; } });
+Object.defineProperty(exports, "SNAPSHOT_BASIS", { enumerable: true, get: function () { return pricing_shape_1.SNAPSHOT_BASIS; } });
 var manifest_2 = require("./routes/manifest");
 Object.defineProperty(exports, "loadManifest", { enumerable: true, get: function () { return manifest_2.loadManifest; } });
 var fingerprint_1 = require("./registry/fingerprint");
@@ -394,8 +513,8 @@ Object.defineProperty(exports, "factsFor", { enumerable: true, get: function ()
 Object.defineProperty(exports, "factsUnderCredential", { enumerable: true, get: function () { return claims_1.factsUnderCredential; } });
 var parity_1 = require("./registry/parity");
 Object.defineProperty(exports, "computeParity", { enumerable: true, get: function () { return parity_1.computeParity; } });
-var provider_2 = require("./types/provider");
-Object.defineProperty(exports, "ALL_CAPABILITY_FLAGS", { enumerable: true, get: function () { return provider_2.ALL_CAPABILITY_FLAGS; } });
+var provider_3 = require("./types/provider");
+Object.defineProperty(exports, "ALL_CAPABILITY_FLAGS", { enumerable: true, get: function () { return provider_3.ALL_CAPABILITY_FLAGS; } });
 var feedback_2 = require("./feedback/feedback");
 Object.defineProperty(exports, "buildFeedbackRow", { enumerable: true, get: function () { return feedback_2.buildFeedbackRow; } });
 var coverage_1 = require("./feedback/coverage");
@@ -406,9 +525,17 @@ var evaluate_1 = require("./watch/evaluate");
 Object.defineProperty(exports, "evaluateEvents", { enumerable: true, get: function () { return evaluate_1.evaluateEvents; } });
 Object.defineProperty(exports, "triggerHash", { enumerable: true, get: function () { return evaluate_1.triggerHash; } });
 Object.defineProperty(exports, "PROPOSAL_TTL_DAYS", { enumerable: true, get: function () { return evaluate_1.PROPOSAL_TTL_DAYS; } });
+Object.defineProperty(exports, "explainCacheContext", { enumerable: true, get: function () { return evaluate_1.explainCacheContext; } });
 var proposals_1 = require("./watch/proposals");
 Object.defineProperty(exports, "createProposalsClient", { enumerable: true, get: function () { return proposals_1.createProposalsClient; } });
 Object.defineProperty(exports, "assertTransition", { enumerable: true, get: function () { return proposals_1.assertTransition; } });
+// Monitor v1 — conform-rate degradation → bake-off proposal (E4 chunk B).
+var monitor_1 = require("./watch/monitor");
+Object.defineProperty(exports, "runMonitorCycle", { enumerable: true, get: function () { return monitor_1.runMonitorCycle; } });
+Object.defineProperty(exports, "evaluateConformDegradation", { enumerable: true, get: function () { return monitor_1.evaluateConformDegradation; } });
+Object.defineProperty(exports, "rollupConformRate", { enumerable: true, get: function () { return monitor_1.rollupConformRate; } });
+Object.defineProperty(exports, "createMonitorReads", { enumerable: true, get: function () { return monitor_1.createMonitorReads; } });
+Object.defineProperty(exports, "DEFAULT_MONITOR_CONFIG", { enumerable: true, get: function () { return monitor_1.DEFAULT_MONITOR_CONFIG; } });
 var run_3 = require("./watch/run");
 Object.defineProperty(exports, "runWatchCycle", { enumerable: true, get: function () { return run_3.runWatchCycle; } });
 var state_1 = require("./watch/state");
@@ -440,6 +567,7 @@ Object.defineProperty(exports, "runTelemetryQuery", { enumerable: true, get: fun
 // Savings odometer + swap machinery (Phase 4 WS4).
 var emit_1 = require("./savings/emit");
 Object.defineProperty(exports, "buildSwapChange", { enumerable: true, get: function () { return emit_1.buildSwapChange; } });
+Object.defineProperty(exports, "buildRestoreYaml", { enumerable: true, get: function () { return emit_1.buildRestoreYaml; } });
 var swap_execute_1 = require("./savings/swap-execute");
 Object.defineProperty(exports, "executeSwap", { enumerable: true, get: function () { return swap_execute_1.executeSwap; } });
 var swaps_client_1 = require("./savings/swaps-client");

package/dist/init/finder.d.ts

@@ -46,7 +46,22 @@ export interface FinderOptions {
     /** Include test files. Off by default: a mock is not a call site. */
     readonly includeTests?: boolean;
     readonly maxFileBytes?: number;
+    /**
+     * Narrow the scan to these paths/globs (F-4). Matched against each file's
+     * repo-relative POSIX path; a file matching NONE is not read at all. A
+     * pattern with no glob metachar (`*`/`?`/`[`) is a directory-prefix match
+     * (`src/pipeline` ⇒ everything under it); otherwise it is a glob where `*`
+     * stays within a path segment and `**` spans them. Empty/undefined = no
+     * narrowing (scan everything), so the default behaviour is unchanged.
+     */
+    readonly scope?: readonly string[];
 }
+/** Compile one scope pattern into a matcher over repo-relative POSIX paths.
+ * Bare paths (no glob metachar) match the file itself or anything beneath it,
+ * so `--scope src/pipeline` onboards one pipeline directory without ceremony. */
+export declare function compileScope(pattern: string): (relPath: string) => boolean;
+/** True when `relPath` matches ANY scope (or no scope is set). */
+export declare function matchesScope(relPath: string, scope: readonly string[] | undefined): boolean;
 export declare const DEFAULT_SKIP_DIRS: readonly string[];
 export interface FileSystemLike {
     readdirSync(path: string, options: {

package/dist/init/finder.d.ts.map

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