@zelari/core 1.28.0 → 1.29.0

package/dist/kraken/index.d.ts

@@ -6,4 +6,5 @@
  */
 export * from './graph.js';
 export * from './conflict.js';
+export * from './verdict.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/kraken/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kraken/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kraken/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/kraken/index.js

@@ -6,4 +6,5 @@
  */
 export * from './graph.js';
 export * from './conflict.js';
+export * from './verdict.js';
 //# sourceMappingURL=index.js.map

package/dist/kraken/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kraken/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kraken/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC"}

package/dist/kraken/verdict.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Kraken graph engine — verify verdict parsing (pure).
+ *
+ * A `verify` node's job is to judge a writer's work, but a tentacle that runs
+ * to completion is a *successful run* regardless of what it concluded: the
+ * executor marked the node `done` and never read the text. A verify that said
+ * "this is wrong" was indistinguishable from one that said "this is correct",
+ * so the graph converged over known-bad work and the only iteration the engine
+ * could do was on execution failure, never on quality.
+ *
+ * This module turns that free text into a decision. The verify prompt asks for
+ * a `VERDICT: PASS` / `VERDICT: FAIL` trailer; the executor parses it and, on
+ * FAIL, spawns a bounded rework round.
+ *
+ * No CLI dependencies (see CORREZIONE-1 in the engine plan).
+ *
+ * @since v1.28.x — verify quality gate
+ */
+/**
+ * What a verify node concluded.
+ *
+ * `unknown` means no trailer was found. It is deliberately distinct from
+ * `pass` so the caller can *report* the omission (a model that quietly stops
+ * emitting the trailer would otherwise disable the whole gate invisibly) while
+ * still treating it as non-blocking.
+ */
+export type VerifyVerdict = 'pass' | 'fail' | 'unknown';
+export interface ParsedVerdict {
+    verdict: VerifyVerdict;
+    /**
+     * The verify's own reasoning — everything except the trailer line, trimmed
+     * and capped. Fed back into the rework node so it knows what to fix.
+     */
+    findings: string;
+}
+/**
+ * Cap on retained findings text. Mirrors `MAX_UPSTREAM_CHARS_PER_DEP` in the
+ * CLI executor, since findings travel the same route (into a sub-agent prompt).
+ */
+export declare const MAX_FINDINGS_CHARS = 2800;
+/**
+ * Extract a verify node's verdict from its conclusion text.
+ *
+ * The **last** trailer wins. Models routinely restate the instruction before
+ * answering ("...end with VERDICT: PASS or VERDICT: FAIL") and a first-match
+ * scan would read that echo as the answer — inverting the gate on exactly the
+ * verbose runs where the judgement matters most.
+ */
+export declare function parseVerifyVerdict(text: string | undefined | null): ParsedVerdict;
+/**
+ * A verify verdict the run could not resolve, carried in the execution summary
+ * and rendered in the digest.
+ *
+ * Lives here (pure) rather than in the CLI executor so the executor and the
+ * status/digest renderer can share it without importing each other.
+ */
+export interface UnresolvedFinding {
+    /** The writer node whose work was judged. */
+    nodeId: string;
+    label: string;
+    /** 'fail' → rework budget exhausted; 'unknown' → no parseable verdict. */
+    reason: 'fail' | 'unknown';
+    findings: string;
+}
+//# sourceMappingURL=verdict.d.ts.map

package/dist/kraken/verdict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.d.ts","sourceRoot":"","sources":["../../src/kraken/verdict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,aAAa,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAUvC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,aAAa,CAsBjF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/kraken/verdict.js

@@ -0,0 +1,68 @@
+/**
+ * Kraken graph engine — verify verdict parsing (pure).
+ *
+ * A `verify` node's job is to judge a writer's work, but a tentacle that runs
+ * to completion is a *successful run* regardless of what it concluded: the
+ * executor marked the node `done` and never read the text. A verify that said
+ * "this is wrong" was indistinguishable from one that said "this is correct",
+ * so the graph converged over known-bad work and the only iteration the engine
+ * could do was on execution failure, never on quality.
+ *
+ * This module turns that free text into a decision. The verify prompt asks for
+ * a `VERDICT: PASS` / `VERDICT: FAIL` trailer; the executor parses it and, on
+ * FAIL, spawns a bounded rework round.
+ *
+ * No CLI dependencies (see CORREZIONE-1 in the engine plan).
+ *
+ * @since v1.28.x — verify quality gate
+ */
+/**
+ * Cap on retained findings text. Mirrors `MAX_UPSTREAM_CHARS_PER_DEP` in the
+ * CLI executor, since findings travel the same route (into a sub-agent prompt).
+ */
+export const MAX_FINDINGS_CHARS = 2800;
+/**
+ * Matches a verdict trailer at the start of a line: `VERDICT: PASS`.
+ * Tolerates leading whitespace, markdown emphasis/bullets the model may wrap
+ * it in (`**VERDICT: FAIL**`, `- VERDICT: PASS`), and any trailing text on the
+ * line (a model that appends "— 3 gaps found" should still be understood).
+ */
+const VERDICT_LINE = /^[\s>*_-]*VERDICT[\s*_]*:[\s*_]*(PASS|FAIL)\b/gim;
+/**
+ * Extract a verify node's verdict from its conclusion text.
+ *
+ * The **last** trailer wins. Models routinely restate the instruction before
+ * answering ("...end with VERDICT: PASS or VERDICT: FAIL") and a first-match
+ * scan would read that echo as the answer — inverting the gate on exactly the
+ * verbose runs where the judgement matters most.
+ */
+export function parseVerifyVerdict(text) {
+    const source = typeof text === 'string' ? text : '';
+    if (source.trim() === '')
+        return { verdict: 'unknown', findings: '' };
+    VERDICT_LINE.lastIndex = 0;
+    let match;
+    let last = null;
+    while ((match = VERDICT_LINE.exec(source)) !== null) {
+        last = match;
+        // A zero-length match would spin forever; the pattern cannot produce one
+        // (it requires the literal "VERDICT"), but guard anyway.
+        if (match.index === VERDICT_LINE.lastIndex)
+            VERDICT_LINE.lastIndex += 1;
+    }
+    if (!last) {
+        return { verdict: 'unknown', findings: capFindings(source) };
+    }
+    const verdict = last[1].toUpperCase() === 'FAIL' ? 'fail' : 'pass';
+    // Everything before the trailer is the reasoning that produced it.
+    const findings = capFindings(source.slice(0, last.index));
+    return { verdict, findings };
+}
+/** Trim and cap findings text, marking the cut so a reader knows it happened. */
+function capFindings(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.length <= MAX_FINDINGS_CHARS)
+        return trimmed;
+    return `${trimmed.slice(0, MAX_FINDINGS_CHARS)}\n… [truncated]`;
+}
+//# sourceMappingURL=verdict.js.map

package/dist/kraken/verdict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verdict.js","sourceRoot":"","sources":["../../src/kraken/verdict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqBH;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,YAAY,GAAG,kDAAkD,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAA+B;IAChE,MAAM,MAAM,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAEtE,YAAY,CAAC,SAAS,GAAG,CAAC,CAAC;IAC3B,IAAI,KAA6B,CAAC;IAClC,IAAI,IAAI,GAA2B,IAAI,CAAC;IACxC,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACpD,IAAI,GAAG,KAAK,CAAC;QACb,yEAAyE;QACzE,yDAAyD;QACzD,IAAI,KAAK,CAAC,KAAK,KAAK,YAAY,CAAC,SAAS;YAAE,YAAY,CAAC,SAAS,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,OAAO,GAAkB,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAClF,mEAAmE;IACnE,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAkBD,iFAAiF;AACjF,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,MAAM,IAAI,kBAAkB;QAAE,OAAO,OAAO,CAAC;IACzD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,iBAAiB,CAAC;AAClE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zelari/core",
-  "version": "1.28.0",
+  "version": "1.29.0",
   "description": "Zelari Code core library — provider-neutral agent loop (AgentHarness), multi-agent council orchestration, and built-in skills. Used by the zelari-code CLI; consumable by other agent frontends.",
   "author": "Anathema Studio <https://anathema-studio.com/>",
   "license": "MIT",