iosm-cli 0.1.2 → 0.2.0

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/sdk.d.ts

@@ -8,7 +8,7 @@ import { ModelRegistry } from "./model-registry.js";
 import type { ResourceLoader } from "./resource-loader.js";
 import { SessionManager } from "./session-manager.js";
 import { SettingsManager } from "./settings-manager.js";
-import { allTools, astGrepTool, bashTool, codingTools, combyTool, createAstGrepTool, createBashTool, createCodingTools, createCombyTool, createEditTool, createFdTool, createFindTool, createGrepTool, createJqTool, createLsTool, createReadOnlyTools, createReadTool, createRgTool, createSedTool, createSemgrepTool, createWriteTool, editTool, fdTool, findTool, grepTool, jqTool, lsTool, readOnlyTools, readTool, rgTool, sedTool, semgrepTool, type Tool, yqTool, createYqTool, writeTool } from "./tools/index.js";
+import { allTools, astGrepTool, bashTool, codingTools, combyTool, createAstGrepTool, createBashTool, createCodingTools, createCombyTool, createEditTool, createFdTool, createFindTool, createGrepTool, createJqTool, createLsTool, createReadOnlyTools, createReadTool, createRgTool, createSedTool, createSemgrepTool, createSemanticSearchTool, createWriteTool, editTool, fdTool, findTool, grepTool, jqTool, lsTool, readOnlyTools, readTool, rgTool, sedTool, semanticSearchTool, semgrepTool, type Tool, yqTool, createYqTool, writeTool } from "./tools/index.js";
 import { type AgentProfileName } from "./agent-profiles.js";
 export interface CreateAgentSessionOptions {
     /** Working directory for project-local discovery. Default: process.cwd() */
@@ -30,7 +30,7 @@ export interface CreateAgentSessionOptions {
         model: Model<any>;
         thinkingLevel?: ThinkingLevel;
     }>;
-    /** Built-in tools to use. Default: codingTools [read, bash, edit, write] */
+    /** Built-in tools to use. Default: active profile tools (profile defaults to "full"). */
     tools?: Tool[];
     /** Custom tools to register (in addition to built-in tools). */
     customTools?: ToolDefinition[];
@@ -66,7 +66,7 @@ export type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, Extension
 export type { PromptTemplate } from "./prompt-templates.js";
 export type { Skill } from "./skills.js";
 export type { Tool } from "./tools/index.js";
-export { createAskUserTool, readTool, bashTool, editTool, writeTool, grepTool, findTool, lsTool, rgTool, fdTool, astGrepTool, combyTool, jqTool, yqTool, semgrepTool, sedTool, codingTools, readOnlyTools, allTools as allBuiltInTools, createCodingTools, createReadOnlyTools, createReadTool, createBashTool, createEditTool, createWriteTool, createGrepTool, createFindTool, createLsTool, createRgTool, createFdTool, createAstGrepTool, createCombyTool, createJqTool, createYqTool, createSemgrepTool, createSedTool, };
+export { createAskUserTool, readTool, bashTool, editTool, writeTool, grepTool, findTool, lsTool, rgTool, fdTool, astGrepTool, combyTool, jqTool, yqTool, semgrepTool, sedTool, semanticSearchTool, codingTools, readOnlyTools, allTools as allBuiltInTools, createCodingTools, createReadOnlyTools, createReadTool, createBashTool, createEditTool, createWriteTool, createGrepTool, createFindTool, createLsTool, createRgTool, createFdTool, createAstGrepTool, createCombyTool, createJqTool, createYqTool, createSemgrepTool, createSedTool, createSemanticSearchTool, };
 /**
  * Create an AgentSession with the specified options.
  *

package/dist/core/sdk.d.ts.map

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

package/dist/core/sdk.js

@@ -14,13 +14,13 @@ import { SettingsManager } from "./settings-manager.js";
 import { loadCustomSubagents, resolveCustomSubagentReference } from "./subagents.js";
 import { time } from "./timings.js";
 import { patchAgentForParallelTaskExecution } from "./parallel-task-agent.js";
-import { allTools, astGrepTool, bashTool, codingTools, combyTool, createAstGrepTool, createBashTool, createCodingTools, createCombyTool, createEditTool, createFdTool, createFindTool, createGrepTool, createJqTool, createLsTool, createReadOnlyTools, createReadTool, createRgTool, createSedTool, createSemgrepTool, createTaskTool, createToolsFromNames, createWriteTool, editTool, fdTool, findTool, grepTool, jqTool, lsTool, readOnlyTools, readTool, rgTool, sedTool, semgrepTool, yqTool, createYqTool, writeTool, } from "./tools/index.js";
+import { allTools, astGrepTool, bashTool, codingTools, combyTool, createAstGrepTool, createBashTool, createCodingTools, createCombyTool, createEditTool, createFdTool, createFindTool, createGrepTool, createJqTool, createLsTool, createReadOnlyTools, createReadTool, createRgTool, createSedTool, createSemgrepTool, createSemanticSearchTool, createTaskTool, createToolsFromNames, createWriteTool, editTool, fdTool, findTool, grepTool, jqTool, lsTool, readOnlyTools, readTool, rgTool, sedTool, semanticSearchTool, semgrepTool, yqTool, createYqTool, writeTool, } from "./tools/index.js";
 import { getAgentProfile } from "./agent-profiles.js";
 export { createAskUserTool, 
 // Pre-built tools (use process.cwd())
-readTool, bashTool, editTool, writeTool, grepTool, findTool, lsTool, rgTool, fdTool, astGrepTool, combyTool, jqTool, yqTool, semgrepTool, sedTool, codingTools, readOnlyTools, allTools as allBuiltInTools, 
+readTool, bashTool, editTool, writeTool, grepTool, findTool, lsTool, rgTool, fdTool, astGrepTool, combyTool, jqTool, yqTool, semgrepTool, sedTool, semanticSearchTool, codingTools, readOnlyTools, allTools as allBuiltInTools, 
 // Tool factories (for custom cwd)
-createCodingTools, createReadOnlyTools, createReadTool, createBashTool, createEditTool, createWriteTool, createGrepTool, createFindTool, createLsTool, createRgTool, createFdTool, createAstGrepTool, createCombyTool, createJqTool, createYqTool, createSemgrepTool, createSedTool, };
+createCodingTools, createReadOnlyTools, createReadTool, createBashTool, createEditTool, createWriteTool, createGrepTool, createFindTool, createLsTool, createRgTool, createFdTool, createAstGrepTool, createCombyTool, createJqTool, createYqTool, createSemgrepTool, createSedTool, createSemanticSearchTool, };
 // Helper Functions
 function getDefaultAgentDir() {
     return getAgentDir();
@@ -150,9 +150,10 @@ export async function createAgentSession(options = {}) {
     if (!model || !model.reasoning) {
         thinkingLevel = "off";
     }
-    // Apply agent profile: overrides tools + thinkingLevel unless caller provided them explicitly
-    const profile = options.profile ? getAgentProfile(options.profile) : undefined;
-    if (profile && profile.name !== "full") {
+    // Apply agent profile: default to "full" when no explicit profile is provided.
+    // This keeps runtime tool availability aligned with UI/profile badges.
+    const profile = getAgentProfile(options.profile);
+    if (profile.name !== "full") {
         // Profile overrides thinking level only when caller did not explicitly pass one
         if (options.thinkingLevel === undefined && !hasExistingSession) {
             thinkingLevel = profile.thinkingLevel;
@@ -163,18 +164,7 @@ export async function createAgentSession(options = {}) {
         }
     }
     const enableTaskTool = options.enableTaskTool !== false; // default true
-    const defaultActiveToolNames = [
-        "read",
-        "bash",
-        "edit",
-        "write",
-        ...(enableTaskTool ? ["task"] : []),
-        "todo_write",
-        "todo_read",
-    ];
-    const profileToolNames = profile
-        ? [...profile.tools, ...(enableTaskTool ? ["task"] : []), "todo_write", "todo_read"].filter((n) => n === "task" || n in allTools)
-        : defaultActiveToolNames;
+    const profileToolNames = [...profile.tools, ...(enableTaskTool ? ["task"] : []), "todo_write", "todo_read"].filter((n) => n === "task" || n in allTools);
     const initialActiveToolNames = options.tools
         ? options.tools.map((t) => t.name).filter((n) => n === "task" || n in allTools)
         : profileToolNames;
@@ -287,7 +277,9 @@ export async function createAgentSession(options = {}) {
                 authStorage,
                 modelRegistry,
                 model: subModel,
-                tools: createToolsFromNames(runnerOptions.cwd, runnerOptions.tools),
+                tools: createToolsFromNames(runnerOptions.cwd, runnerOptions.tools, {
+                    semantic: { authStorage, agentDir },
+                }),
                 sessionManager: SessionManager.inMemory(),
                 settingsManager,
                 enableTaskTool: false, // prevent recursive subagent spawning