@pugi/cli 0.1.0-beta.2 → 0.1.0-beta.20

package/dist/tui/status-bar.js

@@ -1,5 +1,12 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
+import { formatCostUsd, formatTokens } from '../core/repl/model-pricing.js';
+/**
+ * Window during which the per-turn delta flash stays visible on the
+ * cost-meter row. CEO spec: ~2 seconds after completion. Past that, the
+ * flash dimms out and the row shows session totals only.
+ */
+const TURN_DELTA_FLASH_MS = 2_000;
 /**
  * Cyan dot glyphs across the pulse cycle. Three steps keep the motion
  * subtle - a true gradient would force an Ink rerender on every
@@ -17,8 +24,73 @@ export function StatusBar(props) {
     // first. When the connection is healthy (`on_watch` / `connecting`),
     // the FSM dispatch state takes over to show the dispatch lifecycle
     // (`dispatching` / `tool: read` / `aborting` / etc.).
-    const status = composeStatusLabel(props.connection, props.dispatchState, props.dispatchToolLabel);
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: status.color, children: `${glyph ?? '●'} ${status.label}` }), _jsx(Text, { dimColor: true, children: `  ·  ${props.activeAgentCount} agents  ·  ` }), _jsx(Text, { children: `↓ ${tokenLabel} tokens` }), _jsx(Text, { dimColor: true, children: `  ·  ${elapsedLabel}` })] }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: `${formatCount(props.pugiMdCount)} PUGI.md  ·  ${formatCount(props.mcpServerCount)} MCP  ·  ${formatCount(props.skillCount)} skills  ·  ${formatQuota(props.quotaPct)} quota` }) })] }));
+    const status = composeStatusLabel(props.connection, props.dispatchState, props.dispatchToolLabel, props.lastCompletedOutcome);
+    // α7 cost-meter sprint — the cost row anchors above the legacy
+    // dispatch-state line so the operator's eye lands on the meter first
+    // (matches Claude Code TUI footer rhythm). The session-elapsed slot
+    // uses sessionStartedAtEpochMs (REPL boot), distinct from the
+    // per-brief `elapsedLabel` on the row below.
+    const costRow = renderCostMeterRow(props.sessionTokensIn ?? 0, props.sessionTokensOut ?? 0, props.sessionCostUsd ?? 0, props.sessionStartedAtEpochMs, now);
+    const deltaFlash = renderTurnDeltaFlash(props.lastTurnDelta, now);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: `↑ ${costRow.tokensInLabel}` }), _jsx(Text, { dimColor: true, children: '  ' }), _jsx(Text, { color: "cyan", children: `↓ ${costRow.tokensOutLabel}` }), _jsx(Text, { dimColor: true, children: `  ·  ` }), _jsx(Text, { bold: true, children: costRow.costLabel }), _jsx(Text, { dimColor: true, children: `  ·  ${costRow.elapsedLabel}` }), deltaFlash ? (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: '  ' }), _jsx(Text, { color: "green", children: deltaFlash })] })) : null] }), _jsxs(Box, { children: [_jsx(Text, { color: status.color, children: `${glyph ?? '●'} ${status.label}` }), _jsx(Text, { dimColor: true, children: `  ·  ${props.activeAgentCount} agents  ·  ` }), _jsx(Text, { children: `↓ ${tokenLabel} tokens` }), _jsx(Text, { dimColor: true, children: `  ·  ${elapsedLabel}` })] }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: `${formatCount(props.pugiMdCount)} PUGI.md  ·  ${formatCount(props.mcpServerCount)} MCP  ·  ${formatCount(props.skillCount)} skills  ·  ${formatQuota(props.quotaPct)} quota` }) })] }));
+}
+/**
+ * α7 cost-meter sprint — assemble the cost-meter row labels. Pure helper
+ * so the snapshot tests assert the formatted shape without standing up
+ * an Ink renderer.
+ */
+export function renderCostMeterRow(tokensIn, tokensOut, costUsd, sessionStartedAtEpochMs, nowEpochMs) {
+    const elapsedMs = typeof sessionStartedAtEpochMs === 'number'
+        ? Math.max(0, nowEpochMs - sessionStartedAtEpochMs)
+        : 0;
+    return {
+        tokensInLabel: formatTokens(tokensIn),
+        tokensOutLabel: formatTokens(tokensOut),
+        costLabel: formatCostUsd(costUsd),
+        elapsedLabel: formatElapsedShort(elapsedMs),
+    };
+}
+/**
+ * α7 cost-meter sprint — render the per-turn delta flash when the most
+ * recent turn completed within the flash window. Returns null when no
+ * turn has completed yet OR the flash has expired (the elapsed slot
+ * gets the slot back). The flash format mirrors the spec:
+ *
+ *     `+200/+1.1k +$0.01`
+ *
+ * Exported for snapshot tests.
+ */
+export function renderTurnDeltaFlash(delta, nowEpochMs) {
+    if (!delta)
+        return null;
+    const elapsedSinceMs = nowEpochMs - delta.completedAtEpochMs;
+    if (elapsedSinceMs < 0 || elapsedSinceMs > TURN_DELTA_FLASH_MS)
+        return null;
+    const inLabel = formatTokens(delta.tokensIn);
+    const outLabel = formatTokens(delta.tokensOut);
+    const costLabel = delta.costUsd > 0 ? ` +${formatCostUsd(delta.costUsd)}` : '';
+    return `+${inLabel}/+${outLabel}${costLabel}`;
+}
+/**
+ * α7 cost-meter sprint — local copy of the session elapsed formatter.
+ * Mirrors the helper in `core/repl/session.ts` so the status bar stays
+ * a pure leaf component without a circular import on session.ts (the
+ * model-pricing module's `formatDuration` is similar but ships an
+ * `XhYm` ceiling that does not match the CEO spec's `2m44s` shape).
+ */
+function formatElapsedShort(elapsedMs) {
+    if (!Number.isFinite(elapsedMs) || elapsedMs <= 0)
+        return '0s';
+    const totalSec = Math.floor(elapsedMs / 1000);
+    if (totalSec < 60)
+        return `${totalSec}s`;
+    const min = Math.floor(totalSec / 60);
+    const sec = totalSec % 60;
+    if (min < 60)
+        return `${min}m${sec.toString().padStart(2, '0')}s`;
+    const hr = Math.floor(min / 60);
+    const restMin = min % 60;
+    return `${hr}h${restMin.toString().padStart(2, '0')}m`;
 }
 /**
  * Render a count badge — number if defined, `—` placeholder otherwise.
@@ -75,7 +147,7 @@ export function connectionLabel(connection) {
  * `tool: <kind>` upstream so we just concatenate; null falls through
  * to the bare `tool` placeholder.
  */
-function composeStatusLabel(connection, dispatchState, toolLabel) {
+function composeStatusLabel(connection, dispatchState, toolLabel, lastCompletedOutcome) {
     // Transport health wins.
     if (connection === 'offline' || connection === 'reconnecting') {
         return connectionLabel(connection);
@@ -93,6 +165,16 @@ function composeStatusLabel(connection, dispatchState, toolLabel) {
         case 'awaiting_response':
             return { label: 'dispatching', color: 'cyan' };
         case 'completed':
+            // Branch on the work-done outcome so the bottom-bar tells the
+            // same truth as the agent-tree (2026-05-26 — memory
+            // feedback_no_fake_dispatch_promises). `'replied'` = text-only
+            // turn, render with the same neutral gray + arrow used in the
+            // agent-tree. `'shipped'` = real side-effect (or older server
+            // that omits the outcome field). Defaults to `'shipped'` so
+            // older callers without the prop wired stay back-compat.
+            if (lastCompletedOutcome === 'replied') {
+                return { label: 'replied', color: 'gray' };
+            }
             return { label: 'shipped', color: 'green' };
         case 'idle':
         case undefined:
@@ -111,18 +193,14 @@ function formatElapsed(startedAt, now) {
     const seconds = Math.floor((ms % 60_000) / 1000);
     return `${minutes}m ${seconds.toString().padStart(2, '0')}s`;
 }
-/**
- * Format the downstream token counter as 1.2k / 12.4k / 1.0m. Anvil
- * F1 emits totals in the tens-of-thousands range during a single
- * brief, so anything more than three significant figures is noise.
- */
-function formatTokens(total) {
-    if (total < 1_000)
-        return total.toString();
-    if (total < 1_000_000)
-        return `${(total / 1_000).toFixed(1)}k`;
-    return `${(total / 1_000_000).toFixed(1)}m`;
-}
+// `formatTokens` for the downstream-throughput slot is imported from
+// `core/repl/model-pricing.ts` — single source of truth for token
+// formatting across the cost-meter row, `/cost` slash, and the legacy
+// downstream-tokens slot. The shape is identical to the prior local
+// helper (`<1000` raw, `<1m` one-decimal k, `≥1m` one-decimal m); the
+// only semantic difference is non-finite / negative inputs render as
+// `0` instead of throwing, matching the cost-meter row's defensive
+// posture.
 function clampPhase(phase) {
     if (typeof phase !== 'number' || Number.isNaN(phase))
         return 0;

package/dist/tui/status-table.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+export function StatusTable({ snapshot }) {
+    const labelWidth = Math.max('Label'.length, ...snapshot.fields.map((f) => f.label.length));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, children: "Pugi status" }) }), snapshot.fields.map((field) => (_jsxs(Box, { children: [_jsxs(Text, { children: [field.label.padEnd(labelWidth, ' '), "  "] }), field.available ? (_jsx(Text, { children: field.value })) : (_jsx(Text, { dimColor: true, children: field.value }))] }, field.key))), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: ["CLI ", snapshot.meta.cliVersion, "  Node ", snapshot.meta.nodeVersion, "  cwd ", snapshot.meta.cwd] }) })] }));
+}
+//# sourceMappingURL=status-table.js.map

package/dist/tui/tool-stream-pane.js

@@ -64,6 +64,13 @@ function toolDisplayName(tool) {
     switch (tool) {
         case 'read':
             return 'Read';
+        case 'write':
+            // 2026-05-27 — Write is the most operator-visible tool for the
+            // codegen-dispatch surface (Hiroshi writing index.html / style.css
+            // / script.js for a tic-tac-toe brief). Add the display name so
+            // the tool stream pane renders ✓ Write(index.html) instead of an
+            // unlabeled placeholder. Mirrors the Claude Code Write rendering.
+            return 'Write';
         case 'edit':
             return 'Edit';
         case 'bash':

package/dist/tui/update-banner.js

@@ -1,8 +1,26 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
-import { upgradeCommand } from '../runtime/update-check.js';
+import { compareVersions, upgradeCommand, } from '../runtime/update-check.js';
+import { getCachedServerRecommendation } from '../core/transport/version-interceptor.js';
+/**
+ * Resolve the `latest` value the banner should show. Exported so the
+ * spec can lock the merge logic without rendering Ink.
+ */
+export function resolveDisplayedLatest(npmLatest, serverRecommended) {
+    if (!serverRecommended)
+        return npmLatest;
+    return compareVersions(serverRecommended, npmLatest) > 0
+        ? serverRecommended
+        : npmLatest;
+}
 export function UpdateBanner({ result }) {
     const command = upgradeCommand(result.method);
-    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: '─ ' }), _jsx(Text, { bold: true, color: "cyan", children: 'Pugi ' }), _jsx(Text, { children: result.installed }), _jsx(Text, { dimColor: true, children: ' (installed) → ' }), _jsx(Text, { bold: true, children: result.latest }), _jsx(Text, { dimColor: true, children: ' (latest)' })] }), _jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: '  Update: ' }), _jsx(Text, { color: "cyan", children: command })] }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: '  Skip with PUGI_SKIP_UPDATE_BANNER=1' }) })] }));
+    // Read the cache lazily inside the render so a server response that
+    // landed AFTER the banner was constructed still shows up on the next
+    // re-render. The cache lookup is a single map read — cheap enough to
+    // do per render.
+    const serverRecommended = getCachedServerRecommendation();
+    const displayedLatest = resolveDisplayedLatest(result.latest, serverRecommended);
+    return (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: '─ ' }), _jsx(Text, { bold: true, color: "#3da9fc", children: 'Pugi ' }), _jsx(Text, { children: result.installed }), _jsx(Text, { dimColor: true, children: ' (installed) → ' }), _jsx(Text, { bold: true, children: displayedLatest }), _jsx(Text, { dimColor: true, children: ' (latest)' })] }), _jsxs(Box, { children: [_jsx(Text, { dimColor: true, children: '  Update: ' }), _jsx(Text, { color: "#3da9fc", children: command })] }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: '  Skip with PUGI_SKIP_UPDATE_BANNER=1' }) })] }));
 }
 //# sourceMappingURL=update-banner.js.map

package/docs/examples/codegraph.mcp.json

@@ -0,0 +1,10 @@
+{
+  "servers": {
+    "codegraph": {
+      "command": "codegraph",
+      "args": ["serve", "--mcp"],
+      "env": {},
+      "trust": "pending"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pugi/cli",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.20",
   "description": "Pugi CLI - terminal-native software execution system",
   "homepage": "https://pugi.io",
   "repository": {
@@ -29,8 +29,10 @@
     "bin/run.js",
     "dist/**/*.js",
     "assets/**/*.ansi",
+    "docs/examples/**/*.json",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "engines": {
     "node": ">=22.5.0"
@@ -46,13 +48,13 @@
     "ink": "^5.0.1",
     "linkedom": "^0.18.12",
     "react": "^18.3.1",
-    "tar": "^6.2.1",
+    "tar": "^7.5.11",
     "tinyglobby": "^0.2.16",
     "turndown": "^7.2.4",
     "undici": "^8.3.0",
     "zod": "^3.23.0",
     "@pugi/personas": "0.1.2",
-    "@pugi/sdk": "0.1.0-beta.2"
+    "@pugi/sdk": "0.1.0-beta.20"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
@@ -67,9 +69,10 @@
     "build": "pnpm --filter @pugi/personas --filter @pugi/sdk build && tsc -p tsconfig.json && node scripts/make-bin-executable.mjs",
     "dev": "tsx src/index.ts",
     "typecheck": "pnpm --filter @pugi/personas --filter @pugi/sdk build && tsc -p tsconfig.json --noEmit",
-    "test": "pnpm run build && node --test --import tsx 'test/**/*.spec.ts' 'test/**/*.spec.tsx'",
+    "test": "pnpm run check:version-lockstep && pnpm run build && node --test --import tsx 'test/**/*.spec.ts' 'test/**/*.spec.tsx'",
     "version:cli": "tsx src/index.ts version",
     "doctor": "tsx src/index.ts doctor --json",
-    "pack:smoke": "node scripts/pack-smoke.mjs"
+    "check:version-lockstep": "bash ../../scripts/check-version-lockstep.sh",
+    "pack:smoke": "pnpm run check:version-lockstep && node scripts/pack-smoke.mjs"
   }
 }