@clue-ai/cli 0.0.7 → 0.0.8

package/README.md

@@ -66,10 +66,10 @@ detected service.
 
 ## Required Environment
 
-- `CLUE_API_KEY`
-- `CLUE_AI_PROVIDER_API_KEY`
-- `CLUE_AI_PROVIDER`
-- `CLUE_AI_MODEL`
+- `CLUE_API_KEY`: Clue setup screen issues this value.
+- `CLUE_AI_PROVIDER_API_KEY`: the customer's AI provider key, not a Clue key. For Codex/OpenAI, create it at `https://platform.openai.com/api-keys`. For Claude Code/Anthropic, create it at `https://console.anthropic.com/settings/keys`.
+- `CLUE_AI_PROVIDER`: generated from setup target when possible: `codex -> openai`, `claude_code -> anthropic`.
+- `CLUE_AI_MODEL`: generated with a concrete default. OpenAI examples: `gpt-5.4-mini`, `gpt-5.5`, `gpt-5.4-nano`. Anthropic examples: `claude-sonnet-4-6`, `claude-opus-4-7`, `claude-haiku-4-5-20251001`.
 
 `clue-ai semantic-gen` runs semantic AI inside the customer repository CI with
 the customer-configured AI provider key. Clue receives only the final

package/package.json

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

package/src/setup-prepare.mjs

@@ -10,6 +10,62 @@ const DEFAULT_SETUP_MANIFEST_PATH = ".clue/setup-manifest.json";
 const DEFAULT_ENV_GUIDE_PATH = ".env.clue";
 const BROWSER_INGEST_PATH = "/api/v1/ingest/browser";
 const BACKEND_INGEST_PATH = "/api/v1/ingest/backend";
+const AI_PROVIDER_GUIDES = {
+  codex: {
+    provider: "openai",
+    apiKeyValue: "<openai-api-key>",
+    model: "gpt-5.4-mini",
+    secretComments: [
+      "Codexを選んだ場合はOpenAIのAPI keyを使います。",
+      "https://platform.openai.com/api-keys で作成して、GitHub Secretに保存してください。",
+      "ここにはClue API keyではなく、OpenAI API keyを入れてください。",
+    ],
+    providerComments: [
+      "setup targetがcodexのため、providerはopenaiで自動設定しています。",
+    ],
+    modelComments: [
+      "まず迷ったら gpt-5.4-mini を使ってください。",
+      "精度を優先する場合の例: gpt-5.5",
+      "コストを優先する場合の例: gpt-5.4-nano",
+    ],
+  },
+  claude_code: {
+    provider: "anthropic",
+    apiKeyValue: "<anthropic-api-key>",
+    model: "claude-sonnet-4-6",
+    secretComments: [
+      "Claude Codeを選んだ場合はAnthropicのAPI keyを使います。",
+      "https://console.anthropic.com/settings/keys で作成して、GitHub Secretに保存してください。",
+      "ここにはClue API keyではなく、Anthropic API keyを入れてください。",
+    ],
+    providerComments: [
+      "setup targetがclaude_codeのため、providerはanthropicで自動設定しています。",
+    ],
+    modelComments: [
+      "まず迷ったら claude-sonnet-4-6 を使ってください。",
+      "精度を優先する場合の例: claude-opus-4-7",
+      "コストを優先する場合の例: claude-haiku-4-5-20251001",
+    ],
+  },
+};
+const GENERIC_AI_PROVIDER_GUIDE = {
+  provider: "<openai-or-anthropic>",
+  apiKeyValue: "<provider-api-key>",
+  model: "<provider-model>",
+  secretComments: [
+    "OpenAIまたはAnthropicのAPI keyを作成し、GitHub Secretに保存してください。",
+    "OpenAI: https://platform.openai.com/api-keys",
+    "Anthropic: https://console.anthropic.com/settings/keys",
+    "ここにはClue API keyではなく、選択したAI providerのAPI keyを入れてください。",
+  ],
+  providerComments: [
+    "codexを使う場合はopenai、claude_codeを使う場合はanthropicを指定してください。",
+  ],
+  modelComments: [
+    "OpenAIの例: gpt-5.4-mini / gpt-5.5 / gpt-5.4-nano",
+    "Anthropicの例: claude-sonnet-4-6 / claude-opus-4-7 / claude-haiku-4-5-20251001",
+  ],
+};
 
 const writeJson = async ({ repoRoot, path, value }) => {
   const absolutePath = join(resolve(repoRoot), path);
@@ -88,6 +144,9 @@ const trimTrailingSlash = (value) => String(value).replace(/\/+$/, "");
 
 const buildEndpoint = (baseUrl, path) => `${trimTrailingSlash(baseUrl)}${path}`;
 
+const aiProviderGuideForTarget = (target) =>
+  AI_PROVIDER_GUIDES[target] ?? GENERIC_AI_PROVIDER_GUIDE;
+
 const setupContextFromInput = (input = {}) => ({
   clue_api_key: optionalString(input.clueApiKey),
   clue_api_base_url: optionalString(input.clueApiBaseUrl),
@@ -140,6 +199,7 @@ const buildEnvironmentInstructions = ({ manifest, setupContext }) => {
   }
 
   const watchTargets = manifest.lifecycle_verification.watch_targets;
+  const aiProviderGuide = aiProviderGuideForTarget(manifest.target);
   return {
     status: "ready",
     env_file_path: DEFAULT_ENV_GUIDE_PATH,
@@ -157,17 +217,33 @@ const buildEnvironmentInstructions = ({ manifest, setupContext }) => {
         { name: "CLUE_API_KEY", value: setupContext.clue_api_key },
         {
           name: "CLUE_AI_PROVIDER_API_KEY",
-          value: "<openai-or-anthropic-api-key>",
+          value: aiProviderGuide.apiKeyValue,
+          comments: aiProviderGuide.secretComments,
         },
       ],
       variables: [
-        { name: "CLUE_AI_PROVIDER", value: "<openai-or-anthropic>" },
-        { name: "CLUE_AI_MODEL", value: "<selected-provider-model>" },
+        {
+          name: "CLUE_AI_PROVIDER",
+          value: aiProviderGuide.provider,
+          comments: aiProviderGuide.providerComments,
+        },
+        {
+          name: "CLUE_AI_MODEL",
+          value: aiProviderGuide.model,
+          comments: aiProviderGuide.modelComments,
+        },
       ],
     },
   };
 };
 
+const renderEnvironmentEntry = (entry) => [
+  ...(Array.isArray(entry.comments)
+    ? entry.comments.map((comment) => `# ${comment}`)
+    : []),
+  `${entry.name}=${entry.value}`,
+];
+
 const buildEnvironmentGuideText = (instructions) => {
   if (!instructions || instructions.status !== "ready") return null;
   const lines = [
@@ -186,17 +262,13 @@ const buildEnvironmentGuideText = (instructions) => {
   }
   lines.push(
     "GitHub Secrets",
-    ...instructions.ci_github.secrets.map(
-      (entry) => `${entry.name}=${entry.value}`,
-    ),
+    ...instructions.ci_github.secrets.flatMap(renderEnvironmentEntry),
     "",
   );
   if (instructions.ci_github.variables.length > 0) {
     lines.push(
       "GitHub Variables",
-      ...instructions.ci_github.variables.map(
-        (entry) => `${entry.name}=${entry.value}`,
-      ),
+      ...instructions.ci_github.variables.flatMap(renderEnvironmentEntry),
       "",
     );
   }