@kernloop/workflows 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kernloop/workflows",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Kernloop Layer 3 — the canonical loop as data plus the execution engine (spec §6): one blessed graph, per-node checkpoint/resume, and the K-bounded vote-iterate cycle. All real work (model calls, gates, memory) arrives as injected node executors; checkpoint persistence arrives as an injected storage interface — this package imports contracts and zod only.",
   "license": "MIT",
   "type": "module",
@@ -17,7 +17,7 @@
   ],
   "dependencies": {
     "zod": "^4.4.3",
-    "@kernloop/contracts": "0.1.0"
+    "@kernloop/contracts": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "^25.9.3"

package/dist/child-iterate-fixtures.d.ts

@@ -1,36 +0,0 @@
-/**
- * Shared scripted fixtures for the child-iteration + budget-mode tests
- * [CLM-0043, CLM-0077]. Kept apart so neither test file outgrows the 400-line
- * budget; not a runtime export (test-only, imported by `*.test.ts`).
- */
-import type { Brief, Finding, Outcome, TaskContract, Verdict } from '@kernloop/contracts';
-import type { NodeContext, NodeExecutor } from './engine.js';
-export declare const task: TaskContract;
-export declare const brief: (taskId: string) => Brief;
-export declare const verdict: (taskId: string, gate: string, result: Verdict["result"]) => Verdict;
-export declare const outcome: (taskId: string) => Outcome;
-export declare const names: (trace: readonly {
-    node: string;
-    childId?: string;
-}[]) => string[];
-/**
- * A scripted executor set. `qualityByChild` maps a child id to its sequence of
- * quality results (last entry repeats). Records each implement's NodeContext so
- * tests can assert the folded child findings + childIteration.
- */
-export declare function scripted(qualityByChild?: Record<string, Array<Verdict['result']>>): {
-    executors: Record<string, NodeExecutor>;
-    qualityCalls: Record<string, number>;
-    implementCtx: {
-        childId: string;
-        iteration: number;
-        findings: readonly Finding[];
-    }[];
-};
-export declare function counted(executors: Record<string, NodeExecutor>): {
-    executors: {
-        [k: string]: (input: unknown, ctx: NodeContext) => Promise<unknown>;
-    };
-    calls: Record<string, number>;
-};
-//# sourceMappingURL=child-iterate-fixtures.d.ts.map

package/dist/child-iterate-fixtures.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"child-iterate-fixtures.d.ts","sourceRoot":"","sources":["../src/child-iterate-fixtures.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE7D,eAAO,MAAM,IAAI,EAAE,YASlB,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,QAAQ,MAAM,KAAG,KAKrC,CAAC;AAEH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,EAAE,MAAM,MAAM,EAAE,QAAQ,OAAO,CAAC,QAAQ,CAAC,KAAG,OAUhF,CAAC;AAEH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,KAAG,OAOvC,CAAC;AAEH,eAAO,MAAM,KAAK,GAAI,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,aACO,CAAC;AAElF;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAM;;;;iBAE/C,MAAM;mBAAa,MAAM;kBAAY,SAAS,OAAO,EAAE;;EAiC7F;AAED,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;;6BAKjD,OAAO,OAAO,WAAW;;;EAOtC"}

package/dist/child-iterate-fixtures.js

@@ -1,86 +0,0 @@
-export const task = {
-    id: 'task-1',
-    goal: 'ship the feature',
-    constraints: [],
-    budget: { tokens: 1000, usd: 1, wallClockMin: 10 },
-    evidence: [],
-    definitionOfDone: [],
-    authorityCeiling: 'suggest',
-    overlay: 'repo',
-};
-export const brief = (taskId) => ({
-    taskId,
-    sections: [],
-    budget: { allotted: 10, used: 0 },
-    compilerVersion: 'scripted-1',
-});
-export const verdict = (taskId, gate, result) => ({
-    taskId,
-    gate,
-    result,
-    confidence: 1,
-    findings: result === 'approve' || result === 'pass'
-        ? []
-        : [{ severity: 'error', message: `${gate} wants ${taskId} fixed` }],
-    cost: { tokens: 0, usd: 0 },
-});
-export const outcome = (taskId) => ({
-    taskId,
-    status: 'success',
-    signals: [],
-    cost: { tokens: 0, usd: 0 },
-    traceRef: `trace-${taskId}`,
-    distillCandidates: [],
-});
-export const names = (trace) => trace.map((t) => (t.childId === undefined ? t.node : `${t.node}:${t.childId}`));
-/**
- * A scripted executor set. `qualityByChild` maps a child id to its sequence of
- * quality results (last entry repeats). Records each implement's NodeContext so
- * tests can assert the folded child findings + childIteration.
- */
-export function scripted(qualityByChild = {}) {
-    const qualityCalls = {};
-    const implementCtx = [];
-    const executors = {
-        frame: () => Promise.resolve(task),
-        research: () => Promise.resolve(brief(task.id)),
-        plan: () => Promise.resolve(brief(task.id)),
-        vote: (_i, ctx) => Promise.resolve(verdict(ctx.taskId, 'vote', 'approve')),
-        decompose: () => Promise.resolve([
-            { ...task, id: `${task.id}.c1`, parent: task.id },
-            { ...task, id: `${task.id}.c2`, parent: task.id },
-        ]),
-        implement: (input, ctx) => {
-            const c = input;
-            implementCtx.push({
-                childId: c.id,
-                iteration: ctx.childIteration ?? -1,
-                findings: ctx.findings,
-            });
-            return Promise.resolve(outcome(c.id));
-        },
-        quality: (_i, ctx) => {
-            const id = ctx.child?.id ?? ctx.taskId;
-            const seq = qualityByChild[id] ?? ['pass'];
-            const n = qualityCalls[id] ?? 0;
-            qualityCalls[id] = n + 1;
-            return Promise.resolve(verdict(id, 'quality', seq[Math.min(n, seq.length - 1)] ?? 'pass'));
-        },
-        review: (_i, ctx) => Promise.resolve(verdict(ctx.child?.id ?? ctx.taskId, 'review', 'approve')),
-        integrate: () => Promise.resolve(outcome(task.id)),
-        retrospect: (input) => Promise.resolve(input),
-    };
-    return { executors, qualityCalls, implementCtx };
-}
-export function counted(executors) {
-    const calls = {};
-    const wrapped = Object.fromEntries(Object.entries(executors).map(([key, fn]) => [
-        key,
-        (input, ctx) => {
-            calls[key] = (calls[key] ?? 0) + 1;
-            return fn(input, ctx);
-        },
-    ]));
-    return { executors: wrapped, calls };
-}
-//# sourceMappingURL=child-iterate-fixtures.js.map

package/dist/child-iterate-fixtures.js.map

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