@clue-ai/cli 0.0.20 → 0.0.22

package/bin/clue-cli.mjs

@@ -886,6 +886,83 @@ const renderEnvironmentInstructions = (instructions) => {
   return `${lines.join("\n")}\n`;
 };
 
+const renderSetupResult = ({ preparation }) => {
+  if (preparation?.status === "ready_for_ai") {
+    const envPath =
+      preparation.environment_instructions?.env_file_path ?? ".env.clue";
+    const manifestPath =
+      preparation.artifacts?.setup_manifest_path ?? ".clue/setup-manifest.json";
+    const workflowPath =
+      preparation.artifacts?.ci_workflow_path ??
+      ".github/workflows/clue-semantic-snapshot.yml";
+    return [
+      "Clue setup Step1 が完了しました。",
+      "",
+      "作成したファイル:",
+      `- ${envPath}`,
+      `- ${manifestPath}`,
+      `- ${workflowPath}`,
+      "",
+      "次にやること:",
+      `1. setup画面のStep2を見ながら ${envPath} に各サービスのenvとsetup-agent用AI API keyを設定してください。`,
+      `2. ${clueCliCommand("setup-agent --repo .")} を実行してください。`,
+      "",
+      "補足: CLUE_AI_PROVIDER_API_KEY は Clue API key ではなく、OpenAI または Anthropic の API key です。",
+    ].join("\n");
+  }
+
+  const blockers = Array.isArray(preparation?.blockers)
+    ? preparation.blockers
+        .map((blocker) => blocker.message ?? blocker.reason ?? blocker.code)
+        .filter(Boolean)
+    : [];
+  return [
+    "Clue setup に失敗しました。",
+    "",
+    "原因:",
+    ...(blockers.length > 0
+      ? blockers.map((blocker) => `- ${blocker}`)
+      : ["- setup に必要な情報を検出できませんでした。"]),
+  ].join("\n");
+};
+
+const renderSetupAgentResult = (report) => {
+  if (report?.status === "user_verification_pending") {
+    return [
+      "Clue setup-agent の実行が完了しました。",
+      "",
+      "コード差分を確認してください。",
+      `次の動作確認: ${clueCliCommand("setup-watch --local")}`,
+    ].join("\n");
+  }
+
+  if (report?.code === "CLUE_SETUP_AGENT_AI_CONFIG_MISSING") {
+    const missingInputs = report.setup_doctor?.missing_inputs ?? [];
+    return [
+      "Clue setup-agent を開始できません。",
+      "",
+      `不足している環境変数: ${missingInputs.join(", ")}`,
+      "",
+      ".env.clue の Setup Agent セクションに値を設定してから、もう一度実行してください。",
+      "",
+      "例:",
+      "CLUE_AI_PROVIDER=openai",
+      "CLUE_AI_PROVIDER_API_KEY=<your-openai-api-key>",
+      "CLUE_AI_MODEL=gpt-5.4-mini",
+    ].join("\n");
+  }
+
+  const blocker = report?.blockers?.[0];
+  const reason =
+    blocker?.reason ??
+    report?.setup_doctor?.reason ??
+    report?.code ??
+    "原因を特定できませんでした。";
+  return ["Clue setup-agent に失敗しました。", "", `原因: ${reason}`].join(
+    "\n",
+  );
+};
+
 const main = async () => {
   const { command, flags } = parseArgs(process.argv.slice(2));
   if (
@@ -941,7 +1018,11 @@ const main = async () => {
       flags,
       repoRoot,
     });
-    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+    if (flags.has("json")) {
+      process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+    } else {
+      process.stdout.write(`${renderSetupAgentResult(report)}\n`);
+    }
     if (report.status === "blocked") {
       process.exitCode = 1;
     }
@@ -996,12 +1077,19 @@ const main = async () => {
     const environmentInstructions = renderEnvironmentInstructions(
       preparation.environment_instructions,
     );
-    if (environmentInstructions) {
+    if (environmentInstructions && flags.has("json")) {
       process.stderr.write(environmentInstructions);
     }
-    process.stdout.write(
-      `${JSON.stringify({ ...report, preparation }, null, 2)}\n`,
-    );
+    if (flags.has("json")) {
+      process.stdout.write(
+        `${JSON.stringify({ ...report, preparation }, null, 2)}\n`,
+      );
+    } else {
+      process.stdout.write(`${renderSetupResult({ preparation })}\n`);
+    }
+    if (!flags.has("json") && preparation.status === "blocked") {
+      process.exitCode = 1;
+    }
     return;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clue-ai/cli",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "type": "module",
   "bin": {
     "clue-ai": "bin/clue-cli.mjs"

package/src/setup-agent.mjs

@@ -329,6 +329,35 @@ const attemptFailureContext = ({ attempt, error, setupCheck, stage }) => ({
   failed_checks: failedChecks(setupCheck),
 });
 
+const summarizeFailedChecks = (checks) => {
+  if (!Array.isArray(checks) || checks.length === 0) return null;
+  return checks
+    .map((check) => {
+      const missingApis = Array.isArray(check.details?.missing_apis)
+        ? check.details.missing_apis.filter(Boolean)
+        : [];
+      const parts = [
+        check.id,
+        check.summary,
+        missingApis.length ? `missing APIs: ${missingApis.join(", ")}` : null,
+      ].filter(Boolean);
+      return parts.join(" - ");
+    })
+    .join("; ");
+};
+
+const summarizeAttemptFailure = (failureContext) => {
+  if (!failureContext) return "no attempt details were recorded";
+  if (failureContext.error) {
+    return `attempt ${failureContext.attempt} ${failureContext.stage} failed: ${failureContext.error}`;
+  }
+  const failedCheckSummary = summarizeFailedChecks(failureContext.failed_checks);
+  if (failedCheckSummary) {
+    return `attempt ${failureContext.attempt} setup-check failed: ${failedCheckSummary}`;
+  }
+  return `attempt ${failureContext.attempt} failed without detailed error output`;
+};
+
 export const runSetupAgent = async ({
   env = process.env,
   flags = new Map(),
@@ -490,8 +519,12 @@ export const runSetupAgent = async ({
     },
     blockers: [
       {
-        reason: "setup-agent retry budget exhausted",
-        evidence: failureContext,
+        reason: summarizeAttemptFailure(failureContext),
+        evidence: {
+          ...failureContext,
+          retry_budget_exhausted: true,
+          max_attempts: maxAttempts,
+        },
       },
     ],
     user_verification: {