iosm-cli 0.1.3 → 0.2.1

package/dist/core/contract.js

@@ -0,0 +1,300 @@
+import AjvModule from "ajv";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+const Ajv = AjvModule.default || AjvModule;
+const ajv = new Ajv({ allErrors: true, allowUnionTypes: true });
+export class ContractValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ContractValidationError";
+    }
+}
+export class ContractParseError extends Error {
+    constructor(filePath, message) {
+        super(message);
+        this.name = "ContractParseError";
+        this.filePath = filePath;
+    }
+}
+const CONTRACT_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        goal: { type: "string" },
+        scope_include: {
+            type: "array",
+            items: { type: "string" },
+        },
+        scope_exclude: {
+            type: "array",
+            items: { type: "string" },
+        },
+        constraints: {
+            type: "array",
+            items: { type: "string" },
+        },
+        quality_gates: {
+            type: "array",
+            items: { type: "string" },
+        },
+        definition_of_done: {
+            type: "array",
+            items: { type: "string" },
+        },
+        assumptions: {
+            type: "array",
+            items: { type: "string" },
+        },
+        non_goals: {
+            type: "array",
+            items: { type: "string" },
+        },
+        risks: {
+            type: "array",
+            items: { type: "string" },
+        },
+        deliverables: {
+            type: "array",
+            items: { type: "string" },
+        },
+        success_metrics: {
+            type: "array",
+            items: { type: "string" },
+        },
+        stakeholders: {
+            type: "array",
+            items: { type: "string" },
+        },
+        owner: { type: "string" },
+        timebox: { type: "string" },
+        notes: { type: "string" },
+    },
+    required: [],
+};
+const validateContract = ajv.compile(CONTRACT_SCHEMA);
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function normalizeString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : undefined;
+}
+function normalizeStringArray(value) {
+    if (!Array.isArray(value))
+        return undefined;
+    const normalized = value
+        .filter((item) => typeof item === "string")
+        .map((item) => item.trim())
+        .filter((item) => item.length > 0);
+    return normalized.length > 0 ? normalized : undefined;
+}
+function cloneContract(contract) {
+    return {
+        ...(contract.goal ? { goal: contract.goal } : {}),
+        ...(contract.scope_include ? { scope_include: [...contract.scope_include] } : {}),
+        ...(contract.scope_exclude ? { scope_exclude: [...contract.scope_exclude] } : {}),
+        ...(contract.constraints ? { constraints: [...contract.constraints] } : {}),
+        ...(contract.quality_gates ? { quality_gates: [...contract.quality_gates] } : {}),
+        ...(contract.definition_of_done ? { definition_of_done: [...contract.definition_of_done] } : {}),
+        ...(contract.assumptions ? { assumptions: [...contract.assumptions] } : {}),
+        ...(contract.non_goals ? { non_goals: [...contract.non_goals] } : {}),
+        ...(contract.risks ? { risks: [...contract.risks] } : {}),
+        ...(contract.deliverables ? { deliverables: [...contract.deliverables] } : {}),
+        ...(contract.success_metrics ? { success_metrics: [...contract.success_metrics] } : {}),
+        ...(contract.stakeholders ? { stakeholders: [...contract.stakeholders] } : {}),
+        ...(contract.owner ? { owner: contract.owner } : {}),
+        ...(contract.timebox ? { timebox: contract.timebox } : {}),
+        ...(contract.notes ? { notes: contract.notes } : {}),
+    };
+}
+function formatValidationError(payload) {
+    const errors = validateContract.errors ?? [];
+    if (errors.length === 0) {
+        return `Invalid contract payload: ${JSON.stringify(payload)}`;
+    }
+    const details = errors
+        .map((error) => {
+        const path = error.instancePath || "/";
+        return `${path} ${error.message ?? "is invalid"}`;
+    })
+        .join("; ");
+    return `Invalid contract payload: ${details}`;
+}
+export function normalizeEngineeringContract(payload) {
+    if (!isRecord(payload)) {
+        throw new ContractValidationError("Contract payload must be a JSON object.");
+    }
+    if (!validateContract(payload)) {
+        throw new ContractValidationError(formatValidationError(payload));
+    }
+    const goal = normalizeString(payload.goal);
+    const scopeInclude = normalizeStringArray(payload.scope_include);
+    const scopeExclude = normalizeStringArray(payload.scope_exclude);
+    const constraints = normalizeStringArray(payload.constraints);
+    const qualityGates = normalizeStringArray(payload.quality_gates);
+    const definitionOfDone = normalizeStringArray(payload.definition_of_done);
+    const assumptions = normalizeStringArray(payload.assumptions);
+    const nonGoals = normalizeStringArray(payload.non_goals);
+    const risks = normalizeStringArray(payload.risks);
+    const deliverables = normalizeStringArray(payload.deliverables);
+    const successMetrics = normalizeStringArray(payload.success_metrics);
+    const stakeholders = normalizeStringArray(payload.stakeholders);
+    const owner = normalizeString(payload.owner);
+    const timebox = normalizeString(payload.timebox);
+    const notes = normalizeString(payload.notes);
+    return {
+        ...(goal ? { goal } : {}),
+        ...(scopeInclude ? { scope_include: scopeInclude } : {}),
+        ...(scopeExclude ? { scope_exclude: scopeExclude } : {}),
+        ...(constraints ? { constraints } : {}),
+        ...(qualityGates ? { quality_gates: qualityGates } : {}),
+        ...(definitionOfDone ? { definition_of_done: definitionOfDone } : {}),
+        ...(assumptions ? { assumptions } : {}),
+        ...(nonGoals ? { non_goals: nonGoals } : {}),
+        ...(risks ? { risks } : {}),
+        ...(deliverables ? { deliverables } : {}),
+        ...(successMetrics ? { success_metrics: successMetrics } : {}),
+        ...(stakeholders ? { stakeholders } : {}),
+        ...(owner ? { owner } : {}),
+        ...(timebox ? { timebox } : {}),
+        ...(notes ? { notes } : {}),
+    };
+}
+export function deepMergeContracts(base, override) {
+    const merged = cloneContract(base);
+    for (const [key, value] of Object.entries(override)) {
+        if (value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            merged[key] = [...value];
+            continue;
+        }
+        merged[key] = value;
+    }
+    return normalizeEngineeringContract(merged);
+}
+function readContractFile(filePath) {
+    if (!existsSync(filePath)) {
+        return {};
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(filePath, "utf8"));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new ContractParseError(filePath, `Failed to parse contract JSON: ${message}`);
+    }
+    try {
+        return normalizeEngineeringContract(parsed);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new ContractParseError(filePath, message);
+    }
+}
+function writeContractFile(filePath, contract) {
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, `${JSON.stringify(contract, null, 2)}\n`, "utf8");
+}
+export class ContractService {
+    constructor(options) {
+        this.sessionOverlay = {};
+        this.cwd = options.cwd;
+    }
+    getProjectPath() {
+        return join(this.cwd, ".iosm", "contract.json");
+    }
+    getSessionOverlay() {
+        return cloneContract(this.sessionOverlay);
+    }
+    setSessionOverlay(payload) {
+        const normalized = normalizeEngineeringContract(payload);
+        this.sessionOverlay = normalized;
+        return cloneContract(normalized);
+    }
+    clearSessionOverlay() {
+        this.sessionOverlay = {};
+    }
+    loadProjectContract() {
+        return readContractFile(this.getProjectPath());
+    }
+    saveProjectContract(payload) {
+        const normalized = normalizeEngineeringContract(payload);
+        writeContractFile(this.getProjectPath(), normalized);
+        return cloneContract(normalized);
+    }
+    clearProjectContract() {
+        const projectPath = this.getProjectPath();
+        if (!existsSync(projectPath))
+            return false;
+        rmSync(projectPath, { force: true });
+        return true;
+    }
+    save(scope, payload) {
+        if (scope === "project") {
+            return this.saveProjectContract(payload);
+        }
+        return this.setSessionOverlay(payload);
+    }
+    clear(scope) {
+        if (scope === "project") {
+            return this.clearProjectContract();
+        }
+        this.clearSessionOverlay();
+        return true;
+    }
+    getState() {
+        const projectPath = this.getProjectPath();
+        const hasProjectFile = existsSync(projectPath);
+        const project = this.loadProjectContract();
+        const sessionOverlay = this.getSessionOverlay();
+        const effective = deepMergeContracts(project, sessionOverlay);
+        return {
+            projectPath,
+            hasProjectFile,
+            project,
+            sessionOverlay,
+            effective,
+        };
+    }
+    buildPromptContext(maxItemsPerList = 4) {
+        const state = this.getState();
+        const contract = state.effective;
+        if (Object.keys(contract).length === 0) {
+            return undefined;
+        }
+        const lines = ["Active engineering contract (effective):"];
+        if (contract.goal)
+            lines.push(`- goal: ${contract.goal}`);
+        const pushList = (label, values) => {
+            if (!values || values.length === 0)
+                return;
+            const preview = values.slice(0, Math.max(1, maxItemsPerList));
+            const suffix = values.length > preview.length ? ` (+${values.length - preview.length} more)` : "";
+            lines.push(`- ${label}: ${preview.join("; ")}${suffix}`);
+        };
+        pushList("scope_include", contract.scope_include);
+        pushList("scope_exclude", contract.scope_exclude);
+        pushList("constraints", contract.constraints);
+        pushList("quality_gates", contract.quality_gates);
+        pushList("definition_of_done", contract.definition_of_done);
+        pushList("assumptions", contract.assumptions);
+        pushList("non_goals", contract.non_goals);
+        pushList("risks", contract.risks);
+        pushList("deliverables", contract.deliverables);
+        pushList("success_metrics", contract.success_metrics);
+        pushList("stakeholders", contract.stakeholders);
+        if (contract.owner)
+            lines.push(`- owner: ${contract.owner}`);
+        if (contract.timebox)
+            lines.push(`- timebox: ${contract.timebox}`);
+        if (contract.notes)
+            lines.push(`- notes: ${contract.notes}`);
+        lines.push("Treat this contract as execution constraints unless user explicitly overrides it.");
+        return lines.join("\n");
+    }
+}
+//# sourceMappingURL=contract.js.map

package/dist/core/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/core/contract.ts"],"names":[],"mappings":"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","sourcesContent":["import AjvModule from \"ajv\";\nimport { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\nconst Ajv = (AjvModule as any).default || AjvModule;\nconst ajv = new Ajv({ allErrors: true, allowUnionTypes: true });\n\nexport type ContractScope = \"project\" | \"session\";\n\nexport interface EngineeringContract {\n\tgoal?: string;\n\tscope_include?: string[];\n\tscope_exclude?: string[];\n\tconstraints?: string[];\n\tquality_gates?: string[];\n\tdefinition_of_done?: string[];\n\tassumptions?: string[];\n\tnon_goals?: string[];\n\trisks?: string[];\n\tdeliverables?: string[];\n\tsuccess_metrics?: string[];\n\tstakeholders?: string[];\n\towner?: string;\n\ttimebox?: string;\n\tnotes?: string;\n}\n\nexport interface ContractState {\n\tprojectPath: string;\n\thasProjectFile: boolean;\n\tproject: EngineeringContract;\n\tsessionOverlay: EngineeringContract;\n\teffective: EngineeringContract;\n}\n\nexport class ContractValidationError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"ContractValidationError\";\n\t}\n}\n\nexport class ContractParseError extends Error {\n\treadonly filePath: string;\n\n\tconstructor(filePath: string, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"ContractParseError\";\n\t\tthis.filePath = filePath;\n\t}\n}\n\ntype ContractSchemaPayload = {\n\tgoal?: string;\n\tscope_include?: string[];\n\tscope_exclude?: string[];\n\tconstraints?: string[];\n\tquality_gates?: string[];\n\tdefinition_of_done?: string[];\n\tassumptions?: string[];\n\tnon_goals?: string[];\n\trisks?: string[];\n\tdeliverables?: string[];\n\tsuccess_metrics?: string[];\n\tstakeholders?: string[];\n\towner?: string;\n\ttimebox?: string;\n\tnotes?: string;\n};\n\nconst CONTRACT_SCHEMA = {\n\ttype: \"object\",\n\tadditionalProperties: false,\n\tproperties: {\n\t\tgoal: { type: \"string\" },\n\t\tscope_include: {\n\t\t\ttype: \"array\",\n\t\t\titems: { type: \"string\" },\n\t\t},\n\t\tscope_exclude: {\n\t\t\ttype: \"array\",\n\t\t\titems: { type: \"string\" },\n\t\t},\n\t\tconstraints: {\n\t\t\ttype: \"array\",\n\t\t\titems: { type: \"string\" },\n\t\t},\n\t\tquality_gates: {\n\t\t\ttype: \"array\",\n\t\t\titems: { type: \"string\" },\n\t\t},\n\t\tdefinition_of_done: {\n\t\t\ttype: \"array\",\n\t\t\titems: { type: \"string\" },\n\t\t},\n\t\tassumptions: {\n\t\t\ttype: \"array\",\n\t\t\titems: { type: \"string\" },\n\t\t},\n\t\tnon_goals: {\n\t\t\ttype: \"array\",\n\t\t\titems: { type: \"string\" },\n\t\t},\n\t\trisks: {\n\t\t\ttype: \"array\",\n\t\t\titems: { type: \"string\" },\n\t\t},\n\t\tdeliverables: {\n\t\t\ttype: \"array\",\n\t\t\titems: { type: \"string\" },\n\t\t},\n\t\tsuccess_metrics: {\n\t\t\ttype: \"array\",\n\t\t\titems: { type: \"string\" },\n\t\t},\n\t\tstakeholders: {\n\t\t\ttype: \"array\",\n\t\t\titems: { type: \"string\" },\n\t\t},\n\t\towner: { type: \"string\" },\n\t\ttimebox: { type: \"string\" },\n\t\tnotes: { type: \"string\" },\n\t},\n\trequired: [],\n} as const;\n\nconst validateContract = ajv.compile(CONTRACT_SCHEMA as any) as {\n\t(payload: unknown): boolean;\n\terrors?: Array<{ instancePath?: string; message?: string }>;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null;\n}\n\nfunction normalizeString(value: unknown): string | undefined {\n\tif (typeof value !== \"string\") return undefined;\n\tconst normalized = value.trim();\n\treturn normalized.length > 0 ? normalized : undefined;\n}\n\nfunction normalizeStringArray(value: unknown): string[] | undefined {\n\tif (!Array.isArray(value)) return undefined;\n\tconst normalized = value\n\t\t.filter((item): item is string => typeof item === \"string\")\n\t\t.map((item) => item.trim())\n\t\t.filter((item) => item.length > 0);\n\treturn normalized.length > 0 ? normalized : undefined;\n}\n\nfunction cloneContract(contract: EngineeringContract): EngineeringContract {\n\treturn {\n\t\t...(contract.goal ? { goal: contract.goal } : {}),\n\t\t...(contract.scope_include ? { scope_include: [...contract.scope_include] } : {}),\n\t\t...(contract.scope_exclude ? { scope_exclude: [...contract.scope_exclude] } : {}),\n\t\t...(contract.constraints ? { constraints: [...contract.constraints] } : {}),\n\t\t...(contract.quality_gates ? { quality_gates: [...contract.quality_gates] } : {}),\n\t\t...(contract.definition_of_done ? { definition_of_done: [...contract.definition_of_done] } : {}),\n\t\t...(contract.assumptions ? { assumptions: [...contract.assumptions] } : {}),\n\t\t...(contract.non_goals ? { non_goals: [...contract.non_goals] } : {}),\n\t\t...(contract.risks ? { risks: [...contract.risks] } : {}),\n\t\t...(contract.deliverables ? { deliverables: [...contract.deliverables] } : {}),\n\t\t...(contract.success_metrics ? { success_metrics: [...contract.success_metrics] } : {}),\n\t\t...(contract.stakeholders ? { stakeholders: [...contract.stakeholders] } : {}),\n\t\t...(contract.owner ? { owner: contract.owner } : {}),\n\t\t...(contract.timebox ? { timebox: contract.timebox } : {}),\n\t\t...(contract.notes ? { notes: contract.notes } : {}),\n\t};\n}\n\nfunction formatValidationError(payload: unknown): string {\n\tconst errors = validateContract.errors ?? [];\n\tif (errors.length === 0) {\n\t\treturn `Invalid contract payload: ${JSON.stringify(payload)}`;\n\t}\n\tconst details = errors\n\t\t.map((error: { instancePath?: string; message?: string }) => {\n\t\t\tconst path = error.instancePath || \"/\";\n\t\t\treturn `${path} ${error.message ?? \"is invalid\"}`;\n\t\t})\n\t\t.join(\"; \");\n\treturn `Invalid contract payload: ${details}`;\n}\n\nexport function normalizeEngineeringContract(payload: unknown): EngineeringContract {\n\tif (!isRecord(payload)) {\n\t\tthrow new ContractValidationError(\"Contract payload must be a JSON object.\");\n\t}\n\tif (!validateContract(payload)) {\n\t\tthrow new ContractValidationError(formatValidationError(payload));\n\t}\n\n\tconst goal = normalizeString(payload.goal);\n\tconst scopeInclude = normalizeStringArray(payload.scope_include);\n\tconst scopeExclude = normalizeStringArray(payload.scope_exclude);\n\tconst constraints = normalizeStringArray(payload.constraints);\n\tconst qualityGates = normalizeStringArray(payload.quality_gates);\n\tconst definitionOfDone = normalizeStringArray(payload.definition_of_done);\n\tconst assumptions = normalizeStringArray(payload.assumptions);\n\tconst nonGoals = normalizeStringArray(payload.non_goals);\n\tconst risks = normalizeStringArray(payload.risks);\n\tconst deliverables = normalizeStringArray(payload.deliverables);\n\tconst successMetrics = normalizeStringArray(payload.success_metrics);\n\tconst stakeholders = normalizeStringArray(payload.stakeholders);\n\tconst owner = normalizeString(payload.owner);\n\tconst timebox = normalizeString(payload.timebox);\n\tconst notes = normalizeString(payload.notes);\n\n\treturn {\n\t\t...(goal ? { goal } : {}),\n\t\t...(scopeInclude ? { scope_include: scopeInclude } : {}),\n\t\t...(scopeExclude ? { scope_exclude: scopeExclude } : {}),\n\t\t...(constraints ? { constraints } : {}),\n\t\t...(qualityGates ? { quality_gates: qualityGates } : {}),\n\t\t...(definitionOfDone ? { definition_of_done: definitionOfDone } : {}),\n\t\t...(assumptions ? { assumptions } : {}),\n\t\t...(nonGoals ? { non_goals: nonGoals } : {}),\n\t\t...(risks ? { risks } : {}),\n\t\t...(deliverables ? { deliverables } : {}),\n\t\t...(successMetrics ? { success_metrics: successMetrics } : {}),\n\t\t...(stakeholders ? { stakeholders } : {}),\n\t\t...(owner ? { owner } : {}),\n\t\t...(timebox ? { timebox } : {}),\n\t\t...(notes ? { notes } : {}),\n\t};\n}\n\nexport function deepMergeContracts(base: EngineeringContract, override: EngineeringContract): EngineeringContract {\n\tconst merged: EngineeringContract = cloneContract(base);\n\tfor (const [key, value] of Object.entries(override) as Array<[keyof EngineeringContract, unknown]>) {\n\t\tif (value === undefined) continue;\n\t\tif (Array.isArray(value)) {\n\t\t\t(merged as Record<string, unknown>)[key] = [...value];\n\t\t\tcontinue;\n\t\t}\n\t\t(merged as Record<string, unknown>)[key] = value;\n\t}\n\treturn normalizeEngineeringContract(merged);\n}\n\nfunction readContractFile(filePath: string): EngineeringContract {\n\tif (!existsSync(filePath)) {\n\t\treturn {};\n\t}\n\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(readFileSync(filePath, \"utf8\"));\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new ContractParseError(filePath, `Failed to parse contract JSON: ${message}`);\n\t}\n\n\ttry {\n\t\treturn normalizeEngineeringContract(parsed);\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new ContractParseError(filePath, message);\n\t}\n}\n\nfunction writeContractFile(filePath: string, contract: EngineeringContract): void {\n\tmkdirSync(dirname(filePath), { recursive: true });\n\twriteFileSync(filePath, `${JSON.stringify(contract, null, 2)}\\n`, \"utf8\");\n}\n\nexport interface ContractServiceOptions {\n\tcwd: string;\n}\n\nexport class ContractService {\n\tprivate readonly cwd: string;\n\tprivate sessionOverlay: EngineeringContract = {};\n\n\tconstructor(options: ContractServiceOptions) {\n\t\tthis.cwd = options.cwd;\n\t}\n\n\tgetProjectPath(): string {\n\t\treturn join(this.cwd, \".iosm\", \"contract.json\");\n\t}\n\n\tgetSessionOverlay(): EngineeringContract {\n\t\treturn cloneContract(this.sessionOverlay);\n\t}\n\n\tsetSessionOverlay(payload: unknown): EngineeringContract {\n\t\tconst normalized = normalizeEngineeringContract(payload);\n\t\tthis.sessionOverlay = normalized;\n\t\treturn cloneContract(normalized);\n\t}\n\n\tclearSessionOverlay(): void {\n\t\tthis.sessionOverlay = {};\n\t}\n\n\tloadProjectContract(): EngineeringContract {\n\t\treturn readContractFile(this.getProjectPath());\n\t}\n\n\tsaveProjectContract(payload: unknown): EngineeringContract {\n\t\tconst normalized = normalizeEngineeringContract(payload);\n\t\twriteContractFile(this.getProjectPath(), normalized);\n\t\treturn cloneContract(normalized);\n\t}\n\n\tclearProjectContract(): boolean {\n\t\tconst projectPath = this.getProjectPath();\n\t\tif (!existsSync(projectPath)) return false;\n\t\trmSync(projectPath, { force: true });\n\t\treturn true;\n\t}\n\n\tsave(scope: ContractScope, payload: unknown): EngineeringContract {\n\t\tif (scope === \"project\") {\n\t\t\treturn this.saveProjectContract(payload);\n\t\t}\n\t\treturn this.setSessionOverlay(payload);\n\t}\n\n\tclear(scope: ContractScope): boolean {\n\t\tif (scope === \"project\") {\n\t\t\treturn this.clearProjectContract();\n\t\t}\n\t\tthis.clearSessionOverlay();\n\t\treturn true;\n\t}\n\n\tgetState(): ContractState {\n\t\tconst projectPath = this.getProjectPath();\n\t\tconst hasProjectFile = existsSync(projectPath);\n\t\tconst project = this.loadProjectContract();\n\t\tconst sessionOverlay = this.getSessionOverlay();\n\t\tconst effective = deepMergeContracts(project, sessionOverlay);\n\t\treturn {\n\t\t\tprojectPath,\n\t\t\thasProjectFile,\n\t\t\tproject,\n\t\t\tsessionOverlay,\n\t\t\teffective,\n\t\t};\n\t}\n\n\tbuildPromptContext(maxItemsPerList = 4): string | undefined {\n\t\tconst state = this.getState();\n\t\tconst contract = state.effective;\n\t\tif (Object.keys(contract).length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst lines: string[] = [\"Active engineering contract (effective):\"];\n\t\tif (contract.goal) lines.push(`- goal: ${contract.goal}`);\n\n\t\tconst pushList = (label: string, values: string[] | undefined): void => {\n\t\t\tif (!values || values.length === 0) return;\n\t\t\tconst preview = values.slice(0, Math.max(1, maxItemsPerList));\n\t\t\tconst suffix = values.length > preview.length ? ` (+${values.length - preview.length} more)` : \"\";\n\t\t\tlines.push(`- ${label}: ${preview.join(\"; \")}${suffix}`);\n\t\t};\n\n\t\tpushList(\"scope_include\", contract.scope_include);\n\t\tpushList(\"scope_exclude\", contract.scope_exclude);\n\t\tpushList(\"constraints\", contract.constraints);\n\t\tpushList(\"quality_gates\", contract.quality_gates);\n\t\tpushList(\"definition_of_done\", contract.definition_of_done);\n\t\tpushList(\"assumptions\", contract.assumptions);\n\t\tpushList(\"non_goals\", contract.non_goals);\n\t\tpushList(\"risks\", contract.risks);\n\t\tpushList(\"deliverables\", contract.deliverables);\n\t\tpushList(\"success_metrics\", contract.success_metrics);\n\t\tpushList(\"stakeholders\", contract.stakeholders);\n\t\tif (contract.owner) lines.push(`- owner: ${contract.owner}`);\n\t\tif (contract.timebox) lines.push(`- timebox: ${contract.timebox}`);\n\t\tif (contract.notes) lines.push(`- notes: ${contract.notes}`);\n\t\tlines.push(\"Treat this contract as execution constraints unless user explicitly overrides it.\");\n\t\treturn lines.join(\"\\n\");\n\t}\n}\n"]}

package/dist/core/failure-retrospective.d.ts

@@ -0,0 +1,12 @@
+export type FailureCause = "token_limit" | "logic_error" | "aborted" | "timeout" | "dependency_env" | "empty_output" | "unknown";
+export declare function classifyFailureCause(errorMessage: string): FailureCause;
+export declare function isRetrospectiveRetryable(cause: FailureCause): boolean;
+export declare function buildRetrospectiveDirective(input: {
+    cause: FailureCause;
+    errorMessage: string;
+    attempt: number;
+    target: "root" | "delegate";
+}): string;
+export declare function formatFailureCauseCounts(counts: Partial<Record<FailureCause, number>>): string;
+export declare function dominantFailureCause(counts: Partial<Record<FailureCause, number>>): FailureCause | undefined;
+//# sourceMappingURL=failure-retrospective.d.ts.map

package/dist/core/failure-retrospective.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-retrospective.d.ts","sourceRoot":"","sources":["../../src/core/failure-retrospective.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACrB,aAAa,GACb,aAAa,GACb,SAAS,GACT,SAAS,GACT,gBAAgB,GAChB,cAAc,GACd,SAAS,CAAC;AAYb,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,YAAY,CAUvE;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAErE;AAgDD,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IAClD,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;CAC5B,GAAG,MAAM,CAYT;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAe9F;AAED,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAC3C,YAAY,GAAG,SAAS,CAY1B"}

package/dist/core/failure-retrospective.js

@@ -0,0 +1,115 @@
+const tokenLimitPattern = /(token limit|max(?:imum)? tokens?|too many tokens?|context length|context window|prompt is too long|input too long|length exceeded)/i;
+const logicPattern = /(logic|invariant|assert(?:ion)?|expect\(|failed assumption|incorrect result|wrong output|invalid state|regression|failed dependency)/i;
+const abortPattern = /(operation aborted|aborted|signal aborted)/i;
+const timeoutPattern = /(timeout|timed out|deadline exceeded|took too long|hang(?:ing)?)/i;
+const dependencyPattern = /(module not found|cannot find module|dependency|package|importerror|missing dependency|command not found|enoent|env(?:ironment)?)/i;
+const emptyOutputPattern = /(empty output|no output|returned empty)/i;
+export function classifyFailureCause(errorMessage) {
+    const message = errorMessage.trim();
+    if (!message)
+        return "unknown";
+    if (emptyOutputPattern.test(message))
+        return "empty_output";
+    if (tokenLimitPattern.test(message))
+        return "token_limit";
+    if (abortPattern.test(message))
+        return "aborted";
+    if (timeoutPattern.test(message))
+        return "timeout";
+    if (dependencyPattern.test(message))
+        return "dependency_env";
+    if (logicPattern.test(message))
+        return "logic_error";
+    return "unknown";
+}
+export function isRetrospectiveRetryable(cause) {
+    return cause !== "empty_output" && cause !== "aborted";
+}
+function guidanceForCause(cause) {
+    switch (cause) {
+        case "token_limit":
+            return [
+                "- Narrow scope to only the minimum files/commands needed.",
+                "- Produce concise output (bullet points + critical diffs only).",
+                "- Avoid broad scans and repeated large reads.",
+            ];
+        case "logic_error":
+            return [
+                "- Diagnose why the prior approach failed before changing code.",
+                "- Use an alternative strategy, not a repeat of the same path.",
+                "- Prefer smallest verifiable step and validate assumptions explicitly.",
+            ];
+        case "aborted":
+            return [
+                "- Stop retries for this task execution; cancellation came from an external signal.",
+                "- Report cancellation context (where it happened and what was in progress).",
+                "- Resume only via an explicit new task/run request.",
+            ];
+        case "timeout":
+            return [
+                "- Split work into smaller bounded steps.",
+                "- Reduce expensive commands and long-running checks.",
+                "- Prioritize fast targeted verification first.",
+            ];
+        case "dependency_env":
+            return [
+                "- Verify environment/dependency preconditions first.",
+                "- Prefer deterministic remediation steps and minimal commands.",
+                "- If blocked by environment, report exact missing prerequisite.",
+            ];
+        case "empty_output":
+            return [
+                "- Ensure the response includes a concrete result summary.",
+                "- If still impossible, return a clear blocked reason.",
+            ];
+        default:
+            return [
+                "- Re-evaluate assumptions and reduce scope.",
+                "- Try a different implementation approach.",
+                "- Produce a concise, verifiable outcome.",
+            ];
+    }
+}
+export function buildRetrospectiveDirective(input) {
+    const guidance = guidanceForCause(input.cause).join("\n");
+    return [
+        "[RETROSPECTIVE_RETRY]",
+        `target: ${input.target}`,
+        `attempt: ${input.attempt}`,
+        `cause: ${input.cause}`,
+        `previous_error: ${input.errorMessage.replace(/\s+/g, " ").trim()}`,
+        "retry_policy:",
+        guidance,
+        "[/RETROSPECTIVE_RETRY]",
+    ].join("\n");
+}
+export function formatFailureCauseCounts(counts) {
+    const ordered = [
+        "token_limit",
+        "logic_error",
+        "aborted",
+        "timeout",
+        "dependency_env",
+        "empty_output",
+        "unknown",
+    ];
+    const parts = ordered
+        .map((cause) => ({ cause, count: counts[cause] ?? 0 }))
+        .filter((item) => item.count > 0)
+        .map((item) => `${item.cause}=${item.count}`);
+    return parts.join(", ");
+}
+export function dominantFailureCause(counts) {
+    const entries = Object.entries(counts);
+    let best;
+    let bestCount = 0;
+    for (const [cause, count] of entries) {
+        const normalized = count ?? 0;
+        if (normalized > bestCount) {
+            best = cause;
+            bestCount = normalized;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=failure-retrospective.js.map

package/dist/core/failure-retrospective.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-retrospective.js","sourceRoot":"","sources":["../../src/core/failure-retrospective.ts"],"names":[],"mappings":"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","sourcesContent":["export type FailureCause =\n\t| \"token_limit\"\n\t| \"logic_error\"\n\t| \"aborted\"\n\t| \"timeout\"\n\t| \"dependency_env\"\n\t| \"empty_output\"\n\t| \"unknown\";\n\nconst tokenLimitPattern =\n\t/(token limit|max(?:imum)? tokens?|too many tokens?|context length|context window|prompt is too long|input too long|length exceeded)/i;\nconst logicPattern =\n\t/(logic|invariant|assert(?:ion)?|expect\\(|failed assumption|incorrect result|wrong output|invalid state|regression|failed dependency)/i;\nconst abortPattern = /(operation aborted|aborted|signal aborted)/i;\nconst timeoutPattern = /(timeout|timed out|deadline exceeded|took too long|hang(?:ing)?)/i;\nconst dependencyPattern =\n\t/(module not found|cannot find module|dependency|package|importerror|missing dependency|command not found|enoent|env(?:ironment)?)/i;\nconst emptyOutputPattern = /(empty output|no output|returned empty)/i;\n\nexport function classifyFailureCause(errorMessage: string): FailureCause {\n\tconst message = errorMessage.trim();\n\tif (!message) return \"unknown\";\n\tif (emptyOutputPattern.test(message)) return \"empty_output\";\n\tif (tokenLimitPattern.test(message)) return \"token_limit\";\n\tif (abortPattern.test(message)) return \"aborted\";\n\tif (timeoutPattern.test(message)) return \"timeout\";\n\tif (dependencyPattern.test(message)) return \"dependency_env\";\n\tif (logicPattern.test(message)) return \"logic_error\";\n\treturn \"unknown\";\n}\n\nexport function isRetrospectiveRetryable(cause: FailureCause): boolean {\n\treturn cause !== \"empty_output\" && cause !== \"aborted\";\n}\n\nfunction guidanceForCause(cause: FailureCause): string[] {\n\tswitch (cause) {\n\t\tcase \"token_limit\":\n\t\t\treturn [\n\t\t\t\t\"- Narrow scope to only the minimum files/commands needed.\",\n\t\t\t\t\"- Produce concise output (bullet points + critical diffs only).\",\n\t\t\t\t\"- Avoid broad scans and repeated large reads.\",\n\t\t\t];\n\t\tcase \"logic_error\":\n\t\t\treturn [\n\t\t\t\t\"- Diagnose why the prior approach failed before changing code.\",\n\t\t\t\t\"- Use an alternative strategy, not a repeat of the same path.\",\n\t\t\t\t\"- Prefer smallest verifiable step and validate assumptions explicitly.\",\n\t\t\t];\n\t\tcase \"aborted\":\n\t\t\treturn [\n\t\t\t\t\"- Stop retries for this task execution; cancellation came from an external signal.\",\n\t\t\t\t\"- Report cancellation context (where it happened and what was in progress).\",\n\t\t\t\t\"- Resume only via an explicit new task/run request.\",\n\t\t\t];\n\t\tcase \"timeout\":\n\t\t\treturn [\n\t\t\t\t\"- Split work into smaller bounded steps.\",\n\t\t\t\t\"- Reduce expensive commands and long-running checks.\",\n\t\t\t\t\"- Prioritize fast targeted verification first.\",\n\t\t\t];\n\t\tcase \"dependency_env\":\n\t\t\treturn [\n\t\t\t\t\"- Verify environment/dependency preconditions first.\",\n\t\t\t\t\"- Prefer deterministic remediation steps and minimal commands.\",\n\t\t\t\t\"- If blocked by environment, report exact missing prerequisite.\",\n\t\t\t];\n\t\tcase \"empty_output\":\n\t\t\treturn [\n\t\t\t\t\"- Ensure the response includes a concrete result summary.\",\n\t\t\t\t\"- If still impossible, return a clear blocked reason.\",\n\t\t\t];\n\t\tdefault:\n\t\t\treturn [\n\t\t\t\t\"- Re-evaluate assumptions and reduce scope.\",\n\t\t\t\t\"- Try a different implementation approach.\",\n\t\t\t\t\"- Produce a concise, verifiable outcome.\",\n\t\t\t];\n\t}\n}\n\nexport function buildRetrospectiveDirective(input: {\n\tcause: FailureCause;\n\terrorMessage: string;\n\tattempt: number;\n\ttarget: \"root\" | \"delegate\";\n}): string {\n\tconst guidance = guidanceForCause(input.cause).join(\"\\n\");\n\treturn [\n\t\t\"[RETROSPECTIVE_RETRY]\",\n\t\t`target: ${input.target}`,\n\t\t`attempt: ${input.attempt}`,\n\t\t`cause: ${input.cause}`,\n\t\t`previous_error: ${input.errorMessage.replace(/\\s+/g, \" \").trim()}`,\n\t\t\"retry_policy:\",\n\t\tguidance,\n\t\t\"[/RETROSPECTIVE_RETRY]\",\n\t].join(\"\\n\");\n}\n\nexport function formatFailureCauseCounts(counts: Partial<Record<FailureCause, number>>): string {\n\tconst ordered: FailureCause[] = [\n\t\t\"token_limit\",\n\t\t\"logic_error\",\n\t\t\"aborted\",\n\t\t\"timeout\",\n\t\t\"dependency_env\",\n\t\t\"empty_output\",\n\t\t\"unknown\",\n\t];\n\tconst parts = ordered\n\t\t.map((cause) => ({ cause, count: counts[cause] ?? 0 }))\n\t\t.filter((item) => item.count > 0)\n\t\t.map((item) => `${item.cause}=${item.count}`);\n\treturn parts.join(\", \");\n}\n\nexport function dominantFailureCause(\n\tcounts: Partial<Record<FailureCause, number>>,\n): FailureCause | undefined {\n\tconst entries = Object.entries(counts) as Array<[FailureCause, number | undefined]>;\n\tlet best: FailureCause | undefined;\n\tlet bestCount = 0;\n\tfor (const [cause, count] of entries) {\n\t\tconst normalized = count ?? 0;\n\t\tif (normalized > bestCount) {\n\t\t\tbest = cause;\n\t\t\tbestCount = normalized;\n\t\t}\n\t}\n\treturn best;\n}\n"]}

package/dist/core/project-index/index.d.ts

@@ -0,0 +1,17 @@
+import type { BuildProjectIndexOptions, ProjectIndex, ProjectIndexQueryResult, RepoScaleMode } from "./types.js";
+export type { BuildProjectIndexOptions, ProjectIndex, ProjectIndexEntry, ProjectIndexMeta, ProjectIndexQueryResult, RepoScaleMode, } from "./types.js";
+export declare function getProjectIndexPath(cwd: string): string;
+export declare function loadProjectIndex(cwd: string): ProjectIndex | undefined;
+export declare function saveProjectIndex(cwd: string, index: ProjectIndex): void;
+export declare function buildProjectIndex(cwd: string, options?: BuildProjectIndexOptions): ProjectIndex;
+export declare function ensureProjectIndex(cwd: string, modeHint?: RepoScaleMode): {
+    index: ProjectIndex;
+    rebuilt: boolean;
+};
+export declare function queryProjectIndex(index: ProjectIndex, queryText: string, limit?: number): ProjectIndexQueryResult;
+export declare function inferRepoScaleMode(input: {
+    totalFiles: number;
+    sourceFiles: number;
+}): RepoScaleMode;
+export declare function collectChangedFilesSince(index: ProjectIndex, cwd: string): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/core/project-index/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/project-index/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,wBAAwB,EACxB,YAAY,EAGZ,uBAAuB,EACvB,aAAa,EACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACX,wBAAwB,EACxB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,aAAa,GACb,MAAM,YAAY,CAAC;AAwHpB,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAUtE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAIvE;AA+ED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,wBAAwB,GAAG,YAAY,CA0C/F;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAkBnH;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,uBAAuB,CAW7G;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAEpG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAqBnF"}