@paths.design/caws-cli 10.1.0 → 11.0.0

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

@@ -0,0 +1,33 @@
+import { type ChainedEvent, type EventBody, type Result } from '@paths.design/caws-kernel';
+import type { EventsLoadResult } from './types';
+/**
+ * Load events from `.caws/events.jsonl`.
+ *
+ * Outcomes:
+ *   - missing file → Ok({ events: [], warnings: [] })
+ *   - empty file → Ok({ events: [], warnings: [] })
+ *   - valid JSONL → Ok({ events, warnings: [] })
+ *   - trailing partial line → Ok({ events, warnings: [trailing_partial_line] })
+ *   - interior malformed line → Err
+ *   - line parses as JSON but fails validateChainedEvent → Err
+ */
+export declare function loadEvents(cawsDir: string): Result<EventsLoadResult>;
+/**
+ * Append a new event.
+ *
+ * Sequence under lock:
+ *   1. Acquire .caws/events.jsonl.lock (with stale-recovery + bounded retry).
+ *   2. Re-read the full events file to get the most-recent event.
+ *   3. Call prepareAppend(lastEvent ?? null, body).
+ *   4. Append the chained event as a JSON line + '\n'.
+ *   5. Release the lock.
+ *
+ * Returns the new ChainedEvent on success. On failure, the lock is
+ * released and no bytes are written.
+ *
+ * Callers MUST pass an `EventBody` (caller-side fields only). The store
+ * never accepts a pre-chained event — sequence and hash are kernel
+ * authority.
+ */
+export declare function appendEvent(cawsDir: string, body: EventBody): Result<ChainedEvent>;
+//# sourceMappingURL=events-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events-store.d.ts","sourceRoot":"","sources":["../../src/store/events-store.ts"],"names":[],"mappings":"AAsBA,OAAO,EAML,KAAK,YAAY,EAEjB,KAAK,SAAS,EACd,KAAK,MAAM,EACZ,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAUhD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAoBpE;AAoFD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GACd,MAAM,CAAC,YAAY,CAAC,CAgEtB"}

package/dist/store/events-store.js

@@ -0,0 +1,297 @@
+"use strict";
+// Events store — the ONLY write path for .caws/events.jsonl.
+//
+// Semantics carried over verbatim from the legacy implementation, now
+// resting on the evidence kernel:
+//
+//   - Append-only JSONL.
+//   - Each line is exactly one `ChainedEvent`, canonical-hashed.
+//   - Append acquires a lock file via `fs.openSync(lockPath, 'wx')`.
+//   - Stale lock recovery: if `wx` fails with EEXIST and the lockfile is
+//     older than 30 seconds, the stale file is removed and re-tried.
+//     Up to 3 acquisition attempts in total; further contention is Err.
+//   - Reading tolerates a trailing partial line (crash-recovery). An
+//     interior malformed line is Err.
+//   - Callers pass `EventBody`, never `ChainedEvent`. The store re-reads
+//     the tail, calls `prepareAppend`, and writes the new line.
+//
+// This module is the only place outside the kernel that creates chained
+// events. All other code paths (CLI commands, hooks, future store
+// callers) must go through here.
+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.loadEvents = loadEvents;
+exports.appendEvent = appendEvent;
+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 LOCK_STALE_MS = 30_000;
+const LOCK_MAX_ATTEMPTS = 3;
+const LOCK_RETRY_DELAY_MS = 50;
+// ----------------------------------------------------------------------------
+// loadEvents
+// ----------------------------------------------------------------------------
+/**
+ * Load events from `.caws/events.jsonl`.
+ *
+ * Outcomes:
+ *   - missing file → Ok({ events: [], warnings: [] })
+ *   - empty file → Ok({ events: [], warnings: [] })
+ *   - valid JSONL → Ok({ events, warnings: [] })
+ *   - trailing partial line → Ok({ events, warnings: [trailing_partial_line] })
+ *   - interior malformed line → Err
+ *   - line parses as JSON but fails validateChainedEvent → Err
+ */
+function loadEvents(cawsDir) {
+    const filePath = path.join(cawsDir, 'events.jsonl');
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, 'utf8');
+    }
+    catch (e) {
+        const cause = e;
+        if (cause.code === 'ENOENT') {
+            return (0, caws_kernel_1.ok)({ events: [], warnings: [] });
+        }
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.READ_IO_FAILED, `Failed to read events.jsonl: ${cause.message ?? 'unknown error'}.`, { subject: filePath, data: { code: cause.code } }));
+    }
+    return parseJsonlContent(raw, filePath);
+}
+function parseJsonlContent(raw, filePath) {
+    if (raw.length === 0)
+        return (0, caws_kernel_1.ok)({ events: [], warnings: [] });
+    const trailingNewline = raw.endsWith('\n');
+    // Split by '\n'. If the file ends with '\n', the final entry is ''.
+    const parts = raw.split('\n');
+    const lines = trailingNewline ? parts.slice(0, -1) : parts;
+    const events = [];
+    const warnings = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const isLast = i === lines.length - 1;
+        if (line.length === 0) {
+            // Interior empty lines are malformed. A truly empty file was handled above.
+            if (!isLast) {
+                return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.EVENTS_INTERIOR_MALFORMED_LINE, `events.jsonl line ${i + 1} is empty.`, { subject: filePath, data: { line: i + 1 } }));
+            }
+            // Trailing empty line without trailing newline shouldn't happen
+            // (split semantics) but skip if it does.
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch (e) {
+            const cause = e;
+            // Tolerate a trailing partial line (crash-recovery). Interior
+            // malformed JSON is a hard error.
+            if (isLast && !trailingNewline) {
+                warnings.push((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.EVENTS_TRAILING_PARTIAL_LINE, `events.jsonl ends with a partial line (crash-recovery tolerance).`, {
+                    subject: filePath,
+                    data: { line: i + 1, parse_error: cause.message ?? null },
+                }));
+                continue;
+            }
+            return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.EVENTS_INTERIOR_MALFORMED_LINE, `events.jsonl line ${i + 1} is not valid JSON: ${cause.message ?? 'unknown error'}.`, { subject: filePath, data: { line: i + 1 } }));
+        }
+        const validated = (0, caws_kernel_1.validateChainedEvent)(parsed);
+        if (!(0, caws_kernel_1.isOk)(validated)) {
+            // Wrap the kernel diagnostics with file + line metadata so the
+            // shell can render a useful pointer.
+            const wrapped = validated.errors.map((d) => ({
+                ...d,
+                subject: filePath,
+                data: { ...(d.data ?? {}), line: i + 1, source_rule: d.rule },
+                rule: rules_1.STORE_RULES.EVENTS_INVALID_EVENT_SHAPE,
+            }));
+            return (0, caws_kernel_1.err)(wrapped);
+        }
+        events.push(validated.value);
+    }
+    return (0, caws_kernel_1.ok)({ events, warnings });
+}
+// ----------------------------------------------------------------------------
+// appendEvent
+// ----------------------------------------------------------------------------
+/**
+ * Append a new event.
+ *
+ * Sequence under lock:
+ *   1. Acquire .caws/events.jsonl.lock (with stale-recovery + bounded retry).
+ *   2. Re-read the full events file to get the most-recent event.
+ *   3. Call prepareAppend(lastEvent ?? null, body).
+ *   4. Append the chained event as a JSON line + '\n'.
+ *   5. Release the lock.
+ *
+ * Returns the new ChainedEvent on success. On failure, the lock is
+ * released and no bytes are written.
+ *
+ * Callers MUST pass an `EventBody` (caller-side fields only). The store
+ * never accepts a pre-chained event — sequence and hash are kernel
+ * authority.
+ */
+function appendEvent(cawsDir, body) {
+    const eventsPath = path.join(cawsDir, 'events.jsonl');
+    const lockPath = `${eventsPath}.lock`;
+    // Ensure parent dir exists. We don't create .caws/ itself; that's the
+    // shell's bootstrap concern. But events.jsonl living somewhere with a
+    // missing parent is a programmer error.
+    if (!fs.existsSync(cawsDir)) {
+        throw new Error(`appendEvent: cawsDir does not exist: ${cawsDir}`);
+    }
+    const lockFd = acquireLock(lockPath);
+    if (!(0, caws_kernel_1.isOk)(lockFd))
+        return (0, caws_kernel_1.err)(lockFd.errors);
+    try {
+        const loaded = loadEvents(cawsDir);
+        if (!(0, caws_kernel_1.isOk)(loaded))
+            return (0, caws_kernel_1.err)(loaded.errors);
+        const prev = loaded.value.events[loaded.value.events.length - 1] ?? null;
+        const prepared = (0, caws_kernel_1.prepareAppend)(prev, body);
+        if (!(0, caws_kernel_1.isOk)(prepared)) {
+            // Wrap kernel diagnostics with the store rule id so callers can
+            // discriminate. Original rule is preserved in data.source_rule.
+            const wrapped = prepared.errors.map((d) => ({
+                ...d,
+                rule: rules_1.STORE_RULES.EVENTS_PREPARE_APPEND_REJECTED,
+                data: { ...(d.data ?? {}), source_rule: d.rule },
+            }));
+            return (0, caws_kernel_1.err)(wrapped);
+        }
+        const event = prepared.value;
+        const line = JSON.stringify(event) + '\n';
+        // Direct append — atomic-write is the wrong tool here because the
+        // file is append-only and we hold the lock.
+        let fd;
+        try {
+            fd = fs.openSync(eventsPath, 'a');
+            fs.writeFileSync(fd, line);
+            fs.fsyncSync(fd);
+        }
+        catch (e) {
+            const cause = e;
+            return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.WRITE_IO_FAILED, `Failed to append to events.jsonl: ${cause.message ?? 'unknown error'}.`, { subject: eventsPath, data: { code: cause.code } }));
+        }
+        finally {
+            if (fd !== undefined) {
+                try {
+                    fs.closeSync(fd);
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        }
+        return (0, caws_kernel_1.ok)(event);
+    }
+    finally {
+        releaseLock(lockFd.value, lockPath);
+    }
+}
+function acquireLock(lockPath) {
+    for (let attempt = 0; attempt < LOCK_MAX_ATTEMPTS; attempt++) {
+        try {
+            const fd = fs.openSync(lockPath, 'wx');
+            // Write the holder pid + timestamp so a future doctor can see who
+            // is holding the lock and when they took it.
+            try {
+                fs.writeFileSync(fd, JSON.stringify({ pid: process.pid, at: new Date().toISOString() }));
+                fs.fsyncSync(fd);
+            }
+            catch {
+                /* writing the lock body is best-effort; the lock itself is the file's existence */
+            }
+            return (0, caws_kernel_1.ok)({ fd });
+        }
+        catch (e) {
+            const cause = e;
+            if (cause.code !== 'EEXIST') {
+                return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.EVENTS_LOCK_CONTENTION, `Unexpected error acquiring events lock: ${cause.message ?? 'unknown error'}.`, { subject: lockPath, data: { code: cause.code } }));
+            }
+            // Stale-lock recovery.
+            const recovered = tryRecoverStaleLock(lockPath);
+            if (!recovered) {
+                // Lock is held by a fresh holder. Brief sleep, then retry.
+                sleepSyncMs(LOCK_RETRY_DELAY_MS);
+            }
+            // Either way, loop and try again.
+        }
+    }
+    return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.EVENTS_LOCK_CONTENTION, `Could not acquire events lock after ${LOCK_MAX_ATTEMPTS} attempts.`, { subject: lockPath }));
+}
+function releaseLock(handle, lockPath) {
+    try {
+        fs.closeSync(handle.fd);
+    }
+    catch {
+        /* ignore */
+    }
+    try {
+        fs.unlinkSync(lockPath);
+    }
+    catch {
+        /* ignore — best-effort */
+    }
+}
+function tryRecoverStaleLock(lockPath) {
+    try {
+        const stat = fs.statSync(lockPath);
+        const ageMs = Date.now() - stat.mtimeMs;
+        if (ageMs > LOCK_STALE_MS) {
+            fs.unlinkSync(lockPath);
+            return true;
+        }
+    }
+    catch {
+        // The file might have disappeared between attempts; treat that as
+        // recovery and retry.
+        return true;
+    }
+    return false;
+}
+function sleepSyncMs(ms) {
+    // Synchronous sleep without dragging in dependencies. Used only inside
+    // the lock-acquisition retry loop.
+    const end = Date.now() + ms;
+    // Atomics.wait is the clean tool here but requires a SharedArrayBuffer
+    // setup. Polling Date.now() is fine for the tens-of-ms scale we use.
+    while (Date.now() < end) {
+        // empty body — spinning briefly under contention is acceptable.
+    }
+}
+//# sourceMappingURL=events-store.js.map

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

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

package/dist/store/index.d.ts

@@ -0,0 +1,21 @@
+export { STORE_RULES, STORE_RULE_PREFIXES } from './rules';
+export type { StoreRule } from './rules';
+export type { EventsLoadResult, PolicyLoadResult, SpecsLoadResult, StoreSnapshot, } from './types';
+export { defaultGitRunner, resolveRepoRoot, storeDiagnostic, } from './repo-root';
+export type { GitRunner, RepoRoot, ResolveRepoRootOptions } from './repo-root';
+export { fsyncDir, writeFileAtomic } from './atomic-write';
+export { readJsonFile } from './json-store';
+export { readYamlFile, readYamlSource } from './yaml-store';
+export { loadSpecs } from './specs-store';
+export { loadPolicy } from './policy-store';
+export { loadWorktrees } from './worktrees-store';
+export { loadAgents } from './agents-store';
+export { appendEvent, loadEvents } from './events-store';
+export { applyRegistryPatch } from './apply-patch';
+export { loadWaivers, writeWaiver, markRevoked } from './waivers-store';
+export type { WaiversLoadResult } from './waivers-store';
+export { initProject, DEFAULT_POLICY_YAML } from './init-store';
+export type { InitOutcome, InitProjectResult } from './init-store';
+export { composeDoctorSnapshot, composeStoreSnapshot, } from './doctor-snapshot';
+export type { ComposeDoctorOptions, ComposeDoctorResult, ComposeOptions, } from './doctor-snapshot';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,GACf,MAAM,mBAAmB,CAAC"}

package/dist/store/index.js

@@ -0,0 +1,47 @@
+"use strict";
+// Node-only store layer — programmatic exports.
+//
+// This module is the bridge between the filesystem and the pure kernel.
+// It is consumed programmatically; no public CLI commands are registered
+// here. CLI command surface lands in Slice 5c.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeStoreSnapshot = exports.composeDoctorSnapshot = exports.DEFAULT_POLICY_YAML = exports.initProject = exports.markRevoked = exports.writeWaiver = exports.loadWaivers = exports.applyRegistryPatch = exports.loadEvents = exports.appendEvent = exports.loadAgents = exports.loadWorktrees = exports.loadPolicy = exports.loadSpecs = exports.readYamlSource = exports.readYamlFile = exports.readJsonFile = exports.writeFileAtomic = exports.fsyncDir = exports.storeDiagnostic = exports.resolveRepoRoot = exports.defaultGitRunner = exports.STORE_RULE_PREFIXES = exports.STORE_RULES = void 0;
+var rules_1 = require("./rules");
+Object.defineProperty(exports, "STORE_RULES", { enumerable: true, get: function () { return rules_1.STORE_RULES; } });
+Object.defineProperty(exports, "STORE_RULE_PREFIXES", { enumerable: true, get: function () { return rules_1.STORE_RULE_PREFIXES; } });
+var repo_root_1 = require("./repo-root");
+Object.defineProperty(exports, "defaultGitRunner", { enumerable: true, get: function () { return repo_root_1.defaultGitRunner; } });
+Object.defineProperty(exports, "resolveRepoRoot", { enumerable: true, get: function () { return repo_root_1.resolveRepoRoot; } });
+Object.defineProperty(exports, "storeDiagnostic", { enumerable: true, get: function () { return repo_root_1.storeDiagnostic; } });
+var atomic_write_1 = require("./atomic-write");
+Object.defineProperty(exports, "fsyncDir", { enumerable: true, get: function () { return atomic_write_1.fsyncDir; } });
+Object.defineProperty(exports, "writeFileAtomic", { enumerable: true, get: function () { return atomic_write_1.writeFileAtomic; } });
+var json_store_1 = require("./json-store");
+Object.defineProperty(exports, "readJsonFile", { enumerable: true, get: function () { return json_store_1.readJsonFile; } });
+var yaml_store_1 = require("./yaml-store");
+Object.defineProperty(exports, "readYamlFile", { enumerable: true, get: function () { return yaml_store_1.readYamlFile; } });
+Object.defineProperty(exports, "readYamlSource", { enumerable: true, get: function () { return yaml_store_1.readYamlSource; } });
+var specs_store_1 = require("./specs-store");
+Object.defineProperty(exports, "loadSpecs", { enumerable: true, get: function () { return specs_store_1.loadSpecs; } });
+var policy_store_1 = require("./policy-store");
+Object.defineProperty(exports, "loadPolicy", { enumerable: true, get: function () { return policy_store_1.loadPolicy; } });
+var worktrees_store_1 = require("./worktrees-store");
+Object.defineProperty(exports, "loadWorktrees", { enumerable: true, get: function () { return worktrees_store_1.loadWorktrees; } });
+var agents_store_1 = require("./agents-store");
+Object.defineProperty(exports, "loadAgents", { enumerable: true, get: function () { return agents_store_1.loadAgents; } });
+var events_store_1 = require("./events-store");
+Object.defineProperty(exports, "appendEvent", { enumerable: true, get: function () { return events_store_1.appendEvent; } });
+Object.defineProperty(exports, "loadEvents", { enumerable: true, get: function () { return events_store_1.loadEvents; } });
+var apply_patch_1 = require("./apply-patch");
+Object.defineProperty(exports, "applyRegistryPatch", { enumerable: true, get: function () { return apply_patch_1.applyRegistryPatch; } });
+var waivers_store_1 = require("./waivers-store");
+Object.defineProperty(exports, "loadWaivers", { enumerable: true, get: function () { return waivers_store_1.loadWaivers; } });
+Object.defineProperty(exports, "writeWaiver", { enumerable: true, get: function () { return waivers_store_1.writeWaiver; } });
+Object.defineProperty(exports, "markRevoked", { enumerable: true, get: function () { return waivers_store_1.markRevoked; } });
+var init_store_1 = require("./init-store");
+Object.defineProperty(exports, "initProject", { enumerable: true, get: function () { return init_store_1.initProject; } });
+Object.defineProperty(exports, "DEFAULT_POLICY_YAML", { enumerable: true, get: function () { return init_store_1.DEFAULT_POLICY_YAML; } });
+var doctor_snapshot_1 = require("./doctor-snapshot");
+Object.defineProperty(exports, "composeDoctorSnapshot", { enumerable: true, get: function () { return doctor_snapshot_1.composeDoctorSnapshot; } });
+Object.defineProperty(exports, "composeStoreSnapshot", { enumerable: true, get: function () { return doctor_snapshot_1.composeStoreSnapshot; } });
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/store/index.ts"],"names":[],"mappings":";AAAA,gDAAgD;AAChD,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,+CAA+C;;;AAE/C,iCAA2D;AAAlD,oGAAA,WAAW,OAAA;AAAE,4GAAA,mBAAmB,OAAA;AAUzC,yCAIqB;AAHnB,6GAAA,gBAAgB,OAAA;AAChB,4GAAA,eAAe,OAAA;AACf,4GAAA,eAAe,OAAA;AAIjB,+CAA2D;AAAlD,wGAAA,QAAQ,OAAA;AAAE,+GAAA,eAAe,OAAA;AAClC,2CAA4C;AAAnC,0GAAA,YAAY,OAAA;AACrB,2CAA4D;AAAnD,0GAAA,YAAY,OAAA;AAAE,4GAAA,cAAc,OAAA;AAErC,6CAA0C;AAAjC,wGAAA,SAAS,OAAA;AAClB,+CAA4C;AAAnC,0GAAA,UAAU,OAAA;AACnB,qDAAkD;AAAzC,gHAAA,aAAa,OAAA;AACtB,+CAA4C;AAAnC,0GAAA,UAAU,OAAA;AACnB,+CAAyD;AAAhD,2GAAA,WAAW,OAAA;AAAE,0GAAA,UAAU,OAAA;AAEhC,6CAAmD;AAA1C,iHAAA,kBAAkB,OAAA;AAE3B,iDAAwE;AAA/D,4GAAA,WAAW,OAAA;AAAE,4GAAA,WAAW,OAAA;AAAE,4GAAA,WAAW,OAAA;AAG9C,2CAAgE;AAAvD,yGAAA,WAAW,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAGzC,qDAG2B;AAFzB,wHAAA,qBAAqB,OAAA;AACrB,uHAAA,oBAAoB,OAAA"}

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

@@ -0,0 +1,21 @@
+import { type Policy, type Result } from '@paths.design/caws-kernel';
+export declare const DEFAULT_POLICY_YAML = "version: 1\nrisk_tiers:\n  '1':\n    max_files: 5\n    max_loc: 200\n  '2':\n    max_files: 15\n    max_loc: 600\n  '3':\n    max_files: 30\n    max_loc: 1500\ngates:\n  budget_limit:\n    enabled: true\n    mode: block\n  spec_completeness:\n    enabled: true\n    mode: block\n  scope_boundary:\n    enabled: true\n    mode: block\n  god_object:\n    enabled: true\n    mode: warn\n  todo_detection:\n    enabled: true\n    mode: warn\nedit_rules:\n  policy_and_code_same_pr: true\n  require_signed_commits: false\n  require_dual_control_for_governance: false\n";
+export type InitOutcome = 'created' | 'already_initialized';
+export interface InitProjectResult {
+    readonly outcome: InitOutcome;
+    /** Absolute paths of files/dirs newly created. Empty when already initialized. */
+    readonly created: readonly string[];
+    /** Validated policy (whether freshly seeded or already on disk). */
+    readonly policy: Policy;
+}
+/**
+ * Idempotent vNext init. Returns:
+ *
+ *   Ok({ outcome: 'created', created: [...], policy })
+ *   Ok({ outcome: 'already_initialized', created: [], policy })
+ *   Err  on legacy residue (INIT_LEGACY_RESIDUE) or write failure
+ *        (WRITE_IO_FAILED) or a default-policy that fails kernel
+ *        validation (INIT_DEFAULT_POLICY_INVALID).
+ */
+export declare function initProject(repoRoot: string): Result<InitProjectResult>;
+//# sourceMappingURL=init-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init-store.d.ts","sourceRoot":"","sources":["../../src/store/init-store.ts"],"names":[],"mappings":"AAiDA,OAAO,EAIL,KAAK,MAAM,EACX,KAAK,MAAM,EACZ,MAAM,2BAA2B,CAAC;AA0CnC,eAAO,MAAM,mBAAmB,wjBA+B/B,CAAC;AAMF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,qBAAqB,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AA4ED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,iBAAiB,CAAC,CA+F3B"}