@matteeh/osq 0.2.0 → 0.2.2

package/dist/core/foundation/config-file.js

@@ -0,0 +1,46 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { createJiti } from 'jiti';
+import { PACKAGE_ENTRY } from './package-root.js';
+/** A config file that exists but fails to import or validate. */
+export class ConfigLoadError extends Error {
+    constructor(configPath, cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        super(`Failed to load ${configPath}: ${message}`);
+        this.name = 'ConfigLoadError';
+    }
+}
+const CONFIG_FILES = ['osq.config.ts', 'osq.config.js', 'osq.config.mjs'];
+const isFile = (target) => fs
+    .stat(target)
+    .then(() => true)
+    .catch(() => false);
+/**
+ * Import the first existing config file through jiti, aliasing `@matteeh/osq`
+ * to the running osq so a project without its own `node_modules` still loads a
+ * scaffolded config. A file that fails to import rejects with a `ConfigLoadError`
+ * naming it; no config file resolves to an empty user config.
+ */
+export async function loadConfigFile(projectRoot) {
+    for (const file of CONFIG_FILES) {
+        const fullPath = path.join(projectRoot, file);
+        if (!(await isFile(fullPath)))
+            continue;
+        try {
+            const jiti = createJiti(import.meta.url, {
+                moduleCache: false,
+                interopDefault: true,
+                alias: { '@matteeh/osq': PACKAGE_ENTRY },
+            });
+            const loaded = await jiti.import(fullPath);
+            const resolved = loaded?.default || loaded;
+            const userConfig = typeof resolved === 'object' && resolved !== null ? resolved : {};
+            return { userConfig, path: fullPath };
+        }
+        catch (err) {
+            throw new ConfigLoadError(fullPath, err);
+        }
+    }
+    return { userConfig: {} };
+}
+//# sourceMappingURL=config-file.js.map

package/dist/core/foundation/config-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.js","sourceRoot":"","sources":["../../../src/core/foundation/config-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,iEAAiE;AACjE,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,UAAkB,EAAE,KAAc;QAC5C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,KAAK,CAAC,kBAAkB,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAQD,MAAM,YAAY,GAAG,CAAC,eAAe,EAAE,eAAe,EAAE,gBAAgB,CAAC,CAAC;AAE1E,MAAM,MAAM,GAAG,CAAC,MAAc,EAAoB,EAAE,CAClD,EAAE;KACC,IAAI,CAAC,MAAM,CAAC;KACZ,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;KAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YAAE,SAAS;QACxC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;gBACvC,WAAW,EAAE,KAAK;gBAClB,cAAc,EAAE,IAAI;gBACpB,KAAK,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE;aACzC,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,QAAQ,GAAI,MAAsC,EAAE,OAAO,IAAI,MAAM,CAAC;YAC5E,MAAM,UAAU,GACd,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAE,QAA0B,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;AAC5B,CAAC"}

package/dist/core/foundation/config-gates.d.ts

@@ -11,6 +11,8 @@ export interface GatesConfig {
     readonly changeVerifyAfterTask: boolean;
     readonly preSpawnVerify?: PreSpawnVerifyMode;
     readonly autoRetries?: number;
+    /** The command the watcher runs as a change's baseline, when configured. */
+    readonly baselineVerify?: string;
 }
 export declare const DEFAULT_GATES_CONFIG: GatesConfig;
 /**

package/dist/core/foundation/config-gates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-gates.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-gates.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,eAAO,MAAM,oBAAoB,EAAE,WAIlC,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAkC/D"}
+{"version":3,"file":"config-gates.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-gates.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,oBAAoB,EAAE,WAIlC,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CA0C/D"}

package/dist/core/foundation/config-gates.js

@@ -34,10 +34,18 @@ export function validateGatesConfig(gates) {
         autoRetriesRaw < 0) {
         throw new Error('gates.autoRetries must be a non-negative integer');
     }
+    let baselineVerify;
+    if (record.baselineVerify !== undefined) {
+        if (typeof record.baselineVerify !== 'string' || record.baselineVerify.trim().length === 0) {
+            throw new Error('gates.baselineVerify must be a non-empty command');
+        }
+        baselineVerify = record.baselineVerify.trim();
+    }
     return {
         changeVerifyAfterTask: value,
         preSpawnVerify: preSpawnRaw,
         autoRetries: autoRetriesRaw,
+        ...(baselineVerify !== undefined ? { baselineVerify } : {}),
     };
 }
 //# sourceMappingURL=config-gates.js.map

package/dist/core/foundation/config-gates.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-gates.js","sourceRoot":"","sources":["../../../src/core/foundation/config-gates.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,qBAAqB,EAAE,IAAI;IAC3B,cAAc,EAAE,MAAM;IACtB,WAAW,EAAE,CAAC;CACf,CAAC;AAEF,MAAM,sBAAsB,GAAkC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAEtF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,oBAAoB,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,KAAK,GACT,MAAM,CAAC,qBAAqB,KAAK,SAAS;QACxC,CAAC,CAAC,oBAAoB,CAAC,qBAAqB;QAC5C,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC;IACnC,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,WAAW,GACf,MAAM,CAAC,cAAc,KAAK,SAAS;QACjC,CAAC,CAAC,oBAAoB,CAAC,cAAc;QACrC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;IAC5B,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,WAAiC,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,cAAc,GAClB,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;IAC3F,IACE,OAAO,cAAc,KAAK,QAAQ;QAClC,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC;QACjC,cAAc,GAAG,CAAC,EAClB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO;QACL,qBAAqB,EAAE,KAAK;QAC5B,cAAc,EAAE,WAAiC;QACjD,WAAW,EAAE,cAAc;KAC5B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"config-gates.js","sourceRoot":"","sources":["../../../src/core/foundation/config-gates.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,qBAAqB,EAAE,IAAI;IAC3B,cAAc,EAAE,MAAM;IACtB,WAAW,EAAE,CAAC;CACf,CAAC;AAEF,MAAM,sBAAsB,GAAkC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAEtF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,oBAAoB,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,KAAK,GACT,MAAM,CAAC,qBAAqB,KAAK,SAAS;QACxC,CAAC,CAAC,oBAAoB,CAAC,qBAAqB;QAC5C,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC;IACnC,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,MAAM,WAAW,GACf,MAAM,CAAC,cAAc,KAAK,SAAS;QACjC,CAAC,CAAC,oBAAoB,CAAC,cAAc;QACrC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;IAC5B,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,WAAiC,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,cAAc,GAClB,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;IAC3F,IACE,OAAO,cAAc,KAAK,QAAQ;QAClC,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC;QACjC,cAAc,GAAG,CAAC,EAClB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,cAAkC,CAAC;IACvC,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QACxC,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,IAAI,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3F,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IAChD,CAAC;IACD,OAAO;QACL,qBAAqB,EAAE,KAAK;QAC5B,cAAc,EAAE,WAAiC;QACjD,WAAW,EAAE,cAAc;QAC3B,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC"}

package/dist/core/foundation/config-opencode.d.ts

@@ -0,0 +1,25 @@
+import type { HarnessDiagnoseContext, HarnessDiagnosis } from './config-pi.js';
+/** Tested opencode release range. opencode 1 is deliberately out of support. */
+export declare const OPENCODE_TESTED_RANGE = ">=2.0.0 <3.0.0";
+/** Assessment of one `opencode --version` line against the tested range. */
+export interface OpencodeVersionAssessment {
+    /** Extracted `major.minor.patch`, or the raw first line when unparseable. */
+    readonly version: string;
+    /** False only below 2.0.0, the one version that is a hard failure. */
+    readonly ok: boolean;
+    /** True only inside `>=2.0.0 <3.0.0`. */
+    readonly tested: boolean;
+}
+/**
+ * Assess the first `major.minor.patch` in `opencode --version` output, so
+ * `opencode v2.0.18` reads as `2.0.18`. Below 2.0.0 is a failure; a version at
+ * or above 3.0.0, or output with no readable version, is a passing warning.
+ */
+export declare function assessOpencodeVersion(raw: string): OpencodeVersionAssessment;
+/**
+ * Version check for `osq doctor`. Inside the tested range the check passes
+ * silently; below 2.0.0 it fails because the adapter no longer supports
+ * opencode 1; above the range and unparseable output pass with a warning.
+ */
+export declare function diagnoseOpencode(context: HarnessDiagnoseContext): Promise<readonly HarnessDiagnosis[]>;
+//# sourceMappingURL=config-opencode.d.ts.map

package/dist/core/foundation/config-opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-opencode.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-opencode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE/E,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAKtD,4EAA4E;AAC5E,MAAM,WAAW,yBAAyB;IACxC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAYD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,CAW5E;AAYD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAWtC"}

package/dist/core/foundation/config-opencode.js

@@ -0,0 +1,55 @@
+/** Tested opencode release range. opencode 1 is deliberately out of support. */
+export const OPENCODE_TESTED_RANGE = '>=2.0.0 <3.0.0';
+const OPENCODE_TESTED_MIN = [2, 0, 0];
+const OPENCODE_TESTED_MAX = [3, 0, 0];
+function compareVersion(a, b) {
+    for (let i = 0; i < 3; i += 1) {
+        if (a[i] !== b[i])
+            return (a[i] ?? 0) - (b[i] ?? 0);
+    }
+    return 0;
+}
+/**
+ * Assess the first `major.minor.patch` in `opencode --version` output, so
+ * `opencode v2.0.18` reads as `2.0.18`. Below 2.0.0 is a failure; a version at
+ * or above 3.0.0, or output with no readable version, is a passing warning.
+ */
+export function assessOpencodeVersion(raw) {
+    const line = raw.trim().split('\n')[0]?.trim() ?? '';
+    const match = /(\d+)\.(\d+)\.(\d+)/.exec(line);
+    if (!match) {
+        return { version: line, ok: true, tested: false };
+    }
+    const version = `${match[1]}.${match[2]}.${match[3]}`;
+    const current = [Number(match[1]), Number(match[2]), Number(match[3])];
+    const atLeastMinimum = compareVersion(current, OPENCODE_TESTED_MIN) >= 0;
+    const tested = atLeastMinimum && compareVersion(current, OPENCODE_TESTED_MAX) < 0;
+    return { version, ok: atLeastMinimum, tested };
+}
+function versionMessage(assessment) {
+    if (assessment.tested) {
+        return `opencode ${assessment.version} (tested ${OPENCODE_TESTED_RANGE})`;
+    }
+    if (assessment.ok) {
+        return `opencode ${assessment.version} is outside the tested range ${OPENCODE_TESTED_RANGE}`;
+    }
+    return `opencode ${assessment.version} is not supported; the opencode adapter needs opencode 2 (tested ${OPENCODE_TESTED_RANGE})`;
+}
+/**
+ * Version check for `osq doctor`. Inside the tested range the check passes
+ * silently; below 2.0.0 it fails because the adapter no longer supports
+ * opencode 1; above the range and unparseable output pass with a warning.
+ */
+export async function diagnoseOpencode(context) {
+    const assessment = assessOpencodeVersion(context.version);
+    const warns = assessment.ok && !assessment.tested;
+    return [
+        {
+            name: 'harness-version',
+            ok: assessment.ok,
+            ...(warns ? { warning: true } : {}),
+            message: versionMessage(assessment),
+        },
+    ];
+}
+//# sourceMappingURL=config-opencode.js.map

package/dist/core/foundation/config-opencode.js.map

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

package/dist/core/foundation/config-pi.d.ts

@@ -54,6 +54,16 @@ export declare function resolvePiEffort(config?: {
         readonly thinking?: string;
     };
 }): string | null;
+/**
+ * Pi execution model: explicit `pi.model`, then `OSQ_MODEL` only when Pi is the
+ * selected executor. `undefined` defers to Pi's native default. The selected
+ * check is supplied by the caller so the catalog owns harness-name knowledge.
+ */
+export declare function resolvePiModel(config?: {
+    readonly pi?: {
+        readonly model?: string;
+    };
+}, selected?: boolean): string | undefined;
 /** Version warning plus provider credential check for `osq doctor`. */
 export declare function diagnosePi(context: HarnessDiagnoseContext): Promise<readonly HarnessDiagnosis[]>;
 /**

package/dist/core/foundation/config-pi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-pi.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-pi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,QAAQ,CAkBtD;AAED,+EAA+E;AAC/E,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAKlD,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAYD,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAmBhE;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAM5F;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE;IACvC,QAAQ,CAAC,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C,GAAG,MAAM,GAAG,IAAI,CAEhB;AAED,uEAAuE;AACvE,wBAAsB,UAAU,CAC9B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CA4BtC;AAmBD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,cAAc,SAAK,GAClB,OAAO,CAAC,YAAY,CAAC,CAoBvB"}
+{"version":3,"file":"config-pi.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-pi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,QAAQ,CAkBtD;AAED,+EAA+E;AAC/E,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAKlD,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAYD,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAmBhE;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAM5F;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE;IACvC,QAAQ,CAAC,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C,GAAG,MAAM,GAAG,IAAI,CAEhB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EACtD,QAAQ,UAAQ,GACf,MAAM,GAAG,SAAS,CAKpB;AAED,uEAAuE;AACvE,wBAAsB,UAAU,CAC9B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CA4BtC;AAmBD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,cAAc,SAAK,GAClB,OAAO,CAAC,YAAY,CAAC,CAoBvB"}

package/dist/core/foundation/config-pi.js

@@ -67,6 +67,19 @@ export function resolvePiBinary(config) {
 export function resolvePiEffort(config) {
     return config?.pi?.thinking?.trim() || null;
 }
+/**
+ * Pi execution model: explicit `pi.model`, then `OSQ_MODEL` only when Pi is the
+ * selected executor. `undefined` defers to Pi's native default. The selected
+ * check is supplied by the caller so the catalog owns harness-name knowledge.
+ */
+export function resolvePiModel(config, selected = false) {
+    const explicit = config?.pi?.model?.trim();
+    if (explicit)
+        return explicit;
+    if (!selected)
+        return undefined;
+    return process.env.OSQ_MODEL?.trim() || undefined;
+}
 /** Version warning plus provider credential check for `osq doctor`. */
 export async function diagnosePi(context) {
     const assessment = assessPiVersion(context.version);

package/dist/core/foundation/config-pi.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-pi.js","sourceRoot":"","sources":["../../../src/core/foundation/config-pi.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config-pi.js","sourceRoot":"","sources":["../../../src/core/foundation/config-pi.ts"],"names":[],"mappings":"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"}

package/dist/core/foundation/config-planning.d.ts

@@ -2,7 +2,9 @@
  * Planning measurement settings. `idleGapMinutes` bounds the gap between two
  * owned turns that still counts as active planning; `prices` optionally maps a
  * model id to USD per million tokens so a slice can be priced when no harness
- * reported a cost. osq ships no price table of its own.
+ * reported a cost. `disclosures` bounds the executor disclosures the plan
+ * prompt quotes from recent archived changes. osq ships no price table of its
+ * own.
  */
 export interface PlanningPrice {
     readonly input: number;
@@ -10,10 +12,19 @@ export interface PlanningPrice {
     readonly cacheRead: number;
     readonly cacheWrite: number;
 }
+/** Bounds on the executor disclosures quoted in the plan prompt. */
+export interface PlanningDisclosuresConfig {
+    /** How many of the newest archived changes may contribute disclosures. */
+    readonly recentChanges: number;
+    /** Total characters of quoted disclosure entries, excluding the claim line. */
+    readonly maxCharacters: number;
+}
 export interface PlanningConfig {
     readonly idleGapMinutes: number;
+    readonly disclosures: PlanningDisclosuresConfig;
     readonly prices?: Readonly<Record<string, PlanningPrice>>;
 }
+export declare const DEFAULT_PLANNING_DISCLOSURES: PlanningDisclosuresConfig;
 export declare const DEFAULT_PLANNING_CONFIG: PlanningConfig;
 /**
  * Validate an optional `planning` block over the defaults. A partial block

package/dist/core/foundation/config-planning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-planning.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-planning.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CAC3D;AAED,eAAO,MAAM,uBAAuB,EAAE,cAErC,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,CAmBxE"}
+{"version":3,"file":"config-planning.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-planning.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,oEAAoE;AACpE,MAAM,WAAW,yBAAyB;IACxC,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CAC3D;AAED,eAAO,MAAM,4BAA4B,EAAE,yBAG1C,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,cAGrC,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,CAsBxE"}

package/dist/core/foundation/config-planning.js

@@ -1,5 +1,10 @@
+export const DEFAULT_PLANNING_DISCLOSURES = {
+    recentChanges: 3,
+    maxCharacters: 4000,
+};
 export const DEFAULT_PLANNING_CONFIG = {
     idleGapMinutes: 10,
+    disclosures: DEFAULT_PLANNING_DISCLOSURES,
 };
 const PRICE_KINDS = ['input', 'output', 'cacheRead', 'cacheWrite'];
 /**
@@ -22,8 +27,31 @@ export function validatePlanningConfig(planning) {
         idleGapMinutes <= 0) {
         throw new Error('planning.idleGapMinutes must be a positive finite number');
     }
+    const disclosures = validatePlanningDisclosures(record.disclosures);
     const prices = validatePlanningPrices(record.prices);
-    return prices === undefined ? { idleGapMinutes } : { idleGapMinutes, prices };
+    return prices === undefined
+        ? { idleGapMinutes, disclosures }
+        : { idleGapMinutes, disclosures, prices };
+}
+function validatePlanningDisclosures(disclosures) {
+    if (disclosures === undefined)
+        return DEFAULT_PLANNING_DISCLOSURES;
+    if (typeof disclosures !== 'object' || disclosures === null || Array.isArray(disclosures)) {
+        throw new Error('planning.disclosures must be an object with recentChanges and maxCharacters');
+    }
+    const record = disclosures;
+    return {
+        recentChanges: validateDisclosureCount('recentChanges', record.recentChanges, DEFAULT_PLANNING_DISCLOSURES.recentChanges),
+        maxCharacters: validateDisclosureCount('maxCharacters', record.maxCharacters, DEFAULT_PLANNING_DISCLOSURES.maxCharacters),
+    };
+}
+/** A partial `disclosures` block keeps defaults; every value is a positive integer. */
+function validateDisclosureCount(key, value, fallback) {
+    const resolved = value === undefined ? fallback : value;
+    if (typeof resolved !== 'number' || !Number.isInteger(resolved) || resolved <= 0) {
+        throw new Error(`planning.disclosures.${key} must be a positive integer`);
+    }
+    return resolved;
 }
 function validatePlanningPrices(prices) {
     if (prices === undefined)

package/dist/core/foundation/config-planning.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-planning.js","sourceRoot":"","sources":["../../../src/core/foundation/config-planning.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,cAAc,EAAE,EAAE;CACnB,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AAE5E;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACtD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,uBAAuB,CAAC;IAC3D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,MAAM,GAAG,QAAmC,CAAC;IACnD,MAAM,cAAc,GAClB,MAAM,CAAC,cAAc,KAAK,SAAS;QACjC,CAAC,CAAC,uBAAuB,CAAC,cAAc;QACxC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;IAC5B,IACE,OAAO,cAAc,KAAK,QAAQ;QAClC,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC;QAChC,cAAc,IAAI,CAAC,EACnB,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;AAChF,CAAC;AAED,SAAS,sBAAsB,CAC7B,MAAe;IAEf,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,MAAM,GAAkC,EAAE,CAAC;IACjD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,EAAE,CAAC;QAC/E,MAAM,CAAC,KAAK,CAAC,GAAG,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa,EAAE,KAAc;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,mBAAmB,KAAK,8DAA8D,CACvF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,KAAK,GAAiD;QAC1D,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;KACd,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,IAAI,IAAI,uCAAuC,CAAC,CAAC;QAC3F,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"config-planning.js","sourceRoot":"","sources":["../../../src/core/foundation/config-planning.ts"],"names":[],"mappings":"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"}

package/dist/core/foundation/config-traceability.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Scenario traceability. `capabilities` opts capabilities in, either every
+ * capability with `'all'` or a list of names; `mode` turns each finding into a
+ * warning or an error; `focusedTests` is an optional command with a `{files}`
+ * placeholder, left out of the resolved block when unset; `mutation` is an
+ * optional command and budget, also left out when unset.
+ */
+export type TraceabilityMode = 'warn' | 'require';
+/** The project's mutation command and its per-task wall-time budget. */
+export interface MutationConfig {
+    readonly command: string;
+    readonly budgetSeconds: number;
+}
+export interface TraceabilityConfig {
+    readonly capabilities: 'all' | readonly string[];
+    readonly mode: TraceabilityMode;
+    readonly focusedTests?: string;
+    readonly mutation?: MutationConfig;
+}
+/** Default wall-time budget for one task's mutation check. */
+export declare const DEFAULT_MUTATION_BUDGET_SECONDS = 300;
+export declare const DEFAULT_TRACEABILITY_CONFIG: TraceabilityConfig;
+/**
+ * Validate an optional `traceability` block over the defaults. A partial block
+ * keeps each missing default; a value outside its type is rejected.
+ */
+export declare function validateTraceabilityConfig(traceability: unknown): TraceabilityConfig;
+//# sourceMappingURL=config-traceability.d.ts.map

package/dist/core/foundation/config-traceability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-traceability.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-traceability.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAAC;AAElD,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,KAAK,GAAG,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;CACpC;AAED,8DAA8D;AAC9D,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,eAAO,MAAM,2BAA2B,EAAE,kBAGzC,CAAC;AA2BF;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,OAAO,GAAG,kBAAkB,CA8BpF"}

package/dist/core/foundation/config-traceability.js

@@ -0,0 +1,63 @@
+/** Default wall-time budget for one task's mutation check. */
+export const DEFAULT_MUTATION_BUDGET_SECONDS = 300;
+export const DEFAULT_TRACEABILITY_CONFIG = {
+    capabilities: [],
+    mode: 'warn',
+};
+const TRACEABILITY_MODES = ['warn', 'require'];
+function isCapabilities(value) {
+    if (value === 'all')
+        return true;
+    return Array.isArray(value) && value.every((entry) => typeof entry === 'string');
+}
+/** Validate an optional `mutation` block; the budget defaults when omitted. */
+function validateMutationConfig(mutation) {
+    const record = typeof mutation === 'object' && mutation !== null && !Array.isArray(mutation)
+        ? mutation
+        : {};
+    const command = record.command;
+    if (typeof command !== 'string' || command.trim() === '') {
+        throw new Error('traceability.mutation.command must be a non-empty command');
+    }
+    const budgetSeconds = record.budgetSeconds === undefined ? DEFAULT_MUTATION_BUDGET_SECONDS : record.budgetSeconds;
+    if (typeof budgetSeconds !== 'number' || !Number.isFinite(budgetSeconds) || budgetSeconds <= 0) {
+        throw new Error('traceability.mutation.budgetSeconds must be a positive number');
+    }
+    return { command, budgetSeconds };
+}
+/**
+ * Validate an optional `traceability` block over the defaults. A partial block
+ * keeps each missing default; a value outside its type is rejected.
+ */
+export function validateTraceabilityConfig(traceability) {
+    if (traceability === undefined)
+        return DEFAULT_TRACEABILITY_CONFIG;
+    if (typeof traceability !== 'object' || traceability === null || Array.isArray(traceability)) {
+        throw new Error('traceability configuration must be an object');
+    }
+    const record = traceability;
+    const capabilities = record.capabilities === undefined
+        ? DEFAULT_TRACEABILITY_CONFIG.capabilities
+        : record.capabilities;
+    if (!isCapabilities(capabilities)) {
+        throw new Error("traceability.capabilities must be 'all' or a list of capability names");
+    }
+    const mode = record.mode === undefined ? DEFAULT_TRACEABILITY_CONFIG.mode : record.mode;
+    if (!TRACEABILITY_MODES.includes(mode)) {
+        throw new Error('traceability.mode must be one of warn, require');
+    }
+    const focusedTests = record.focusedTests;
+    if (focusedTests !== undefined) {
+        if (typeof focusedTests !== 'string' || !focusedTests.includes('{files}')) {
+            throw new Error('traceability.focusedTests must be a command containing {files}');
+        }
+    }
+    const mutation = record.mutation;
+    return {
+        capabilities,
+        mode: mode,
+        ...(focusedTests !== undefined ? { focusedTests } : {}),
+        ...(mutation !== undefined ? { mutation: validateMutationConfig(mutation) } : {}),
+    };
+}
+//# sourceMappingURL=config-traceability.js.map

package/dist/core/foundation/config-traceability.js.map

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

package/dist/core/foundation/config-user.d.ts

@@ -0,0 +1,32 @@
+import type { ClaudeConfig } from './config-claude.js';
+import type { CodexConfig } from './config-codex.js';
+import type { GatesConfig } from './config-gates.js';
+import type { PiConfig } from './config-pi.js';
+import type { PlanningConfig } from './config-planning.js';
+import type { QueueConfig } from './config-queue.js';
+import type { TraceabilityConfig } from './config-traceability.js';
+import type { VcsConfig } from './config-vcs.js';
+import type { AgyConfig, LogConfig, OpencodeConfig, OsqConfig, OsqLimits, OsqPaths, OsqTimeouts, PlannerConfig } from './config.js';
+/**
+ * Consumer-authored partial configuration accepted by `defineConfig`. Harness
+ * sections with extra resolved fields (codex, pi, claude) are re-declared as
+ * partial so callers never have to spell out defaults.
+ */
+export type OsqUserConfig = Partial<Omit<OsqConfig, 'limits' | 'paths' | 'timeouts' | 'codex' | 'pi' | 'claude' | 'log' | 'planner' | 'planning' | 'queue' | 'gates' | 'traceability' | 'vcs'>> & {
+    readonly limits?: Partial<OsqLimits>;
+    readonly paths?: Partial<OsqPaths>;
+    readonly timeouts?: Partial<OsqTimeouts>;
+    readonly agy?: Partial<AgyConfig>;
+    readonly opencode?: Partial<OpencodeConfig>;
+    readonly codex?: Partial<CodexConfig>;
+    readonly pi?: Partial<PiConfig>;
+    readonly claude?: Partial<ClaudeConfig>;
+    readonly log?: Partial<LogConfig>;
+    readonly planner?: Partial<PlannerConfig>;
+    readonly planning?: Partial<PlanningConfig>;
+    readonly queue?: Partial<QueueConfig>;
+    readonly gates?: Partial<GatesConfig>;
+    readonly traceability?: Partial<TraceabilityConfig>;
+    readonly vcs?: Partial<VcsConfig>;
+};
+//# sourceMappingURL=config-user.d.ts.map

package/dist/core/foundation/config-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-user.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,cAAc,EACd,SAAS,EACT,SAAS,EACT,QAAQ,EACR,WAAW,EACX,aAAa,EACd,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CACjC,IAAI,CACF,SAAS,EACP,QAAQ,GACR,OAAO,GACP,UAAU,GACV,OAAO,GACP,IAAI,GACJ,QAAQ,GACR,KAAK,GACL,SAAS,GACT,UAAU,GACV,OAAO,GACP,OAAO,GACP,cAAc,GACd,KAAK,CACR,CACF,GAAG;IACF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CACnC,CAAC"}

package/dist/core/foundation/config-user.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config-user.js.map

package/dist/core/foundation/config-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-user.js","sourceRoot":"","sources":["../../../src/core/foundation/config-user.ts"],"names":[],"mappings":""}

package/dist/core/foundation/config-vcs.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Version control configuration. osq performs no git writes unless `enabled`
+ * is set, so the block defaults off. `author` is the identity every osq commit
+ * carries and is required once writes are on. `worktreeRoot` names where linked
+ * worktrees live, `defaultBranch` names the branch approval must start from,
+ * and `prepare` runs before osq commits; all three keep their trimmed form.
+ * The commit timeout lives with the other timeouts.
+ */
+export interface VcsConfig {
+    readonly enabled: boolean;
+    readonly author?: string;
+    readonly worktreeRoot?: string;
+    readonly defaultBranch?: string;
+    readonly prepare?: string;
+}
+export declare const DEFAULT_VCS_CONFIG: VcsConfig;
+/** The branch used when neither origin nor `vcs.defaultBranch` names one. */
+export declare const DEFAULT_BRANCH = "main";
+/** Where linked worktrees live when `vcs.worktreeRoot` is unset. */
+export declare const DEFAULT_WORKTREE_ROOT = "~/.osq/worktrees";
+/** Default bound in seconds for each commit osq makes when unset. */
+export declare const DEFAULT_GIT_COMMIT_SECONDS = 120;
+/**
+ * Validate an optional `vcs` block over the defaults. Missing fields keep the
+ * defaults; a non-boolean `enabled`, a malformed author, an author missing
+ * while enabled, and a blank or non-string path or command are rejected.
+ */
+export declare function validateVcsConfig(vcs: unknown): VcsConfig;
+//# sourceMappingURL=config-vcs.d.ts.map

package/dist/core/foundation/config-vcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-vcs.d.ts","sourceRoot":"","sources":["../../../src/core/foundation/config-vcs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,kBAAkB,EAAE,SAA8B,CAAC;AAEhE,6EAA6E;AAC7E,eAAO,MAAM,cAAc,SAAS,CAAC;AAErC,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD,qEAAqE;AACrE,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAK9C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CA8BzD"}

package/dist/core/foundation/config-vcs.js

@@ -0,0 +1,57 @@
+export const DEFAULT_VCS_CONFIG = { enabled: false };
+/** The branch used when neither origin nor `vcs.defaultBranch` names one. */
+export const DEFAULT_BRANCH = 'main';
+/** Where linked worktrees live when `vcs.worktreeRoot` is unset. */
+export const DEFAULT_WORKTREE_ROOT = '~/.osq/worktrees';
+/** Default bound in seconds for each commit osq makes when unset. */
+export const DEFAULT_GIT_COMMIT_SECONDS = 120;
+/** A name, a space, and a non-empty email in angle brackets. */
+const AUTHOR_PATTERN = /^\S.*\s<[^<>]+>$/;
+/**
+ * Validate an optional `vcs` block over the defaults. Missing fields keep the
+ * defaults; a non-boolean `enabled`, a malformed author, an author missing
+ * while enabled, and a blank or non-string path or command are rejected.
+ */
+export function validateVcsConfig(vcs) {
+    if (vcs === undefined)
+        return DEFAULT_VCS_CONFIG;
+    if (typeof vcs !== 'object' || vcs === null || Array.isArray(vcs)) {
+        throw new Error('vcs configuration must be an object');
+    }
+    const record = vcs;
+    const enabled = record.enabled === undefined ? DEFAULT_VCS_CONFIG.enabled : record.enabled;
+    if (typeof enabled !== 'boolean') {
+        throw new Error('vcs.enabled must be a boolean');
+    }
+    let author;
+    if (record.author !== undefined) {
+        if (typeof record.author !== 'string' || !AUTHOR_PATTERN.test(record.author)) {
+            throw new Error('vcs.author must look like "Name <email>"');
+        }
+        author = record.author;
+    }
+    if (enabled && author === undefined) {
+        throw new Error('vcs.author is required when vcs.enabled is true');
+    }
+    const worktreeRoot = trimmedField(record, 'worktreeRoot');
+    const defaultBranch = trimmedField(record, 'defaultBranch');
+    const prepare = trimmedField(record, 'prepare');
+    return {
+        enabled,
+        ...(author !== undefined ? { author } : {}),
+        ...(worktreeRoot !== undefined ? { worktreeRoot } : {}),
+        ...(defaultBranch !== undefined ? { defaultBranch } : {}),
+        ...(prepare !== undefined ? { prepare } : {}),
+    };
+}
+/** A present field's trimmed value, rejecting blanks and non-strings. */
+function trimmedField(record, field) {
+    const value = record[field];
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new Error(`vcs.${field} must be a non-empty string if provided`);
+    }
+    return value.trim();
+}
+//# sourceMappingURL=config-vcs.js.map

package/dist/core/foundation/config-vcs.js.map

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