replen 0.1.3 → 0.2.0

package/LICENSE

@@ -1,21 +1,73 @@
-MIT License
-
-Copyright (c) 2026 replen.dev
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2026 replen.dev
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under these Terms and Conditions, as indicated by our inclusion of these Terms and Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents, Redistribution and Trademark clauses below, we hereby grant you the right to use, copy, modify, create derivative works, publicly perform, publicly display and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use means making the Software available to others in a commercial product or service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our patents, the license grant above includes a license under our patents. If you make a claim against any party that the Software infringes or contributes to the infringement of any patent, then your patent license to the Software ends immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software, you must include a copy of or a link to these Terms and Conditions and not remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of the Software, you have no right under these Terms and Conditions to use our trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under the MIT license that is effective on the second anniversary of the date we make the Software available. On or after that date, you may use the Software under the MIT license, in which case the following will apply:
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/api.js

@@ -0,0 +1,43 @@
+// Thin fetch wrapper for CLI subcommands. The CLI hits the same /api/mcp/*
+// routes the MCP server uses (same DIGEST_TOKEN authentication), so plain-
+// shell users get parity with the in-Claude-Code experience.
+import { readConfig } from "./config.js";
+export async function loadConfigOrExit() {
+    const cfg = await readConfig();
+    if (!cfg) {
+        console.error("Not signed in. Run `npx replen` first.");
+        process.exit(1);
+    }
+    return cfg;
+}
+export async function apiGet(cfg, path, query) {
+    const url = new URL(cfg.base + path);
+    if (query) {
+        for (const [k, v] of Object.entries(query)) {
+            if (v !== undefined && v !== null && v !== "")
+                url.searchParams.set(k, String(v));
+        }
+    }
+    const res = await fetch(url, {
+        headers: { "x-digest-token": cfg.token, accept: "application/json" },
+    });
+    if (!res.ok) {
+        throw new Error(`GET ${path} → ${res.status}: ${(await res.text()).slice(0, 200)}`);
+    }
+    return res.json();
+}
+export async function apiPost(cfg, path, body) {
+    const res = await fetch(cfg.base + path, {
+        method: "POST",
+        headers: {
+            "x-digest-token": cfg.token,
+            "content-type": "application/json",
+            accept: "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        throw new Error(`POST ${path} → ${res.status}: ${(await res.text()).slice(0, 200)}`);
+    }
+    return res.json();
+}

package/dist/commands.js

@@ -0,0 +1,225 @@
+// Plain-shell subcommands. Each one mirrors an MCP tool but renders for the
+// terminal rather than returning JSON to an agent. `--json` flag on every
+// command dumps raw JSON for piping/scripting.
+import { apiGet, apiPost, loadConfigOrExit } from "./api.js";
+function hasFlag(argv, flag) {
+    return argv.includes(flag);
+}
+function getFlag(argv, flag) {
+    const i = argv.indexOf(flag);
+    if (i < 0 || i === argv.length - 1)
+        return undefined;
+    return argv[i + 1];
+}
+// Trigger a fresh pipeline run. Returns immediately; user can `replen progress`
+// to watch. Rate-limited at 60s on the server side.
+export async function runRun(argv) {
+    const cfg = await loadConfigOrExit();
+    const json = hasFlag(argv, "--json");
+    try {
+        const r = await apiPost(cfg, "/api/mcp/run-now", {});
+        if (json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        if (r.ok) {
+            console.log("✓ Pipeline started. Tail progress with `replen progress`.");
+        }
+        else if (r.status === "in_flight") {
+            console.log(`A run is already in flight (run #${r.runId}). Tail it with \`replen progress\`.`);
+        }
+        else if (r.status === "rate_limited") {
+            console.log(`Rate-limited: ${r.reason}. Try again in a minute.`);
+        }
+        else {
+            console.log(`✗ ${r.reason ?? "unknown error"}`);
+        }
+    }
+    catch (e) {
+        handleApiError(e);
+    }
+}
+// Tail live pipeline progress. Polls /api/mcp/status with ?since=<id> until
+// the run finishes, printing each event as it arrives. Exits 0 on completion.
+export async function runProgress(argv) {
+    const cfg = await loadConfigOrExit();
+    const json = hasFlag(argv, "--json");
+    let since = 0;
+    let firstTick = true;
+    // 2.5s matches the in-app live log poll cadence.
+    while (true) {
+        let status;
+        try {
+            status = await apiGet(cfg, "/api/mcp/status", since ? { since } : undefined);
+        }
+        catch (e) {
+            handleApiError(e);
+            return;
+        }
+        if (json) {
+            console.log(JSON.stringify(status));
+        }
+        else {
+            if (firstTick) {
+                const phase = status.phase ?? "unknown";
+                const tag = status.inFlight ? `running · phase=${phase}` : "idle";
+                const counts = `${status.candidates ?? 0} candidates · ${status.matches ?? 0} matches`;
+                console.log(`Run #${status.runId ?? "?"} · ${tag} · ${counts}`);
+                firstTick = false;
+            }
+            for (const ev of status.events ?? []) {
+                console.log(`${marker(ev.kind)} ${ev.message}`);
+                if (ev.id > since)
+                    since = ev.id;
+            }
+        }
+        if (!status.inFlight) {
+            if (!json) {
+                console.log(`— done · ${status.matches ?? 0} matches · run #${status.runId ?? "?"}`);
+            }
+            return;
+        }
+        await sleep(2500);
+    }
+}
+// What landed in the last N days. Defaults: 2 days, high+medium relevance.
+export async function runFeed(argv) {
+    const cfg = await loadConfigOrExit();
+    const json = hasFlag(argv, "--json");
+    const days = Number(getFlag(argv, "--days") ?? 2);
+    const project = getFlag(argv, "--project");
+    const relevance = getFlag(argv, "--relevance") ?? "high,medium";
+    try {
+        const r = await apiGet(cfg, "/api/mcp/today", {
+            days,
+            relevance,
+            project,
+        });
+        if (json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        if (r.count === 0) {
+            console.log(`No matches in the last ${r.days} day(s).`);
+            return;
+        }
+        console.log(`${r.count} matches · last ${r.days} day(s):`);
+        for (const m of r.matches)
+            renderMatchLine(m);
+    }
+    catch (e) {
+        handleApiError(e);
+    }
+}
+// Full-text search across the user's match history.
+export async function runSearch(argv) {
+    const cfg = await loadConfigOrExit();
+    const json = hasFlag(argv, "--json");
+    const q = argv.filter((a) => !a.startsWith("--")).slice(1).join(" ").trim();
+    if (q.length < 2) {
+        console.error("Usage: replen search <query>");
+        process.exit(1);
+    }
+    try {
+        const r = await apiGet(cfg, "/api/mcp/search", { q });
+        if (json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        if (!r.matches?.length) {
+            console.log(`No results for "${q}".`);
+            return;
+        }
+        console.log(`${r.count ?? r.matches.length} results for "${q}":`);
+        for (const m of r.matches)
+            renderMatchLine(m);
+    }
+    catch (e) {
+        handleApiError(e);
+    }
+}
+// Starred matches + their handoff PR status (awaiting / open-pr / merged).
+export async function runStarred(argv) {
+    const cfg = await loadConfigOrExit();
+    const json = hasFlag(argv, "--json");
+    try {
+        const r = await apiGet(cfg, "/api/mcp/starred");
+        if (json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        if (!r.matches?.length) {
+            console.log("No starred matches.");
+            return;
+        }
+        console.log(`${r.matches.length} starred:`);
+        for (const m of r.matches)
+            renderMatchLine(m, { showHandoff: true });
+    }
+    catch (e) {
+        handleApiError(e);
+    }
+}
+// Open a handoff PR for a starred match in the matched project's own repo.
+export async function runHandoff(argv) {
+    const cfg = await loadConfigOrExit();
+    const json = hasFlag(argv, "--json");
+    const idStr = argv.filter((a) => !a.startsWith("--"))[1];
+    const matchId = idStr ? parseInt(idStr, 10) : NaN;
+    if (!Number.isInteger(matchId) || matchId <= 0) {
+        console.error("Usage: replen handoff <matchId>");
+        process.exit(1);
+    }
+    try {
+        const r = await apiPost(cfg, "/api/mcp/handoff", { matchId });
+        if (json) {
+            console.log(JSON.stringify(r, null, 2));
+            return;
+        }
+        if (r.ok && r.prUrl) {
+            console.log(`✓ Opened handoff PR: ${r.prUrl}`);
+        }
+        else {
+            console.log(`✗ ${r.reason ?? "unknown error"}`);
+            process.exitCode = 1;
+        }
+    }
+    catch (e) {
+        handleApiError(e);
+    }
+}
+function renderMatchLine(m, opts = {}) {
+    const score = m.relevanceScore != null ? `· ${m.relevanceScore}` : "";
+    const stars = m.stars != null ? `· ${m.stars}★` : "";
+    const lic = m.license ? `· ${m.license}` : "";
+    const star = m.starred ? "★" : " ";
+    const handoff = opts.showHandoff && m.handoffPrUrl ? `\n      PR: ${m.handoffPrUrl}` : "";
+    const repo = m.repo ?? "(no repo)";
+    console.log(`  ${star} #${m.matchId} ${repo} → ${m.project} · ${m.relevance}${score}${stars}${lic}${handoff}`);
+}
+function marker(kind) {
+    switch (kind) {
+        case "match":
+            return "✓";
+        case "skip":
+        case "triage_skip":
+            return "·";
+        case "error":
+            return "✗";
+        case "fetch_start":
+        case "fetch_done":
+            return "↓";
+        case "reason":
+            return "?";
+        case "scan":
+        default:
+            return "›";
+    }
+}
+function handleApiError(e) {
+    console.error(`✗ ${e.message ?? String(e)}`);
+    process.exit(1);
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}

package/dist/index.js

@@ -3,17 +3,30 @@ import { runInit } from "./init.js";
 import { setupMcp } from "./mcp-setup.js";
 import { readConfig, configPath } from "./config.js";
 import { runProjectInit } from "./project-init.js";
+import { runFeed, runHandoff, runProgress, runRun, runSearch, runStarred } from "./commands.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 status          Show CLI auth + 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
 
+Use replen from a plain shell (no Claude Code / Codex needed):
+  npx replen run                       Trigger a fresh pipeline run
+  npx replen progress                  Live tail of the current run; exits when done
+  npx replen feed [--days N]           Today's matches (default 2 days)
+                  [--project SLUG]     Limit to one project
+                  [--relevance high,medium]
+  npx replen search <query>            Full-text search across past matches
+  npx replen starred                   Starred matches + handoff PR status
+  npx replen handoff <matchId>         Open the handoff PR for a starred match
+
+Every data command accepts --json to dump raw JSON for scripting / jq.
+
 Env:
   REPLEN_BASE             Override dashboard URL (default https://app.replen.dev)
 
@@ -69,6 +82,18 @@ async function main() {
         console.log(`Note: this only clears local auth. The token is still valid until you rotate it on /settings.`);
         return;
     }
+    if (cmd === "run")
+        return runRun(argv);
+    if (cmd === "progress")
+        return runProgress(argv);
+    if (cmd === "feed")
+        return runFeed(argv);
+    if (cmd === "search")
+        return runSearch(argv);
+    if (cmd === "starred")
+        return runStarred(argv);
+    if (cmd === "handoff")
+        return runHandoff(argv);
     if (cmd === undefined) {
         // Default: if already signed in, just rerun mcp setup. Otherwise, full flow.
         const cfg = await readConfig();

package/dist/init.js

@@ -137,7 +137,7 @@ export async function runInit() {
     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("    use replen to replen_today → pulls today's matches");
     console.log("");
     console.log(`  Dashboard: ${exchange.base}`);
     console.log("");

package/dist/mcp-setup.js

@@ -43,7 +43,8 @@ export async function setupMcp(token, base) {
         config = readJson(CONFIG_PATH);
     }
     catch (e) {
-        console.error(`  ✗ ${CONFIG_PATH} is not valid JSON: ${e.message}`);
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(`  ✗ ${CONFIG_PATH} is not valid JSON: ${msg}`);
         console.error(`    Fix the file manually and run \`replen mcp setup\`.`);
         process.exit(1);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replen",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "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": {
@@ -30,7 +30,7 @@
   },
   "bugs": "https://github.com/replenhq/replen/issues",
   "author": "replen.dev",
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE",
   "engines": {
     "node": ">=18"
   },