@paths.design/caws-cli 10.2.0 → 11.0.0

package/dist/store/waivers-store.js

@@ -0,0 +1,232 @@
+"use strict";
+// Waivers store.
+//
+// Loads every `*.yaml` / `*.yml` file directly under `.caws/waivers/`,
+// hands each source to the kernel's `validateWaiver`, and collects the
+// results.
+//
+// Discipline (mirrors specs-store):
+//   - Missing `.caws/waivers/` → `{ waivers: [], diagnostics: [] }`.
+//   - Non-YAML files → soft `non_yaml_skipped` diagnostic.
+//   - Invalid waiver file → diagnostic, valid waivers still load.
+//   - Duplicate waiver id → diagnostic; first occurrence wins.
+//   - Filename should equal `<id>.yaml`; mismatch → diagnostic (info).
+//   - Writes are atomic via writeFileAtomic.
+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.loadWaivers = loadWaivers;
+exports.writeWaiver = writeWaiver;
+exports.markRevoked = markRevoked;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const caws_kernel_1 = require("@paths.design/caws-kernel");
+const atomic_write_1 = require("./atomic-write");
+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 waiversDirPath(cawsDir) {
+    return path.join(cawsDir, 'waivers');
+}
+function waiverFilePath(cawsDir, id) {
+    return path.join(waiversDirPath(cawsDir), `${id}.yaml`);
+}
+function loadWaivers(cawsDir) {
+    const waiversDir = waiversDirPath(cawsDir);
+    if (!fs.existsSync(waiversDir)) {
+        return { waivers: [], diagnostics: [] };
+    }
+    let entries;
+    try {
+        entries = fs.readdirSync(waiversDir, { withFileTypes: true });
+    }
+    catch (e) {
+        const cause = e;
+        return {
+            waivers: [],
+            diagnostics: [
+                (0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_IO_FAILED, `Failed to read ${waiversDir}: ${cause.message ?? 'unknown error'}.`, cause.code !== undefined
+                    ? { subject: waiversDir, data: { code: cause.code } }
+                    : { subject: waiversDir }),
+            ],
+        };
+    }
+    const validWaivers = [];
+    const diagnostics = [];
+    const seenIds = new Map(); // id → first-seen file path
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        const fullPath = path.join(waiversDir, entry.name);
+        if (!isYamlPath(entry.name)) {
+            diagnostics.push((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WAIVERS_NON_YAML_SKIPPED, `Skipping non-YAML file in .caws/waivers/: ${entry.name}.`, { subject: fullPath }));
+            continue;
+        }
+        const source = (0, yaml_store_1.readYamlFile)(fullPath);
+        if (!(0, caws_kernel_1.isOk)(source)) {
+            diagnostics.push(...source.errors);
+            continue;
+        }
+        const result = (0, caws_kernel_1.validateWaiver)(source.value);
+        if (!(0, caws_kernel_1.isOk)(result)) {
+            // Annotate with the file we were reading so doctor can repair.
+            for (const e of result.errors) {
+                diagnostics.push({ ...e, subject: e.subject ?? fullPath });
+            }
+            continue;
+        }
+        const waiver = result.value;
+        const prev = seenIds.get(waiver.id);
+        if (prev !== undefined) {
+            diagnostics.push((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WAIVERS_DUPLICATE_ID, `Duplicate waiver id ${waiver.id}: first seen in ${prev}, second in ${fullPath}.`, {
+                subject: fullPath,
+                data: { waiver_id: waiver.id, first_seen: prev, duplicate: fullPath },
+            }));
+            continue;
+        }
+        seenIds.set(waiver.id, fullPath);
+        // Filename should equal `<id>.yaml`. This isn't an error (the kernel
+        // doesn't care about filenames), but it's a hygiene info diagnostic
+        // so doctor can spot drift.
+        const expectedName = `${waiver.id}.yaml`;
+        if (entry.name !== expectedName) {
+            diagnostics.push({
+                ...(0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WAIVERS_FILENAME_MISMATCH, `Waiver file ${entry.name} does not match id ${waiver.id} (expected ${expectedName}).`, { subject: fullPath, data: { id: waiver.id, expected: expectedName } }),
+                severity: 'info',
+            });
+        }
+        validWaivers.push(waiver);
+    }
+    return { waivers: validWaivers, diagnostics };
+}
+/**
+ * Write a waiver atomically to `.caws/waivers/<id>.yaml`. Refuses
+ * to overwrite an existing file (use markRevoked to update status).
+ */
+function writeWaiver(cawsDir, waiver, opts = {}) {
+    const waiversDir = waiversDirPath(cawsDir);
+    try {
+        fs.mkdirSync(waiversDir, { recursive: true });
+    }
+    catch (e) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WRITE_IO_FAILED, `Failed to create ${waiversDir}: ${e.message}.`, { subject: waiversDir }));
+    }
+    const filePath = waiverFilePath(cawsDir, waiver.id);
+    if (!opts.allowOverwrite && fs.existsSync(filePath)) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WAIVERS_ALREADY_EXISTS, `Waiver ${waiver.id} already exists at ${filePath}.`, { subject: filePath, data: { id: waiver.id } }));
+    }
+    return (0, atomic_write_1.writeFileAtomic)(filePath, serializeWaiver(waiver));
+}
+/**
+ * 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).
+ */
+function markRevoked(cawsDir, id, args) {
+    const filePath = waiverFilePath(cawsDir, id);
+    if (!fs.existsSync(filePath)) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WAIVERS_NOT_FOUND, `Waiver ${id} not found at ${filePath}.`, { subject: filePath, data: { id } }));
+    }
+    const source = (0, yaml_store_1.readYamlFile)(filePath);
+    if (!(0, caws_kernel_1.isOk)(source))
+        return source;
+    const validated = (0, caws_kernel_1.validateWaiver)(source.value);
+    if (!(0, caws_kernel_1.isOk)(validated))
+        return validated;
+    const existing = validated.value;
+    if (existing.status === 'revoked') {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WAIVERS_ALREADY_EXISTS, `Waiver ${id} is already revoked.`, { subject: filePath, data: { id } }));
+    }
+    const revoked = {
+        ...existing,
+        status: 'revoked',
+        revocation: {
+            revoked_at: args.now.toISOString(),
+            ...(args.revoked_by !== undefined ? { revoked_by: args.revoked_by } : {}),
+            ...(args.reason !== undefined ? { reason: args.reason } : {}),
+        },
+    };
+    const write = (0, atomic_write_1.writeFileAtomic)(filePath, serializeWaiver(revoked));
+    if (!(0, caws_kernel_1.isOk)(write))
+        return write;
+    return (0, caws_kernel_1.ok)(revoked);
+}
+/**
+ * Serialize a waiver to YAML. Deterministic field order so the file is
+ * stable on disk. Built by hand to avoid YAML alias churn (the existing
+ * specs use a similar controlled-serialization approach).
+ */
+function serializeWaiver(w) {
+    const lines = [];
+    lines.push(`id: ${w.id}`);
+    lines.push(`title: ${yamlQuote(w.title)}`);
+    lines.push(`status: ${w.status}`);
+    lines.push('gates:');
+    for (const g of w.gates)
+        lines.push(`  - ${g}`);
+    lines.push(`reason: ${yamlQuote(w.reason)}`);
+    lines.push(`approved_by: ${yamlQuote(w.approved_by)}`);
+    lines.push(`created_at: ${yamlQuote(w.created_at)}`);
+    lines.push(`expires_at: ${yamlQuote(w.expires_at)}`);
+    if (w.scope !== undefined) {
+        lines.push('scope:');
+        if (w.scope.spec_id !== undefined)
+            lines.push(`  spec_id: ${w.scope.spec_id}`);
+    }
+    if (w.constraints !== undefined) {
+        lines.push('constraints:');
+        if (w.constraints.max_uses !== undefined)
+            lines.push(`  max_uses: ${w.constraints.max_uses}`);
+    }
+    if (w.revocation !== undefined) {
+        lines.push('revocation:');
+        lines.push(`  revoked_at: ${yamlQuote(w.revocation.revoked_at)}`);
+        if (w.revocation.revoked_by !== undefined)
+            lines.push(`  revoked_by: ${yamlQuote(w.revocation.revoked_by)}`);
+        if (w.revocation.reason !== undefined)
+            lines.push(`  reason: ${yamlQuote(w.revocation.reason)}`);
+    }
+    return lines.join('\n') + '\n';
+}
+function yamlQuote(value) {
+    // Conservative: always single-quote strings, doubling internal single quotes.
+    // This avoids the YAML "is this an integer/date/bool?" ambiguity entirely.
+    return `'${value.replace(/'/g, "''")}'`;
+}
+//# sourceMappingURL=waivers-store.js.map

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

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

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

@@ -0,0 +1,3 @@
+import { type Result, type WorktreeRegistry } from '@paths.design/caws-kernel';
+export declare function loadWorktrees(cawsDir: string): Result<WorktreeRegistry>;
+//# sourceMappingURL=worktrees-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worktrees-store.d.ts","sourceRoot":"","sources":["../../src/store/worktrees-store.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AAKnC,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAoBvE"}

package/dist/store/worktrees-store.js

@@ -0,0 +1,62 @@
+"use strict";
+// Worktrees registry loader.
+//
+// Reads `.caws/worktrees.json`. Missing file → empty registry. Malformed
+// JSON or non-object payload → Err. Shape validation is shallow; the
+// kernel's worktree module reasons about the structured shape.
+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.loadWorktrees = loadWorktrees;
+const path = __importStar(require("path"));
+const caws_kernel_1 = require("@paths.design/caws-kernel");
+const json_store_1 = require("./json-store");
+const repo_root_1 = require("./repo-root");
+const rules_1 = require("./rules");
+function loadWorktrees(cawsDir) {
+    const filePath = path.join(cawsDir, 'worktrees.json');
+    const r = (0, json_store_1.readJsonFile)(filePath);
+    if (!(0, caws_kernel_1.isOk)(r)) {
+        if (r.errors.some((e) => e.rule === rules_1.STORE_RULES.READ_MISSING_FILE)) {
+            return (0, caws_kernel_1.ok)({});
+        }
+        return (0, caws_kernel_1.err)(r.errors);
+    }
+    const value = r.value;
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.REGISTRY_NOT_OBJECT, `worktrees.json is not a JSON object.`, { subject: filePath }));
+    }
+    return (0, caws_kernel_1.ok)(value);
+}
+//# sourceMappingURL=worktrees-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worktrees-store.js","sourceRoot":"","sources":["../../src/store/worktrees-store.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,EAAE;AACF,yEAAyE;AACzE,qEAAqE;AACrE,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAc/D,sCAoBC;AAhCD,2CAA6B;AAC7B,2DAMmC;AACnC,6CAA4C;AAC5C,2CAA8C;AAC9C,mCAAsC;AAEtC,SAAgB,aAAa,CAAC,OAAe;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACtD,MAAM,CAAC,GAAG,IAAA,yBAAY,EAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC,IAAA,kBAAI,EAAC,CAAC,CAAC,EAAE,CAAC;QACb,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,mBAAW,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACnE,OAAO,IAAA,gBAAE,EAAC,EAAE,CAAC,CAAC;QAChB,CAAC;QACD,OAAO,IAAA,iBAAG,EAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;IACtB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,IAAA,iBAAG,EACR,IAAA,2BAAe,EACb,mBAAW,CAAC,mBAAmB,EAC/B,sCAAsC,EACtC,EAAE,OAAO,EAAE,QAAQ,EAAE,CACtB,CACF,CAAC;IACJ,CAAC;IACD,OAAO,IAAA,gBAAE,EAAC,KAAyB,CAAC,CAAC;AACvC,CAAC"}

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

@@ -0,0 +1,9 @@
+import { type Result } from '@paths.design/caws-kernel';
+export declare function readYamlFile(filePath: string): Result<unknown>;
+/**
+ * Read raw YAML text (no parse). Returns Err for missing/IO failure but
+ * never for syntax problems — those are the caller's concern. Used by
+ * spec/policy loaders, which hand the raw string to the kernel.
+ */
+export declare function readYamlSource(filePath: string): Result<string>;
+//# sourceMappingURL=yaml-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-store.d.ts","sourceRoot":"","sources":["../../src/store/yaml-store.ts"],"names":[],"mappings":"AAaA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAIjE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAyD9D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CA0C/D"}

package/dist/store/yaml-store.js

@@ -0,0 +1,121 @@
+"use strict";
+// YAML read helper.
+//
+// Returns Ok(parsedNode) or Err(diagnostic). Distinguishes:
+//   - missing file → Err(STORE.READ_MISSING_FILE)   [caller decides Ok([]) vs Err]
+//   - not a regular file → Err(STORE.READ_NOT_A_FILE)
+//   - I/O failure → Err(STORE.READ_IO_FAILED)
+//   - YAML parse failure → Err(STORE.READ_YAML_INVALID)
+//
+// This helper does NOT validate against a schema. The kernel is the
+// authority for semantic validation; the store is the bridge for I/O.
+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.readYamlFile = readYamlFile;
+exports.readYamlSource = readYamlSource;
+const fs = __importStar(require("fs"));
+const yaml = __importStar(require("js-yaml"));
+const caws_kernel_1 = require("@paths.design/caws-kernel");
+const repo_root_1 = require("./repo-root");
+const rules_1 = require("./rules");
+function readYamlFile(filePath) {
+    let stat;
+    try {
+        stat = fs.statSync(filePath);
+    }
+    catch (e) {
+        const cause = e;
+        if (cause.code === 'ENOENT') {
+            return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_MISSING_FILE, `File not found: ${filePath}.`, {
+                subject: filePath,
+            }));
+        }
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_IO_FAILED, `Failed to stat ${filePath}: ${cause.message ?? 'unknown error'}.`, { subject: filePath, data: { code: cause.code } }));
+    }
+    if (!stat.isFile()) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_NOT_A_FILE, `${filePath} is not a regular file.`, {
+            subject: filePath,
+        }));
+    }
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, 'utf8');
+    }
+    catch (e) {
+        const cause = e;
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_IO_FAILED, `Failed to read ${filePath}: ${cause.message ?? 'unknown error'}.`, { subject: filePath, data: { code: cause.code } }));
+    }
+    try {
+        const parsed = yaml.load(raw);
+        return (0, caws_kernel_1.ok)(parsed);
+    }
+    catch (e) {
+        const cause = e;
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_YAML_INVALID, `YAML parse failed in ${filePath}: ${cause.message ?? 'unknown error'}.`, { subject: filePath }));
+    }
+}
+/**
+ * Read raw YAML text (no parse). Returns Err for missing/IO failure but
+ * never for syntax problems — those are the caller's concern. Used by
+ * spec/policy loaders, which hand the raw string to the kernel.
+ */
+function readYamlSource(filePath) {
+    let stat;
+    try {
+        stat = fs.statSync(filePath);
+    }
+    catch (e) {
+        const cause = e;
+        if (cause.code === 'ENOENT') {
+            return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_MISSING_FILE, `File not found: ${filePath}.`, {
+                subject: filePath,
+            }));
+        }
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_IO_FAILED, `Failed to stat ${filePath}: ${cause.message ?? 'unknown error'}.`, { subject: filePath, data: { code: cause.code } }));
+    }
+    if (!stat.isFile()) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_NOT_A_FILE, `${filePath} is not a regular file.`, {
+            subject: filePath,
+        }));
+    }
+    try {
+        return (0, caws_kernel_1.ok)(fs.readFileSync(filePath, 'utf8'));
+    }
+    catch (e) {
+        const cause = e;
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_IO_FAILED, `Failed to read ${filePath}: ${cause.message ?? 'unknown error'}.`, { subject: filePath, data: { code: cause.code } }));
+    }
+}
+//# sourceMappingURL=yaml-store.js.map

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

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@paths.design/caws-cli",
-  "version": "10.2.0",
-  "description": "CAWS CLI - Coding Agent Workflow System command-line tools for spec management, quality gates, and AI-assisted development",
+  "version": "11.0.0",
+  "description": "CAWS CLI - the governed core for CAWS project state, scope, claims, gates, waivers, and evidence (v11.0.0). vNext kernel/store/shell architecture.",
   "main": "dist/index.js",
   "bin": {
     "caws": "dist/index.js"
@@ -9,13 +9,12 @@
   "preferGlobal": true,
   "files": [
     "dist",
-    "README.md",
-    "templates"
+    "README.md"
   ],
   "scripts": {
-    "build": "mkdir -p dist && cp -r src/* dist/ && cp -r templates dist/ 2>/dev/null || true",
-    "dev": "mkdir -p dist && cp -r src/* dist/ && node dist/index.js",
-    "typecheck": "tsc --emitDeclarationOnly --outDir dist",
+    "build": "node scripts/build-cli.js",
+    "dev": "node scripts/build-cli.js && node dist/index.js",
+    "typecheck": "tsc -p tsconfig.vnext.test.json",
     "start": "node dist/index.js",
     "test": "node scripts/run-tests.js",
     "test:unit": "npm run build && jest --testPathIgnorePatterns='perf-budgets|integration|e2e|mutation|axe|contract' && npm run test:cleanup",
@@ -27,10 +26,10 @@
     "perf:budgets": "npm run build && jest --testPathPatterns=perf && npm run test:cleanup",
     "test:watch": "npm run build && jest --watch",
     "test:cleanup": "node scripts/cleanup-tests.js",
-    "lint": "npx eslint src/**/*.js tests/**/*.js",
-    "lint:fix": "npx eslint src/**/*.js tests/**/*.js --fix",
-    "lint:staged": "npx eslint src/**/*.js tests/**/*.js",
-    "format": "prettier --write src/**/*.js tests/**/*.js",
+    "lint": "npx eslint 'src/**/*.{js,ts}' 'tests/**/*.{js,ts}'",
+    "lint:fix": "npx eslint 'src/**/*.{js,ts}' 'tests/**/*.{js,ts}' --fix",
+    "lint:staged": "npx eslint 'src/**/*.{js,ts}' 'tests/**/*.{js,ts}'",
+    "format": "prettier --write 'src/**/*.{js,ts}' 'tests/**/*.{js,ts}'",
     "validate": "echo 'CLI package validation not required'",
     "caws:validate": "node dist/index.js validate",
     "clean": "rm -rf dist test-caws-project .agent && npm run test:cleanup",
@@ -56,11 +55,13 @@
     "access": "public"
   },
   "dependencies": {
+    "@paths.design/caws-kernel": "^1.0.0",
+    "@paths.design/quality-gates": "^2.0.0",
+    "ajv": "8.17.1",
     "chalk": "4.1.2",
     "commander": "^11.0.0",
     "fs-extra": "^11.0.0",
     "inquirer": "8.2.7",
-    "ajv": "8.17.1",
     "js-yaml": "4.1.0",
     "micromatch": "4.0.8",
     "minimatch": "^10.0.1"
@@ -82,7 +83,8 @@
     "lint-staged": "15.5.2",
     "prettier": "^3.0.0",
     "semantic-release": "25.0.0-beta.6",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "typescript-eslint": "8.46.4"
   },
   "engines": {
     "node": ">=18.0.0"