@venizia/vulcan 0.4.8 → 0.4.9-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 (179) hide show
  1. package/base/extensions/vulcan-guards.ts +48 -41
  2. package/base/hooks/antigravity-guards.ts +4 -3
  3. package/base/hooks/codex-guards.ts +17 -6
  4. package/base/hooks/guard-git.ts +8 -8
  5. package/base/hooks/guard-manifest.ts +5 -5
  6. package/base/hooks/guard-outside.ts +8 -8
  7. package/base/hooks/guard-package.ts +6 -6
  8. package/base/hooks/guard-remote-hosts.ts +14 -9
  9. package/base/hooks/guard-scripting.ts +6 -6
  10. package/base/hooks/guard-writes.ts +20 -11
  11. package/base/hooks/post-tool.ts +4 -3
  12. package/base/hooks/prompt-submit.ts +4 -3
  13. package/base/hooks/session-start.ts +5 -3
  14. package/base/hooks/stop.ts +4 -3
  15. package/base/hooks/subagent-start.ts +2 -2
  16. package/base/make/vulcan.mk +1 -4
  17. package/base/skills/build-a-feature/SKILL.md +1 -1
  18. package/base/skills/docs-update/SKILL.md +11 -5
  19. package/base/skills/docs-update/evals/evals.json +1 -1
  20. package/base/skills/docs-writing/SKILL.md +1 -1
  21. package/base/skills/plan-a-change/references/spec-card.md +1 -1
  22. package/base/skills/ship/SKILL.md +1 -1
  23. package/base/skills/visualize-work/SKILL.md +29 -6
  24. package/base/skills/visualize-work/references/spec.md +16 -5
  25. package/package.json +5 -6
  26. package/src/agents/atlas-block.ts +43 -43
  27. package/src/agents/codex-hooks.ts +55 -52
  28. package/src/agents/common/types.ts +1 -1
  29. package/src/agents/detect.ts +19 -16
  30. package/src/agents/exclude.ts +97 -98
  31. package/src/agents/hooks-json.ts +41 -43
  32. package/src/agents/local.ts +46 -43
  33. package/src/agents/prompt.ts +45 -42
  34. package/src/agents/render.ts +203 -201
  35. package/src/agents/resolve.ts +133 -134
  36. package/src/agents/table.ts +12 -8
  37. package/src/cli.ts +3 -1
  38. package/src/commands/add.command.ts +2 -2
  39. package/src/commands/agents.command.ts +11 -17
  40. package/src/commands/clean.command.ts +6 -6
  41. package/src/commands/doctor.command.ts +6 -4
  42. package/src/commands/help.command.ts +11 -9
  43. package/src/commands/init.command.ts +14 -8
  44. package/src/commands/preset.command.ts +2 -2
  45. package/src/commands/profile.command.ts +43 -50
  46. package/src/commands/sync.command.ts +109 -111
  47. package/src/commands/upgrade.command.ts +85 -78
  48. package/src/commands/visualize.command.ts +20 -5
  49. package/src/commands/x.command.ts +55 -50
  50. package/src/common/format.ts +23 -21
  51. package/src/common/index.ts +2 -0
  52. package/src/common/json.ts +8 -5
  53. package/src/common/layout-folder.ts +96 -111
  54. package/src/common/paths.ts +14 -12
  55. package/src/common/record.ts +7 -0
  56. package/src/common/text.ts +7 -0
  57. package/src/config/common/constants.ts +13 -1
  58. package/src/config/common/types.ts +8 -1
  59. package/src/config/loader.ts +53 -48
  60. package/src/config/packages.ts +17 -11
  61. package/src/config/schema.ts +54 -7
  62. package/src/create/add-app.ts +604 -493
  63. package/src/create/add-lib.ts +249 -242
  64. package/src/create/bunfig.ts +26 -23
  65. package/src/create/checks.ts +36 -34
  66. package/src/create/common/constants.ts +1 -0
  67. package/src/create/common/failure.ts +10 -0
  68. package/src/create/common/index.ts +2 -0
  69. package/src/create/common/preset-path.ts +11 -0
  70. package/src/create/common/types.ts +7 -2
  71. package/src/create/diff.ts +21 -23
  72. package/src/create/dockerignore.ts +26 -24
  73. package/src/create/files.ts +7 -5
  74. package/src/create/init-monorepo.ts +78 -80
  75. package/src/create/lib-preset.ts +62 -61
  76. package/src/create/manifest-json.ts +10 -4
  77. package/src/create/names.ts +217 -210
  78. package/src/create/next.ts +27 -24
  79. package/src/create/plan.ts +15 -12
  80. package/src/create/preset-diff.ts +415 -240
  81. package/src/create/preset-menu.ts +40 -34
  82. package/src/create/preset.ts +207 -194
  83. package/src/create/process.ts +80 -71
  84. package/src/create/scratch.ts +49 -48
  85. package/src/create/workspace.ts +423 -398
  86. package/src/doctor/checks.ts +1069 -998
  87. package/src/doctor/makefile.ts +17 -13
  88. package/src/doctor/runner.ts +88 -116
  89. package/src/doctor/skills.ts +97 -95
  90. package/src/doctor/tags.ts +44 -41
  91. package/src/hooks/codex-patch.ts +27 -24
  92. package/src/hooks/command-view.ts +44 -39
  93. package/src/hooks/common/constants.ts +0 -3
  94. package/src/hooks/common/types.ts +15 -1
  95. package/src/hooks/decision.ts +38 -42
  96. package/src/hooks/guard-git.ts +52 -50
  97. package/src/hooks/guard-manifest.ts +58 -55
  98. package/src/hooks/guard-outside.ts +109 -88
  99. package/src/hooks/guard-package.ts +86 -77
  100. package/src/hooks/guard-scripting.ts +20 -15
  101. package/src/hooks/guard-writes.ts +169 -111
  102. package/src/hooks/owner-reply.ts +128 -128
  103. package/src/hooks/post-tool.ts +94 -93
  104. package/src/hooks/project-guards.ts +93 -55
  105. package/src/hooks/project-tmp.ts +27 -24
  106. package/src/hooks/remote-hosts.ts +157 -149
  107. package/src/hooks/session-digest.ts +99 -95
  108. package/src/hooks/shell.ts +519 -500
  109. package/src/hooks/subagent-card.ts +11 -7
  110. package/src/hooks/trusted-scripts.ts +158 -80
  111. package/src/init/common/types.ts +1 -1
  112. package/src/init/scaffold.ts +137 -134
  113. package/src/local/clean.ts +39 -37
  114. package/src/local/format.ts +21 -17
  115. package/src/local/scan.ts +146 -140
  116. package/src/manifest/render.ts +127 -112
  117. package/src/owner/card.ts +51 -46
  118. package/src/owner/profile.ts +100 -96
  119. package/src/owner/reply-switch.ts +9 -6
  120. package/src/owner/shape.ts +72 -70
  121. package/src/owner/survey.ts +175 -164
  122. package/src/owner/view.ts +62 -59
  123. package/src/owner/violations.ts +119 -123
  124. package/src/router.ts +4 -1
  125. package/src/rules/base.ts +15 -11
  126. package/src/rules/common/types.ts +1 -1
  127. package/src/rules/parser.ts +39 -32
  128. package/src/rules/slots.ts +8 -6
  129. package/src/signals/claims.ts +30 -28
  130. package/src/signals/classify.ts +36 -33
  131. package/src/signals/loop.ts +39 -37
  132. package/src/signals/state.ts +80 -85
  133. package/src/skills/frontmatter.ts +28 -28
  134. package/src/sync/agent-files.ts +217 -199
  135. package/src/sync/agent-removal.ts +62 -68
  136. package/src/sync/atlas-block.ts +45 -43
  137. package/src/sync/base-rules.ts +32 -30
  138. package/src/sync/claude-launch.ts +74 -37
  139. package/src/sync/common/constants.ts +4 -0
  140. package/src/sync/common/index.ts +1 -0
  141. package/src/sync/common/symlink.ts +9 -0
  142. package/src/sync/common/types.ts +2 -2
  143. package/src/sync/exclude.ts +77 -69
  144. package/src/sync/local-choice.ts +50 -47
  145. package/src/sync/planner.ts +64 -68
  146. package/src/sync/prune.ts +52 -48
  147. package/src/sync/settings.ts +167 -168
  148. package/src/ui/capability.ts +12 -7
  149. package/src/ui/keyboard.ts +35 -33
  150. package/src/ui/prompt.ts +81 -77
  151. package/src/visualize/assets.ts +379 -195
  152. package/src/visualize/charts.ts +188 -176
  153. package/src/visualize/compare-css.ts +31 -0
  154. package/src/visualize/compare-render.ts +196 -0
  155. package/src/visualize/compare-schema.ts +81 -0
  156. package/src/visualize/compare-validate.ts +126 -0
  157. package/src/visualize/constants.ts +29 -3
  158. package/src/visualize/diagrams.ts +189 -174
  159. package/src/visualize/gate.ts +136 -0
  160. package/src/visualize/grid-span.ts +34 -0
  161. package/src/visualize/icons.ts +9 -4
  162. package/src/visualize/index.ts +2 -0
  163. package/src/visualize/kinds-css.ts +54 -0
  164. package/src/visualize/kinds-render.ts +698 -0
  165. package/src/visualize/kinds-schema.ts +148 -0
  166. package/src/visualize/kinds-validate.ts +186 -0
  167. package/src/visualize/labels-vi.ts +109 -0
  168. package/src/visualize/labels.ts +53 -0
  169. package/src/visualize/layout.ts +112 -92
  170. package/src/visualize/page.ts +140 -114
  171. package/src/visualize/render.ts +158 -114
  172. package/src/visualize/schema.ts +21 -1
  173. package/src/visualize/sections.ts +401 -309
  174. package/src/visualize/sources.ts +270 -0
  175. package/src/visualize/theme.ts +474 -0
  176. package/src/visualize/validate.ts +15 -5
  177. package/src/wiki/anchors.ts +39 -37
  178. package/src/wiki/command.ts +4 -4
  179. package/src/wiki/source-links.ts +49 -49
package/src/owner/view.ts CHANGED
@@ -25,68 +25,71 @@ export interface IOwnerView {
25
25
  codeTaste: string | undefined;
26
26
  }
27
27
 
28
- /** Whether a language code is English, whatever its region (`en`, `en-GB`). */
29
- export const isEnglishLanguage = (opts: { language: string }): boolean =>
30
- opts.language.split('-')[0]?.toLowerCase() === OwnerConstants.DEFAULT_LANGUAGE;
31
-
32
28
  const sameLabelSet = (opts: { first: TOwnerLabelSet; second: TOwnerLabelSet }): boolean =>
33
29
  JSON.stringify(opts.first) === JSON.stringify(opts.second);
34
30
 
35
- /** The stricter of two enforcement levels. */
36
- export const stricterEnforcement = (opts: {
37
- first: string;
38
- second: string | undefined;
39
- }): string => {
40
- const order: readonly string[] = OwnerEnforcement.STRICTNESS;
41
- const second = opts.second ?? opts.first;
31
+ export class OwnerView {
32
+ /** Whether a language code is English, whatever its region (`en`, `en-GB`). */
33
+ static isEnglishLanguage(opts: { language: string }): boolean {
34
+ return opts.language.split('-')[0]?.toLowerCase() === OwnerConstants.DEFAULT_LANGUAGE;
35
+ }
36
+
37
+ /** The stricter of two enforcement levels. */
38
+ static stricterEnforcement(opts: { first: string; second: string | undefined }): string {
39
+ const order: readonly string[] = OwnerEnforcement.STRICTNESS;
40
+ const second = opts.second ?? opts.first;
42
41
 
43
- return order.indexOf(second) > order.indexOf(opts.first) ? second : opts.first;
44
- };
42
+ return order.indexOf(second) > order.indexOf(opts.first) ? second : opts.first;
43
+ }
45
44
 
46
- /**
47
- * Language, address, tone, detail and habits come from the person's profile; the shape, status set and
48
- * label defaults from the project block, which a profile may not change; `enforce` is the stricter of
49
- * the two. A language with no label set of its own gets the English words and, unless it is English,
50
- * the `free` label mode: the agent writes the labels in the reader's language and the check looks at the
51
- * structure, never at another language's words.
52
- */
53
- export const resolveOwnerView = (opts: { owner: TOwnerConfig; profile?: TProfile }): IOwnerView => {
54
- const { owner, profile } = opts;
55
- const language = profile?.language ?? owner.language;
56
- const projectLabels: TOwnerLabelSet = {
57
- minimapColumns: owner.report.minimapColumns,
58
- status: owner.report.status,
59
- labels: owner.report.labels,
60
- };
61
- const own =
62
- profile !== undefined && Object.hasOwn(profile.labels, language)
63
- ? profile.labels[language]
64
- : undefined;
65
- const chosen = own ?? (language === owner.language ? projectLabels : undefined);
66
- const labels = chosen ?? OwnerConstants.DEFAULT_LABELS;
67
- const isFree =
68
- !isEnglishLanguage({ language }) &&
69
- (chosen === undefined ||
70
- sameLabelSet({ first: chosen, second: OwnerConstants.DEFAULT_LABELS }));
45
+ /**
46
+ * Language, address, tone, detail and habits come from the person's profile; the shape, status set and
47
+ * label defaults from the project block, which a profile may not change; `enforce` is the stricter of
48
+ * the two. A language with no label set of its own gets the English words and, unless it is English,
49
+ * the `free` label mode: the agent writes the labels in the reader's language and the check looks at the
50
+ * structure, never at another language's words.
51
+ */
52
+ static resolve(opts: { owner: TOwnerConfig; profile?: TProfile }): IOwnerView {
53
+ const { owner, profile } = opts;
54
+ const language = profile?.language ?? owner.language;
55
+ const projectLabels: TOwnerLabelSet = {
56
+ minimapColumns: owner.report.minimapColumns,
57
+ status: owner.report.status,
58
+ labels: owner.report.labels,
59
+ };
60
+ const own =
61
+ profile !== undefined && Object.hasOwn(profile.labels, language)
62
+ ? profile.labels[language]
63
+ : undefined;
64
+ const chosen = own ?? (language === owner.language ? projectLabels : undefined);
65
+ const labels = chosen ?? OwnerConstants.DEFAULT_LABELS;
66
+ const isFree =
67
+ !OwnerView.isEnglishLanguage({ language }) &&
68
+ (chosen === undefined ||
69
+ sameLabelSet({ first: chosen, second: OwnerConstants.DEFAULT_LABELS }));
71
70
 
72
- return {
73
- language,
74
- labels,
75
- labelMode: isFree ? OwnerLabelModes.FREE : OwnerLabelModes.EXACT,
76
- shape: owner.report.shape,
77
- headlineMaxSentences: owner.report.headlineMaxSentences,
78
- absolutePaths: owner.report.absolutePaths,
79
- enforce: stricterEnforcement({ first: owner.report.enforce, second: profile?.enforce }),
80
- claimWords: owner.report.claimWords,
81
- shortReplyWords: Math.min(
82
- owner.report.shortReplyWords,
83
- profile?.shortReplyWords ?? owner.report.shortReplyWords,
84
- ),
85
- address: profile?.address,
86
- tone: profile?.tone,
87
- reportDetail: profile?.reportDetail,
88
- habits: profile?.habits,
89
- about: profile?.about,
90
- codeTaste: profile?.codeTaste,
91
- };
92
- };
71
+ return {
72
+ language,
73
+ labels,
74
+ labelMode: isFree ? OwnerLabelModes.FREE : OwnerLabelModes.EXACT,
75
+ shape: owner.report.shape,
76
+ headlineMaxSentences: owner.report.headlineMaxSentences,
77
+ absolutePaths: owner.report.absolutePaths,
78
+ enforce: OwnerView.stricterEnforcement({
79
+ first: owner.report.enforce,
80
+ second: profile?.enforce,
81
+ }),
82
+ claimWords: owner.report.claimWords,
83
+ shortReplyWords: Math.min(
84
+ owner.report.shortReplyWords,
85
+ profile?.shortReplyWords ?? owner.report.shortReplyWords,
86
+ ),
87
+ address: profile?.address,
88
+ tone: profile?.tone,
89
+ reportDetail: profile?.reportDetail,
90
+ habits: profile?.habits,
91
+ about: profile?.about,
92
+ codeTaste: profile?.codeTaste,
93
+ };
94
+ }
95
+ }
@@ -9,7 +9,7 @@ import {
9
9
  writeFileSync,
10
10
  } from 'node:fs';
11
11
  import { join } from 'node:path';
12
- import { localRootOf } from '../local/scan.ts';
12
+ import { LocalScan } from '../local/scan.ts';
13
13
  import { ClaimClasses } from '../signals/constants.ts';
14
14
  import { ShapeClasses } from './shape.ts';
15
15
 
@@ -37,7 +37,7 @@ export class ViolationConstants {
37
37
 
38
38
  /** `.agents/local/<file>` of a trusted project, or `undefined`; a symlinked file is never followed. */
39
39
  const fileOf = (opts: { root: string; name: string }): string | undefined => {
40
- const local = localRootOf({ root: opts.root });
40
+ const local = LocalScan.localRootOf({ root: opts.root });
41
41
 
42
42
  if (local === undefined) {
43
43
  return undefined;
@@ -76,7 +76,7 @@ const noteName = (opts: { session?: string }): string => {
76
76
  * a directory. Created only when `opts.create` is set.
77
77
  */
78
78
  const notesDirectoryOf = (opts: { root: string; create: boolean }): string | undefined => {
79
- const local = localRootOf({ root: opts.root });
79
+ const local = LocalScan.localRootOf({ root: opts.root });
80
80
 
81
81
  if (local === undefined) {
82
82
  return undefined;
@@ -154,7 +154,7 @@ const readNote = (opts: { root: string; session?: string }): Record<string, unkn
154
154
  */
155
155
  const pruneNotes = (opts: { root: string; now: number }): void => {
156
156
  const directory = notesDirectoryOf({ root: opts.root, create: false });
157
- const local = localRootOf({ root: opts.root });
157
+ const local = LocalScan.localRootOf({ root: opts.root });
158
158
 
159
159
  if (local !== undefined) {
160
160
  const legacy = join(local, ViolationConstants.LEGACY_LAST_FILE);
@@ -196,155 +196,151 @@ const isOversized = (opts: { path: string }): boolean => {
196
196
  }
197
197
  };
198
198
 
199
- /** Records one checked reply: the log when it broke the shape, and always the session's last-reply note. */
200
- export const recordReply = (opts: {
201
- root: string;
202
- classes: string[];
203
- session?: string;
204
- now?: Date;
205
- }): void => {
206
- const now = opts.now ?? new Date();
207
- const log = fileOf({ root: opts.root, name: ViolationConstants.LOG_FILE });
208
-
209
- if (log !== undefined && opts.classes.length > 0 && !isOversized({ path: log })) {
210
- appendFileSync(
211
- log,
212
- `${JSON.stringify({ date: now.toISOString().slice(0, 10), classes: opts.classes })}\n`,
213
- { mode: 0o600 },
214
- );
215
- }
199
+ export class ViolationLog {
200
+ /** Records one checked reply: the log when it broke the shape, and always the session's last-reply note. */
201
+ static recordReply(opts: {
202
+ root: string;
203
+ classes: string[];
204
+ session?: string;
205
+ now?: Date;
206
+ }): void {
207
+ const now = opts.now ?? new Date();
208
+ const log = fileOf({ root: opts.root, name: ViolationConstants.LOG_FILE });
209
+
210
+ if (log !== undefined && opts.classes.length > 0 && !isOversized({ path: log })) {
211
+ appendFileSync(
212
+ log,
213
+ `${JSON.stringify({ date: now.toISOString().slice(0, 10), classes: opts.classes })}\n`,
214
+ { mode: 0o600 },
215
+ );
216
+ }
216
217
 
217
- const last = noteFileOf({ root: opts.root, session: opts.session, create: true });
218
+ const last = noteFileOf({ root: opts.root, session: opts.session, create: true });
218
219
 
219
- if (last !== undefined) {
220
- const { blockedAt } = readNote({ root: opts.root, session: opts.session });
220
+ if (last !== undefined) {
221
+ const { blockedAt } = readNote({ root: opts.root, session: opts.session });
221
222
 
222
- writeFileSync(
223
- last,
224
- `${JSON.stringify({ at: now.getTime(), classes: opts.classes, ...(typeof blockedAt === 'number' ? { blockedAt } : {}) })}\n`,
225
- { mode: 0o600 },
226
- );
227
- pruneNotes({ root: opts.root, now: Date.now() });
223
+ writeFileSync(
224
+ last,
225
+ `${JSON.stringify({ at: now.getTime(), classes: opts.classes, ...(typeof blockedAt === 'number' ? { blockedAt } : {}) })}\n`,
226
+ { mode: 0o600 },
227
+ );
228
+ pruneNotes({ root: opts.root, now: Date.now() });
229
+ }
228
230
  }
229
- };
230
231
 
231
- /** Notes that a reply of this session was just sent back, so a second one is never sent back right after it. */
232
- export const markBlocked = (opts: { root: string; session?: string; now?: Date }): void => {
233
- const last = noteFileOf({ root: opts.root, session: opts.session, create: true });
232
+ /** Notes that a reply of this session was just sent back, so a second one is never sent back right after it. */
233
+ static markBlocked(opts: { root: string; session?: string; now?: Date }): void {
234
+ const last = noteFileOf({ root: opts.root, session: opts.session, create: true });
234
235
 
235
- if (last !== undefined) {
236
- writeFileSync(
237
- last,
238
- `${JSON.stringify({ ...readNote({ root: opts.root, session: opts.session }), blockedAt: (opts.now ?? new Date()).getTime() })}\n`,
239
- { mode: 0o600 },
240
- );
236
+ if (last !== undefined) {
237
+ writeFileSync(
238
+ last,
239
+ `${JSON.stringify({ ...readNote({ root: opts.root, session: opts.session }), blockedAt: (opts.now ?? new Date()).getTime() })}\n`,
240
+ { mode: 0o600 },
241
+ );
242
+ }
241
243
  }
242
- };
243
244
 
244
- export const wasBlockedRecently = (opts: {
245
- root: string;
246
- session?: string;
247
- now?: number;
248
- }): boolean => {
249
- const { blockedAt } = readNote({ root: opts.root, session: opts.session });
250
-
251
- return (
252
- typeof blockedAt === 'number' &&
253
- (opts.now ?? Date.now()) - blockedAt <= ViolationConstants.BLOCK_COOLDOWN_MS
254
- );
255
- };
256
-
257
- /** The size of the violation log in bytes, 0 when there is none or it is not ours to read. */
258
- export const violationLogBytes = (opts: { root: string }): number => {
259
- const log = fileOf({ root: opts.root, name: ViolationConstants.LOG_FILE });
245
+ static wasBlockedRecently(opts: { root: string; session?: string; now?: number }): boolean {
246
+ const { blockedAt } = readNote({ root: opts.root, session: opts.session });
260
247
 
261
- return log === undefined ? 0 : (lstatSync(log, { throwIfNoEntry: false })?.size ?? 0);
262
- };
248
+ return (
249
+ typeof blockedAt === 'number' &&
250
+ (opts.now ?? Date.now()) - blockedAt <= ViolationConstants.BLOCK_COOLDOWN_MS
251
+ );
252
+ }
263
253
 
264
- /** The classes the previous reply of this session broke, or none when there is no note or it is stale. */
265
- export const readLastClasses = (opts: {
266
- root: string;
267
- session?: string;
268
- now?: number;
269
- }): string[] => {
270
- const last = noteFileOf({ root: opts.root, session: opts.session, create: false });
254
+ /** The size of the violation log in bytes, 0 when there is none or it is not ours to read. */
255
+ static violationBytes(opts: { root: string }): number {
256
+ const log = fileOf({ root: opts.root, name: ViolationConstants.LOG_FILE });
271
257
 
272
- if (last === undefined) {
273
- return [];
258
+ return log === undefined ? 0 : (lstatSync(log, { throwIfNoEntry: false })?.size ?? 0);
274
259
  }
275
260
 
276
- try {
277
- const note: unknown = JSON.parse(readFileSync(last, 'utf8'));
261
+ /** The classes the previous reply of this session broke, or none when there is no note or it is stale. */
262
+ static readLastClasses(opts: { root: string; session?: string; now?: number }): string[] {
263
+ const last = noteFileOf({ root: opts.root, session: opts.session, create: false });
278
264
 
279
- if (typeof note !== 'object' || note === null || !('at' in note) || !('classes' in note)) {
265
+ if (last === undefined) {
280
266
  return [];
281
267
  }
282
268
 
283
- const { at, classes } = note;
269
+ try {
270
+ const note: unknown = JSON.parse(readFileSync(last, 'utf8'));
284
271
 
285
- if (
286
- typeof at !== 'number' ||
287
- (opts.now ?? Date.now()) - at > ViolationConstants.LAST_MAX_AGE_MS ||
288
- !Array.isArray(classes)
289
- ) {
290
- return [];
291
- }
272
+ if (typeof note !== 'object' || note === null || !('at' in note) || !('classes' in note)) {
273
+ return [];
274
+ }
292
275
 
293
- return classes.filter(
294
- (value): value is string => typeof value === 'string' && isKnownClass(value),
295
- );
296
- } catch {
297
- return [];
298
- }
299
- };
276
+ const { at, classes } = note;
300
277
 
301
- /** Violations by class across the log, and the number of days it covers; empty when there is no log. */
302
- export const readViolationCounts = (opts: {
303
- root: string;
304
- }): { byClass: Map<string, number>; replies: number; days: number } => {
305
- const byClass = new Map<string, number>();
306
- const days = new Set<string>();
307
- let replies = 0;
308
- const log = fileOf({ root: opts.root, name: ViolationConstants.LOG_FILE });
309
-
310
- if (log === undefined) {
311
- return { byClass, replies, days: 0 };
278
+ if (
279
+ typeof at !== 'number' ||
280
+ (opts.now ?? Date.now()) - at > ViolationConstants.LAST_MAX_AGE_MS ||
281
+ !Array.isArray(classes)
282
+ ) {
283
+ return [];
284
+ }
285
+
286
+ return classes.filter(
287
+ (value): value is string => typeof value === 'string' && isKnownClass(value),
288
+ );
289
+ } catch {
290
+ return [];
291
+ }
312
292
  }
313
293
 
314
- let text = '';
294
+ /** Violations by class across the log, and the number of days it covers; empty when there is no log. */
295
+ static readCounts(opts: { root: string }): {
296
+ byClass: Map<string, number>;
297
+ replies: number;
298
+ days: number;
299
+ } {
300
+ const byClass = new Map<string, number>();
301
+ const days = new Set<string>();
302
+ let replies = 0;
303
+ const log = fileOf({ root: opts.root, name: ViolationConstants.LOG_FILE });
304
+
305
+ if (log === undefined) {
306
+ return { byClass, replies, days: 0 };
307
+ }
315
308
 
316
- try {
317
- text = readFileSync(log, 'utf8');
318
- } catch {
319
- return { byClass, replies, days: 0 };
320
- }
309
+ let text = '';
321
310
 
322
- for (const line of text.split('\n')) {
323
311
  try {
324
- const entry: unknown = JSON.parse(line);
312
+ text = readFileSync(log, 'utf8');
313
+ } catch {
314
+ return { byClass, replies, days: 0 };
315
+ }
325
316
 
326
- if (
327
- typeof entry === 'object' &&
328
- entry !== null &&
329
- 'classes' in entry &&
330
- Array.isArray(entry.classes)
331
- ) {
332
- replies += 1;
317
+ for (const line of text.split('\n')) {
318
+ try {
319
+ const entry: unknown = JSON.parse(line);
333
320
 
334
- if ('date' in entry && typeof entry.date === 'string') {
335
- days.add(entry.date);
336
- }
321
+ if (
322
+ typeof entry === 'object' &&
323
+ entry !== null &&
324
+ 'classes' in entry &&
325
+ Array.isArray(entry.classes)
326
+ ) {
327
+ replies += 1;
337
328
 
338
- for (const value of entry.classes) {
339
- if (typeof value === 'string' && isKnownClass(value)) {
340
- byClass.set(value, (byClass.get(value) ?? 0) + 1);
329
+ if ('date' in entry && typeof entry.date === 'string') {
330
+ days.add(entry.date);
331
+ }
332
+
333
+ for (const value of entry.classes) {
334
+ if (typeof value === 'string' && isKnownClass(value)) {
335
+ byClass.set(value, (byClass.get(value) ?? 0) + 1);
336
+ }
341
337
  }
342
338
  }
339
+ } catch {
340
+ // A damaged line is skipped: the log is advisory.
343
341
  }
344
- } catch {
345
- // A damaged line is skipped: the log is advisory.
346
342
  }
347
- }
348
343
 
349
- return { byClass, replies, days: days.size };
350
- };
344
+ return { byClass, replies, days: days.size };
345
+ }
346
+ }
package/src/router.ts CHANGED
@@ -41,6 +41,7 @@ const ACCEPTED_ARGS: Record<string, IAcceptedArgs> = {
41
41
  CreateFlags.APP,
42
42
  CreateFlags.API,
43
43
  CreateFlags.LIB,
44
+ CreateFlags.SHARED,
44
45
  CreateFlags.DIR,
45
46
  CreateFlags.SCOPE,
46
47
  ],
@@ -152,7 +153,9 @@ export const runVulcan = async (opts: { argv: string[]; cwd: string }): Promise<
152
153
  }
153
154
 
154
155
  try {
155
- return await handler({ args, cwd: opts.cwd });
156
+ const exitCode = await handler({ args, cwd: opts.cwd });
157
+
158
+ return exitCode;
156
159
  } catch (error) {
157
160
  // The refusal is already printed; every `finally` between the menu and here has run.
158
161
  if (error instanceof PipedInputRefusal) {
package/src/rules/base.ts CHANGED
@@ -1,19 +1,23 @@
1
1
  import { readFileSync } from 'node:fs';
2
2
  import { join } from 'node:path';
3
3
  import { BASE_DIRECTORY } from '../common/index.ts';
4
- import { extractRuleRows, parseRetiredRuleIds, parseRuleIds } from './parser.ts';
4
+ import { RuleParser } from './parser.ts';
5
5
 
6
6
  const readBaseMarkdown = (): string => readFileSync(join(BASE_DIRECTORY, 'rules.md'), 'utf8');
7
7
 
8
- /** Each base rule's ID with its table row, verbatim. */
9
- export const readBaseRules = (): Record<string, string> =>
10
- Object.fromEntries(
11
- extractRuleRows({ markdown: readBaseMarkdown() }).map((row) => {
12
- const [id] = parseRuleIds({ markdown: row });
8
+ export class BaseRules {
9
+ /** Each base rule's ID with its table row, verbatim. */
10
+ static read(): Record<string, string> {
11
+ return Object.fromEntries(
12
+ RuleParser.extractRows({ markdown: readBaseMarkdown() }).map((row) => {
13
+ const [id] = RuleParser.parseIds({ markdown: row });
13
14
 
14
- return [id, row];
15
- }),
16
- );
15
+ return [id, row];
16
+ }),
17
+ );
18
+ }
17
19
 
18
- export const readRetiredRuleIds = (): string[] =>
19
- parseRetiredRuleIds({ markdown: readBaseMarkdown() });
20
+ static readRetiredIds(): string[] {
21
+ return RuleParser.parseRetiredIds({ markdown: readBaseMarkdown() });
22
+ }
23
+ }
@@ -1,5 +1,5 @@
1
1
  /** One choice of a slot rule; `settings` merge into `.claude/settings.json` when it is chosen. */
2
- export interface ISlotOption {
2
+ interface ISlotOption {
3
3
  text: string;
4
4
  settings?: Record<string, unknown>;
5
5
  }
@@ -2,48 +2,55 @@ import { RuleConstants } from './common/index.ts';
2
2
 
3
3
  const RULE_ROW = new RegExp(`^\\|\\s*(?:\\*\\*)?(${RuleConstants.ID_SOURCE})(?:\\*\\*)?\\s*\\|`);
4
4
 
5
- /** Rule IDs in table order, from rows whose first cell is `W-01`, `V-W-01` or either in bold. */
6
- export const parseRuleIds = (opts: { markdown: string }): string[] =>
7
- opts.markdown
8
- .split('\n')
9
- .map((line) => RULE_ROW.exec(line)?.[1])
10
- .filter((id): id is string => id !== undefined);
11
-
12
- /** The table rows of every rule, verbatim, in order. */
13
- export const extractRuleRows = (opts: { markdown: string }): string[] =>
14
- opts.markdown.split('\n').filter((line) => RULE_ROW.test(line));
15
-
16
5
  const BASE_ID = new RegExp(`(?<![A-Z-])${RuleConstants.BASE_ID_SOURCE}\\b`, 'g');
6
+
17
7
  const EXTENDS_LIST = new RegExp(
18
8
  `\\bExtends\\s+${RuleConstants.BASE_ID_SOURCE}(?:(?:\\s*,\\s*|\\s+and\\s+)${RuleConstants.BASE_ID_SOURCE})*`,
19
9
  'g',
20
10
  );
11
+
21
12
  const RETIRED_ITEM = new RegExp(`^- \`(${RuleConstants.BASE_ID_SOURCE})\` - `);
22
13
 
23
- /**
24
- * The base IDs a project's rules point at, once each, in order: an `Extends V-X, V-Y and V-Z` list
25
- * in a table row, and every `V-` ID in a row's first cell. A `V-` ID in prose or a later cell is not one.
26
- */
27
- export const parseBaseReferences = (opts: { markdown: string }): string[] => {
28
- const references = new Set<string>();
14
+ export class RuleParser {
15
+ /** Rule IDs in table order, from rows whose first cell is `W-01`, `V-W-01` or either in bold. */
16
+ static parseIds(opts: { markdown: string }): string[] {
17
+ return opts.markdown
18
+ .split('\n')
19
+ .map((line) => RULE_ROW.exec(line)?.[1])
20
+ .filter((id): id is string => id !== undefined);
21
+ }
29
22
 
30
- for (const line of opts.markdown.split('\n').filter((row) => row.startsWith('|'))) {
31
- const firstCell = line.split('|')[1] ?? '';
32
- const lists = [...line.matchAll(EXTENDS_LIST)].map((match) => match[0]);
23
+ /** The table rows of every rule, verbatim, in order. */
24
+ static extractRows(opts: { markdown: string }): string[] {
25
+ return opts.markdown.split('\n').filter((line) => RULE_ROW.test(line));
26
+ }
33
27
 
34
- for (const text of [...lists, firstCell]) {
35
- for (const match of text.matchAll(BASE_ID)) {
36
- references.add(match[0]);
28
+ /**
29
+ * The base IDs a project's rules point at, once each, in order: an `Extends V-X, V-Y and V-Z` list
30
+ * in a table row, and every `V-` ID in a row's first cell. A `V-` ID in prose or a later cell is not one.
31
+ */
32
+ static parseBaseReferences(opts: { markdown: string }): string[] {
33
+ const references = new Set<string>();
34
+
35
+ for (const line of opts.markdown.split('\n').filter((row) => row.startsWith('|'))) {
36
+ const firstCell = line.split('|')[1] ?? '';
37
+ const lists = [...line.matchAll(EXTENDS_LIST)].map((match) => match[0]);
38
+
39
+ for (const text of [...lists, firstCell]) {
40
+ for (const match of text.matchAll(BASE_ID)) {
41
+ references.add(match[0]);
42
+ }
37
43
  }
38
44
  }
39
- }
40
45
 
41
- return [...references];
42
- };
46
+ return [...references];
47
+ }
43
48
 
44
- /** The IDs the base retired, one `` - `V-X-NN` - why `` bullet each; they are never reused. */
45
- export const parseRetiredRuleIds = (opts: { markdown: string }): string[] =>
46
- opts.markdown
47
- .split('\n')
48
- .map((line) => RETIRED_ITEM.exec(line)?.[1])
49
- .filter((id): id is string => id !== undefined);
49
+ /** The IDs the base retired, one `` - `V-X-NN` - why `` bullet each; they are never reused. */
50
+ static parseRetiredIds(opts: { markdown: string }): string[] {
51
+ return opts.markdown
52
+ .split('\n')
53
+ .map((line) => RETIRED_ITEM.exec(line)?.[1])
54
+ .filter((id): id is string => id !== undefined);
55
+ }
56
+ }
@@ -3,10 +3,12 @@ import { join } from 'node:path';
3
3
  import { BASE_DIRECTORY } from '../common/index.ts';
4
4
  import type { ISlot } from './common/index.ts';
5
5
 
6
- export const readSlots = (): Record<string, ISlot> => {
7
- const slots: Record<string, ISlot> = JSON.parse(
8
- readFileSync(join(BASE_DIRECTORY, 'slots.json'), 'utf8'),
9
- );
6
+ export class RuleSlots {
7
+ static read(): Record<string, ISlot> {
8
+ const slots: Record<string, ISlot> = JSON.parse(
9
+ readFileSync(join(BASE_DIRECTORY, 'slots.json'), 'utf8'),
10
+ );
10
11
 
11
- return slots;
12
- };
12
+ return slots;
13
+ }
14
+ }