@namzu/cli 0.0.2

package/README.md

@@ -0,0 +1,79 @@
+# @namzu/cli
+
+Operator CLI for the [Namzu](https://namzu.ai) agent platform.
+
+Dual-purpose:
+- **Standalone bin** — `npx @namzu/cli doctor` (or after install: `namzu doctor`).
+- **Library** — `import { runDoctor, registerDoctorCheck } from '@namzu/cli'` for embedded usage where consumer code wants to invoke the doctor in its own process so app-registered checks are visible.
+
+## Install
+
+```bash
+pnpm add -D @namzu/cli
+# or, for one-off invocations:
+pnpm dlx @namzu/cli doctor
+```
+
+## Commands
+
+### `namzu doctor`
+
+Run health checks against the local Namzu environment.
+
+```
+namzu doctor                              # human-readable, all categories
+namzu doctor --json                       # machine-readable JSON
+namzu doctor --category sandbox,runtime   # filter by category
+namzu doctor --per-check-timeout 8000     # raise per-check timeout
+namzu doctor --verbose                    # include failure detail
+```
+
+**Exit codes** (sysexits-aligned):
+
+| Code | Name                  | Meaning                                     |
+| ---: | --------------------- | ------------------------------------------- |
+|  `0` | `EXIT_OK`             | All checks passed (or no failure produced). |
+|  `1` | `EXIT_FAIL`           | One or more checks reported `fail`.         |
+|  `2` | `EXIT_NO_CONFIG`      | No checks registered (Namzu not set up).    |
+| `70` | `EXIT_INTERNAL_ERROR` | sysexits `EX_SOFTWARE`; CLI bug.            |
+
+**Built-in checks** ship intentionally conservative; consumers register their own via `registerDoctorCheck()`:
+
+- `sandbox.platform` — darwin sandbox-exec presence; warn on win32; inconclusive on linux.
+- `runtime.cwd-writable`, `runtime.tmpdir-writable` — `fs.access(W_OK)` probes.
+- `telemetry.installed` — pass if `@namzu/telemetry` is dynamically importable.
+- `vault.registered`, `providers.registered` — inconclusive with "register your own" guidance.
+
+## Library API
+
+```ts
+import { runDoctor, registerDoctorCheck, builtInDoctorChecks } from '@namzu/cli'
+import { ProviderRegistry } from '@namzu/sdk'
+
+// Register a custom check that walks YOUR provider registry
+registerDoctorCheck({
+	id: 'app.providers.reachable',
+	category: 'providers',
+	run: async () => {
+		const providers = ProviderRegistry.getAll()
+		const results = await Promise.all(
+			providers.map((p) => p.doctorCheck?.() ?? { status: 'inconclusive' as const }),
+		)
+		const failed = results.filter((r) => r.status === 'fail')
+		return failed.length > 0
+			? { status: 'fail', message: `${failed.length} provider(s) failed reachability` }
+			: { status: 'pass', message: `${providers.length} provider(s) reachable` }
+	},
+})
+
+const report = await runDoctor()
+process.exit(report.exit)
+```
+
+## Architecture
+
+The doctor's protocol types (`DoctorCheck`, `DoctorCheckResult`, `DoctorReport`, `DoctorStatus`) live in `@namzu/sdk` so kernel components (providers, vaults, sandboxes) can implement `doctorCheck?()` hooks against them. The runtime (registry, runner, output formatting, exit codes) lives here in `@namzu/cli` because it's operator-facing concerns. This is the [`ses_007-probe-and-doctor`](https://github.com/cogitave/namzu/tree/main/docs.local/sessions/ses_007-probe-and-doctor) split.
+
+## License
+
+MIT

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { runDoctorCommand } from './commands/doctor.js';
+const HELP = `namzu — operator CLI for the Namzu agent platform
+
+Usage:
+  namzu <command> [options]
+
+Commands:
+  doctor       Run health checks against the local environment
+  help         Show this help
+
+Examples:
+  namzu doctor
+  namzu doctor --json
+  namzu doctor --category sandbox,runtime
+  namzu doctor --per-check-timeout 8000
+`;
+async function main() {
+    const [, , command, ...rest] = process.argv;
+    if (!command || command === 'help' || command === '--help' || command === '-h') {
+        process.stdout.write(`${HELP}\n`);
+        return 0;
+    }
+    switch (command) {
+        case 'doctor':
+            return runDoctorCommand(rest);
+        default:
+            process.stderr.write(`Unknown command: ${command}\n\n${HELP}\n`);
+            return 64; // EX_USAGE per sysexits
+    }
+}
+main().then((code) => {
+    process.exit(code);
+}, (err) => {
+    process.stderr.write(`Fatal: ${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`);
+    process.exit(70); // EX_SOFTWARE per sysexits
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAEvD,MAAM,IAAI,GAAG;;;;;;;;;;;;;;CAcZ,CAAA;AAED,KAAK,UAAU,IAAI;IAClB,MAAM,CAAC,EAAE,AAAD,EAAG,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAA;IAE3C,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAChF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAA;QACjC,OAAO,CAAC,CAAA;IACT,CAAC;IAED,QAAQ,OAAO,EAAE,CAAC;QACjB,KAAK,QAAQ;YACZ,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAA;QAC9B;YACC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,OAAO,IAAI,IAAI,CAAC,CAAA;YAChE,OAAO,EAAE,CAAA,CAAC,wBAAwB;IACpC,CAAC;AACF,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CACV,CAAC,IAAI,EAAE,EAAE;IACR,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACnB,CAAC,EACD,CAAC,GAAG,EAAE,EAAE;IACP,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAC7E,CAAA;IACD,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA,CAAC,2BAA2B;AAC7C,CAAC,CACD,CAAA"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function runDoctorCommand(args: readonly string[]): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAkMA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA8B/E"}

package/dist/commands/doctor.js

@@ -0,0 +1,201 @@
+import { builtInDoctorChecks } from '../doctor/checks/index.js';
+import { createDoctorRegistry, runDoctor } from '../doctor/registry.js';
+import { EXIT_INTERNAL_ERROR } from '../exit-codes.js';
+const VALID_CATEGORIES = [
+    'sandbox',
+    'providers',
+    'vault',
+    'telemetry',
+    'runtime',
+    'plugins',
+    'custom',
+];
+const HELP = `namzu doctor — health checks for the local Namzu environment
+
+Usage:
+  namzu doctor [options]
+
+Options:
+  --json                       Emit a machine-readable JSON report
+  --verbose                    Include stack traces on failures
+  --category <a,b,c>           Comma-separated category filter
+                               (sandbox, providers, vault, telemetry,
+                                runtime, plugins, custom)
+  --per-check-timeout <ms>     Per-check timeout (default 5000)
+  --wall-clock-timeout <ms>    Total wall-clock timeout (default 10000)
+  -h, --help                   Show this help
+
+Exit codes:
+  0   all checks passed (or no failure produced)
+  1   one or more checks reported \`fail\`
+  2   no checks registered (Namzu not configured here)
+  70  internal CLI error (sysexits EX_SOFTWARE)
+`;
+function parseArgs(args) {
+    let json = false;
+    let verbose = false;
+    let help = false;
+    let categories;
+    let perCheckTimeoutMs;
+    let wallClockTimeoutMs;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--json':
+                json = true;
+                break;
+            case '--verbose':
+                verbose = true;
+                break;
+            case '-h':
+            case '--help':
+                help = true;
+                break;
+            case '--category': {
+                const value = args[++i];
+                if (!value)
+                    return { json, verbose, help, error: '--category requires a value' };
+                const parts = value
+                    .split(',')
+                    .map((p) => p.trim())
+                    .filter(Boolean);
+                const invalid = parts.filter((p) => !VALID_CATEGORIES.includes(p));
+                if (invalid.length > 0) {
+                    return {
+                        json,
+                        verbose,
+                        help,
+                        error: `unknown category: ${invalid.join(', ')} (valid: ${VALID_CATEGORIES.join(', ')})`,
+                    };
+                }
+                categories = parts;
+                break;
+            }
+            case '--per-check-timeout': {
+                const value = args[++i];
+                if (!value)
+                    return {
+                        json,
+                        verbose,
+                        help,
+                        error: '--per-check-timeout requires a value',
+                    };
+                const n = Number.parseInt(value, 10);
+                if (!Number.isFinite(n) || n <= 0) {
+                    return {
+                        json,
+                        verbose,
+                        help,
+                        error: `--per-check-timeout must be a positive integer; got ${value}`,
+                    };
+                }
+                perCheckTimeoutMs = n;
+                break;
+            }
+            case '--wall-clock-timeout': {
+                const value = args[++i];
+                if (!value)
+                    return {
+                        json,
+                        verbose,
+                        help,
+                        error: '--wall-clock-timeout requires a value',
+                    };
+                const n = Number.parseInt(value, 10);
+                if (!Number.isFinite(n) || n <= 0) {
+                    return {
+                        json,
+                        verbose,
+                        help,
+                        error: `--wall-clock-timeout must be a positive integer; got ${value}`,
+                    };
+                }
+                wallClockTimeoutMs = n;
+                break;
+            }
+            default:
+                return { json, verbose, help, error: `unknown option: ${arg}` };
+        }
+    }
+    return {
+        json,
+        verbose,
+        help,
+        categories,
+        perCheckTimeoutMs,
+        wallClockTimeoutMs,
+    };
+}
+function statusGlyph(status) {
+    switch (status) {
+        case 'pass':
+            return '✓';
+        case 'fail':
+            return '✗';
+        case 'inconclusive':
+            return '⊘';
+        case 'warn':
+            return '!';
+    }
+}
+function formatHumanReport(report, verbose) {
+    const lines = [];
+    lines.push(`namzu doctor — ${report.timestamp}`);
+    lines.push('');
+    const widestCategory = report.checks.reduce((w, c) => Math.max(w, c.category.length), 'category'.length);
+    for (const record of report.checks) {
+        const glyph = statusGlyph(record.status);
+        const category = record.category.padEnd(widestCategory);
+        const dur = `${record.durationMs}ms`;
+        const head = `  ${glyph} ${category}  ${record.id}  ${dur}`;
+        lines.push(head);
+        if (record.message)
+            lines.push(`     ${record.message}`);
+        if (record.remediation)
+            lines.push(`     → ${record.remediation}`);
+    }
+    lines.push('');
+    const s = report.summary;
+    lines.push(`  pass: ${s.pass}  fail: ${s.fail}  warn: ${s.warn}  inconc: ${s.inconclusive}  total: ${s.total}`);
+    lines.push(`  exit: ${report.exit}`);
+    if (verbose) {
+        const failed = report.checks.filter((c) => c.status === 'fail');
+        if (failed.length > 0) {
+            lines.push('');
+            lines.push('Failures:');
+            for (const f of failed) {
+                lines.push(`  ${f.id}: ${f.message ?? '(no message)'}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+export async function runDoctorCommand(args) {
+    const parsed = parseArgs(args);
+    if (parsed.error) {
+        process.stderr.write(`Error: ${parsed.error}\n\n${HELP}\n`);
+        return EXIT_INTERNAL_ERROR;
+    }
+    if (parsed.help) {
+        process.stdout.write(`${HELP}\n`);
+        return 0;
+    }
+    const registry = createDoctorRegistry();
+    for (const check of builtInDoctorChecks)
+        registry.register(check);
+    const opts = {
+        registry,
+        categories: parsed.categories,
+        perCheckTimeoutMs: parsed.perCheckTimeoutMs,
+        wallClockTimeoutMs: parsed.wallClockTimeoutMs,
+    };
+    const report = await runDoctor(opts);
+    if (parsed.json) {
+        process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+    }
+    else {
+        process.stdout.write(`${formatHumanReport(report, parsed.verbose)}\n`);
+    }
+    return report.exit;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/commands/doctor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=doctor.test.d.ts.map

package/dist/commands/doctor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.test.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.test.ts"],"names":[],"mappings":""}

package/dist/commands/doctor.test.js

@@ -0,0 +1,82 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { runDoctorCommand } from './doctor.js';
+describe('runDoctorCommand', () => {
+    let captured;
+    let originalStdoutWrite;
+    let originalStderrWrite;
+    beforeEach(() => {
+        captured = '';
+        originalStdoutWrite = process.stdout.write.bind(process.stdout);
+        originalStderrWrite = process.stderr.write.bind(process.stderr);
+        process.stdout.write = ((chunk) => {
+            captured += typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString('utf8');
+            return true;
+        });
+        process.stderr.write = ((chunk) => {
+            captured += typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString('utf8');
+            return true;
+        });
+    });
+    afterEach(() => {
+        process.stdout.write = originalStdoutWrite;
+        process.stderr.write = originalStderrWrite;
+    });
+    it('--help returns 0 and prints usage', async () => {
+        const code = await runDoctorCommand(['--help']);
+        expect(code).toBe(0);
+        expect(captured).toContain('namzu doctor');
+        expect(captured).toContain('--json');
+        expect(captured).toContain('--category');
+    });
+    it('rejects unknown options with EXIT_INTERNAL_ERROR (70)', async () => {
+        const code = await runDoctorCommand(['--frobnicate']);
+        expect(code).toBe(70);
+        expect(captured).toContain('unknown option: --frobnicate');
+    });
+    it('--category accepts a valid comma-separated list', async () => {
+        const code = await runDoctorCommand(['--category', 'sandbox,runtime', '--json']);
+        expect([0, 1]).toContain(code);
+        const json = JSON.parse(captured);
+        expect(json.checks.every((c) => ['sandbox', 'runtime'].includes(c.category))).toBe(true);
+    });
+    it('--category rejects an invalid name', async () => {
+        const code = await runDoctorCommand(['--category', 'sandbox,wat']);
+        expect(code).toBe(70);
+        expect(captured).toContain('unknown category: wat');
+    });
+    it('--per-check-timeout requires a positive integer', async () => {
+        const code = await runDoctorCommand(['--per-check-timeout', '-5']);
+        expect(code).toBe(70);
+        expect(captured).toContain('--per-check-timeout must be a positive integer');
+    });
+    it('--json emits valid JSON conforming to DoctorReport', async () => {
+        const code = await runDoctorCommand(['--json']);
+        expect([0, 1]).toContain(code);
+        const json = JSON.parse(captured);
+        expect(json).toHaveProperty('version');
+        expect(json).toHaveProperty('timestamp');
+        expect(Array.isArray(json.checks)).toBe(true);
+        expect(json).toHaveProperty('summary.total');
+        expect(json).toHaveProperty('exit');
+    });
+    it('default human output includes the summary line', async () => {
+        const code = await runDoctorCommand([]);
+        expect([0, 1]).toContain(code);
+        expect(captured).toContain('namzu doctor —');
+        expect(captured).toMatch(/pass: \d+ {2}fail: \d+/);
+        expect(captured).toMatch(/exit: \d+/);
+    });
+    it('built-in checks register with stable ids', async () => {
+        const code = await runDoctorCommand(['--json']);
+        expect([0, 1]).toContain(code);
+        const json = JSON.parse(captured);
+        const ids = json.checks.map((c) => c.id).sort();
+        expect(ids).toContain('sandbox.platform');
+        expect(ids).toContain('runtime.cwd-writable');
+        expect(ids).toContain('runtime.tmpdir-writable');
+        expect(ids).toContain('telemetry.installed');
+        expect(ids).toContain('vault.registered');
+        expect(ids).toContain('providers.registered');
+    });
+});
+//# sourceMappingURL=doctor.test.js.map

package/dist/commands/doctor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.test.js","sourceRoot":"","sources":["../../src/commands/doctor.test.ts"],"names":[],"mappings":"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"}

package/dist/doctor/checks/index.d.ts

@@ -0,0 +1,9 @@
+import type { DoctorCheck } from '@namzu/sdk';
+import { providersRegisteredCheck } from './providers.js';
+import { cwdWritableCheck, tmpdirWritableCheck } from './runtime.js';
+import { sandboxPlatformCheck } from './sandbox.js';
+import { telemetryInstalledCheck } from './telemetry.js';
+import { vaultRegisteredCheck } from './vault.js';
+export { providersRegisteredCheck, cwdWritableCheck, tmpdirWritableCheck, sandboxPlatformCheck, telemetryInstalledCheck, vaultRegisteredCheck, };
+export declare const builtInDoctorChecks: readonly DoctorCheck[];
+//# sourceMappingURL=index.d.ts.map

package/dist/doctor/checks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/doctor/checks/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjD,OAAO,EACN,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,GACpB,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,WAAW,EAOrD,CAAA"}

package/dist/doctor/checks/index.js

@@ -0,0 +1,15 @@
+import { providersRegisteredCheck } from './providers.js';
+import { cwdWritableCheck, tmpdirWritableCheck } from './runtime.js';
+import { sandboxPlatformCheck } from './sandbox.js';
+import { telemetryInstalledCheck } from './telemetry.js';
+import { vaultRegisteredCheck } from './vault.js';
+export { providersRegisteredCheck, cwdWritableCheck, tmpdirWritableCheck, sandboxPlatformCheck, telemetryInstalledCheck, vaultRegisteredCheck, };
+export const builtInDoctorChecks = [
+    sandboxPlatformCheck,
+    cwdWritableCheck,
+    tmpdirWritableCheck,
+    providersRegisteredCheck,
+    vaultRegisteredCheck,
+    telemetryInstalledCheck,
+];
+//# sourceMappingURL=index.js.map

package/dist/doctor/checks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/doctor/checks/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjD,OAAO,EACN,wBAAwB,EACxB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,GACpB,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IAC1D,oBAAoB;IACpB,gBAAgB;IAChB,mBAAmB;IACnB,wBAAwB;IACxB,oBAAoB;IACpB,uBAAuB;CACvB,CAAA"}

package/dist/doctor/checks/providers.d.ts

@@ -0,0 +1,19 @@
+import type { DoctorCheck } from '@namzu/sdk';
+/**
+ * Built-in provider probe is intentionally inconclusive in v1.
+ *
+ * Provider auto-discovery requires walking `ProviderRegistry`, which is
+ * a module-private map populated by side-effecting calls in consumer
+ * code. Standalone `runDoctor()` invoked from a different process won't
+ * see those registrations. Two consumer paths:
+ *
+ * 1. Consumers running doctor in their own process via `runDoctor()`
+ *    can register a custom provider check that iterates their
+ *    `ProviderRegistry.getAll()` and calls `provider.doctorCheck?.()`
+ *    on each.
+ * 2. The standalone `namzu doctor` CLI command (Phase 5) inherits
+ *    this same behavior — it can only check providers that are visible
+ *    to its process. Plugin-registered providers ARE visible.
+ */
+export declare const providersRegisteredCheck: DoctorCheck;
+//# sourceMappingURL=providers.d.ts.map

package/dist/doctor/checks/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../../src/doctor/checks/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,YAAY,CAAA;AAEhE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,wBAAwB,EAAE,WAQtC,CAAA"}

package/dist/doctor/checks/providers.js

@@ -0,0 +1,25 @@
+/**
+ * Built-in provider probe is intentionally inconclusive in v1.
+ *
+ * Provider auto-discovery requires walking `ProviderRegistry`, which is
+ * a module-private map populated by side-effecting calls in consumer
+ * code. Standalone `runDoctor()` invoked from a different process won't
+ * see those registrations. Two consumer paths:
+ *
+ * 1. Consumers running doctor in their own process via `runDoctor()`
+ *    can register a custom provider check that iterates their
+ *    `ProviderRegistry.getAll()` and calls `provider.doctorCheck?.()`
+ *    on each.
+ * 2. The standalone `namzu doctor` CLI command (Phase 5) inherits
+ *    this same behavior — it can only check providers that are visible
+ *    to its process. Plugin-registered providers ARE visible.
+ */
+export const providersRegisteredCheck = {
+    id: 'providers.registered',
+    category: 'providers',
+    run: async () => ({
+        status: 'inconclusive',
+        message: 'no provider auto-discovery in v1; register a provider check via registerDoctorCheck for your specific provider configuration (call provider.doctorCheck?() per registered provider)',
+    }),
+};
+//# sourceMappingURL=providers.js.map

package/dist/doctor/checks/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../../src/doctor/checks/providers.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAgB;IACpD,EAAE,EAAE,sBAAsB;IAC1B,QAAQ,EAAE,WAAW;IACrB,GAAG,EAAE,KAAK,IAAgC,EAAE,CAAC,CAAC;QAC7C,MAAM,EAAE,cAAc;QACtB,OAAO,EACN,qLAAqL;KACtL,CAAC;CACF,CAAA"}

package/dist/doctor/checks/runtime.d.ts

@@ -0,0 +1,4 @@
+import type { DoctorCheck } from '@namzu/sdk';
+export declare const cwdWritableCheck: DoctorCheck;
+export declare const tmpdirWritableCheck: DoctorCheck;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/doctor/checks/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/doctor/checks/runtime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAyC,MAAM,YAAY,CAAA;AAEpF,eAAO,MAAM,gBAAgB,EAAE,WAgB9B,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,WAiBjC,CAAA"}

package/dist/doctor/checks/runtime.js

@@ -0,0 +1,40 @@
+import { constants, access } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+export const cwdWritableCheck = {
+    id: 'runtime.cwd-writable',
+    category: 'runtime',
+    run: async (ctx) => {
+        try {
+            await access(ctx.cwd, constants.W_OK);
+            return { status: 'pass', message: `cwd writable: ${ctx.cwd}` };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                status: 'fail',
+                message: `cwd not writable: ${ctx.cwd} (${message})`,
+                remediation: 'Run from a directory you have write access to, or pass an explicit cwd.',
+            };
+        }
+    },
+};
+export const tmpdirWritableCheck = {
+    id: 'runtime.tmpdir-writable',
+    category: 'runtime',
+    run: async () => {
+        const dir = tmpdir();
+        try {
+            await access(dir, constants.W_OK);
+            return { status: 'pass', message: `tmpdir writable: ${dir}` };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                status: 'fail',
+                message: `tmpdir not writable: ${dir} (${message})`,
+                remediation: 'Set TMPDIR / TMP / TEMP to a writable location.',
+            };
+        }
+    },
+};
+//# sourceMappingURL=runtime.js.map

package/dist/doctor/checks/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/doctor/checks/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAIhC,MAAM,CAAC,MAAM,gBAAgB,GAAgB;IAC5C,EAAE,EAAE,sBAAsB;IAC1B,QAAQ,EAAE,SAAS;IACnB,GAAG,EAAE,KAAK,EAAE,GAAuB,EAA8B,EAAE;QAClE,IAAI,CAAC;YACJ,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;YACrC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,CAAC,GAAG,EAAE,EAAE,CAAA;QAC/D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACtE,OAAO;gBACN,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,qBAAqB,GAAG,CAAC,GAAG,KAAK,OAAO,GAAG;gBACpD,WAAW,EAAE,yEAAyE;aACtF,CAAA;QACF,CAAC;IACF,CAAC;CACD,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC/C,EAAE,EAAE,yBAAyB;IAC7B,QAAQ,EAAE,SAAS;IACnB,GAAG,EAAE,KAAK,IAAgC,EAAE;QAC3C,MAAM,GAAG,GAAG,MAAM,EAAE,CAAA;QACpB,IAAI,CAAC;YACJ,MAAM,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;YACjC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,EAAE,EAAE,CAAA;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YACtE,OAAO;gBACN,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,wBAAwB,GAAG,KAAK,OAAO,GAAG;gBACnD,WAAW,EAAE,iDAAiD;aAC9D,CAAA;QACF,CAAC;IACF,CAAC;CACD,CAAA"}

package/dist/doctor/checks/sandbox.d.ts

@@ -0,0 +1,3 @@
+import type { DoctorCheck } from '@namzu/sdk';
+export declare const sandboxPlatformCheck: DoctorCheck;
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/doctor/checks/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../../src/doctor/checks/sandbox.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,YAAY,CAAA;AAIhE,eAAO,MAAM,oBAAoB,EAAE,WAsClC,CAAA"}

package/dist/doctor/checks/sandbox.js

@@ -0,0 +1,42 @@
+import { constants, access } from 'node:fs/promises';
+const DARWIN_SANDBOX_EXEC = '/usr/bin/sandbox-exec';
+export const sandboxPlatformCheck = {
+    id: 'sandbox.platform',
+    category: 'sandbox',
+    run: async () => {
+        const platform = process.platform;
+        switch (platform) {
+            case 'darwin':
+                try {
+                    await access(DARWIN_SANDBOX_EXEC, constants.X_OK);
+                    return {
+                        status: 'pass',
+                        message: `darwin / ${DARWIN_SANDBOX_EXEC} present and executable`,
+                    };
+                }
+                catch {
+                    return {
+                        status: 'fail',
+                        message: `darwin / ${DARWIN_SANDBOX_EXEC} not executable`,
+                        remediation: 'macOS sandboxing requires sandbox-exec; check system integrity.',
+                    };
+                }
+            case 'linux':
+                return {
+                    status: 'inconclusive',
+                    message: 'linux sandbox capability probe (unshare + namespaces) not implemented in v1; register a custom check via registerDoctorCheck if you need it',
+                };
+            case 'win32':
+                return {
+                    status: 'warn',
+                    message: 'windows sandbox is not supported by @namzu/sdk today',
+                };
+            default:
+                return {
+                    status: 'inconclusive',
+                    message: `unrecognized platform "${platform}"`,
+                };
+        }
+    },
+};
+//# sourceMappingURL=sandbox.js.map