@pugi/cli 0.1.0-alpha.6 → 0.1.0-alpha.8

package/dist/core/repl/slash-commands.js

@@ -1,31 +1,99 @@
 /**
- * REPL slash command registry - Sprint α5.7 (ADR-0056 PR-PUGI-CLI-REPL-DEFAULT).
+ * REPL slash command registry — Sprint α5.7, expanded α6.14 wave 2.
  *
- * The REPL input box surfaces a small palette of slash commands that the
- * operator can run from inside a persistent session: dispatch a brief,
- * inspect the agent roster, stop a running persona, open the help
- * overlay, or quit. The registry is intentionally narrow at M1 -
- * complementary surfaces (`/sync`, `/handoff`, `/budget`) ship as proper
- * subcommands in α5.8+ and stay reachable from a non-REPL `pugi
- * <command>` invocation.
+ * The REPL input box surfaces a palette of slash commands the operator
+ * can run from inside a persistent session. The wave-2 expansion (CEO
+ * 2026-05-25) grows the surface from 6 to 20 commands so the `/help`
+ * overlay matches the breadth Claude Code / Codex CLI operators expect.
  *
- * The registry is pure: each entry returns a `SlashCommandResult`
- * describing what the REPL session should do next. The session module
- * owns the side effects (network calls, dispatcher invocation, exit).
- * Keeping the surface pure lets the unit test exercise every shape
- * without standing up an Ink runtime or an Anvil endpoint.
+ * The registry is pure: each `parseSlashCommand` call returns a
+ * `SlashCommandResult` describing what the REPL session should do next.
+ * The session module owns the side effects (network calls, dispatcher
+ * invocation, exit, transcript clear). Keeping the surface pure lets
+ * the unit test exercise every shape without standing up an Ink runtime
+ * or an Anvil endpoint.
+ *
+ * Tiering (per CEO wave-2 spec):
+ *
+ *   Tier 1 — wired against real state (3 + existing 6 = 9 wired):
+ *     brief, agents, stop, help, quit, web, clear, version, jobs.
+ *
+ *   Tier 2 — best-effort wiring against existing surfaces (3):
+ *     diff, cost, status.
+ *
+ *   Tier 3 — deterministic stubs ("coming in αX.Y") (8):
+ *     compact, resume, memory, config, privacy, budget, mcp, undo.
  *
  * Brand voice (brandbook §08): power words `brief / dispatch / stop /
- * agents / quit`. Tagline `Brief it. It ships.` reserved for `/quit`
- * confirmation and `/help` footer - never inline.
+ * agents / quit / shipped`. Tagline `Brief it. It ships.` reserved for
+ * `/quit` confirmation and `/help` footer — never inline.
  */
 import { listRoles } from '../agents/registry.js';
+/**
+ * Deterministic stub copy returned by the Tier 3 commands. Spec'd
+ * inline so the unit test can pin the exact text without poking at
+ * the help overlay. The version tag at the end maps to the sprint we
+ * intend to land the real wiring in.
+ */
+export const SLASH_STUB_MESSAGES = Object.freeze({
+    brief: '',
+    agents: '',
+    stop: '',
+    help: '',
+    quit: '',
+    web: '',
+    clear: '',
+    version: '',
+    jobs: '',
+    diff: '',
+    cost: '',
+    status: '',
+    compact: 'Manual context compaction lands in α6.5.',
+    resume: 'Resume last session lands in α6.4 once SQLite session.db lands.',
+    memory: 'Session memory editor lands in α6.5.',
+    config: 'Run `pugi config list` from a fresh shell for the full surface; in-REPL editor lands in α6.5.',
+    privacy: 'Run `pugi privacy show` from a fresh shell; in-REPL toggle lands in α6.5.',
+    budget: 'Run `pugi budget` from a fresh shell; in-REPL summary lands in α6.5.',
+    mcp: 'Run `pugi config mcp list` from a fresh shell; in-REPL palette lands in α6.5.',
+    undo: 'Run `pugi undo` from a fresh shell; in-REPL undo lands in α6.5.',
+});
 export const SLASH_COMMAND_HELP = Object.freeze([
-    { name: 'brief', args: '<text>', gloss: 'Dispatch a brief to the workforce' },
-    { name: 'agents', args: '', gloss: 'List the on-watch agent roster' },
-    { name: 'stop', args: '<persona>', gloss: 'Stop one agent by persona slug' },
-    { name: 'help', args: '', gloss: 'Show this help overlay' },
-    { name: 'quit', args: '', gloss: 'Exit the REPL (session resumes via pugi resume)' },
+    // Workforce dispatch
+    { name: 'brief', args: '<text>', gloss: 'Dispatch a brief to the workforce', group: 'Workforce dispatch' },
+    { name: 'agents', args: '', gloss: 'List the on-watch agent roster', group: 'Workforce dispatch' },
+    { name: 'stop', args: '<persona>', gloss: 'Stop one agent by persona slug', group: 'Workforce dispatch' },
+    { name: 'jobs', args: '', gloss: 'List background jobs', group: 'Workforce dispatch' },
+    // Session
+    { name: 'clear', args: '', gloss: 'Clear conversation pane', group: 'Session' },
+    { name: 'resume', args: '', gloss: 'Resume last session  (α6.4)', group: 'Session', stub: true },
+    { name: 'compact', args: '', gloss: 'Manual context compaction  (α6.5)', group: 'Session', stub: true },
+    { name: 'memory', args: '', gloss: 'Session memory editor  (α6.5)', group: 'Session', stub: true },
+    // Pugi tools
+    { name: 'web', args: '<url>', gloss: 'Fetch a URL into context', group: 'Pugi tools' },
+    { name: 'diff', args: '', gloss: 'Show pending diff', group: 'Pugi tools' },
+    { name: 'cost', args: '', gloss: 'Token usage + budget', group: 'Pugi tools' },
+    { name: 'status', args: '', gloss: 'Backend + tenant status', group: 'Pugi tools' },
+    // Settings
+    { name: 'config', args: '', gloss: 'Show config', group: 'Settings', stub: true },
+    { name: 'privacy', args: '', gloss: 'Show privacy mode', group: 'Settings', stub: true },
+    { name: 'budget', args: '', gloss: 'Show usage budget', group: 'Settings', stub: true },
+    { name: 'mcp', args: '', gloss: 'List MCP servers', group: 'Settings', stub: true },
+    { name: 'undo', args: '', gloss: 'Undo last write', group: 'Settings', stub: true },
+    // Meta
+    { name: 'help', args: '', gloss: 'Show this help overlay', group: 'Meta' },
+    { name: 'version', args: '', gloss: 'Show CLI version', group: 'Meta' },
+    { name: 'quit', args: '', gloss: 'Exit the REPL', group: 'Meta' },
+]);
+/**
+ * Ordered list of groups. Drives the `/help` overlay sectioning so the
+ * operator reads commands by intent (dispatch first, meta last).
+ */
+export const SLASH_COMMAND_GROUPS = Object.freeze([
+    'Workforce dispatch',
+    'Session',
+    'Pugi tools',
+    'Settings',
+    'Meta',
 ]);
 /**
  * Parse one line of input from the REPL. The contract:
@@ -33,13 +101,15 @@ export const SLASH_COMMAND_HELP = Object.freeze([
  *   - Empty / whitespace-only input returns `noop` with the original
  *     text so the REPL can ignore it without printing anything.
  *   - Input that does not start with `/` is treated as an implicit
- *     `/brief <text>` - the most-common operator action.
+ *     `/brief <text>` — the most-common operator action.
  *   - `/<name> [args]` resolves the name against the registry; unknown
  *     names return `error` so the REPL can render a one-line tip
  *     instead of silently dropping the input.
+ *   - Tier 3 stubs return `{ kind: 'stub', name, message }` so the REPL
+ *     can render the deterministic "coming in αX.Y" copy uniformly.
  *
  * The function never throws. Bad input maps to a structured result the
- * REPL can render - the alternative (throwing from a keystroke handler)
+ * REPL can render — the alternative (throwing from a keystroke handler)
  * would unmount Ink mid-frame.
  */
 export function parseSlashCommand(input) {
@@ -90,6 +160,47 @@ export function parseSlashCommand(input) {
         case 'q': {
             return { kind: 'quit' };
         }
+        case 'web':
+        case 'fetch': {
+            if (tail.length === 0) {
+                return { kind: 'error', message: 'Usage: /web <url>' };
+            }
+            return { kind: 'web', url: tail };
+        }
+        case 'clear':
+        case 'cls': {
+            return { kind: 'clear' };
+        }
+        case 'version':
+        case 'v': {
+            return { kind: 'version' };
+        }
+        case 'jobs': {
+            return { kind: 'jobs' };
+        }
+        case 'diff': {
+            return { kind: 'diff' };
+        }
+        case 'cost': {
+            return { kind: 'cost' };
+        }
+        case 'status': {
+            return { kind: 'status' };
+        }
+        case 'compact':
+        case 'resume':
+        case 'memory':
+        case 'config':
+        case 'privacy':
+        case 'budget':
+        case 'mcp':
+        case 'undo': {
+            return {
+                kind: 'stub',
+                name: name,
+                message: SLASH_STUB_MESSAGES[name],
+            };
+        }
         default: {
             return {
                 kind: 'error',

package/dist/core/settings.js

@@ -34,6 +34,19 @@ const pugiSettingsSchema = z.object({
         promoteExplicitly: z.boolean().default(true),
     })
         .default({}),
+    // `web.fetch.enabled` gates the `pugi web` / `/web` SSRF-guarded
+    // fetcher. Default-off matches the spec posture; the schema must
+    // declare it explicitly because Zod's strict-pass strips unknown
+    // keys and would silently swallow the operator's intent.
+    web: z
+        .object({
+        fetch: z
+            .object({
+            enabled: z.boolean().optional(),
+        })
+            .optional(),
+    })
+        .optional(),
 });
 export function loadSettings(root) {
     const settingsPath = resolve(root, '.pugi/settings.json');