@cassiomc1/forgeloop 1.6.4 → 1.6.5

package/AGENT_COMPATIBILITY.md

@@ -0,0 +1,11 @@
+# Deprecated filename
+
+> Deprecated since package `1.2.4`; retained as a repository compatibility stub.
+> It is not part of the public integration surface and is scheduled for removal
+> in the next compatibility-breaking release.
+
+ForgeLoop is vendor-neutral and does not use a supported-agent allowlist.
+
+The canonical integration contract is:
+
+[`PROTOCOL_INTEGRATION.md`](./PROTOCOL_INTEGRATION.md)

package/docs/AGENT_PROTOCOL_SUMMARY.md

@@ -7,7 +7,7 @@
 ForgeLoop is a portable protocol and support CLI for verifiable engineering workflows. It records and validates task state, contracts, routing, checks, evidence, continuity, and optional code attestations. It does not become an agent scheduler, delegation service, source-control authority, or secret manager.
 
 Protocol version: 1
-Package version: 1.6.4
+Package version: 1.6.5
 
 ## Canonical loop
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cassiomc1/forgeloop",
-  "version": "1.6.4",
+  "version": "1.6.5",
   "description": "Portable, verifiable engineering protocol for AI coding environments and developer workflows",
   "repository": {
     "type": "git",
@@ -28,6 +28,7 @@
     "GUIDE_ROUTER.md",
     "LOOP_ENGINEERING.md",
     "PROTOCOL_INTEGRATION.md",
+    "AGENT_COMPATIBILITY.md",
     "LOOP_SYSTEM_DESIGN.md",
     "QUALITY_SCORECARD.md",
     "TERMINOLOGY.md",

package/src/core/resumability.js

@@ -26,7 +26,7 @@ async function deriveResumePhaseFromLedger(target, packageRoot, taskId) {
     return null;
   }
   if (!ledger?.valid) return null;
-  const scoped = (ledger.events ?? []).filter((event) => event.taskId === taskId);
+  const scoped = (ledger.events ?? []).filter((event) => !taskId || event.taskId === taskId);
   if (scoped.some((event) => event.event === "COMPLETION_VALIDATED")) return null;
   const positions = RESUME_PHASE_BY_MILESTONE;
   let derived = null;
@@ -42,6 +42,20 @@ async function deriveResumePhaseFromLedger(target, packageRoot, taskId) {
   return derived;
 }
 
+function deriveVerificationCycleFromLedger(events) {
+  const cycleEvents = new Set([
+    "VERIFICATION_STARTED",
+    "VERIFICATION_RECORDED",
+    "DIAGNOSIS_RECORDED",
+    "DIAGNOSTIC_CASE_RECORDED",
+  ]);
+  const cycles = events
+    .filter((event) => cycleEvents.has(event.event))
+    .map((event) => event.details?.verificationCycle)
+    .filter((cycle) => Number.isInteger(cycle) && cycle >= 1);
+  return cycles.at(-1);
+}
+
 function resumeSteps(phase) {
   if (phase === "EXECUTING" || phase === "VERIFYING") {
     return {
@@ -61,6 +75,17 @@ export async function ensureResumableState({ target, packageRoot, contract, rout
   if (existing) return existing;
 
   const resumedPhase = await deriveResumePhaseFromLedger(target, packageRoot, taskId) ?? "ROUTED";
+  let verificationCycle;
+  try {
+    const ledger = await validateEventLedger(target, packageRoot, { taskId });
+    if (ledger.valid) {
+      verificationCycle = deriveVerificationCycleFromLedger(
+        (ledger.events ?? []).filter((event) => !taskId || event.taskId === taskId),
+      );
+    }
+  } catch {
+    verificationCycle = undefined;
+  }
   const steps = resumeSteps(resumedPhase);
   const state = createWorkState({
     taskId: contract.value.taskId,
@@ -71,6 +96,7 @@ export async function ensureResumableState({ target, packageRoot, contract, rout
     selectedGuides: route.value.guides,
     completedSteps: steps.completedSteps,
     pendingSteps: steps.pendingSteps,
+    ...(verificationCycle !== undefined ? { verificationCycle } : {}),
     checks: [],
     failures: [],
     blockers: [],