@orkestrel/scaffold 0.0.132 → 0.0.134

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 (86) hide show
  1. package/dist/agents/skills/orkestrel-dispatch/scripts/bench.js +61 -96
  2. package/dist/agents/skills/orkestrel-dispatch/scripts/brief.js +48 -76
  3. package/dist/agents/skills/orkestrel-dispatch/scripts/chain.js +27 -66
  4. package/dist/agents/skills/orkestrel-dispatch/scripts/cite.js +31 -64
  5. package/dist/agents/skills/orkestrel-dispatch/scripts/launch.js +43 -57
  6. package/dist/agents/skills/orkestrel-dispatch/scripts/login.js +43 -86
  7. package/dist/agents/skills/orkestrel-dispatch/scripts/patch.js +68 -104
  8. package/dist/agents/skills/orkestrel-dispatch/scripts/result.js +35 -69
  9. package/dist/agents/skills/orkestrel-dispatch/scripts/sweep.js +47 -84
  10. package/dist/agents/skills/orkestrel-falsify/scripts/mutate.js +134 -116
  11. package/dist/agents/skills/orkestrel-harden/scripts/discovery.js +38 -90
  12. package/dist/agents/skills/orkestrel-harden/scripts/interleave.js +39 -103
  13. package/dist/agents/skills/orkestrel-harden/scripts/measure.js +40 -89
  14. package/dist/agents/skills/orkestrel-harden/scripts/titles.js +41 -87
  15. package/dist/agents/skills/orkestrel-parallel/scripts/cases.js +43 -88
  16. package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +1018 -194
  17. package/dist/agents/skills/orkestrel-publish/scripts/compare.js +40 -60
  18. package/dist/agents/skills/orkestrel-publish/scripts/pins.js +47 -81
  19. package/dist/agents/skills/orkestrel-publish/scripts/steps.js +66 -104
  20. package/dist/agents/skills/orkestrel-publish/scripts/swap.js +74 -88
  21. package/dist/agents/skills/orkestrel-publish/scripts/wave.js +95 -108
  22. package/dist/agents/skills/orkestrel-publish/scripts/window.js +55 -96
  23. package/dist/agents/skills/orkestrel-scout/scripts/map.js +54 -101
  24. package/dist/bin/main.js +30 -6
  25. package/dist/bin/main.js.map +1 -1
  26. package/dist/host/agents/orchestration.md +1 -0
  27. package/dist/host/agents/skills/orkestrel-dispatch/scripts/bench.ts +81 -97
  28. package/dist/host/agents/skills/orkestrel-dispatch/scripts/brief.ts +64 -72
  29. package/dist/host/agents/skills/orkestrel-dispatch/scripts/chain.ts +41 -63
  30. package/dist/host/agents/skills/orkestrel-dispatch/scripts/cite.ts +56 -79
  31. package/dist/host/agents/skills/orkestrel-dispatch/scripts/launch.ts +61 -74
  32. package/dist/host/agents/skills/orkestrel-dispatch/scripts/login.ts +59 -89
  33. package/dist/host/agents/skills/orkestrel-dispatch/scripts/patch.ts +87 -106
  34. package/dist/host/agents/skills/orkestrel-dispatch/scripts/result.ts +57 -76
  35. package/dist/host/agents/skills/orkestrel-dispatch/scripts/sweep.ts +73 -88
  36. package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +2 -2
  37. package/dist/host/agents/skills/orkestrel-falsify/scripts/mutate.ts +167 -119
  38. package/dist/host/agents/skills/orkestrel-harden/references/methods.md +1 -1
  39. package/dist/host/agents/skills/orkestrel-harden/scripts/discovery.ts +58 -75
  40. package/dist/host/agents/skills/orkestrel-harden/scripts/interleave.ts +55 -99
  41. package/dist/host/agents/skills/orkestrel-harden/scripts/measure.ts +59 -90
  42. package/dist/host/agents/skills/orkestrel-harden/scripts/titles.ts +60 -80
  43. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +4 -4
  44. package/dist/host/agents/skills/orkestrel-parallel/scripts/cases.ts +71 -108
  45. package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +1288 -239
  46. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +10 -6
  47. package/dist/host/agents/skills/orkestrel-publish/scripts/compare.ts +58 -79
  48. package/dist/host/agents/skills/orkestrel-publish/scripts/pins.ts +66 -87
  49. package/dist/host/agents/skills/orkestrel-publish/scripts/steps.ts +84 -102
  50. package/dist/host/agents/skills/orkestrel-publish/scripts/swap.ts +92 -99
  51. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +130 -126
  52. package/dist/host/agents/skills/orkestrel-publish/scripts/window.ts +82 -120
  53. package/dist/host/agents/skills/orkestrel-scout/SKILL.md +3 -3
  54. package/dist/host/agents/skills/orkestrel-scout/scripts/map.ts +85 -112
  55. package/dist/host/claude/agents/orkestrel.md +54 -54
  56. package/dist/host/claude/rules/documentation.md +1 -1
  57. package/dist/host/claude/rules/patterns.md +5 -4
  58. package/dist/host/claude/rules/styles.md +1 -1
  59. package/dist/host/claude/rules/tests.md +8 -3
  60. package/dist/host/claude/rules/workspace.md +47 -35
  61. package/dist/host/configs/helpers.ts +40 -15
  62. package/dist/host/dotfiles/oxlintrc.json +62 -0
  63. package/dist/host/guides/browser.md +1 -1
  64. package/dist/host/guides/form.md +79 -4
  65. package/dist/host/guides/queue.md +3 -1
  66. package/dist/host/guides/scaffold.md +95 -67
  67. package/dist/host/guides/table.md +20 -6
  68. package/dist/host/guides/test.md +342 -202
  69. package/dist/host/guides/workflow.md +4 -2
  70. package/dist/host/manifest.json +48 -48
  71. package/dist/host/tests/config.test.ts +201 -11
  72. package/dist/host/tests/policy.test.ts +15 -22
  73. package/dist/host/tests/setupPolicy.ts +43 -36
  74. package/dist/src/core/index.cjs +194 -97
  75. package/dist/src/core/index.cjs.map +1 -1
  76. package/dist/src/core/index.d.cts +27 -13
  77. package/dist/src/core/index.d.ts +27 -13
  78. package/dist/src/core/index.js +192 -97
  79. package/dist/src/core/index.js.map +1 -1
  80. package/dist/src/server/index.cjs +8 -9
  81. package/dist/src/server/index.cjs.map +1 -1
  82. package/dist/src/server/index.d.cts +1 -1
  83. package/dist/src/server/index.d.ts +1 -1
  84. package/dist/src/server/index.js +8 -9
  85. package/dist/src/server/index.js.map +1 -1
  86. package/package.json +5 -5
@@ -41,60 +41,60 @@ Treat generated package identifiers, versions, layers, and dependency ranges as
41
41
 
42
42
  <!-- orkestrel:catalog -->
43
43
 
44
- | Package | Version | Layer | Runtime dependencies | Peer dependencies |
45
- | ----------------------- | --------- | ----- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
46
- | `@orkestrel/abort` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.23` | |
47
- | `@orkestrel/agent` | `0.0.40` | L5 | `@orkestrel/tool` `^0.0.22`, `@orkestrel/abort` `^0.0.16`, `@orkestrel/queue` `^0.0.21`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/ndjson` `^0.0.16`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22`, `@orkestrel/workflow` `^0.0.27`, `@orkestrel/workspace` `^0.0.16` | |
48
- | `@orkestrel/brief` | `0.0.17` | L4 | `@orkestrel/reason` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/interpret` `^0.0.22` | |
49
- | `@orkestrel/browser` | `0.0.32` | L5 | `@orkestrel/mcp` `^0.0.42`, `@orkestrel/html` `^0.0.15`, `@orkestrel/pool` `^0.0.20`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/codec` `^0.0.9`, `@orkestrel/router` `^0.0.20`, `@orkestrel/server` `^0.0.26`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/markdown` `^0.0.20`, `@orkestrel/websocket` `^0.0.18` | |
50
- | `@orkestrel/budget` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.23` | |
51
- | `@orkestrel/capture` | `0.0.6` | L3 | `@orkestrel/process` `^0.0.18`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | `vite` `^8.3.7`, `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.61.0`, `@vitest/browser-playwright` `^4.1.12 \|\| ^5.0.5` |
52
- | `@orkestrel/codec` | `0.0.10` | L1 | `@orkestrel/contract` `^0.0.23` | |
53
- | `@orkestrel/console` | `0.0.20` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
54
- | `@orkestrel/contract` | `0.0.23` | L0 | | |
55
- | `@orkestrel/csv` | `0.0.14` | L2 | `@orkestrel/codec` `^0.0.10`, `@orkestrel/contract` `^0.0.23` | |
56
- | `@orkestrel/database` | `0.0.23` | L2 | `@orkestrel/sqlite` `^0.0.18`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/indexeddb` `^0.0.18` | |
57
- | `@orkestrel/emitter` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.23` | |
58
- | `@orkestrel/form` | `0.0.17` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
59
- | `@orkestrel/guide` | `0.0.30` | L3 | `@orkestrel/contract` `^0.0.22`, `@orkestrel/markdown` `^0.0.20` | |
60
- | `@orkestrel/html` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.23` | |
61
- | `@orkestrel/indexeddb` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.23` | |
62
- | `@orkestrel/interpret` | `0.0.22` | L3 | `@orkestrel/reason` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/template` `^0.0.13` | |
63
- | `@orkestrel/jsonrpc` | `0.0.3` | L1 | `@orkestrel/contract` `^0.0.23` | |
64
- | `@orkestrel/lsp` | `0.0.14` | L3 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/jsonrpc` `^0.0.2`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22` | |
65
- | `@orkestrel/markdown` | `0.0.21` | L2 | `@orkestrel/html` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
66
- | `@orkestrel/mcp` | `0.0.42` | L4 | `@orkestrel/sse` `^0.0.13`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/codec` `^0.0.9`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/jsonrpc` `^0.0.2`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/websocket` `^0.0.18` | `@orkestrel/router` `^0.0.20`, `@orkestrel/server` `^0.0.26` |
67
- | `@orkestrel/middleware` | `0.0.30` | L4 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | `@orkestrel/server` `^0.0.26`, `@orkestrel/database` `^0.0.22` |
68
- | `@orkestrel/msg` | `0.0.17` | L2 | `@orkestrel/codec` `^0.0.10`, `@orkestrel/contract` `^0.0.23` | |
69
- | `@orkestrel/ndjson` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.23` | |
70
- | `@orkestrel/ollama` | `0.0.34` | L6 | `@orkestrel/tool` `^0.0.22`, `@orkestrel/agent` `^0.0.40`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/ndjson` `^0.0.16`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22` | |
71
- | `@orkestrel/pool` | `0.0.21` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
72
- | `@orkestrel/probe` | `0.0.29` | L5 | `@orkestrel/lsp` `^0.0.14`, `@orkestrel/mcp` `^0.0.42`, `@orkestrel/pool` `^0.0.20`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | `vitest` `^4.1.12 \|\| ^5.1.0`, `typescript` `^6.0.3 \|\| ^7.0.2` |
73
- | `@orkestrel/process` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
74
- | `@orkestrel/program` | `0.0.20` | L4 | `@orkestrel/rater` `^0.0.21`, `@orkestrel/reason` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/qualifier` `^0.0.21` | |
75
- | `@orkestrel/qualifier` | `0.0.21` | L3 | `@orkestrel/reason` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
76
- | `@orkestrel/queue` | `0.0.21` | L3 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22` | |
77
- | `@orkestrel/rater` | `0.0.21` | L3 | `@orkestrel/reason` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22` | |
78
- | `@orkestrel/reason` | `0.0.18` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
79
- | `@orkestrel/relation` | `0.0.20` | L3 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22` | |
80
- | `@orkestrel/router` | `0.0.21` | L2 | `@orkestrel/abort` `^0.0.17`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
81
- | `@orkestrel/scaffold` | `0.0.131` | L3 | `@orkestrel/console` `^0.0.19`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/markdown` `^0.0.20`, `@orkestrel/template` `^0.0.13` | |
82
- | `@orkestrel/sea` | `0.0.22` | L3 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/process` `^0.0.18`, `@orkestrel/contract` `^0.0.22` | |
83
- | `@orkestrel/server` | `0.0.26` | L3 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/codec` `^0.0.9`, `@orkestrel/router` `^0.0.20`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | |
84
- | `@orkestrel/sqlite` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.23` | |
85
- | `@orkestrel/sse` | `0.0.14` | L2 | `@orkestrel/codec` `^0.0.10`, `@orkestrel/contract` `^0.0.23` | |
86
- | `@orkestrel/study` | `0.0.17` | L7 | `@orkestrel/tool` `^0.0.22`, `@orkestrel/abort` `^0.0.16`, `@orkestrel/agent` `^0.0.40`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/ollama` `^0.0.34`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22` | |
87
- | `@orkestrel/table` | `0.0.16` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
88
- | `@orkestrel/template` | `0.0.14` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
89
- | `@orkestrel/terminal` | `0.0.24` | L3 | `@orkestrel/sse` `^0.0.13`, `@orkestrel/form` `^0.0.16`, `@orkestrel/console` `^0.0.19`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22` | |
90
- | `@orkestrel/test` | `0.0.34` | L1 | `@orkestrel/contract` `^0.0.23` | `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.65.0` |
91
- | `@orkestrel/timeout` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.23` | |
92
- | `@orkestrel/tool` | `0.0.23` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
93
- | `@orkestrel/toolbox` | `0.0.29` | L6 | `@orkestrel/form` `^0.0.16`, `@orkestrel/tool` `^0.0.22`, `@orkestrel/agent` `^0.0.40`, `@orkestrel/server` `^0.0.26`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22`, `@orkestrel/relation` `^0.0.20`, `@orkestrel/terminal` `^0.0.24`, `@orkestrel/workflow` `^0.0.27`, `@orkestrel/workspace` `^0.0.16` | |
94
- | `@orkestrel/websocket` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
95
- | `@orkestrel/worker` | `0.0.21` | L4 | `@orkestrel/pool` `^0.0.20`, `@orkestrel/queue` `^0.0.21`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22` | |
96
- | `@orkestrel/workflow` | `0.0.27` | L4 | `@orkestrel/abort` `^0.0.16`, `@orkestrel/queue` `^0.0.21`, `@orkestrel/budget` `^0.0.17`, `@orkestrel/emitter` `^0.0.15`, `@orkestrel/timeout` `^0.0.16`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22` | |
97
- | `@orkestrel/workspace` | `0.0.16` | L3 | `@orkestrel/emitter` `^0.0.15`, `@orkestrel/contract` `^0.0.22`, `@orkestrel/database` `^0.0.22` | |
44
+ | Package | Version | Layer | Runtime dependencies | Peer dependencies |
45
+ | ----------------------- | --------- | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
46
+ | `@orkestrel/abort` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.23` | |
47
+ | `@orkestrel/agent` | `0.0.41` | L5 | `@orkestrel/tool` `^0.0.23`, `@orkestrel/abort` `^0.0.17`, `@orkestrel/queue` `^0.0.22`, `@orkestrel/budget` `^0.0.18`, `@orkestrel/ndjson` `^0.0.17`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/timeout` `^0.0.17`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/database` `^0.0.23`, `@orkestrel/workflow` `^0.0.28`, `@orkestrel/workspace` `^0.0.17` | |
48
+ | `@orkestrel/brief` | `0.0.18` | L4 | `@orkestrel/reason` `^0.0.18`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/interpret` `^0.0.23` | |
49
+ | `@orkestrel/browser` | `0.0.33` | L5 | `@orkestrel/mcp` `^0.0.43`, `@orkestrel/html` `^0.0.16`, `@orkestrel/pool` `^0.0.21`, `@orkestrel/tool` `^0.0.23`, `@orkestrel/codec` `^0.0.10`, `@orkestrel/router` `^0.0.21`, `@orkestrel/server` `^0.0.27`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/process` `^0.0.19`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/markdown` `^0.0.21`, `@orkestrel/websocket` `^0.0.19` | |
50
+ | `@orkestrel/budget` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.23` | |
51
+ | `@orkestrel/capture` | `0.0.7` | L3 | `@orkestrel/process` `^0.0.19`, `@orkestrel/timeout` `^0.0.17`, `@orkestrel/contract` `^0.0.23` | `vite` `^8.3.8`, `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.61.0`, `@vitest/browser-playwright` `^4.1.12 \|\| ^5.0.5` |
52
+ | `@orkestrel/codec` | `0.0.10` | L1 | `@orkestrel/contract` `^0.0.23` | |
53
+ | `@orkestrel/console` | `0.0.20` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
54
+ | `@orkestrel/contract` | `0.0.23` | L0 | | |
55
+ | `@orkestrel/csv` | `0.0.14` | L2 | `@orkestrel/codec` `^0.0.10`, `@orkestrel/contract` `^0.0.23` | |
56
+ | `@orkestrel/database` | `0.0.23` | L2 | `@orkestrel/sqlite` `^0.0.18`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/indexeddb` `^0.0.18` | |
57
+ | `@orkestrel/emitter` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.23` | |
58
+ | `@orkestrel/form` | `0.0.18` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
59
+ | `@orkestrel/guide` | `0.0.31` | L3 | `@orkestrel/contract` `^0.0.23`, `@orkestrel/markdown` `^0.0.21` | |
60
+ | `@orkestrel/html` | `0.0.16` | L1 | `@orkestrel/contract` `^0.0.23` | |
61
+ | `@orkestrel/indexeddb` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.23` | |
62
+ | `@orkestrel/interpret` | `0.0.23` | L3 | `@orkestrel/reason` `^0.0.18`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/template` `^0.0.14` | |
63
+ | `@orkestrel/jsonrpc` | `0.0.3` | L1 | `@orkestrel/contract` `^0.0.23` | |
64
+ | `@orkestrel/lsp` | `0.0.15` | L3 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/jsonrpc` `^0.0.3`, `@orkestrel/process` `^0.0.19`, `@orkestrel/contract` `^0.0.23` | |
65
+ | `@orkestrel/markdown` | `0.0.21` | L2 | `@orkestrel/html` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
66
+ | `@orkestrel/mcp` | `0.0.43` | L4 | `@orkestrel/sse` `^0.0.14`, `@orkestrel/tool` `^0.0.23`, `@orkestrel/codec` `^0.0.10`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/jsonrpc` `^0.0.3`, `@orkestrel/process` `^0.0.19`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/websocket` `^0.0.19` | `@orkestrel/router` `^0.0.21`, `@orkestrel/server` `^0.0.27` |
67
+ | `@orkestrel/middleware` | `0.0.31` | L4 | `@orkestrel/abort` `^0.0.17`, `@orkestrel/budget` `^0.0.18`, `@orkestrel/timeout` `^0.0.17`, `@orkestrel/contract` `^0.0.23` | `@orkestrel/server` `^0.0.27`, `@orkestrel/database` `^0.0.23` |
68
+ | `@orkestrel/msg` | `0.0.17` | L2 | `@orkestrel/codec` `^0.0.10`, `@orkestrel/contract` `^0.0.23` | |
69
+ | `@orkestrel/ndjson` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.23` | |
70
+ | `@orkestrel/ollama` | `0.0.35` | L6 | `@orkestrel/tool` `^0.0.23`, `@orkestrel/agent` `^0.0.41`, `@orkestrel/budget` `^0.0.18`, `@orkestrel/ndjson` `^0.0.17`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/process` `^0.0.19`, `@orkestrel/contract` `^0.0.23` | |
71
+ | `@orkestrel/pool` | `0.0.21` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
72
+ | `@orkestrel/probe` | `0.0.30` | L5 | `@orkestrel/lsp` `^0.0.15`, `@orkestrel/mcp` `^0.0.43`, `@orkestrel/pool` `^0.0.21`, `@orkestrel/tool` `^0.0.23`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/process` `^0.0.19`, `@orkestrel/timeout` `^0.0.17`, `@orkestrel/contract` `^0.0.23` | `vitest` `^4.1.12 \|\| ^5.1.0`, `typescript` `^6.0.3 \|\| ^7.0.2` |
73
+ | `@orkestrel/process` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
74
+ | `@orkestrel/program` | `0.0.21` | L4 | `@orkestrel/rater` `^0.0.22`, `@orkestrel/reason` `^0.0.18`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/qualifier` `^0.0.22` | |
75
+ | `@orkestrel/qualifier` | `0.0.22` | L3 | `@orkestrel/reason` `^0.0.18`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
76
+ | `@orkestrel/queue` | `0.0.22` | L3 | `@orkestrel/abort` `^0.0.17`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/timeout` `^0.0.17`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/database` `^0.0.23` | |
77
+ | `@orkestrel/rater` | `0.0.22` | L3 | `@orkestrel/reason` `^0.0.18`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
78
+ | `@orkestrel/reason` | `0.0.18` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
79
+ | `@orkestrel/relation` | `0.0.21` | L3 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/database` `^0.0.23` | |
80
+ | `@orkestrel/router` | `0.0.21` | L2 | `@orkestrel/abort` `^0.0.17`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
81
+ | `@orkestrel/scaffold` | `0.0.133` | L3 | `@orkestrel/console` `^0.0.20`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/process` `^0.0.19`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/markdown` `^0.0.21`, `@orkestrel/template` `^0.0.14` | |
82
+ | `@orkestrel/sea` | `0.0.23` | L3 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/process` `^0.0.19`, `@orkestrel/contract` `^0.0.23` | |
83
+ | `@orkestrel/server` | `0.0.27` | L3 | `@orkestrel/abort` `^0.0.17`, `@orkestrel/codec` `^0.0.10`, `@orkestrel/router` `^0.0.21`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/timeout` `^0.0.17`, `@orkestrel/contract` `^0.0.23` | |
84
+ | `@orkestrel/sqlite` | `0.0.18` | L1 | `@orkestrel/contract` `^0.0.23` | |
85
+ | `@orkestrel/sse` | `0.0.14` | L2 | `@orkestrel/codec` `^0.0.10`, `@orkestrel/contract` `^0.0.23` | |
86
+ | `@orkestrel/study` | `0.0.18` | L7 | `@orkestrel/tool` `^0.0.23`, `@orkestrel/abort` `^0.0.17`, `@orkestrel/agent` `^0.0.41`, `@orkestrel/budget` `^0.0.18`, `@orkestrel/ollama` `^0.0.35`, `@orkestrel/timeout` `^0.0.17`, `@orkestrel/contract` `^0.0.23` | |
87
+ | `@orkestrel/table` | `0.0.17` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
88
+ | `@orkestrel/template` | `0.0.14` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
89
+ | `@orkestrel/terminal` | `0.0.25` | L3 | `@orkestrel/sse` `^0.0.14`, `@orkestrel/form` `^0.0.17`, `@orkestrel/console` `^0.0.20`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/database` `^0.0.23` | |
90
+ | `@orkestrel/test` | `0.0.37` | L1 | `@orkestrel/contract` `^0.0.23` | `vitest` `^4.1.12 \|\| ^5.1.0`, `playwright` `^1.65.0` |
91
+ | `@orkestrel/timeout` | `0.0.17` | L1 | `@orkestrel/contract` `^0.0.23` | |
92
+ | `@orkestrel/tool` | `0.0.23` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
93
+ | `@orkestrel/toolbox` | `0.0.30` | L6 | `@orkestrel/form` `^0.0.17`, `@orkestrel/tool` `^0.0.23`, `@orkestrel/agent` `^0.0.41`, `@orkestrel/server` `^0.0.27`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/database` `^0.0.23`, `@orkestrel/relation` `^0.0.21`, `@orkestrel/terminal` `^0.0.25`, `@orkestrel/workflow` `^0.0.28`, `@orkestrel/workspace` `^0.0.17` | |
94
+ | `@orkestrel/websocket` | `0.0.19` | L2 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23` | |
95
+ | `@orkestrel/worker` | `0.0.22` | L4 | `@orkestrel/pool` `^0.0.21`, `@orkestrel/queue` `^0.0.22`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/database` `^0.0.23` | |
96
+ | `@orkestrel/workflow` | `0.0.28` | L4 | `@orkestrel/abort` `^0.0.17`, `@orkestrel/queue` `^0.0.22`, `@orkestrel/budget` `^0.0.18`, `@orkestrel/emitter` `^0.0.16`, `@orkestrel/timeout` `^0.0.17`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/database` `^0.0.23` | |
97
+ | `@orkestrel/workspace` | `0.0.17` | L3 | `@orkestrel/emitter` `^0.0.16`, `@orkestrel/contract` `^0.0.23`, `@orkestrel/database` `^0.0.23` | |
98
98
 
99
99
  <!-- /orkestrel:catalog -->
100
100
 
@@ -113,7 +113,7 @@ A skill, a tool description, and a refusal message each teach an agent mid-task.
113
113
 
114
114
  - Run a script in a target through its built twin, `node node_modules/@orkestrel/scaffold/dist/agents/skills/<skill>/scripts/<name>.js`, because Node refuses to strip types for a file under `node_modules`; `.claude/rules/workspace.md` names the `build:skills` script that emits the twins. When a script spawns a sibling script, take the extension from the running file (`extname(fileURLToPath(import.meta.url))`), so the twin spawns `.js` and the checkout spawns `.ts`. When a script resolves a file under `.agents/templates/`, add that file to the copy in `build:skills`.
115
115
  - Resolve a sibling canon file (a template, another script) from the script's own location with `import.meta.url`, and the manifest, `tmp/`, and the test tree from the working directory, because a target runs the script from `node_modules/@orkestrel/scaffold/dist/agents/` against its own checkout.
116
- - Read arguments as `--flag value` pairs: the first occurrence of a flag wins, a value that opens with `--` is a missing value, and `--flag=value` is not read. Refuse every argument before a bare `--` that opens with `--` and names no flag the script reads, the `--flag=value` form included, so a mistyped flag never runs the default; a bare `--` opens a command the script passes on. Where flags select different work (`--visit` or `--plan`), the script names one operation mode per run and refuses two; where each flag adds a section to one report (`--tree` with `--headings`), the script combines them and its usage line says so. Read every value of a flag that repeats (`--range`) and say in the usage line that it repeats. Exit 64 on every usage refusal and say on stderr what was refused: the usage line when no mode or two modes were given, and the flag with the value it takes when a flag was unknown, malformed, or given with no value.
116
+ - Read arguments with `parseArgs` from `node:util`, with `strict: true` and every flag the script reads declared in its `options`: it refuses an unknown flag, a value-taking flag with no value, and a value that opens with `-` and is longer than `-`, outside the `--flag=value` form, and it reads `--flag value` and `--flag=value` alike. Never wrap `parseArgs` to change what it reads. Declare a flag that repeats (`--range`) with `multiple: true` and say in the usage line that it repeats. Where a script passes a command on, parse only the arguments before the first bare `--` and take the arguments after it as the command. Where flags select different work (`--visit` or `--plan`), the script names one operation mode per run and refuses two; where each flag adds a section to one report (`--tree` with `--headings`), the script combines them and its usage line says so. Exit 64 on every usage refusal and say on stderr what was refused: the `parseArgs` error message followed by the usage line, the usage line when no mode or two modes were given, and the flag with the value it takes when a value fails the script's own check.
117
117
  - Print to the terminal by default. Offer `--json` for a reader that parses, and `--out FILE` (`.txt` for a list, `.json` for a structure) where a lane reads the result later or the output would crowd a context; a written file saves the tokens a terminal dump spends. Choose per script; state each form in its usage line.
118
118
  - Verify each API a skill instructs an executor to call against the installed package's public entry before landing the instruction, and name the entry you read. A skill that names a symbol its package does not export teaches an executor to write a dangling import.
119
119
  - Put every symbol a skill teaches in a named import inside a Markdown fence in `SKILL.md` or a named reference. The policy sweep reads fenced value and type imports from `@orkestrel/*` declaration entries; it does not read identifiers in prose or table cells, or validate call signatures and runtime behavior.
@@ -13,10 +13,11 @@ These rules govern the shape of options, managers, emitters, and contracts, and
13
13
 
14
14
  `AGENTS.md` § Non-negotiable rules owns the reuse law. Before writing a guard, parser, combinator, outcome, safe exception boundary, contract shape/compiler, schema utility, error narrower, emitter helper, or other general primitive:
15
15
 
16
- 1. Inspect `package.json`, the lockfile, vendored dependency guides, and exact installed declarations/exports.
17
- 2. Build a semantic overlap map between the proposed/local behavior and declared `@orkestrel/*` capabilities.
18
- 3. Keep local behavior only when it adds a real domain invariant, composition, projection, translation, or intentionally different contract.
19
- 4. Test the difference. Similar names are not proof of equivalent semantics.
16
+ 1. Check the stable `node:` modules and ECMAScript built-ins at the declared `engines.node` floor, and use the one whose semantics match, such as `parseArgs` from `node:util` for command-line flags.
17
+ 2. Inspect `package.json`, the lockfile, vendored dependency guides, and exact installed declarations/exports.
18
+ 3. Build a semantic overlap map between the proposed/local behavior and declared `@orkestrel/*` capabilities.
19
+ 4. Keep local behavior only when it adds a real domain invariant, composition, projection, translation, or intentionally different contract.
20
+ 5. Test the difference. Similar names are not proof of equivalent semantics.
20
21
 
21
22
  ## Options
22
23
 
@@ -109,4 +109,4 @@ State classes are bare adjectives such as `.active` and `.disabled`, chosen cons
109
109
 
110
110
  When a class sets one component's tokens for one key of a shared Sass map, such as a recreated `$theme-colors`, write it as a variant class, as Bootstrap writes `.btn-success`: generate one class per key with `@each` over the map's keys, take each value from the family map with an `@error` on a missing key, and set only the component's own custom properties. Keep the bare modifier form for a class that any component reads.
111
111
 
112
- The composable owns interaction state, class application, `aria-*`, and timing. The partial owns visual presentation. Their contracts are stable class names and transition tokens. A native browser module's partial keys its chrome on the module's `data-*` state attribute, scoped under the module's host attribute, and its proof sets the attribute directly; the stable-class-name contract covers the classes a composable writes, not a module's attributes.
112
+ The composable owns interaction state, class application, `aria-*`, and timing. The partial owns visual presentation. Their contracts are stable class names and transition tokens. A native browser module's partial keys its chrome on the module's `data-*` state attribute, scoped under the module's host attribute, and its proof sets the attribute directly; the stable-class-name contract covers the classes a composable writes, not a module's attributes. When descent from the host cannot select every element the module marks, because the module declares no host attribute or reaches the element through an association such as `commandfor` or `form`, key the state attribute on the marked element instead: compound it with the class whose paint the state changes, and only when no other module of the package writes that attribute. The proof of such a rule sets the attribute directly in a fixture that carries no host attribute, and proves that an element carrying the attribute without the class paints unchanged.
@@ -180,6 +180,11 @@ A test that spawns a process, packs, installs, or drives a real build is a proof
180
180
  `.claude/rules/workspace.md` § Test project matrix places.
181
181
  - Keep a study's developmental selection and its untouched confirmation as separate evidence
182
182
  populations, and withhold expected outputs and population membership from the run.
183
+ - Keep the `studies` project short enough to run with every unit that touches a study: drive it from
184
+ seeded, replayed, or scripted runs, and move a full-schedule rehearsal out of it into an on-demand
185
+ script outside every chain, per `.claude/rules/quality.md` § Performance.
186
+ - In a study test file, record each sealed result once, before its cases, and read it from every
187
+ case that needs it; never record a result per case.
183
188
  - Put in `studies` only the proofs the `@orkestrel/study` engine drives. Place a slow end-to-end proof of
184
189
  the package's own features that no study engine drives, such as its built executable run against
185
190
  a fixture workspace, as an integration test under § Cross-cutting proofs. Place it by the scope it
@@ -204,9 +209,9 @@ Test helpers are shared infrastructure, not local test-file clutter.
204
209
  - For the test modules scaffold owns, keep shared helpers within them instead of importing them
205
210
  from `@orkestrel/test`. In the vendored set (`tests/setupPolicy.ts`, `tests/policy.test.ts`, and
206
211
  `tests/config.test.ts`), follow the vendored-file import law in `.claude/rules/workspace.md`. In
207
- the `tests/setupDistribution.ts` harness, import only `node:` modules, `vitest`, and `vite`, and
208
- in its browser variant also `playwright`, `@vitest/browser-playwright`, and
209
- `../configs/browsers.js`.
212
+ the `tests/setupDistribution.ts` harness, import only `node:` modules, `@orkestrel/contract`,
213
+ `vitest`, and `vite`, and in its browser variant also `playwright`, `@vitest/browser-playwright`,
214
+ and `../configs/browsers.js`.
210
215
 
211
216
  - Extract a fixture, recorder, event factory, async wait, renderer, scenario/data builder, protocol fixture, or DOM builder as soon as it could serve another test.
212
217
  - Any duplicate or near-duplicate helper is a defect; consolidate it into one general form.
@@ -16,30 +16,37 @@ Use only the environments a project needs, and keep the root dependency model in
16
16
 
17
17
  ## Environments
18
18
 
19
- | Path | Purpose |
20
- | -------------- | ------------------------------------------------------------------ |
21
- | `src/core/` | Published host-independent library |
22
- | `src/browser/` | Published browser-only library |
23
- | `src/server/` | Published Node-only library |
24
- | `src/styles/` | Optional styles surface: the base sheet face producing `index.css` |
25
- | `src/<name>/` | Styles extension: a named sheet face beside `src/styles/` |
26
- | `src/vue/` | Browser extension: the published `vue` face over `src/browser/` |
27
- | `src/bin/` | Optional executable; `main.ts` entry, never a public barrel |
28
- | `app/core/` | Shared application logic with an `index.ts` barrel |
29
- | `app/browser/` | Browser app; `main.ts` entry, not a barrel |
30
- | `app/vue/` | Browser extension: the Vue app beside `app/browser/`; `main.ts` |
31
- | `app/server/` | Node server app; `main.ts` entry |
32
- | `tests/` | Mirrors src/app environments; root holds cross-cutting proofs |
33
- | `configs/` | Thin target wrappers around root configs |
19
+ | Path | Purpose |
20
+ | --------------- | ------------------------------------------------------------------ |
21
+ | `src/core/` | Published host-independent library |
22
+ | `src/browser/` | Published browser-only library |
23
+ | `src/server/` | Published Node-only library |
24
+ | `src/styles/` | Optional styles surface: the base sheet face producing `index.css` |
25
+ | `src/<name>/` | Styles extension: a named sheet face beside `src/styles/` |
26
+ | `src/vue/` | Browser extension: the published `vue` face over `src/browser/` |
27
+ | `src/bin/` | Optional executable; `main.ts` entry, never a public barrel |
28
+ | `src/reporter/` | Optional Vitest reporter; `main.ts` entry, never a barrel |
29
+ | `app/core/` | Shared application logic with an `index.ts` barrel |
30
+ | `app/browser/` | Browser app; `main.ts` entry, not a barrel |
31
+ | `app/vue/` | Browser extension: the Vue app beside `app/browser/`; `main.ts` |
32
+ | `app/server/` | Node server app; `main.ts` entry |
33
+ | `tests/` | Mirrors src/app environments; root holds cross-cutting proofs |
34
+ | `configs/` | Thin target wrappers around root configs |
34
35
 
35
36
  - Dependency direction is the root project model in `AGENTS.md` and is not restated here; this file governs where the environments live and how they are configured.
36
37
  - Typical browser-app domains: `components/`, `pages/`, `composables/`, `controllers/`, `services/`, `stores/`.
37
38
  - Typical server-app domains: `handlers.ts`, `middlewares.ts`, `routes.ts`.
38
39
  - A sheet face (`src/styles/` and each `src/<name>/` styles extension) builds from `sheet.ts`, which imports `./index.scss` alone; its `index.ts` star-exports `./sheet.js`. The themes target builds from `src/styles/themes/sheet.ts` the same way.
39
- - Name a styles extension with a name the `NAME_PATTERN` constant admits, and never `core`, `browser`, `server`, `bin`, `styles`, `themes`, or `vue`.
40
+ - Name a styles extension with a name the `NAME_PATTERN` constant admits, and never `core`, `browser`, `server`, `bin`, `reporter`, `styles`, `themes`, or `vue`.
40
41
  - `src/bin/main.ts` is the executable entry, built to `dist/bin/main.js`. The name is fixed, as it
41
42
  is for `app/browser/main.ts` and `app/server/main.ts`, so every runtime entry in a workspace is
42
43
  found at the same name.
44
+ - `src/reporter/main.ts` is the Vitest reporter entry, one per package, built to
45
+ `dist/reporter/main.js` and published as the `./reporter` export. Its body is two statements:
46
+ an import of the reporter class from `@src/server`, then `export default` of that class. That
47
+ body is the one exception to `.claude/rules/architecture.md` § Barrel exports, and the vendored
48
+ `.oxlintrc.json` exempts that one path from `import/no-default-export`. Keep the class in
49
+ `src/server`, exported by name through the server barrel.
43
50
  - `package.json`'s `bin` key is the installed command name. The entry path is the value and does
44
51
  not carry that name.
45
52
  - Keep every ignored output at the workspace root or under `tmp/`, and write no `.gitignore`
@@ -65,9 +72,9 @@ Use only the environments a project needs, and keep the root dependency model in
65
72
 
66
73
  Give every selected environment and every face an alias: `src/styles`, each `src/<name>` styles extension, and each axis the `vue` extension occupies. Define aliases in `tsconfig.json` first. `vite.config.ts` derives from `compilerOptions.paths`; keep both aligned.
67
74
 
68
- Import a sibling environment through its alias. In `src/browser`, `src/server`, `src/vue`, and `src/bin`, a
69
- relative path to `src/core`, to `src/browser` from `src/vue`, or to `src/server` from `src/bin` bundles a
70
- private copy of that environment into the face, so the vendored `.oxlintrc.json` refuses it with a message naming the alias.
75
+ Import a sibling environment through its alias. In `src/browser`, `src/server`, `src/vue`, `src/bin`, and
76
+ `src/reporter`, a relative path to `src/core`, to `src/browser` from `src/vue`, or to `src/server` from
77
+ `src/bin` or `src/reporter` bundles a private copy of that environment into the face, so the vendored `.oxlintrc.json` refuses it with a message naming the alias.
71
78
 
72
79
  ## Configuration authority
73
80
 
@@ -76,7 +83,7 @@ private copy of that environment into the face, so the vendored `.oxlintrc.json`
76
83
  - `*/types.ts`: public API contracts.
77
84
  - `configs/agents/tsconfig.skills.json`: the scoped typecheck of the skill scripts; its presence selects the `skills` blueprint fact.
78
85
  - `configs/src/` and `configs/app/`: thin per-target wrappers, including optional
79
- `configs/src/*bin*` files. Shared logic remains in root configs.
86
+ `configs/src/*bin*` and `configs/src/*reporter*` files. Shared logic remains in root configs.
80
87
  - `configs/helpers.ts`, `configs/browsers.ts`, `configs/commands.ts`, and `configs/policy.ts`: the
81
88
  only permitted leaves under `configs/`. Each imports nothing from the workspace, which is what
82
89
  keeps it a leaf, so no `configs/types.ts` exists for one to import: each keeps its own types,
@@ -129,12 +136,16 @@ Environment rules:
129
136
  | `dist/src/styles/themes` | Compiled themes `index.css` | CSS |
130
137
  | `dist/src/<name>` | Compiled `index.css` | CSS |
131
138
  | `dist/bin` | Optional executable `main.js` | ES with shebang |
139
+ | `dist/reporter` | Vitest reporter + `main.d.ts` | ES |
132
140
  | `dist/app/browser` | Browser application | target-defined |
133
141
  | `dist/app/vue` | Vue application | target-defined |
134
142
  | `dist/app/server` | Server application | CJS runtime entry; ES barrel when `studies` is selected |
135
143
  | `showcase/<application>.html` | Single-file page per application | self-contained, committed |
136
144
 
137
145
  - Roll up each published TypeScript face's declarations in its Vite wrapper. A face that imports `@src/core` or `@src/browser` rewrites those specifiers to the published subpaths in its emitted declarations.
146
+ - Build the reporter entry ES only with `@src/*` external, rewritten through `output.paths` to
147
+ `../src/<environment>/index.js`, and roll up `dist/reporter/main.d.ts` with
148
+ `rewriteServerSpecifier` rewriting `@src/server` to `../src/server/index.js`.
138
149
  - A sheet face ships CSS, not declarations, and its JavaScript build stub stays out of `files`.
139
150
  - Build each sheet face with `cssMinify: false`, bounded to its own output directory.
140
151
  - Build `dist/src/styles/themes` after `dist/src/styles`; the themes build empties only its own directory.
@@ -148,19 +159,20 @@ Environment rules:
148
159
  `vite.config.ts` defines Vitest projects on an environment axis and a workspace-proof axis. The
149
160
  environment axis is one project per src/app axis × environment, plus one per extension face:
150
161
 
151
- | Project | Files | Environment | Setup |
152
- | ------------- | ---------------------- | ------------------------------------- | ------------------------------------------------------------ |
153
- | `src:core` | `tests/src/core/**` | Node | `setup.ts` |
154
- | `src:browser` | `tests/src/browser/**` | Playwright Chromium | `setup.ts`, `setupBrowser.ts` |
155
- | `src:vue` | `tests/src/vue/**` | Playwright Chromium | `setup.ts`, `setupBrowser.ts` |
156
- | `src:server` | `tests/src/server/**` | Node | `setup.ts`, `setupServer.ts` |
157
- | `src:styles` | `tests/src/styles/**` | Playwright Chromium, `isolate: false` | `setup.ts`, `setupBrowser.ts`, `setupStyles.ts` when present |
158
- | `src:<name>` | `tests/src/<name>/**` | Playwright Chromium, `isolate: false` | `setup.ts`, `setupBrowser.ts`, `setupStyles.ts` when present |
159
- | `src:bin` | `tests/src/bin/**` | Node | `setup.ts`, `setupServer.ts` |
160
- | `app:core` | `tests/app/core/**` | Node | `setup.ts` |
161
- | `app:browser` | `tests/app/browser/**` | Playwright Chromium | `setup.ts`, `setupBrowser.ts` |
162
- | `app:vue` | `tests/app/vue/**` | Playwright Chromium | `setup.ts`, `setupBrowser.ts` |
163
- | `app:server` | `tests/app/server/**` | Node | `setup.ts`, `setupServer.ts` |
162
+ | Project | Files | Environment | Setup |
163
+ | -------------- | ----------------------- | ------------------------------------- | ------------------------------------------------------------ |
164
+ | `src:core` | `tests/src/core/**` | Node | `setup.ts` |
165
+ | `src:browser` | `tests/src/browser/**` | Playwright Chromium | `setup.ts`, `setupBrowser.ts` |
166
+ | `src:vue` | `tests/src/vue/**` | Playwright Chromium | `setup.ts`, `setupBrowser.ts` |
167
+ | `src:server` | `tests/src/server/**` | Node | `setup.ts`, `setupServer.ts` |
168
+ | `src:styles` | `tests/src/styles/**` | Playwright Chromium, `isolate: false` | `setup.ts`, `setupBrowser.ts`, `setupStyles.ts` when present |
169
+ | `src:<name>` | `tests/src/<name>/**` | Playwright Chromium, `isolate: false` | `setup.ts`, `setupBrowser.ts`, `setupStyles.ts` when present |
170
+ | `src:bin` | `tests/src/bin/**` | Node | `setup.ts`, `setupServer.ts` |
171
+ | `src:reporter` | `tests/src/reporter/**` | Node | `setup.ts`, `setupServer.ts` |
172
+ | `app:core` | `tests/app/core/**` | Node | `setup.ts` |
173
+ | `app:browser` | `tests/app/browser/**` | Playwright Chromium | `setup.ts`, `setupBrowser.ts` |
174
+ | `app:vue` | `tests/app/vue/**` | Playwright Chromium | `setup.ts`, `setupBrowser.ts` |
175
+ | `app:server` | `tests/app/server/**` | Node | `setup.ts`, `setupServer.ts` |
164
176
 
165
177
  - Compose every sheet-face project (`src:styles` and each `src:<name>`) in its own wrapper through
166
178
  the one root `sheetProject` factory, and run it through its `test:src:<face>` script, which builds
@@ -273,8 +285,8 @@ then runs the configured scoped checks that prove environment isolation.
273
285
 
274
286
  - Use plain `tsc` for a TypeScript-only tree.
275
287
  - Use `vue-tsc` only for a scope containing `.vue` internals.
276
- - `check:src` mirrors configured `src:*` test projects; optional `src:bin` is its
277
- own scope.
288
+ - `check:src` mirrors configured `src:*` test projects; optional `src:bin` and `src:reporter`
289
+ are each their own scope.
278
290
  - `check:app` mirrors configured `app:*` projects.
279
291
  - `check:skills` typechecks `.agents/skills/*/scripts/*.ts` through `configs/agents/tsconfig.skills.json` wherever that wrapper is present: the root project's wildcard never enters a dot-prefixed directory, so the scripts need their own scope.
280
292
  - The `build:skills` script emits a `.js` twin of every `.agents/skills/*/scripts/*.ts` script into the `dist/agents/skills/` tree through the same wrapper, rewrites each relative import to `.js`, and copies `.agents/templates/brief.md` into the `dist/agents/templates/` directory; the `build` chain runs it after `build:host`, and `dist/agents` ships in the package.
@@ -19,14 +19,18 @@ import {
19
19
  rmSync,
20
20
  writeFileSync,
21
21
  } from 'node:fs'
22
- import { dirname, isAbsolute, join, relative, resolve as resolvePath, sep } from 'node:path'
22
+ import {
23
+ basename,
24
+ dirname,
25
+ isAbsolute,
26
+ join,
27
+ relative,
28
+ resolve as resolvePath,
29
+ sep,
30
+ } from 'node:path'
23
31
 
24
32
  export function hasASCIIURLControl(value: string): boolean {
25
- for (const character of value) {
26
- const code = character.codePointAt(0)
27
- if (code !== undefined && (code <= 0x1f || code === 0x7f)) return true
28
- }
29
- return false
33
+ return /[\p{Cc}--[\u0080-\u009f]]/v.test(value)
30
34
  }
31
35
 
32
36
  /**
@@ -372,7 +376,7 @@ export function findPackageDirectory(current: string): string | undefined {
372
376
  export function packageRootOf(packageName: string, resolvedPath: string): string | undefined {
373
377
  const physical = physicalPath(resolvedPath)
374
378
  const directory = findPackageDirectory(
375
- existsSync(physical) && lstatSync(physical).isDirectory() ? physical : dirname(physical),
379
+ lstatSync(physical, { throwIfNoEntry: false })?.isDirectory() ? physical : dirname(physical),
376
380
  )
377
381
  return directory !== undefined && packageManifestName(directory) === packageName
378
382
  ? realpathSync.native(directory)
@@ -382,7 +386,7 @@ export function packageRootOf(packageName: string, resolvedPath: string): string
382
386
  export function packageRootForResolved(resolvedPath: string): string | undefined {
383
387
  const physical = physicalPath(resolvedPath)
384
388
  const directory = findPackageDirectory(
385
- existsSync(physical) && lstatSync(physical).isDirectory() ? physical : dirname(physical),
389
+ lstatSync(physical, { throwIfNoEntry: false })?.isDirectory() ? physical : dirname(physical),
386
390
  )
387
391
  return directory !== undefined && packageManifestName(directory) !== undefined
388
392
  ? realpathSync.native(directory)
@@ -873,6 +877,26 @@ export function rewriteBrowserSpecifier(content: string): string {
873
877
  .replaceAll('@src/browser', `${name}/browser`)
874
878
  }
875
879
 
880
+ /**
881
+ * Rewrites every server alias in a roll-up to the built server entry beside the reporter output.
882
+ *
883
+ * @param content - The finished roll-up.
884
+ * @returns That roll-up with each `@src/server` specifier replaced by `../src/server/index.js`.
885
+ *
886
+ * @remarks
887
+ * The reporter entry reaches the server class through the `@src/server` alias, and the extractor
888
+ * keeps it external and writes it through unchanged. `dist/reporter/main.d.ts` resolves the server
889
+ * declarations at the same relative path its `main.js` imports through `output.paths`.
890
+ *
891
+ * @example
892
+ * ```ts
893
+ * rewriteServerSpecifier("from '@src/server'") // "from '../src/server/index.js'"
894
+ * ```
895
+ */
896
+ export function rewriteServerSpecifier(content: string): string {
897
+ return content.replaceAll('@src/server', '../src/server/index.js')
898
+ }
899
+
876
900
  /**
877
901
  * Rolls one published face's declarations into the single file that face ships.
878
902
  *
@@ -883,12 +907,13 @@ export function rewriteBrowserSpecifier(content: string): string {
883
907
  * At `closeBundle`, after Vite has written every format of the face, the plugin emits the face's
884
908
  * declarations with the workspace compiler run as a process into a scratch directory made fresh
885
909
  * under the host temporary directory, hands the emitted entry to the extractor's own engine,
886
- * applies `rewrite`, and removes the scratch directory. Keeping the scratch outside the face's own
887
- * output means its unconditional removal can never take a sibling the face already published, such
888
- * as its own `declarations` folder. The extractor is a publishing workspace's development
889
- * dependency, so this vendored leaf defers loading it to that hook: a workspace that publishes no
890
- * library installs no extractor, never reaches the hook, and never resolves the package at build
891
- * or at check.
910
+ * applies `rewrite`, and removes the scratch directory. The roll-up takes the entry's own name, so
911
+ * an `index.ts` face ships `index.d.ts` and a `main.ts` entry ships `main.d.ts`. Keeping the
912
+ * scratch outside the face's own output means its unconditional removal can never take a sibling
913
+ * the face already published, such as its own `declarations` folder. The extractor is a publishing
914
+ * workspace's development dependency, so this vendored leaf defers loading it to that hook: a
915
+ * workspace that publishes no library installs no extractor, never reaches the hook, and never
916
+ * resolves the package at build or at check.
892
917
  */
893
918
  export function declarationRollup(options: DeclarationRollupOptions): Plugin {
894
919
  const state = new BuildState()
@@ -917,7 +942,7 @@ export function declarationRollup(options: DeclarationRollupOptions): Plugin {
917
942
  )
918
943
  }
919
944
  const scratch = mkdtempSync(join(tmpdir(), 'orkestrel-declarations-'))
920
- const rollup = resolvePath(state.output, 'index.d.ts')
945
+ const rollup = resolvePath(state.output, basename(declaration))
921
946
  try {
922
947
  readCompilerOutput(compiler, [
923
948
  '-p',