@pugi/cli 0.1.0-beta.18 → 0.1.0-beta.19

package/dist/runtime/commands/status.js

@@ -0,0 +1,178 @@
+/**
+ * `pugi status` — concise session-state probe (Leak L34, 2026-05-27).
+ *
+ * Different from `pugi doctor` (environment health). The status
+ * command answers "what is this Pugi session doing right now?" —
+ * session id + age, cwd, permission mode, CLI version, token
+ * usage, dispatch counts, last command, compact boundaries, auth
+ * identity.
+ *
+ * # Module contract
+ *
+ *   - This file owns the WIRING from CLI flags + ambient process
+ *     state к the snapshot collector. The data collector itself
+ *     lives in `core/diagnostics/probes/status-snapshot.ts` and
+ *     has zero coupling к the CLI dispatch surface.
+ *
+ *   - `runStatusCommand` is the single entry point. Both the
+ *     top-level `pugi status` handler in `runtime/cli.ts` AND the
+ *     in-REPL `/status` slash command call it. The function
+ *     returns the `StatusSnapshot` so the REPL slash handler can
+ *     mount the Ink renderer without re-collecting fields.
+ *
+ *   - The credential resolver is captured behind a function so the
+ *     spec can stub it without monkey-patching `core/credentials.ts`.
+ *
+ *   - The permission state module is dynamic-imported with a
+ *     try/catch so this command lands cleanly before the L6
+ *     permission-mode work — when the module is absent the field
+ *     degrades к "unknown" instead of crashing the snapshot.
+ *
+ *   - Exit code is 0 unless the snapshot itself throws. The
+ *     command is intentionally informational — even a fully
+ *     "unavailable" snapshot (everything degraded к sentinels)
+ *     exits 0 so monitoring scripts can rely on a stable contract.
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { resolveActiveCredential } from '../../core/credentials.js';
+import { PUGI_CLI_VERSION } from '../version.js';
+import { collectStatusSnapshot, } from '../../core/diagnostics/probes/status-snapshot.js';
+/**
+ * Default production filesystem stubs. Wraps node:fs so the
+ * snapshot collector can stay sync + structurally testable.
+ */
+const DEFAULT_FS = {
+    existsSync,
+    statSync,
+    readdirSync: (p) => readdirSync(p),
+    readFileSync: (p, encoding) => readFileSync(p, encoding),
+};
+/**
+ * Default credential resolver. Wraps `resolveActiveCredential` so
+ * the snapshot only sees the trimmed `ResolvedCredentialSummary`
+ * shape and не the full store record.
+ */
+function defaultResolveCredential(env, home) {
+    const cred = resolveActiveCredential(env, home);
+    if (!cred)
+        return null;
+    // Tier is не yet recorded в the credentials file — set к null
+    // until a future sprint surfaces `tier` on the stored record.
+    // The renderer hides the parenthetical when tier is null.
+    return {
+        apiUrl: cred.apiUrl,
+        label: cred.label ?? null,
+        tier: null,
+        identity: cred.label ?? null,
+    };
+}
+/**
+ * Default permission-mode loader. Dynamic-imports
+ * `core/permissions/state.ts` (L6 in the leak-parity roadmap);
+ * returns null when the module is absent OR malformed, which the
+ * snapshot field degrades к the "unknown" sentinel.
+ */
+async function defaultResolvePermissionMode() {
+    try {
+        const mod = (await import('../../core/permissions/state.js').catch(() => null));
+        if (!mod || typeof mod.getCurrentPermissionMode !== 'function') {
+            return null;
+        }
+        const mode = mod.getCurrentPermissionMode();
+        return typeof mode === 'string' && mode.length > 0 ? mode : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Collect the snapshot + emit the output via the supplied
+ * writeOutput sink. Returns the snapshot so REPL callers can
+ * route it к the Ink renderer instead of the plain-text fallback.
+ */
+export async function runStatusCommand(ctx) {
+    // Resolve the permission mode upfront — the snapshot is sync but
+    // the L6 loader is async (dynamic import). We materialise the
+    // value here and hand the snapshot a sync getter.
+    const permissionMode = ctx.resolvePermissionMode === undefined
+        ? await defaultResolvePermissionMode()
+        : null;
+    const deps = {
+        cwd: ctx.cwd,
+        home: ctx.home,
+        cliVersion: PUGI_CLI_VERSION,
+        now: ctx.now ?? Date.now,
+        liveSessionId: ctx.liveSessionId ?? null,
+        sessionStartedAtEpochMs: ctx.sessionStartedAtEpochMs ?? null,
+        liveTokensUsed: ctx.liveTokensUsed ?? null,
+        lastCommand: ctx.lastCommand ?? null,
+        lastCommandAtEpochMs: ctx.lastCommandAtEpochMs ?? null,
+        fs: ctx.fs ?? DEFAULT_FS,
+        resolveCredential: ctx.resolveCredential ?? (() => defaultResolveCredential(ctx.env, ctx.home)),
+        resolvePermissionMode: ctx.resolvePermissionMode ?? (() => permissionMode),
+    };
+    let snapshot;
+    try {
+        snapshot = collectStatusSnapshot(deps);
+    }
+    catch (error) {
+        // Defensive: the snapshot collector is fail-soft per field, but
+        // a structural crash (e.g. a hostile env that throws on
+        // `process.version` access) must не bring down `pugi status`.
+        // We synthesise a minimal envelope and surface the error в the
+        // text output so the operator can file a bug.
+        const message = error instanceof Error ? error.message : String(error);
+        snapshot = {
+            command: 'status',
+            fields: [
+                {
+                    key: 'session',
+                    label: 'Session',
+                    value: 'unknown',
+                    available: false,
+                    note: `snapshot collector crashed: ${message}`,
+                },
+            ],
+            meta: {
+                cliVersion: PUGI_CLI_VERSION,
+                nodeVersion: process.version,
+                cwd: ctx.cwd,
+                capturedAt: new Date((ctx.now ?? Date.now)()).toISOString(),
+            },
+        };
+    }
+    const text = renderStatusTable(snapshot);
+    ctx.writeOutput(snapshot, text);
+    // Always exit 0 — `pugi status` is informational, never a gate.
+    process.exitCode = 0;
+    return snapshot;
+}
+/**
+ * Plain-text table renderer. Lays out the snapshot as a two-column
+ * (LABEL / VALUE) table with the brand-voice header `Pugi status`.
+ * Matches the column-light pattern used by `renderDoctorTable` so
+ * narrow terminals stay legible without a layout library.
+ */
+export function renderStatusTable(snapshot) {
+    const labelWidth = Math.max('Label'.length, ...snapshot.fields.map((f) => f.label.length));
+    const lines = [];
+    lines.push('Pugi status');
+    lines.push('═'.repeat(50));
+    for (const field of snapshot.fields) {
+        const labelPart = field.label.padEnd(labelWidth, ' ');
+        lines.push(`${labelPart}  ${field.value}`);
+    }
+    lines.push('');
+    lines.push(`CLI ${snapshot.meta.cliVersion}  Node ${snapshot.meta.nodeVersion}  cwd ${snapshot.meta.cwd}`);
+    return lines.join('\n');
+}
+/**
+ * Default home dir resolver. Centralised so the CLI handler can
+ * call `runStatusCommand` without re-importing `os.homedir`
+ * everywhere.
+ */
+export function defaultStatusHome() {
+    return homedir();
+}
+//# sourceMappingURL=status.js.map

package/dist/runtime/version.js

@@ -44,7 +44,7 @@ export function sanitizeSemver(raw) {
  * during import). When bumping the CLI version BOTH literals must be
  * updated; the release smoke-test (`pack:smoke`) verifies they agree.
  */
-export const PUGI_CLI_VERSION = sanitizeSemver('0.1.0-beta.18');
+export const PUGI_CLI_VERSION = sanitizeSemver('0.1.0-beta.19');
 /**
  * Outbound: the CLI's installed semver. Read at request time by
  * `version-interceptor.ts` and injected on every `fetch` call.

package/dist/tui/compact-banner.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Visible boundary marker for the conversation pane.
+ *
+ * Rendered inline in the transcript when the replay walker hits a
+ * `compaction` event. Conveys three facts at a glance:
+ *
+ *   1. A compaction happened (separator line).
+ *   2. How many turns were folded into the summary.
+ *   3. Whether it was manual or auto-triggered.
+ *
+ * The separator line uses U+2500 (BOX DRAWINGS LIGHT HORIZONTAL) so
+ * the visual weight matches the rest of the Ink chrome. Dim ink-color
+ * `gray` keeps the marker subdued — it is a navigation aid, not the
+ * conversation itself.
+ *
+ * Width-aware: when stdout columns are known we render the dashes to
+ * fill the line minus the centred label; on unknown width we fall
+ * back to a fixed 64-dash pad. The fallback is wide enough for any
+ * realistic terminal and narrow enough to not wrap on small ones.
+ */
+import { Box, Text } from 'ink';
+const FALLBACK_COLUMNS = 80;
+/**
+ * Render the boundary line. The wrapping `<Box>` keeps the marker on
+ * its own row even when the surrounding flex container packs siblings.
+ */
+export function CompactBanner(props) {
+    const columns = props.columns && props.columns > 20 ? props.columns : FALLBACK_COLUMNS;
+    const label = buildLabel(props);
+    const dashesEach = Math.max(3, Math.floor((columns - label.length - 2) / 2));
+    const dashes = '─'.repeat(dashesEach);
+    return (_jsx(Box, { children: _jsx(Text, { color: "gray", children: `${dashes} ${label} ${dashes}` }) }));
+}
+/**
+ * Build the centred label. Examples:
+ *   "context compacted (12 turns → 1 summary, auto)"
+ *   "context compacted (4 turns → 1 summary, manual · ~3.2k tokens)"
+ */
+export function buildLabel(props) {
+    const trigger = props.trigger === 'auto' ? 'auto' : 'manual';
+    const turns = `${props.turnsBefore} ${props.turnsBefore === 1 ? 'turn' : 'turns'}`;
+    const tokens = props.summaryTokenCount && props.summaryTokenCount > 0
+        ? ` · ~${formatTokens(props.summaryTokenCount)} tokens`
+        : '';
+    return `context compacted (${turns} → 1 summary, ${trigger}${tokens})`;
+}
+/** Format token counts like 1234 → 1.2k, 950 → 950. */
+function formatTokens(n) {
+    if (n < 1000)
+        return `${n}`;
+    return `${(n / 1000).toFixed(1)}k`;
+}
+//# sourceMappingURL=compact-banner.js.map

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pugi/cli",
-  "version": "0.1.0-beta.18",
+  "version": "0.1.0-beta.19",
   "description": "Pugi CLI - terminal-native software execution system",
   "homepage": "https://pugi.io",
   "repository": {
@@ -54,7 +54,7 @@
     "undici": "^8.3.0",
     "zod": "^3.23.0",
     "@pugi/personas": "0.1.2",
-    "@pugi/sdk": "0.1.0-beta.18"
+    "@pugi/sdk": "0.1.0-beta.19"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",