replen 0.1.0 → 0.1.2

package/README.md

@@ -1,12 +1,14 @@
 # replen
 
-One-command setup for [replen](https://replen.dev) — daily personalised OSS discovery.
+**Smart AI Development workflows.** One-command setup for [replen](https://replen.dev) - the AI that asks *"can we do this better?"* on your codebase, every morning.
 
 ```bash
 npx replen
 ```
 
-That single command:
+While your AI coding tool waits for prompts, replen reads your code against the ecosystem and surfaces drop-in libraries, ideas to port, and patterns to learn from. A proactive layer for your AI coding workflow.
+
+The single command above:
 1. Opens your browser to sign in / sign up at `app.replen.dev`
 2. Captures the auth back into the terminal (browser-callback flow, like `gh auth login`)
 3. Wires the [@replen/mcp](https://www.npmjs.com/package/@replen/mcp) server into your Claude Code / Codex config
@@ -48,4 +50,4 @@ Rotate the ingest token on the [/settings](https://app.replen.dev/settings) page
 
 ## License
 
-MIT — see [LICENSE](./LICENSE).
+MIT - see [LICENSE](./LICENSE).

package/dist/index.js

@@ -2,14 +2,17 @@
 import { runInit } from "./init.js";
 import { setupMcp } from "./mcp-setup.js";
 import { readConfig, configPath } from "./config.js";
-const HELP = `replen — daily personalised OSS discovery
+import { runProjectInit } from "./project-init.js";
+const HELP = `replen: Smart AI Development workflows
 
 Usage:
-  npx replen              Sign up / sign in + wire MCP into Claude Code
-  npx replen status       Show current config
-  npx replen mcp setup    Re-wire MCP using saved auth
-  npx replen logout       Forget saved auth
-  npx replen --help       This help
+  npx replen                 Sign up / sign in + wire MCP into Claude Code
+  npx replen status          Show current config
+  npx replen mcp setup       Re-wire MCP using saved auth
+  npx replen project-init    Print a prompt your AI coding tool uses to draft
+                             a CLAUDE.md tuned for replen
+  npx replen logout          Forget saved auth
+  npx replen --help          This help
 
 Env:
   REPLEN_BASE             Override dashboard URL (default https://app.replen.dev)
@@ -36,6 +39,10 @@ async function main() {
         console.log(`  Config:    ${configPath()}`);
         return;
     }
+    if (cmd === "project-init") {
+        runProjectInit();
+        return;
+    }
     if (cmd === "mcp" && argv[1] === "setup") {
         const cfg = await readConfig();
         if (!cfg) {
@@ -54,7 +61,7 @@ async function main() {
         }
         catch (e) {
             if (e?.code === "ENOENT") {
-                console.log(`No saved auth — nothing to forget.`);
+                console.log(`No saved auth; nothing to forget.`);
             }
             else {
                 throw e;

package/dist/init.js

@@ -4,7 +4,7 @@ import { spawn } from "node:child_process";
 import { platform } from "node:os";
 import { writeConfig, configPath } from "./config.js";
 import { setupMcp } from "./mcp-setup.js";
-// Default web app URL — override with REPLEN_BASE for self-host.
+// Default web app URL. Override with REPLEN_BASE for self-host.
 const DEFAULT_BASE = process.env.REPLEN_BASE || "https://app.replen.dev";
 // Range for the local callback listener. Anything in 1024-65535 works.
 const PORT_MIN = 38000;
@@ -16,10 +16,10 @@ function openBrowser(url) {
     const cmd = platform() === "darwin" ? "open"
         : platform() === "win32" ? "start"
             : "xdg-open";
-    // Detach — we don't care about its exit.
+    // Detach. We don't care about its exit.
     const proc = spawn(cmd, [url], { stdio: "ignore", detached: true });
     proc.on("error", () => {
-        // Fail silently — we print the URL anyway as fallback.
+        // Fail silently. We print the URL anyway as fallback.
     });
     proc.unref();
 }
@@ -32,12 +32,11 @@ function waitForCallback(port, expectedState) {
                 res.end("not found");
                 return;
             }
-            const token = url.searchParams.get("token");
+            const code = url.searchParams.get("code");
             const state = url.searchParams.get("state");
-            const base = url.searchParams.get("base") ?? DEFAULT_BASE;
-            if (!token || !state) {
+            if (!code || !state) {
                 res.writeHead(400, { "content-type": "text/plain" });
-                res.end("missing token/state");
+                res.end("missing code/state");
                 return;
             }
             if (state !== expectedState) {
@@ -49,7 +48,7 @@ function waitForCallback(port, expectedState) {
             res.end(SUCCESS_HTML);
             // Give the response a tick to flush before we shut down the listener.
             setTimeout(() => server.close(), 100);
-            resolve({ token, base });
+            resolve({ code });
         });
         server.on("error", reject);
         server.listen(port, "127.0.0.1");
@@ -61,8 +60,20 @@ function waitForCallback(port, expectedState) {
         server.on("close", () => clearTimeout(timeout));
     });
 }
+async function exchangeCode(base, code, state) {
+    const res = await fetch(`${base}/api/cli-auth/exchange`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ code, state }),
+    });
+    const body = (await res.json().catch(() => ({})));
+    if (!res.ok || !body.ok || !body.token) {
+        throw new Error(`Exchange failed: ${body.error ?? `HTTP ${res.status}`}`);
+    }
+    return { token: body.token, base: body.base || base };
+}
 const SUCCESS_HTML = `<!doctype html>
-<html><head><meta charset="utf-8"><title>replen — authorized</title>
+<html><head><meta charset="utf-8"><title>replen: authorized</title>
 <style>
   body { font: 15px system-ui, -apple-system, sans-serif; max-width: 480px;
          margin: 80px auto; padding: 0 24px; color: #111; line-height: 1.55; }
@@ -73,7 +84,7 @@ const SUCCESS_HTML = `<!doctype html>
 <body>
   <h1><span class="ok">✓</span> Authorized</h1>
   <p>The replen CLI is now connected to your account.</p>
-  <p>You can close this tab and head back to your terminal — the CLI is finishing setup.</p>
+  <p>You can close this tab and head back to your terminal. The CLI is finishing setup.</p>
 </body></html>`;
 export async function runInit() {
     const state = randomBytes(32).toString("hex");
@@ -89,26 +100,34 @@ export async function runInit() {
     console.log("  (Waiting for browser callback on http://127.0.0.1:" + port + "…)");
     console.log("");
     openBrowser(authUrl);
-    let result;
+    let cb;
+    try {
+        cb = await waitForCallback(port, state);
+    }
+    catch (e) {
+        console.error("  ✗ " + (e?.message ?? String(e)));
+        process.exit(1);
+    }
+    let exchange;
     try {
-        result = await waitForCallback(port, state);
+        exchange = await exchangeCode(base, cb.code, state);
     }
     catch (e) {
         console.error("  ✗ " + (e?.message ?? String(e)));
         process.exit(1);
     }
     await writeConfig({
-        token: result.token,
-        base: result.base,
+        token: exchange.token,
+        base: exchange.base,
         savedAt: new Date().toISOString(),
     });
     console.log(`  ✓ Saved auth to ${configPath()}`);
-    await setupMcp(result.token, result.base);
+    await setupMcp(exchange.token, exchange.base);
     console.log("");
     console.log("  All set. Restart Claude Code (or Codex) and try:");
-    console.log("    /replen-triage      — runs the morning triage protocol");
-    console.log("    use replen to digest_today — pulls today's matches");
+    console.log("    /replen-triage      → runs the morning triage protocol");
+    console.log("    use replen to digest_today → pulls today's matches");
     console.log("");
-    console.log(`  Dashboard: ${result.base}`);
+    console.log(`  Dashboard: ${exchange.base}`);
     console.log("");
 }

package/dist/mcp-setup.js

@@ -2,7 +2,7 @@ import { readFileSync, writeFileSync, existsSync, mkdirSync, renameSync } from "
 import { homedir } from "node:os";
 import { join, dirname } from "node:path";
 // Write the @replen/mcp server entry into Claude Code's config. Uses npx so
-// the user doesn't need a separate global install — Claude Code will fetch
+// the user doesn't need a separate global install; Claude Code will fetch
 // @replen/mcp on first MCP launch and cache it.
 const SERVER_NAME = "replen";
 const CONFIG_PATH = join(homedir(), ".claude.json");
@@ -23,7 +23,10 @@ function writeJsonAtomic(path, data) {
 export async function setupMcp(token, base) {
     console.log(`  Wiring replen MCP into Claude Code config…`);
     if (existsSync(CONFIG_PATH)) {
-        const backup = `${CONFIG_PATH}.bak`;
+        // Timestamp the backup so re-running setup never overwrites a previous
+        // backup. Each run preserves the prior state.
+        const ts = new Date().toISOString().replace(/[:.]/g, "-");
+        const backup = `${CONFIG_PATH}.bak.${ts}`;
         writeFileSync(backup, readFileSync(CONFIG_PATH));
         console.log(`  (backed up existing config to ${backup})`);
     }

package/dist/project-init.js

@@ -0,0 +1,38 @@
+// `replen project-init` — prints a copy-pasteable prompt the user feeds to
+// their AI coding tool (Claude Code, Codex, Cursor, Aider, whatever) so it
+// can draft a CLAUDE.md tuned for replen's relevance scorer.
+//
+// The prompt deliberately points at the live template URL so changes to the
+// template don't require shipping a new CLI version. We do not write any
+// files ourselves — the AI tool does, locally, with full source access.
+const PROMPT = `Read this repository and produce a CLAUDE.md at the root, optimised for replen (https://replen.dev) — the daily research tool that scores new OSS repos against this project.
+
+Follow the template + section guidance at https://docs.replen.dev/project-docs.html. The seven sections are:
+
+  ## What this project is
+  ## Stack
+  ## Niche / problem domain
+  ## Active areas
+  ## Constraints & non-goals
+  ## Anti-patterns
+  ## Integration preferences
+
+Be specific. Use the project's actual domain vocabulary, not generic abstractions. Derive content from the source, the existing README, and the last 30 git commits — not boilerplate. If you can't verify a section from the code or git history, leave it short rather than making things up.
+
+When you're done, print the draft in chat and ask me to confirm before writing the file. If a CLAUDE.md already exists, don't overwrite it without my explicit say-so.
+
+Total length target: 200-500 words, bullet points over paragraphs.`;
+export function runProjectInit() {
+    console.log("");
+    console.log("Copy the prompt below into your AI coding tool (Claude Code / Codex / Cursor / Aider).");
+    console.log("It will read this repo and draft a CLAUDE.md tuned for replen.");
+    console.log("");
+    console.log("─".repeat(64));
+    console.log(PROMPT);
+    console.log("─".repeat(64));
+    console.log("");
+    console.log("If you have the replen-project-init skill installed in Claude Code,");
+    console.log("you can also invoke it with: /replen-project-init");
+    console.log("(install: copy skills/replen-project-init/ into ~/.claude/skills/)");
+    console.log("");
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "replen",
-  "version": "0.1.0",
-  "description": "One-command setup for replen — daily personalised OSS discovery. Opens a browser to sign you up, captures the auth back into the terminal, and wires the MCP server into your Claude Code / Codex config.",
+  "version": "0.1.2",
+  "description": "Smart AI Development workflows. The AI that asks 'can we do this better?' - replen reads your codebase against the live ecosystem every morning, surfaces drop-in libraries, ideas to port, and patterns to learn from. A proactive layer for your AI coding workflow. One-command setup: opens a browser to sign in, then wires the MCP server into Claude Code / Codex.",
   "type": "module",
   "bin": {
     "replen": "dist/index.js"
@@ -16,7 +16,13 @@
     "README.md",
     "LICENSE"
   ],
-  "keywords": ["replen", "oss-discovery", "claude-code", "mcp", "cli"],
+  "keywords": [
+    "replen",
+    "oss-discovery",
+    "claude-code",
+    "mcp",
+    "cli"
+  ],
   "homepage": "https://replen.dev",
   "repository": {
     "type": "git",