@fixprompt/cli 0.3.0 → 0.5.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,183 @@ 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 detectRuntime(cwd) {
+  const pj = join(cwd, "package.json");
+  if (!existsSync(pj)) return "unknown";
+  try {
+    const j = JSON.parse(readFileSync(pj, "utf8"));
+    const deps = { ...j.dependencies || {}, ...j.devDependencies || {} };
+    if (deps["react-native"] || deps["expo"]) return "react-native";
+    if (deps["next"]) return "next";
+    if (deps["react"] || deps["vite"] || deps["react-scripts"]) return "browser";
+    if (deps["@nestjs/core"] || deps["express"] || deps["fastify"]) return "node";
+  } catch {
+  }
+  return "unknown";
+}
+var FIXLOOP_SECTION_MARKER = "<!-- fixloop:claude-section -->";
+function buildClaudeMdSection(projectId, projectSlug, runtime) {
+  const sdkRows = {
+    "react-native": {
+      pkg: "@fixprompt/react-native",
+      entry: "App.tsx / index.js \u2014 call before the first render",
+      example: "import { initFixPrompt } from '@fixprompt/react-native';\ninitFixPrompt({\n  projectKey: process.env.EXPO_PUBLIC_FIXPROMPT_KEY!,\n  source: '<slug>-prod',\n  service: '<slug>',\n  env: 'prod',\n});"
+    },
+    next: {
+      pkg: "@fixprompt/browser (client) + @fixprompt/node (server, github:goscha01/geos-loghub-client until @fixprompt/node ships)",
+      entry: "src/app/providers.tsx for client (useEffect-init), instrumentation.ts or server-start for Node",
+      example: `// client (in a "use client" component, useEffect):
+import { initFixPrompt } from '@fixprompt/browser';
+initFixPrompt({ projectKey: process.env.NEXT_PUBLIC_FIXPROMPT_KEY!, source: '<slug>-prod', service: '<slug>', env: 'prod' });`
+    },
+    browser: {
+      pkg: "@fixprompt/browser",
+      entry: "src/main.{ts,tsx} / index.{js,tsx} \u2014 top of file, before render",
+      example: "import { initFixPrompt } from '@fixprompt/browser';\ninitFixPrompt({\n  projectKey: import.meta.env.VITE_FIXPROMPT_KEY, // or REACT_APP_FIXPROMPT_KEY for CRA\n  source: '<slug>-prod',\n  service: '<slug>',\n  env: import.meta.env.PROD ? 'prod' : 'dev',\n});"
+    },
+    node: {
+      pkg: "@geos/loghub-client (npm install @geos/loghub-client@github:goscha01/geos-loghub-client \u2014 @fixprompt/node not yet on npm)",
+      entry: "src/index.{ts,js} / src/main.{ts,js} \u2014 at server start, before route registration",
+      example: "const { loghubLog } = require('@geos/loghub-client');\n// per-request middleware:\napp.use((req, res, next) => {\n  res.on('finish', () => loghubLog({ service: '<slug>', app: '<slug>', env: 'prod', level: res.statusCode >= 500 ? 'error' : 'info', message: 'http_request', attrs: { method: req.method, path: req.originalUrl, status: res.statusCode } }));\n  next();\n});"
+    }
+  };
+  const sdk = runtime === "unknown" ? {
+    pkg: "@fixprompt/browser | @fixprompt/react-native | @geos/loghub-client (Node) \u2014 pick by stack",
+    entry: "(read package.json to determine runtime)",
+    example: "// see https://fixloop-dashboard.vercel.app/onboarding for runtime-specific snippets"
+  } : sdkRows[runtime];
+  const slugLine = projectSlug ? `\`${projectSlug}\`` : "(see .env.local)";
+  const sdkExampleWithSlug = sdk.example.replace(/<slug>/g, projectSlug ?? "<slug>");
+  return [
+    "",
+    FIXLOOP_SECTION_MARKER,
+    "## FixLoop \u2014 production error logs (auto-fetch on bug reports + dev loop)",
+    "",
+    `This project is wired to FixLoop. Two behaviors expected of the coding agent reading this file:`,
+    "",
+    "### 1. Install the SDK on first use (skip if already in `package.json`)",
+    "",
+    `Detected runtime: **${runtime}**. Recommended SDK: \`${sdk.pkg}\``,
+    "",
+    `- Entry point: ${sdk.entry}`,
+    `- Init snippet:`,
+    "",
+    "```ts",
+    sdkExampleWithSlug,
+    "```",
+    "",
+    "After install, the SDK ships every uncaught error to the broker \u2192 Grafana Loki under `service_name=" + (projectSlug ?? "<slug>") + "`. Subsequent debug runs read these errors back via the curl in step 2.",
+    "",
+    "### 2. Debug loop on bug reports",
+    "",
+    `Trigger phrases: "X is broken", "doesn't work", "crashes", "is failing", pasted error stacks, "users are reporting Y", TestFlight/App Store bug reports.`,
+    "",
+    "Loop until the log query returns no new matches:",
+    "",
+    "1. **Fetch recent errors** \u2014 env vars come from `.env.local` (gitignored \u2014 never commit):",
+    "   ```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), `q` (substring), `limit` (1..500).",
+    "",
+    '2. **Parse `entries[]`** \u2014 each has `ts`, `level`, `message`, optional `attrs` + `stack`. Find the entries matching the user\'s symptom. Cite specific lines in your response (e.g. *"the `Cannot read property foo of null` at -200ms vs `[Storage] read failed` at -240ms suggests AsyncStorage is racing the migration"*).',
+    "",
+    "3. **Apply a fix** grounded in what the logs show. **Do not ask the user to paste log lines \u2014 fetch them yourself.**",
+    "",
+    "4. **Verify locally** \u2014 run the build / dev server / tests so the fix compiles and the affected path no longer throws.",
+    "",
+    "5. **Re-fetch with `since=5m`** after deploy. If the same error still appears OR new errors appear, **loop back to step 2** with the latest entries as context. Stop when the query returns no new matches against the user's symptom.",
+    "",
+    "### Project",
+    "",
+    `- Slug: ${slugLine}`,
+    `- Dashboard: https://fixloop-dashboard.vercel.app/issues/${projectId}`,
+    `- Manage / revoke the read token: https://fixloop-dashboard.vercel.app/integrations/${projectId}`,
+    ""
+  ].join("\n");
+}
+function stripFixloopSection(body) {
+  const lines = body.split("\n");
+  let start = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].trim() === FIXLOOP_SECTION_MARKER) {
+      start = i;
+      break;
+    }
+    if (lines[i].startsWith("## FixLoop \u2014")) {
+      start = i;
+      break;
+    }
+  }
+  if (start === -1) return body;
+  const realStart = start > 0 && lines[start - 1] === "" ? start - 1 : start;
+  let end = lines.length;
+  for (let i = start + 1; i < lines.length; i++) {
+    if (lines[i].startsWith("## ") && !lines[i].startsWith("## FixLoop \u2014")) {
+      end = i;
+      break;
+    }
+  }
+  const trimmedTail = lines.slice(end);
+  while (trimmedTail.length > 0 && realStart > 0 && lines[realStart - 1] === "" && trimmedTail[0] === "") {
+    trimmedTail.shift();
+  }
+  return [...lines.slice(0, realStart), ...trimmedTail].join("\n");
+}
+function appendClaudeMdGuidance(cwd, projectId, projectSlug) {
+  const claudePath = join(cwd, "CLAUDE.md");
+  const runtime = detectRuntime(cwd);
+  const section = buildClaudeMdSection(projectId, projectSlug, runtime);
+  if (existsSync(claudePath)) {
+    const existing = readFileSync(claudePath, "utf8");
+    const stripped = stripFixloopSection(existing);
+    const next = stripped.endsWith("\n") ? stripped + section.replace(/^\n/, "") : stripped + section;
+    writeFileSync(claudePath, next);
+  } 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 +449,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 +461,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 +471,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 +481,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 +492,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 +507,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 +533,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 +547,7 @@ async function connect(args) {
 
 // src/version.ts
 var CLI_NAME = "@fixprompt/cli";
-var CLI_VERSION = "0.3.0";
+var CLI_VERSION = "0.5.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.5.0",
   "description": "FixPrompt CLI — annotate deployments and ship them to the broker so the dashboard knows what changed.",
   "license": "UNLICENSED",
   "repository": {