xab 2.0.0 → 3.0.0

package/dist/index.js

@@ -473,7 +473,14 @@ You are looking at a worktree based on the TARGET branch "${opts.targetBranch}".
    - "no" = missing
 4. If not fully present, describe a step-by-step strategy for applying cleanly
 5. List which top-level components/directories are affected
-6. Consider: does this change make sense for the target? Is it useful?`;
+6. Consider: does this change make sense for the target? Is it useful?
+7. Check if this commit requires any operator action beyond a normal code deploy:
+   - New environment variables added to .env / .env.example? \u2192 note which ones
+   - Database schema changes or migrations? \u2192 note what to run
+   - New services, containers, or infrastructure to deploy? \u2192 note what
+   - Config files that need manual updates on servers? \u2192 note which
+   - Dependencies on external services being added or removed? \u2192 note what
+   - If the commit is just normal code changes that only need a deploy+restart, leave opsNotes as []`;
   let turn;
   if (diffChunks.length > 1) {
     await thread.run(firstPrompt);
@@ -500,7 +507,8 @@ You now have the complete diff. Analyze and produce your structured response.`,
     alreadyInTarget: "no",
     reasoning: "Could not parse structured output",
     applicationStrategy: "Manual review recommended",
-    affectedComponents: []
+    affectedComponents: [],
+    opsNotes: []
   });
 }
 async function applyCommit(opts) {
@@ -642,9 +650,14 @@ var init_codex = __esm(() => {
         type: "array",
         items: { type: "string" },
         description: "Top-level directories/components affected (e.g. 'api', 'frontend', 'contracts')"
+      },
+      opsNotes: {
+        type: "array",
+        items: { type: "string" },
+        description: "Operator action items ONLY if this commit requires something beyond a standard code deploy+restart. Examples: new env vars to add, database migrations to run, new services to deploy, infrastructure changes, config file updates on servers. Leave as empty array [] if no operator action is needed \u2014 a normal code deploy does NOT count."
       }
     },
-    required: ["summary", "alreadyInTarget", "reasoning", "applicationStrategy", "affectedComponents"],
+    required: ["summary", "alreadyInTarget", "reasoning", "applicationStrategy", "affectedComponents", "opsNotes"],
     additionalProperties: false
   };
   applyResultSchema = {
@@ -1260,7 +1273,8 @@ async function runEngine(opts, cb) {
       worktreePath: "",
       workBranch: "",
       auditDir: "",
-      commits: []
+      commits: [],
+      opsNotes: []
     };
   }
   cb.onStatus("Detecting already cherry-picked commits...");
@@ -1293,7 +1307,8 @@ async function runEngine(opts, cb) {
       worktreePath: "",
       workBranch: "",
       auditDir: "",
-      commits: commitsToProcess
+      commits: commitsToProcess,
+      opsNotes: []
     };
   }
   const repoName = repoPath.split("/").pop() ?? "repo";
@@ -1394,13 +1409,26 @@ async function runEngine(opts, cb) {
     cb.onDecision(commit, decision);
   }
   audit.runEnd(summary, decisions);
+  const opsNotes = decisions.filter((d) => d.opsNotes && d.opsNotes.length > 0).map((d) => ({ commitHash: d.commitHash, commitMessage: d.commitMessage, notes: d.opsNotes }));
+  if (opsNotes.length > 0) {
+    cb.onLog("", "gray");
+    cb.onLog("\u2550\u2550\u2550 OPERATOR NOTES \u2550\u2550\u2550", "yellow");
+    for (const entry of opsNotes) {
+      cb.onLog(`  ${entry.commitHash.slice(0, 8)} ${entry.commitMessage}:`, "yellow");
+      for (const note of entry.notes) {
+        cb.onLog(`    \u2192 ${note}`, "yellow");
+      }
+    }
+    cb.onLog("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550", "yellow");
+  }
   return {
     summary,
     decisions,
     worktreePath: wtPath,
     workBranch: wbName,
     auditDir: audit.runDir,
-    commits: commitsToProcess
+    commits: commitsToProcess,
+    opsNotes
   };
 }
 async function processOneCommit(o) {
@@ -1452,12 +1480,12 @@ async function processOneCommit(o) {
     };
   }
   if (o.dryRun) {
-    const kind = analysis.alreadyInTarget === "partial" ? "would_apply" : "would_apply";
     return {
-      kind,
+      kind: "would_apply",
       commitHash: commit.hash,
       commitMessage: commit.message,
       reason: analysis.applicationStrategy.slice(0, 300),
+      opsNotes: analysis.opsNotes.length > 0 ? analysis.opsNotes : undefined,
       durationMs: Date.now() - start
     };
   }
@@ -1656,6 +1684,7 @@ async function processOneCommit(o) {
       newCommitHash: validation.newCommitHash ?? undefined,
       filesChanged: applyResult.filesChanged,
       reviewApproved: o.review ? true : undefined,
+      opsNotes: analysis.opsNotes.length > 0 ? analysis.opsNotes : undefined,
       durationMs: Date.now() - start
     };
     const invariantErrors = validateDecision(d, headBefore, headAfter, o.dryRun);
@@ -1739,7 +1768,8 @@ async function runBatch(opts) {
       summary: result.summary,
       worktree: result.worktreePath,
       branch: result.workBranch,
-      auditDir: result.auditDir
+      auditDir: result.auditDir,
+      opsNotes: result.opsNotes
     });
     const { summary } = result;
     if (summary.failed > 0)
@@ -2433,6 +2463,42 @@ function App({ repoPath, engineOpts }) {
               }, undefined, true, undefined, this)
             ]
           }, undefined, true, undefined, this),
+          result.opsNotes.length > 0 && /* @__PURE__ */ jsxDEV(Box, {
+            flexDirection: "column",
+            borderStyle: "round",
+            borderColor: "yellow",
+            paddingX: 1,
+            marginTop: 1,
+            children: [
+              /* @__PURE__ */ jsxDEV(Text, {
+                bold: true,
+                color: "yellow",
+                children: "Operator Notes"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV(Newline, {}, undefined, false, undefined, this),
+              result.opsNotes.map((entry) => /* @__PURE__ */ jsxDEV(Box, {
+                flexDirection: "column",
+                children: [
+                  /* @__PURE__ */ jsxDEV(Text, {
+                    color: "yellow",
+                    children: [
+                      entry.commitHash.slice(0, 8),
+                      " ",
+                      entry.commitMessage
+                    ]
+                  }, undefined, true, undefined, this),
+                  entry.notes.map((note, i) => /* @__PURE__ */ jsxDEV(Text, {
+                    color: "yellow",
+                    children: [
+                      " ",
+                      "\u2192 ",
+                      note
+                    ]
+                  }, i, true, undefined, this))
+                ]
+              }, entry.commitHash, true, undefined, this))
+            ]
+          }, undefined, true, undefined, this),
           /* @__PURE__ */ jsxDEV(ActionBar, {
             actions: [{ key: "q", label: "Exit", color: "gray" }]
           }, undefined, false, undefined, this)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xab",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "AI-powered curated branch reconciliation engine",
   "type": "module",
   "bin": {