@clue-ai/cli 0.0.19 → 0.0.20

package/bin/clue-cli.mjs

@@ -876,7 +876,10 @@ const renderEnvironmentInstructions = (instructions) => {
   const lines = [
     "",
     `環境変数の設定内容を ${instructions.env_file_path} に書き出しました。`,
-    `Step2で ${instructions.env_file_path} を開き、各サービスの env と GitHub Secrets/Variables に反映してください。`,
+    `Step2で ${instructions.env_file_path} を開き、各サービスの env、setup-agent 用AI設定、GitHub Secrets/Variables に反映してください。`,
+    `Step3で setup-agent を実行する前に ${instructions.setup_agent_required_env_names?.join(", ") ?? "CLUE_AI_PROVIDER, CLUE_AI_PROVIDER_API_KEY, CLUE_AI_MODEL"} を設定してください。`,
+    "CLUE_AI_PROVIDER_API_KEY は Clue API key ではなく、OpenAI または Anthropic の API key です。",
+    `setup-agent 実行: ${instructions.setup_agent_command ?? clueCliCommand("setup-agent --repo .")}`,
     `${instructions.env_file_path} は秘密情報を含むため、コミットしないでください。`,
     "",
   ];

package/package.json

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

package/src/setup-agent.mjs

@@ -10,6 +10,11 @@ import { runSetupDoctor } from "./setup-doctor.mjs";
 const DEFAULT_SETUP_MANIFEST_PATH = ".clue/setup-manifest.json";
 const DEFAULT_ENV_GUIDE_PATH = ".env.clue";
 const DEFAULT_MAX_ATTEMPTS = 3;
+const REQUIRED_SETUP_AGENT_AI_ENV_NAMES = [
+  "CLUE_AI_PROVIDER",
+  "CLUE_AI_PROVIDER_API_KEY",
+  "CLUE_AI_MODEL",
+];
 const DEPENDENCY_WRITE_FILE_CANDIDATES = [
   "package.json",
   "package-lock.json",
@@ -80,6 +85,50 @@ const aiProviderEnvFromFlags = ({ env, flags }) => {
   };
 };
 
+const missingSetupAgentAiEnvNames = (env) =>
+  REQUIRED_SETUP_AGENT_AI_ENV_NAMES.filter((name) => !optionalString(env[name]));
+
+const blockedMissingAiProviderConfig = ({ manifestPath, missingInputs }) => ({
+  status: "blocked",
+  code: "CLUE_SETUP_AGENT_AI_CONFIG_MISSING",
+  manifest_path: manifestPath,
+  attempts: [],
+  setup_check: null,
+  setup_doctor: {
+    status: "skipped",
+    reason: "AI provider configuration is missing",
+    missing_inputs: missingInputs,
+    report: null,
+  },
+  blockers: [
+    {
+      reason:
+        "setup-agent requires CLUE_AI_PROVIDER, CLUE_AI_PROVIDER_API_KEY, and CLUE_AI_MODEL before lifecycle planning",
+      evidence: {
+        missing_inputs: missingInputs,
+        env_file_path: DEFAULT_ENV_GUIDE_PATH,
+        supported_providers: ["openai", "anthropic"],
+        cli_flags: [
+          "--ai-provider",
+          "--ai-provider-api-key",
+          "--ai-model",
+        ],
+      },
+    },
+  ],
+  next_steps: [
+    "Open .env.clue and replace CLUE_AI_PROVIDER_API_KEY with an OpenAI API key for codex or an Anthropic API key for claude_code.",
+    "Confirm CLUE_AI_PROVIDER and CLUE_AI_MODEL are set in .env.clue or process env.",
+    "Alternatively run setup-agent with --ai-provider, --ai-provider-api-key, and --ai-model.",
+  ],
+  user_verification: {
+    setup_watch_owner: "user",
+    setup_watch_auto_run: false,
+    status: "not_reached",
+    required_command: "npx -y @clue-ai/cli setup-watch --local",
+  },
+});
+
 const requireManifest = async ({ manifestPath, repoRoot }) => {
   try {
     return await readJson(resolve(repoRoot, manifestPath));
@@ -344,6 +393,13 @@ export const runSetupAgent = async ({
     DEFAULT_MAX_ATTEMPTS,
   );
   const aiEnv = aiProviderEnvFromFlags({ env: mergedEnv, flags });
+  const missingAiInputs = missingSetupAgentAiEnvNames(aiEnv);
+  if (missingAiInputs.length > 0) {
+    return blockedMissingAiProviderConfig({
+      manifestPath,
+      missingInputs: missingAiInputs,
+    });
+  }
   const attempts = [];
   let failureContext = null;
   let lastSetupCheck = null;

package/src/setup-prepare.mjs

@@ -32,6 +32,11 @@ const BACKEND_RUNTIME_ENV_NAMES = [
   "CLUE_INGEST_ENDPOINT",
   "CLUE_API_KEY",
 ];
+const SETUP_AGENT_AI_ENV_NAMES = [
+  "CLUE_AI_PROVIDER",
+  "CLUE_AI_PROVIDER_API_KEY",
+  "CLUE_AI_MODEL",
+];
 const AI_PROVIDER_GUIDES = {
   codex: {
     provider: "openai",
@@ -352,6 +357,14 @@ const buildEnvironmentGuideText = (instructions) => {
       "",
     );
   }
+  lines.push(
+    "Setup Agent",
+    "# Before running `npx -y @clue-ai/cli setup-agent --repo .`, set the AI provider values below.",
+    "# setup-agent reads CLUE_AI_PROVIDER, CLUE_AI_PROVIDER_API_KEY, and CLUE_AI_MODEL from this file or process env.",
+    "# CLUE_AI_PROVIDER_API_KEY is not a Clue key. It must be an OpenAI key for codex or an Anthropic key for claude_code.",
+    "# You may also pass --ai-provider, --ai-provider-api-key, and --ai-model directly to setup-agent.",
+    "",
+  );
   lines.push(
     "GitHub Secrets",
     ...instructions.ci_github.secrets.flatMap(renderEnvironmentEntry),
@@ -374,7 +387,9 @@ const summarizeEnvironmentInstructions = (instructions) => {
   return {
     status: "ready",
     env_file_path: instructions.env_file_path,
-    message: `${instructions.env_file_path} を開き、各サービスの env と GitHub Secrets に反映してください。`,
+    message: `${instructions.env_file_path} を開き、各サービスの env、setup-agent 用AI設定、GitHub Secrets/Variables に反映してください。`,
+    setup_agent_required_env_names: SETUP_AGENT_AI_ENV_NAMES,
+    setup_agent_command: "npx -y @clue-ai/cli setup-agent --repo .",
     service_env_block_count: instructions.service_env_blocks.length,
     github_secret_names: instructions.ci_github.secrets.map(
       (entry) => entry.name,