@paths.design/caws-cli 10.2.0 → 11.0.0

package/dist/store/repo-root.js.map

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

package/dist/store/rules.d.ts

@@ -0,0 +1,53 @@
+export declare const STORE_RULES: {
+    readonly REPO_ROOT_NOT_A_GIT_REPO: "store.repo_root.not_a_git_repo";
+    readonly REPO_ROOT_GIT_INVOCATION_FAILED: "store.repo_root.git_invocation_failed";
+    readonly REPO_ROOT_CAWS_DIR_MISSING: "store.repo_root.caws_dir_missing";
+    /** Distinguishable so callers can decide missing → Ok([]) vs missing → Err. */
+    readonly READ_MISSING_FILE: "store.read.missing_file";
+    readonly READ_NOT_A_FILE: "store.read.not_a_file";
+    readonly READ_IO_FAILED: "store.read.io_failed";
+    /** YAML parse failure. */
+    readonly READ_YAML_INVALID: "store.read.yaml_invalid";
+    /** JSON parse failure. */
+    readonly READ_JSON_INVALID: "store.read.json_invalid";
+    readonly WRITE_IO_FAILED: "store.write.io_failed";
+    /** Patch references a registry entry that does not exist (rebind/takeover). */
+    readonly WRITE_PATCH_TARGET_MISSING: "store.write.patch_target_missing";
+    /** A single spec file failed validation; the load itself still succeeds. */
+    readonly SPECS_SPEC_INVALID: "store.specs.spec_invalid";
+    /** A non-spec file landed in .caws/specs/ (e.g., README.md). Soft skip. */
+    readonly SPECS_NON_YAML_SKIPPED: "store.specs.non_yaml_skipped";
+    /** Two spec files declared the same spec id. */
+    readonly SPECS_DUPLICATE_ID: "store.specs.duplicate_id";
+    /** worktrees.json or agents.json parsed but is not a plain object. */
+    readonly REGISTRY_NOT_OBJECT: "store.registry.not_object";
+    /** A single waiver file failed validation; the load itself still succeeds. */
+    readonly WAIVERS_FILE_INVALID: "store.waivers.file_invalid";
+    /** Non-YAML file in .caws/waivers/. Soft skip. */
+    readonly WAIVERS_NON_YAML_SKIPPED: "store.waivers.non_yaml_skipped";
+    /** Two waiver files declared the same waiver id. */
+    readonly WAIVERS_DUPLICATE_ID: "store.waivers.duplicate_id";
+    /** Filename did not match the waiver id. */
+    readonly WAIVERS_FILENAME_MISMATCH: "store.waivers.filename_mismatch";
+    /** Caller tried to create a waiver with an id that already exists. */
+    readonly WAIVERS_ALREADY_EXISTS: "store.waivers.already_exists";
+    /** Caller tried to revoke a waiver that does not exist. */
+    readonly WAIVERS_NOT_FOUND: "store.waivers.not_found";
+    /** Interior (non-trailing) malformed JSON line in events.jsonl. */
+    readonly EVENTS_INTERIOR_MALFORMED_LINE: "store.events.interior_malformed_line";
+    /** Trailing partial line (crash-recovery). Tolerated; emitted as warning. */
+    readonly EVENTS_TRAILING_PARTIAL_LINE: "store.events.trailing_partial_line";
+    /** Event line parsed as JSON but did not pass validateChainedEvent. */
+    readonly EVENTS_INVALID_EVENT_SHAPE: "store.events.invalid_event_shape";
+    /** Failed to acquire the events.jsonl lock after the bounded retry. */
+    readonly EVENTS_LOCK_CONTENTION: "store.events.lock_contention";
+    /** prepareAppend rejected the body. Carries the kernel diagnostics. */
+    readonly EVENTS_PREPARE_APPEND_REJECTED: "store.events.prepare_append_rejected";
+    /** A legacy file (e.g., working-spec.yaml) blocks vNext init. */
+    readonly INIT_LEGACY_RESIDUE: "store.init.legacy_residue";
+    /** init seeded a default policy that did not pass kernel validation. */
+    readonly INIT_DEFAULT_POLICY_INVALID: "store.init.default_policy_invalid";
+};
+export type StoreRule = (typeof STORE_RULES)[keyof typeof STORE_RULES];
+export declare const STORE_RULE_PREFIXES: readonly ["store.repo_root.", "store.read.", "store.write.", "store.specs.", "store.waivers.", "store.registry.", "store.events.", "store.init."];
+//# sourceMappingURL=rules.d.ts.map

package/dist/store/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/store/rules.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,WAAW;;;;IAOtB,+EAA+E;;;;IAI/E,0BAA0B;;IAE1B,0BAA0B;;;IAK1B,+EAA+E;;IAI/E,4EAA4E;;IAE5E,2EAA2E;;IAE3E,gDAAgD;;IAIhD,sEAAsE;;IAItE,8EAA8E;;IAE9E,kDAAkD;;IAElD,oDAAoD;;IAEpD,4CAA4C;;IAE5C,sEAAsE;;IAEtE,2DAA2D;;IAI3D,mEAAmE;;IAEnE,6EAA6E;;IAE7E,uEAAuE;;IAEvE,uEAAuE;;IAEvE,uEAAuE;;IAIvE,iEAAiE;;IAEjE,wEAAwE;;CAEhE,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE,eAAO,MAAM,mBAAmB,mJAStB,CAAC"}

package/dist/store/rules.js

@@ -0,0 +1,78 @@
+"use strict";
+// Stable rule identifiers for the Node-only store layer.
+//
+// These ids are public contract for shell-side diagnostics. The store is
+// the only place outside the kernel that emits Diagnostics under the
+// `kernel/diagnostics` authority — store-specific authority is reserved
+// for future. Until then, store rule ids carry the `store.*` namespace.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORE_RULE_PREFIXES = exports.STORE_RULES = void 0;
+exports.STORE_RULES = {
+    // ---- repo root resolution -----------------------------------------------
+    REPO_ROOT_NOT_A_GIT_REPO: 'store.repo_root.not_a_git_repo',
+    REPO_ROOT_GIT_INVOCATION_FAILED: 'store.repo_root.git_invocation_failed',
+    REPO_ROOT_CAWS_DIR_MISSING: 'store.repo_root.caws_dir_missing',
+    // ---- file I/O ------------------------------------------------------------
+    /** Distinguishable so callers can decide missing → Ok([]) vs missing → Err. */
+    READ_MISSING_FILE: 'store.read.missing_file',
+    READ_NOT_A_FILE: 'store.read.not_a_file',
+    READ_IO_FAILED: 'store.read.io_failed',
+    /** YAML parse failure. */
+    READ_YAML_INVALID: 'store.read.yaml_invalid',
+    /** JSON parse failure. */
+    READ_JSON_INVALID: 'store.read.json_invalid',
+    // ---- atomic write --------------------------------------------------------
+    WRITE_IO_FAILED: 'store.write.io_failed',
+    /** Patch references a registry entry that does not exist (rebind/takeover). */
+    WRITE_PATCH_TARGET_MISSING: 'store.write.patch_target_missing',
+    // ---- specs ---------------------------------------------------------------
+    /** A single spec file failed validation; the load itself still succeeds. */
+    SPECS_SPEC_INVALID: 'store.specs.spec_invalid',
+    /** A non-spec file landed in .caws/specs/ (e.g., README.md). Soft skip. */
+    SPECS_NON_YAML_SKIPPED: 'store.specs.non_yaml_skipped',
+    /** Two spec files declared the same spec id. */
+    SPECS_DUPLICATE_ID: 'store.specs.duplicate_id',
+    // ---- registries ---------------------------------------------------------
+    /** worktrees.json or agents.json parsed but is not a plain object. */
+    REGISTRY_NOT_OBJECT: 'store.registry.not_object',
+    // ---- waivers ------------------------------------------------------------
+    /** A single waiver file failed validation; the load itself still succeeds. */
+    WAIVERS_FILE_INVALID: 'store.waivers.file_invalid',
+    /** Non-YAML file in .caws/waivers/. Soft skip. */
+    WAIVERS_NON_YAML_SKIPPED: 'store.waivers.non_yaml_skipped',
+    /** Two waiver files declared the same waiver id. */
+    WAIVERS_DUPLICATE_ID: 'store.waivers.duplicate_id',
+    /** Filename did not match the waiver id. */
+    WAIVERS_FILENAME_MISMATCH: 'store.waivers.filename_mismatch',
+    /** Caller tried to create a waiver with an id that already exists. */
+    WAIVERS_ALREADY_EXISTS: 'store.waivers.already_exists',
+    /** Caller tried to revoke a waiver that does not exist. */
+    WAIVERS_NOT_FOUND: 'store.waivers.not_found',
+    // ---- events -------------------------------------------------------------
+    /** Interior (non-trailing) malformed JSON line in events.jsonl. */
+    EVENTS_INTERIOR_MALFORMED_LINE: 'store.events.interior_malformed_line',
+    /** Trailing partial line (crash-recovery). Tolerated; emitted as warning. */
+    EVENTS_TRAILING_PARTIAL_LINE: 'store.events.trailing_partial_line',
+    /** Event line parsed as JSON but did not pass validateChainedEvent. */
+    EVENTS_INVALID_EVENT_SHAPE: 'store.events.invalid_event_shape',
+    /** Failed to acquire the events.jsonl lock after the bounded retry. */
+    EVENTS_LOCK_CONTENTION: 'store.events.lock_contention',
+    /** prepareAppend rejected the body. Carries the kernel diagnostics. */
+    EVENTS_PREPARE_APPEND_REJECTED: 'store.events.prepare_append_rejected',
+    // ---- init (slice 7b) ----------------------------------------------------
+    /** A legacy file (e.g., working-spec.yaml) blocks vNext init. */
+    INIT_LEGACY_RESIDUE: 'store.init.legacy_residue',
+    /** init seeded a default policy that did not pass kernel validation. */
+    INIT_DEFAULT_POLICY_INVALID: 'store.init.default_policy_invalid',
+};
+exports.STORE_RULE_PREFIXES = [
+    'store.repo_root.',
+    'store.read.',
+    'store.write.',
+    'store.specs.',
+    'store.waivers.',
+    'store.registry.',
+    'store.events.',
+    'store.init.',
+];
+//# sourceMappingURL=rules.js.map

package/dist/store/rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../src/store/rules.ts"],"names":[],"mappings":";AAAA,yDAAyD;AACzD,EAAE;AACF,yEAAyE;AACzE,qEAAqE;AACrE,wEAAwE;AACxE,wEAAwE;;;AAE3D,QAAA,WAAW,GAAG;IACzB,4EAA4E;IAC5E,wBAAwB,EAAE,gCAAgC;IAC1D,+BAA+B,EAAE,uCAAuC;IACxE,0BAA0B,EAAE,kCAAkC;IAE9D,6EAA6E;IAC7E,+EAA+E;IAC/E,iBAAiB,EAAE,yBAAyB;IAC5C,eAAe,EAAE,uBAAuB;IACxC,cAAc,EAAE,sBAAsB;IACtC,0BAA0B;IAC1B,iBAAiB,EAAE,yBAAyB;IAC5C,0BAA0B;IAC1B,iBAAiB,EAAE,yBAAyB;IAE5C,6EAA6E;IAC7E,eAAe,EAAE,uBAAuB;IACxC,+EAA+E;IAC/E,0BAA0B,EAAE,kCAAkC;IAE9D,6EAA6E;IAC7E,4EAA4E;IAC5E,kBAAkB,EAAE,0BAA0B;IAC9C,2EAA2E;IAC3E,sBAAsB,EAAE,8BAA8B;IACtD,gDAAgD;IAChD,kBAAkB,EAAE,0BAA0B;IAE9C,4EAA4E;IAC5E,sEAAsE;IACtE,mBAAmB,EAAE,2BAA2B;IAEhD,4EAA4E;IAC5E,8EAA8E;IAC9E,oBAAoB,EAAE,4BAA4B;IAClD,kDAAkD;IAClD,wBAAwB,EAAE,gCAAgC;IAC1D,oDAAoD;IACpD,oBAAoB,EAAE,4BAA4B;IAClD,4CAA4C;IAC5C,yBAAyB,EAAE,iCAAiC;IAC5D,sEAAsE;IACtE,sBAAsB,EAAE,8BAA8B;IACtD,2DAA2D;IAC3D,iBAAiB,EAAE,yBAAyB;IAE5C,4EAA4E;IAC5E,mEAAmE;IACnE,8BAA8B,EAAE,sCAAsC;IACtE,6EAA6E;IAC7E,4BAA4B,EAAE,oCAAoC;IAClE,uEAAuE;IACvE,0BAA0B,EAAE,kCAAkC;IAC9D,uEAAuE;IACvE,sBAAsB,EAAE,8BAA8B;IACtD,uEAAuE;IACvE,8BAA8B,EAAE,sCAAsC;IAEtE,4EAA4E;IAC5E,iEAAiE;IACjE,mBAAmB,EAAE,2BAA2B;IAChD,wEAAwE;IACxE,2BAA2B,EAAE,mCAAmC;CACxD,CAAC;AAIE,QAAA,mBAAmB,GAAG;IACjC,kBAAkB;IAClB,aAAa;IACb,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,iBAAiB;IACjB,eAAe;IACf,aAAa;CACL,CAAC"}

package/dist/store/specs-store.d.ts

@@ -0,0 +1,3 @@
+import type { SpecsLoadResult } from './types';
+export declare function loadSpecs(cawsDir: string): SpecsLoadResult;
+//# sourceMappingURL=specs-store.d.ts.map

package/dist/store/specs-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specs-store.d.ts","sourceRoot":"","sources":["../../src/store/specs-store.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAM/C,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAmG1D"}

package/dist/store/specs-store.js

@@ -0,0 +1,131 @@
+"use strict";
+// Specs loader.
+//
+// Multi-spec only. Loads every `*.yaml` / `*.yml` file directly under
+// `.caws/specs/`, hands each source to the kernel's `parseAndValidateSpec`,
+// and collects the results.
+//
+// Discipline:
+//   - DOES NOT resurrect `.caws/working-spec.yaml`. The project-level
+//     spec is gone in vNext; the only authoritative source is per-feature
+//     specs under .caws/specs/.
+//   - Skips files that are not .yaml/.yml with a soft `non_yaml_skipped`
+//     diagnostic (info severity).
+//   - Per-file validation failures land in `diagnostics`; the valid
+//     specs are still returned. doctor decides how to surface them.
+//   - Duplicate spec ids → diagnostic; the first occurrence wins.
+//   - Missing `.caws/specs/` directory → returns `{ specs: [], diagnostics: [] }`.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadSpecs = loadSpecs;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const caws_kernel_1 = require("@paths.design/caws-kernel");
+const repo_root_1 = require("./repo-root");
+const rules_1 = require("./rules");
+const yaml_store_1 = require("./yaml-store");
+function isYamlPath(name) {
+    return name.endsWith('.yaml') || name.endsWith('.yml');
+}
+function loadSpecs(cawsDir) {
+    const specsDir = path.join(cawsDir, 'specs');
+    if (!fs.existsSync(specsDir)) {
+        return { specs: [], diagnostics: [] };
+    }
+    let entries;
+    try {
+        entries = fs.readdirSync(specsDir, { withFileTypes: true });
+    }
+    catch (e) {
+        const cause = e;
+        return {
+            specs: [],
+            diagnostics: [
+                (0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_IO_FAILED, `Failed to read ${specsDir}: ${cause.message ?? 'unknown error'}.`, { subject: specsDir, data: { code: cause.code } }),
+            ],
+        };
+    }
+    const validSpecs = [];
+    const diagnostics = [];
+    const seenIds = new Map(); // id → first-seen file path
+    // Sort for determinism. composeDoctorSnapshot should produce the same
+    // snapshot for the same on-disk state.
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        // Explicit guard: working-spec.yaml is forbidden in vNext.
+        if (entry.name === 'working-spec.yaml' || entry.name === 'working-spec.yml') {
+            diagnostics.push((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.SPECS_NON_YAML_SKIPPED, `Skipping ${entry.name}: project-level working spec is not supported in vNext.`, { subject: path.join(specsDir, entry.name) }));
+            continue;
+        }
+        const fullPath = path.join(specsDir, entry.name);
+        if (!isYamlPath(entry.name)) {
+            diagnostics.push((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.SPECS_NON_YAML_SKIPPED, `Skipping non-YAML file in .caws/specs/: ${entry.name}.`, { subject: fullPath }));
+            continue;
+        }
+        const source = (0, yaml_store_1.readYamlSource)(fullPath);
+        if (!(0, caws_kernel_1.isOk)(source)) {
+            diagnostics.push(...source.errors);
+            continue;
+        }
+        const result = (0, caws_kernel_1.parseAndValidateSpec)(source.value);
+        if (!(0, caws_kernel_1.isOk)(result)) {
+            // Wrap kernel diagnostics with the offending file as subject when
+            // the kernel didn't already attach one.
+            for (const d of result.errors) {
+                diagnostics.push({
+                    ...d,
+                    subject: d.subject ?? fullPath,
+                });
+            }
+            continue;
+        }
+        const spec = result.value;
+        const existing = seenIds.get(spec.id);
+        if (existing !== undefined) {
+            diagnostics.push((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.SPECS_DUPLICATE_ID, `Duplicate spec id "${spec.id}" — already loaded from ${existing}.`, {
+                subject: fullPath,
+                narrowRepair: `Rename the spec id in ${entry.name} or remove the duplicate file.`,
+                data: { spec_id: spec.id, first_seen: existing, duplicate: fullPath },
+            }));
+            continue;
+        }
+        seenIds.set(spec.id, fullPath);
+        validSpecs.push(spec);
+    }
+    return { specs: validSpecs, diagnostics };
+}
+//# sourceMappingURL=specs-store.js.map

package/dist/store/specs-store.js.map

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

package/dist/store/types.d.ts

@@ -0,0 +1,84 @@
+import type { AgentRegistry, ChainedEvent, Diagnostic, Policy, Spec, Waiver, WorktreeRegistry } from '@paths.design/caws-kernel';
+export interface SpecsLoadResult {
+    /** Specs that parsed AND validated. Safe to hand to the kernel. */
+    readonly specs: readonly Spec[];
+    /**
+     * Per-file diagnostics from parse/validate. Includes:
+     *   - kernel diagnostics for individual spec files that failed
+     *   - store diagnostics for unreadable/skipped files
+     *   - store diagnostics for duplicate spec ids
+     */
+    readonly diagnostics: readonly Diagnostic[];
+}
+export interface PolicyLoadResult {
+    /** Undefined when no policy.yaml exists or the file failed to parse. */
+    readonly policy?: Policy;
+    /** Non-fatal diagnostics from the kernel's policy semantics layer. */
+    readonly warnings: readonly Diagnostic[];
+    /** Fatal diagnostics — when present, `policy` is undefined. */
+    readonly errors: readonly Diagnostic[];
+}
+export interface EventsLoadResult {
+    /** Successfully parsed chained events. */
+    readonly events: readonly ChainedEvent[];
+    /**
+     * Non-fatal diagnostics. Only one kind is currently emitted here:
+     * `store.events.trailing_partial_line` when the last line was incomplete
+     * (crash-recovery tolerance).
+     */
+    readonly warnings: readonly Diagnostic[];
+}
+export interface StoreSnapshot {
+    readonly repoRoot: string;
+    readonly cawsDir: string;
+    /** Specs that parsed AND validated. */
+    readonly specs: readonly Spec[];
+    /** Per-file diagnostics from loadSpecs. */
+    readonly specDiagnostics: readonly Diagnostic[];
+    /** Parsed policy if present. */
+    readonly policy?: Policy;
+    /** Non-fatal diagnostics from the policy kernel. */
+    readonly policyWarnings: readonly Diagnostic[];
+    /** Fatal diagnostics that prevented policy loading. */
+    readonly policyErrors: readonly Diagnostic[];
+    readonly worktrees: WorktreeRegistry;
+    readonly agents: AgentRegistry;
+    readonly events: readonly ChainedEvent[];
+    readonly eventWarnings: readonly Diagnostic[];
+    /** Waivers that parsed AND validated (slice 7a.5). */
+    readonly waivers: readonly Waiver[];
+    /** Per-file load diagnostics from loadWaivers (slice 7a.5). */
+    readonly waiverDiagnostics: readonly Diagnostic[];
+    /**
+     * Presence of legacy single-spec / pre-vNext artifacts inside `.caws/`.
+     * Doctor surfaces these as errors — vNext init refuses to bootstrap
+     * over them, and live projects should retire them.
+     */
+    readonly initResidue: {
+        readonly workingSpecYaml: boolean;
+        readonly workingSpecSchemaJson: boolean;
+    };
+    /**
+     * Existence facts for each canonical vNext path. Doctor needs these
+     * to surface "canonical layout drift" (e.g. specs/ dir missing on a
+     * live project). `eventsJsonlExists` is reported but never required:
+     * the first append creates it under lock.
+     */
+    readonly filesystem: {
+        readonly cawsDirExists: boolean;
+        readonly specsDirExists: boolean;
+        readonly waiversDirExists: boolean;
+        readonly policyYamlExists: boolean;
+        readonly worktreesJsonExists: boolean;
+        readonly agentsJsonExists: boolean;
+        readonly eventsJsonlExists: boolean;
+    };
+    /**
+     * Diagnostics from worktrees.json / agents.json load failures that
+     * the previous shape silently swallowed (the snapshot fell back to
+     * `{}` on Err). Doctor needs to see these to flag "registry file is
+     * malformed" without treating registry absence as drift.
+     */
+    readonly registryDiagnostics: readonly Diagnostic[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/store/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,MAAM,EACN,IAAI,EACJ,MAAM,EACN,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AAMnC,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAMD,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;IACzC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;CACxC;AAMD,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;CAC1C;AAWD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,UAAU,EAAE,CAAC;IAChD,gCAAgC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,cAAc,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/C,uDAAuD;IACvD,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,SAAS,UAAU,EAAE,CAAC;IAC9C,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,iBAAiB,EAAE,SAAS,UAAU,EAAE,CAAC;IAUlD;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;QAClC,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;KACzC,CAAC;IAEF;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE;QACnB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;QAChC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;QACjC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;QACnC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;QACnC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;QACtC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;QACnC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;KACrC,CAAC;IAEF;;;;;OAKG;IACH,QAAQ,CAAC,mBAAmB,EAAE,SAAS,UAAU,EAAE,CAAC;CACrD"}

package/dist/store/types.js

@@ -0,0 +1,14 @@
+"use strict";
+// Node-only store types.
+//
+// The store layer is the bridge between the filesystem and the pure
+// kernel. It loads state, delegates validation to the kernel, and returns
+// either parsed values or structured Diagnostics.
+//
+// Discipline:
+//   - The store never invents new validation rules. It parses and forwards.
+//   - The store distinguishes "missing file" (often a recoverable Ok) from
+//     "malformed file" (always Err).
+//   - Programmer errors throw; user/repo errors return Result.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/store/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":";AAAA,yBAAyB;AACzB,EAAE;AACF,oEAAoE;AACpE,0EAA0E;AAC1E,kDAAkD;AAClD,EAAE;AACF,cAAc;AACd,4EAA4E;AAC5E,2EAA2E;AAC3E,qCAAqC;AACrC,+DAA+D"}

package/dist/store/waivers-store.d.ts

@@ -0,0 +1,25 @@
+import { type Diagnostic, type Result, type Waiver } from '@paths.design/caws-kernel';
+export interface WaiversLoadResult {
+    readonly waivers: readonly Waiver[];
+    readonly diagnostics: readonly Diagnostic[];
+}
+export declare function loadWaivers(cawsDir: string): WaiversLoadResult;
+/**
+ * Write a waiver atomically to `.caws/waivers/<id>.yaml`. Refuses
+ * to overwrite an existing file (use markRevoked to update status).
+ */
+export declare function writeWaiver(cawsDir: string, waiver: Waiver, opts?: {
+    allowOverwrite?: boolean;
+}): Result<true>;
+/**
+ * Mark an existing waiver as revoked. Reads the existing file, builds a
+ * new in-memory waiver with status='revoked' and a revocation record,
+ * writes it back atomically. Refuses if the waiver is already revoked
+ * (caller decides whether to revisit revocation reason).
+ */
+export declare function markRevoked(cawsDir: string, id: string, args: {
+    now: Date;
+    revoked_by?: string;
+    reason?: string;
+}): Result<Waiver>;
+//# sourceMappingURL=waivers-store.d.ts.map

package/dist/store/waivers-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waivers-store.d.ts","sourceRoot":"","sources":["../../src/store/waivers-store.ts"],"names":[],"mappings":"AAiBA,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,MAAM,EACX,KAAK,MAAM,EACZ,MAAM,2BAA2B,CAAC;AAOnC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAcD,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAiG9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,MAAM,CAAC,IAAI,CAAC,CA0Bd;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,MAAM,CAAC,MAAM,CAAC,CA0ChB"}