iosm-cli 0.2.0 → 0.2.1

package/dist/core/swarm/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../../src/core/swarm/planner.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EngineeringContract } from \"../contract.js\";\nimport type { SingularAnalysisResult, SingularOption } from \"../singular.js\";\nimport type { ProjectIndex } from \"../project-index/types.js\";\nimport { queryProjectIndex } from \"../project-index/index.js\";\nimport type { SwarmPlan, SwarmTaskPlan } from \"./types.js\";\n\nfunction toTaskId(index: number): string {\n\treturn `task_${index + 1}`;\n}\n\nfunction compact(values: string[]): string[] {\n\treturn [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))];\n}\n\nfunction inferConcurrencyClass(brief: string, touches: string[]): SwarmTaskPlan[\"concurrency_class\"] {\n\tconst lower = `${brief} ${touches.join(\" \")}`.toLowerCase();\n\tif (/(test|spec|verification|verify|qa)/.test(lower)) return \"verification\";\n\tif (/(doc|readme|changelog)/.test(lower)) return \"docs\";\n\tif (/(analysis|audit|map|scope)/.test(lower)) return \"analysis\";\n\tif (/(implement|refactor|patch|change|rewrite)/.test(lower)) return \"implementation\";\n\treturn \"default\";\n}\n\nfunction deriveScopes(contract: EngineeringContract, touches: string[]): string[] {\n\tif ((contract.scope_include ?? []).length > 0) {\n\t\treturn compact(contract.scope_include ?? []);\n\t}\n\tconst scopes = touches\n\t\t.map((touch) => touch.replace(/^\\.\\//, \"\").split(\"/\").slice(0, 2).join(\"/\"))\n\t\t.filter((value) => value.length > 0)\n\t\t.map((value) => `${value}/**`);\n\treturn compact(scopes).slice(0, 8);\n}\n\nfunction spreadTouches(touches: string[], index: number): string[] {\n\tif (touches.length === 0) return [];\n\tconst start = index % touches.length;\n\tconst result: string[] = [];\n\tfor (let offset = 0; offset < Math.min(3, touches.length); offset += 1) {\n\t\tresult.push(touches[(start + offset) % touches.length] ?? touches[0]!);\n\t}\n\treturn compact(result);\n}\n\nfunction deriveDiffPredictionTouches(index: ProjectIndex, querySeeds: string[], limit = 12): string[] {\n\tconst touches: string[] = [];\n\tfor (const seed of querySeeds) {\n\t\tif (!seed || seed.trim().length === 0) continue;\n\t\tconst matches = queryProjectIndex(index, seed, Math.max(4, Math.floor(limit / 2))).matches;\n\t\tfor (const entry of matches) {\n\t\t\ttouches.push(entry.path);\n\t\t\tif (touches.length >= limit) {\n\t\t\t\treturn compact(touches).slice(0, limit);\n\t\t\t}\n\t\t}\n\t}\n\treturn compact(touches).slice(0, limit);\n}\n\nfunction buildTask(\n\tindex: number,\n\tbrief: string,\n\ttouches: string[],\n\tscopes: string[],\n\tdependsOn: string[],\n\tseverity: SwarmTaskPlan[\"severity\"] = \"medium\",\n): SwarmTaskPlan {\n\tconst taskTouches = compact(touches).slice(0, 8);\n\treturn {\n\t\tid: toTaskId(index),\n\t\tbrief,\n\t\tdepends_on: compact(dependsOn),\n\t\tscopes: compact(scopes),\n\t\ttouches: taskTouches,\n\t\tconcurrency_class: inferConcurrencyClass(brief, taskTouches),\n\t\tseverity,\n\t\tneeds_user_input: false,\n\t\tmodel_hint: \"default\",\n\t\tspawn_policy: severity === \"high\" ? \"manual_high_risk\" : \"allow\",\n\t};\n}\n\nexport function buildSwarmPlanFromTask(input: {\n\trequest: string;\n\tcontract: EngineeringContract;\n\tindex: ProjectIndex;\n}): SwarmPlan {\n\tconst matches = queryProjectIndex(input.index, input.request, 12).matches;\n\tconst diffPredictionTouches = deriveDiffPredictionTouches(input.index, [\n\t\tinput.request,\n\t\t`implement ${input.request}`,\n\t\t`refactor ${input.request}`,\n\t\t`verify ${input.request}`,\n\t]);\n\tconst touches = compact([...matches.map((entry) => entry.path), ...diffPredictionTouches]).slice(0, 12);\n\tconst scopes = deriveScopes(input.contract, touches.length > 0 ? touches : [\"src/**\", \"test/**\"]);\n\n\tconst tasks: SwarmTaskPlan[] = [\n\t\tbuildTask(0, `Map scope and baseline risks for: ${input.request}`, spreadTouches(touches, 0), scopes, [], \"low\"),\n\t\tbuildTask(1, `Implement change for: ${input.request}`, spreadTouches(touches, 1), scopes, [toTaskId(0)], \"high\"),\n\t\tbuildTask(2, `Verify behavior and quality gates for: ${input.request}`, spreadTouches(touches, 2), scopes, [toTaskId(1)], \"medium\"),\n\t];\n\n\tif ((input.contract.definition_of_done ?? []).length > 0 || (input.contract.quality_gates ?? []).length > 0) {\n\t\ttasks.push(\n\t\t\tbuildTask(\n\t\t\t\t3,\n\t\t\t\t\"Finalize integration report and contract gate checklist.\",\n\t\t\t\tspreadTouches(touches, 3),\n\t\t\t\tscopes,\n\t\t\t\t[toTaskId(2)],\n\t\t\t\t\"medium\",\n\t\t\t),\n\t\t);\n\t}\n\n\treturn {\n\t\tsource: \"plain\",\n\t\trequest: input.request,\n\t\ttasks,\n\t\tnotes: [\n\t\t\t\"Plan built from plain-language task and Project Index signals.\",\n\t\t\t`candidate_files=${touches.length}`,\n\t\t\t`diff_prediction_candidates=${diffPredictionTouches.length}`,\n\t\t],\n\t};\n}\n\nexport function buildSwarmPlanFromSingular(input: {\n\tanalysis: SingularAnalysisResult;\n\toption: SingularOption;\n\tcontract: EngineeringContract;\n\tindex: ProjectIndex;\n}): SwarmPlan {\n\tconst optionTouches = compact(input.option.suggested_files);\n\tconst fallbackTouches = queryProjectIndex(input.index, `${input.analysis.request} ${input.option.title}`, 12).matches.map(\n\t\t(entry) => entry.path,\n\t);\n\tconst diffPredictionTouches = deriveDiffPredictionTouches(\n\t\tinput.index,\n\t\t[\n\t\t\tinput.analysis.request,\n\t\t\tinput.option.title,\n\t\t\tinput.option.summary,\n\t\t\t...input.option.plan.slice(0, 6),\n\t\t\t...input.option.pros.slice(0, 3),\n\t\t\t...input.option.cons.slice(0, 3),\n\t\t],\n\t\t14,\n\t);\n\tconst touches = compact([\n\t\t...(optionTouches.length > 0 ? optionTouches : fallbackTouches),\n\t\t...diffPredictionTouches,\n\t]).slice(0, 14);\n\tconst scopes = deriveScopes(input.contract, touches.length > 0 ? touches : [\"src/**\", \"test/**\"]);\n\n\tconst steps = input.option.plan.length > 0\n\t\t? input.option.plan\n\t\t: [`Implement option ${input.option.id}: ${input.option.title}`];\n\n\tconst tasks: SwarmTaskPlan[] = steps.map((step, index) =>\n\t\tbuildTask(\n\t\t\tindex,\n\t\t\tstep,\n\t\t\tspreadTouches(touches, index),\n\t\t\tscopes,\n\t\t\tindex === 0 ? [] : [toTaskId(index - 1)],\n\t\t\tindex === 0 ? \"medium\" : index === steps.length - 1 ? \"medium\" : \"high\",\n\t\t),\n\t);\n\n\tif (tasks.length === 0) {\n\t\ttasks.push(buildTask(0, `Execute selected singular option: ${input.option.title}`, touches, scopes, [], \"high\"));\n\t}\n\n\tconst finalTaskId = toTaskId(tasks.length);\n\ttasks.push(\n\t\tbuildTask(\n\t\t\ttasks.length,\n\t\t\t\"Run final task gates and prepare integration handoff artifact.\",\n\t\t\tspreadTouches(touches, tasks.length),\n\t\t\tscopes,\n\t\t\t[tasks[tasks.length - 1]!.id],\n\t\t\t\"medium\",\n\t\t),\n\t);\n\n\treturn {\n\t\tsource: \"singular\",\n\t\trequest: input.analysis.request,\n\t\ttasks,\n\t\tnotes: [\n\t\t\t`singular_run_id=${input.analysis.runId}`,\n\t\t\t`option=${input.option.id}`,\n\t\t\t`option_title=${input.option.title}`,\n\t\t\t`final_task_id=${finalTaskId}`,\n\t\t\t`diff_prediction_candidates=${diffPredictionTouches.length}`,\n\t\t],\n\t};\n}\n"]}

package/dist/core/swarm/retry.d.ts

@@ -0,0 +1,16 @@
+export type SwarmRetryBucket = "permission" | "dependency_import" | "test" | "timeout" | "unknown";
+export interface SwarmRetryPolicy {
+    maxByBucket: Record<SwarmRetryBucket, number>;
+}
+export declare const DEFAULT_RETRY_POLICY: SwarmRetryPolicy;
+export declare function classifyRetryBucket(errorMessage: string): SwarmRetryBucket;
+export declare function shouldRetry(input: {
+    errorMessage: string;
+    currentRetries: number;
+    policy?: SwarmRetryPolicy;
+}): {
+    retry: boolean;
+    bucket: SwarmRetryBucket;
+    max: number;
+};
+//# sourceMappingURL=retry.d.ts.map

package/dist/core/swarm/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../../src/core/swarm/retry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnG,MAAM,WAAW,gBAAgB;IAChC,WAAW,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED,eAAO,MAAM,oBAAoB,EAAE,gBAQlC,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAO1E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC1B,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAS5D"}

package/dist/core/swarm/retry.js

@@ -0,0 +1,32 @@
+export const DEFAULT_RETRY_POLICY = {
+    maxByBucket: {
+        permission: 1,
+        dependency_import: 2,
+        test: 2,
+        timeout: 2,
+        unknown: 1,
+    },
+};
+export function classifyRetryBucket(errorMessage) {
+    const msg = errorMessage.toLowerCase();
+    if (/(permission|denied|not allowed|forbidden|eacces|eprem)/.test(msg))
+        return "permission";
+    if (/(module not found|cannot find module|importerror|dependency|package)/.test(msg))
+        return "dependency_import";
+    if (/(test failed|assert|expect\(|failing test|spec failed)/.test(msg))
+        return "test";
+    if (/(timeout|timed out|deadline exceeded)/.test(msg))
+        return "timeout";
+    return "unknown";
+}
+export function shouldRetry(input) {
+    const bucket = classifyRetryBucket(input.errorMessage);
+    const policy = input.policy ?? DEFAULT_RETRY_POLICY;
+    const max = policy.maxByBucket[bucket] ?? 0;
+    return {
+        retry: input.currentRetries < max,
+        bucket,
+        max,
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/core/swarm/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../../src/core/swarm/retry.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,oBAAoB,GAAqB;IACrD,WAAW,EAAE;QACZ,UAAU,EAAE,CAAC;QACb,iBAAiB,EAAE,CAAC;QACpB,IAAI,EAAE,CAAC;QACP,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;KACV;CACD,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,YAAoB;IACvD,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,wDAAwD,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,YAAY,CAAC;IAC5F,IAAI,sEAAsE,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACjH,IAAI,wDAAwD,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACtF,IAAI,uCAAuC,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACxE,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAI3B;IACA,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,oBAAoB,CAAC;IACpD,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO;QACN,KAAK,EAAE,KAAK,CAAC,cAAc,GAAG,GAAG;QACjC,MAAM;QACN,GAAG;KACH,CAAC;AACH,CAAC","sourcesContent":["export type SwarmRetryBucket = \"permission\" | \"dependency_import\" | \"test\" | \"timeout\" | \"unknown\";\n\nexport interface SwarmRetryPolicy {\n\tmaxByBucket: Record<SwarmRetryBucket, number>;\n}\n\nexport const DEFAULT_RETRY_POLICY: SwarmRetryPolicy = {\n\tmaxByBucket: {\n\t\tpermission: 1,\n\t\tdependency_import: 2,\n\t\ttest: 2,\n\t\ttimeout: 2,\n\t\tunknown: 1,\n\t},\n};\n\nexport function classifyRetryBucket(errorMessage: string): SwarmRetryBucket {\n\tconst msg = errorMessage.toLowerCase();\n\tif (/(permission|denied|not allowed|forbidden|eacces|eprem)/.test(msg)) return \"permission\";\n\tif (/(module not found|cannot find module|importerror|dependency|package)/.test(msg)) return \"dependency_import\";\n\tif (/(test failed|assert|expect\\(|failing test|spec failed)/.test(msg)) return \"test\";\n\tif (/(timeout|timed out|deadline exceeded)/.test(msg)) return \"timeout\";\n\treturn \"unknown\";\n}\n\nexport function shouldRetry(input: {\n\terrorMessage: string;\n\tcurrentRetries: number;\n\tpolicy?: SwarmRetryPolicy;\n}): { retry: boolean; bucket: SwarmRetryBucket; max: number } {\n\tconst bucket = classifyRetryBucket(input.errorMessage);\n\tconst policy = input.policy ?? DEFAULT_RETRY_POLICY;\n\tconst max = policy.maxByBucket[bucket] ?? 0;\n\treturn {\n\t\tretry: input.currentRetries < max,\n\t\tbucket,\n\t\tmax,\n\t};\n}\n"]}

package/dist/core/swarm/scheduler.d.ts

@@ -0,0 +1,48 @@
+import type { EngineeringContract } from "../contract.js";
+import { type SwarmRetryPolicy } from "./retry.js";
+import type { SwarmDispatchResult, SwarmEvent, SwarmPlan, SwarmRuntimeState, SwarmSchedulerResult, SwarmTaskPlan, SwarmTaskRuntimeState } from "./types.js";
+export interface RunSwarmSchedulerOptions {
+    runId: string;
+    plan: SwarmPlan;
+    contract: EngineeringContract;
+    maxParallel: number;
+    budgetUsd?: number;
+    existingState?: SwarmRuntimeState;
+    retryPolicy?: SwarmRetryPolicy;
+    noProgressTickLimit?: number;
+    spawnCap?: number;
+    progressHeuristic?: {
+        enabled?: boolean;
+        activateAfterNoProgressTicks?: number;
+        minScore?: number;
+    };
+    conflictDensityGuard?: {
+        enabled?: boolean;
+        threshold?: number;
+        minParallel?: number;
+    };
+    confirmSpawn?: (input: {
+        candidate: NonNullable<SwarmDispatchResult["spawnCandidates"]>[number];
+        parentTask: SwarmTaskPlan;
+        parentTaskRuntime: SwarmTaskRuntimeState;
+        state: SwarmRuntimeState;
+    }) => Promise<boolean>;
+    dispatchTask: (input: {
+        task: SwarmTaskPlan;
+        runtime: SwarmTaskRuntimeState;
+        tick: number;
+    }) => Promise<SwarmDispatchResult>;
+    onEvent?: (event: SwarmEvent, state: SwarmRuntimeState) => void;
+    onStateChanged?: (state: SwarmRuntimeState) => void;
+    shouldStop?: () => boolean;
+}
+export interface RunSwarmSchedulerExtendedResult extends SwarmSchedulerResult {
+    spawnBacklog: Array<{
+        fingerprint: string;
+        description: string;
+        path: string;
+        changeType: string;
+    }>;
+}
+export declare function runSwarmScheduler(options: RunSwarmSchedulerOptions): Promise<RunSwarmSchedulerExtendedResult>;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/core/swarm/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/core/swarm/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,OAAO,EAAqC,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEtF,OAAO,KAAK,EACX,mBAAmB,EACnB,UAAU,EAEV,SAAS,EAET,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,qBAAqB,EACrB,MAAM,YAAY,CAAC;AAyOpB,MAAM,WAAW,wBAAwB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,4BAA4B,CAAC,EAAE,MAAM,CAAC;QACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,oBAAoB,CAAC,EAAE;QACtB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE;QACtB,SAAS,EAAE,WAAW,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACvE,UAAU,EAAE,aAAa,CAAC;QAC1B,iBAAiB,EAAE,qBAAqB,CAAC;QACzC,KAAK,EAAE,iBAAiB,CAAC;KACzB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvB,YAAY,EAAE,CAAC,KAAK,EAAE;QACrB,IAAI,EAAE,aAAa,CAAC;QACpB,OAAO,EAAE,qBAAqB,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC;KACb,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAChE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,+BAAgC,SAAQ,oBAAoB;IAC5E,YAAY,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpG;AAED,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,wBAAwB,GAC/B,OAAO,CAAC,+BAA+B,CAAC,CAsY1C"}