@winspan/claude-forge 8.54.3 → 9.2.0

package/dist/core/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;;GAMG;AACH,SAAS,aAAa;IACpB,OAAO;QACL,OAAO,EAAE;YACP,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE;YAC5B,WAAW,EAAE,QAAQ,CAAC,mBAAmB;SAC1C;QACD,GAAG,EAAE;YACH,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,QAAQ,CAAC,QAAQ;SACxB;QACD,QAAQ,EAAE;YACR,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,IAAI;YAClB,aAAa,EAAE,IAAI;YACnB,iBAAiB,EAAE,GAAG;SACvB;KACF,CAAC;AACJ,CAAC;AAcD;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,GAAuB,IAAI,CAAC;IACzB,UAAU,CAAS;IAEpC,YAAY,UAAmB;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;IACvD,CAAC;IAED;;;;;;OAMG;IACH,GAAG;QACD,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QAEpC,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;QAEjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;YACvB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAsD,CAAC;YAEnF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC1C,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;gBACvB,OAAO,IAAI,CAAC,MAAM,CAAC;YACrB,CAAC;YAED,IAAI,CAAC,MAAM,GAAG;gBACZ,OAAO,EAAE,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE;gBACnD,GAAG,EAAE,EAAE,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE;gBACvC,QAAQ,EAAE,EAAE,GAAG,QAAQ,CAAC,QAAS,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE;aACzC,CAAC;YAEjB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;YACvB,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI;QACF,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/core/constants.d.ts

@@ -13,40 +13,41 @@ export declare const FORGE_PATHS: {
     readonly daemonLog: () => string;
     readonly daemonStdout: () => string;
     readonly daemonStderr: () => string;
+    readonly bypassToken: () => string;
     readonly hooks: () => string;
     readonly queue: () => string;
     readonly queueDead: () => string;
+    readonly daemonHeartbeat: () => string;
     readonly routingYaml: () => string;
     readonly backups: (kind: "skills" | "routing") => string;
     readonly skillCandidates: (source?: string) => string;
     readonly skillUpgradeReport: () => string;
 };
-/**
- * Time constants in milliseconds
- */
-export declare const TIME: {
-    readonly SECOND: 1000;
-    readonly MINUTE: 60000;
-    readonly HOUR: 3600000;
-    readonly DAY: 86400000;
-    readonly WEEK: 604800000;
-};
 /**
  * Database defaults
+ *
+ * CACHE_SIZE: SQLite interprets negative values as KB. -65_536 = 64 MB.
+ * Rationale (audit 2026-05-26): live DB sits at 269 MB; previous 2 MB cache
+ * covered only ~0.74% of the working set. 64 MB gives ~24% headroom for the
+ * hot pages (sessions / recent events / indexes) without bloating RSS for
+ * lightweight CLI invocations (mmap_size = 30 GB already lets the kernel
+ * page in whatever is cold; the cache buys us write-locality + read-coalesce).
  */
 export declare const DATABASE: {
     readonly DEFAULT_PATH: string;
     readonly WAL_MODE: "wal";
     readonly BUSY_TIMEOUT: 5000;
-    readonly CACHE_SIZE: -2000;
+    readonly CACHE_SIZE: -65536;
 };
 /**
  * Default config values
  */
 export declare const DEFAULTS: {
-    readonly AI_MODEL: "claude-sonnet-4-6";
-    readonly AI_PROVIDER: "anthropic";
     readonly STORAGE_MAX_SIZE_MB: 500;
     readonly WEB_PORT: 3721;
+    /** Heartbeat write interval (ms) — every 60 seconds */
+    readonly HEARTBEAT_INTERVAL_MS: 60000;
+    /** Heartbeat stale threshold (ms) — 3 minutes without a write = stale */
+    readonly HEARTBEAT_STALE_MS: 180000;
 };
 //# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,UAAU,QAAmC,CAAC;AAE3D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;6BAqBD,QAAQ,GAAG,SAAS;wCACd,MAAM;;CAKzB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,IAAI;;;;;;CAMP,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,UAAU,QAAmC,CAAC;AAE3D,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;6BA4BD,QAAQ,GAAG,SAAS;wCACd,MAAM;;CAKzB,CAAC;AAEX;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ;;;;;CAKX,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;;;IAMnB,uDAAuD;;IAEvD,yEAAyE;;CAEjE,CAAC"}

package/dist/core/constants.js

@@ -16,10 +16,15 @@ export const FORGE_PATHS = {
     daemonLog: () => join(FORGE_HOME, 'daemon.log'),
     daemonStdout: () => join(FORGE_HOME, 'daemon-stdout.log'),
     daemonStderr: () => join(FORGE_HOME, 'daemon-stderr.log'),
+    // ── Enforcement bypass token (Phase 2c safety-net #2) ──
+    // Mode-0600 JSON file consumed by PreToolUseHandler. Written by `cf bypass`.
+    bypassToken: () => join(FORGE_HOME, 'bypass.token'),
     // ── Subdirs ─────────────────────────────────────────────
     hooks: () => join(FORGE_HOME, 'hooks'),
     queue: () => join(FORGE_HOME, 'queue'),
     queueDead: () => join(FORGE_HOME, 'queue', 'dead'),
+    // ── Watchdog / heartbeat ─────────────────────────────────
+    daemonHeartbeat: () => join(FORGE_HOME, 'daemon.heartbeat'),
     // ── Patchable targets ───────────────────────────────────
     routingYaml: () => join(FORGE_HOME, 'routing.yaml'),
     backups: (kind) => join(FORGE_HOME, 'backups', kind),
@@ -28,32 +33,34 @@ export const FORGE_PATHS = {
         : join(FORGE_HOME, 'skill-candidates'),
     skillUpgradeReport: () => join(FORGE_HOME, 'skill-upgrade-report.md'),
 };
-/**
- * Time constants in milliseconds
- */
-export const TIME = {
-    SECOND: 1_000,
-    MINUTE: 60_000,
-    HOUR: 3_600_000,
-    DAY: 86_400_000,
-    WEEK: 604_800_000,
-};
 /**
  * Database defaults
+ *
+ * CACHE_SIZE: SQLite interprets negative values as KB. -65_536 = 64 MB.
+ * Rationale (audit 2026-05-26): live DB sits at 269 MB; previous 2 MB cache
+ * covered only ~0.74% of the working set. 64 MB gives ~24% headroom for the
+ * hot pages (sessions / recent events / indexes) without bloating RSS for
+ * lightweight CLI invocations (mmap_size = 30 GB already lets the kernel
+ * page in whatever is cold; the cache buys us write-locality + read-coalesce).
  */
 export const DATABASE = {
     DEFAULT_PATH: FORGE_PATHS.database(),
     WAL_MODE: 'wal',
     BUSY_TIMEOUT: 5_000,
-    CACHE_SIZE: -2_000, // 2MB
+    CACHE_SIZE: -65_536, // 64 MB (was -2_000 / 2 MB before 2026-05-26 perf PR)
 };
 /**
  * Default config values
  */
 export const DEFAULTS = {
-    AI_MODEL: 'claude-sonnet-4-6',
-    AI_PROVIDER: 'anthropic',
+    // D R-D (2026-05-29, spec 0902): legacy `AI_MODEL` / `AI_PROVIDER` defaults
+    // deleted. AI flows now use the user's Claude Code OAuth keychain via
+    // `claude` CLI shell-out — daemon does not pick the upstream model.
     STORAGE_MAX_SIZE_MB: 500,
     WEB_PORT: 3721,
+    /** Heartbeat write interval (ms) — every 60 seconds */
+    HEARTBEAT_INTERVAL_MS: 60_000,
+    /** Heartbeat stale threshold (ms) — 3 minutes without a write = stale */
+    HEARTBEAT_STALE_MS: 180_000,
 };
 //# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC;AAE3D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU;IACtB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC;IAC7C,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC;IAC3C,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC;IAEpC,2DAA2D;IAC3D,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC;IACnD,SAAS,EAAK,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;IAClD,WAAW,EAAG,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC;IACpD,SAAS,EAAK,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;IAClD,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzD,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC;IAEzD,2DAA2D;IAC3D,KAAK,EAAS,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7C,KAAK,EAAS,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7C,SAAS,EAAK,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;IAErD,2DAA2D;IAC3D,WAAW,EAAG,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC;IACpD,OAAO,EAAO,CAAC,IAA0B,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC;IAC/E,eAAe,EAAE,CAAC,MAAe,EAAE,EAAE,CACnC,MAAM;QACJ,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,EAAE,MAAM,CAAC;QAC9C,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAC1C,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,yBAAyB,CAAC;CAC7D,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,MAAM,EAAE,KAAK;IACb,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,WAAW;CACT,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,YAAY,EAAE,WAAW,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM;CAClB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,WAAW;IACxB,mBAAmB,EAAE,GAAG;IACxB,QAAQ,EAAE,IAAI;CACN,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC;AAE3D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU;IACtB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC;IAC7C,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC;IAC3C,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC;IAEpC,2DAA2D;IAC3D,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC;IACnD,SAAS,EAAK,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;IAClD,WAAW,EAAG,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC;IACpD,SAAS,EAAK,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC;IAClD,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzD,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC;IAEzD,0DAA0D;IAC1D,6EAA6E;IAC7E,WAAW,EAAG,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC;IAEpD,2DAA2D;IAC3D,KAAK,EAAS,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7C,KAAK,EAAS,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7C,SAAS,EAAK,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;IAErD,4DAA4D;IAC5D,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAE3D,2DAA2D;IAC3D,WAAW,EAAG,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC;IACpD,OAAO,EAAO,CAAC,IAA0B,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC;IAC/E,eAAe,EAAE,CAAC,MAAe,EAAE,EAAE,CACnC,MAAM;QACJ,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,EAAE,MAAM,CAAC;QAC9C,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC;IAC1C,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,yBAAyB,CAAC;CAC7D,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,YAAY,EAAE,WAAW,CAAC,QAAQ,EAAE;IACpC,QAAQ,EAAE,KAAK;IACf,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,CAAC,MAAM,EAAE,sDAAsD;CACnE,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,4EAA4E;IAC5E,sEAAsE;IACtE,oEAAoE;IACpE,mBAAmB,EAAE,GAAG;IACxB,QAAQ,EAAE,IAAI;IACd,uDAAuD;IACvD,qBAAqB,EAAE,MAAM;IAC7B,yEAAyE;IACzE,kBAAkB,EAAE,OAAO;CACnB,CAAC"}

package/dist/core/diagnostics/checks.d.ts

@@ -0,0 +1,151 @@
+/**
+ * cf doctor — 9-check diagnostic engine (spec 1a41b43a).
+ *
+ * Pure module: CLI (`cf doctor`) and Web (`GET /api/diagnostics`) both consume
+ * `runChecks()` here, avoiding child_process spawns and circular deps between
+ * `src/cli/` and `src/web/`.
+ *
+ * Each check returns a `CheckResult` describing pass/warn/fail status, a
+ * short human message, optional details, and a fix hint. The set of checks
+ * automatically fixable by `cf fix` is enumerated in `FIXABLE_COMMANDS`.
+ *
+ * Marker schema (spec 1, frozen): `readSystemMarker()` / `readProjectMarker()`
+ * from `./markers.js` — DO NOT modify.
+ *
+ * @see docs/design/2026-06-01/1030-cf-doctor-diagnostic-spec.md
+ */
+import type DatabaseT from 'better-sqlite3';
+type SqliteDriver = new (filename: string, options?: DatabaseT.Options) => DatabaseT.Database;
+export type CheckStatus = 'pass' | 'warn' | 'fail' | 'skip';
+export type FixableBy = 'cf fix' | 'manual';
+export interface CheckResult {
+    /** Stable id 1-9 used to filter / cross-link with `cf fix`. */
+    id: number;
+    /** Stable short name (snake-case-with-hyphens). */
+    name: string;
+    status: CheckStatus;
+    /** Single-line human message. */
+    message: string;
+    /** Optional multi-line detail (e.g. error stack). */
+    details?: string;
+    /** Suggested fix command for the user. */
+    fix_hint?: string;
+    /** Whether `cf fix` can auto-apply the fix, or it requires manual action. */
+    fixable_by?: FixableBy;
+}
+export interface CheckSummary {
+    pass: number;
+    warn: number;
+    fail: number;
+    skip: number;
+    fixable: number;
+}
+export interface DoctorReport {
+    summary: CheckSummary;
+    checks: CheckResult[];
+    generated_at: string;
+}
+export interface RunChecksOptions {
+    /** Restrict to a subset of checks by id. Empty / undefined runs all. */
+    ids?: number[];
+    /**
+     * Override cwd for project-scoped checks (5, 6).
+     *
+     * - `undefined` (CLI default): use `process.cwd()` — keeps `cf doctor`
+     *   behaviour when invoked from a project root.
+     * - `null` (Web fresh-install): no project context known — checks 5/6 must
+     *   emit `status: 'skip'` with a friendly message instead of FAILing against
+     *   the daemon's cwd. This is the P0 safety contract for spec e5b845c4.
+     * - string: explicit project root (Web "most recent project" pick).
+     */
+    cwd?: string | null;
+    /** Override FORGE_HOME for hermetic tests. */
+    forgeHome?: string;
+    /** Override platform for tests (defaults to process.platform). */
+    platform?: NodeJS.Platform;
+    /** Override better-sqlite3 driver for tests. */
+    sqliteDriver?: () => Promise<SqliteDriver>;
+    /**
+     * spec 8cbecdb4 / OQ #3: when the diagnostics report is generated from
+     * inside the daemon's own process (Web `/api/diagnostics`), check 1 must
+     * self-introspect via `process.pid` + in-memory heartbeat rather than
+     * probing the pidfile. The pidfile may legitimately be stale right after
+     * a launchd respawn, which previously surfaced as a false-positive FAIL.
+     *
+     * - `false` / `undefined` (CLI default): external observation via pidfile.
+     * - `true` (Web path): use {@link getDaemonSelfStatus}; check 1 always
+     *   reports PASS unless the heartbeat is stale.
+     */
+    selfMode?: boolean;
+}
+/**
+ * Whitelist of checks `cf fix` can auto-apply. Any check NOT in this map is
+ * considered manual-only (we do not synthesize new commands at runtime).
+ *
+ * Tests guarantee that every key here corresponds to a real check id, so the
+ * registry stays in sync.
+ */
+export declare const FIXABLE_COMMANDS: Record<number, string>;
+interface Check1Deps {
+    readPid: (p: string) => string | null;
+    kill0: (pid: number) => boolean;
+    pidFile: string;
+    /**
+     * spec 8cbecdb4 / OQ #3: when true, skip pidfile probing and use
+     * {@link getDaemonSelfStatus} (in-process introspection). Web `/api/diagnostics`
+     * sets this to avoid false-positive FAILs after launchd respawn.
+     */
+    selfMode: boolean;
+}
+export declare function check1_daemonProcess(deps?: Partial<Check1Deps>): Promise<CheckResult>;
+interface Check2Deps {
+    socketPath: string;
+    /** Connect to socket with a short timeout, resolving true on connect. */
+    tryConnect?: (p: string, timeoutMs: number) => Promise<boolean>;
+}
+export declare function check2_daemonSocket(deps?: Partial<Check2Deps>): Promise<CheckResult>;
+interface Check3Deps {
+    platform: NodeJS.Platform;
+    /** Returns launchd status; should match LaunchdStatus shape. */
+    launchdStatus?: () => {
+        installed: boolean;
+        loaded: boolean;
+        pid: number | null;
+        state: string | null;
+    };
+}
+export declare function check3_launchdAgent(deps?: Partial<Check3Deps>): Promise<CheckResult>;
+interface Check4Deps {
+    settingsPath: string;
+    readFile: (p: string) => string | null;
+}
+export declare function check4_hooksInjected(deps?: Partial<Check4Deps>): Promise<CheckResult>;
+export declare function check5_projectClaudemd(opts?: {
+    cwd?: string | null;
+}): Promise<CheckResult>;
+export declare function check6_projectKnowledge(opts?: {
+    cwd?: string | null;
+}): Promise<CheckResult>;
+interface Check7Deps {
+    dbPath: string;
+    /** Pluggable driver loader for tests. */
+    load?: () => Promise<SqliteDriver>;
+}
+export declare function check7_dbIntegrity(deps?: Partial<Check7Deps>): Promise<CheckResult>;
+interface Check8Deps {
+    configPath: string;
+    readFile: (p: string) => string | null;
+}
+export declare function check8_configYaml(deps?: Partial<Check8Deps>): Promise<CheckResult>;
+interface Check9Deps {
+    dbPath: string;
+    load?: () => Promise<SqliteDriver>;
+    /** Override "now" for deterministic tests. */
+    now?: () => number;
+}
+export declare function check9_recentActivity(deps?: Partial<Check9Deps>): Promise<CheckResult>;
+export declare function runChecks(opts?: RunChecksOptions): Promise<CheckResult[]>;
+export declare function summarize(checks: CheckResult[]): CheckSummary;
+export declare function runDoctorReport(opts?: RunChecksOptions): Promise<DoctorReport>;
+export {};
+//# sourceMappingURL=checks.d.ts.map

package/dist/core/diagnostics/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../../../src/core/diagnostics/checks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAW5C,KAAK,YAAY,GAAG,KAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,KACxB,SAAS,CAAC,QAAQ,CAAC;AAIxB,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAC5D,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf;;;;;;;;;OASG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAMnD,CAAC;AAIF,UAAU,UAAU;IAClB,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACtC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;CACnB;AAmBD,wBAAsB,oBAAoB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAwD3F;AAID,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACjE;AA4BD,wBAAsB,mBAAmB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAiC1F;AAID,UAAU,UAAU;IAClB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM;QACpB,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,EAAE,OAAO,CAAC;QAChB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;QACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC;CACH;AAED,wBAAsB,mBAAmB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAiE1F;AAYD,UAAU,UAAU;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,wBAAsB,oBAAoB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAsE3F;AAMD,wBAAsB,sBAAsB,CAAC,IAAI,CAAC,EAAE;IAClD,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,GAAG,OAAO,CAAC,WAAW,CAAC,CAuDvB;AAID,wBAAsB,uBAAuB,CAAC,IAAI,CAAC,EAAE;IACnD,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,GAAG,OAAO,CAAC,WAAW,CAAC,CA2DvB;AAID,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;CACpC;AAED,wBAAsB,kBAAkB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CA8EzF;AAMD,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,wBAAsB,iBAAiB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAiDxF;AAID,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IACnC,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAgF5F;AA6DD,wBAAsB,SAAS,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA2B/E;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY,CAS7D;AAED,wBAAsB,eAAe,CAAC,IAAI,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAOpF"}