@cavuno/board 1.35.1 → 1.37.0

package/dist/{board-t_WltBBa.d.mts → board-D0guOBYy.d.mts}

@@ -1,4 +1,4 @@
-import { b as Schemas } from './jobs-Dq2a9oPj.mjs';
+import { b as Schemas } from './jobs-CMCADU_-.mjs';
 
 type PublicBoard = Schemas['PublicBoardContext'];
 type PublicBoardFeatures = PublicBoard['features'];

package/dist/{board-Z7hjKDp8.d.ts → board-D_BRa2zC.d.ts}

@@ -1,4 +1,4 @@
-import { b as Schemas } from './jobs-Dq2a9oPj.js';
+import { b as Schemas } from './jobs-CMCADU_-.js';
 
 type PublicBoard = Schemas['PublicBoardContext'];
 type PublicBoardFeatures = PublicBoard['features'];

package/dist/doctor.d.mts

@@ -0,0 +1,59 @@
+/**
+ * Doctor check primitives (ADR-0058 Wave B): the pure logic behind
+ * `npx @cavuno/board doctor` — env validation, JSON-LD extraction,
+ * sitemap parsing, and the pass/fail/skip summary. Everything here is
+ * synchronous and I/O-free so it unit-tests without a network; the
+ * orchestrator in run.ts owns the fetches.
+ */
+type CheckStatus = 'pass' | 'fail' | 'skip';
+interface CheckResult {
+    id: string;
+    /** 1 static · 2 read probes · 3 write probes (sandbox-only). */
+    tier: 1 | 2 | 3;
+    status: CheckStatus;
+    detail: string;
+}
+interface DoctorEnv {
+    apiUrl?: string;
+    boardKey?: string;
+}
+interface DoctorSummary {
+    exitCode: 0 | 1;
+    passed: string[];
+    failed: string[];
+    skipped: string[];
+}
+
+/**
+ * Doctor orchestrator (ADR-0058 Wave B): tier-1 static checks (this
+ * file), tier-2 read probes (read.ts), and opt-in tier-3 write probes
+ * (writes.ts — sandbox-only, gated on the board context's `sandbox`
+ * flag). Each tier is a run/skip module pair dispatched the same way, so
+ * every check always appears in the results — unrun checks SKIP loudly,
+ * nothing silently vanishes. Fetch is injected for tests; the CLI passes
+ * global fetch.
+ */
+interface RunDoctorOptions {
+    env: DoctorEnv;
+    /** The tenant's frontend base URL (`--frontend`). Read tier skips loudly without it. */
+    frontendUrl?: string;
+    /** Consumer project root for the skills-freshness check. Default: cwd. */
+    projectRoot?: string;
+    fetchImpl?: typeof fetch;
+    /**
+     * Enable tier-3 write probes (`--sandbox`). The probes themselves gate
+     * on the resolved board's `sandbox` flag; this option only opts in.
+     */
+    sandbox?: boolean;
+    /** Platform-operator Resend credential for the email-boundary check. */
+    resendApiKey?: string;
+    /** Test override for the per-run probe identity. */
+    writeProbeNonce?: string;
+}
+interface DoctorRun {
+    results: CheckResult[];
+    summary: DoctorSummary;
+}
+declare function runDoctor(options: RunDoctorOptions): Promise<DoctorRun>;
+
+export { type CheckResult, type CheckStatus, type DoctorEnv, type DoctorRun, type DoctorSummary, type RunDoctorOptions, runDoctor };

package/dist/doctor.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Doctor check primitives (ADR-0058 Wave B): the pure logic behind
+ * `npx @cavuno/board doctor` — env validation, JSON-LD extraction,
+ * sitemap parsing, and the pass/fail/skip summary. Everything here is
+ * synchronous and I/O-free so it unit-tests without a network; the
+ * orchestrator in run.ts owns the fetches.
+ */
+type CheckStatus = 'pass' | 'fail' | 'skip';
+interface CheckResult {
+    id: string;
+    /** 1 static · 2 read probes · 3 write probes (sandbox-only). */
+    tier: 1 | 2 | 3;
+    status: CheckStatus;
+    detail: string;
+}
+interface DoctorEnv {
+    apiUrl?: string;
+    boardKey?: string;
+}
+interface DoctorSummary {
+    exitCode: 0 | 1;
+    passed: string[];
+    failed: string[];
+    skipped: string[];
+}
+
+/**
+ * Doctor orchestrator (ADR-0058 Wave B): tier-1 static checks (this
+ * file), tier-2 read probes (read.ts), and opt-in tier-3 write probes
+ * (writes.ts — sandbox-only, gated on the board context's `sandbox`
+ * flag). Each tier is a run/skip module pair dispatched the same way, so
+ * every check always appears in the results — unrun checks SKIP loudly,
+ * nothing silently vanishes. Fetch is injected for tests; the CLI passes
+ * global fetch.
+ */
+interface RunDoctorOptions {
+    env: DoctorEnv;
+    /** The tenant's frontend base URL (`--frontend`). Read tier skips loudly without it. */
+    frontendUrl?: string;
+    /** Consumer project root for the skills-freshness check. Default: cwd. */
+    projectRoot?: string;
+    fetchImpl?: typeof fetch;
+    /**
+     * Enable tier-3 write probes (`--sandbox`). The probes themselves gate
+     * on the resolved board's `sandbox` flag; this option only opts in.
+     */
+    sandbox?: boolean;
+    /** Platform-operator Resend credential for the email-boundary check. */
+    resendApiKey?: string;
+    /** Test override for the per-run probe identity. */
+    writeProbeNonce?: string;
+}
+interface DoctorRun {
+    results: CheckResult[];
+    summary: DoctorSummary;
+}
+declare function runDoctor(options: RunDoctorOptions): Promise<DoctorRun>;
+
+export { type CheckResult, type CheckStatus, type DoctorEnv, type DoctorRun, type DoctorSummary, type RunDoctorOptions, runDoctor };