snipara-companion 3.2.15 → 3.2.16

package/dist/index.d.ts

@@ -3149,6 +3149,14 @@ interface AgenticWorkStatus {
         count?: number;
         note: string;
     };
+    operationalLoop: {
+        status: "clear" | "attention" | "blocked";
+        decisionRequestCount: number;
+        receiptGapCount: number;
+        nextActions: string[];
+        receiptActions: string[];
+        caveats: string[];
+    };
     suggestedNextAction: string;
 }
 interface AgenticTimelineEvent {

package/dist/index.js

@@ -23292,6 +23292,68 @@ function buildSuggestedAgenticNextAction(state, risks) {
   }
   return "Run snipara-companion workflow status to inspect the managed workflow.";
 }
+function buildAgenticOperationalLoop(args) {
+  const phase = args.state ? currentWorkflowPhase(args.state) : void 0;
+  const nextActions = [];
+  const receiptActions = [];
+  const caveats = [
+    "Operational Loop is local and advisory; it does not edit Project Policy, approve memory, or bypass verification."
+  ];
+  let receiptGapCount = 0;
+  if (args.pendingDecisionCount > 0) {
+    nextActions.push(
+      `Resolve ${args.pendingDecisionCount} local Decision Request${args.pendingDecisionCount === 1 ? "" : "s"} with snipara-companion workflow decisions and workflow decide.`
+    );
+  }
+  if (args.teamSyncSummary.staleWorkCount > 0) {
+    nextActions.push(
+      "Review stale Team Sync work with snipara-companion team-sync sweep --dry-run before continuing."
+    );
+  }
+  if (args.dirtyFileCount > 0) {
+    nextActions.push("Review dirty git state and run the relevant checks before phase-commit.");
+  }
+  if (args.latestHandoff?.next) {
+    nextActions.push(
+      `Continue latest handoff next step: ${toPreview(args.latestHandoff.next, 160)}`
+    );
+  }
+  if (phase?.status === "blocked") {
+    nextActions.push(`Unblock current phase '${phase.id}' before new implementation work.`);
+  } else if (phase) {
+    nextActions.push(
+      `Continue phase '${phase.id}' and close it with snipara-companion workflow phase-commit ${phase.id}.`
+    );
+  } else if (!args.state) {
+    nextActions.push("Start a managed workflow before multi-step implementation work.");
+  }
+  if (args.state && args.state.status !== "completed") {
+    receiptGapCount += 1;
+    receiptActions.push(
+      "Before closing the phase, capture why/outcome evidence with snipara-companion outcome-capture preview --emit-outcome-receipt."
+    );
+  }
+  if (args.latestHandoff && args.latestHandoff.attention !== "note") {
+    receiptGapCount += 1;
+    receiptActions.push(
+      "Treat the latest Team Sync handoff as needing proof/review evidence before final-commit."
+    );
+  }
+  if (args.pendingDecisionCount > 0) {
+    receiptActions.push(
+      "Decision Request resolution records the human choice; follow-up policy edits remain explicit."
+    );
+  }
+  const status = phase?.status === "blocked" ? "blocked" : args.risks.length > 0 || args.pendingDecisionCount > 0 || receiptGapCount > 0 ? "attention" : "clear";
+  return {
+    status,
+    decisionRequestCount: args.pendingDecisionCount,
+    receiptGapCount,
+    nextActions: uniqueStrings16(nextActions).slice(0, 6),
+    receiptActions: uniqueStrings16(receiptActions).slice(0, 4),
+    caveats
+  };
+}
 function buildAgenticWorkStatus(cwd = process.cwd()) {
   const state = readWorkflowState2(cwd);
   const git = readLocalGitState(cwd);
@@ -23302,6 +23364,7 @@ function buildAgenticWorkStatus(cwd = process.cwd()) {
   const currentPhase = state ? currentWorkflowPhase(state) : void 0;
   const lastPhaseCommit = lastCompletedWorkflowPhase(state);
   const dirtyFileCount = git.statusLines?.length ?? 0;
+  const pendingDecisionCount = decisionPendingCount(cwd);
   const risks = buildAgenticStatusRisks({
     state,
     dirtyFileCount,
@@ -23358,8 +23421,17 @@ function buildAgenticWorkStatus(cwd = process.cwd()) {
     },
     risks,
     openDecisions: {
+      count: pendingDecisionCount,
       note: "Run snipara-companion brief for hosted decisions and memory authority signals."
     },
+    operationalLoop: buildAgenticOperationalLoop({
+      state,
+      dirtyFileCount,
+      risks,
+      pendingDecisionCount,
+      teamSyncSummary,
+      latestHandoff
+    }),
     suggestedNextAction: buildSuggestedAgenticNextAction(state, risks)
   };
 }
@@ -23418,8 +23490,24 @@ function printAgenticWorkStatus(status) {
   }
   console.log("");
   console.log(import_chalk6.default.bold("Open Decisions"));
+  if (typeof status.openDecisions.count === "number") {
+    console.log(`Local pending Decision Requests: ${status.openDecisions.count}`);
+  }
   console.log(status.openDecisions.note);
   console.log("");
+  console.log(import_chalk6.default.bold("Operational Loop"));
+  console.log(`Status: ${status.operationalLoop.status}`);
+  console.log(`Receipt gaps: ${status.operationalLoop.receiptGapCount}`);
+  for (const action of status.operationalLoop.nextActions) {
+    console.log(`- ${action}`);
+  }
+  for (const action of status.operationalLoop.receiptActions) {
+    console.log(`- ${action}`);
+  }
+  for (const caveat of status.operationalLoop.caveats) {
+    console.log(`- ${caveat}`);
+  }
+  console.log("");
   printKeyValue2("Next suggested action:", status.suggestedNextAction);
   if (status.workflow) {
     printKeyValue2("Resume:", status.workflow.resumeCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snipara-companion",
-  "version": "3.2.15",
+  "version": "3.2.16",
   "description": "Local-first CLI that asks your repo what breaks before an AI coding agent edits it.",
   "main": "dist/index.js",
   "bin": {