scriptonia 0.6.0 → 0.7.0

package/bin/scriptonia.mjs

@@ -32,7 +32,7 @@ const commands = {
   add, ingest: add, push: add,
   plan, plans, comment,
   query, contexts, link,
-  status, logout, skill: reinstallSkill, mcp,
+  status, credits, logout, skill: reinstallSkill, mcp,
   flow, guide: flow,
   help: async () => usage(),
 };
@@ -132,13 +132,19 @@ async function flow() {
   const row = (n, name, desc, cmd) =>
     console.log(`  ${C.v}${n}${C.r}  ${C.b}${name.padEnd(7)}${C.r} ${C.dim}${desc.padEnd(34)}${C.r} ${cmd ? C.g + cmd + C.r : ""}`);
 
-  console.log(`  ${C.dim}THE LOOP${C.r}   ${C.dim}${s.total} signals · ${plansN} plans${C.r}`);
+  const cr = o?.credits;
+  const creditStr = cr && cr.metered !== false ? ` · ${cr.plan} ${cr.used}/${cr.cap} credits` : "";
+  console.log(`  ${C.dim}THE LOOP${C.r}   ${C.dim}${s.total} signals · ${plansN} plans${creditStr}${C.r}`);
   row("1", "SIGNAL", "feed customer reality (text·md·vtt)", `scriptonia add <files>`);
   row("2", "PLAN", "issue → PLAN.md, sourced & checked", `scriptonia plan "<issue>"`);
   row("3", "BUILD", "your agent executes PLAN.md → PR", `claude "execute PLAN.md"`);
   row("4", "REFINE", "a note regenerates the plan", `scriptonia comment plan/<slug> "…"`);
 
-  console.log(`\n  ${C.b}NEXT${C.r}  ${nextStep(s, plansN, recentPlan, repo, C)}\n`);
+  console.log(`\n  ${C.b}NEXT${C.r}  ${nextStep(s, plansN, recentPlan, repo, C)}`);
+  if (cr && cr.metered !== false && cr.available <= 0) {
+    console.log(`  ${C.w}Out of credits${C.r} ${C.dim}— ${cr.topup}${C.r}`);
+  }
+  console.log("");
 }
 
 function nextStep(s, plansN, recentPlan, repo, C) {
@@ -339,6 +345,7 @@ async function comment(args) {
       body: JSON.stringify({ slug, body: text, author: flags.as ?? cfg.email }),
     });
     const data = await res.json().catch(() => ({}));
+    if (res.status === 402) failCredits(data);
     if (res.status === 404) fail(`no plan "${slug}" — generate one first: scriptonia plan "<issue>"`);
     if (!res.ok) fail(`comment failed (${res.status}): ${JSON.stringify(data).slice(0, 200)}`);
     // Approval-chain receipt: which human note produced which plan version.
@@ -362,6 +369,7 @@ async function comment(args) {
     body: JSON.stringify({ slug: target, body: text, author: flags.as ?? cfg.email }),
   });
   const data = await res.json().catch(() => ({}));
+  if (res.status === 402) failCredits(data);
   if (res.status === 404) fail(`no context "${target}" — see \`scriptonia contexts\``);
   if (!res.ok) fail(`comment failed (${res.status}): ${JSON.stringify(data)}`);
 
@@ -384,6 +392,7 @@ async function query(args) {
     body: JSON.stringify({ query: q, window: flags.window, segment: flags.segment }),
   });
   const data = await res.json();
+  if (res.status === 402) failCredits(data);
   if (!res.ok) fail(`query failed (${res.status}): ${JSON.stringify(data)}`);
 
   const wantJson = flags.json !== undefined || !process.stdout.isTTY;
@@ -412,12 +421,65 @@ async function link(args) {
 async function status() {
   const cfg = loadConfig();
   if (!cfg) { console.log("not logged in — run `scriptonia login`"); return; }
+  const active = activeCreds();
+  const C = colors();
   console.log(`signed in as ${cfg.email}`);
-  console.log(`project      ${cfg.project}`);
+  console.log(`project      ${active.project}`);
+  const c = await fetchCredits(active);
+  if (c && c.metered !== false) {
+    const bar = creditBar(c.used, c.cap, C);
+    console.log(`plan         ${C.b}${c.plan}${C.r}`);
+    console.log(`credits      ${bar} ${c.used}/${c.cap} used · resets ${c.resets_at}`);
+    if (c.available <= 0) console.log(`             ${C.w}out of credits${C.r} — ${c.topup}`);
+    else if (c.available <= Math.max(2, Math.round(c.cap * 0.2))) console.log(`             ${C.dim}running low — ${c.topup}${C.r}`);
+  }
   console.log(`endpoint     ${cfg.url}`);
   console.log(`config       ${CONFIG_PATH}`);
 }
 
+// ── credits ───────────────────────────────────────────────────
+async function credits() {
+  const cfg = activeCreds();
+  const C = colors();
+  const c = await fetchCredits(cfg);
+  if (!c) fail("could not load credits");
+  if (c.metered === false) { console.log(`\n  ${C.dim}This project isn't metered.${C.r}\n`); return; }
+  console.log(`\n  ${C.b}${c.plan.toUpperCase()}${C.r} · ${cfg.project}`);
+  console.log(`  ${creditBar(c.used, c.cap, C)}  ${C.b}${c.available}${C.r} of ${c.cap} credits left ${C.dim}(resets ${c.resets_at})${C.r}`);
+  console.log(`\n  ${C.dim}Plans & comments cost 5 · queries 1 · adding signal is free.${C.r}`);
+  if (c.available <= 0) console.log(`  ${C.w}Out of credits.${C.r} ${c.topup}`);
+  else console.log(`  ${C.dim}Need more? ${c.topup}${C.r}`);
+  console.log("");
+}
+
+async function fetchCredits(cfg) {
+  try {
+    const res = await fetch(`${cfg.url}/api/credits`, { headers: { authorization: `Bearer ${cfg.token}` } });
+    if (!res.ok) return null;
+    return await res.json();
+  } catch { return null; }
+}
+
+function creditBar(used, cap, C) {
+  const width = 16;
+  const frac = cap > 0 ? Math.min(1, used / cap) : 0;
+  const filled = Math.round(frac * width);
+  const color = frac >= 1 ? C.w : frac >= 0.8 ? C.w : C.g;
+  return `${color}${"█".repeat(filled)}${C.dim}${"░".repeat(width - filled)}${C.r}`;
+}
+
+/** Render an HTTP 402 credits_exhausted body and exit. Shared by plan/query/comment. */
+function failCredits(data) {
+  const C = colors();
+  const resets = data.resets_at ? ` (resets ${data.resets_at})` : "";
+  console.error(`\n  ${C.w}✕ Out of credits${C.r} — ${data.plan}: ${data.used}/${data.cap} used this month${resets}.\n`);
+  console.error(`    Your signal is safe and still being collected. Plans & queries resume`);
+  console.error(`    when credits do.\n`);
+  console.error(`    ${C.b}Top up:${C.r} ${data.topup}`);
+  console.error(`    ${C.dim}(adding signal, sync, contexts, plans list — all still free)${C.r}\n`);
+  process.exit(1);
+}
+
 async function logout() {
   if (fs.existsSync(CONFIG_PATH)) fs.rmSync(CONFIG_PATH);
   console.log("logged out.");
@@ -621,8 +683,10 @@ function usage() {
     scriptonia query "<topic>"    quick lookup, no full plan  (--json)
     scriptonia link "<id>"        a signal's full text
     scriptonia sync               write the brain to local files
+    scriptonia credits            plan, balance, reset date
 
   ACCOUNT   scriptonia status | logout | skill | mcp
+  Plans & comments cost 5 credits · queries 1 · adding signal is free.
 `);
 }
 
@@ -798,6 +862,7 @@ async function plan(args) {
     body: JSON.stringify({ issue, repo_summary: repoSummary }),
   });
   const data = await res.json();
+  if (res.status === 402) failCredits(data);
   if (!res.ok) fail(`plan failed (${res.status}): ${JSON.stringify(data).slice(0, 200)}`);
   writePlan(cfg, data, flags);
 }
@@ -817,7 +882,13 @@ function writePlan(cfg, data, flags) {
   console.log(`\n  ${C.g}✓${C.r} Plan ${C.b}${data.slug}${C.r} ${C.dim}v${data.version}${C.r} → ${C.v}${out}${C.r}`);
   console.log(`  ${C.dim}${(data.sources ?? []).length} cited signal(s)${data.contradictions ? `, ${data.contradictions} unresolved contradiction(s)` : ""}${C.r}`);
   console.log(`\n  ${C.b}Hand it to your agent:${C.r}  ${C.g}claude "execute PLAN.md"${C.r}   ${C.dim}(or codex · opencode · hermes)${C.r}`);
-  console.log(`  ${C.dim}refine:${C.r} ${C.g}scriptonia comment plan/${data.slug} "…"${C.r} ${C.dim}(rewrites PLAN.md)${C.r}\n`);
+  console.log(`  ${C.dim}refine:${C.r} ${C.g}scriptonia comment plan/${data.slug} "…"${C.r} ${C.dim}(rewrites PLAN.md)${C.r}`);
+  if (data.credits) {
+    const cr = data.credits;
+    const low = cr.cap > 0 && cr.cap - cr.used <= Math.max(2, Math.round(cr.cap * 0.2));
+    console.log(`  ${low ? C.w : C.dim}${cr.used}/${cr.cap} credits used this month${low ? " — top up: sathwik07@scriptonia.dev" : ""}${C.r}`);
+  }
+  console.log("");
 }
 
 // ── repo scan ─────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scriptonia",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Turn customer signal into executable plans your coding agent runs. Issue in, PLAN.md out.",
   "type": "module",
   "bin": {