@fixprompt/cli 0.3.0 → 0.4.0

package/dist/cli.js

@@ -87,7 +87,7 @@ function detectContext() {
 }
 
 // src/connect.ts
-import { readFileSync, readdirSync, statSync } from "fs";
+import { appendFileSync, existsSync, readFileSync, readdirSync, statSync, writeFileSync } from "fs";
 import { join } from "path";
 import { spawnSync } from "child_process";
 var DEFAULT_ENDPOINT = "https://geosloghub-production.up.railway.app";
@@ -255,6 +255,80 @@ function writeToProvider(envVar, token, provider, target, force, cwd) {
       return writeVercel(envVar, token, target);
   }
 }
+function ensureGitignoreHas(cwd, pattern) {
+  const gi = join(cwd, ".gitignore");
+  let s = "";
+  try {
+    s = readFileSync(gi, "utf8");
+  } catch {
+  }
+  const lines = s.split(/\r?\n/);
+  if (lines.some((l) => l.trim() === pattern)) return false;
+  const sep = s.length === 0 || s.endsWith("\n") ? "" : "\n";
+  writeFileSync(gi, s + sep + "\n# FixLoop\n" + pattern + "\n");
+  return true;
+}
+function appendEnvLocal(cwd, token, projectId, projectSlug, endpoint) {
+  const envPath = join(cwd, ".env.local");
+  const lines = [
+    "",
+    "# FixLoop \u2014 read token for the local coding agent. Gitignored.",
+    `# Generated ${(/* @__PURE__ */ new Date()).toISOString()}`,
+    `# Manage / revoke: https://fixloop-dashboard.vercel.app/integrations/${projectId}`,
+    `FIXPROMPT_PROJECT_ID=${projectId}`
+  ];
+  if (projectSlug) lines.push(`FIXPROMPT_PROJECT_SLUG=${projectSlug}`);
+  lines.push(`FIXPROMPT_READ_TOKEN=${token}`);
+  lines.push(`FIXPROMPT_BROKER_URL=${endpoint}`);
+  lines.push("");
+  const block = lines.join("\n");
+  if (existsSync(envPath)) {
+    appendFileSync(envPath, block);
+  } else {
+    writeFileSync(envPath, block.replace(/^\n/, ""));
+  }
+}
+function appendClaudeMdGuidance(cwd, projectId, projectSlug) {
+  const claudePath = join(cwd, "CLAUDE.md");
+  const section = [
+    "",
+    "## FixLoop \u2014 production error logs (auto-fetch on bug reports)",
+    "",
+    'This project ships errors to FixLoop. When the user reports a bug, crash, error, "X is broken", or pastes an error stack:',
+    "",
+    "1. Read the FixLoop env vars from `.env.local` (gitignored \u2014 never commit).",
+    "2. `curl` the broker for recent error lines.",
+    "3. Parse the response `entries[]` \u2014 each has `ts`, `level`, `message`, optional `attrs` + `stack`. Match against the user's symptom.",
+    "4. Propose a fix grounded in what the logs show. **Do not ask the user to paste log lines \u2014 fetch them yourself.**",
+    "",
+    "### Fetch logs",
+    "",
+    "```sh",
+    'curl -sH "x-fixprompt-read-token: $FIXPROMPT_READ_TOKEN" \\',
+    '  "$FIXPROMPT_BROKER_URL/projects/$FIXPROMPT_PROJECT_ID/logs?since=24h&level=error,warn,fatal&limit=200"',
+    "```",
+    "",
+    "Query params: `since` (15m..7d), `level` (csv: debug,info,warn,error,fatal), `q` (substring), `limit` (1..500).",
+    "",
+    projectSlug ? `**Project**: \`${projectSlug}\`.` : "",
+    `Manage / revoke: https://fixloop-dashboard.vercel.app/integrations/${projectId}`,
+    ""
+  ].filter(Boolean).join("\n");
+  if (existsSync(claudePath)) {
+    const existing = readFileSync(claudePath, "utf8");
+    if (existing.includes("## FixLoop \u2014")) return;
+    appendFileSync(claudePath, section);
+  } else {
+    writeFileSync(claudePath, "# Project\n" + section);
+  }
+}
+function writeLocalDiscovery(opts) {
+  console.log(`  \xB7 writing .env.local + CLAUDE.md guidance to ${opts.cwd}\u2026`);
+  const giChanged = ensureGitignoreHas(opts.cwd, ".env.local");
+  if (giChanged) console.log("    + appended .env.local to .gitignore");
+  appendEnvLocal(opts.cwd, opts.token, opts.projectId, opts.projectSlug, opts.endpoint);
+  appendClaudeMdGuidance(opts.cwd, opts.projectId, opts.projectSlug);
+}
 async function connect(args) {
   const cwd = process.cwd();
   const scopeRaw = (args.flags.scope ?? "deploy").toLowerCase();
@@ -272,7 +346,7 @@ async function connect(args) {
   }
   const endpoint = (args.flags.endpoint ?? process.env.FIXPROMPT_ENDPOINT ?? DEFAULT_ENDPOINT).replace(/\/$/, "");
   let projectId = args.flags["project-id"] ?? process.env.FIXPROMPT_PROJECT_ID ?? null;
-  const projectSlug = args.flags["project-slug"] ?? null;
+  let projectSlug = args.flags["project-slug"] ?? null;
   if (!projectId && projectSlug) {
     const res = await fetch(`${endpoint}/admin/projects/by-slug/${encodeURIComponent(projectSlug)}`, {
       headers: { "x-internal-admin-token": adminToken }
@@ -284,6 +358,7 @@ async function connect(args) {
     }
     const parsed = JSON.parse(text);
     projectId = parsed.id;
+    projectSlug = parsed.slug;
     console.log(`  resolved --project-slug=${projectSlug} \u2192 ${parsed.id} (${parsed.name})`);
   }
   if (!projectId) {
@@ -293,8 +368,9 @@ async function connect(args) {
     process.exit(1);
   }
   const explicit = args.flags.provider;
-  const provider = explicit ?? detectProvider(cwd);
-  if (!provider) {
+  const detectedProvider = explicit ?? detectProvider(cwd);
+  const scopeNeedsProvider = scope !== "read";
+  if (scopeNeedsProvider && !detectedProvider) {
     console.error(
       `Couldn't detect a provider from ${cwd}. Pass --provider <eas|vercel|github-actions>.
   Detection looks for: app.json/eas.json (EAS), .vercel/project.json (Vercel),
@@ -302,8 +378,10 @@ async function connect(args) {
     );
     process.exit(1);
   }
+  const provider = detectedProvider;
   const target = {
-    provider,
+    provider: provider ?? "eas",
+    // unused when provider is null; placeholder
     easEnv: args.flags["eas-env"] ?? "production",
     vercelProjectId: args.flags["vercel-project-id"] ?? void 0,
     vercelTargets: typeof args.flags["vercel-targets"] === "string" ? args.flags["vercel-targets"].split(",").map((t) => t.trim()) : void 0
@@ -311,7 +389,7 @@ async function connect(args) {
   const labelBase = args.flags.label ?? `${provider}-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19)}`;
   console.log(`fixprompt connect`);
   console.log(`  scope        : ${scope}`);
-  console.log(`  provider     : ${provider}`);
+  console.log(`  provider     : ${provider ?? "(none \u2014 read-only, writing local files)"}`);
   console.log(`  project_id   : ${projectId}`);
   console.log(`  endpoint     : ${endpoint}`);
   console.log(`  label        : ${labelBase}`);
@@ -326,12 +404,24 @@ async function connect(args) {
 \u2022 Minting ${s} token via broker\u2026`);
     const minted = await mintToken({ endpoint, adminToken, projectId, label, scope: s });
     console.log(`  \u2713 token_id ${minted.token_id}`);
-    await writeToProvider(envVar, minted.token, provider, target, force, cwd);
+    if (s === "read") {
+      writeLocalDiscovery({
+        cwd,
+        token: minted.token,
+        projectId,
+        projectSlug,
+        endpoint
+      });
+    } else if (provider) {
+      await writeToProvider(envVar, minted.token, provider, target, force, cwd);
+    }
     mintedTokens.push({ scope: s, token_id: minted.token_id, envVar });
   }
-  console.log(`
-\u2713 ${mintedTokens.map((m) => m.envVar).join(" + ")} now set on ${provider}.`);
-  if (mintedTokens.some((m) => m.scope === "deploy")) {
+  const readMinted = mintedTokens.some((m) => m.scope === "read");
+  const deployMinted = mintedTokens.some((m) => m.scope === "deploy");
+  console.log("");
+  if (deployMinted && provider) {
+    console.log(`\u2713 FIXPROMPT_DEPLOY_TOKEN set on ${provider}.`);
     if (provider === "eas") {
       console.log(`  Next OTA: npm run release:ota --branch=production --message="..."`);
     } else if (provider === "github-actions") {
@@ -340,9 +430,10 @@ async function connect(args) {
       console.log(`  The deploy token is in your Vercel project env.`);
     }
   }
-  if (mintedTokens.some((m) => m.scope === "read")) {
-    console.log(`  Customer-side agents can now fetch logs via FIXPROMPT_READ_TOKEN \u2014`);
-    console.log(`  see the fixprompt-debug skill at fixloop-dashboard.vercel.app/claude-skill.md.`);
+  if (readMinted) {
+    console.log(`\u2713 FIXPROMPT_READ_TOKEN written to .env.local; CLAUDE.md updated.`);
+    console.log(`  Coding agents (Claude Code / Cursor / Copilot) opening this repo will see`);
+    console.log(`  the FixLoop section in CLAUDE.md and know to fetch logs on bug reports.`);
   }
   console.log(`
   Revoke any of these from the dashboard \u2192 Integrations.`);
@@ -353,7 +444,7 @@ async function connect(args) {
 
 // src/version.ts
 var CLI_NAME = "@fixprompt/cli";
-var CLI_VERSION = "0.3.0";
+var CLI_VERSION = "0.4.0";
 
 // src/cli.ts
 var DEFAULT_ENDPOINT2 = "https://geosloghub-production.up.railway.app";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fixprompt/cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "FixPrompt CLI — annotate deployments and ship them to the broker so the dashboard knows what changed.",
   "license": "UNLICENSED",
   "repository": {