@paths.design/caws-cli 11.1.6 → 11.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (93) hide show
  1. package/README.md +1 -1
  2. package/dist/init/hook-packs/manifest-claude-code.d.ts +1 -1
  3. package/dist/init/hook-packs/manifest-claude-code.d.ts.map +1 -1
  4. package/dist/init/hook-packs/manifest-claude-code.js +59 -6
  5. package/dist/init/hook-packs/manifest-claude-code.js.map +1 -1
  6. package/dist/init/hook-packs/types.js +1 -1
  7. package/dist/init/hook-packs/types.js.map +1 -1
  8. package/dist/shell/commands/agents.d.ts +49 -0
  9. package/dist/shell/commands/agents.d.ts.map +1 -0
  10. package/dist/shell/commands/agents.js +577 -0
  11. package/dist/shell/commands/agents.js.map +1 -0
  12. package/dist/shell/commands/claim.d.ts.map +1 -1
  13. package/dist/shell/commands/claim.js +3 -4
  14. package/dist/shell/commands/claim.js.map +1 -1
  15. package/dist/shell/commands/status.d.ts +12 -0
  16. package/dist/shell/commands/status.d.ts.map +1 -1
  17. package/dist/shell/commands/status.js +236 -21
  18. package/dist/shell/commands/status.js.map +1 -1
  19. package/dist/shell/commands/worktree.d.ts +9 -0
  20. package/dist/shell/commands/worktree.d.ts.map +1 -1
  21. package/dist/shell/commands/worktree.js +302 -0
  22. package/dist/shell/commands/worktree.js.map +1 -1
  23. package/dist/shell/index.d.ts +4 -2
  24. package/dist/shell/index.d.ts.map +1 -1
  25. package/dist/shell/index.js +12 -1
  26. package/dist/shell/index.js.map +1 -1
  27. package/dist/shell/register.d.ts.map +1 -1
  28. package/dist/shell/register.js +150 -0
  29. package/dist/shell/register.js.map +1 -1
  30. package/dist/shell/render/status.d.ts +7 -1
  31. package/dist/shell/render/status.d.ts.map +1 -1
  32. package/dist/shell/render/status.js +72 -0
  33. package/dist/shell/render/status.js.map +1 -1
  34. package/dist/store/agents-store.d.ts.map +1 -1
  35. package/dist/store/agents-store.js +9 -0
  36. package/dist/store/agents-store.js.map +1 -1
  37. package/dist/store/apply-patch.d.ts.map +1 -1
  38. package/dist/store/apply-patch.js +15 -0
  39. package/dist/store/apply-patch.js.map +1 -1
  40. package/dist/store/doctor-snapshot.d.ts.map +1 -1
  41. package/dist/store/doctor-snapshot.js +143 -3
  42. package/dist/store/doctor-snapshot.js.map +1 -1
  43. package/dist/store/git-sparse-checkout.d.ts +25 -0
  44. package/dist/store/git-sparse-checkout.d.ts.map +1 -0
  45. package/dist/store/git-sparse-checkout.js +101 -0
  46. package/dist/store/git-sparse-checkout.js.map +1 -0
  47. package/dist/store/index.d.ts +2 -0
  48. package/dist/store/index.d.ts.map +1 -1
  49. package/dist/store/index.js +10 -1
  50. package/dist/store/index.js.map +1 -1
  51. package/dist/store/leases-store.d.ts +89 -0
  52. package/dist/store/leases-store.d.ts.map +1 -0
  53. package/dist/store/leases-store.js +369 -0
  54. package/dist/store/leases-store.js.map +1 -0
  55. package/dist/store/lifecycle-transaction.d.ts.map +1 -1
  56. package/dist/store/lifecycle-transaction.js +34 -1
  57. package/dist/store/lifecycle-transaction.js.map +1 -1
  58. package/dist/store/rules.d.ts +21 -1
  59. package/dist/store/rules.d.ts.map +1 -1
  60. package/dist/store/rules.js +22 -0
  61. package/dist/store/rules.js.map +1 -1
  62. package/dist/store/types.d.ts +25 -1
  63. package/dist/store/types.d.ts.map +1 -1
  64. package/dist/store/worktrees-migration.d.ts +141 -0
  65. package/dist/store/worktrees-migration.d.ts.map +1 -0
  66. package/dist/store/worktrees-migration.js +356 -0
  67. package/dist/store/worktrees-migration.js.map +1 -0
  68. package/dist/store/worktrees-writer.d.ts.map +1 -1
  69. package/dist/store/worktrees-writer.js +37 -1
  70. package/dist/store/worktrees-writer.js.map +1 -1
  71. package/package.json +2 -2
  72. package/templates/hook-packs/claude-code/CLAUDE.md +5 -5
  73. package/templates/hook-packs/claude-code/agent-heartbeat.sh +131 -0
  74. package/templates/hook-packs/claude-code/agent-register.sh +62 -0
  75. package/templates/hook-packs/claude-code/agent-stop.sh +51 -0
  76. package/templates/hook-packs/claude-code/audit.sh +1 -1
  77. package/templates/hook-packs/claude-code/block-dangerous.sh +1 -1
  78. package/templates/hook-packs/claude-code/classify_command.py +1 -1
  79. package/templates/hook-packs/claude-code/dispatch/post_tool_use.sh +1 -1
  80. package/templates/hook-packs/claude-code/dispatch/pre_tool_use.sh +11 -2
  81. package/templates/hook-packs/claude-code/dispatch/session_start.sh +6 -2
  82. package/templates/hook-packs/claude-code/dispatch/stop.sh +7 -2
  83. package/templates/hook-packs/claude-code/guard-strikes.sh +1 -1
  84. package/templates/hook-packs/claude-code/lib/parse-input.sh +1 -1
  85. package/templates/hook-packs/claude-code/lib/run-handlers.sh +1 -1
  86. package/templates/hook-packs/claude-code/reset-danger-latch.sh +1 -1
  87. package/templates/hook-packs/claude-code/reset-strikes.sh +1 -1
  88. package/templates/hook-packs/claude-code/runtime-paths.sh +1 -1
  89. package/templates/hook-packs/claude-code/scope-guard.sh +1 -1
  90. package/templates/hook-packs/claude-code/session-caws-status.sh +7 -1
  91. package/templates/hook-packs/claude-code/session-log.sh +1 -1
  92. package/templates/hook-packs/claude-code/worktree-guard.sh +130 -4
  93. package/templates/hook-packs/claude-code/worktree-write-guard.sh +133 -18
package/README.md CHANGED
@@ -61,7 +61,7 @@ the complete doctrine, command surface, and architectural invariants.
61
61
  ## Installation
62
62
 
63
63
  ```bash
64
- npm install -g @paths.design/caws-cli@^11.0.0
64
+ npm install -g @paths.design/caws-cli@^11.1.0
65
65
  ```
66
66
 
67
67
  The package depends on `@paths.design/caws-kernel@^1.0.0` (the pure
@@ -1,4 +1,4 @@
1
1
  import type { HookPackV1 } from './types';
2
- export declare const CLAUDE_CODE_PACK_VERSION = 2;
2
+ export declare const CLAUDE_CODE_PACK_VERSION = 5;
3
3
  export declare const CLAUDE_CODE_PACK: HookPackV1;
4
4
  //# sourceMappingURL=manifest-claude-code.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"manifest-claude-code.d.ts","sourceRoot":"","sources":["../../../src/init/hook-packs/manifest-claude-code.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAO1C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAO,MAAM,gBAAgB,EAAE,UA2K9B,CAAC"}
1
+ {"version":3,"file":"manifest-claude-code.d.ts","sourceRoot":"","sources":["../../../src/init/hook-packs/manifest-claude-code.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AA4B1C,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAO,MAAM,gBAAgB,EAAE,UAsM9B,CAAC"}
@@ -7,7 +7,7 @@
7
7
  // session's tool calls.
8
8
  //
9
9
  // Lineage entries this pack covers — see
10
- // packages/caws-cli/docs-status/failure-lineage.md:
10
+ // docs/failure-lineage.md:
11
11
  // Entry 1 — git init catastrophic deletion (block-dangerous + classify_command)
12
12
  // Entry 4 — worktree cross-contamination, inherited-dirty-state (worktree-guard)
13
13
  // Entry 6 — stash-and-destroy (worktree-guard)
@@ -17,14 +17,41 @@
17
17
  // Entry 13 — working-spec.yaml baseline clobber (worktree-write-guard)
18
18
  // Entry 16 — adjudicator overstep / role partitioning (the pack itself)
19
19
  // Entry 17 — git --bare init bypass + danger latch (classify_command + block-dangerous + reset-danger-latch)
20
+ // Entry 19 — canonical-checkout hijack: parallel agent silently switched the
21
+ // canonical checkout off the coordination branch, breaking authority
22
+ // resolution for the worktree-bound session. MULTI-AGENT-ACTIVITY-
23
+ // REGISTRY-001 ships the lease substrate (agent-register/heartbeat/
24
+ // stop) so the next time two sessions touch this repo, both see
25
+ // each other at SessionStart and on every tool call when N > 1.
20
26
  Object.defineProperty(exports, "__esModule", { value: true });
21
27
  exports.CLAUDE_CODE_PACK = exports.CLAUDE_CODE_PACK_VERSION = void 0;
22
28
  // Pack version bumps when managed file contents change in a way that
23
29
  // existing installs should pick up via the managed_old_version → auto-
24
- // update path. Version 2 ships the strike-level diagnostic triage,
25
- // activation-banner wording fix, settings.json "why we don't write it"
26
- // note, and tightened ask/block semantics in block-dangerous.
27
- exports.CLAUDE_CODE_PACK_VERSION = 2;
30
+ // update path.
31
+ //
32
+ // Version 2: strike-level diagnostic triage, activation-banner wording
33
+ // fix, settings.json "why we don't write it" note, tightened ask/block
34
+ // semantics in block-dangerous.
35
+ //
36
+ // Version 3: MULTI-AGENT-ACTIVITY-REGISTRY-001. Adds three new managed
37
+ // files (agent-register.sh, agent-heartbeat.sh, agent-stop.sh) wired
38
+ // into the SessionStart, PreToolUse, and Stop dispatchers. The CLI is
39
+ // hook-protocol-agnostic; agent-heartbeat.sh is the sole emitter of
40
+ // Claude Code's hookSpecificOutput.additionalContext envelope. Adds
41
+ // .caws/leases/ to the stateModel read/write surface.
42
+ //
43
+ // Version 4: CANONICAL-CHECKOUT-WORKTREE-GUARD-001. Adds a hook-IO
44
+ // behavioral contract (canonical-checkout-pre-tool-use-guard-v1)
45
+ // inside worktree-guard.sh that blocks mutating git commands
46
+ // (checkout, switch, branch -f, reset non-hard) from the canonical
47
+ // checkout when at least one active CAWS worktree exists. The guard
48
+ // uses git_dir == git_common_dir as the canonical-detection predicate
49
+ // and the existing entriesOf helper for v10/v11 dual-shape registry
50
+ // reads. Leases are NOT consulted; visibility-only, never authority.
51
+ // Closes the enforcement gap that failure-lineage Entry 19 documented
52
+ // as visibility-without-enforcement. No new managed files; no stateModel
53
+ // changes (leases/worktrees.json already declared).
54
+ exports.CLAUDE_CODE_PACK_VERSION = 5;
28
55
  exports.CLAUDE_CODE_PACK = {
29
56
  id: 'claude-code',
30
57
  targetSurface: 'claude-code',
@@ -39,6 +66,7 @@ exports.CLAUDE_CODE_PACK = {
39
66
  '.caws/specs/*.yaml',
40
67
  '.caws/worktrees.json',
41
68
  '.caws/agents.json',
69
+ '.caws/leases/',
42
70
  '.caws/policy.yaml',
43
71
  'package.json',
44
72
  ],
@@ -47,10 +75,11 @@ exports.CLAUDE_CODE_PACK = {
47
75
  '.claude/logs/session-*.log',
48
76
  '.claude/hooks/state/danger-latch-*.json',
49
77
  '.claude/hooks/state/guard-strikes-*.json',
78
+ '.caws/leases/',
50
79
  'tmp/<session-id>/',
51
80
  ],
52
81
  },
53
- lineageRefs: [1, 4, 6, 8, 11, 12, 13, 16, 17],
82
+ lineageRefs: [1, 4, 6, 8, 11, 12, 13, 16, 17, 19],
54
83
  // Installed files. Order is deterministic (used by tests and by the
55
84
  // install reporter). destPath is relative to repo root.
56
85
  // sourcePath is relative to the pack root
@@ -115,6 +144,30 @@ exports.CLAUDE_CODE_PACK = {
115
144
  executable: true,
116
145
  managed: true,
117
146
  },
147
+ // -- MULTI-AGENT-ACTIVITY-REGISTRY-001 (lineage entry 19) --
148
+ // Lease-substrate hooks. agent-register fires at SessionStart;
149
+ // agent-heartbeat fires FIRST at PreToolUse (throttled, surfaces
150
+ // parallel-agent presence via Claude Code additionalContext when
151
+ // N>1); agent-stop fires at Stop to mark the lease stopped.
152
+ // All three are best-effort and never block their dispatchers.
153
+ {
154
+ destPath: '.claude/hooks/agent-register.sh',
155
+ sourcePath: 'agent-register.sh',
156
+ executable: true,
157
+ managed: true,
158
+ },
159
+ {
160
+ destPath: '.claude/hooks/agent-heartbeat.sh',
161
+ sourcePath: 'agent-heartbeat.sh',
162
+ executable: true,
163
+ managed: true,
164
+ },
165
+ {
166
+ destPath: '.claude/hooks/agent-stop.sh',
167
+ sourcePath: 'agent-stop.sh',
168
+ executable: true,
169
+ managed: true,
170
+ },
118
171
  {
119
172
  destPath: '.claude/hooks/session-log.sh',
120
173
  sourcePath: 'session-log.sh',
@@ -1 +1 @@
1
- {"version":3,"file":"manifest-claude-code.js","sourceRoot":"","sources":["../../../src/init/hook-packs/manifest-claude-code.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"manifest-claude-code.js","sourceRoot":"","sources":["../../../src/init/hook-packs/manifest-claude-code.ts"],"names":[],"mappings":"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"}
@@ -22,7 +22,7 @@
22
22
  // without --adopt/--overwrite).
23
23
  //
24
24
  // Lineage: every pack must declare which failure-lineage entries it covers
25
- // (packages/caws-cli/docs-status/failure-lineage.md). Removing or weakening
25
+ // (docs/failure-lineage.md). Removing or weakening
26
26
  // a pack file requires naming the entry and identifying the replacement
27
27
  // mechanism.
28
28
  Object.defineProperty(exports, "__esModule", { value: true });
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/init/hook-packs/types.ts"],"names":[],"mappings":";AAAA,2EAA2E;AAC3E,sCAAsC;AACtC,EAAE;AACF,2EAA2E;AAC3E,sEAAsE;AACtE,2EAA2E;AAC3E,4EAA4E;AAC5E,6BAA6B;AAC7B,EAAE;AACF,qEAAqE;AACrE,EAAE;AACF,wBAAwB;AACxB,sBAAsB;AACtB,wCAAwC;AACxC,uCAAuC;AACvC,4DAA4D;AAC5D,wEAAwE;AACxE,EAAE;AACF,sEAAsE;AACtE,yEAAyE;AACzE,gCAAgC;AAChC,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,wEAAwE;AACxE,aAAa"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/init/hook-packs/types.ts"],"names":[],"mappings":";AAAA,2EAA2E;AAC3E,sCAAsC;AACtC,EAAE;AACF,2EAA2E;AAC3E,sEAAsE;AACtE,2EAA2E;AAC3E,4EAA4E;AAC5E,6BAA6B;AAC7B,EAAE;AACF,qEAAqE;AACrE,EAAE;AACF,wBAAwB;AACxB,sBAAsB;AACtB,wCAAwC;AACxC,uCAAuC;AACvC,4DAA4D;AAC5D,wEAAwE;AACxE,EAAE;AACF,sEAAsE;AACtE,yEAAyE;AACzE,gCAAgC;AAChC,EAAE;AACF,2EAA2E;AAC3E,mDAAmD;AACnD,wEAAwE;AACxE,aAAa"}
@@ -0,0 +1,49 @@
1
+ import { type LeaseReason } from '@paths.design/caws-kernel';
2
+ interface BaseAgentsOpts {
3
+ readonly cwd?: string;
4
+ readonly now?: () => Date;
5
+ readonly env?: NodeJS.ProcessEnv;
6
+ readonly out?: (line: string) => void;
7
+ readonly err?: (line: string) => void;
8
+ readonly showData?: boolean;
9
+ readonly json?: boolean;
10
+ /** Explicit session identity (overrides resolveSession). Hook-invoked
11
+ * commands MUST pass this; the value is validated as a safe filename
12
+ * BEFORE any I/O. */
13
+ readonly sessionId?: string;
14
+ readonly platform?: string;
15
+ }
16
+ export interface RegisterOpts extends BaseAgentsOpts {
17
+ readonly reason?: LeaseReason;
18
+ readonly includeActiveSummary?: boolean;
19
+ }
20
+ export declare function runAgentsRegisterCommand(opts?: RegisterOpts): number;
21
+ export interface HeartbeatOpts extends BaseAgentsOpts {
22
+ readonly reason?: LeaseReason;
23
+ readonly throttleMs?: number;
24
+ readonly includeActiveSummary?: boolean;
25
+ }
26
+ export declare function runAgentsHeartbeatCommand(opts?: HeartbeatOpts): number;
27
+ export interface StopOpts extends BaseAgentsOpts {
28
+ }
29
+ export declare function runAgentsStopCommand(opts?: StopOpts): number;
30
+ export interface ListOpts extends BaseAgentsOpts {
31
+ readonly includeStale?: boolean;
32
+ readonly includeStopped?: boolean;
33
+ readonly activeOnly?: boolean;
34
+ readonly staleTtlMs?: number;
35
+ }
36
+ export declare function runAgentsListCommand(opts?: ListOpts): number;
37
+ export interface ShowOpts extends BaseAgentsOpts {
38
+ readonly id: string;
39
+ }
40
+ export declare function runAgentsShowCommand(opts: ShowOpts): number;
41
+ export interface PruneOpts extends BaseAgentsOpts {
42
+ readonly status: 'stopped' | 'stale';
43
+ readonly olderThanMs: number;
44
+ readonly staleTtlMs?: number;
45
+ readonly apply?: boolean;
46
+ }
47
+ export declare function runAgentsPruneCommand(opts: PruneOpts): number;
48
+ export {};
49
+ //# sourceMappingURL=agents.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/shell/commands/agents.ts"],"names":[],"mappings":"AAqCA,OAAO,EASL,KAAK,WAAW,EAGjB,MAAM,2BAA2B,CAAC;AA+CnC,UAAU,cAAc;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB;;0BAEsB;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAkMD,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,wBAAgB,wBAAwB,CAAC,IAAI,GAAE,YAAiB,GAAG,MAAM,CAyExE;AAID,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;CACzC;AAED,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,aAAkB,GAAG,MAAM,CA4F1E;AAID,MAAM,WAAW,QAAS,SAAQ,cAAc;CAAG;AAEnD,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,QAAa,GAAG,MAAM,CAuDhE;AAID,MAAM,WAAW,QAAS,SAAQ,cAAc;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,QAAa,GAAG,MAAM,CAqEhE;AAID,MAAM,WAAW,QAAS,SAAQ,cAAc;IAC9C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAwC3D;AAID,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAwC7D"}