@fixprompt/cli 0.4.0 → 0.5.0

package/dist/cli.js

@@ -288,36 +288,139 @@ function appendEnvLocal(cwd, token, projectId, projectSlug, endpoint) {
     writeFileSync(envPath, block.replace(/^\n/, ""));
   }
 }
-function appendClaudeMdGuidance(cwd, projectId, projectSlug) {
-  const claudePath = join(cwd, "CLAUDE.md");
-  const section = [
+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 \u2014 production error logs (auto-fetch on bug reports)",
+    FIXLOOP_SECTION_MARKER,
+    "## FixLoop \u2014 production error logs (auto-fetch on bug reports + dev loop)",
     "",
-    'This project ships errors to FixLoop. When the user reports a bug, crash, error, "X is broken", or pastes an error stack:',
+    `This project is wired to FixLoop. Two behaviors expected of the coding agent reading this file:`,
     "",
-    "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.**",
+    "### 1. Install the SDK on first use (skip if already in `package.json`)",
     "",
-    "### Fetch logs",
+    `Detected runtime: **${runtime}**. Recommended SDK: \`${sdk.pkg}\``,
     "",
-    "```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"',
+    `- Entry point: ${sdk.entry}`,
+    `- Init snippet:`,
+    "",
+    "```ts",
+    sdkExampleWithSlug,
     "```",
     "",
-    "Query params: `since` (15m..7d), `level` (csv: debug,info,warn,error,fatal), `q` (substring), `limit` (1..500).",
+    "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"*).',
     "",
-    projectSlug ? `**Project**: \`${projectSlug}\`.` : "",
-    `Manage / revoke: https://fixloop-dashboard.vercel.app/integrations/${projectId}`,
+    "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}`,
     ""
-  ].filter(Boolean).join("\n");
+  ].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");
-    if (existing.includes("## FixLoop \u2014")) return;
-    appendFileSync(claudePath, section);
+    const stripped = stripFixloopSection(existing);
+    const next = stripped.endsWith("\n") ? stripped + section.replace(/^\n/, "") : stripped + section;
+    writeFileSync(claudePath, next);
   } else {
     writeFileSync(claudePath, "# Project\n" + section);
   }
@@ -444,7 +547,7 @@ async function connect(args) {
 
 // src/version.ts
 var CLI_NAME = "@fixprompt/cli";
-var CLI_VERSION = "0.4.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.4.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": {