@cleocode/contracts 2026.5.90 → 2026.5.93

package/dist/docs-taxonomy.js

@@ -0,0 +1,489 @@
+/**
+ * Canonical Doc-Kind Taxonomy Registry (T9788).
+ *
+ * Single source of truth for the user-facing document-kind taxonomy consumed
+ * by `cleo docs` (add / list / publish-pr / list-types / schema). Prior to
+ * this module the taxonomy was duplicated across three files:
+ *
+ * - `packages/contracts/src/operations/docs.ts` — `DOCS_TYPE_VALUES` (6 kinds)
+ * - `packages/core/src/docs/publish-pr.ts` — `KNOWN_DOC_TYPES` (6 kinds)
+ * - `packages/cleo/src/dispatch/domains/docs.ts` — local mirror (6 kinds)
+ *
+ * The three copies drifted independently. T9788 consolidates them behind
+ * {@link DocKindRegistry} so a new kind requires editing exactly one place
+ * (or one config file for project-level extensions).
+ *
+ * IMPORTANT — relationship to {@link import('./docs-accessor.js').DocKind}:
+ * `DocKind` in `docs-accessor.ts` is the STORAGE-LAYER discriminator (which
+ * backing store holds the bytes — llmtxt.db vs manifest.db). The taxonomy
+ * here is the USER-FACING DOCUMENT CLASSIFICATION (what kind of document
+ * the human / agent authored). The two are intentionally distinct:
+ *
+ * - `docs-accessor.DocKind` answers "where is it stored?"
+ * - `docs-taxonomy.DocKindMetadata.kind` answers "what is it about?"
+ *
+ * Most user-facing docs are stored under `docs-accessor.DocKind = 'adr'` or
+ * `'agent-output'`; their taxonomy `kind` (this file) carries the semantic
+ * classification.
+ *
+ * Backward compatibility (T9788 AC8):
+ * - Every prior `DOCS_TYPE_VALUES` value remains in {@link BUILTIN_DOC_KINDS}.
+ * - Tests using literal strings `'spec'`, `'adr'`, etc. continue to pass.
+ * - The stored `type` column shape is unchanged (still a string).
+ *
+ * @epic T9787 (E-DOCS-TAXONOMY-V2)
+ * @task T9788
+ * @see ADR-073 §1 — Task Hierarchy Charter (sibling registry pattern)
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Built-in registry (10 canonical kinds)
+// ---------------------------------------------------------------------------
+/**
+ * Canonical list of built-in document kinds.
+ *
+ * Adding a kind requires:
+ *   1. Append an entry here (preserving existing kinds for back-compat).
+ *   2. Run the contracts build — every consumer picks the new kind up.
+ *
+ * Order is preserved by {@link DocKindRegistry.list}. Built-in kinds
+ * always sort before extensions.
+ *
+ * @see {@link DocKindMetadata} — entry shape
+ */
+export const BUILTIN_DOC_KINDS = [
+    {
+        kind: 'adr',
+        label: 'ADR',
+        description: 'Architectural decision record',
+        defaultOwnerKind: 'task',
+        publishDir: 'docs/adr',
+        requiresEntityId: true,
+        entityIdPattern: /^adr-\d{3,4}-[a-z0-9-]+$/,
+    },
+    {
+        kind: 'spec',
+        label: 'Spec',
+        description: 'Technical specification',
+        defaultOwnerKind: 'task',
+        publishDir: 'docs/spec',
+        requiresEntityId: false,
+    },
+    {
+        kind: 'research',
+        label: 'Research',
+        description: 'Investigation / research note',
+        defaultOwnerKind: 'task',
+        publishDir: 'docs/research',
+        requiresEntityId: false,
+    },
+    {
+        kind: 'handoff',
+        label: 'Handoff',
+        description: 'Session / agent handoff',
+        defaultOwnerKind: 'session',
+        publishDir: 'docs/handoff',
+        requiresEntityId: false,
+    },
+    {
+        kind: 'note',
+        label: 'Note',
+        description: 'Agent observation / informal note',
+        defaultOwnerKind: 'observation',
+        publishDir: 'docs/note',
+        requiresEntityId: false,
+    },
+    {
+        kind: 'llm-readme',
+        label: 'LLM README',
+        description: 'Machine-readable README (llms.txt)',
+        defaultOwnerKind: 'project',
+        publishDir: '.',
+        requiresEntityId: false,
+    },
+    {
+        kind: 'changeset',
+        label: 'Changeset',
+        description: 'Atomic change entry (release-note input)',
+        defaultOwnerKind: 'task',
+        publishDir: '.changeset',
+        requiresEntityId: true,
+        entityIdPattern: /^t\d+-[a-z0-9-]+$/,
+    },
+    {
+        kind: 'release-note',
+        label: 'Release Note',
+        description: 'Composed release notes',
+        defaultOwnerKind: 'project',
+        publishDir: 'docs/release',
+        requiresEntityId: true,
+        entityIdPattern: /^v\d{4}\.\d+\.\d+(-[a-z0-9-]+)?$/,
+    },
+    {
+        kind: 'plan',
+        label: 'Plan',
+        description: 'Epic / saga decomposition plan',
+        defaultOwnerKind: 'task',
+        publishDir: 'docs/plan',
+        requiresEntityId: false,
+    },
+    {
+        kind: 'rcasd',
+        label: 'RCASD',
+        description: 'Root-cause analysis + scoped delivery',
+        defaultOwnerKind: 'task',
+        publishDir: '.cleo/rcasd',
+        requiresEntityId: true,
+        entityIdPattern: /^t\d+(-.+)?$/,
+    },
+];
+/**
+ * Tuple of every built-in kind id (lowercase kebab-case).
+ *
+ * Useful for `satisfies` checks and union derivation in downstream
+ * contracts (e.g. `operations/docs.ts`). Kept frozen.
+ */
+export const BUILTIN_DOC_KIND_VALUES = Object.freeze(BUILTIN_DOC_KINDS.map((d) => d.kind));
+// ---------------------------------------------------------------------------
+// Registry class
+// ---------------------------------------------------------------------------
+/**
+ * Runtime accessor for the canonical doc-kind registry.
+ *
+ * Combines {@link BUILTIN_DOC_KINDS} with project-level extensions loaded
+ * from `.cleo/docs-config.json`. Built-in entries always win on collision
+ * — extensions cannot override a built-in kind.
+ *
+ * Usage:
+ * ```ts
+ * const registry = DocKindRegistry.load(projectRoot);
+ * const adr = registry.get('adr');
+ * const check = registry.validateSlug('adr', 'adr-001-intro');
+ * ```
+ *
+ * @task T9788
+ */
+export class DocKindRegistry {
+    /**
+     * Maximum allowed length of an `entityIdPattern` source string.
+     *
+     * Caps the input surface so a malformed extension config cannot trigger
+     * pathological regex backtracking. 256 chars is far more than any
+     * realistic slug pattern (typical: 30–60 chars).
+     */
+    static SAFE_REGEX_LENGTH_LIMIT = 256;
+    byKind;
+    orderedEntries;
+    /**
+     * Construct a registry from an explicit array of entries.
+     *
+     * Most callers should use {@link DocKindRegistry.load} instead; this
+     * constructor is exposed for tests that want to bypass filesystem I/O.
+     *
+     * @param entries - Pre-validated doc-kind metadata (built-in + extensions).
+     */
+    constructor(entries) {
+        this.orderedEntries = entries;
+        const map = new Map();
+        for (const entry of entries) {
+            // First write wins; built-ins are passed first by `load`, so this
+            // automatically gives built-ins precedence over extensions.
+            if (!map.has(entry.kind))
+                map.set(entry.kind, entry);
+        }
+        this.byKind = map;
+    }
+    /**
+     * Load the canonical registry, merging built-ins with extensions from
+     * `<projectRoot>/.cleo/docs-config.json`.
+     *
+     * Missing or unreadable config file → returns the built-in-only registry.
+     * Malformed config (bad JSON, invalid entry, regex too long, etc.) →
+     * throws {@link DocKindConfigError} so the caller can surface a clear
+     * envelope rather than silently dropping extensions.
+     *
+     * @param projectRoot - Absolute path to the repo root.
+     * @throws DocKindConfigError when the config exists but is invalid.
+     */
+    static load(projectRoot) {
+        const configPath = join(projectRoot, '.cleo', 'docs-config.json');
+        let raw;
+        try {
+            raw = readFileSync(configPath, 'utf-8');
+        }
+        catch {
+            // No config file → built-ins only.
+            return new DocKindRegistry(BUILTIN_DOC_KINDS);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            throw new DocKindConfigError(`${configPath}: invalid JSON — ${err.message}`, configPath);
+        }
+        const config = validateDocKindConfig(parsed, configPath);
+        const extensions = (config.extensions ?? []).map((ext) => compileExtension(ext, configPath));
+        return new DocKindRegistry([...BUILTIN_DOC_KINDS, ...extensions]);
+    }
+    /**
+     * Build a registry from already-parsed config — bypasses filesystem I/O.
+     *
+     * Used by tests and HTTP-dispatch callers that hand-construct a config
+     * object instead of reading from disk.
+     *
+     * @param config - Parsed config object (or `undefined` for built-ins only).
+     * @param sourceLabel - Optional label used in error messages.
+     * @throws DocKindConfigError when the config object is invalid.
+     */
+    static fromConfig(config, sourceLabel = '<inline-config>') {
+        if (!config)
+            return new DocKindRegistry(BUILTIN_DOC_KINDS);
+        const validated = validateDocKindConfig(config, sourceLabel);
+        const extensions = (validated.extensions ?? []).map((ext) => compileExtension(ext, sourceLabel));
+        return new DocKindRegistry([...BUILTIN_DOC_KINDS, ...extensions]);
+    }
+    /**
+     * Default registry — built-in kinds only, no extensions.
+     *
+     * Suitable for code paths that never need project-level extensions
+     * (e.g. unit tests, library-mode consumers).
+     */
+    static builtinOnly() {
+        return new DocKindRegistry(BUILTIN_DOC_KINDS);
+    }
+    /** True when `kind` is registered (built-in OR extension). */
+    has(kind) {
+        return this.byKind.has(kind);
+    }
+    /** Look up metadata for a registered kind. Returns `undefined` on miss. */
+    get(kind) {
+        return this.byKind.get(kind);
+    }
+    /**
+     * List every registered kind, built-ins first then extensions in
+     * declaration order.
+     *
+     * Used by `cleo docs schema` and `cleo docs list-types`.
+     */
+    list() {
+        return this.orderedEntries;
+    }
+    /**
+     * Validate a slug against the registered pattern for `kind`.
+     *
+     * Behaviour:
+     * - Unknown kind → `{ ok: false, error: "unknown kind '<kind>'" }`.
+     * - Known kind with `requiresEntityId === false` → always `{ ok: true }`.
+     * - Known kind with `requiresEntityId === true` and no pattern → defensive
+     *   `{ ok: false }` since the registry entry is internally inconsistent.
+     * - Known kind with pattern → tests `slug` against the pattern.
+     *
+     * @param kind - Registered kind id.
+     * @param slug - Slug to validate.
+     * @returns Pass/fail result with a human-readable error on failure.
+     */
+    validateSlug(kind, slug) {
+        const meta = this.byKind.get(kind);
+        if (!meta) {
+            return { ok: false, error: `unknown kind '${kind}'` };
+        }
+        if (!meta.requiresEntityId) {
+            return { ok: true };
+        }
+        if (!meta.entityIdPattern) {
+            // Defensive: registry entry marked requiresEntityId but lacks the
+            // pattern. Built-in entries always carry one; an extension that
+            // omits it is rejected at load time, so this branch is reachable
+            // only via the public constructor with a hand-crafted array.
+            return {
+                ok: false,
+                error: `kind '${kind}' requires an entityIdPattern but the registry entry omits one`,
+            };
+        }
+        if (!meta.entityIdPattern.test(slug)) {
+            return {
+                ok: false,
+                error: `slug '${slug}' does not match pattern ${meta.entityIdPattern.source} for kind '${kind}'`,
+                example: buildSlugExample(meta),
+            };
+        }
+        return { ok: true };
+    }
+    /**
+     * Map a kind to its `publishDir` (e.g. `'adr'` → `'docs/adr'`).
+     *
+     * Returns `undefined` for unknown kinds — callers decide whether to
+     * fall back to a default (e.g. `'docs/note'`) or surface an error.
+     */
+    publishDirFor(kind) {
+        return this.byKind.get(kind)?.publishDir;
+    }
+}
+/**
+ * Error thrown by {@link DocKindRegistry.load} and
+ * {@link DocKindRegistry.fromConfig} when the supplied config is invalid.
+ *
+ * Carries the offending source path / label so the CLI surface can render
+ * a `details` payload pointing the user at the right file.
+ */
+export class DocKindConfigError extends Error {
+    /** Source identifier — file path on disk, or `<inline-config>` for tests. */
+    source;
+    constructor(message, source) {
+        super(message);
+        this.name = 'DocKindConfigError';
+        this.source = source;
+    }
+}
+// ---------------------------------------------------------------------------
+// Config validation helpers
+// ---------------------------------------------------------------------------
+/**
+ * Narrow an arbitrary parsed-JSON value to {@link DocKindConfigFile}.
+ *
+ * Performs structural validation only — regex compilation happens in
+ * {@link compileExtension}.
+ *
+ * @internal
+ */
+function validateDocKindConfig(raw, source) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        throw new DocKindConfigError(`${source}: top-level value must be an object`, source);
+    }
+    const obj = raw;
+    if (obj.extensions === undefined) {
+        return {};
+    }
+    if (!Array.isArray(obj.extensions)) {
+        throw new DocKindConfigError(`${source}: 'extensions' must be an array`, source);
+    }
+    const extensions = [];
+    for (let i = 0; i < obj.extensions.length; i++) {
+        const item = obj.extensions[i];
+        extensions.push(validateExtensionEntry(item, source, i));
+    }
+    return { extensions };
+}
+/**
+ * Narrow one extension entry from the parsed `extensions[]` array.
+ *
+ * @internal
+ */
+function validateExtensionEntry(raw, source, index) {
+    const where = `${source} extensions[${index}]`;
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+        throw new DocKindConfigError(`${where}: must be an object`, source);
+    }
+    const obj = raw;
+    const kind = requireString(obj, 'kind', where, source);
+    if (!/^[a-z][a-z0-9-]*$/.test(kind)) {
+        throw new DocKindConfigError(`${where}: 'kind' must be lowercase kebab-case (got '${kind}')`, source);
+    }
+    const builtinNames = new Set(BUILTIN_DOC_KIND_VALUES);
+    if (builtinNames.has(kind)) {
+        throw new DocKindConfigError(`${where}: kind '${kind}' shadows a built-in — built-ins cannot be overridden`, source);
+    }
+    const label = requireString(obj, 'label', where, source);
+    const description = requireString(obj, 'description', where, source);
+    const defaultOwnerKind = requireString(obj, 'defaultOwnerKind', where, source);
+    if (defaultOwnerKind !== 'task' &&
+        defaultOwnerKind !== 'session' &&
+        defaultOwnerKind !== 'observation' &&
+        defaultOwnerKind !== 'project') {
+        throw new DocKindConfigError(`${where}: 'defaultOwnerKind' must be task|session|observation|project (got '${defaultOwnerKind}')`, source);
+    }
+    const publishDir = requireString(obj, 'publishDir', where, source);
+    const requiresEntityId = obj.requiresEntityId;
+    if (typeof requiresEntityId !== 'boolean') {
+        throw new DocKindConfigError(`${where}: 'requiresEntityId' must be a boolean`, source);
+    }
+    let entityIdPattern;
+    if (obj.entityIdPattern !== undefined) {
+        if (typeof obj.entityIdPattern !== 'string') {
+            throw new DocKindConfigError(`${where}: 'entityIdPattern' must be a string`, source);
+        }
+        if (obj.entityIdPattern.length > DocKindRegistry.SAFE_REGEX_LENGTH_LIMIT) {
+            throw new DocKindConfigError(`${where}: 'entityIdPattern' exceeds ${DocKindRegistry.SAFE_REGEX_LENGTH_LIMIT} chars`, source);
+        }
+        entityIdPattern = obj.entityIdPattern;
+    }
+    if (requiresEntityId && entityIdPattern === undefined) {
+        throw new DocKindConfigError(`${where}: 'entityIdPattern' is required when 'requiresEntityId' is true`, source);
+    }
+    return {
+        kind,
+        label,
+        description,
+        defaultOwnerKind,
+        publishDir,
+        requiresEntityId,
+        ...(entityIdPattern !== undefined ? { entityIdPattern } : {}),
+    };
+}
+/**
+ * Compile an extension config into a `DocKindMetadata` (regex compiled,
+ * `isExtension` set).
+ *
+ * @internal
+ */
+function compileExtension(ext, source) {
+    let entityIdPattern;
+    if (ext.entityIdPattern !== undefined) {
+        try {
+            entityIdPattern = new RegExp(ext.entityIdPattern);
+        }
+        catch (err) {
+            throw new DocKindConfigError(`${source}: invalid regex for kind '${ext.kind}': ${err.message}`, source);
+        }
+    }
+    return {
+        kind: ext.kind,
+        label: ext.label,
+        description: ext.description,
+        defaultOwnerKind: ext.defaultOwnerKind,
+        publishDir: ext.publishDir,
+        requiresEntityId: ext.requiresEntityId,
+        ...(entityIdPattern !== undefined ? { entityIdPattern } : {}),
+        isExtension: true,
+    };
+}
+/**
+ * Extract a required string field from a parsed JSON object.
+ *
+ * @internal
+ */
+function requireString(obj, field, where, source) {
+    const value = obj[field];
+    if (typeof value !== 'string' || value.length === 0) {
+        throw new DocKindConfigError(`${where}: '${field}' must be a non-empty string`, source);
+    }
+    return value;
+}
+/**
+ * Build a best-effort example slug from a metadata entry's pattern.
+ *
+ * Used by {@link DocKindRegistry.validateSlug} to give the caller a
+ * concrete sample slug that would pass. Built-in patterns ship with
+ * hard-coded samples; extensions fall back to the pattern source.
+ *
+ * @internal
+ */
+function buildSlugExample(meta) {
+    // Hard-coded samples for built-in kinds keep the error message friendly.
+    // Extensions get the raw pattern as a fallback.
+    switch (meta.kind) {
+        case 'adr':
+            return 'adr-001-intro';
+        case 'changeset':
+            return 't9788-docs-taxonomy';
+        case 'release-note':
+            return 'v2026.5.93';
+        case 'rcasd':
+            return 't9788-investigation';
+        default:
+            return meta.entityIdPattern?.source;
+    }
+}
+//# sourceMappingURL=docs-taxonomy.js.map

package/dist/docs-taxonomy.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Doctor domain contracts — types for `cleo doctor` worktree-orphan audit/prune.
+ *
+ * These types describe orphan `.cleo/` directories left behind under
+ * `<projectRoot>/.claude/worktrees/` by the T9550/T9580 SSoT bug (fixed in
+ * v2026.5.83) and the schema for the audit JSONL line written per prune.
+ *
+ * Consumed by:
+ *   - `packages/core/src/doctor/worktree-orphans.ts` (scan + prune primitives)
+ *   - `packages/cleo/src/cli/commands/doctor.ts` (CLI flags)
+ *
+ * @task T9790
+ * @epic T9790
+ */
+/**
+ * One orphan `.cleo/` directory discovered under
+ * `<projectRoot>/.claude/worktrees/`.
+ *
+ * Worktrees are nested 1-3 levels deep — examples:
+ *   - `<projectRoot>/.claude/worktrees/agent-X/.cleo/`            (depth 1)
+ *   - `<projectRoot>/.claude/worktrees/agent-X/T9220/.cleo/`     (depth 2)
+ *
+ * Each entry carries full provenance so the operator can decide whether
+ * the orphan represents lost work before pruning.
+ */
+export interface OrphanEntry {
+    /**
+     * The worktree root that contains the orphan — the first directory under
+     * `.claude/worktrees/` (e.g. `<projectRoot>/.claude/worktrees/agent-X`).
+     * Used as the boundary that `pruneWorktreeOrphans` validates against.
+     */
+    worktreePath: string;
+    /**
+     * Absolute path to the orphan `.cleo/` directory itself. Always lives
+     * under `worktreePath` (the security check rejects anything that doesn't).
+     */
+    orphanPath: string;
+    /**
+     * List of `tasks.db`, `brain.db`, `nexus.db`, or `config.json` paths
+     * found inside the orphan. Empty array means the orphan exists but is
+     * structurally empty (still pruned — it shouldn't be there at all).
+     */
+    dbFiles: string[];
+    /** Total byte size of the orphan tree (sum of regular file sizes). */
+    sizeBytes: number;
+    /** ISO-8601 timestamp of the most recent file modification under the orphan. */
+    lastModifiedAt: string;
+    /**
+     * Seconds since `lastModifiedAt` (relative to scan time). Surfaces "stale
+     * vs recent" without forcing the caller to compute date math.
+     */
+    ageSeconds: number;
+    /**
+     * `true` when the orphan contains more than just stray DB files — e.g. a
+     * full duplicate of `adrs/`, `agent-outputs/`, `rcasd/`, etc. These need
+     * heightened operator review before pruning.
+     */
+    isFullDuplicate: boolean;
+}
+/**
+ * Result of one prune operation. Reports the archive location, the per-entry
+ * outcome, and any entries rejected by the security gate.
+ */
+export interface PruneResult {
+    /**
+     * Absolute path to the `.tar.gz` archive written before any deletion.
+     * `null` only when `dryRun: true` AND no archive was produced.
+     */
+    archivePath: string | null;
+    /** Whether this was a dry run (no archive, no rm, no audit-log line). */
+    dryRun: boolean;
+    /** Entries that were successfully pruned (or would be in dry-run mode). */
+    pruned: OrphanEntry[];
+    /**
+     * Entries that failed validation and were skipped. The `reason` is a
+     * stable machine-readable code (e.g. `path-outside-worktrees-root`,
+     * `path-not-found`, `rm-failed`).
+     */
+    rejected: Array<{
+        entry: OrphanEntry;
+        reason: string;
+    }>;
+    /** Total bytes archived (sum of `pruned[].sizeBytes`). */
+    totalSizeBytes: number;
+    /** ISO-8601 timestamp the prune completed. */
+    prunedAt: string;
+}
+/**
+ * One line appended to `.cleo/audit/worktree-prune.jsonl` per prune
+ * operation. Extends the existing audit-log schema (timestamp +
+ * worktreePath + action + agent) with the orphan-specific fields needed
+ * to reconstruct what was removed.
+ *
+ * Existing fields preserved for schema continuity:
+ *   - `timestamp`, `worktreePath`, `action`, `agent`
+ *
+ * New fields for orphan prune:
+ *   - `orphanPath`, `sizeBytes`, `dbFileCount`, `archivePath`, `dryRun`
+ */
+export interface PruneAuditEntry {
+    /** ISO-8601 timestamp. */
+    timestamp: string;
+    /** Worktree root that contained the orphan. */
+    worktreePath: string;
+    /** Absolute path to the orphan `.cleo/` directory removed. */
+    orphanPath: string;
+    /** Action code — fixed to `'prune-worktree-orphan'` for this flow. */
+    action: 'prune-worktree-orphan';
+    /** Always `'cleo'` — written by `cleo doctor`. */
+    agent: 'cleo';
+    /** Byte size of the pruned tree. */
+    sizeBytes: number;
+    /** Number of DB files found in the orphan (informational). */
+    dbFileCount: number;
+    /** Absolute path to the archive. `null` only on dry-run lines. */
+    archivePath: string | null;
+    /** Whether this entry represents a dry-run plan (no actual removal). */
+    dryRun: boolean;
+}
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAElB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAElB,gFAAgF;IAChF,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,yEAAyE;IACzE,MAAM,EAAE,OAAO,CAAC;IAEhB,2EAA2E;IAC3E,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAExD,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,EAAE,uBAAuB,CAAC;IAChC,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,wEAAwE;IACxE,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/doctor.js

@@ -0,0 +1,16 @@
+/**
+ * Doctor domain contracts — types for `cleo doctor` worktree-orphan audit/prune.
+ *
+ * These types describe orphan `.cleo/` directories left behind under
+ * `<projectRoot>/.claude/worktrees/` by the T9550/T9580 SSoT bug (fixed in
+ * v2026.5.83) and the schema for the audit JSONL line written per prune.
+ *
+ * Consumed by:
+ *   - `packages/core/src/doctor/worktree-orphans.ts` (scan + prune primitives)
+ *   - `packages/cleo/src/cli/commands/doctor.ts` (CLI flags)
+ *
+ * @task T9790
+ * @epic T9790
+ */
+export {};
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}