@paths.design/caws-cli 11.1.6 → 11.1.8

package/dist/store/git-sparse-checkout.js

@@ -0,0 +1,101 @@
+"use strict";
+// Sparse-checkout helper for CAWS-created worktrees
+// (WORKTREE-SPEC-AUTHORITY-CONTROL-PLANE-001 A1).
+//
+// CAWS state is control-plane. The .caws/specs/ directory exists exactly
+// once for the project, owned by the main checkout. When `caws worktree
+// create` adds a linked worktree, git's default full checkout would
+// materialize .caws/specs/<id>.yaml into the worktree filesystem,
+// producing the v10.2 split-brain authority class: an editable spec
+// copy inside the worktree, divergent from control-plane bytes,
+// silently consulted by anything that walks cwd upward.
+//
+// This helper configures non-cone sparse-checkout on a freshly-added
+// worktree so the .caws/specs/ tree is excluded from checkout. The
+// rest of the worktree is a normal full checkout — the historic
+// objection to sparse-checkout (broken cross-module imports caused by
+// nearly-empty worktrees) is preserved by including everything OTHER
+// than the authority files.
+//
+// Sparse-checkout vs the worktree-guard.sh hook policy: the hook
+// (`.claude/hooks/worktree-guard.sh:52-56`) blocks agent-issued
+// `git sparse-checkout` commands because sparse-checkout can be
+// misused to hide source files and break work. This helper's use is
+// different: it excludes ONLY the .caws/specs/ authority files, never
+// source code, and runs from the CLI writer (via child_process.spawn)
+// which does not go through the Bash tool hook surface. The hook's
+// purpose is preserved.
+//
+// Pattern: `/*` includes everything; `!/.caws/specs/` excludes the
+// authority directory. Non-cone mode is required because cone mode
+// would force enumeration of all top-level directories. Non-cone
+// sparse-checkout requires git 2.27+, which is documented in the
+// spec's non_functional.reliability clause.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureWorktreeSparseCheckout = configureWorktreeSparseCheckout;
+const child_process_1 = require("child_process");
+/**
+ * Configure non-cone sparse-checkout on `wtPath` so that `.caws/specs/`
+ * is excluded from checkout, then run `git checkout` to materialize the
+ * remaining tree.
+ *
+ * Returns Result-shape `{ ok: true }` on success or `{ ok: false,
+ * reason }` on the first failing git invocation. The caller is
+ * responsible for compensating side effects (typically by running
+ * `git worktree remove --force <wtPath>` on the partially-created
+ * worktree).
+ *
+ * IMPORTANT: this function does NOT call `git worktree add`. The caller
+ * must have already added the worktree with `--no-checkout` so that no
+ * files have been materialized yet. Calling this on a worktree that
+ * was added with a normal full checkout would not retroactively remove
+ * already-checked-out `.caws/specs/` files.
+ */
+function configureWorktreeSparseCheckout(wtPath) {
+    // 1) Initialize sparse-checkout in non-cone mode.
+    const initResult = runGit(wtPath, ['sparse-checkout', 'init', '--no-cone']);
+    if (!initResult.ok)
+        return { ok: false, reason: initResult.reason, step: 'init' };
+    // 2) Set the pattern: include everything, exclude .caws/specs/.
+    //    Non-cone mode interprets these as gitignore-style patterns
+    //    relative to the worktree root. The leading slash in '/.caws/specs/'
+    //    anchors the exclusion to the worktree root (not subdirectories
+    //    named .caws/specs/ further down — there are none in this
+    //    project, but the anchor is correct discipline).
+    const setResult = runGit(wtPath, [
+        'sparse-checkout',
+        'set',
+        '--no-cone',
+        '/*',
+        '!/.caws/specs/',
+    ]);
+    if (!setResult.ok)
+        return { ok: false, reason: setResult.reason, step: 'set' };
+    // 3) Materialize the included files. `git worktree add --no-checkout`
+    //    leaves the worktree empty; this populates everything sparse-
+    //    checkout admits.
+    const checkoutResult = runGit(wtPath, ['checkout']);
+    if (!checkoutResult.ok)
+        return { ok: false, reason: checkoutResult.reason, step: 'checkout' };
+    return { ok: true };
+}
+function runGit(cwd, args) {
+    try {
+        const stdout = (0, child_process_1.execFileSync)('git', [...args], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        return { ok: true, stdout: stdout.toString() };
+    }
+    catch (e) {
+        const cause = e;
+        const stderr = cause.stderr instanceof Buffer
+            ? cause.stderr.toString()
+            : typeof cause.stderr === 'string'
+                ? cause.stderr
+                : (cause.message ?? 'unknown git error');
+        return { ok: false, reason: stderr.trim() };
+    }
+}
+//# sourceMappingURL=git-sparse-checkout.js.map

package/dist/store/git-sparse-checkout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-sparse-checkout.js","sourceRoot":"","sources":["../../src/store/git-sparse-checkout.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,kDAAkD;AAClD,EAAE;AACF,yEAAyE;AACzE,wEAAwE;AACxE,oEAAoE;AACpE,kEAAkE;AAClE,oEAAoE;AACpE,gEAAgE;AAChE,wDAAwD;AACxD,EAAE;AACF,qEAAqE;AACrE,mEAAmE;AACnE,gEAAgE;AAChE,sEAAsE;AACtE,qEAAqE;AACrE,4BAA4B;AAC5B,EAAE;AACF,iEAAiE;AACjE,gEAAgE;AAChE,gEAAgE;AAChE,oEAAoE;AACpE,sEAAsE;AACtE,sEAAsE;AACtE,mEAAmE;AACnE,wBAAwB;AACxB,EAAE;AACF,mEAAmE;AACnE,mEAAmE;AACnE,iEAAiE;AACjE,iEAAiE;AACjE,4CAA4C;;AAqB5C,0EA8BC;AAjDD,iDAA6C;AAE7C;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,+BAA+B,CAC7C,MAAc;IAEd,kDAAkD;IAClD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,iBAAiB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAC5E,IAAI,CAAC,UAAU,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAElF,gEAAgE;IAChE,gEAAgE;IAChE,yEAAyE;IACzE,oEAAoE;IACpE,8DAA8D;IAC9D,qDAAqD;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE;QAC/B,iBAAiB;QACjB,KAAK;QACL,WAAW;QACX,IAAI;QACJ,gBAAgB;KACjB,CAAC,CAAC;IACH,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAE/E,sEAAsE;IACtE,kEAAkE;IAClE,sBAAsB;IACtB,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IACpD,IAAI,CAAC,cAAc,CAAC,EAAE;QACpB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAExE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,MAAM,CAAC,GAAW,EAAE,IAAuB;IAClD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,4BAAY,EAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;YAC5C,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;IACjD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,CAAmD,CAAC;QAClE,MAAM,MAAM,GACV,KAAK,CAAC,MAAM,YAAY,MAAM;YAC5B,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE;YACzB,CAAC,CAAC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAChC,CAAC,CAAC,KAAK,CAAC,MAAM;gBACd,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,mBAAmB,CAAC,CAAC;QAC/C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/store/index.d.ts

@@ -7,11 +7,16 @@ export { fsyncDir, writeFileAtomic } from './atomic-write';
 export { readJsonFile } from './json-store';
 export { readYamlFile, readYamlSource } from './yaml-store';
 export { loadSpecs } from './specs-store';
+export { runSpecsMigrateScan, runSpecsMigrateApply, MIGRATION_REPORT_SCHEMA_VERSION, } from './specs-migration';
+export type { ScanEntry, ScanReport, ReportEntry, ReportVerdict, MigrationReport, ApplyResult as SpecsMigrateApplyResult, ScanOptions as SpecsMigrateScanOptions, ApplyOptions as SpecsMigrateApplyOptions, NonYamlObservation, } from './specs-migration';
 export { loadPolicy } from './policy-store';
 export { loadWorktrees } from './worktrees-store';
 export { loadAgents } from './agents-store';
-export { appendEvent, loadEvents } from './events-store';
+export { appendEvent, loadEvents, rotateEvents } from './events-store';
+export type { RotateEventsOptions } from './events-store';
 export { applyRegistryPatch } from './apply-patch';
+export { safeLeaseFilename, loadLeases, applyLeasePatch, applyLeasePatches, pruneLeasesByStatus, } from './leases-store';
+export type { LoadLeasesResult, PruneOptions, PruneResult, } from './leases-store';
 export { loadWaivers, writeWaiver, markRevoked } from './waivers-store';
 export type { WaiversLoadResult } from './waivers-store';
 export { initProject, DEFAULT_POLICY_YAML } from './init-store';

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

@@ -1 +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"}
+{"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;AAG1C,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,+BAA+B,GAChC,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,aAAa,EACb,eAAe,EACf,WAAW,IAAI,uBAAuB,EACtC,WAAW,IAAI,uBAAuB,EACtC,YAAY,IAAI,wBAAwB,EACxC,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,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,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAKnD,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,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

@@ -5,7 +5,7 @@
 // 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;
+exports.composeStoreSnapshot = exports.composeDoctorSnapshot = exports.DEFAULT_POLICY_YAML = exports.initProject = exports.markRevoked = exports.writeWaiver = exports.loadWaivers = exports.pruneLeasesByStatus = exports.applyLeasePatches = exports.applyLeasePatch = exports.loadLeases = exports.safeLeaseFilename = exports.applyRegistryPatch = exports.rotateEvents = exports.loadEvents = exports.appendEvent = exports.loadAgents = exports.loadWorktrees = exports.loadPolicy = exports.MIGRATION_REPORT_SCHEMA_VERSION = exports.runSpecsMigrateApply = exports.runSpecsMigrateScan = 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; } });
@@ -23,6 +23,11 @@ Object.defineProperty(exports, "readYamlFile", { enumerable: true, get: function
 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; } });
+// ─── v10→v11 spec migration (CAWS-MIGRATE-V10-SPECS-001) ─────────────────
+var specs_migration_1 = require("./specs-migration");
+Object.defineProperty(exports, "runSpecsMigrateScan", { enumerable: true, get: function () { return specs_migration_1.runSpecsMigrateScan; } });
+Object.defineProperty(exports, "runSpecsMigrateApply", { enumerable: true, get: function () { return specs_migration_1.runSpecsMigrateApply; } });
+Object.defineProperty(exports, "MIGRATION_REPORT_SCHEMA_VERSION", { enumerable: true, get: function () { return specs_migration_1.MIGRATION_REPORT_SCHEMA_VERSION; } });
 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");
@@ -32,8 +37,18 @@ Object.defineProperty(exports, "loadAgents", { enumerable: true, get: function (
 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; } });
+Object.defineProperty(exports, "rotateEvents", { enumerable: true, get: function () { return events_store_1.rotateEvents; } });
 var apply_patch_1 = require("./apply-patch");
 Object.defineProperty(exports, "applyRegistryPatch", { enumerable: true, get: function () { return apply_patch_1.applyRegistryPatch; } });
+// ─── leases (MULTI-AGENT-ACTIVITY-REGISTRY-001) ──────────────────────────
+// Lease I/O surface — separate from applyRegistryPatch. LeasePatch is
+// applied ONLY through applyLeasePatch / applyLeasePatches.
+var leases_store_1 = require("./leases-store");
+Object.defineProperty(exports, "safeLeaseFilename", { enumerable: true, get: function () { return leases_store_1.safeLeaseFilename; } });
+Object.defineProperty(exports, "loadLeases", { enumerable: true, get: function () { return leases_store_1.loadLeases; } });
+Object.defineProperty(exports, "applyLeasePatch", { enumerable: true, get: function () { return leases_store_1.applyLeasePatch; } });
+Object.defineProperty(exports, "applyLeasePatches", { enumerable: true, get: function () { return leases_store_1.applyLeasePatches; } });
+Object.defineProperty(exports, "pruneLeasesByStatus", { enumerable: true, get: function () { return leases_store_1.pruneLeasesByStatus; } });
 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; } });

package/dist/store/index.js.map

@@ -1 +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"}
+{"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;AAElB,4EAA4E;AAC5E,qDAI2B;AAHzB,sHAAA,mBAAmB,OAAA;AACnB,uHAAA,oBAAoB,OAAA;AACpB,kIAAA,+BAA+B,OAAA;AAcjC,+CAA4C;AAAnC,0GAAA,UAAU,OAAA;AACnB,qDAAkD;AAAzC,gHAAA,aAAa,OAAA;AACtB,+CAA4C;AAAnC,0GAAA,UAAU,OAAA;AACnB,+CAAuE;AAA9D,2GAAA,WAAW,OAAA;AAAE,0GAAA,UAAU,OAAA;AAAE,4GAAA,YAAY,OAAA;AAG9C,6CAAmD;AAA1C,iHAAA,kBAAkB,OAAA;AAE3B,4EAA4E;AAC5E,sEAAsE;AACtE,4DAA4D;AAC5D,+CAMwB;AALtB,iHAAA,iBAAiB,OAAA;AACjB,0GAAA,UAAU,OAAA;AACV,+GAAA,eAAe,OAAA;AACf,iHAAA,iBAAiB,OAAA;AACjB,mHAAA,mBAAmB,OAAA;AAQrB,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/leases-store.d.ts

@@ -0,0 +1,89 @@
+import { type Diagnostic, type LeasePatch, type LeaseRegistry, type Result } from '@paths.design/caws-kernel';
+export interface LoadLeasesResult {
+    readonly leases: LeaseRegistry;
+    readonly diagnostics: ReadonlyArray<Diagnostic>;
+}
+/**
+ * Validate a session_id for filesystem safety, returning the filename
+ * to use (with .json suffix) on success.
+ */
+export declare function safeLeaseFilename(sessionId: unknown): Result<string>;
+/**
+ * Load all lease files under .caws/leases/.
+ *
+ * LENIENT per file: a malformed individual lease produces a diagnostic
+ * in the returned diagnostics array and is excluded from the registry;
+ * the call returns ok with the parseable subset.
+ *
+ * STRICT on directory: an unreadable .caws/leases/ directory returns
+ * err with LEASE_DIR_UNREADABLE. A missing directory returns
+ * ok({ leases: {}, diagnostics: [] }) — leases are operational cache;
+ * absence is normal.
+ *
+ * Per-file failure classes (each emits one diagnostic, excludes the file):
+ *   - filename does not match the lease pattern (skipped silently —
+ *     these are not lease files, just other content in the dir)
+ *   - JSON parse failure → LEASE_FILE_MALFORMED
+ *   - JSON parses but is not an object → LEASE_FILE_MALFORMED
+ *   - session_id mismatch between filename and content → LEASE_FILE_MALFORMED
+ */
+export declare function loadLeases(cawsDir: string): Result<LoadLeasesResult>;
+/**
+ * Apply a single LeasePatch via atomic per-file write.
+ *
+ * Creates the leases directory if missing. No lock acquired (per spec
+ * invariant 11). No event emitted (per spec invariant 10 and doctrine
+ * §6 invariant 10).
+ *
+ * Patch semantics:
+ *   - write_lease: serialize patch.lease as JSON, atomic-write to
+ *     <cawsDir>/leases/<safe-session-id>.json.
+ *   - mark_stopped: read existing lease file; if absent, return ok with
+ *     a warning diagnostic (NOT a fabricated record); if present,
+ *     update status='stopped', stopped_at=patch.transitioned_at,
+ *     last_seen_reason='session_stop'; atomic-write back.
+ *   - delete_lease: fs.unlinkSync the lease file; idempotent on absence.
+ */
+export declare function applyLeasePatch(cawsDir: string, patch: LeasePatch): Result<{
+    readonly wrote: boolean;
+    readonly diagnostics: ReadonlyArray<Diagnostic>;
+}>;
+/**
+ * Apply a batch of lease patches. Per-patch failures do NOT abort the
+ * batch — each patch's diagnostics are aggregated into the return.
+ *
+ * Use for operator commands like prune that emit multiple delete_lease
+ * patches. Single-session register/heartbeat/stop go through
+ * applyLeasePatch directly.
+ */
+export declare function applyLeasePatches(cawsDir: string, patches: ReadonlyArray<LeasePatch>): Result<{
+    readonly applied: number;
+    readonly diagnostics: ReadonlyArray<Diagnostic>;
+}>;
+/**
+ * Operator-invoked prune: delete lease files matching a status + age
+ * threshold.
+ *
+ * Selection: status === target AND (now - reference) > retentionMs, where
+ * reference is `stopped_at` for status='stopped' and `last_active` for
+ * status='active' (with TTL-based read-side 'stale' bucketing).
+ *
+ * Default `dryRun: true` (caller must explicitly pass false to delete).
+ * Returns count of files that would be / were deleted plus any
+ * diagnostics from the delete operations.
+ */
+export interface PruneOptions {
+    readonly status: 'stopped' | 'stale';
+    /** Active records whose age exceeds this are bucketed as stale for the prune decision. */
+    readonly staleTtlMs?: number;
+    readonly retentionMs: number;
+    readonly now: Date;
+    readonly dryRun?: boolean;
+}
+export interface PruneResult {
+    readonly candidates: ReadonlyArray<string>;
+    readonly deleted: ReadonlyArray<string>;
+    readonly diagnostics: ReadonlyArray<Diagnostic>;
+}
+export declare function pruneLeasesByStatus(cawsDir: string, opts: PruneOptions): Result<PruneResult>;
+//# sourceMappingURL=leases-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"leases-store.d.ts","sourceRoot":"","sources":["../../src/store/leases-store.ts"],"names":[],"mappings":"AAoCA,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,MAAM,EACZ,MAAM,2BAA2B,CAAC;AA+BnC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAuCpE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,CA6FpE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,UAAU,GAChB,MAAM,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;CAAE,CAAC,CA2KtF;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,GACjC,MAAM,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;CAAE,CAAC,CAevF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IACrC,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACjD;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,GACjB,MAAM,CAAC,WAAW,CAAC,CAyDrB"}