@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
@@ -1,5 +1,6 @@
1
1
  import { existsSync, readdirSync, readFileSync } from 'node:fs';
2
2
  import { join, relative, resolve } from 'node:path';
3
+ import { TextValue } from '../common/text.ts';
3
4
  import { WikiDefaults } from './constants.ts';
4
5
 
5
6
  /**
@@ -15,12 +16,9 @@ const SOURCE_EXTENSIONS = ['ts', 'tsx', 'md', 'json', 'mjs', 'js', 'yaml', 'yml'
15
16
  const RESOURCE_LINE_PATTERN = /^resource:\s*(.+)$/;
16
17
  const LINE_SUFFIX_PATTERN = /(:\d+|#L\d+)$/;
17
18
 
18
- const escapeRegExp = (opts: { text: string }): string =>
19
- opts.text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
20
-
21
19
  // `{}` and `*` mark a template or a glob and `<>` a placeholder, never one real file.
22
20
  const BACKTICK_PATTERN = new RegExp(
23
- `\`((?:${SOURCE_ROOTS.map((root) => escapeRegExp({ text: root })).join('|')})[^\`{}*<>]+?\\.(?:${SOURCE_EXTENSIONS.join('|')})(?::\\d+|#L\\d+)?)\``,
21
+ `\`((?:${SOURCE_ROOTS.map((root) => TextValue.escapeLiteral({ text: root })).join('|')})[^\`{}*<>]+?\\.(?:${SOURCE_EXTENSIONS.join('|')})(?::\\d+|#L\\d+)?)\``,
24
22
  'g',
25
23
  );
26
24
 
@@ -77,7 +75,7 @@ const walkMarkdown = (opts: { directory: string }): string[] => {
77
75
 
78
76
  const extractPaths = (opts: { text: string; repo: string; skipProse: boolean }): string[] => {
79
77
  const github = new RegExp(
80
- `${escapeRegExp({ text: opts.repo })}/(?:blob|tree)/main/([^\\s)\\]"'\`<>]+)`,
78
+ `${TextValue.escapeLiteral({ text: opts.repo })}/(?:blob|tree)/main/([^\\s)\\]"'\`<>]+)`,
81
79
  'g',
82
80
  );
83
81
  const found = [...opts.text.matchAll(github)].map((match) =>
@@ -128,59 +126,61 @@ const extractResource = (opts: { lines: string[] }): { line: number; path: strin
128
126
  return undefined;
129
127
  };
130
128
 
131
- /**
132
- * Walks the `.md` files under `directories` (paths relative to `root`) and reports every source path
133
- * that git does not track. `skipFiles` are generated pages that are never held to the gate.
134
- */
135
- export const checkSourceLinks = (opts: {
136
- root: string;
137
- repo: string;
138
- directories: string[];
139
- skipProseUnder: string[];
140
- skipFiles: string[];
141
- }): { checked: number; missing: IMissingSourceLink[] } => {
142
- const { root, repo, skipFiles, skipProseUnder } = opts;
143
- const tracked = loadTracked({ root });
144
- const exists = (path: string): boolean =>
145
- tracked.files.has(path) || tracked.directories.has(path);
146
- const missing: IMissingSourceLink[] = [];
147
- let checked = 0;
148
-
149
- for (const directory of opts.directories) {
150
- for (const file of walkMarkdown({ directory: resolve(root, directory) })) {
151
- const path = relative(root, file);
152
-
153
- if (skipFiles.some((skip) => isUnder({ path, directory: skip }))) {
154
- continue;
155
- }
129
+ export class SourceLinkCheck {
130
+ /**
131
+ * Walks the `.md` files under `directories` (paths relative to `root`) and reports every source path
132
+ * that git does not track. `skipFiles` are generated pages that are never held to the gate.
133
+ */
134
+ static check(opts: {
135
+ root: string;
136
+ repo: string;
137
+ directories: string[];
138
+ skipProseUnder: string[];
139
+ skipFiles: string[];
140
+ }): { checked: number; missing: IMissingSourceLink[] } {
141
+ const { root, repo, skipFiles, skipProseUnder } = opts;
142
+ const tracked = loadTracked({ root });
143
+ const exists = (path: string): boolean =>
144
+ tracked.files.has(path) || tracked.directories.has(path);
145
+ const missing: IMissingSourceLink[] = [];
146
+ let checked = 0;
147
+
148
+ for (const directory of opts.directories) {
149
+ for (const file of walkMarkdown({ directory: resolve(root, directory) })) {
150
+ const path = relative(root, file);
151
+
152
+ if (skipFiles.some((skip) => isUnder({ path, directory: skip }))) {
153
+ continue;
154
+ }
156
155
 
157
- const skipProse = skipProseUnder.some((skip) => isUnder({ path, directory: skip }));
158
- const lines = readFileSync(file, 'utf8').split('\n');
159
- const resource = isUnder({ path, directory: WikiDefaults.KNOWLEDGE_DIRECTORY })
160
- ? extractResource({ lines })
161
- : undefined;
156
+ const skipProse = skipProseUnder.some((skip) => isUnder({ path, directory: skip }));
157
+ const lines = readFileSync(file, 'utf8').split('\n');
158
+ const resource = isUnder({ path, directory: WikiDefaults.KNOWLEDGE_DIRECTORY })
159
+ ? extractResource({ lines })
160
+ : undefined;
162
161
 
163
- if (resource !== undefined) {
164
- checked += 1;
162
+ if (resource !== undefined) {
163
+ checked += 1;
165
164
 
166
- if (!exists(resource.path)) {
167
- missing.push({ file: path, line: resource.line, path: resource.path });
165
+ if (!exists(resource.path)) {
166
+ missing.push({ file: path, line: resource.line, path: resource.path });
167
+ }
168
168
  }
169
- }
170
169
 
171
- for (const [index, text] of lines.entries()) {
172
- for (const found of extractPaths({ text, repo, skipProse })) {
173
- checked += 1;
170
+ for (const [index, text] of lines.entries()) {
171
+ for (const found of extractPaths({ text, repo, skipProse })) {
172
+ checked += 1;
174
173
 
175
- if (!exists(found)) {
176
- missing.push({ file: path, line: index + 1, path: found });
174
+ if (!exists(found)) {
175
+ missing.push({ file: path, line: index + 1, path: found });
176
+ }
177
177
  }
178
178
  }
179
179
  }
180
180
  }
181
- }
182
181
 
183
- missing.sort((left, right) => left.file.localeCompare(right.file) || left.line - right.line);
182
+ missing.sort((left, right) => left.file.localeCompare(right.file) || left.line - right.line);
184
183
 
185
- return { checked, missing };
186
- };
184
+ return { checked, missing };
185
+ }
186
+ }