snipara-companion 3.2.0 → 3.2.1

package/dist/index.d.ts

@@ -3869,6 +3869,9 @@ interface RuntimeDetectionReport {
         cliAvailable: boolean;
         command?: string;
         version?: string;
+        source?: "path" | "workspace_venv";
+        workspacePackageVersion?: string;
+        versionMismatch?: boolean;
     };
     providerKeys: {
         openai: boolean;

package/dist/index.js

@@ -437,14 +437,14 @@ function resolveProject(opts = {}) {
   }
   return { identifier: path2.basename(cwd), source: "cwd-basename" };
 }
-function findUpward(startDir, relative7) {
+function findUpward(startDir, relative8) {
   let dir = path2.resolve(startDir);
   try {
     dir = fs2.realpathSync(dir);
   } catch {
   }
   while (true) {
-    const candidate = path2.join(dir, relative7);
+    const candidate = path2.join(dir, relative8);
     if (fs2.existsSync(candidate)) return candidate;
     const parent = path2.dirname(dir);
     if (parent === dir) return null;
@@ -2281,8 +2281,8 @@ function normalizeRelativePath2(value) {
   return value.split(path5.sep).join("/");
 }
 function toRepoRelative(repoRoot, absolutePath) {
-  const relative7 = path5.relative(repoRoot, absolutePath);
-  return normalizeRelativePath2(relative7 || path5.basename(absolutePath));
+  const relative8 = path5.relative(repoRoot, absolutePath);
+  return normalizeRelativePath2(relative8 || path5.basename(absolutePath));
 }
 function sha2562(content) {
   return crypto2.createHash("sha256").update(content, "utf8").digest("hex");
@@ -10243,8 +10243,8 @@ function decisionPendingCount(cwd = process.cwd()) {
   return listPendingDecisionRequests(cwd).filter((entry) => entry.status === "pending").length;
 }
 function toProjectRelativePath(absolutePath, cwd) {
-  const relative7 = path11.relative(cwd, absolutePath).replace(/\\/g, "/");
-  return relative7.startsWith(".") ? relative7 : `.${path11.sep}${relative7}`.replace(/\\/g, "/");
+  const relative8 = path11.relative(cwd, absolutePath).replace(/\\/g, "/");
+  return relative8.startsWith(".") ? relative8 : `.${path11.sep}${relative8}`.replace(/\\/g, "/");
 }
 
 // src/commands/memory.ts
@@ -11228,6 +11228,8 @@ function detectRuntimeEnvironment(cwd = process.cwd(), env = process.env) {
   const mcpConfigPaths = findRuntimeMcpConfigPaths(cwd, workspaceRoot);
   const sandboxCli = detectSandboxCli();
   const orchestratorCli = detectOrchestratorCli(cwd, workspaceRoot);
+  const workspaceOrchestratorVersion = findWorkspaceOrchestratorVersion(cwd, workspaceRoot);
+  const orchestratorCliVersion = parseOrchestratorVersion(orchestratorCli.version);
   const parsedVersion = parseRuntimeVersion(sandboxCli.version);
   const providerKeys = detectProviderKeys(cwd, workspaceRoot, env);
   return {
@@ -11251,7 +11253,12 @@ function detectRuntimeEnvironment(cwd = process.cwd(), env = process.env) {
     orchestrator: {
       cliAvailable: Boolean(orchestratorCli.command),
       command: orchestratorCli.command,
-      version: orchestratorCli.version
+      version: orchestratorCli.version,
+      source: orchestratorCli.source,
+      workspacePackageVersion: workspaceOrchestratorVersion,
+      versionMismatch: Boolean(
+        orchestratorCliVersion && workspaceOrchestratorVersion && orchestratorCliVersion !== workspaceOrchestratorVersion
+      )
     },
     providerKeys,
     docker: {
@@ -11391,7 +11398,8 @@ function detectOrchestratorCli(cwd, workspaceRoot) {
   if (version || commandExists(ORCHESTRATOR_COMMAND)) {
     return {
       command: ORCHESTRATOR_COMMAND,
-      version
+      version,
+      source: "path"
     };
   }
   for (const candidate of findWorkspaceExecutableCandidates(
@@ -11404,11 +11412,46 @@ function detectOrchestratorCli(cwd, workspaceRoot) {
     }
     return {
       command: candidate,
-      version: getCommandVersion(candidate)
+      version: getCommandVersion(candidate),
+      source: "workspace_venv"
     };
   }
   return {};
 }
+function findWorkspaceOrchestratorVersion(cwd, workspaceRoot) {
+  const roots = Array.from(
+    new Set([workspaceRoot, path13.resolve(cwd)].filter((value) => Boolean(value)))
+  );
+  for (const root of roots) {
+    const version = readPyprojectVersion(
+      path13.join(root, "packages", "agentic-orchestrator", "pyproject.toml"),
+      "snipara-orchestrator"
+    );
+    if (version) {
+      return version;
+    }
+  }
+  return void 0;
+}
+function readPyprojectVersion(filePath, packageName) {
+  if (!fs14.existsSync(filePath)) {
+    return void 0;
+  }
+  const content = fs14.readFileSync(filePath, "utf-8");
+  const nameMatch = content.match(/^\s*name\s*=\s*["']([^"']+)["']/m);
+  if (nameMatch && nameMatch[1] !== packageName) {
+    return void 0;
+  }
+  const versionMatch = content.match(/^\s*version\s*=\s*["']([^"']+)["']/m);
+  return versionMatch?.[1];
+}
+function parseOrchestratorVersion(version) {
+  if (!version) {
+    return void 0;
+  }
+  const match = version.match(/snipara-orchestrator\s+([^\s]+)/i);
+  return match?.[1];
+}
 function findWorkspaceExecutableCandidates(command, cwd, workspaceRoot) {
   const executableName = process.platform === "win32" ? `${command}.exe` : command;
   const roots = Array.from(
@@ -11998,7 +12041,14 @@ function runtimeVersionSummary(report) {
   return `available (CLI ${report.runtime.cliVersion})`;
 }
 function orchestratorVersionSummary(report) {
-  return report.orchestrator.version ? `available (${report.orchestrator.version})` : "available";
+  const parts = [
+    report.orchestrator.version ?? "version unknown",
+    report.orchestrator.command ? `path ${report.orchestrator.command}` : null,
+    report.orchestrator.source ? `source ${report.orchestrator.source}` : null,
+    report.orchestrator.workspacePackageVersion ? `workspace ${report.orchestrator.workspacePackageVersion}` : null,
+    report.orchestrator.versionMismatch ? "source/install mismatch" : null
+  ].filter((value) => Boolean(value));
+  return `available (${parts.join(", ")})`;
 }
 function sourceLabel(source2) {
   return source2 === "env-file" ? ".env" : "environment";
@@ -12170,6 +12220,7 @@ function buildAdaptiveWorkRoutingRecommendation(options) {
   });
   const warnings = [
     "Recommendation-only dry run; companion does not launch or claim workers.",
+    "Declare local runtimes with `snipara-companion workers local add ...` before expecting a local worker route.",
     ...preferredEndpointTypes.includes("local") ? ["Local endpoint preference requires a runtime catalog or gateway to confirm availability."] : []
   ];
   const routingCard = {
@@ -13555,11 +13606,7 @@ function normalizeAdapterTarget(value) {
   return "custom";
 }
 function normalizeAdapterValues(values) {
-  return [
-    ...new Set(
-      (values ?? []).flatMap((value) => value.split(",")).map((value) => value.trim()).filter(Boolean)
-    )
-  ];
+  return [...new Set((values ?? []).map((value) => value.trim()).filter(Boolean))];
 }
 function normalizeConflictPosture(value, payload) {
   const normalized = value?.trim().toLowerCase().replace(/-/g, "_");
@@ -15040,6 +15087,15 @@ var FINAL_COMMIT_RETRY_SUMMARY_MAX_CHARS = 600;
 var DEFAULT_ADAPTIVE_ROUTING_CATALOG_LIMIT = 20;
 var DEFAULT_LOCAL_ORCHESTRATOR_TIMEOUT_MS = 8e3;
 var ADAPTIVE_ROUTING_POLICY_RELATIVE_PATH2 = path19.join(".snipara", "adaptive-routing.json");
+var MEMORY_DECISION_PRODUCER_ACTIONS = /* @__PURE__ */ new Set([
+  "accept",
+  "reject",
+  "archive",
+  "invalidate",
+  "merge",
+  "supersede",
+  "verify"
+]);
 var SHARED_CONTEXT_INTENT_PATTERN = /\b(standard|standards|convention|conventions|guideline|guidelines|best practice|best practices|policy|policies|compliance|compliant|security rules|team rules|style guide|playbook|checklist)\b/i;
 var DOCUMENT_SYNC_FORMATS = {
   ".adoc": { kind: "DOC", format: "adoc" },
@@ -16110,8 +16166,8 @@ function defaultWorkflowPlanOutputPath(preset, cwd = process.cwd()) {
   return path19.resolve(cwd, WORKFLOW_PLANS_RELATIVE_DIR, `${preset}-plan.json`);
 }
 function toProjectRelativePath2(absolutePath, cwd = process.cwd()) {
-  const relative7 = path19.relative(cwd, absolutePath);
-  return relative7 && !relative7.startsWith("..") ? relative7 : absolutePath;
+  const relative8 = path19.relative(cwd, absolutePath);
+  return relative8 && !relative8.startsWith("..") ? relative8 : absolutePath;
 }
 function buildWorkflowPlanScaffold(preset, options = {}) {
   const cwd = path19.resolve(options.cwd ?? process.cwd());
@@ -17004,6 +17060,30 @@ async function workflowProducerTriageCommand(options) {
 }
 async function workflowDecisionProducerMemoryCommand(options) {
   const action = options.action.trim();
+  if (!MEMORY_DECISION_PRODUCER_ACTIONS.has(action)) {
+    throw new Error(
+      `Invalid memory decision action '${action}'. Use one of: ${[
+        ...MEMORY_DECISION_PRODUCER_ACTIONS
+      ].join(", ")}. Internal review item types such as review_queue_item are not human actions.`
+    );
+  }
+  const reviewItem = await findMemoryReviewConnectorItem(options.memoryId);
+  if (reviewItem) {
+    const request2 = buildMemoryReviewDecisionRequest({
+      ...reviewItem,
+      action,
+      recommendation: options.reviewerHint ?? reviewItem.recommendation,
+      options: action === "verify" ? ["verify", "keep_pending", "invalidate"] : action === "invalidate" ? ["invalidate", "keep", "inspect"] : reviewItem.options.includes(action) ? reviewItem.options : [action, ...reviewItem.options.filter((option) => option !== action)]
+    });
+    const write2 = writeDecisionRequest(request2);
+    if (options.json) {
+      printJson2({ request: request2, write: write2, inheritedFrom: "memory reviews" });
+      return;
+    }
+    console.log(`Decision request ${write2.status}: ${write2.requestId}`);
+    console.log(request2.question);
+    return;
+  }
   const applyPath = action === "verify" ? "snipara_memory_verify" : action === "invalidate" ? "snipara_memory_invalidate" : "snipara_memory_resolve_queue_item";
   const request = buildDecisionRequest({
     producer: {
@@ -17031,6 +17111,20 @@ async function workflowDecisionProducerMemoryCommand(options) {
   }
   console.log(`Decision request ${write.status}: ${write.requestId}`);
 }
+async function findMemoryReviewConnectorItem(memoryId) {
+  try {
+    const result = await buildMemoryReviewConnector({
+      limit: 50,
+      includeCleanCandidates: false,
+      includeDuplicates: false
+    });
+    return result.items.find(
+      (item) => item.memoryId === memoryId || item.evidenceItem.ref === memoryId || item.evidenceItem.ref === `memory:${memoryId}`
+    ) ?? null;
+  } catch {
+    return null;
+  }
+}
 async function workflowDecisionProducerContextRiskCommand(options) {
   const kind = options.kind === "document_tombstone" ? "document_tombstone" : "unknown_registry_risk";
   const request = buildDecisionRequest({
@@ -19498,9 +19592,9 @@ function normalizeSyncDocumentsPayload(payload) {
   };
 }
 function toUploadPath(filePath, rootDir, prefix) {
-  const relative7 = path19.relative(rootDir, filePath).split(path19.sep).join("/");
+  const relative8 = path19.relative(rootDir, filePath).split(path19.sep).join("/");
   const trimmedPrefix = prefix?.replace(/^\/+|\/+$/g, "");
-  return trimmedPrefix ? `${trimmedPrefix}/${relative7}` : relative7;
+  return trimmedPrefix ? `${trimmedPrefix}/${relative8}` : relative8;
 }
 function collectDirectoryDocuments(options) {
   const rootDir = path19.resolve(options.dir);
@@ -22436,11 +22530,7 @@ function normalizeTarget(target) {
   return "custom";
 }
 function unique2(values) {
-  return [
-    ...new Set(
-      (values ?? []).flatMap((value) => value.split(",")).map((value) => value.trim()).filter(Boolean)
-    )
-  ];
+  return [...new Set((values ?? []).map((value) => value.trim()).filter(Boolean))];
 }
 function normalizeTask(task) {
   const normalized = task?.trim();
@@ -22464,8 +22554,8 @@ function safeReadJson(filePath) {
   }
 }
 function relativePath(rootDir, filePath) {
-  const relative7 = path21.relative(rootDir, filePath);
-  return relative7 && !relative7.startsWith("..") ? relative7 : filePath;
+  const relative8 = path21.relative(rootDir, filePath);
+  return relative8 && !relative8.startsWith("..") ? relative8 : filePath;
 }
 function collectAgentReadinessLocalSignals(rootDir = process.cwd()) {
   const workflowPath = path21.join(rootDir, ".snipara", "workflow", "current.json");
@@ -22927,11 +23017,7 @@ function normalizeTask2(task) {
   return normalized ? normalized : void 0;
 }
 function unique3(values) {
-  return [
-    ...new Set(
-      (values ?? []).flatMap((value) => value.split(",")).map((value) => value.trim()).filter(Boolean)
-    )
-  ];
+  return [...new Set((values ?? []).map((value) => value.trim()).filter(Boolean))];
 }
 function isRecord11(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -24285,6 +24371,15 @@ function writeReport2(outputPath, report) {
 `;
   fs23.writeFileSync(absolute, content, "utf8");
 }
+function defaultJsonOutputPath(cwd, report) {
+  const timestamp = report.generatedAt.replace(/[:.]/g, "-");
+  return path22.join(
+    cwd,
+    ".snipara",
+    "lead-plans",
+    `${timestamp}-${slug(report.task ?? "lead-plan", "lead-plan")}.json`
+  );
+}
 async function leadPlanCommand(options) {
   const cwd = path22.resolve(options.dir ?? process.cwd());
   const report = buildCompanionEngineeringLeadPlanReport({
@@ -24292,11 +24387,26 @@ async function leadPlanCommand(options) {
     cwd,
     localSignals: collectAgentReadinessLocalSignals(cwd)
   });
-  if (options.output) {
-    writeReport2(options.output, report);
+  const writtenOutput = options.output ?? (options.json ? defaultJsonOutputPath(cwd, report) : void 0);
+  if (writtenOutput) {
+    writeReport2(writtenOutput, report);
   }
   if (options.json) {
-    console.log(JSON.stringify(report, null, 2));
+    console.log(
+      JSON.stringify(
+        {
+          ...report,
+          outputPath: writtenOutput ? path22.resolve(writtenOutput) : void 0,
+          relativeOutputPath: writtenOutput ? path22.relative(cwd, path22.resolve(writtenOutput)) : void 0,
+          nextCommand: writtenOutput ? `snipara-orchestrator team-sync gate --plan ${path22.relative(
+            cwd,
+            path22.resolve(writtenOutput)
+          )} --json` : void 0
+        },
+        null,
+        2
+      )
+    );
     return;
   }
   console.log(formatCompanionEngineeringLeadPlanReport(report));
@@ -29763,7 +29873,7 @@ program.command("outcome-capture").description("Extract review-pending why/outco
 program.command("lead-plan").description("Create a fail-closed Companion Engineering Lead Plan").option("--task <task>", "Current task or work package summary").option(
   "--target <target>",
   "Target agent or ADE (codex|claude-code|cursor|orca|windsurf|custom)"
-).option("--changed-files <files...>", "Changed or relevant files").option("--context <refs...>", "Context references, decisions, docs, or source facts").option("--proof <proof...>", "Required proof gates or verification evidence").option("--acceptance <criteria...>", "Acceptance criteria for the delegated work").option("--risk <risks...>", "Known risks or caveats").option("--from-cockpit <file>", "Read a Project Health cockpit JSON export").option("--from-plan <file>", "Read a Companion or Project Health Engineering Lead Plan JSON").option("--reconcile", "Reconcile an imported lead plan against current local Companion signals").option("-d, --dir <directory>", "Project directory (default: current)").option("-o, --output <file>", "Write Markdown or JSON report").option("--json", "Print raw JSON").action(async (options) => {
+).option("--changed-files <files...>", "Changed or relevant files").option("--context <refs...>", "Context references, decisions, docs, or source facts").option("--proof <proof...>", "Required proof gates or verification evidence").option("--acceptance <criteria...>", "Acceptance criteria for the delegated work").option("--risk <risks...>", "Known risks or caveats").option("--from-cockpit <file>", "Read a Project Health cockpit JSON export").option("--from-plan <file>", "Read a Companion or Project Health Engineering Lead Plan JSON").option("--reconcile", "Reconcile an imported lead plan against current local Companion signals").option("-d, --dir <directory>", "Project directory (default: current)").option("-o, --output <file>", "Write Markdown or JSON report").option("--out <file>", "Alias for --output").option("--json", "Print raw JSON").action(async (options) => {
   await leadPlanCommand({
     task: options.task,
     target: options.target,
@@ -29776,7 +29886,7 @@ program.command("lead-plan").description("Create a fail-closed Companion Enginee
     fromPlan: options.fromPlan,
     reconcile: Boolean(options.reconcile),
     dir: options.dir,
-    output: options.output,
+    output: options.output ?? options.out,
     json: Boolean(options.json)
   });
 });

package/package.json

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