@venizia/vulcan 0.4.5 → 0.4.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 (54) hide show
  1. package/LICENSE.md +1 -1
  2. package/README.md +13 -0
  3. package/base/checks/wiki-anchors.ts +8 -0
  4. package/base/checks/wiki-source-links.ts +8 -0
  5. package/base/hooks/guard-git.ts +9 -2
  6. package/base/hooks/guard-writes.ts +4 -0
  7. package/base/hooks/session-start.ts +14 -4
  8. package/base/make/vulcan.mk +12 -1
  9. package/base/references/delegation-brief.md +5 -4
  10. package/base/rules.md +2 -2
  11. package/base/skills/docs-writing/SKILL.md +1 -1
  12. package/base/skills/docs-writing/references/agent-documents.md +1 -1
  13. package/base/skills/knowledge-sync/SKILL.md +1 -1
  14. package/base/skills/plan-a-change/SKILL.md +2 -2
  15. package/base/skills/plan-a-change/evals/evals.json +6 -0
  16. package/base/skills/plan-a-change/references/spec-card.md +1 -0
  17. package/base/skills/report-back/SKILL.md +1 -1
  18. package/base/skills/retro/SKILL.md +1 -1
  19. package/base/skills/review-a-change/SKILL.md +1 -1
  20. package/base/skills/ship/SKILL.md +1 -1
  21. package/base/skills/visualize-work/SKILL.md +33 -11
  22. package/base/skills/visualize-work/references/spec.md +77 -12
  23. package/package.json +4 -4
  24. package/src/config/schema.ts +58 -4
  25. package/src/doctor/checks.ts +29 -1
  26. package/src/doctor/runner.ts +2 -0
  27. package/src/hooks/command-view.ts +24 -0
  28. package/src/hooks/common/constants.ts +10 -0
  29. package/src/hooks/guard-git.ts +78 -2
  30. package/src/hooks/guard-outside.ts +20 -3
  31. package/src/hooks/guard-writes.ts +17 -6
  32. package/src/hooks/index.ts +2 -0
  33. package/src/hooks/project-guards.ts +123 -0
  34. package/src/hooks/project-tmp.ts +36 -0
  35. package/src/hooks/session-digest.ts +5 -0
  36. package/src/manifest/render.ts +38 -0
  37. package/src/sync/claude-launch.ts +48 -0
  38. package/src/sync/index.ts +1 -0
  39. package/src/sync/local-choice.ts +2 -0
  40. package/src/visualize/assets.ts +195 -54
  41. package/src/visualize/charts.ts +235 -0
  42. package/src/visualize/constants.ts +106 -1
  43. package/src/visualize/diagrams.ts +224 -0
  44. package/src/visualize/icons.ts +28 -0
  45. package/src/visualize/layout.ts +58 -8
  46. package/src/visualize/page.ts +152 -146
  47. package/src/visualize/schema.ts +246 -0
  48. package/src/visualize/sections.ts +370 -0
  49. package/src/visualize/validate.ts +100 -7
  50. package/src/wiki/anchors.ts +118 -0
  51. package/src/wiki/command.ts +110 -0
  52. package/src/wiki/constants.ts +30 -0
  53. package/src/wiki/index.ts +4 -0
  54. package/src/wiki/source-links.ts +186 -0
@@ -46,6 +46,40 @@ export const buildBaseRuleHashes = (): Record<string, string> =>
46
46
  }),
47
47
  );
48
48
 
49
+ /** The manifest's `guard` block: what the project adds to guard-writes and guard-git, as data a hook reads without the config. */
50
+ const guardBlockOf = (opts: { config: TResolvedConfig }): { guard?: Record<string, unknown> } => {
51
+ const { commands } = opts.config.guard.writes;
52
+ const { askPush } = opts.config.guard.git;
53
+ const block = {
54
+ ...(commands.length === 0
55
+ ? {}
56
+ : {
57
+ writes: {
58
+ commands: commands.map((command) => ({
59
+ rule: command.rule,
60
+ what: command.what,
61
+ pattern: command.pattern,
62
+ ...(command.ignoreCase === true ? { ignoreCase: true } : {}),
63
+ })),
64
+ },
65
+ }),
66
+ ...(askPush.length === 0 ? {} : { git: { askPush } }),
67
+ };
68
+
69
+ return Object.keys(block).length === 0 ? {} : { guard: block };
70
+ };
71
+
72
+ /** The manifest's `atlas` block: only what the config sets (keys listed, the download turned off). */
73
+ const atlasBlockOf = (opts: { config: TResolvedConfig }): { atlas?: Record<string, unknown> } => {
74
+ const keys = opts.config.atlas.index?.keys ?? [];
75
+ const block = {
76
+ ...(keys.length === 0 ? {} : { index: { keys } }),
77
+ ...(opts.config.atlas.prebuilt === false ? { prebuilt: false } : {}),
78
+ };
79
+
80
+ return Object.keys(block).length === 0 ? {} : { atlas: block };
81
+ };
82
+
49
83
  /**
50
84
  * The project manifest (Project Contract v1, C1): data only, rendered from the config with a fixed
51
85
  * key order, so the committed file is byte-stable and a stale one shows as a diff.
@@ -82,6 +116,10 @@ export const renderManifest = (opts: { root: string; config: TResolvedConfig }):
82
116
  rules: { project: ManifestConstants.PROJECT_RULES, base: buildBaseRuleHashes() },
83
117
  // The sources this project reads knowledge from (atlas, git mode); a project without any carries none.
84
118
  ...(config.atlas.sources.length === 0 ? {} : { sources: config.atlas.sources }),
119
+ // The prebuilt index: the keys a published pair is checked with, and the switch; neither set, nothing is written.
120
+ ...atlasBlockOf({ config }),
121
+ // The commands and push targets the guards ask about beyond their own list; neither set, nothing is written.
122
+ ...guardBlockOf({ config }),
85
123
  // The remote-host guard reads its policy here; a project without the key has no guard.
86
124
  ...(config.remoteHosts === undefined ? {} : { remoteHosts: config.remoteHosts }),
87
125
  };
@@ -0,0 +1,48 @@
1
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
2
+ import { dirname, join } from 'node:path';
3
+ import { ProjectLayout } from '../common/index.ts';
4
+ import { projectTmpOf } from '../hooks/project-tmp.ts';
5
+ import { SyncStatuses } from './common/index.ts';
6
+ import type { ISyncAction } from './common/index.ts';
7
+
8
+ /** Beside the other personal files of the developer, gitignored with them. */
9
+ export const CLAUDE_LAUNCH_FILE = `${ProjectLayout.LOCAL_DIRECTORY}/claude.launch.settings.json`;
10
+
11
+ /**
12
+ * What `claude --settings <this file>` adds to a session: `TMPDIR` and `CLAUDE_CODE_TMPDIR` in the project.
13
+ * Claude Code applies an `env` block given this way (and the variables in the launch environment, and the
14
+ * user settings file), but not the same block in the project's own settings, so this is the route that
15
+ * moves its own task-output files and its MCP servers into the project. Absolute paths: the file belongs
16
+ * to one checkout of one developer.
17
+ */
18
+ export const renderClaudeLaunch = (opts: { root: string }): string => {
19
+ const folder = projectTmpOf({ root: opts.root });
20
+
21
+ return `${JSON.stringify({ env: { TMPDIR: folder, CLAUDE_CODE_TMPDIR: folder } }, null, 2)}\n`;
22
+ };
23
+
24
+ /** The launch file when it is missing or written for another folder; nothing to do when it is current. */
25
+ export const planClaudeLaunch = (opts: { root: string }): ISyncAction[] => {
26
+ const path = join(opts.root, CLAUDE_LAUNCH_FILE);
27
+ const text = renderClaudeLaunch({ root: opts.root });
28
+ const before = existsSync(path) ? readFileSync(path, 'utf8') : undefined;
29
+
30
+ if (before === text) {
31
+ return [];
32
+ }
33
+
34
+ return [
35
+ {
36
+ path,
37
+ status: before === undefined ? SyncStatuses.CREATED : SyncStatuses.REPLACED,
38
+ note:
39
+ before === undefined
40
+ ? 'the Claude Code launch file is missing'
41
+ : 'the Claude Code launch file names another folder',
42
+ apply: () => {
43
+ mkdirSync(dirname(path), { recursive: true });
44
+ writeFileSync(path, text);
45
+ },
46
+ },
47
+ ];
48
+ };
package/src/sync/index.ts CHANGED
@@ -4,6 +4,7 @@ export * from './planner.ts';
4
4
  export * from './prune.ts';
5
5
  export * from './settings.ts';
6
6
  export * from './local-choice.ts';
7
+ export * from './claude-launch.ts';
7
8
  export * from './agent-files.ts';
8
9
  export * from './atlas-block.ts';
9
10
  export * from './exclude.ts';
@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
2
2
  import { dirname, join } from 'node:path';
3
3
  import { LOCAL_AGENTS_FILE, renderLocalChoice } from '../agents/index.ts';
4
4
  import { ProjectLayout } from '../common/index.ts';
5
+ import { planClaudeLaunch } from './claude-launch.ts';
5
6
  import { SyncStatuses } from './common/index.ts';
6
7
  import type { ISyncAction } from './common/index.ts';
7
8
 
@@ -71,6 +72,7 @@ export const planLocalWorkspace = (opts: { root: string }): ISyncAction[] => {
71
72
 
72
73
  return [
73
74
  ...planIgnoreLine({ root: opts.root, line: `${ProjectLayout.LOCAL_DIRECTORY}/` }),
75
+ ...planClaudeLaunch({ root: opts.root }),
74
76
  {
75
77
  path: directory,
76
78
  status: missing.length === 0 ? SyncStatuses.UNCHANGED : SyncStatuses.CREATED,
@@ -1,64 +1,205 @@
1
- /** The page's stylesheet: light and dark by variables, no font, no image, final state in print and under reduced motion. */
2
- export const PAGE_CSS = `:root{--bg:#fbfbfa;--fg:#1c1d1f;--mut:#5b6068;--line:#c9ccd2;--card:#fff;--acc:#0b5cd5;--ok:#17703a;--warn:#8a5a00;--bad:#b3261e;--info:#0b5cd5;--add:#17703a;--rem:#b3261e;color-scheme:light}
3
- @media (prefers-color-scheme:dark){:root:not([data-theme=light]){--bg:#15171a;--fg:#e8e9eb;--mut:#a3a8b0;--line:#3a3f47;--card:#1e2126;--acc:#6ea8ff;--ok:#5fd18a;--warn:#f0b955;--bad:#ff8a80;--info:#6ea8ff;--add:#5fd18a;--rem:#ff8a80;color-scheme:dark}}
4
- :root[data-theme=dark]{--bg:#15171a;--fg:#e8e9eb;--mut:#a3a8b0;--line:#3a3f47;--card:#1e2126;--acc:#6ea8ff;--ok:#5fd18a;--warn:#f0b955;--bad:#ff8a80;--info:#6ea8ff;--add:#5fd18a;--rem:#ff8a80;color-scheme:dark}
1
+ /** Light and dark palettes: neutral ink, one bronze accent, semantic states with tints, five series colours for charts. */
2
+ const LIGHT =
3
+ '--bg:#f4f4f4;--surface:#fff;--surface2:#ececec;--fg:#15161a;--mut:#585d66;--line:#dedede;--acc:#98681a;--acc-bg:#f6ecd9;--ok:#157a3a;--ok-bg:#e4f3e8;--warn:#9c5a06;--warn-bg:#fcefd8;--bad:#bd2820;--bad-bg:#fbe8e6;--info:#1c5ccc;--info-bg:#e6edfb;--s1:#2a78d6;--s2:#eb6834;--s3:#1baf7a;--s4:#eda100;--s5:#e87ba4;--shadow:0 1px 2px rgba(20,22,30,.06);color-scheme:light';
4
+ const DARK =
5
+ '--bg:#0e0f12;--surface:#17191e;--surface2:#1d2026;--fg:#eeeef0;--mut:#a2a6af;--line:#2a2d35;--acc:#e0b366;--acc-bg:#2b2314;--ok:#5fd18a;--ok-bg:#13261b;--warn:#f0b955;--warn-bg:#2b2212;--bad:#ff8a80;--bad-bg:#2d1816;--info:#7ab0ff;--info-bg:#14213a;--s1:#3987e5;--s2:#d95926;--s3:#199e70;--s4:#c98500;--s5:#d55181;--shadow:0 1px 2px rgba(0,0,0,.4);color-scheme:dark';
6
+
7
+ /** The page's stylesheet: light and dark by variables, system fonts, no image, final state in print and under reduced motion. */
8
+ export const PAGE_CSS = `:root{${LIGHT};--sans:ui-sans-serif,system-ui,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;--serif:ui-serif,"Iowan Old Style","Palatino Linotype",Palatino,Georgia,serif;--mono:ui-monospace,"SF Mono","JetBrains Mono",Menlo,Consolas,monospace}
9
+ @media (prefers-color-scheme:dark){:root:not([data-theme=light]){${DARK}}}
10
+ :root[data-theme=dark]{${DARK}}
5
11
  *{box-sizing:border-box}
6
- body{margin:0;background:var(--bg);color:var(--fg);font:16px/1.5 system-ui,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif}
7
- main{max-width:1100px;margin:0 auto;padding:20px 16px 64px}
8
- header{display:flex;flex-wrap:wrap;gap:8px 16px;align-items:center;justify-content:space-between}
9
- h1{font-size:1.6rem;line-height:1.25;margin:0;flex:1 1 320px}
10
- h2{font-size:1.15rem;margin:32px 0 8px}
11
- .meta{color:var(--mut);font-size:.9rem;display:flex;flex-wrap:wrap;gap:4px 16px;margin:4px 0 0}
12
- .chip{display:inline-flex;align-items:center;gap:8px;border:2px solid currentColor;border-radius:999px;padding:2px 12px;font-weight:600;font-size:.9rem}
13
- .chip i{display:inline-block;width:12px;height:12px;background:currentColor}
14
- .ok{color:var(--ok)}.ok i{border-radius:50%}
15
- .warn{color:var(--warn)}.warn i{clip-path:polygon(50% 0,100% 100%,0 100%)}
16
- .blocked{color:var(--bad)}.blocked i{border-radius:2px}
17
- .info{color:var(--info)}.info i{transform:rotate(45deg) scale(.8)}
18
- button{font:inherit;color:var(--fg);background:var(--card);border:1px solid var(--line);border-radius:6px;padding:4px 12px;cursor:pointer}
19
- button:focus-visible,.node:focus-visible{outline:3px solid var(--acc);outline-offset:2px}
20
- .verdict{font-size:1.25rem;font-weight:600;margin:16px 0 4px}
21
- .cap{color:var(--mut);margin:0 0 12px}
22
- .strip{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:8px;margin:16px 0}
23
- .strip div{background:var(--card);border:1px solid var(--line);border-radius:8px;padding:8px 12px}
24
- .strip b{display:block;font-size:.8rem;text-transform:uppercase;letter-spacing:.04em;color:var(--mut)}
25
- .bar{display:flex;flex-wrap:wrap;gap:8px;align-items:center;margin:8px 0}
26
- .fig{overflow-x:auto;background:var(--card);border:1px solid var(--line);border-radius:8px;padding:8px}
27
- svg{display:block;max-width:none;color:var(--mut)}
28
- .node rect{fill:var(--bg);stroke:var(--fg);stroke-width:1.5}
29
- .node .t{font-size:14px;font-weight:600;fill:var(--fg)}.node .s{font-size:12px;fill:var(--mut)}
30
- .node.service rect{stroke-width:3}.node.store rect{stroke-dasharray:2 3;stroke-width:2.5}.node.actor rect{rx:32}.node.external rect{stroke-dasharray:8 4}
31
- .edge path{fill:none;stroke:currentColor;stroke-width:1.8}.edge text{font-size:12px;fill:var(--fg);paint-order:stroke;stroke:var(--card);stroke-width:4px}
32
- .edge.branch path,.edge.return path{stroke-dasharray:7 5}.edge.fanout path{stroke-width:2.6}.edge.error{color:var(--bad)}.edge.error path{stroke:var(--bad)}marker .bad{fill:var(--bad)}.edge.error path{stroke-dasharray:2 4}
12
+ html{-webkit-text-size-adjust:100%}
13
+ body{margin:0;background:var(--bg);color:var(--fg);font:16px/1.55 var(--sans);font-variant-numeric:tabular-nums;-webkit-font-smoothing:antialiased}
14
+ h1,h2,h3,p,ol,ul,figure,blockquote{margin:0}
15
+ ol,ul{padding:0;list-style:none}
16
+ a{color:inherit;text-underline-offset:3px}
17
+ .ic{flex:none;display:inline-block;vertical-align:middle}
18
+ .c-ok{--c:var(--ok);--cb:var(--ok-bg)}.c-warn{--c:var(--warn);--cb:var(--warn-bg)}.c-bad{--c:var(--bad);--cb:var(--bad-bg)}.c-info{--c:var(--info);--cb:var(--info-bg)}.c-mut{--c:var(--mut);--cb:var(--surface2)}
19
+ .chip{display:inline-flex;align-items:center;gap:6px;color:var(--c);font:600 .8125rem/1.2 var(--mono);text-transform:uppercase;letter-spacing:.05em}
20
+ .lab{font:600 .8125rem/1.3 var(--mono);text-transform:uppercase;letter-spacing:.08em;color:var(--mut)}
21
+ .mut{color:var(--mut)}.inl{display:inline-flex;margin-right:6px;color:var(--c)}
22
+ .vh{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap}
23
+ :focus-visible{outline:2px solid var(--acc);outline-offset:2px}
24
+ button{font:500 .8125rem/1.3 var(--mono);letter-spacing:.04em;color:var(--fg);background:transparent;border:1px solid var(--line);border-radius:4px;padding:5px 10px;cursor:pointer}
25
+ button:hover{border-color:var(--fg)}
26
+ .wrap{max-width:1240px;margin:0 auto;padding:16px 20px 72px}
27
+ .tools{display:flex;justify-content:flex-end;gap:8px;margin-bottom:14px}
28
+ .mini{position:sticky;top:0;z-index:20;display:flex;align-items:center;gap:12px;padding:0 20px;background:var(--bg);border-bottom:1px solid transparent;opacity:0;pointer-events:none;height:0;overflow:hidden;transition:opacity .2s}
29
+ .mini.on{opacity:1;pointer-events:auto;height:auto;padding:8px 20px;border-bottom-color:var(--line)}
30
+ .mini b{font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;min-width:0;font-size:.9375rem}
31
+ .banner{display:grid;grid-template-columns:auto 1fr;gap:28px;align-items:center;padding:30px 32px;border-radius:4px;background:var(--cb);border:1px solid color-mix(in srgb,var(--c) 40%,var(--surface));box-shadow:var(--shadow)}
32
+ .b-ic{color:var(--c);display:grid;place-items:center;width:84px;height:84px;border-radius:4px;background:var(--surface)}
33
+ .b-ic .ic{width:52px;height:52px}
34
+ .meta{display:flex;flex-wrap:wrap;gap:2px 16px;font:500 .8125rem/1.4 var(--mono);color:var(--mut);letter-spacing:.03em}
35
+ .word{font:800 clamp(1.8rem,1.2rem + 2.6vw,3rem)/1 var(--sans);letter-spacing:-.02em;text-transform:uppercase;color:var(--c);margin:10px 0 8px}
36
+ h1{font-size:clamp(1.3rem,1.1rem + .8vw,1.6rem);line-height:1.25;font-weight:650;max-width:62ch}
37
+ .verdict{margin-top:8px;font-size:1.05rem;max-width:62ch}
38
+ .cap{margin-top:6px;color:var(--mut);max-width:62ch}
39
+ .sec{margin-top:40px}
40
+ .sec>h2.lab{margin-bottom:14px}
41
+ .tiles{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:12px;margin-top:20px}
42
+ .tile{padding:18px;border-radius:4px;background:var(--surface);box-shadow:var(--shadow);position:relative;display:grid;gap:8px}
43
+ .tile .n{font:750 2.4rem/1 var(--sans);letter-spacing:-.03em;font-variant-numeric:tabular-nums}
44
+ .tile .l{color:var(--mut);font-size:.9375rem}
45
+ .tile .ic{position:absolute;top:16px;right:16px;color:var(--c)}
46
+ .strip{display:grid;grid-auto-flow:column;grid-auto-columns:minmax(0,1fr);gap:6px}
47
+ .seg{display:grid;gap:8px;align-content:start}
48
+ .seg .bar{height:10px;border-radius:4px;background:var(--c)}
49
+ .seg.c-mut .bar{background:repeating-linear-gradient(135deg,var(--line) 0 5px,transparent 5px 10px);border:1px solid var(--line)}
50
+ .seg .nm{display:grid;gap:3px;font-size:.9375rem;line-height:1.3}.seg .tn{font-weight:600}
51
+ .seg .nt{color:var(--mut);font-size:.875rem;line-height:1.35}
52
+ .two{display:grid;grid-template-columns:minmax(0,3fr) minmax(0,2fr);gap:12px;margin-top:28px;align-items:start}
53
+ .card{padding:22px;border-radius:4px;background:var(--surface);box-shadow:var(--shadow)}
54
+ .action{background:var(--fg);color:var(--surface);box-shadow:none}
55
+ .action .lab{color:var(--surface);opacity:.7}
56
+ .action h2{font-size:clamp(1.15rem,1.05rem + .5vw,1.4rem);line-height:1.3;margin:6px 0 14px}
57
+ .check{display:grid;gap:10px;counter-reset:s}
58
+ .check li{counter-increment:s;display:grid;grid-template-columns:34px 1fr;gap:12px;align-items:center;padding:12px 14px;border-radius:4px;background:color-mix(in srgb,var(--surface) 14%,transparent);font-weight:550}
59
+ .check li::before{content:counter(s);display:grid;place-items:center;width:34px;height:34px;border-radius:4px;background:var(--surface);color:var(--fg);font:750 1rem var(--mono)}
60
+ .jump{display:inline-block;margin-top:14px;color:inherit;font:600 .8125rem/1.3 var(--mono);letter-spacing:.04em}
61
+ .blocked .bb{display:flex;gap:10px;margin:8px 0 14px;font-weight:550}
62
+ .blocked .bb .ic{color:var(--warn);margin-top:3px}
63
+ .ok-line{display:flex;gap:10px;padding-top:12px;margin-top:12px;border-top:1px solid var(--line);color:var(--mut);font-size:.9375rem}
64
+ .ok-line .ic{margin-top:3px}.ok-line b{color:var(--fg);font-weight:600}
65
+ .fig{background:var(--surface);border:1px solid var(--line);border-radius:4px;padding:12px;overflow-x:auto;box-shadow:var(--shadow)}
66
+ .fig svg{display:block;max-width:100%;height:auto;color:var(--mut)}
67
+ .node rect{fill:var(--surface);stroke:var(--c,var(--fg));stroke-width:1.5}
68
+ .node .t{font:600 15px var(--sans);fill:var(--fg)}.node .s{font:13px var(--mono);fill:var(--mut)}.node .st{color:var(--c)}
69
+ .node.service rect{stroke-width:3}.node.store rect{stroke-dasharray:2 3;stroke-width:2.25}.node.actor rect{rx:30}.node.external rect{stroke-dasharray:8 4}
70
+ .edge path{fill:none;stroke:currentColor;stroke-width:1.6}.edge text{font:13px var(--mono);fill:var(--fg);paint-order:stroke;stroke:var(--surface);stroke-width:5px}
71
+ .edge.branch path,.edge.return path{stroke-dasharray:7 5}.edge.fanout path{stroke-width:2.6}.edge.error{color:var(--bad)}.edge.error path{stroke:var(--bad);stroke-dasharray:2 4}marker .bad{fill:var(--bad)}
33
72
  .flow .edge path{stroke-dasharray:6 6;animation:dash 1s linear infinite}
34
73
  @keyframes dash{to{stroke-dashoffset:-12}}
35
74
  .focus .node:not(.on),.focus .edge:not(.on){opacity:.22}
36
- #detail,#stepnote{min-height:1.5em;margin:8px 0 0}
37
- #stepnote{font-weight:600}
38
- .legend{display:flex;flex-wrap:wrap;gap:4px 16px;color:var(--mut);font-size:.85rem;margin:8px 0 0}
39
- .steps{margin:12px 0 0;padding-left:24px}
40
- .ba{display:grid;grid-template-columns:repeat(auto-fit,minmax(260px,1fr));gap:12px}
41
- .ba section{background:var(--card);border:1px solid var(--line);border-radius:8px;padding:8px 16px}
42
- .ba h3{margin:4px 0}.ba ul{margin:0;padding-left:20px}
43
- .added{color:var(--add);font-weight:600}.removed{color:var(--rem);text-decoration:line-through dashed}
75
+ .node:focus-visible{outline:2px solid var(--acc);outline-offset:2px}
76
+ .dbox rect{fill:var(--surface);stroke:var(--c,var(--fg));stroke-width:1.5}.dbox .t{font:600 14px var(--sans);fill:var(--fg)}.dbox .s{font:12.5px var(--mono);fill:var(--mut)}.dbox .st{color:var(--c)}
77
+ .dline{stroke:var(--mut);stroke-width:1.6;fill:none}.dl{font:12.5px var(--mono);fill:var(--fg);paint-order:stroke;stroke:var(--surface);stroke-width:4px}
78
+ .dband{fill:var(--surface2)}.dlab{font:600 13px var(--mono);fill:var(--mut);text-transform:uppercase}
79
+ .bar{display:flex;flex-wrap:wrap;gap:8px;align-items:center;margin:12px 0 0}
80
+ #detail,#stepnote{min-height:1.5em;margin:10px 0 0;color:var(--mut)}
81
+ #stepnote{color:var(--fg);font-weight:600}
82
+ .legend{display:flex;flex-wrap:wrap;gap:6px 18px;margin-top:12px;color:var(--mut);font:.8125rem/1.4 var(--mono)}
83
+ .steps-note{margin:14px 0 0;padding-left:24px;max-width:70ch;list-style:decimal}
84
+ .path{display:none;margin:0;padding:0}
85
+ .path li{display:flex;flex-wrap:wrap;align-items:center;gap:8px;border-top:1px solid var(--line);padding:10px 0}.path li:first-child{border-top:0}
86
+ .path b{font-weight:600}
87
+ .verb{display:inline-block;border:1px solid var(--line);border-radius:4px;padding:0 8px;font:.8125rem/1.6 var(--mono);color:var(--mut)}.verb.error{color:var(--bad);border-color:var(--bad)}.verb.branch,.verb.return{border-style:dashed}
88
+ .path-detail{display:none;margin-top:12px}.path-detail li{border-top:1px solid var(--line);padding:10px 0}.path-detail b{display:block}
89
+ .opts{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:12px;margin-top:14px;align-items:start}
90
+ .opts.n2{grid-template-columns:repeat(2,minmax(0,1fr))}.opts.n4,.opts.n6{grid-template-columns:repeat(4,minmax(0,1fr))}.opts.n5{grid-template-columns:repeat(3,minmax(0,1fr))}
91
+ .opt{padding:22px 20px;border-radius:4px;background:var(--surface);box-shadow:var(--shadow);display:grid;gap:12px;align-content:start;position:relative}
92
+ .opt.rec{background:var(--acc-bg);box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--acc) 45%,var(--surface))}
93
+ .opt .tag{position:absolute;top:-12px;left:16px;background:var(--acc);color:var(--surface);padding:3px 10px;border-radius:4px;font:700 .8125rem var(--mono);letter-spacing:.06em;text-transform:uppercase}
94
+ .opt h3{font-size:1.15rem;line-height:1.3}.opt .ln{color:var(--mut)}
95
+ .opt .tot{font:750 1.9rem/1 var(--sans);font-variant-numeric:tabular-nums}.opt .tot small{font:500 .875rem var(--sans);color:var(--mut)}
96
+ .crit{display:grid;gap:7px}.crit div{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:10px;align-items:center;font-size:.9rem}
97
+ .dots{display:inline-flex;gap:3px}.dots i{width:14px;height:8px;border-radius:2px;background:var(--surface2);border:1px solid var(--line)}.dots i.on{background:var(--mut);border-color:var(--mut)}
98
+ .opt.rec .dots i.on{background:var(--acc);border-color:var(--acc)}
99
+ .pc{display:grid;gap:6px}.pc li{display:flex;gap:8px;font-size:.9375rem}.pc .ic{margin-top:3px}.pc .p .ic{color:var(--ok)}.pc .c .ic{color:var(--bad)}
100
+ .note{margin-top:14px;display:flex;gap:8px;color:var(--mut);font-size:.9rem}.note .ic{margin-top:3px}
101
+ .chart.card{padding:18px 20px;max-width:520px}
102
+ svg .ct{font:13px var(--sans);fill:var(--fg)}svg .ct.strong{font-weight:700}svg .cv{font:600 13px var(--mono);fill:var(--fg)}
103
+ svg .ctrack{fill:var(--surface2)}svg .cgrid{stroke:var(--line);stroke-width:1}svg .cring{stroke:var(--surface);stroke-width:2}
104
+ svg .cbig{font:750 22px var(--sans);fill:var(--fg)}
105
+ .charts{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;margin-top:14px}
106
+ figure.chart{background:var(--surface);border-radius:4px;box-shadow:var(--shadow);padding:18px 20px;display:grid;gap:12px;align-content:start}
107
+ figure.chart{align-self:start}
108
+ figure.chart svg{display:block;width:100%;max-width:380px;height:auto}
109
+ figure.chart.donut .cbody{display:flex;flex-wrap:wrap;gap:16px;align-items:center}figure.chart.donut svg{max-width:150px;flex:none}
110
+ .clegend{display:grid;gap:6px;min-width:0;flex:1 1 150px}.clegend li{display:grid;grid-template-columns:14px minmax(0,1fr) auto auto;gap:8px;align-items:center;font-size:.9rem}.clegend.row{display:flex;flex-wrap:wrap;gap:6px 16px}.clegend.row li{display:flex}
111
+ .clegend em{color:var(--mut);font-style:normal;font:.8125rem var(--mono)}.clegend b{font:600 .875rem var(--mono)}
112
+ .sw{width:12px;height:12px;border-radius:3px;background:var(--mut);display:inline-block}
113
+ .sw[data-s="1"]{background:var(--s1)}.sw[data-s="2"]{background:var(--s2)}.sw[data-s="3"]{background:var(--s3)}.sw[data-s="4"]{background:var(--s4)}.sw[data-s="5"]{background:var(--s5)}
114
+ .sw[data-t=ok]{background:var(--ok)}.sw[data-t=warn]{background:var(--warn)}.sw[data-t=bad]{background:var(--bad)}.sw[data-t=info]{background:var(--info)}.sw[data-t=mut]{background:var(--mut)}
115
+ .tv summary{cursor:pointer;font:600 .8125rem var(--mono);letter-spacing:.06em;text-transform:uppercase;color:var(--mut)}.tv .tw{margin-top:8px}
116
+ .callouts{display:grid;gap:10px;margin-top:14px}.callout{display:flex;gap:12px;padding:14px 18px;border-radius:4px;background:var(--cb)}.callout .ic{color:var(--c);margin-top:2px}
117
+ .steps{display:grid;gap:0;position:relative}
118
+ .estep{display:grid;grid-template-columns:44px minmax(0,1fr) minmax(0,1.1fr);gap:4px 22px;padding:0 0 30px;position:relative}
119
+ .estep::before{content:"";position:absolute;left:16px;top:36px;bottom:0;width:2px;background:var(--line)}.estep:last-child::before{display:none}
120
+ .estep .no{display:grid;place-items:center;width:34px;height:34px;border-radius:4px;background:var(--fg);color:var(--surface);font:750 1rem var(--mono)}
121
+ .estep h3{font-size:1.2rem;line-height:1.3}.estep .sb p{color:var(--mut);margin-top:6px;max-width:48ch}
122
+ .estep .dg .fig{box-shadow:none}
123
+ .idea{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,.7fr) minmax(0,1fr);gap:20px;align-items:center}
124
+ .idea .side{display:grid;gap:14px}.centre{display:grid;gap:8px;justify-items:center;text-align:center;padding:26px 18px;border-radius:4px;border:1px solid color-mix(in srgb,var(--acc) 45%,var(--surface));background:var(--acc-bg);color:var(--acc)}.centre b{color:var(--fg);font-size:1.25rem;line-height:1.25}
125
+ .branch{padding:16px 18px;border-radius:4px;background:var(--surface);box-shadow:var(--shadow);display:grid;gap:10px;position:relative}
126
+ .branch h3{display:flex;gap:8px;align-items:center;font-size:1rem}
127
+ .chips{display:flex;flex-wrap:wrap;gap:6px}.chips li{padding:3px 10px;border-radius:4px;background:var(--surface2);font-size:.9rem}
128
+ .tl{position:relative;display:grid;gap:22px;padding-left:36px}
129
+ .tl::before{content:"";position:absolute;left:11px;top:6px;bottom:6px;width:2px;background:var(--line)}
130
+ .tl li{position:relative;display:grid;gap:2px}
131
+ .tl .dot{position:absolute;left:-36px;top:0;display:grid;place-items:center;width:24px;height:24px;border-radius:50%;background:var(--bg);color:var(--c);border:2px solid var(--c)}
132
+ .tl .dot .ic{width:14px;height:14px}.tl li.c-mut .dot{border-style:dashed}
133
+ .tl time{font:600 .8125rem var(--mono);letter-spacing:.06em;color:var(--mut)}.tl h3{font-size:1.05rem}.tl p{color:var(--mut);max-width:60ch}
134
+ .diff{display:grid;grid-template-columns:1fr 1fr;gap:12px}
135
+ .diff section{border:1px solid var(--line);border-radius:4px;background:var(--surface);overflow:hidden}
136
+ .diff h3{padding:10px 14px;font:600 .8125rem/1.3 var(--mono);text-transform:uppercase;letter-spacing:.08em;color:var(--mut);border-bottom:1px solid var(--line)}
137
+ .diff li{display:flex;gap:10px;padding:9px 14px;border-top:1px solid var(--line)}.diff li:first-child{border-top:0}
138
+ .diff li.add{background:var(--ok-bg)}.diff li.del{background:var(--bad-bg)}
139
+ .diff li .ic{margin-top:3px}.diff li.add .ic{color:var(--ok)}.diff li.del .ic{color:var(--bad)}.diff li.same .ic{opacity:0}
140
+ .dr{display:grid;gap:12px}.dr .ctx{max-width:70ch;font-size:1.05rem}
141
+ .pull{margin:14px 0;padding:26px 0;border-top:1px solid var(--line);border-bottom:1px solid var(--line)}
142
+ .pull .ic{color:var(--acc);width:36px;height:36px}.pull .lab{color:var(--acc);margin:8px 0}
143
+ .pull .big{font:italic 500 clamp(1.4rem,1.15rem + 1.2vw,2rem)/1.3 var(--serif);max-width:34em}
144
+ .cons{display:grid;gap:8px}.cons li{display:flex;gap:10px}.cons .ic{color:var(--ok);margin-top:3px}
145
+ .dec{display:grid;gap:12px}
146
+ .dec li{display:grid;grid-template-columns:minmax(0,1.25fr) minmax(0,1fr);gap:6px 28px;align-items:start;padding:18px;border-radius:4px;background:var(--surface);box-shadow:var(--shadow)}
147
+ .dec .q{grid-column:1;font-size:1.1rem;line-height:1.4;font-weight:600}
148
+ .dec .rec{grid-column:2;grid-row:1 / span 2;padding:10px 14px;background:var(--acc-bg);border-radius:4px}.dec .rec .lab{color:var(--acc)}.dec .rec p{margin-top:4px;font-weight:500}
149
+ .dec .chg{grid-column:1;color:var(--mut);font-size:.9375rem}.dec .chg .lab{margin-right:8px}
150
+ .evs{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:12px}
151
+ .ev{padding:16px 18px;border-radius:4px;background:var(--surface);box-shadow:var(--shadow);display:grid;gap:10px;align-content:start}
152
+ .ev b{font-weight:600;line-height:1.35}.ev .pr{color:var(--mut);font-size:.875rem}.ev .rs{font:600 .9375rem var(--mono)}
153
+ .badge{display:inline-flex;align-items:center;gap:6px;justify-self:start;border-radius:4px;padding:3px 9px;background:var(--cb);color:var(--c);font:600 .8125rem/1.3 var(--mono);letter-spacing:.03em}
154
+ .ev-verified{--c:var(--ok);--cb:var(--ok-bg)}.ev-inferred{--c:var(--warn);--cb:var(--warn-bg)}.ev-guess{--c:var(--mut);--cb:var(--surface2)}
44
155
  .tw{overflow-x:auto}
45
- table{border-collapse:collapse;width:100%;min-width:560px}
46
- th,td{text-align:left;vertical-align:top;border-bottom:1px solid var(--line);padding:6px 10px}
47
- th{font-size:.8rem;text-transform:uppercase;letter-spacing:.04em;color:var(--mut)}
48
- .tag{font-weight:600;white-space:nowrap}
49
- ol.d{padding-left:24px}ol.d li{margin:8px 0}
50
- a{color:var(--acc)}
51
- .present{font-size:1.2em}.present .bar,.present #theme{display:none}
52
- @media (prefers-reduced-motion:reduce){.flow .edge path{animation:none}}
53
- @media print{body{background:#fff;color:#000}.bar,#theme{display:none}.fig{overflow:visible}.flow .edge path{animation:none}.focus .node:not(.on),.focus .edge:not(.on){opacity:1}}`;
156
+ table{border-collapse:collapse;width:100%}
157
+ th{font:600 .8125rem/1.3 var(--mono);text-transform:uppercase;letter-spacing:.08em;color:var(--mut);text-align:left;padding:0 14px 8px 0;border-bottom:1px solid var(--fg)}
158
+ td{text-align:left;vertical-align:top;border-top:1px solid var(--line);padding:11px 14px 11px 0}
159
+ tbody tr:first-child td{border-top:0}
160
+ .log{background:var(--surface);border-radius:4px;box-shadow:var(--shadow)}
161
+ .log li{display:grid;grid-template-columns:110px 1fr;gap:14px;padding:12px 18px;border-top:1px solid var(--line)}.log li:first-child{border-top:0}.log time{font:600 .8125rem var(--mono);color:var(--mut);padding-top:2px}
162
+ .links{display:grid;gap:6px}
163
+ footer{margin-top:48px;padding-top:16px;border-top:1px solid var(--line);font:.8125rem/1.5 var(--mono);color:var(--mut)}
164
+ .deck{display:none}
165
+ html.present{font-size:1.15em}
166
+ html.present [data-slide]{display:none}
167
+ html.present [data-slide].cur{display:block;min-height:calc(100vh - 140px)}
168
+ html.present .banner.cur{display:grid;align-content:center}
169
+ html.present .mini,html.present footer,html.present .two:not(.cur){display:none}
170
+ html.present .deck{display:flex;position:fixed;left:0;right:0;bottom:0;z-index:30;gap:12px;align-items:center;justify-content:center;padding:10px;background:var(--bg);border-top:1px solid var(--line)}
171
+ html.present .deck span{font:600 .875rem var(--mono);color:var(--mut)}
172
+ @media (max-width:860px){.tiles{grid-template-columns:repeat(2,minmax(0,1fr))}.two,.charts,.evs,.opts,.opts.n2,.opts.n4,.opts.n5,.opts.n6{grid-template-columns:1fr}.banner{grid-template-columns:1fr;padding:22px;gap:14px}.b-ic{width:60px;height:60px}.b-ic .ic{width:38px;height:38px}
173
+ .strip{grid-auto-flow:row;gap:0}.seg{grid-template-columns:8px minmax(0,1fr);column-gap:14px;padding:10px 0;border-top:1px solid var(--line)}.seg:first-child{border-top:0}.seg .bar{grid-row:1 / span 2;height:100%;min-height:36px;width:6px;justify-self:center}
174
+ .log li{grid-template-columns:1fr;gap:2px}.dec li{display:block}.dec .rec{margin-top:12px}.diff{grid-template-columns:1fr}.estep{grid-template-columns:44px minmax(0,1fr)}.estep .dg{grid-column:2}
175
+ .idea{grid-template-columns:1fr}.idea .centre{order:-1}
176
+ .stack thead{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0)}.stack,.stack tbody,.stack tr,.stack td{display:block;width:100%}.stack tr{padding:12px 0;border-top:1px solid var(--line)}.stack tbody tr:first-child{border-top:0;padding-top:0}.stack td{border:0;padding:3px 0}
177
+ .stack td[data-label]::before{content:attr(data-label);display:block;font:600 .8125rem/1.3 var(--mono);text-transform:uppercase;letter-spacing:.08em;color:var(--mut);margin-bottom:2px}
178
+ .wrap{padding:12px 16px 56px}.sec{margin-top:32px}}
179
+ @media (prefers-reduced-motion:reduce){.flow .edge path{animation:none}.mini{transition:none}}
180
+ @media print{body{background:#fff;color:#000}.mini,.tools,.deck,.bar{display:none}.fig{overflow:visible;display:block!important}.path,.path-detail{display:none!important}[data-slide]{display:block!important;break-inside:avoid}.banner{break-after:page}.flow .edge path{animation:none}.focus .node:not(.on),.focus .edge:not(.on){opacity:1}}`;
54
181
 
55
- /** The page's script: theme, detail on hover or focus, play and pause, numbered steps. Text is set with textContent only. */
182
+ /** The page's script: theme, the mini header, detail on hover or focus, play and numbered steps, and the presentation mode. Text is set with textContent only. */
56
183
  export const PAGE_JS = `(()=>{
57
184
  const d=document,q=(s,r=d)=>r.querySelector(s),qa=(s,r=d)=>[...r.querySelectorAll(s)],root=d.documentElement;
58
185
  try{const t=localStorage.getItem('vz-theme');if(t==='dark'||t==='light')root.dataset.theme=t}catch(e){}
59
186
  const tb=q('#theme');
60
187
  if(tb)tb.onclick=()=>{const dark=root.dataset.theme?root.dataset.theme==='dark':matchMedia('(prefers-color-scheme: dark)').matches,n=dark?'light':'dark';root.dataset.theme=n;try{localStorage.setItem('vz-theme',n)}catch(e){}};
61
- if(new URLSearchParams(location.search).get('present')==='1')root.classList.add('present');
188
+ const hero=q('[data-hero]'),mini=q('.mini');
189
+ if(hero&&mini&&'IntersectionObserver'in window)new IntersectionObserver(([e])=>mini.classList.toggle('on',!e.isIntersecting),{threshold:0}).observe(hero);
190
+ const slides=qa('[data-slide]'),pb=q('#present'),count=q('#slide-count');
191
+ let cur=0;
192
+ const show=i=>{cur=Math.max(0,Math.min(slides.length-1,i));slides.forEach((s,k)=>s.classList.toggle('cur',k===cur));if(count)count.textContent=(cur+1)+' / '+slides.length;scrollTo(0,0)};
193
+ const present=on=>{root.classList.toggle('present',on);if(pb)pb.textContent=on?pb.dataset.off:pb.dataset.on;if(on)show(cur);else slides.forEach(s=>s.classList.remove('cur'))};
194
+ if(pb)pb.onclick=()=>present(!root.classList.contains('present'));
195
+ const sp=q('#slide-prev'),sn=q('#slide-next');
196
+ if(sp)sp.onclick=()=>show(cur-1);
197
+ if(sn)sn.onclick=()=>show(cur+1);
198
+ addEventListener('keydown',e=>{if(!root.classList.contains('present'))return;const k=e.key;
199
+ if(k==='ArrowRight'||k==='ArrowDown'||k==='PageDown'||k===' '){e.preventDefault();show(cur+1)}
200
+ else if(k==='ArrowLeft'||k==='ArrowUp'||k==='PageUp'){e.preventDefault();show(cur-1)}
201
+ else if(k==='Home'){show(0)}else if(k==='End'){show(slides.length-1)}else if(k==='Escape'){present(false)}});
202
+ if(new URLSearchParams(location.search).get('present')==='1')present(true);
62
203
  const fig=q('.fig'),panel=q('#detail');
63
204
  qa('[data-node]').forEach(n=>{const show=()=>{if(panel)panel.textContent=n.dataset.detail};n.addEventListener('mouseenter',show);n.addEventListener('focus',show)});
64
205
  const pp=q('#play');
@@ -67,14 +208,14 @@ const raw=q('#steps');
67
208
  if(raw&&fig){
68
209
  const steps=JSON.parse(raw.textContent),note=q('#stepnote'),prev=q('#prev'),next=q('#next'),all=q('#all');
69
210
  let at=-1;
70
- const show=i=>{at=i;qa('.on',fig).forEach(x=>x.classList.remove('on'));
211
+ const go=i=>{at=i;qa('.on',fig).forEach(x=>x.classList.remove('on'));
71
212
  if(i<0){fig.classList.remove('focus');note.textContent='';return}
72
213
  const s=steps[i];fig.classList.add('focus');
73
214
  s.nodes.forEach(id=>q('[data-node="'+id+'"]',fig)?.classList.add('on'));
74
215
  s.edges.forEach(id=>q('[data-edge="'+id+'"]',fig)?.classList.add('on'));
75
216
  note.textContent=(i+1)+'/'+steps.length+' '+s.title+' - '+s.note};
76
- if(prev)prev.onclick=()=>show(Math.max(0,at-1));
77
- if(next)next.onclick=()=>show(Math.min(steps.length-1,at+1));
78
- if(all)all.onclick=()=>show(-1);
217
+ if(prev)prev.onclick=()=>go(Math.max(0,at-1));
218
+ if(next)next.onclick=()=>go(Math.min(steps.length-1,at+1));
219
+ if(all)all.onclick=()=>go(-1);
79
220
  }
80
221
  })();`;