@ironbee-ai/cli 0.2.1 → 0.4.0

package/dist/hooks/core/session-state.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * IronBee — Session State Management
+ *
+ * Centralized state management for session data.
+ * All session state (retries, activeVerificationId, lastVerdictStatus)
+ * is stored in a single state.json file per session.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTraceId = generateTraceId;
+exports.readState = readState;
+exports.writeState = writeState;
+exports.getActiveVerificationId = getActiveVerificationId;
+exports.setActiveVerification = setActiveVerification;
+exports.getActiveTraceId = getActiveTraceId;
+exports.clearActiveVerification = clearActiveVerification;
+exports.getRetries = getRetries;
+exports.incrementRetries = incrementRetries;
+exports.resetRetries = resetRetries;
+exports.getLastVerdictStatus = getLastVerdictStatus;
+exports.setLastVerdictStatus = setLastVerdictStatus;
+exports.setActiveFix = setActiveFix;
+exports.getActiveFixId = getActiveFixId;
+exports.clearActiveFix = clearActiveFix;
+exports.setPhase = setPhase;
+exports.getPhase = getPhase;
+exports.reconcileSessionState = reconcileSessionState;
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const logger_1 = require("../../lib/logger");
+const STATE_FILE = "state.json";
+const DEFAULT_STATE = {
+    retries: 0,
+    activeVerificationId: null,
+    activeTraceId: null,
+    lastVerdictStatus: null,
+    activeFixId: null,
+    phase: null,
+};
+/** Generate an OTEL-compatible trace ID (32 hex chars / 16 bytes). */
+function generateTraceId() {
+    return (0, crypto_1.randomBytes)(16).toString("hex");
+}
+function readState(sessionDir) {
+    const filePath = (0, path_1.join)(sessionDir, STATE_FILE);
+    if (!(0, fs_1.existsSync)(filePath)) {
+        return { ...DEFAULT_STATE };
+    }
+    try {
+        const content = (0, fs_1.readFileSync)(filePath, "utf-8");
+        const parsed = JSON.parse(content);
+        const validPhases = ["coding", "verifying", "fixing"];
+        return {
+            retries: typeof parsed.retries === "number" ? parsed.retries : 0,
+            activeVerificationId: typeof parsed.activeVerificationId === "string" ? parsed.activeVerificationId : null,
+            activeTraceId: typeof parsed.activeTraceId === "string" ? parsed.activeTraceId : null,
+            lastVerdictStatus: typeof parsed.lastVerdictStatus === "string" ? parsed.lastVerdictStatus : null,
+            activeFixId: typeof parsed.activeFixId === "string" ? parsed.activeFixId : null,
+            phase: typeof parsed.phase === "string" && validPhases.includes(parsed.phase) ? parsed.phase : null,
+        };
+    }
+    catch (e) {
+        logger_1.logger.debug(`failed to read state from ${filePath}: ${e}`);
+        return { ...DEFAULT_STATE };
+    }
+}
+function writeState(sessionDir, state) {
+    const filePath = (0, path_1.join)(sessionDir, STATE_FILE);
+    try {
+        (0, fs_1.mkdirSync)(sessionDir, { recursive: true });
+        (0, fs_1.writeFileSync)(filePath, JSON.stringify(state, null, 2));
+    }
+    catch (e) {
+        logger_1.logger.debug(`failed to write state to ${filePath}: ${e}`);
+    }
+}
+function getActiveVerificationId(sessionDir) {
+    const state = readState(sessionDir);
+    return state.activeVerificationId ?? undefined;
+}
+function setActiveVerification(sessionDir, verificationId, traceId) {
+    const state = readState(sessionDir);
+    state.activeVerificationId = verificationId;
+    state.activeTraceId = traceId;
+    state.phase = "verifying";
+    writeState(sessionDir, state);
+}
+function getActiveTraceId(sessionDir) {
+    const state = readState(sessionDir);
+    return state.activeTraceId ?? undefined;
+}
+function clearActiveVerification(sessionDir) {
+    const state = readState(sessionDir);
+    state.activeVerificationId = null;
+    state.activeTraceId = null;
+    state.phase = "coding";
+    writeState(sessionDir, state);
+}
+function getRetries(sessionDir) {
+    const state = readState(sessionDir);
+    return state.retries;
+}
+function incrementRetries(sessionDir) {
+    const state = readState(sessionDir);
+    state.retries = state.retries + 1;
+    writeState(sessionDir, state);
+    return state.retries;
+}
+function resetRetries(sessionDir) {
+    const state = readState(sessionDir);
+    state.retries = 0;
+    writeState(sessionDir, state);
+}
+function getLastVerdictStatus(sessionDir) {
+    const state = readState(sessionDir);
+    return state.lastVerdictStatus ?? undefined;
+}
+function setLastVerdictStatus(sessionDir, status) {
+    const state = readState(sessionDir);
+    state.lastVerdictStatus = status;
+    writeState(sessionDir, state);
+}
+function setActiveFix(sessionDir, fixId) {
+    const state = readState(sessionDir);
+    state.activeFixId = fixId;
+    writeState(sessionDir, state);
+}
+function getActiveFixId(sessionDir) {
+    const state = readState(sessionDir);
+    return state.activeFixId ?? undefined;
+}
+function clearActiveFix(sessionDir) {
+    const state = readState(sessionDir);
+    state.activeFixId = null;
+    writeState(sessionDir, state);
+}
+function setPhase(sessionDir, phase) {
+    const state = readState(sessionDir);
+    state.phase = phase;
+    writeState(sessionDir, state);
+}
+function getPhase(sessionDir) {
+    const state = readState(sessionDir);
+    return state.phase;
+}
+/**
+ * Reconcile session state on session start/resume.
+ * Closes any open verification or fix cycles, records appropriate
+ * end entries in actions.jsonl, and resets phase to "coding".
+ *
+ * @param appendFn — action appender function (avoids circular import with actions.ts)
+ */
+function reconcileSessionState(sessionDir, actionsFile, appendFn) {
+    const state = readState(sessionDir);
+    let dirty = false;
+    // close abandoned verification
+    if (state.activeVerificationId) {
+        appendFn(actionsFile, {
+            type: "verification_end",
+            timestamp: new Date().toISOString(),
+            verification_id: state.activeVerificationId,
+            trace_id: state.activeTraceId,
+            reason: "session_reconcile",
+        });
+        logger_1.logger.debug(`reconcile: ended abandoned verification ${state.activeVerificationId}`);
+        state.activeVerificationId = null;
+        state.activeTraceId = null;
+        dirty = true;
+    }
+    // close abandoned fix
+    if (state.activeFixId) {
+        appendFn(actionsFile, {
+            type: "fix_end",
+            timestamp: new Date().toISOString(),
+            fix_id: state.activeFixId,
+            reason: "session_reconcile",
+        });
+        logger_1.logger.debug(`reconcile: ended abandoned fix ${state.activeFixId}`);
+        state.activeFixId = null;
+        dirty = true;
+    }
+    // reset phase to coding
+    if (state.phase !== "coding") {
+        state.phase = "coding";
+        dirty = true;
+    }
+    if (dirty) {
+        writeState(sessionDir, state);
+    }
+}
+//# sourceMappingURL=session-state.js.map

package/dist/hooks/core/session-state.js.map

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

package/dist/hooks/core/submit-verdict.d.ts

@@ -9,6 +9,7 @@
  */
 export interface SubmitVerdictInput {
     sessionId: string;
+    sessionDir: string;
     verdictFile: string;
     actionsFile: string;
     verdictJson: string;
@@ -17,5 +18,5 @@ export interface SubmitVerdictResult {
     success: boolean;
     message: string;
 }
-export declare function runSubmitVerdict(input: SubmitVerdictInput): SubmitVerdictResult;
+export declare function runSubmitVerdict(input: SubmitVerdictInput): Promise<SubmitVerdictResult>;
 //# sourceMappingURL=submit-verdict.d.ts.map

package/dist/hooks/core/submit-verdict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"submit-verdict.d.ts","sourceRoot":"","sources":["../../../src/hooks/core/submit-verdict.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,kBAAkB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACnB;AAoCD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CA6E/E"}
+{"version":3,"file":"submit-verdict.d.ts","sourceRoot":"","sources":["../../../src/hooks/core/submit-verdict.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,WAAW,kBAAkB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACnB;AAYD,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgH9F"}

package/dist/hooks/core/submit-verdict.js

@@ -10,37 +10,15 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runSubmitVerdict = runSubmitVerdict;
+const crypto_1 = require("crypto");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const logger_1 = require("../../lib/logger");
+const telemetry_1 = require("../../lib/telemetry");
 const actions_1 = require("./actions");
-function getLastVerdictStatus(actionsFile) {
-    if (!(0, fs_1.existsSync)(actionsFile)) {
-        return undefined;
-    }
-    try {
-        const content = (0, fs_1.readFileSync)(actionsFile, "utf-8");
-        const lines = content.trim().split("\n").filter((l) => l.length > 0);
-        for (let i = lines.length - 1; i >= 0; i--) {
-            try {
-                const entry = JSON.parse(lines[i]);
-                if (entry.type === "verdict_write") {
-                    const verdict = entry.verdict;
-                    return typeof verdict.status === "string" ? verdict.status : undefined;
-                }
-            }
-            catch {
-                // skip malformed lines
-            }
-        }
-        return undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function runSubmitVerdict(input) {
-    const { sessionId, verdictFile, actionsFile, verdictJson } = input;
+const session_state_1 = require("./session-state");
+async function runSubmitVerdict(input) {
+    const { sessionId, sessionDir, verdictFile, actionsFile, verdictJson } = input;
     // parse JSON
     let verdict;
     try {
@@ -75,7 +53,7 @@ function runSubmitVerdict(input) {
     }
     // validate fixes — required when pass after a previous fail
     if (verdict.status === "pass") {
-        const lastStatus = getLastVerdictStatus(actionsFile);
+        const lastStatus = (0, session_state_1.getLastVerdictStatus)(sessionDir);
         if (lastStatus === "fail") {
             if (!Array.isArray(verdict.fixes) || verdict.fixes.length === 0) {
                 return { success: false, message: "REJECTED: when status is \"pass\" after a previous fail, fixes must be a non-empty array describing what was fixed." };
@@ -91,13 +69,45 @@ function runSubmitVerdict(input) {
         logger_1.logger.debug(`submit-verdict: failed to write ${verdictFile}: ${e}`);
         return { success: false, message: `REJECTED: failed to write verdict file: ${e}` };
     }
+    // update last verdict status in session state
+    (0, session_state_1.setLastVerdictStatus)(sessionDir, verdict.status);
+    // auto-record verification_end if there's an active verification
+    const verificationId = (0, session_state_1.getActiveVerificationId)(sessionDir);
+    const traceId = (0, session_state_1.getActiveTraceId)(sessionDir);
+    if (verificationId) {
+        const endEntry = {
+            type: "verification_end",
+            timestamp: new Date().toISOString(),
+            verification_id: verificationId,
+            trace_id: traceId,
+        };
+        (0, actions_1.appendAction)(actionsFile, endEntry);
+        (0, session_state_1.clearActiveVerification)(sessionDir);
+        logger_1.logger.debug(`verification-end (auto): ${verificationId} trace=${traceId}`);
+    }
     // record verdict_write action
     const entry = {
         type: "verdict_write",
         timestamp: new Date().toISOString(),
+        verification_id: verificationId,
+        trace_id: traceId,
         verdict: verdict,
     };
     (0, actions_1.appendAction)(actionsFile, entry);
+    await (0, telemetry_1.trackVerdictWrite)(sessionId, verdict.status);
+    // record fix_start when verdict is fail
+    if (verdict.status === "fail") {
+        const fixId = (0, crypto_1.randomUUID)();
+        const fixEntry = {
+            type: "fix_start",
+            timestamp: new Date().toISOString(),
+            fix_id: fixId,
+        };
+        (0, actions_1.appendAction)(actionsFile, fixEntry);
+        (0, session_state_1.setActiveFix)(sessionDir, fixId);
+        (0, session_state_1.setPhase)(sessionDir, "fixing");
+        logger_1.logger.debug(`fix-start: ${fixId} (verdict was fail)`);
+    }
     logger_1.logger.debug(`submit-verdict: session=${sessionId} status=${verdict.status}`);
     if (verdict.status === "pass") {
         const fixesInfo = verdict.fixes?.length ? ` Fixes: ${verdict.fixes.join(", ")}` : "";

package/dist/hooks/core/submit-verdict.js.map

@@ -1 +1 @@
-{"version":3,"file":"submit-verdict.js","sourceRoot":"","sources":["../../../src/hooks/core/submit-verdict.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAqDH,4CA6EC;AAhID,2BAAwE;AACxE,+BAA+B;AAC/B,6CAA0C;AAC1C,uCAA6D;AAwB7D,SAAS,oBAAoB,CAAC,WAAmB;IAC7C,IAAI,CAAC,IAAA,eAAU,EAAC,WAAW,CAAC,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,IAAI,CAAC;QACD,MAAM,OAAO,GAAW,IAAA,iBAAY,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAa,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAS,EAAW,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAChG,KAAK,IAAI,CAAC,GAAW,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,IAAI,CAAC;gBACD,MAAM,KAAK,GAA4B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAA4B,CAAC;gBACvF,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;oBACjC,MAAM,OAAO,GAA4B,KAAK,CAAC,OAAkC,CAAC;oBAClF,OAAO,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;gBAC3E,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACL,uBAAuB;YAC3B,CAAC;QACL,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAyB;IACtD,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAEnE,aAAa;IACb,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAY,CAAC;IACjD,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QAClB,eAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,EAAE,CAAC,CAAC;QACnD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC;IAC/E,CAAC;IAED,kBAAkB;IAClB,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACzD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mDAAmD,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IAC9G,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC;IAC5F,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,6CAA6C,EAAE,CAAC;IACtF,CAAC;IAED,IAAI,OAAO,OAAO,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;IACrF,CAAC;IAED,IAAI,OAAO,OAAO,CAAC,gBAAgB,KAAK,QAAQ,EAAE,CAAC;QAC/C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;IACvF,CAAC;IAED,0BAA0B;IAC1B,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,6FAA6F,EAAE,CAAC;QACtI,CAAC;IACL,CAAC;IAED,4DAA4D;IAC5D,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAuB,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACzE,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,qHAAqH,EAAE,CAAC;YAC9J,CAAC;QACL,CAAC;IACL,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC;QACD,IAAA,cAAS,EAAC,IAAA,cAAO,EAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,IAAA,kBAAa,EAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QAClB,eAAM,CAAC,KAAK,CAAC,mCAAmC,WAAW,KAAK,CAAC,EAAE,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,2CAA2C,CAAC,EAAE,EAAE,CAAC;IACvF,CAAC;IAED,8BAA8B;IAC9B,MAAM,KAAK,GAAuB;QAC9B,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,OAA6C;KACzD,CAAC;IACF,IAAA,sBAAY,EAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAEjC,eAAM,CAAC,KAAK,CAAC,2BAA2B,SAAS,WAAW,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE9E,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAW,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,0BAA0B,SAAS,EAAE,EAAE,CAAC;IAC7E,CAAC;IAED,MAAM,MAAM,GAAW,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,mCAAmC,MAAM,sBAAsB,EAAE,CAAC;AACvG,CAAC"}
+{"version":3,"file":"submit-verdict.js","sourceRoot":"","sources":["../../../src/hooks/core/submit-verdict.ts"],"names":[],"mappings":"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"}

package/dist/hooks/core/verification-lifecycle.d.ts

@@ -0,0 +1,30 @@
+/**
+ * IronBee — Verification Lifecycle Core Logic
+ *
+ * Manages verification start/end boundaries.
+ * Each verification cycle gets a unique ID and an OTEL-compatible trace ID
+ * linking start → end → verdict.
+ */
+export interface VerificationStartInput {
+    sessionId: string;
+    sessionDir: string;
+    actionsFile: string;
+}
+export interface VerificationStartResult {
+    verificationId: string;
+    traceId: string;
+}
+export interface VerificationEndInput {
+    sessionId: string;
+    sessionDir: string;
+    actionsFile: string;
+}
+export interface VerificationEndResult {
+    success: boolean;
+    verificationId?: string;
+    traceId?: string;
+    message: string;
+}
+export declare function startVerification(input: VerificationStartInput): VerificationStartResult;
+export declare function endVerification(input: VerificationEndInput): VerificationEndResult;
+//# sourceMappingURL=verification-lifecycle.d.ts.map

package/dist/hooks/core/verification-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/hooks/core/verification-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,MAAM,WAAW,sBAAsB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,uBAAuB,CA8CxF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAsBlF"}

package/dist/hooks/core/verification-lifecycle.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * IronBee — Verification Lifecycle Core Logic
+ *
+ * Manages verification start/end boundaries.
+ * Each verification cycle gets a unique ID and an OTEL-compatible trace ID
+ * linking start → end → verdict.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startVerification = startVerification;
+exports.endVerification = endVerification;
+const crypto_1 = require("crypto");
+const logger_1 = require("../../lib/logger");
+const actions_1 = require("./actions");
+const session_state_1 = require("./session-state");
+function startVerification(input) {
+    const { sessionDir, actionsFile } = input;
+    // if there's an active fix, end it before starting verification
+    const activeFixId = (0, session_state_1.getActiveFixId)(sessionDir);
+    if (activeFixId) {
+        const fixEndEntry = {
+            type: "fix_end",
+            timestamp: new Date().toISOString(),
+            fix_id: activeFixId,
+        };
+        (0, actions_1.appendAction)(actionsFile, fixEndEntry);
+        (0, session_state_1.clearActiveFix)(sessionDir);
+        logger_1.logger.debug(`fix-end: ${activeFixId} (starting new verification)`);
+    }
+    // if there's already an active verification, end it first
+    const existingId = (0, session_state_1.getActiveVerificationId)(sessionDir);
+    if (existingId) {
+        const existingTraceId = (0, session_state_1.getActiveTraceId)(sessionDir);
+        logger_1.logger.debug(`ending previous verification ${existingId} before starting new one`);
+        const endEntry = {
+            type: "verification_end",
+            timestamp: new Date().toISOString(),
+            verification_id: existingId,
+            trace_id: existingTraceId,
+        };
+        (0, actions_1.appendAction)(actionsFile, endEntry);
+        (0, session_state_1.clearActiveVerification)(sessionDir);
+    }
+    const verificationId = (0, crypto_1.randomUUID)();
+    const traceId = (0, session_state_1.generateTraceId)();
+    const entry = {
+        type: "verification_start",
+        timestamp: new Date().toISOString(),
+        verification_id: verificationId,
+        trace_id: traceId,
+    };
+    (0, actions_1.appendAction)(actionsFile, entry);
+    (0, session_state_1.setActiveVerification)(sessionDir, verificationId, traceId);
+    logger_1.logger.debug(`verification-start: ${verificationId} trace=${traceId}`);
+    return { verificationId, traceId };
+}
+function endVerification(input) {
+    const { sessionDir, actionsFile } = input;
+    const verificationId = (0, session_state_1.getActiveVerificationId)(sessionDir);
+    if (!verificationId) {
+        return { success: false, message: "No active verification to end." };
+    }
+    const traceId = (0, session_state_1.getActiveTraceId)(sessionDir);
+    const entry = {
+        type: "verification_end",
+        timestamp: new Date().toISOString(),
+        verification_id: verificationId,
+        trace_id: traceId,
+    };
+    (0, actions_1.appendAction)(actionsFile, entry);
+    (0, session_state_1.clearActiveVerification)(sessionDir);
+    logger_1.logger.debug(`verification-end: ${verificationId} trace=${traceId}`);
+    return { success: true, verificationId, traceId, message: `Verification ${verificationId} ended.` };
+}
+//# sourceMappingURL=verification-lifecycle.js.map

package/dist/hooks/core/verification-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-lifecycle.js","sourceRoot":"","sources":["../../../src/hooks/core/verification-lifecycle.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAoCH,8CA8CC;AAED,0CAsBC;AAxGD,mCAAoC;AACpC,6CAA0C;AAC1C,uCAKmB;AACnB,mDAA6K;AA0B7K,SAAgB,iBAAiB,CAAC,KAA6B;IAC3D,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAE1C,gEAAgE;IAChE,MAAM,WAAW,GAAuB,IAAA,8BAAc,EAAC,UAAU,CAAC,CAAC;IACnE,IAAI,WAAW,EAAE,CAAC;QACd,MAAM,WAAW,GAAiB;YAC9B,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,WAAW;SACtB,CAAC;QACF,IAAA,sBAAY,EAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACvC,IAAA,8BAAc,EAAC,UAAU,CAAC,CAAC;QAC3B,eAAM,CAAC,KAAK,CAAC,YAAY,WAAW,8BAA8B,CAAC,CAAC;IACxE,CAAC;IAED,0DAA0D;IAC1D,MAAM,UAAU,GAAuB,IAAA,uCAAuB,EAAC,UAAU,CAAC,CAAC;IAC3E,IAAI,UAAU,EAAE,CAAC;QACb,MAAM,eAAe,GAAuB,IAAA,gCAAgB,EAAC,UAAU,CAAC,CAAC;QACzE,eAAM,CAAC,KAAK,CAAC,gCAAgC,UAAU,0BAA0B,CAAC,CAAC;QACnF,MAAM,QAAQ,GAA0B;YACpC,IAAI,EAAE,kBAAkB;YACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,eAAe,EAAE,UAAU;YAC3B,QAAQ,EAAE,eAAe;SAC5B,CAAC;QACF,IAAA,sBAAY,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACpC,IAAA,uCAAuB,EAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,cAAc,GAAW,IAAA,mBAAU,GAAE,CAAC;IAC5C,MAAM,OAAO,GAAW,IAAA,+BAAe,GAAE,CAAC;IAE1C,MAAM,KAAK,GAA4B;QACnC,IAAI,EAAE,oBAAoB;QAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,eAAe,EAAE,cAAc;QAC/B,QAAQ,EAAE,OAAO;KACpB,CAAC;IACF,IAAA,sBAAY,EAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACjC,IAAA,qCAAqB,EAAC,UAAU,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IAE3D,eAAM,CAAC,KAAK,CAAC,uBAAuB,cAAc,UAAU,OAAO,EAAE,CAAC,CAAC;IAEvE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;AACvC,CAAC;AAED,SAAgB,eAAe,CAAC,KAA2B;IACvD,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAE1C,MAAM,cAAc,GAAuB,IAAA,uCAAuB,EAAC,UAAU,CAAC,CAAC;IAC/E,IAAI,CAAC,cAAc,EAAE,CAAC;QAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,OAAO,GAAuB,IAAA,gCAAgB,EAAC,UAAU,CAAC,CAAC;IAEjE,MAAM,KAAK,GAA0B;QACjC,IAAI,EAAE,kBAAkB;QACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,eAAe,EAAE,cAAc;QAC/B,QAAQ,EAAE,OAAO;KACpB,CAAC;IACF,IAAA,sBAAY,EAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACjC,IAAA,uCAAuB,EAAC,UAAU,CAAC,CAAC;IAEpC,eAAM,CAAC,KAAK,CAAC,qBAAqB,cAAc,UAAU,OAAO,EAAE,CAAC,CAAC;IAErE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,cAAc,SAAS,EAAE,CAAC;AACxG,CAAC"}

package/dist/hooks/core/verify-gate.d.ts

@@ -7,14 +7,14 @@
  */
 export interface VerifyGateInput {
     sessionId: string;
+    sessionDir: string;
     actionsFile: string;
     verdictFile: string;
-    retryFile: string;
     maxRetries?: number;
 }
 export interface VerifyGateResult {
     action: "allow" | "block";
     message?: string;
 }
-export declare function runVerifyGate(input: VerifyGateInput): VerifyGateResult;
+export declare function runVerifyGate(input: VerifyGateInput): Promise<VerifyGateResult>;
 //# sourceMappingURL=verify-gate.d.ts.map

package/dist/hooks/core/verify-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify-gate.d.ts","sourceRoot":"","sources":["../../../src/hooks/core/verify-gate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AA+DD,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,gBAAgB,CA6LtE"}
+{"version":3,"file":"verify-gate.d.ts","sourceRoot":"","sources":["../../../src/hooks/core/verify-gate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAgED,wBAAsB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsLrF"}

package/dist/hooks/core/verify-gate.js

@@ -9,9 +9,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runVerifyGate = runVerifyGate;
 const fs_1 = require("fs");
-const path_1 = require("path");
 const logger_1 = require("../../lib/logger");
+const telemetry_1 = require("../../lib/telemetry");
 const actions_1 = require("./actions");
+const session_state_1 = require("./session-state");
 const DEFAULT_MAX_RETRIES = 3;
 function verdictExamplePass(sessionId) {
     return JSON.stringify({
@@ -35,11 +36,12 @@ function verdictExampleFail(sessionId) {
     });
 }
 const MCP_SERVER = "browser-devtools";
+const TOOL_PREFIX = "bdt_";
 const REQUIRED_TOOLS = [
-    { toolName: `mcp__${MCP_SERVER}__navigation_go-to`, name: `mcp__${MCP_SERVER}__navigation_go-to`, purpose: "navigate to a page" },
-    { toolName: `mcp__${MCP_SERVER}__content_take-screenshot`, name: `mcp__${MCP_SERVER}__content_take-screenshot`, purpose: "take a screenshot" },
-    { toolName: `mcp__${MCP_SERVER}__a11y_take-aria-snapshot`, name: `mcp__${MCP_SERVER}__a11y_take-aria-snapshot`, purpose: "check accessibility/page structure" },
-    { toolName: `mcp__${MCP_SERVER}__o11y_get-console-messages`, name: `mcp__${MCP_SERVER}__o11y_get-console-messages`, purpose: "check console for errors" },
+    { toolName: `mcp__${MCP_SERVER}__${TOOL_PREFIX}navigation_go-to`, name: `mcp__${MCP_SERVER}__${TOOL_PREFIX}navigation_go-to`, purpose: "navigate to a page" },
+    { toolName: `mcp__${MCP_SERVER}__${TOOL_PREFIX}content_take-screenshot`, name: `mcp__${MCP_SERVER}__${TOOL_PREFIX}content_take-screenshot`, purpose: "take a screenshot" },
+    { toolName: `mcp__${MCP_SERVER}__${TOOL_PREFIX}a11y_take-aria-snapshot`, name: `mcp__${MCP_SERVER}__${TOOL_PREFIX}a11y_take-aria-snapshot`, purpose: "check accessibility/page structure" },
+    { toolName: `mcp__${MCP_SERVER}__${TOOL_PREFIX}o11y_get-console-messages`, name: `mcp__${MCP_SERVER}__${TOOL_PREFIX}o11y_get-console-messages`, purpose: "check console for errors" },
 ];
 function cleanup(...files) {
     for (const f of files) {
@@ -53,19 +55,19 @@ function cleanup(...files) {
         }
     }
 }
-function runVerifyGate(input) {
-    const { sessionId: sid, actionsFile, verdictFile, retryFile, maxRetries: inputMaxRetries } = input;
+async function runVerifyGate(input) {
+    const { sessionId: sid, sessionDir, actionsFile, verdictFile, maxRetries: inputMaxRetries } = input;
     const maxRetries = inputMaxRetries ?? DEFAULT_MAX_RETRIES;
     logger_1.logger.debug(`verify-gate: session=${sid} verdictExists=${(0, fs_1.existsSync)(verdictFile)}`);
     // ── Check 1: Were code files edited? ───────────────────
     const hasEdit = (0, actions_1.hasFileEditsSinceLastVerification)(actionsFile);
     if (!hasEdit) {
         logger_1.logger.debug("no code edits detected, allowing completion");
-        recordMarker(actionsFile, "allow", "no_edits");
+        await recordMarker(actionsFile, sid, "allow", "no_edits");
         return { action: "allow" };
     }
-    // ── Check 2: Were required IronBee tools used? ─────────
-    const toolCalls = (0, actions_1.getToolCallsSinceLastVerification)(actionsFile);
+    // ── Check 2: Were required IronBee tools used AFTER the latest code edit? ─
+    const toolCalls = (0, actions_1.getToolCallsSinceLastFileEdit)(actionsFile);
     const usedToolNames = new Set(toolCalls.map((t) => t.tool_name));
     const missingTools = REQUIRED_TOOLS.filter((t) => !usedToolNames.has(t.toolName));
     logger_1.logger.debug(`verify-gate: missingTools=${missingTools.length}/${REQUIRED_TOOLS.length} usedTools=${[...usedToolNames].join(",")}`);
@@ -98,7 +100,7 @@ You made code changes but did not verify them through the browser.
     }
     if (missingTools.length > 0) {
         const missing = missingTools.map((t) => `  - ${t.name} (${t.purpose})`).join("\n");
-        recordMarker(actionsFile, "block", "incomplete_tools");
+        await recordMarker(actionsFile, sid, "block", "incomplete_tools");
         return {
             action: "block",
             message: `INCOMPLETE VERIFICATION.
@@ -112,7 +114,7 @@ Run the missing tools, functionally test your changes, then submit your verdict:
     }
     // ── Check 3: Verdict file exists? ──────────────────────
     if (!(0, fs_1.existsSync)(verdictFile)) {
-        recordMarker(actionsFile, "block", "no_verdict");
+        await recordMarker(actionsFile, sid, "block", "no_verdict");
         return {
             action: "block",
             message: `VERDICT MISSING.
@@ -130,7 +132,7 @@ Submit your verdict:
     catch (e) {
         logger_1.logger.debug(`failed to parse verdict ${verdictFile}: ${e}`);
         cleanup(verdictFile);
-        recordMarker(actionsFile, "block", "invalid_verdict");
+        await recordMarker(actionsFile, sid, "block", "invalid_verdict");
         return {
             action: "block",
             message: `INVALID VERDICT. Submit valid JSON:
@@ -142,7 +144,7 @@ Submit your verdict:
     const checks = verdict.checks;
     if (!Array.isArray(pages) || pages.length === 0) {
         cleanup(verdictFile);
-        recordMarker(actionsFile, "block", "invalid_verdict");
+        await recordMarker(actionsFile, sid, "block", "invalid_verdict");
         return {
             action: "block",
             message: `VERDICT REJECTED: missing pages_tested.
@@ -153,7 +155,7 @@ Your verdict must include which pages you tested.
     }
     if (!Array.isArray(checks) || checks.length === 0) {
         cleanup(verdictFile);
-        recordMarker(actionsFile, "block", "invalid_verdict");
+        await recordMarker(actionsFile, sid, "block", "invalid_verdict");
         return {
             action: "block",
             message: `VERDICT REJECTED: missing checks.
@@ -164,7 +166,7 @@ Your verdict must describe what you functionally tested.
     }
     if (typeof verdict.console_errors !== "number" || typeof verdict.network_failures !== "number") {
         cleanup(verdictFile);
-        recordMarker(actionsFile, "block", "invalid_verdict");
+        await recordMarker(actionsFile, sid, "block", "invalid_verdict");
         return {
             action: "block",
             message: `VERDICT REJECTED: missing console_errors or network_failures count.
@@ -176,25 +178,17 @@ Your verdict must include error counts.
     // ── Check 6: Pass or fail? ─────────────────────────────
     if (verdict.status === "pass") {
         logger_1.logger.debug("verdict passed, allowing completion");
-        cleanup(retryFile);
-        recordMarker(actionsFile, "allow", "verdict_pass");
+        (0, session_state_1.resetRetries)(sessionDir);
+        await recordMarker(actionsFile, sid, "allow", "verdict_pass");
         return { action: "allow" };
     }
     if (verdict.status === "fail") {
-        let retries = 0;
-        try {
-            retries = parseInt((0, fs_1.readFileSync)(retryFile, "utf-8"), 10) || 0;
-        }
-        catch (e) {
-            logger_1.logger.debug(`failed to read retry file ${retryFile}: ${e}`);
-        }
-        retries++;
-        (0, fs_1.mkdirSync)((0, path_1.dirname)(retryFile), { recursive: true });
-        (0, fs_1.writeFileSync)(retryFile, String(retries));
+        const retries = (0, session_state_1.incrementRetries)(sessionDir);
         const issues = (verdict.issues ?? ["unknown"]).join("\n  - ");
         if (retries >= maxRetries) {
-            cleanup(verdictFile, retryFile);
-            recordMarker(actionsFile, "allow", "max_retries_exceeded");
+            cleanup(verdictFile);
+            (0, session_state_1.resetRetries)(sessionDir);
+            await recordMarker(actionsFile, sid, "allow", "max_retries_exceeded");
             return {
                 action: "allow",
                 message: `VERIFICATION FAILED ${maxRetries} TIMES. Allowing completion.
@@ -206,7 +200,7 @@ Report these issues in your final response.`,
             };
         }
         cleanup(verdictFile);
-        recordMarker(actionsFile, "block", "verdict_fail");
+        await recordMarker(actionsFile, sid, "block", "verdict_fail");
         return {
             action: "block",
             message: `VERIFICATION FAILED (attempt ${retries}/${maxRetries}).
@@ -220,14 +214,14 @@ Submit verdict: echo '<verdict-json>' | ironbee hook submit-verdict`,
     }
     // ── Unknown status ─────────────────────────────────────
     cleanup(verdictFile);
-    recordMarker(actionsFile, "block", "invalid_verdict");
+    await recordMarker(actionsFile, sid, "block", "invalid_verdict");
     return {
         action: "block",
         message: `INVALID VERDICT STATUS: "${verdict.status}". Status must be "pass" or "fail".
   echo '${verdictExamplePass(sid)}' | ironbee hook submit-verdict`,
     };
 }
-function recordMarker(actionsFile, action, reason) {
+async function recordMarker(actionsFile, sessionId, action, reason) {
     const marker = {
         type: "verification_requested",
         timestamp: new Date().toISOString(),
@@ -235,5 +229,6 @@ function recordMarker(actionsFile, action, reason) {
         reason,
     };
     (0, actions_1.appendAction)(actionsFile, marker);
+    await (0, telemetry_1.trackVerificationRequested)(sessionId, action, reason);
 }
 //# sourceMappingURL=verify-gate.js.map