xab 10.0.0 → 11.0.0

package/dist/index.js

@@ -1436,6 +1436,9 @@ async function runEngine(opts, cb) {
     autoSkip = true
   } = opts;
   const config = loadConfig(repoPath, opts.configPath);
+  if (opts.hints?.length) {
+    config.promptHints = [...config.promptHints ?? [], ...opts.hints];
+  }
   const effectiveMaxAttempts = opts.maxAttempts ?? config.maxAttempts ?? Infinity;
   const effectiveWorkBranch = opts.workBranch ?? config.workBranch;
   const commitPrefix = config.commitPrefix ?? "backmerge:";
@@ -1451,6 +1454,12 @@ async function runEngine(opts, cb) {
     for (const l of logs)
       cb.onLog(`  ${l}`, "gray");
   }
+  if (config.promptHints && config.promptHints.length > 0) {
+    cb.onLog(`Active hints (${config.promptHints.length}):`, "cyan");
+    for (const h of config.promptHints) {
+      cb.onLog(`  \u2192 ${h}`, "cyan");
+    }
+  }
   cb.onStatus("Discovering repo structure & docs...");
   const repoCtx = buildRepoContext(repoPath, config);
   const instrCount = repoCtx.instructions.size;
@@ -3043,6 +3052,7 @@ var batch = false;
 var jsonl = false;
 var resume = true;
 var showHelp = false;
+var hints = [];
 for (let i = 0;i < args.length; i++) {
   const arg = args[i];
   if (arg === "--help" || arg === "-h")
@@ -3083,6 +3093,8 @@ for (let i = 0;i < args.length; i++) {
     maxAttempts = parseInt(args[++i], 10) || 2;
   else if (arg === "--config" && args[i + 1])
     configPath = args[++i];
+  else if (arg === "--hint" && args[i + 1])
+    hints.push(args[++i]);
   else if (!arg.startsWith("-"))
     repoPath = arg;
 }
@@ -3119,6 +3131,7 @@ Behavior:
   --no-auto-skip          Don't auto-skip commits AI identifies as present
   --max-attempts <n>      Max retries per commit (default: unlimited)
   --no-resume             Don't resume from interrupted runs (default: auto-resume)
+  --hint <text>           Operator hint injected into AI prompts (repeatable)
   --config <path>         Path to config file (default: auto-discover)
   --help, -h              Show this help
 
@@ -3179,6 +3192,7 @@ var engineOpts = {
   review,
   autoSkip,
   resume,
+  ...hints.length > 0 && { hints },
   maxAttempts,
   ...startAfter && { startAfter },
   ...limit > 0 && { limit },

package/package.json

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