@amistio/cli 0.1.17 → 0.1.18

package/README.md

@@ -51,6 +51,8 @@ Runner setup and local-tool execution use bounded failure controls. `amistio run
 
 Watch mode prints a completed-work success once per work item, keeps fresh completion visible briefly, and returns old completed work to the ready state when no queued, running, blocked, failed, review, or runner-readiness action needs attention.
 
+Known validation failures such as `unsafe_context_path` are printed with attention-needed next steps. For project-context refresh path-safety failures, deploy the latest web/API fix, update and restart the runner when applicable, retry the refresh, and capture only bounded non-secret output if it repeats.
+
 For headless startup after login on supported user-level service managers:
 
 ```sh

package/dist/index.js

@@ -1583,6 +1583,73 @@ function decideSyncState(state) {
 }
 
 // ../shared/src/next-action.ts
+var workFailureGuidanceCodes = ["unsafe_context_path", "unsafe_context_result", "invalid_context_result", "context_map_too_large", "context_map_store_failed"];
+var projectContextFailureGuidance = {
+  unsafe_context_path: {
+    code: "unsafe_context_path",
+    title: "Attention needed",
+    message: "Project context refresh was rejected because a returned path looked unsafe.",
+    steps: [
+      "Deploy the latest web/API fix and update the local runner if this started after a path-safety release.",
+      "Retry the project context refresh.",
+      "If it fails again, capture the failing repo-relative path or bounded runner output without sharing secrets."
+    ]
+  },
+  unsafe_context_result: {
+    code: "unsafe_context_result",
+    title: "Attention needed",
+    message: "Project context refresh was rejected because the result looked like it contained unsafe evidence.",
+    steps: [
+      "Review the local runner output for accidental secret-looking evidence without pasting secrets into Amistio.",
+      "Retry the project context refresh after removing or narrowing unsafe evidence.",
+      "If it repeats, capture a bounded redacted summary of the runner output."
+    ]
+  },
+  invalid_context_result: {
+    code: "invalid_context_result",
+    title: "Attention needed",
+    message: "Project context refresh returned structured data the server could not accept.",
+    steps: [
+      "Update and restart the local runner so it uses the latest context refresh schema.",
+      "Retry the project context refresh.",
+      "If it fails again, capture the bounded marker-delimited result without source dumps or secrets."
+    ]
+  },
+  context_map_too_large: {
+    code: "context_map_too_large",
+    title: "Attention needed",
+    message: "Project context refresh produced a map too large to store safely.",
+    steps: [
+      "Retry the refresh after narrowing the context scope or waiting for smaller incremental refresh support.",
+      "Keep raw source and large dumps out of the context result.",
+      "If this repeats on normal output, split the context-map storage model before retrying large repositories."
+    ]
+  },
+  context_map_store_failed: {
+    code: "context_map_store_failed",
+    title: "Attention needed",
+    message: "Project context refresh could not be stored safely after validation.",
+    steps: [
+      "Retry the project context refresh once.",
+      "If it repeats, check the web/API storage logs for the safe rejection reason.",
+      "Keep the runner output bounded and avoid sharing raw source or secrets."
+    ]
+  }
+};
+function getWorkFailureGuidance(input) {
+  const normalizedMessage = (input.message ?? "").toLowerCase();
+  const code = workFailureGuidanceCodes.find((candidate) => normalizedMessage.includes(candidate));
+  if (!code) {
+    return void 0;
+  }
+  if (input.workKind && input.workKind !== "projectContextRefresh" && !normalizedMessage.includes("project context")) {
+    return void 0;
+  }
+  return projectContextFailureGuidance[code];
+}
+function formatWorkFailureGuidanceDetail(guidance) {
+  return `Next steps: ${guidance.steps.join(" ")}`;
+}
 var nextActionRunnerHeartbeatFreshMs = 15 * 60 * 1e3;
 var nextActionCompletedWorkFreshMs = 60 * 60 * 1e3;
 function computeProjectNextAction(input) {
@@ -1647,11 +1714,11 @@ function computeProjectNextAction(input) {
   }
   const failedBrainGeneration = latestWorkItem(input.workItems.filter((item) => item.workKind === "brainGeneration" && item.status === "failed"));
   if (failedBrainGeneration) {
-    return workAction(failedBrainGeneration, "brainGenerationFailed", "user", "danger", "Brain generation failed", failedBrainGeneration.lastStatusMessage ?? "Retry generation after checking the runner output.");
+    return failedWorkAction(failedBrainGeneration, "brainGenerationFailed", "Brain generation failed", failedBrainGeneration.lastStatusMessage ?? "Retry generation after checking the runner output.");
   }
   const failedPlanRevision = latestWorkItem(input.workItems.filter((item) => item.workKind === "planRevision" && item.status === "failed"));
   if (failedPlanRevision) {
-    return workAction(failedPlanRevision, "planRevisionFailed", "user", "danger", "Plan revision failed", failedPlanRevision.lastStatusMessage ?? "Review the conversation and request another revision if needed.");
+    return failedWorkAction(failedPlanRevision, "planRevisionFailed", "Plan revision failed", failedPlanRevision.lastStatusMessage ?? "Review the conversation and request another revision if needed.");
   }
   const blockedWork = latestWorkItem(input.workItems.filter((item) => item.status === "blocked" || item.status === "changesRequested"));
   if (blockedWork) {
@@ -1659,7 +1726,7 @@ function computeProjectNextAction(input) {
   }
   const failedWork = latestWorkItem(input.workItems.filter((item) => item.status === "failed"));
   if (failedWork) {
-    return workAction(failedWork, "workFailed", "user", "danger", "Work failed", failedWork.lastStatusMessage ?? "Review the failure and retry or update the plan.");
+    return failedWorkAction(failedWork, "workFailed", "Work failed", failedWork.lastStatusMessage ?? "Review the failure and retry or update the plan.");
   }
   const queuedBrainGeneration = latestWorkItem(input.workItems.filter((item) => item.workKind === "brainGeneration" && item.status === "approved"));
   const queuedPlanRevision = latestWorkItem(input.workItems.filter((item) => item.workKind === "planRevision" && item.status === "approved"));
@@ -1698,7 +1765,7 @@ function computeProjectNextAction(input) {
   };
 }
 function formatProjectNextAction(action) {
-  return `${action.title}: ${action.message}`;
+  return `${action.title}: ${action.message}${action.detail ? ` ${action.detail}` : ""}`;
 }
 function runnerWaitAction(readiness, fallbackTitle) {
   const repositoryName = readiness.repositoryLink?.repoName ?? "the paired repository";
@@ -1761,13 +1828,21 @@ function isGeneratedDocument(document) {
   const generatedDraftId = document.frontmatter.generatedDraftId;
   return typeof generatedDraftId === "string" && generatedDraftId.length > 0;
 }
-function workAction(workItem, kind, actor, tone, title, message) {
+function failedWorkAction(workItem, kind, fallbackTitle, fallbackMessage) {
+  const guidance = getWorkFailureGuidance({ message: workItem.lastStatusMessage, workKind: workItem.workKind });
+  if (guidance) {
+    return workAction(workItem, kind, "user", "danger", guidance.title, guidance.message, formatWorkFailureGuidanceDetail(guidance));
+  }
+  return workAction(workItem, kind, "user", "danger", fallbackTitle, fallbackMessage);
+}
+function workAction(workItem, kind, actor, tone, title, message, detail) {
   return {
     kind,
     actor,
     tone,
     title,
     message,
+    ...detail ? { detail } : {},
     workItemId: workItem.workItemId,
     ...workItem.claimedByRunnerId ? { runnerId: workItem.claimedByRunnerId } : {},
     updatedAt: workItem.lastStatusAt
@@ -4974,7 +5049,9 @@ function projectContextRefreshSubmissionFailureSummary(result) {
   if (result.refresh.status !== "failed" && result.workItem.status !== "failed") {
     return void 0;
   }
-  return result.refresh.error ?? result.workItem.lastStatusMessage ?? "Server rejected the project context refresh result.";
+  const summary = result.refresh.error ?? result.workItem.lastStatusMessage ?? "Server rejected the project context refresh result.";
+  const guidance = getWorkFailureGuidance({ message: summary, workKind: "projectContextRefresh" });
+  return guidance ? `${summary} ${formatWorkFailureGuidanceDetail(guidance)}` : summary;
 }
 function createBrainGenerationPrompt(workItem) {
   const wish = workItem.sourceWish ?? workItem.title;