@fonderie/cli 0.4.0 → 0.6.0

package/bin/fonderie.mjs

@@ -328,6 +328,9 @@ const ADMIN_PAGES = {
   routes:    { path: '/routes',              about: 'every exposed route with its guard' },
   tokens:    { path: '/access/tokens',       about: 'the admin token verdict + legacy per-brick tokens' },
   log:       { path: '/activity/admin-log',  about: 'who did what through the surface (--limit, --before)' },
+  user:      { path: '/users',               about: 'look up a user: admin user <email|id> [sessions|history|revoke-sessions|suspend|unsuspend]' },
+  catalog:   { path: '/catalog',             about: 'plans as configured and as stored' },
+  subscriber:{ path: '/subscriptions',       about: 'admin subscriber <user|workspace> <id> [subscription|wallet|ledger]' },
 };
 async function adminCmd() {
   const pageName = argv[1];
@@ -338,6 +341,32 @@ async function adminCmd() {
     process.exit(2);
   }
   const prefix = (process.env.FONDERIE_ADMIN_PREFIX || '/_admin').replace(/\/$/, '');
+  if (pageName === 'user') {
+    // fonderie admin user <email|id> [sessions|history|revoke-sessions|suspend|unsuspend]
+    const who = argv[2]; const verb = argv[3] ?? 'show';
+    if (!who) { console.error('fonderie admin user <email|id> [sessions|history|revoke-sessions|suspend|unsuspend]'); process.exit(2); }
+    const byEmail = who.includes('@');
+    const base = byEmail ? `${prefix}/users?email=${encodeURIComponent(who)}` : `${prefix}/users/${encodeURIComponent(who)}`;
+    if (verb === 'show') return adminFetch('GET', base);
+    if (byEmail) { console.error('sessions/history/revoke-sessions/suspend/unsuspend need the user id (run `admin user <email>` first).'); process.exit(2); }
+    const sub = { sessions: ['GET', '/sessions'], history: ['GET', '/login-history'], 'revoke-sessions': ['DELETE', '/sessions'], suspend: ['POST', '/suspend'], unsuspend: ['POST', '/unsuspend'] }[verb];
+    if (!sub) { console.error(`unknown verb "${verb}"`); process.exit(2); }
+    const q = new URLSearchParams(); const limit = arg('--limit', undefined); if (limit && verb === 'history') q.set('limit', limit);
+    const qs = q.toString();
+    return adminFetch(sub[0], base + sub[1] + (qs ? `?${qs}` : ''));
+  }
+  if (pageName === 'subscriber') {
+    const type = argv[2]; const id = argv[3]; const verb = argv[4] ?? 'subscription';
+    if ((type !== 'user' && type !== 'workspace') || !id) { console.error('fonderie admin subscriber <user|workspace> <id> [subscription|wallet|ledger] [--currency <c>] [--limit <n>]'); process.exit(2); }
+    const sub = `/${type}/${encodeURIComponent(id)}`;
+    const q = new URLSearchParams(); const cur = arg('--currency', undefined); const lim = arg('--limit', undefined);
+    if (cur) q.set('currency', cur); if (lim && verb === 'ledger') q.set('limit', lim);
+    const qs = q.toString(); const tail = qs ? `?${qs}` : '';
+    if (verb === 'subscription') return adminFetch('GET', `${prefix}/subscriptions${sub}`);
+    if (verb === 'wallet') return adminFetch('GET', `${prefix}/wallet${sub}${tail}`);
+    if (verb === 'ledger') return adminFetch('GET', `${prefix}/wallet${sub}/ledger${tail}`);
+    console.error(`unknown verb "${verb}"`); process.exit(2);
+  }
   const q = new URLSearchParams();
   const limit = arg('--limit', undefined);
   const before = arg('--before', undefined);
@@ -443,6 +472,8 @@ else {
   fonderie template <get|set|delete|history|rollback> [type] [text] [--locale <l>] [--subject <s>] [--html <h>] ...
       manage a live deployment over its admin API — set FONDERIE_ADMIN_URL + FONDERIE_ADMIN_TOKEN
   fonderie admin <attention|manifest|doctor|config|routes|tokens|log> [--limit <n>] [--before <cursor>]
+  fonderie admin user <email|id> [sessions|history|revoke-sessions|suspend|unsuspend]
+  fonderie admin catalog · admin subscriber <user|workspace> <id> [subscription|wallet|ledger] [--currency <c>]
       read a deployment's operator surface (@fonderie/admin) — same env; FONDERIE_ADMIN_PREFIX if moved
 
 Zero deps. No MCP server. A binary + markdown that runs in any agent harness.`);

package/bin/fonderie.test.mjs

@@ -141,6 +141,24 @@ await (async () => {
   if (!find('GET', '/_admin')) fail('admin attention: should hit the prefix root');
   if (!find('GET', '/_admin/activity/admin-log?limit=5&before=abc')) fail('admin log: flags not forwarded');
   if (!find('GET', '/ops/doctor')) fail('admin doctor: FONDERIE_ADMIN_PREFIX not honoured');
+  await cli(['admin', 'user', 'ada@example.com']);
+  await cli(['admin', 'user', 'u1', 'history', '--limit', '3']);
+  await cli(['admin', 'user', 'u1', 'suspend']);
+  if (!find('GET', '/_admin/users?email=ada%40example.com')) fail('admin user <email>: wrong lookup path');
+  if (!find('GET', '/_admin/users/u1/login-history?limit=3')) fail('admin user history: flags not forwarded');
+  if (!find('POST', '/_admin/users/u1/suspend')) fail('admin user suspend: wrong request');
+  await cli(['admin', 'catalog']);
+  await cli(['admin', 'subscriber', 'workspace', 'w1']);
+  await cli(['admin', 'subscriber', 'user', 'u1', 'ledger', '--currency', 'eur', '--limit', '7']);
+  if (!find('GET', '/_admin/catalog')) fail('admin catalog: wrong path');
+  if (!find('GET', '/_admin/subscriptions/workspace/w1')) fail('admin subscriber: wrong path');
+  if (!find('GET', '/_admin/wallet/user/u1/ledger?currency=eur&limit=7')) fail('admin subscriber ledger: flags not forwarded');
+  let badType = 0;
+  try { await cli(['admin', 'subscriber', 'team', 'x']); } catch (e) { badType = e.code; }
+  if (badType !== 2) fail(`admin subscriber <bad type> should exit 2, got ${badType}`);
+  let needsId = 0;
+  try { await cli(['admin', 'user', 'ada@example.com', 'suspend']); } catch (e) { needsId = e.code; }
+  if (needsId !== 2) fail(`admin user <email> suspend should exit 2, got ${needsId}`);
   let unknown = 0;
   try { await cli(['admin', 'nope']); } catch (e) { unknown = e.code; }
   if (unknown !== 2) fail(`admin <unknown page> should exit 2, got ${unknown}`);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fonderie/cli",
-	"version": "0.4.0",
+	"version": "0.6.0",
 	"description": "The Fonderie CLI — teaches any coding agent the SDK without loading it eagerly. `fonderie skill` writes a lazy skill (a small router + per-package bodies read on demand); `fonderie query` answers what to install for a capability. Zero deps, runs anywhere.",
 	"keywords": [
 		"fonderiejs",