clawvault 2.5.4 → 2.6.1

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 (89) hide show
  1. package/README.md +159 -159
  2. package/bin/clawvault.js +111 -111
  3. package/bin/command-registration.test.js +166 -166
  4. package/bin/command-runtime.js +93 -93
  5. package/bin/command-runtime.test.js +154 -154
  6. package/bin/help-contract.test.js +39 -39
  7. package/bin/register-config-commands.js +153 -153
  8. package/bin/register-config-route-commands.test.js +121 -121
  9. package/bin/register-core-commands.js +237 -237
  10. package/bin/register-kanban-commands.js +56 -56
  11. package/bin/register-kanban-commands.test.js +83 -83
  12. package/bin/register-maintenance-commands.js +282 -282
  13. package/bin/register-project-commands.js +209 -209
  14. package/bin/register-project-commands.test.js +206 -206
  15. package/bin/register-query-commands.js +317 -317
  16. package/bin/register-query-commands.test.js +65 -65
  17. package/bin/register-resilience-commands.js +182 -182
  18. package/bin/register-resilience-commands.test.js +81 -81
  19. package/bin/register-route-commands.js +114 -114
  20. package/bin/register-session-lifecycle-commands.js +206 -206
  21. package/bin/register-tailscale-commands.js +106 -106
  22. package/bin/register-task-commands.js +348 -348
  23. package/bin/register-task-commands.test.js +69 -69
  24. package/bin/register-template-commands.js +75 -72
  25. package/bin/register-template-commands.test.js +87 -0
  26. package/bin/register-vault-operations-commands.js +300 -300
  27. package/bin/test-helpers/cli-command-fixtures.js +119 -119
  28. package/dashboard/lib/graph-diff.js +104 -104
  29. package/dashboard/lib/graph-diff.test.js +75 -75
  30. package/dashboard/lib/vault-parser.js +556 -556
  31. package/dashboard/lib/vault-parser.test.js +254 -254
  32. package/dashboard/public/app.js +796 -796
  33. package/dashboard/public/index.html +52 -52
  34. package/dashboard/public/styles.css +221 -221
  35. package/dashboard/server.js +374 -374
  36. package/dist/{chunk-2YDBJS7M.js → chunk-3BTHWPMB.js} +1 -1
  37. package/dist/{chunk-J5EMBUPK.js → chunk-4OXMU5S2.js} +1 -1
  38. package/dist/{chunk-GSD4ALSI.js → chunk-4VRIMU4O.js} +1 -1
  39. package/dist/{chunk-5GZFTAL7.js → chunk-AZYOKJYC.js} +128 -42
  40. package/dist/{chunk-K3CDT7IH.js → chunk-HIHOUSXS.js} +2 -2
  41. package/dist/{chunk-IZEY5S74.js → chunk-IEVLHNLU.js} +1 -1
  42. package/dist/{chunk-OSMS7QIG.js → chunk-ME37YNW3.js} +2 -2
  43. package/dist/chunk-MFAWT5O5.js +301 -0
  44. package/dist/{chunk-TPDH3JPP.js → chunk-PBEE567J.js} +1 -1
  45. package/dist/{chunk-S2IG7VNM.js → chunk-Q2J5YTUF.js} +2 -2
  46. package/dist/{chunk-IOALNTAN.js → chunk-QWQ3TIKS.js} +103 -29
  47. package/dist/{chunk-YCVDVI5B.js → chunk-R2MIW5G7.js} +1 -1
  48. package/dist/{chunk-4IV3R2F5.js → chunk-R6SXNSFD.js} +2 -2
  49. package/dist/{chunk-YOSEUUNB.js → chunk-T76H47ZS.js} +1 -1
  50. package/dist/{chunk-JDLOL2PL.js → chunk-TLGBDTYT.js} +3 -3
  51. package/dist/{chunk-W2HNZC22.js → chunk-UEOUADMO.js} +1 -1
  52. package/dist/cli/index.js +12 -10
  53. package/dist/commands/backlog.js +3 -1
  54. package/dist/commands/blocked.js +3 -1
  55. package/dist/commands/canvas.js +3 -1
  56. package/dist/commands/doctor.js +7 -5
  57. package/dist/commands/inject.js +2 -2
  58. package/dist/commands/kanban.js +4 -2
  59. package/dist/commands/observe.js +7 -5
  60. package/dist/commands/project.js +5 -3
  61. package/dist/commands/rebuild.js +6 -4
  62. package/dist/commands/reflect.js +3 -3
  63. package/dist/commands/replay.js +8 -6
  64. package/dist/commands/setup.js +1 -1
  65. package/dist/commands/sleep.js +7 -5
  66. package/dist/commands/status.js +6 -4
  67. package/dist/commands/task.js +4 -2
  68. package/dist/commands/template.d.ts +10 -1
  69. package/dist/commands/template.js +47 -55
  70. package/dist/commands/wake.js +2 -2
  71. package/dist/index.js +20 -19
  72. package/dist/lib/project-utils.js +4 -2
  73. package/dist/lib/task-utils.d.ts +14 -13
  74. package/dist/lib/task-utils.js +3 -1
  75. package/dist/lib/template-engine.d.ts +1 -0
  76. package/hooks/clawvault/HOOK.md +83 -83
  77. package/hooks/clawvault/handler.js +816 -816
  78. package/hooks/clawvault/handler.test.js +263 -263
  79. package/package.json +94 -94
  80. package/templates/checkpoint.md +34 -19
  81. package/templates/daily-note.md +34 -19
  82. package/templates/daily.md +34 -19
  83. package/templates/decision.md +39 -17
  84. package/templates/handoff.md +34 -19
  85. package/templates/lesson.md +31 -16
  86. package/templates/person.md +37 -19
  87. package/templates/project.md +84 -23
  88. package/templates/task.md +81 -0
  89. /package/dist/{chunk-AXKYDCNN.js → chunk-RVYA52PY.js} +0 -0
@@ -1,206 +1,206 @@
1
- import { beforeEach, describe, expect, it, vi } from 'vitest';
2
- import { Command } from 'commander';
3
- import { registerProjectCommands } from './register-project-commands.js';
4
- import { chalkStub } from './test-helpers/cli-command-fixtures.js';
5
-
6
- const { projectCommandMock } = vi.hoisted(() => ({
7
- projectCommandMock: vi.fn()
8
- }));
9
-
10
- vi.mock('../dist/commands/project.js', () => ({
11
- projectCommand: projectCommandMock
12
- }));
13
-
14
- function buildProgram() {
15
- const program = new Command();
16
- registerProjectCommands(program, {
17
- chalk: chalkStub,
18
- resolveVaultPath: (value) => value ?? '/vault'
19
- });
20
- return program;
21
- }
22
-
23
- async function runCommand(args) {
24
- const program = buildProgram();
25
- await program.parseAsync(args, { from: 'user' });
26
- }
27
-
28
- describe('register-project-commands', () => {
29
- beforeEach(() => {
30
- vi.clearAllMocks();
31
- });
32
-
33
- it('registers add/update/archive/list/show/tasks/board subcommands', () => {
34
- const program = buildProgram();
35
- const projectCommand = program.commands.find((command) => command.name() === 'project');
36
- expect(projectCommand).toBeDefined();
37
-
38
- const subcommandNames = projectCommand?.commands.map((command) => command.name()) ?? [];
39
- expect(subcommandNames).toEqual(expect.arrayContaining([
40
- 'add',
41
- 'update',
42
- 'archive',
43
- 'list',
44
- 'show',
45
- 'tasks',
46
- 'board'
47
- ]));
48
-
49
- const addCommand = projectCommand?.commands.find((command) => command.name() === 'add');
50
- const addFlags = addCommand?.options.map((option) => option.flags) ?? [];
51
- expect(addFlags).toEqual(expect.arrayContaining([
52
- '--owner <owner>',
53
- '--status <status>',
54
- '--team <team>',
55
- '--client <client>',
56
- '--tags <tags>',
57
- '--description <description>',
58
- '--deadline <date>',
59
- '--repo <url>',
60
- '--url <url>'
61
- ]));
62
-
63
- const listCommand = projectCommand?.commands.find((command) => command.name() === 'list');
64
- const listFlags = listCommand?.options.map((option) => option.flags) ?? [];
65
- expect(listFlags).toEqual(expect.arrayContaining([
66
- '--status <status>',
67
- '--owner <owner>',
68
- '--client <client>',
69
- '--tag <tag>',
70
- '--json'
71
- ]));
72
-
73
- const boardCommand = projectCommand?.commands.find((command) => command.name() === 'board');
74
- const boardFlags = boardCommand?.options.map((option) => option.flags) ?? [];
75
- expect(boardFlags).toEqual(expect.arrayContaining([
76
- '--output <path>',
77
- '--group-by <field>'
78
- ]));
79
-
80
- expect(listCommand?.description()).toContain('archived projects are hidden');
81
-
82
- const boardGroupByOption = boardCommand?.options.find((option) => option.flags === '--group-by <field>');
83
- expect(boardGroupByOption?.description).toContain('default: status');
84
- });
85
-
86
- it('dispatches project subcommands to project command handler', async () => {
87
- await runCommand([
88
- 'project',
89
- 'add',
90
- 'Apollo Launch',
91
- '--owner',
92
- 'alice',
93
- '--status',
94
- 'active',
95
- '--team',
96
- 'alice,bob',
97
- '--client',
98
- 'Acme',
99
- '--tags',
100
- 'platform,release',
101
- '--description',
102
- 'Launch project',
103
- '--deadline',
104
- '2026-03-01',
105
- '--repo',
106
- 'https://github.com/acme/apollo',
107
- '--url',
108
- 'https://apollo.acme.dev'
109
- ]);
110
- expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'add', {
111
- title: 'Apollo Launch',
112
- options: {
113
- owner: 'alice',
114
- status: 'active',
115
- team: ['alice', 'bob'],
116
- client: 'Acme',
117
- tags: ['platform', 'release'],
118
- description: 'Launch project',
119
- deadline: '2026-03-01',
120
- repo: 'https://github.com/acme/apollo',
121
- url: 'https://apollo.acme.dev'
122
- }
123
- });
124
-
125
- await runCommand([
126
- 'project',
127
- 'update',
128
- 'apollo-launch',
129
- '--status',
130
- 'paused',
131
- '--owner',
132
- 'carol',
133
- '--team',
134
- 'carol,dave',
135
- '--client',
136
- 'Acme',
137
- '--tags',
138
- 'ops',
139
- '--description',
140
- 'Paused pending review',
141
- '--deadline',
142
- '2026-03-10',
143
- '--repo',
144
- 'https://github.com/acme/apollo-v2',
145
- '--url',
146
- 'https://staging.acme.dev'
147
- ]);
148
- expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'update', {
149
- slug: 'apollo-launch',
150
- options: {
151
- status: 'paused',
152
- owner: 'carol',
153
- team: ['carol', 'dave'],
154
- client: 'Acme',
155
- tags: ['ops'],
156
- description: 'Paused pending review',
157
- deadline: '2026-03-10',
158
- repo: 'https://github.com/acme/apollo-v2',
159
- url: 'https://staging.acme.dev'
160
- }
161
- });
162
-
163
- await runCommand(['project', 'archive', 'apollo-launch', '--reason', 'Client offboarded']);
164
- expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'archive', {
165
- slug: 'apollo-launch',
166
- options: {
167
- reason: 'Client offboarded'
168
- }
169
- });
170
-
171
- await runCommand(['project', 'list', '--status', 'active', '--owner', 'alice', '--client', 'Acme', '--tag', 'platform', '--json']);
172
- expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'list', {
173
- options: {
174
- status: 'active',
175
- owner: 'alice',
176
- client: 'Acme',
177
- tag: 'platform',
178
- json: true
179
- }
180
- });
181
-
182
- await runCommand(['project', 'show', 'apollo-launch']);
183
- expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'show', {
184
- slug: 'apollo-launch',
185
- options: {
186
- json: undefined
187
- }
188
- });
189
-
190
- await runCommand(['project', 'tasks', 'apollo-launch', '--json']);
191
- expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'tasks', {
192
- slug: 'apollo-launch',
193
- options: {
194
- json: true
195
- }
196
- });
197
-
198
- await runCommand(['project', 'board', '--output', 'Projects-Board.md', '--group-by', 'client']);
199
- expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'board', {
200
- options: {
201
- output: 'Projects-Board.md',
202
- groupBy: 'client'
203
- }
204
- });
205
- });
206
- });
1
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
2
+ import { Command } from 'commander';
3
+ import { registerProjectCommands } from './register-project-commands.js';
4
+ import { chalkStub } from './test-helpers/cli-command-fixtures.js';
5
+
6
+ const { projectCommandMock } = vi.hoisted(() => ({
7
+ projectCommandMock: vi.fn()
8
+ }));
9
+
10
+ vi.mock('../dist/commands/project.js', () => ({
11
+ projectCommand: projectCommandMock
12
+ }));
13
+
14
+ function buildProgram() {
15
+ const program = new Command();
16
+ registerProjectCommands(program, {
17
+ chalk: chalkStub,
18
+ resolveVaultPath: (value) => value ?? '/vault'
19
+ });
20
+ return program;
21
+ }
22
+
23
+ async function runCommand(args) {
24
+ const program = buildProgram();
25
+ await program.parseAsync(args, { from: 'user' });
26
+ }
27
+
28
+ describe('register-project-commands', () => {
29
+ beforeEach(() => {
30
+ vi.clearAllMocks();
31
+ });
32
+
33
+ it('registers add/update/archive/list/show/tasks/board subcommands', () => {
34
+ const program = buildProgram();
35
+ const projectCommand = program.commands.find((command) => command.name() === 'project');
36
+ expect(projectCommand).toBeDefined();
37
+
38
+ const subcommandNames = projectCommand?.commands.map((command) => command.name()) ?? [];
39
+ expect(subcommandNames).toEqual(expect.arrayContaining([
40
+ 'add',
41
+ 'update',
42
+ 'archive',
43
+ 'list',
44
+ 'show',
45
+ 'tasks',
46
+ 'board'
47
+ ]));
48
+
49
+ const addCommand = projectCommand?.commands.find((command) => command.name() === 'add');
50
+ const addFlags = addCommand?.options.map((option) => option.flags) ?? [];
51
+ expect(addFlags).toEqual(expect.arrayContaining([
52
+ '--owner <owner>',
53
+ '--status <status>',
54
+ '--team <team>',
55
+ '--client <client>',
56
+ '--tags <tags>',
57
+ '--description <description>',
58
+ '--deadline <date>',
59
+ '--repo <url>',
60
+ '--url <url>'
61
+ ]));
62
+
63
+ const listCommand = projectCommand?.commands.find((command) => command.name() === 'list');
64
+ const listFlags = listCommand?.options.map((option) => option.flags) ?? [];
65
+ expect(listFlags).toEqual(expect.arrayContaining([
66
+ '--status <status>',
67
+ '--owner <owner>',
68
+ '--client <client>',
69
+ '--tag <tag>',
70
+ '--json'
71
+ ]));
72
+
73
+ const boardCommand = projectCommand?.commands.find((command) => command.name() === 'board');
74
+ const boardFlags = boardCommand?.options.map((option) => option.flags) ?? [];
75
+ expect(boardFlags).toEqual(expect.arrayContaining([
76
+ '--output <path>',
77
+ '--group-by <field>'
78
+ ]));
79
+
80
+ expect(listCommand?.description()).toContain('archived projects are hidden');
81
+
82
+ const boardGroupByOption = boardCommand?.options.find((option) => option.flags === '--group-by <field>');
83
+ expect(boardGroupByOption?.description).toContain('default: status');
84
+ });
85
+
86
+ it('dispatches project subcommands to project command handler', async () => {
87
+ await runCommand([
88
+ 'project',
89
+ 'add',
90
+ 'Apollo Launch',
91
+ '--owner',
92
+ 'alice',
93
+ '--status',
94
+ 'active',
95
+ '--team',
96
+ 'alice,bob',
97
+ '--client',
98
+ 'Acme',
99
+ '--tags',
100
+ 'platform,release',
101
+ '--description',
102
+ 'Launch project',
103
+ '--deadline',
104
+ '2026-03-01',
105
+ '--repo',
106
+ 'https://github.com/acme/apollo',
107
+ '--url',
108
+ 'https://apollo.acme.dev'
109
+ ]);
110
+ expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'add', {
111
+ title: 'Apollo Launch',
112
+ options: {
113
+ owner: 'alice',
114
+ status: 'active',
115
+ team: ['alice', 'bob'],
116
+ client: 'Acme',
117
+ tags: ['platform', 'release'],
118
+ description: 'Launch project',
119
+ deadline: '2026-03-01',
120
+ repo: 'https://github.com/acme/apollo',
121
+ url: 'https://apollo.acme.dev'
122
+ }
123
+ });
124
+
125
+ await runCommand([
126
+ 'project',
127
+ 'update',
128
+ 'apollo-launch',
129
+ '--status',
130
+ 'paused',
131
+ '--owner',
132
+ 'carol',
133
+ '--team',
134
+ 'carol,dave',
135
+ '--client',
136
+ 'Acme',
137
+ '--tags',
138
+ 'ops',
139
+ '--description',
140
+ 'Paused pending review',
141
+ '--deadline',
142
+ '2026-03-10',
143
+ '--repo',
144
+ 'https://github.com/acme/apollo-v2',
145
+ '--url',
146
+ 'https://staging.acme.dev'
147
+ ]);
148
+ expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'update', {
149
+ slug: 'apollo-launch',
150
+ options: {
151
+ status: 'paused',
152
+ owner: 'carol',
153
+ team: ['carol', 'dave'],
154
+ client: 'Acme',
155
+ tags: ['ops'],
156
+ description: 'Paused pending review',
157
+ deadline: '2026-03-10',
158
+ repo: 'https://github.com/acme/apollo-v2',
159
+ url: 'https://staging.acme.dev'
160
+ }
161
+ });
162
+
163
+ await runCommand(['project', 'archive', 'apollo-launch', '--reason', 'Client offboarded']);
164
+ expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'archive', {
165
+ slug: 'apollo-launch',
166
+ options: {
167
+ reason: 'Client offboarded'
168
+ }
169
+ });
170
+
171
+ await runCommand(['project', 'list', '--status', 'active', '--owner', 'alice', '--client', 'Acme', '--tag', 'platform', '--json']);
172
+ expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'list', {
173
+ options: {
174
+ status: 'active',
175
+ owner: 'alice',
176
+ client: 'Acme',
177
+ tag: 'platform',
178
+ json: true
179
+ }
180
+ });
181
+
182
+ await runCommand(['project', 'show', 'apollo-launch']);
183
+ expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'show', {
184
+ slug: 'apollo-launch',
185
+ options: {
186
+ json: undefined
187
+ }
188
+ });
189
+
190
+ await runCommand(['project', 'tasks', 'apollo-launch', '--json']);
191
+ expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'tasks', {
192
+ slug: 'apollo-launch',
193
+ options: {
194
+ json: true
195
+ }
196
+ });
197
+
198
+ await runCommand(['project', 'board', '--output', 'Projects-Board.md', '--group-by', 'client']);
199
+ expect(projectCommandMock).toHaveBeenCalledWith('/vault', 'board', {
200
+ options: {
201
+ output: 'Projects-Board.md',
202
+ groupBy: 'client'
203
+ }
204
+ });
205
+ });
206
+ });