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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (130) hide show
  1. package/THIRD_PARTY_NOTICES.md +40 -0
  2. package/assets/pugi-mascot.ansi +15 -40
  3. package/bin/run.js +33 -1
  4. package/dist/commands/jobs-watch.js +201 -0
  5. package/dist/commands/jobs.js +15 -0
  6. package/dist/core/agent-progress/cleanup.js +134 -0
  7. package/dist/core/agent-progress/schema.js +144 -0
  8. package/dist/core/agent-progress/writer.js +101 -0
  9. package/dist/core/compact/auto-trigger.js +96 -0
  10. package/dist/core/compact/buffer-rewriter.js +115 -0
  11. package/dist/core/compact/summarizer.js +196 -0
  12. package/dist/core/compact/token-counter.js +108 -0
  13. package/dist/core/consensus/diff-capture.js +73 -0
  14. package/dist/core/context/index.js +7 -0
  15. package/dist/core/context/markdown-traverse.js +255 -0
  16. package/dist/core/cost/rate-card.js +129 -0
  17. package/dist/core/cost/tracker.js +221 -0
  18. package/dist/core/denial-tracking/index.js +8 -0
  19. package/dist/core/denial-tracking/state.js +264 -0
  20. package/dist/core/diagnostics/probe-runner.js +93 -0
  21. package/dist/core/diagnostics/probes/api.js +46 -0
  22. package/dist/core/diagnostics/probes/auth.js +86 -0
  23. package/dist/core/diagnostics/probes/cli-version.js +127 -0
  24. package/dist/core/diagnostics/probes/config.js +72 -0
  25. package/dist/core/diagnostics/probes/denial-tracking.js +57 -0
  26. package/dist/core/diagnostics/probes/disk.js +81 -0
  27. package/dist/core/diagnostics/probes/git.js +65 -0
  28. package/dist/core/diagnostics/probes/mcp.js +75 -0
  29. package/dist/core/diagnostics/probes/node.js +59 -0
  30. package/dist/core/diagnostics/probes/pnpm.js +36 -0
  31. package/dist/core/diagnostics/probes/session.js +74 -0
  32. package/dist/core/diagnostics/probes/status-snapshot.js +442 -0
  33. package/dist/core/diagnostics/probes/workspace.js +63 -0
  34. package/dist/core/diagnostics/types.js +70 -0
  35. package/dist/core/edits/dispatch.js +218 -2
  36. package/dist/core/edits/journal.js +199 -0
  37. package/dist/core/edits/layer-d-ast.js +557 -14
  38. package/dist/core/edits/verify-hook.js +273 -0
  39. package/dist/core/edits/worktree.js +111 -18
  40. package/dist/core/engine/anvil-client.js +115 -5
  41. package/dist/core/engine/budgets.js +89 -0
  42. package/dist/core/engine/context-prefix.js +155 -0
  43. package/dist/core/engine/intent.js +260 -0
  44. package/dist/core/engine/native-pugi.js +744 -210
  45. package/dist/core/engine/prompts.js +61 -6
  46. package/dist/core/engine/strip-internal-fields.js +124 -0
  47. package/dist/core/engine/tool-bridge.js +818 -31
  48. package/dist/core/file-cache.js +113 -1
  49. package/dist/core/init/scaffold.js +195 -0
  50. package/dist/core/lsp/client.js +174 -29
  51. package/dist/core/mcp/client.js +75 -6
  52. package/dist/core/mcp/http-server.js +553 -0
  53. package/dist/core/mcp/permission.js +190 -0
  54. package/dist/core/mcp/registry.js +24 -2
  55. package/dist/core/mcp/server-tools.js +219 -0
  56. package/dist/core/mcp/server.js +397 -0
  57. package/dist/core/permissions/gate.js +187 -0
  58. package/dist/core/permissions/index.js +18 -0
  59. package/dist/core/permissions/mode.js +102 -0
  60. package/dist/core/permissions/state.js +160 -0
  61. package/dist/core/permissions/tool-class.js +93 -0
  62. package/dist/core/repl/codebase-survey.js +308 -0
  63. package/dist/core/repl/history.js +11 -1
  64. package/dist/core/repl/init-interview.js +457 -0
  65. package/dist/core/repl/model-pricing.js +135 -0
  66. package/dist/core/repl/onboarding-state.js +297 -0
  67. package/dist/core/repl/session.js +719 -29
  68. package/dist/core/repl/slash-commands.js +133 -9
  69. package/dist/core/retry-budget/budget.js +284 -0
  70. package/dist/core/retry-budget/index.js +5 -0
  71. package/dist/core/settings.js +71 -0
  72. package/dist/core/skills/defaults.js +457 -0
  73. package/dist/core/subagents/dispatcher-real.js +600 -0
  74. package/dist/core/subagents/dispatcher.js +113 -24
  75. package/dist/core/subagents/index.js +18 -5
  76. package/dist/core/subagents/isolation-matrix.js +213 -0
  77. package/dist/core/subagents/spawn.js +19 -4
  78. package/dist/core/transport/version-interceptor.js +166 -0
  79. package/dist/index.js +28 -0
  80. package/dist/runtime/bootstrap.js +190 -0
  81. package/dist/runtime/cli.js +1588 -266
  82. package/dist/runtime/commands/compact.js +296 -0
  83. package/dist/runtime/commands/cost.js +199 -0
  84. package/dist/runtime/commands/delegate.js +289 -0
  85. package/dist/runtime/commands/doctor.js +369 -0
  86. package/dist/runtime/commands/lsp.js +187 -5
  87. package/dist/runtime/commands/mcp.js +824 -0
  88. package/dist/runtime/commands/patch.js +17 -0
  89. package/dist/runtime/commands/permissions.js +87 -0
  90. package/dist/runtime/commands/report.js +299 -0
  91. package/dist/runtime/commands/review-consensus.js +17 -2
  92. package/dist/runtime/commands/roster.js +117 -0
  93. package/dist/runtime/commands/status.js +178 -0
  94. package/dist/runtime/commands/worktree.js +50 -6
  95. package/dist/runtime/headless.js +543 -0
  96. package/dist/runtime/load-hooks-or-exit.js +71 -0
  97. package/dist/runtime/plan-decompose.js +531 -0
  98. package/dist/runtime/version.js +65 -0
  99. package/dist/tools/agent-tool.js +206 -0
  100. package/dist/tools/apply-patch.js +281 -39
  101. package/dist/tools/ask-user-question.js +213 -0
  102. package/dist/tools/ask-user.js +115 -0
  103. package/dist/tools/file-tools.js +85 -14
  104. package/dist/tools/mcp-tool.js +260 -0
  105. package/dist/tools/multi-edit.js +361 -0
  106. package/dist/tools/registry.js +22 -2
  107. package/dist/tools/skill-tool.js +96 -0
  108. package/dist/tools/tasks.js +208 -0
  109. package/dist/tools/web-fetch.js +147 -2
  110. package/dist/tools/web-search.js +458 -0
  111. package/dist/tui/agent-progress-card.js +111 -0
  112. package/dist/tui/agent-tree.js +10 -0
  113. package/dist/tui/ask-modal.js +2 -2
  114. package/dist/tui/ask-user-question-prompt.js +192 -0
  115. package/dist/tui/compact-banner.js +54 -0
  116. package/dist/tui/conversation-pane.js +69 -8
  117. package/dist/tui/cost-table.js +111 -0
  118. package/dist/tui/doctor-table.js +31 -0
  119. package/dist/tui/input-box.js +1 -1
  120. package/dist/tui/markdown-render.js +4 -4
  121. package/dist/tui/repl-render.js +276 -37
  122. package/dist/tui/repl-splash.js +2 -2
  123. package/dist/tui/repl.js +25 -6
  124. package/dist/tui/splash.js +1 -1
  125. package/dist/tui/status-bar.js +94 -16
  126. package/dist/tui/status-table.js +7 -0
  127. package/dist/tui/tool-stream-pane.js +7 -0
  128. package/dist/tui/update-banner.js +20 -2
  129. package/docs/examples/codegraph.mcp.json +10 -0
  130. package/package.json +9 -6
@@ -0,0 +1,86 @@
1
+ /**
2
+ * AUTH probe — verifies the active credential resolves to a working
3
+ * Bearer token by calling `GET /api/pugi/health` with it.
4
+ *
5
+ * Failure modes (deterministic mapping):
6
+ * - no credential found in env or `~/.pugi/credentials.json`
7
+ * → status `error`, remediation = `pugi login`
8
+ * - credential exists but server returns 401/403
9
+ * → status `error`, remediation = `pugi login` (token expired/revoked)
10
+ * - credential exists but server returns 5xx OR network fails
11
+ * → status `warn` (server-side; don't blame the operator)
12
+ * - credential exists and server returns 200
13
+ * → status `ok` (latency captured)
14
+ *
15
+ * NOTE: the probe must NEVER log the token itself. Memory hit
16
+ * `feedback_no_claude_attribution_anywhere_hard_rule` plus the CSO
17
+ * sweep on bearer leaks (history: PR-AGENT-MERGE-GATE 2026-05-15)
18
+ * frame why this is enforced at the probe layer.
19
+ */
20
+ export async function probeAuth(ctx, deps) {
21
+ const credential = deps.resolveCredential(ctx.env, ctx.home);
22
+ if (!credential) {
23
+ return {
24
+ name: 'AUTH',
25
+ status: 'error',
26
+ detail: 'No credential — no PUGI_API_KEY env and no ~/.pugi/credentials.json',
27
+ remediation: 'Run `pugi login` to authenticate',
28
+ };
29
+ }
30
+ const startedAt = deps.now();
31
+ let response;
32
+ try {
33
+ response = await deps.fetchImpl(`${stripTrailingSlash(credential.apiUrl)}/api/pugi/health`, {
34
+ method: 'GET',
35
+ headers: {
36
+ Authorization: `Bearer ${credential.apiKey}`,
37
+ },
38
+ });
39
+ }
40
+ catch (error) {
41
+ const message = error instanceof Error ? error.message : String(error);
42
+ return {
43
+ name: 'AUTH',
44
+ status: 'warn',
45
+ detail: `Auth check skipped — network error contacting ${credential.apiUrl}`,
46
+ remediation: `Verify network: ${message}`,
47
+ };
48
+ }
49
+ const latencyMs = deps.now() - startedAt;
50
+ if (response.status === 401 || response.status === 403) {
51
+ return {
52
+ name: 'AUTH',
53
+ status: 'error',
54
+ detail: `Token rejected (${response.status}) by ${credential.apiUrl}`,
55
+ latencyMs,
56
+ remediation: 'Token expired or revoked — run `pugi login`',
57
+ };
58
+ }
59
+ if (response.status >= 500) {
60
+ return {
61
+ name: 'AUTH',
62
+ status: 'warn',
63
+ detail: `Server error ${response.status} from ${credential.apiUrl}`,
64
+ latencyMs,
65
+ remediation: 'Try again in a moment; if it persists, check api.pugi.io status',
66
+ };
67
+ }
68
+ if (response.status !== 200) {
69
+ return {
70
+ name: 'AUTH',
71
+ status: 'warn',
72
+ detail: `Unexpected status ${response.status} from /api/pugi/health`,
73
+ latencyMs,
74
+ };
75
+ }
76
+ return {
77
+ name: 'AUTH',
78
+ status: 'ok',
79
+ detail: `Authenticated against ${credential.apiUrl}`,
80
+ latencyMs,
81
+ };
82
+ }
83
+ function stripTrailingSlash(url) {
84
+ return url.endsWith('/') ? url.slice(0, -1) : url;
85
+ }
86
+ //# sourceMappingURL=auth.js.map
@@ -0,0 +1,127 @@
1
+ /**
2
+ * CLI VERSION probe — compares the running @pugi/cli version against
3
+ * the npm registry's `latest` tag. Surfaces an upgrade banner when
4
+ * the operator is behind.
5
+ *
6
+ * Semver comparison is intentionally minimal — we only need to answer
7
+ * "is local strictly older than latest" for the WARN gate. Edge cases
8
+ * (pre-release ordering, build metadata) collapse к string equality
9
+ * because the publish pipeline only tags clean `X.Y.Z[-channel.N]`.
10
+ *
11
+ * Network failure is NOT an error — the operator is offline, that's
12
+ * a transient condition surfaced by the API probe; this probe reports
13
+ * `warn` so the doctor table still ships a usable verdict.
14
+ */
15
+ const REGISTRY_URL = 'https://registry.npmjs.org/@pugi/cli/latest';
16
+ /**
17
+ * Strict-newer comparison. Returns true when `b` is strictly newer
18
+ * than `a`. Treats unparseable inputs as equal (no false-positive
19
+ * upgrade banner on a hand-edited local version).
20
+ */
21
+ export function isNewerVersion(a, b) {
22
+ const left = parseSemver(a);
23
+ const right = parseSemver(b);
24
+ if (!left || !right)
25
+ return false;
26
+ if (right.major !== left.major)
27
+ return right.major > left.major;
28
+ if (right.minor !== left.minor)
29
+ return right.minor > left.minor;
30
+ if (right.patch !== left.patch)
31
+ return right.patch > left.patch;
32
+ // Same X.Y.Z — pre-release ordering: a stable release is newer
33
+ // than any pre-release of the same X.Y.Z; otherwise compare
34
+ // pre-release tokens lexicographically as a coarse heuristic
35
+ // sufficient for the upgrade banner.
36
+ if (!right.pre && left.pre)
37
+ return true;
38
+ if (right.pre && !left.pre)
39
+ return false;
40
+ if (right.pre && left.pre)
41
+ return right.pre > left.pre;
42
+ return false;
43
+ }
44
+ function parseSemver(version) {
45
+ const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?/.exec(version);
46
+ if (!match)
47
+ return null;
48
+ const major = Number(match[1]);
49
+ const minor = Number(match[2]);
50
+ const patch = Number(match[3]);
51
+ if (!Number.isFinite(major) || !Number.isFinite(minor) || !Number.isFinite(patch)) {
52
+ return null;
53
+ }
54
+ return { major, minor, patch, pre: match[4] ?? '' };
55
+ }
56
+ export async function probeCliVersion(deps) {
57
+ const url = deps.registryUrl ?? REGISTRY_URL;
58
+ const timeoutMs = deps.timeoutMs ?? 3_000;
59
+ const controller = new AbortController();
60
+ const timer = setTimeout(() => controller.abort(), timeoutMs);
61
+ const startedAt = deps.now();
62
+ let response;
63
+ try {
64
+ response = await deps.fetchImpl(url, {
65
+ method: 'GET',
66
+ headers: { Accept: 'application/json' },
67
+ signal: controller.signal,
68
+ });
69
+ }
70
+ catch (error) {
71
+ clearTimeout(timer);
72
+ const message = error instanceof Error ? error.message : String(error);
73
+ return {
74
+ name: 'CLI VERSION',
75
+ status: 'warn',
76
+ detail: `local=${deps.localVersion} — registry unreachable`,
77
+ remediation: `Skip-able. Network error: ${message}`,
78
+ };
79
+ }
80
+ clearTimeout(timer);
81
+ const latencyMs = deps.now() - startedAt;
82
+ if (!response.ok) {
83
+ return {
84
+ name: 'CLI VERSION',
85
+ status: 'warn',
86
+ detail: `local=${deps.localVersion} — registry returned ${response.status}`,
87
+ latencyMs,
88
+ };
89
+ }
90
+ let body;
91
+ try {
92
+ body = (await response.json());
93
+ }
94
+ catch {
95
+ return {
96
+ name: 'CLI VERSION',
97
+ status: 'warn',
98
+ detail: `local=${deps.localVersion} — registry JSON unparseable`,
99
+ latencyMs,
100
+ };
101
+ }
102
+ const remote = body.version;
103
+ if (typeof remote !== 'string' || remote.length === 0) {
104
+ return {
105
+ name: 'CLI VERSION',
106
+ status: 'warn',
107
+ detail: `local=${deps.localVersion} — registry response missing version`,
108
+ latencyMs,
109
+ };
110
+ }
111
+ if (isNewerVersion(deps.localVersion, remote)) {
112
+ return {
113
+ name: 'CLI VERSION',
114
+ status: 'warn',
115
+ detail: `local=${deps.localVersion}, latest=${remote}`,
116
+ latencyMs,
117
+ remediation: 'Run `npm i -g @pugi/cli@latest` to upgrade',
118
+ };
119
+ }
120
+ return {
121
+ name: 'CLI VERSION',
122
+ status: 'ok',
123
+ detail: `${deps.localVersion} (latest)`,
124
+ latencyMs,
125
+ };
126
+ }
127
+ //# sourceMappingURL=cli-version.js.map
@@ -0,0 +1,72 @@
1
+ /**
2
+ * CONFIG probe — verifies `~/.pugi/credentials.json` exists, parses,
3
+ * and carries the canonical shape (a `tokens` array). Lighter-weight
4
+ * than the auth probe (no network); catches `corrupted JSON` /
5
+ * `accidentally overwrote with empty file` / `bad permissions` cases
6
+ * that would otherwise surface as confusing errors deeper in the
7
+ * auth path.
8
+ *
9
+ * Absence of the file is NOT an error here — the operator may not
10
+ * have run `pugi login` yet. That case is caught by the AUTH probe
11
+ * with a clean "run pugi login" remediation. CONFIG's job is to
12
+ * verify the file is sane WHEN it exists.
13
+ */
14
+ export function probeConfig(ctx, fs) {
15
+ const credPath = `${ctx.home}/.pugi/credentials.json`;
16
+ if (!fs.existsSync(credPath)) {
17
+ return {
18
+ name: 'CONFIG',
19
+ status: 'skipped',
20
+ detail: '~/.pugi/credentials.json absent (operator has not logged in)',
21
+ };
22
+ }
23
+ let raw;
24
+ try {
25
+ raw = fs.readFileSync(credPath, 'utf8');
26
+ }
27
+ catch (error) {
28
+ const message = error instanceof Error ? error.message : String(error);
29
+ return {
30
+ name: 'CONFIG',
31
+ status: 'error',
32
+ detail: `Cannot read ~/.pugi/credentials.json`,
33
+ remediation: `Fix permissions or delete and re-login: ${message}`,
34
+ };
35
+ }
36
+ let parsed;
37
+ try {
38
+ parsed = JSON.parse(raw);
39
+ }
40
+ catch (error) {
41
+ const message = error instanceof Error ? error.message : String(error);
42
+ return {
43
+ name: 'CONFIG',
44
+ status: 'error',
45
+ detail: `~/.pugi/credentials.json is not valid JSON`,
46
+ remediation: `Delete and re-login: ${message}`,
47
+ };
48
+ }
49
+ if (!parsed || typeof parsed !== 'object') {
50
+ return {
51
+ name: 'CONFIG',
52
+ status: 'error',
53
+ detail: `credentials.json root is not an object`,
54
+ remediation: 'Delete and re-login',
55
+ };
56
+ }
57
+ const tokens = parsed.tokens;
58
+ if (!Array.isArray(tokens)) {
59
+ return {
60
+ name: 'CONFIG',
61
+ status: 'error',
62
+ detail: `credentials.json missing required \`tokens\` array`,
63
+ remediation: 'Delete and re-login',
64
+ };
65
+ }
66
+ return {
67
+ name: 'CONFIG',
68
+ status: 'ok',
69
+ detail: `~/.pugi/credentials.json valid (${tokens.length} token(s) stored)`,
70
+ };
71
+ }
72
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1,57 @@
1
+ /**
2
+ * α7 L11 (2026-05-27) — DENIAL TRACKING probe for `pugi doctor`.
3
+ *
4
+ * Reports the current session's denial pressure: total denial count,
5
+ * unique (tool, args) patterns, and how many patterns have repeated
6
+ * past the reminder threshold. Operators read this to spot:
7
+ *
8
+ * - A hook script refusing more dispatches than expected (mis-
9
+ * configured `.pugi/hooks.json`).
10
+ * - Plan-mode runs where the model keeps trying mutating tools
11
+ * (a sign the prompt is not anchoring it correctly).
12
+ * - Stale-read loops indicating concurrent multi-agent writes.
13
+ *
14
+ * Status semantics:
15
+ *
16
+ * - `ok` when the tracker is empty OR carries denials but none have
17
+ * repeated past the threshold. Single denials are normal session
18
+ * hygiene; repeats are the signal.
19
+ * - `warn` when one or more patterns repeated >= the reminder
20
+ * threshold. The probe surfaces the count so the operator can act.
21
+ * - `skipped` when no tracker is wired (e.g. doctor invoked outside
22
+ * a live REPL session, top-level `pugi doctor`).
23
+ *
24
+ * Pure: takes a tracker snapshot — no I/O, no module-level state.
25
+ */
26
+ import { DENIAL_REMINDER_THRESHOLD, } from '../../denial-tracking/state.js';
27
+ export function probeDenialTracking(deps) {
28
+ if (!deps.tracker) {
29
+ return {
30
+ name: 'DENIAL TRACKING',
31
+ status: 'skipped',
32
+ detail: 'No live session — run `pugi doctor` from inside the REPL to see denials.',
33
+ };
34
+ }
35
+ const summary = deps.tracker.summary();
36
+ if (summary.totalDenials === 0) {
37
+ return {
38
+ name: 'DENIAL TRACKING',
39
+ status: 'ok',
40
+ detail: 'No tool denials this session.',
41
+ };
42
+ }
43
+ if (summary.repeatedPatterns === 0) {
44
+ return {
45
+ name: 'DENIAL TRACKING',
46
+ status: 'ok',
47
+ detail: `${summary.totalDenials} denial(s), ${summary.uniquePatterns} unique pattern(s), none repeated.`,
48
+ };
49
+ }
50
+ return {
51
+ name: 'DENIAL TRACKING',
52
+ status: 'warn',
53
+ detail: `${summary.totalDenials} denial(s), ${summary.repeatedPatterns} pattern(s) repeated >= ${DENIAL_REMINDER_THRESHOLD}.`,
54
+ remediation: 'Inspect via `/permissions denials` (when L6 lands) or check `.pugi/events.jsonl` for the latest refusals.',
55
+ };
56
+ }
57
+ //# sourceMappingURL=denial-tracking.js.map
@@ -0,0 +1,81 @@
1
+ /**
2
+ * DISK probe — warn the operator when the home partition is dangerously
3
+ * full. The session log, file cache, MCP working dirs, and the engine
4
+ * artifact bundle all land under `~/.pugi/`, so a full disk produces
5
+ * cryptic ENOSPC errors mid-dispatch. We catch that early.
6
+ *
7
+ * Implementation strategy: call `df -k` (POSIX-portable BSD tool with a
8
+ * stable column ordering) on the home dir and parse the available
9
+ * column. Bytes math + 1k blocks = simple integer arithmetic. We
10
+ * deliberately avoid `statvfs` because Node's stable surface for it
11
+ * (`fs.statfs` introduced in Node 18.15) returns BigInts that callers
12
+ * routinely mishandle on cross-platform builds.
13
+ *
14
+ * Thresholds:
15
+ * - `< 256 MiB` available → error (Pugi cannot do meaningful work)
16
+ * - `< 1 GiB` available → warn (operator should clear space soon)
17
+ * - otherwise → ok
18
+ */
19
+ const MIB = 1024 * 1024;
20
+ const GIB = MIB * 1024;
21
+ const ERROR_THRESHOLD_BYTES = 256 * MIB;
22
+ const WARN_THRESHOLD_BYTES = 1 * GIB;
23
+ export function probeDisk(ctx, deps) {
24
+ let freeBytes;
25
+ try {
26
+ freeBytes = deps.getFreeBytes(ctx.home);
27
+ }
28
+ catch (error) {
29
+ const message = error instanceof Error ? error.message : String(error);
30
+ return {
31
+ name: 'DISK',
32
+ status: 'warn',
33
+ detail: `Cannot determine free space on ${ctx.home}`,
34
+ remediation: `Inspection failed: ${message}`,
35
+ };
36
+ }
37
+ if (!Number.isFinite(freeBytes) || freeBytes < 0) {
38
+ return {
39
+ name: 'DISK',
40
+ status: 'warn',
41
+ detail: `df returned implausible value (${freeBytes}) for ${ctx.home}`,
42
+ };
43
+ }
44
+ const human = formatBytes(freeBytes);
45
+ if (freeBytes < ERROR_THRESHOLD_BYTES) {
46
+ return {
47
+ name: 'DISK',
48
+ status: 'error',
49
+ detail: `${human} free on home partition`,
50
+ remediation: 'Free disk space — Pugi writes ~/.pugi/sessions and cache files',
51
+ };
52
+ }
53
+ if (freeBytes < WARN_THRESHOLD_BYTES) {
54
+ return {
55
+ name: 'DISK',
56
+ status: 'warn',
57
+ detail: `${human} free on home partition`,
58
+ remediation: 'Consider clearing ~/.pugi/sessions older entries',
59
+ };
60
+ }
61
+ return {
62
+ name: 'DISK',
63
+ status: 'ok',
64
+ detail: `${human} free on home partition`,
65
+ };
66
+ }
67
+ /**
68
+ * Format bytes as `1.2GB` / `512MB` / `42KB`. Stays in IEC base-1024
69
+ * because that's what `df -k` returns and what operators reading the
70
+ * doctor table expect to see on their `df` follow-up.
71
+ */
72
+ export function formatBytes(bytes) {
73
+ if (bytes >= GIB)
74
+ return `${(bytes / GIB).toFixed(1)}GB`;
75
+ if (bytes >= MIB)
76
+ return `${Math.round(bytes / MIB)}MB`;
77
+ if (bytes >= 1024)
78
+ return `${Math.round(bytes / 1024)}KB`;
79
+ return `${bytes}B`;
80
+ }
81
+ //# sourceMappingURL=disk.js.map
@@ -0,0 +1,65 @@
1
+ /**
2
+ * GIT probe — verifies git is on PATH AND the current cwd is inside a
3
+ * git work tree. Reports the short HEAD sha + repo root for context.
4
+ *
5
+ * Pugi treats the workspace as a git project (worktree isolation,
6
+ * /codex review, /triple-review and the entire agent loop assume
7
+ * `git diff origin/main..HEAD` is meaningful). A workspace that is
8
+ * not a git work tree still works for read-only commands but the
9
+ * doctor surface flags this so the operator knows where the limits
10
+ * are.
11
+ */
12
+ export function probeGit(ctx, deps) {
13
+ let version;
14
+ try {
15
+ version = deps.resolveVersion();
16
+ }
17
+ catch (error) {
18
+ const message = error instanceof Error ? error.message : String(error);
19
+ return {
20
+ name: 'GIT',
21
+ status: 'warn',
22
+ detail: 'git not on PATH',
23
+ remediation: `Install git (error: ${message})`,
24
+ };
25
+ }
26
+ let inWorkTree = false;
27
+ try {
28
+ inWorkTree = deps.isInWorkTree(ctx.cwd);
29
+ }
30
+ catch {
31
+ inWorkTree = false;
32
+ }
33
+ if (!inWorkTree) {
34
+ return {
35
+ name: 'GIT',
36
+ status: 'warn',
37
+ detail: `${version} (cwd is not a git work tree)`,
38
+ remediation: 'Run `git init` to enable diff-based commands',
39
+ };
40
+ }
41
+ const sha = (() => {
42
+ try {
43
+ return deps.resolveHeadSha(ctx.cwd);
44
+ }
45
+ catch {
46
+ return null;
47
+ }
48
+ })();
49
+ const root = (() => {
50
+ try {
51
+ return deps.resolveRoot(ctx.cwd);
52
+ }
53
+ catch {
54
+ return null;
55
+ }
56
+ })();
57
+ const shaSuffix = sha ? ` @ ${sha.slice(0, 8)}` : '';
58
+ const rootSuffix = root ? ` (${root})` : '';
59
+ return {
60
+ name: 'GIT',
61
+ status: 'ok',
62
+ detail: `${version}${shaSuffix}${rootSuffix}`,
63
+ };
64
+ }
65
+ //# sourceMappingURL=git.js.map
@@ -0,0 +1,75 @@
1
+ /**
2
+ * MCP probe — reports the configured Model Context Protocol servers
3
+ * along with their trust + connection state.
4
+ *
5
+ * Sibling L13 (MCP server config) ships its own command surface; this
6
+ * probe consumes the existing `loadMcpRegistry` helper в a graceful
7
+ * try/catch so an unconfigured workspace (no `.pugi/mcp.json` OR an
8
+ * empty `servers: {}` map) lands as `ok` with detail "no servers
9
+ * configured" rather than a noisy failure row.
10
+ *
11
+ * Failure modes:
12
+ * - registry helper throws → `warn` with the error message;
13
+ * the table renderer surfaces the remediation hint;
14
+ * - one or more servers report `lastError` → `warn` summarising the
15
+ * count;
16
+ * - all configured servers connected cleanly → `ok` listing them.
17
+ */
18
+ export async function probeMcp(ctx, deps) {
19
+ let registry;
20
+ try {
21
+ // `connect: false` keeps the probe cheap — we only need the
22
+ // declared config + trust ledger entries, not live subprocess
23
+ // handshakes. The doctor sweep budget shouldn't be eaten by
24
+ // server-spawn latency.
25
+ registry = await deps.loadRegistry(ctx.cwd, { connect: false });
26
+ }
27
+ catch (error) {
28
+ const message = error instanceof Error ? error.message : String(error);
29
+ return {
30
+ name: 'MCP SERVERS',
31
+ status: 'warn',
32
+ detail: 'MCP registry not loadable (config or schema error)',
33
+ remediation: `Inspect .pugi/mcp.json: ${message}`,
34
+ };
35
+ }
36
+ const servers = Array.from(registry.servers.values());
37
+ // Best-effort shutdown — even with `connect: false` we still own the
38
+ // registry handle. Swallow errors so a clean-up failure never
39
+ // poisons the probe verdict.
40
+ await registry.shutdown().catch(() => { });
41
+ if (servers.length === 0) {
42
+ return {
43
+ name: 'MCP SERVERS',
44
+ status: 'ok',
45
+ detail: 'No MCP servers configured',
46
+ };
47
+ }
48
+ const labels = servers.map((server) => `${server.name}:${server.trust}`);
49
+ const trusted = servers.filter((server) => server.trust === 'trusted');
50
+ const pending = servers.filter((server) => server.trust === 'pending');
51
+ const denied = servers.filter((server) => server.trust === 'denied');
52
+ const failing = servers.filter((server) => typeof server.lastError === 'string' && server.lastError.length > 0);
53
+ if (failing.length > 0) {
54
+ return {
55
+ name: 'MCP SERVERS',
56
+ status: 'warn',
57
+ detail: `${failing.length}/${servers.length} server(s) reporting errors: ${labels.join(', ')}`,
58
+ remediation: `Inspect: \`pugi mcp list\``,
59
+ };
60
+ }
61
+ if (pending.length > 0) {
62
+ return {
63
+ name: 'MCP SERVERS',
64
+ status: 'warn',
65
+ detail: `${pending.length} pending trust decision(s): ${labels.join(', ')}`,
66
+ remediation: 'Run `pugi mcp trust <name>` or `pugi mcp deny <name>`',
67
+ };
68
+ }
69
+ return {
70
+ name: 'MCP SERVERS',
71
+ status: 'ok',
72
+ detail: `${trusted.length} trusted, ${denied.length} denied (${labels.join(', ')})`,
73
+ };
74
+ }
75
+ //# sourceMappingURL=mcp.js.map
@@ -0,0 +1,59 @@
1
+ /**
2
+ * NODE probe — verifies the running Node major version meets the
3
+ * `engines.node` floor declared in @pugi/cli's package.json.
4
+ *
5
+ * We bake the floor in as a constant rather than reading package.json
6
+ * at runtime because the published .tgz strips the file from a location
7
+ * the compiled bundle can reach (`--resolveJsonModule` is off for the
8
+ * CLI build). The lockstep is enforced by
9
+ * `scripts/check-version-lockstep.sh` in the publish pipeline.
10
+ */
11
+ /**
12
+ * Minimum supported Node major. Mirrors `engines.node` in
13
+ * apps/pugi-cli/package.json (`">=22.5.0"`).
14
+ */
15
+ export const MIN_NODE_MAJOR = 22;
16
+ export const MIN_NODE_MINOR = 5;
17
+ /**
18
+ * Parse a Node version string of the form `v<major>.<minor>.<patch>`.
19
+ * Returns null when the input doesn't match — the caller treats null
20
+ * as an error condition.
21
+ */
22
+ export function parseNodeVersion(version) {
23
+ const match = /^v(\d+)\.(\d+)\./.exec(version);
24
+ if (!match)
25
+ return null;
26
+ const major = Number(match[1]);
27
+ const minor = Number(match[2]);
28
+ if (!Number.isFinite(major) || !Number.isFinite(minor))
29
+ return null;
30
+ return { major, minor };
31
+ }
32
+ export function probeNode(input) {
33
+ const parsed = parseNodeVersion(input.version);
34
+ if (!parsed) {
35
+ return {
36
+ name: 'NODE',
37
+ status: 'error',
38
+ detail: `Unparseable Node version "${input.version}"`,
39
+ remediation: `Install Node >= ${MIN_NODE_MAJOR}.${MIN_NODE_MINOR}.0 (current binary returns a non-semver version string)`,
40
+ };
41
+ }
42
+ const { major, minor } = parsed;
43
+ const passes = major > MIN_NODE_MAJOR ||
44
+ (major === MIN_NODE_MAJOR && minor >= MIN_NODE_MINOR);
45
+ if (passes) {
46
+ return {
47
+ name: 'NODE',
48
+ status: 'ok',
49
+ detail: `${input.version} (>= ${MIN_NODE_MAJOR}.${MIN_NODE_MINOR}.0 required)`,
50
+ };
51
+ }
52
+ return {
53
+ name: 'NODE',
54
+ status: 'error',
55
+ detail: `${input.version} below floor >= ${MIN_NODE_MAJOR}.${MIN_NODE_MINOR}.0`,
56
+ remediation: `Upgrade Node: \`nvm install ${MIN_NODE_MAJOR}\` or download from nodejs.org`,
57
+ };
58
+ }
59
+ //# sourceMappingURL=node.js.map
@@ -0,0 +1,36 @@
1
+ /**
2
+ * PNPM probe — verifies pnpm is on PATH and reports its version. The
3
+ * customer-facing CLI doesn't strictly require pnpm at runtime
4
+ * (`@pugi/cli` is published as a regular npm package), but a missing
5
+ * pnpm means `pugi code` cannot run `pnpm test` / `pnpm typecheck`
6
+ * gates the agent loop emits. Surfacing this early prevents the
7
+ * agent from issuing a meaningless `command not found: pnpm` error
8
+ * three turns into a session.
9
+ */
10
+ export function probePnpm(deps) {
11
+ try {
12
+ const version = deps.resolveVersion();
13
+ if (!version) {
14
+ return {
15
+ name: 'PNPM',
16
+ status: 'warn',
17
+ detail: 'pnpm reported empty version string',
18
+ };
19
+ }
20
+ return {
21
+ name: 'PNPM',
22
+ status: 'ok',
23
+ detail: `pnpm ${version}`,
24
+ };
25
+ }
26
+ catch (error) {
27
+ const message = error instanceof Error ? error.message : String(error);
28
+ return {
29
+ name: 'PNPM',
30
+ status: 'warn',
31
+ detail: 'pnpm not on PATH — agent quality gates will be skipped',
32
+ remediation: `Install pnpm: \`npm i -g pnpm\` (error: ${message})`,
33
+ };
34
+ }
35
+ }
36
+ //# sourceMappingURL=pnpm.js.map