@tangle-network/starter-foundry 0.7.2 → 0.13.0

package/dist/lib/run-record.d.ts

@@ -0,0 +1,105 @@
+/**
+ * RunRecord — typed substrate for every measured run in starter-foundry.
+ *
+ * One JSONL line per logical run. The schema mirrors the v0.16 agent-eval
+ * RunRecord shape so the swap is rename-only:
+ *
+ *   import { RunRecord, validateRunRecord, makeRunRecord } from '@tangle-network/agent-eval'
+ *
+ * and `rm src/lib/run-record.ts`.
+ *
+ * @public
+ *
+ * Runs are appended to `.evolve/runs.jsonl` (gitignored). Bare model aliases
+ * (`claude-sonnet-4-6` without `@<snapshot>` suffix) are rejected at write
+ * time — every emission MUST carry a pinned snapshot from
+ * `.evolve/snapshots.lock.json`. The only allowlisted exception is
+ * `splitTag === 'historical'` which carries `model: '<alias>@unknown-historical'`
+ * for runs migrated from pre-Gen-17 experiments.
+ */
+export interface RunRecordOutcome {
+    searchScore: number;
+    holdoutScore?: number;
+    raw: Record<string, number | boolean>;
+}
+export interface RunRecordTokenUsage {
+    input: number;
+    output: number;
+}
+export type RunRecordSplitTag = 'search' | 'holdout' | 'historical';
+export type RunRecordSource = 'foundry' | 'vb';
+export interface RunRecord {
+    /** Unique run id — `crypto.randomUUID()` unless dedup'd from content hash. */
+    runId: string;
+    /** Logical experiment grouping (e.g. generation slug). */
+    experimentId: string;
+    /** Identifies the variant under test. */
+    candidateId: string;
+    /** RNG seed for reproducibility. */
+    seed: number;
+    /**
+     * Model identifier. MUST be `<alias>@<snapshot>` form (e.g.
+     * `claude-sonnet-4-6@claude-sonnet-4-5-20250929`). The validator rejects
+     * bare aliases at write time. The CI bare-alias scan rejects them again
+     * post-hoc as a defense-in-depth check.
+     */
+    model: string;
+    /** sha256 of the effective prompt. */
+    promptHash: string;
+    /** sha256 of the role config. */
+    configHash: string;
+    /** `git rev-parse HEAD` at run start. */
+    commitSha: string;
+    wallMs: number;
+    /** USD cost computed from token usage × model rate. */
+    costUsd: number;
+    tokenUsage: RunRecordTokenUsage;
+    outcome: RunRecordOutcome;
+    splitTag: RunRecordSplitTag;
+    /** Failure-mode taxonomy key (first failing stage); omit on success. */
+    failureMode?: string;
+    /** Verticalbench coupling — distinguishes foundry-internal vs vb-feedback runs. */
+    source: RunRecordSource;
+}
+export interface MakeRunRecordInput {
+    experimentId: string;
+    candidateId: string;
+    seed: number;
+    model: string;
+    promptHash: string;
+    configHash: string;
+    wallMs: number;
+    costUsd: number;
+    tokenUsage: RunRecordTokenUsage;
+    outcome: RunRecordOutcome;
+    splitTag: RunRecordSplitTag;
+    source: RunRecordSource;
+    failureMode?: string;
+    /** Override commitSha — mainly for tests. Defaults to live `git rev-parse HEAD`. */
+    commitSha?: string;
+    /** Override runId — mainly for content-hash dedup. Defaults to `randomUUID()`. */
+    runId?: string;
+}
+export declare function sha256(input: string): string;
+/** Reset the cached HEAD sha. Test-only. */
+export declare function _resetCommitShaCache(): void;
+/**
+ * Validate that `model` is in `<alias>@<snapshot>` form, except for
+ * historical migrations which carry the sentinel snapshot.
+ */
+export declare function isPinnedModel(model: string, splitTag?: RunRecordSplitTag): boolean;
+export declare class RunRecordValidationError extends Error {
+    readonly issues: string[];
+    constructor(issues: string[]);
+}
+/**
+ * Validate an unknown payload as a RunRecord. Throws RunRecordValidationError
+ * on failure with the full list of issues. Returns the typed record on success.
+ */
+export declare function validateRunRecord(input: unknown): RunRecord;
+/**
+ * Build a RunRecord. Fills `runId` (random) + `commitSha` (live git HEAD)
+ * unless overridden. Validates before returning, so a bad input here throws.
+ */
+export declare function makeRunRecord(input: MakeRunRecordInput): RunRecord;
+export declare const HISTORICAL_SNAPSHOT = "unknown-historical";

package/dist/lib/run-record.js

@@ -0,0 +1,189 @@
+/**
+ * RunRecord — typed substrate for every measured run in starter-foundry.
+ *
+ * One JSONL line per logical run. The schema mirrors the v0.16 agent-eval
+ * RunRecord shape so the swap is rename-only:
+ *
+ *   import { RunRecord, validateRunRecord, makeRunRecord } from '@tangle-network/agent-eval'
+ *
+ * and `rm src/lib/run-record.ts`.
+ *
+ * @public
+ *
+ * Runs are appended to `.evolve/runs.jsonl` (gitignored). Bare model aliases
+ * (`claude-sonnet-4-6` without `@<snapshot>` suffix) are rejected at write
+ * time — every emission MUST carry a pinned snapshot from
+ * `.evolve/snapshots.lock.json`. The only allowlisted exception is
+ * `splitTag === 'historical'` which carries `model: '<alias>@unknown-historical'`
+ * for runs migrated from pre-Gen-17 experiments.
+ */
+import { execSync } from 'node:child_process';
+import { createHash, randomUUID } from 'node:crypto';
+const HISTORICAL_SNAPSHOT_SENTINEL = 'unknown-historical';
+export function sha256(input) {
+    return createHash('sha256').update(input).digest('hex');
+}
+let cachedHeadSha = null;
+function readHeadSha() {
+    if (cachedHeadSha !== null)
+        return cachedHeadSha;
+    try {
+        cachedHeadSha = execSync('git rev-parse HEAD', { stdio: ['ignore', 'pipe', 'ignore'] })
+            .toString()
+            .trim();
+    }
+    catch {
+        cachedHeadSha = 'unknown';
+    }
+    return cachedHeadSha;
+}
+/** Reset the cached HEAD sha. Test-only. */
+export function _resetCommitShaCache() {
+    cachedHeadSha = null;
+}
+/**
+ * Validate that `model` is in `<alias>@<snapshot>` form, except for
+ * historical migrations which carry the sentinel snapshot.
+ */
+export function isPinnedModel(model, splitTag) {
+    if (typeof model !== 'string' || !model.includes('@'))
+        return false;
+    const [alias, snapshot] = model.split('@');
+    if (!alias || !snapshot)
+        return false;
+    if (snapshot === HISTORICAL_SNAPSHOT_SENTINEL)
+        return splitTag === 'historical';
+    return true;
+}
+function isFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+function isNonEmptyString(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+function isStringRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export class RunRecordValidationError extends Error {
+    issues;
+    constructor(issues) {
+        super(`RunRecord validation failed: ${issues.join('; ')}`);
+        this.issues = issues;
+        this.name = 'RunRecordValidationError';
+    }
+}
+/**
+ * Validate an unknown payload as a RunRecord. Throws RunRecordValidationError
+ * on failure with the full list of issues. Returns the typed record on success.
+ */
+export function validateRunRecord(input) {
+    const issues = [];
+    if (!isStringRecord(input)) {
+        throw new RunRecordValidationError(['root must be an object']);
+    }
+    const record = input;
+    if (!isNonEmptyString(record.runId))
+        issues.push('runId must be non-empty string');
+    if (!isNonEmptyString(record.experimentId))
+        issues.push('experimentId must be non-empty string');
+    if (!isNonEmptyString(record.candidateId))
+        issues.push('candidateId must be non-empty string');
+    if (!Number.isInteger(record.seed))
+        issues.push('seed must be integer');
+    if (!isNonEmptyString(record.model))
+        issues.push('model must be non-empty string');
+    if (!isNonEmptyString(record.promptHash))
+        issues.push('promptHash must be non-empty string');
+    if (!isNonEmptyString(record.configHash))
+        issues.push('configHash must be non-empty string');
+    if (!isNonEmptyString(record.commitSha))
+        issues.push('commitSha must be non-empty string');
+    if (!isFiniteNumber(record.wallMs) || record.wallMs < 0)
+        issues.push('wallMs must be non-negative number');
+    if (!isFiniteNumber(record.costUsd) || record.costUsd < 0)
+        issues.push('costUsd must be non-negative number');
+    const tokenUsage = record.tokenUsage;
+    if (!isStringRecord(tokenUsage)) {
+        issues.push('tokenUsage must be object with input + output');
+    }
+    else {
+        if (!Number.isInteger(tokenUsage.input))
+            issues.push('tokenUsage.input must be integer');
+        if (!Number.isInteger(tokenUsage.output))
+            issues.push('tokenUsage.output must be integer');
+    }
+    const outcome = record.outcome;
+    if (!isStringRecord(outcome)) {
+        issues.push('outcome must be object');
+    }
+    else {
+        if (!isFiniteNumber(outcome.searchScore))
+            issues.push('outcome.searchScore must be number');
+        const holdoutScore = outcome.holdoutScore;
+        if (holdoutScore !== undefined && !isFiniteNumber(holdoutScore))
+            issues.push('outcome.holdoutScore must be number when present');
+        const raw = outcome.raw;
+        if (!isStringRecord(raw)) {
+            issues.push('outcome.raw must be object');
+        }
+        else {
+            for (const [k, v] of Object.entries(raw)) {
+                if (!isFiniteNumber(v) && !isBoolean(v))
+                    issues.push(`outcome.raw.${k} must be number or boolean`);
+            }
+        }
+    }
+    const splitTag = record.splitTag;
+    const splitTagValid = splitTag === 'search' || splitTag === 'holdout' || splitTag === 'historical';
+    if (!splitTagValid) {
+        issues.push("splitTag must be 'search' | 'holdout' | 'historical'");
+    }
+    const source = record.source;
+    if (source !== 'foundry' && source !== 'vb') {
+        issues.push("source must be 'foundry' | 'vb'");
+    }
+    if (record.failureMode !== undefined && !isNonEmptyString(record.failureMode)) {
+        issues.push('failureMode must be non-empty string when present');
+    }
+    const splitTagForCheck = splitTagValid ? splitTag : undefined;
+    if (isNonEmptyString(record.model) && !isPinnedModel(record.model, splitTagForCheck)) {
+        issues.push(`model "${record.model}" is not pinned — must be <alias>@<snapshot> form ` +
+            `(historical entries may use @${HISTORICAL_SNAPSHOT_SENTINEL})`);
+    }
+    if (issues.length > 0)
+        throw new RunRecordValidationError(issues);
+    return record;
+}
+/**
+ * Build a RunRecord. Fills `runId` (random) + `commitSha` (live git HEAD)
+ * unless overridden. Validates before returning, so a bad input here throws.
+ */
+export function makeRunRecord(input) {
+    const record = {
+        runId: input.runId ?? randomUUID(),
+        experimentId: input.experimentId,
+        candidateId: input.candidateId,
+        seed: input.seed,
+        model: input.model,
+        promptHash: input.promptHash,
+        configHash: input.configHash,
+        commitSha: input.commitSha ?? readHeadSha(),
+        wallMs: input.wallMs,
+        costUsd: input.costUsd,
+        tokenUsage: { input: input.tokenUsage.input, output: input.tokenUsage.output },
+        outcome: {
+            searchScore: input.outcome.searchScore,
+            raw: { ...input.outcome.raw },
+            ...(input.outcome.holdoutScore !== undefined ? { holdoutScore: input.outcome.holdoutScore } : {}),
+        },
+        splitTag: input.splitTag,
+        source: input.source,
+        ...(input.failureMode !== undefined ? { failureMode: input.failureMode } : {}),
+    };
+    return validateRunRecord(record);
+}
+export const HISTORICAL_SNAPSHOT = HISTORICAL_SNAPSHOT_SENTINEL;
+//# sourceMappingURL=run-record.js.map

package/dist/lib/run-record.js.map

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

package/dist/lib/safety/license-check.js

@@ -5,22 +5,30 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 // Conservative block list — scopes NOT to ship in a commercial scaffold
 // without the user's explicit acknowledgement.
-const COPYLEFT_LICENSES = new Set(['GPL-2.0', 'GPL-3.0', 'AGPL-3.0', 'SSPL-1.0', 'GPL-2.0-only', 'GPL-3.0-only', 'AGPL-3.0-only']);
+const COPYLEFT_LICENSES = new Set([
+    'GPL-2.0',
+    'GPL-3.0',
+    'AGPL-3.0',
+    'SSPL-1.0',
+    'GPL-2.0-only',
+    'GPL-3.0-only',
+    'AGPL-3.0-only',
+]);
 // Best-effort package-license lookup. For the hot path, we rely on the
 // consumer's node_modules/<pkg>/package.json license field (read once,
 // cached). For the deterministic dev path, we use a tiny hand-curated
 // override map + default to 'unknown'.
 const KNOWN_LICENSES = {
     // (fill in over time from observed audit results — this is a seed).
-    'vllm': 'Apache-2.0',
-    'stripe': 'MIT',
-    'ethers': 'MIT',
-    'viem': 'MIT',
-    'react': 'MIT',
-    'next': 'MIT',
-    'svelte': 'MIT',
-    'vue': 'MIT',
-    'langchain': 'MIT',
+    vllm: 'Apache-2.0',
+    stripe: 'MIT',
+    ethers: 'MIT',
+    viem: 'MIT',
+    react: 'MIT',
+    next: 'MIT',
+    svelte: 'MIT',
+    vue: 'MIT',
+    langchain: 'MIT',
     '@mysten/sui': 'Apache-2.0',
 };
 async function readPackageLicense(outDir, name) {

package/dist/lib/safety/license-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"license-check.js","sourceRoot":"","sources":["../../../src/lib/safety/license-check.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,2EAA2E;AAC3E,qEAAqE;AAErE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACjC,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,wEAAwE;AACxE,+CAA+C;AAC/C,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC,CAAA;AAQlI,uEAAuE;AACvE,uEAAuE;AACvE,sEAAsE;AACtE,uCAAuC;AACvC,MAAM,cAAc,GAA2B;IAC7C,oEAAoE;IACpE,MAAM,EAAE,YAAY;IACpB,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,KAAK;IACf,KAAK,EAAE,KAAK;IACZ,WAAW,EAAE,KAAK;IAClB,aAAa,EAAE,YAAY;CAC5B,CAAA;AAED,KAAK,UAAU,kBAAkB,CAAC,MAAc,EAAE,IAAY;IAC5D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAA;QAC9F,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA6C,CAAA;QACvE,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,OAAO,CAAA;QACvD,IAAI,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,CAAC,OAAO;YAAE,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAA;QAC5G,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAA;IAAC,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAmD;IACpF,MAAM,KAAK,GAAkB,EAAE,CAAA;IAC/B,IAAI,GAAG,CAAA;IACP,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAEjF,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAA;IAAC,CAAC;IAExB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,CAAC,MAAM,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,SAAS,CAAA;QAClG,IAAI,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,IAAI;gBACb,OAAO;gBACP,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;aACnD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}
+{"version":3,"file":"license-check.js","sourceRoot":"","sources":["../../../src/lib/safety/license-check.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,2EAA2E;AAC3E,qEAAqE;AAErE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACjC,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,wEAAwE;AACxE,+CAA+C;AAC/C,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,SAAS;IACT,SAAS;IACT,UAAU;IACV,UAAU;IACV,cAAc;IACd,cAAc;IACd,eAAe;CAChB,CAAC,CAAA;AAQF,uEAAuE;AACvE,uEAAuE;AACvE,sEAAsE;AACtE,uCAAuC;AACvC,MAAM,cAAc,GAA2B;IAC7C,oEAAoE;IACpE,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,KAAK;IACZ,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;IACb,GAAG,EAAE,KAAK;IACV,SAAS,EAAE,KAAK;IAChB,aAAa,EAAE,YAAY;CAC5B,CAAA;AAED,KAAK,UAAU,kBAAkB,CAAC,MAAc,EAAE,IAAY;IAC5D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAA;QAC9F,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA6C,CAAA;QACvE,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,GAAG,CAAC,OAAO,CAAA;QACvD,IAAI,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,IAAI,GAAG,CAAC,OAAO;YACzE,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAA;QACjC,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAGlC;IACC,MAAM,KAAK,GAAkB,EAAE,CAAA;IAC/B,IAAI,GAAG,CAAA;IACP,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAEjF,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;QACvD,MAAM,OAAO,GACX,CAAC,MAAM,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,SAAS,CAAA;QACpF,IAAI,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,IAAI;gBACb,OAAO;gBACP,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;aACnD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/lib/safety/secret-scan.js

@@ -21,7 +21,21 @@ const PATTERNS = [
 // Directories we don't scan — binary / generated / huge.
 const SKIP_DIRS = new Set(['node_modules', 'pkg', 'target', 'dist', '.git', '.next', '.turbo']);
 // Extensions we don't bother reading.
-const SKIP_EXTS = new Set(['.png', '.jpg', '.jpeg', '.gif', '.webp', '.ico', '.svg', '.woff', '.woff2', '.ttf', '.otf', '.wasm', '.lockb']);
+const SKIP_EXTS = new Set([
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.webp',
+    '.ico',
+    '.svg',
+    '.woff',
+    '.woff2',
+    '.ttf',
+    '.otf',
+    '.wasm',
+    '.lockb',
+]);
 async function walk(dir, onFile, root = dir) {
     const entries = await fs.readdir(dir, { withFileTypes: true });
     for (const entry of entries) {

package/dist/lib/safety/secret-scan.js.map

@@ -1 +1 @@
-{"version":3,"file":"secret-scan.js","sourceRoot":"","sources":["../../../src/lib/safety/secret-scan.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"secret-scan.js","sourceRoot":"","sources":["../../../src/lib/safety/secret-scan.ts"],"names":[],"mappings":"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"}

package/dist/lib/selection.d.ts

@@ -21,6 +21,21 @@ export declare function selectTemplateVersion(familyId: string, seed: string, op
     repoRoot?: string;
     envDiverseServe?: string;
 }): string | null;
+/**
+ * Detect "technical identifier" shape: a kebab-case cluster of ≥2 hyphen-
+ * separated tokens with no spaces and no natural-language verbs/articles.
+ * This is what BA's H1 canonical-scaffold catalog feeds in (compiler-lexer-dfa,
+ * algo-suffix-array-sais, todo-asyncstorage, godot-character-movement). Such
+ * prompts that score 0 against all family keywords are UNROUTEABLE — refusing
+ * to silently degrade is the resilient behavior.
+ *
+ * Returns true ONLY when ALL hold:
+ *   - No whitespace (a real prompt has at least one space)
+ *   - At least 2 hyphens (rules out single words like `bot` or `agent`)
+ *   - All characters are [a-z0-9-] (no punctuation, no digits-only)
+ *   - No natural-language stopwords (a, an, the, of, for, with, my, your)
+ */
+export declare function isTechnicalIdShape(prompt: string): boolean;
 export declare function selectStarter({ prompt, partner, }: {
     prompt: string;
     partner?: string | null;