@paths.design/caws-cli 10.2.0 → 11.1.0

package/dist/store/specs-writer.js

@@ -0,0 +1,506 @@
+"use strict";
+// Spec lifecycle writer.
+//
+// CLI-SPECS-001: store-layer mutations for spec lifecycle. Composes
+// lifecycle-transaction + yaml-patch + appendEvent into typed lifecycle
+// operations:
+//
+//   createSpec  — write a new .caws/specs/<id>.yaml (active) + spec_created
+//   closeSpec   — raw-byte patch lifecycle_state/resolution/closure_notes
+//                  /updated_at on existing spec + spec_closed
+//   archiveSpec — move .caws/specs/<id>.yaml → .caws/specs/.archive/<id>.yaml,
+//                  patch lifecycle_state → archived + spec_archived
+//
+// Every operation:
+//   - acquires the lifecycle lock
+//   - validates plan via kernel (parseAndValidateSpec on planned bytes)
+//   - performs writes through atomicWrite with preserveMode
+//   - appends events through appendEvent (the SOLE v11 events writer)
+//   - rolls back on failure with typed partial-failure outcomes
+//
+// What this module does NOT do:
+//   - CLI argument parsing (that's in shell/commands/specs.ts)
+//   - Rendering (shell layer)
+//   - Concurrent worktree mutations (Slice 6 surface)
+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.createSpec = createSpec;
+exports.closeSpec = closeSpec;
+exports.archiveSpec = archiveSpec;
+exports.listSpecs = listSpecs;
+exports.showSpec = showSpec;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const caws_kernel_1 = require("@paths.design/caws-kernel");
+const events_store_1 = require("./events-store");
+const lifecycle_transaction_1 = require("./lifecycle-transaction");
+const lifecycle_lock_1 = require("./lifecycle-lock");
+const repo_root_1 = require("./repo-root");
+const rules_1 = require("./rules");
+const specs_store_1 = require("./specs-store");
+const yaml_patch_1 = require("./yaml-patch");
+const yaml_store_1 = require("./yaml-store");
+// ─── Path helpers ────────────────────────────────────────────────────────
+function specPath(cawsDir, id) {
+    return path.join(cawsDir, 'specs', `${id}.yaml`);
+}
+function archivedSpecPath(cawsDir, id) {
+    return path.join(cawsDir, 'specs', '.archive', `${id}.yaml`);
+}
+/** Find a spec on disk under either active or archived locations. */
+function findSpecPath(cawsDir, id) {
+    const active = specPath(cawsDir, id);
+    if (fs.existsSync(active))
+        return active;
+    const archived = archivedSpecPath(cawsDir, id);
+    if (fs.existsSync(archived))
+        return archived;
+    return null;
+}
+// ─── ID validation (mirrors kernel regex) ────────────────────────────────
+const SPEC_ID_PATTERN = /^[A-Z][A-Z0-9]*(-[A-Z0-9]+)*-\d+[a-z]*$/;
+function validateSpecId(id) {
+    if (typeof id !== 'string' || id.length === 0) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, 'Spec id is required.', { subject: 'id' }));
+    }
+    if (!SPEC_ID_PATTERN.test(id)) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, `Spec id "${id}" does not match the v11 pattern (e.g., FEAT-001, CLI-SPECS-001).`, { subject: id, data: { pattern: SPEC_ID_PATTERN.source } }));
+    }
+    return (0, caws_kernel_1.ok)(true);
+}
+// ─── Spec rendering for create ───────────────────────────────────────────
+function renderInitialSpecYaml(input) {
+    const now = (input.now ?? (() => new Date()))().toISOString();
+    const state = input.initialState ?? 'active';
+    // Render a minimum-viable v11 spec. Plain-string fields are
+    // single-quoted to be defensive against embedded colons. The body
+    // is intentionally minimal but satisfies the kernel's structural
+    // requirements (non-empty arrays where the schema demands them).
+    // The user fills in concrete values before iteration.
+    return [
+        `id: ${input.id}`,
+        `title: '${input.title.replace(/'/g, "''")}'`,
+        `risk_tier: ${input.riskTier}`,
+        `mode: ${input.mode}`,
+        `lifecycle_state: ${state}`,
+        `created_at: '${now}'`,
+        `updated_at: '${now}'`,
+        `blast_radius:`,
+        `  modules:`,
+        `    - 'TODO: list one or more modules this spec touches.'`,
+        `  data_migration: false`,
+        `operational_rollback_slo: 5m`,
+        `scope:`,
+        `  in:`,
+        `    - 'TODO: list the file(s) or directories this spec authorizes.'`,
+        `  out: []`,
+        `invariants:`,
+        `  - 'TODO: describe one invariant this spec guarantees.'`,
+        `acceptance:`,
+        `  - id: A1`,
+        `    given: 'TODO'`,
+        `    when: 'TODO'`,
+        `    then: 'TODO'`,
+        `non_functional: {}`,
+        `contracts: []`,
+        ``,
+    ].join('\n');
+}
+// ─── createSpec ──────────────────────────────────────────────────────────
+function createSpec(cawsDir, input) {
+    const idValidation = validateSpecId(input.id);
+    if (!idValidation.ok)
+        return idValidation;
+    // Refuse duplicate ids (in either active or archived location).
+    const existing = findSpecPath(cawsDir, input.id);
+    if (existing !== null) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, `Spec "${input.id}" already exists at ${existing}.`, { subject: input.id, data: { existing_path: existing } }));
+    }
+    const targetPath = specPath(cawsDir, input.id);
+    const newBytes = renderInitialSpecYaml(input);
+    // Validate the planned YAML through the kernel BEFORE we write or
+    // append events.
+    const parsed = (0, caws_kernel_1.parseAndValidateSpec)(newBytes);
+    if (!(0, caws_kernel_1.isOk)(parsed)) {
+        return (0, caws_kernel_1.err)(parsed.errors.map((d) => (0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, d.message, {
+            subject: d.subject ?? input.id,
+            data: { source_rule: d.rule },
+        })));
+    }
+    const now = (input.now ?? (() => new Date()))().toISOString();
+    const event = {
+        event: 'spec_created',
+        ts: now,
+        actor: input.actor,
+        spec_id: input.id,
+        data: {
+            title: input.title,
+            risk_tier: input.riskTier,
+            mode: input.mode,
+            lifecycle_state: input.initialState ?? 'active',
+        },
+    };
+    const txnResult = (0, lifecycle_lock_1.withLifecycleLock)(cawsDir, () => (0, lifecycle_transaction_1.runLifecycleTransaction)({
+        cawsDir,
+        plannedWrites: [{ path: targetPath, contents: newBytes }],
+        events: [event],
+    }));
+    if (!txnResult.ok) {
+        return (0, caws_kernel_1.err)(txnResult.errors);
+    }
+    return mapTxnToOutcome(txnResult.value, input.id, targetPath);
+}
+// ─── closeSpec ───────────────────────────────────────────────────────────
+function closeSpec(cawsDir, input) {
+    const idValidation = validateSpecId(input.id);
+    if (!idValidation.ok)
+        return idValidation;
+    const targetPath = specPath(cawsDir, input.id);
+    if (!fs.existsSync(targetPath)) {
+        // Check archive too — if it's already archived, this is a different
+        // kind of error than "not found."
+        const archived = archivedSpecPath(cawsDir, input.id);
+        if (fs.existsSync(archived)) {
+            return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, `Spec "${input.id}" is archived; cannot close (legal transitions: active → closed → archived).`, { subject: input.id }));
+        }
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, `Spec "${input.id}" not found at ${targetPath}.`, { subject: input.id }));
+    }
+    // Load and verify the current state.
+    const sourceResult = (0, yaml_store_1.readYamlSource)(targetPath);
+    if (!(0, caws_kernel_1.isOk)(sourceResult))
+        return (0, caws_kernel_1.err)(sourceResult.errors);
+    const originalBytes = sourceResult.value;
+    const parsed = (0, caws_kernel_1.parseAndValidateSpec)(originalBytes);
+    if (!(0, caws_kernel_1.isOk)(parsed)) {
+        return (0, caws_kernel_1.err)(parsed.errors.map((d) => (0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, d.message, {
+            subject: d.subject ?? input.id,
+            data: { source_rule: d.rule },
+        })));
+    }
+    const spec = parsed.value;
+    if (spec.lifecycle_state !== 'active') {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, `Spec "${input.id}" is in lifecycle_state "${spec.lifecycle_state}"; only active specs can be closed.`, { subject: input.id, data: { current_state: spec.lifecycle_state } }));
+    }
+    // Raw-byte patch sequence:
+    //   1. lifecycle_state → closed
+    //   2. insert resolution after lifecycle_state
+    //   3. if reason: insert closure_notes after resolution
+    //   4. updated_at → now
+    const now = (input.now ?? (() => new Date()))().toISOString();
+    let patched = originalBytes;
+    const step1 = (0, yaml_patch_1.setTopLevelScalar)(patched, 'lifecycle_state', 'closed');
+    if (!step1.ok)
+        return (0, caws_kernel_1.err)(step1.errors);
+    patched = step1.value;
+    // Insert resolution after lifecycle_state. If resolution already
+    // exists (e.g., from a prior failed transaction), update it instead.
+    const hasResolution = /^resolution:/m.test(patched);
+    if (hasResolution) {
+        const step2 = (0, yaml_patch_1.setTopLevelScalar)(patched, 'resolution', input.resolution);
+        if (!step2.ok)
+            return (0, caws_kernel_1.err)(step2.errors);
+        patched = step2.value;
+    }
+    else {
+        const step2 = (0, yaml_patch_1.insertTopLevelScalarAfter)(patched, 'lifecycle_state', 'resolution', input.resolution);
+        if (!step2.ok)
+            return (0, caws_kernel_1.err)(step2.errors);
+        patched = step2.value;
+    }
+    if (input.reason !== undefined && input.reason.length > 0) {
+        const escaped = `'${input.reason.replace(/'/g, "''")}'`;
+        const hasNotes = /^closure_notes:/m.test(patched);
+        if (hasNotes) {
+            const step3 = (0, yaml_patch_1.setTopLevelScalar)(patched, 'closure_notes', escaped);
+            if (!step3.ok)
+                return (0, caws_kernel_1.err)(step3.errors);
+            patched = step3.value;
+        }
+        else {
+            const step3 = (0, yaml_patch_1.insertTopLevelScalarAfter)(patched, 'resolution', 'closure_notes', escaped);
+            if (!step3.ok)
+                return (0, caws_kernel_1.err)(step3.errors);
+            patched = step3.value;
+        }
+    }
+    const step4 = (0, yaml_patch_1.setTopLevelScalar)(patched, 'updated_at', `'${now}'`);
+    if (!step4.ok)
+        return (0, caws_kernel_1.err)(step4.errors);
+    patched = step4.value;
+    // Validate the patched bytes through the kernel before write.
+    const reparsed = (0, caws_kernel_1.parseAndValidateSpec)(patched);
+    if (!(0, caws_kernel_1.isOk)(reparsed)) {
+        return (0, caws_kernel_1.err)(reparsed.errors.map((d) => (0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, d.message, {
+            subject: d.subject ?? input.id,
+            data: { source_rule: d.rule, hint: 'planned-bytes validation failed' },
+        })));
+    }
+    const eventData = { resolution: input.resolution };
+    if (input.reason !== undefined && input.reason.length > 0) {
+        eventData.closure_notes = input.reason;
+    }
+    if (input.mergeCommit !== undefined)
+        eventData.merge_commit = input.mergeCommit;
+    if (input.supersededBy !== undefined)
+        eventData.superseded_by = input.supersededBy;
+    const event = {
+        event: 'spec_closed',
+        ts: now,
+        actor: input.actor,
+        spec_id: input.id,
+        data: eventData,
+    };
+    const txnResult = (0, lifecycle_lock_1.withLifecycleLock)(cawsDir, () => (0, lifecycle_transaction_1.runLifecycleTransaction)({
+        cawsDir,
+        plannedWrites: [{ path: targetPath, contents: patched }],
+        events: [event],
+    }));
+    if (!txnResult.ok) {
+        return (0, caws_kernel_1.err)(txnResult.errors);
+    }
+    return mapTxnToOutcome(txnResult.value, input.id, targetPath);
+}
+// ─── archiveSpec ─────────────────────────────────────────────────────────
+function archiveSpec(cawsDir, input) {
+    const idValidation = validateSpecId(input.id);
+    if (!idValidation.ok)
+        return idValidation;
+    const fromPath = specPath(cawsDir, input.id);
+    if (!fs.existsSync(fromPath)) {
+        const archived = archivedSpecPath(cawsDir, input.id);
+        if (fs.existsSync(archived)) {
+            return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, `Spec "${input.id}" is already archived at ${archived}.`, { subject: input.id }));
+        }
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, `Spec "${input.id}" not found at ${fromPath}.`, { subject: input.id }));
+    }
+    // Validate current state: must be closed.
+    const sourceResult = (0, yaml_store_1.readYamlSource)(fromPath);
+    if (!(0, caws_kernel_1.isOk)(sourceResult))
+        return (0, caws_kernel_1.err)(sourceResult.errors);
+    const originalBytes = sourceResult.value;
+    const parsed = (0, caws_kernel_1.parseAndValidateSpec)(originalBytes);
+    if (!(0, caws_kernel_1.isOk)(parsed)) {
+        return (0, caws_kernel_1.err)(parsed.errors.map((d) => (0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, d.message, {
+            subject: d.subject ?? input.id,
+            data: { source_rule: d.rule },
+        })));
+    }
+    const spec = parsed.value;
+    if (spec.lifecycle_state !== 'closed') {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, `Spec "${input.id}" is in lifecycle_state "${spec.lifecycle_state}"; only closed specs can be archived.`, { subject: input.id, data: { current_state: spec.lifecycle_state } }));
+    }
+    const now = (input.now ?? (() => new Date()))().toISOString();
+    const toPath = archivedSpecPath(cawsDir, input.id);
+    // Patch lifecycle_state → archived and bump updated_at on a copy.
+    let patched = originalBytes;
+    const s1 = (0, yaml_patch_1.setTopLevelScalar)(patched, 'lifecycle_state', 'archived');
+    if (!s1.ok)
+        return (0, caws_kernel_1.err)(s1.errors);
+    patched = s1.value;
+    const s2 = (0, yaml_patch_1.setTopLevelScalar)(patched, 'updated_at', `'${now}'`);
+    if (!s2.ok)
+        return (0, caws_kernel_1.err)(s2.errors);
+    patched = s2.value;
+    // Validate.
+    const reparsed = (0, caws_kernel_1.parseAndValidateSpec)(patched);
+    if (!(0, caws_kernel_1.isOk)(reparsed)) {
+        return (0, caws_kernel_1.err)(reparsed.errors.map((d) => (0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, d.message, {
+            subject: d.subject ?? input.id,
+            data: { source_rule: d.rule, hint: 'planned-bytes validation failed' },
+        })));
+    }
+    // Ensure the archive dir exists. fs.renameSync requires it.
+    try {
+        fs.mkdirSync(path.dirname(toPath), { recursive: true });
+    }
+    catch (e) {
+        const cause = e;
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_WRITE_FAILED, `Failed to create archive directory: ${cause.message ?? 'unknown'}.`, { subject: path.dirname(toPath) }));
+    }
+    // Filesystem-move pattern: we write the patched bytes to the new
+    // path via the transaction, then delete the source. The transaction
+    // doesn't model moves natively, so we do this in two phases inside
+    // the same lock:
+    //   1. lifecycle-transaction: write toPath + append spec_archived
+    //   2. AFTER transaction success: unlink fromPath
+    //
+    // If step 2 fails, we surface the partial-failure but the audit log
+    // already records the move intent. The next doctor pass will see
+    // the spec in BOTH locations and surface that as a doctor finding.
+    const fromRel = path.relative(path.join(cawsDir, '..'), fromPath);
+    const toRel = path.relative(path.join(cawsDir, '..'), toPath);
+    const event = {
+        event: 'spec_archived',
+        ts: now,
+        actor: input.actor,
+        spec_id: input.id,
+        data: { from_path: fromRel, to_path: toRel },
+    };
+    // Capture original bytes so we can roll back the unlink in
+    // emergencies (rare but worth tracking).
+    let unlinkOk = false;
+    let unlinkError = null;
+    const txnResult = (0, lifecycle_lock_1.withLifecycleLock)(cawsDir, () => {
+        const r = (0, lifecycle_transaction_1.runLifecycleTransaction)({
+            cawsDir,
+            plannedWrites: [{ path: toPath, contents: patched }],
+            events: [event],
+        });
+        if (!r.ok)
+            return r;
+        if (r.value.kind !== 'success')
+            return r;
+        // Transaction wrote toPath + appended event. Now remove fromPath.
+        try {
+            fs.unlinkSync(fromPath);
+            unlinkOk = true;
+        }
+        catch (e) {
+            const cause = e;
+            unlinkError = cause.message ?? 'unknown unlink error';
+        }
+        return r;
+    });
+    // Reason flows into closure_notes ONLY if the user passed one; archive
+    // event schema does NOT take closure_notes, but we attach the reason
+    // to a follow-up evidence record path in future versions. For v11.1
+    // archive, we accept the --reason for parity with close but the
+    // schema does not carry it.
+    void input.reason;
+    if (!txnResult.ok) {
+        return (0, caws_kernel_1.err)(txnResult.errors);
+    }
+    if (txnResult.value.kind !== 'success') {
+        return (0, caws_kernel_1.ok)({
+            kind: 'partial_failure_recovered',
+            cause: txnResult.value.cause,
+        });
+    }
+    if (!unlinkOk) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PARTIAL_FAILURE_UNRECOVERED, `Archive write succeeded and spec_archived event appended, but original file unlink failed (${unlinkError}). Spec now exists in BOTH active and archived locations.`, {
+            subject: input.id,
+            data: {
+                from_path: fromPath,
+                to_path: toPath,
+                recovery_instruction: `Manually remove ${fromPath} once you've confirmed ${toPath} is intact.`,
+            },
+        }));
+    }
+    return (0, caws_kernel_1.ok)({ kind: 'success', id: input.id, path: toPath });
+}
+// ─── Outcome mapper ──────────────────────────────────────────────────────
+function mapTxnToOutcome(result, id, targetPath) {
+    if (result.kind === 'success') {
+        return (0, caws_kernel_1.ok)({ kind: 'success', id, path: targetPath });
+    }
+    if (result.kind === 'partial_failure_recovered') {
+        return (0, caws_kernel_1.ok)({ kind: 'partial_failure_recovered', cause: result.cause });
+    }
+    // partial_failure_unrecovered: this should already have surfaced as
+    // an Err from runLifecycleTransaction, but we map defensively.
+    return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PARTIAL_FAILURE_UNRECOVERED, `Spec "${id}" lifecycle transaction left partial state.`, {
+        subject: id,
+        data: {
+            writes_completed: result.writesCompleted,
+            rolled_back: result.rolledBack,
+            rollback_failed: result.rollbackFailed,
+            recovery_instruction: result.recoveryInstruction,
+        },
+    }));
+}
+/** List specs by lifecycle state, optionally including archived ones. */
+function listSpecs(cawsDir, options = {}) {
+    const activeResult = (0, specs_store_1.loadSpecs)(cawsDir);
+    const active = activeResult.specs.map((spec) => ({
+        id: spec.id,
+        title: spec.title,
+        lifecycle_state: spec.lifecycle_state,
+        path: specPath(cawsDir, spec.id),
+    }));
+    const archived = [];
+    if (options.includeArchived === true) {
+        const archiveDir = path.join(cawsDir, 'specs', '.archive');
+        if (fs.existsSync(archiveDir)) {
+            try {
+                const entries = fs.readdirSync(archiveDir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (!entry.isFile())
+                        continue;
+                    if (!entry.name.endsWith('.yaml') && !entry.name.endsWith('.yml'))
+                        continue;
+                    const fullPath = path.join(archiveDir, entry.name);
+                    const src = (0, yaml_store_1.readYamlSource)(fullPath);
+                    if (!(0, caws_kernel_1.isOk)(src))
+                        continue;
+                    const parsed = (0, caws_kernel_1.parseAndValidateSpec)(src.value);
+                    if (!(0, caws_kernel_1.isOk)(parsed))
+                        continue;
+                    const spec = parsed.value;
+                    archived.push({
+                        id: spec.id,
+                        title: spec.title,
+                        lifecycle_state: spec.lifecycle_state,
+                        path: fullPath,
+                    });
+                }
+            }
+            catch {
+                // Best-effort archive listing.
+            }
+        }
+    }
+    return (0, caws_kernel_1.ok)({ active, archived });
+}
+/** Find a spec by id under active or archive locations. */
+function showSpec(cawsDir, id) {
+    const idValidation = validateSpecId(id);
+    if (!idValidation.ok)
+        return idValidation;
+    const fullPath = findSpecPath(cawsDir, id);
+    if (fullPath === null) {
+        return (0, caws_kernel_1.err)((0, repo_root_1.storeDiagnostic)(rules_1.STORE_RULES.LIFECYCLE_PLAN_REJECTED, `Spec "${id}" not found in .caws/specs/ or .caws/specs/.archive/.`, { subject: id }));
+    }
+    const sourceResult = (0, yaml_store_1.readYamlSource)(fullPath);
+    if (!(0, caws_kernel_1.isOk)(sourceResult))
+        return (0, caws_kernel_1.err)(sourceResult.errors);
+    const parsed = (0, caws_kernel_1.parseAndValidateSpec)(sourceResult.value);
+    if (!(0, caws_kernel_1.isOk)(parsed))
+        return (0, caws_kernel_1.err)(parsed.errors);
+    return (0, caws_kernel_1.ok)({ spec: parsed.value, path: fullPath, source: sourceResult.value });
+}
+// Unused import elimination: surface appendEvent so future direct-event
+// flows (if any) compile against the same surface as evidence/waiver.
+void events_store_1.appendEvent;
+//# sourceMappingURL=specs-writer.js.map

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

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