@orkestrel/scaffold 0.0.108 → 0.0.110

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 (162) hide show
  1. package/dist/agents/skills/orkestrel-dispatch/scripts/bench.js +326 -91
  2. package/dist/agents/skills/orkestrel-dispatch/scripts/brief.js +110 -14
  3. package/dist/agents/skills/orkestrel-dispatch/scripts/chain.js +280 -0
  4. package/dist/agents/skills/orkestrel-dispatch/scripts/cite.js +188 -26
  5. package/dist/agents/skills/orkestrel-dispatch/scripts/launch.js +142 -43
  6. package/dist/agents/skills/orkestrel-dispatch/scripts/login.js +240 -62
  7. package/dist/agents/skills/orkestrel-dispatch/scripts/patch.js +323 -0
  8. package/dist/agents/skills/orkestrel-dispatch/scripts/result.js +169 -32
  9. package/dist/agents/skills/orkestrel-dispatch/scripts/sweep.js +290 -69
  10. package/dist/agents/skills/orkestrel-falsify/scripts/mutate.js +560 -0
  11. package/dist/agents/skills/orkestrel-harden/scripts/discovery.js +1052 -205
  12. package/dist/agents/skills/orkestrel-harden/scripts/measure.js +361 -0
  13. package/dist/agents/skills/orkestrel-harden/scripts/titles.js +455 -80
  14. package/dist/agents/skills/orkestrel-parallel/scripts/cases.js +327 -0
  15. package/dist/agents/skills/orkestrel-publish/scripts/compare.js +298 -51
  16. package/dist/agents/skills/orkestrel-publish/scripts/pins.js +170 -13
  17. package/dist/agents/skills/orkestrel-publish/scripts/swap.js +956 -191
  18. package/dist/agents/skills/orkestrel-publish/scripts/wave.js +707 -112
  19. package/dist/agents/skills/orkestrel-publish/scripts/window.js +235 -41
  20. package/dist/agents/skills/orkestrel-scout/scripts/map.js +341 -54
  21. package/dist/agents/templates/brief.md +6 -2
  22. package/dist/bin/main.js +51 -46
  23. package/dist/bin/main.js.map +1 -1
  24. package/dist/host/AGENTS.md +23 -21
  25. package/dist/host/agents/orchestration.md +85 -54
  26. package/dist/host/agents/platforms/windows.md +8 -3
  27. package/dist/host/agents/skills/orkestrel-align/SKILL.md +10 -13
  28. package/dist/host/agents/skills/orkestrel-align/references/fleet.md +4 -10
  29. package/dist/host/agents/skills/orkestrel-align/references/integration.md +1 -1
  30. package/dist/host/agents/skills/orkestrel-build/SKILL.md +16 -48
  31. package/dist/host/agents/skills/orkestrel-build/agents/openai.yaml +1 -1
  32. package/dist/host/agents/skills/orkestrel-debrief/SKILL.md +19 -16
  33. package/dist/host/agents/skills/orkestrel-debrief/agents/openai.yaml +1 -1
  34. package/dist/host/agents/skills/orkestrel-debrief/references/field-testing.md +15 -28
  35. package/dist/host/agents/skills/orkestrel-debrief/references/instruction-audit.md +5 -6
  36. package/dist/host/agents/skills/orkestrel-debrief/references/retention.md +4 -6
  37. package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +36 -25
  38. package/dist/host/agents/skills/orkestrel-dispatch/references/launch.md +4 -5
  39. package/dist/host/agents/skills/orkestrel-dispatch/scripts/bench.ts +366 -75
  40. package/dist/host/agents/skills/orkestrel-dispatch/scripts/brief.ts +126 -16
  41. package/dist/host/agents/skills/orkestrel-dispatch/scripts/chain.ts +323 -0
  42. package/dist/host/agents/skills/orkestrel-dispatch/scripts/cite.ts +220 -31
  43. package/dist/host/agents/skills/orkestrel-dispatch/scripts/launch.ts +176 -33
  44. package/dist/host/agents/skills/orkestrel-dispatch/scripts/login.ts +294 -59
  45. package/dist/host/agents/skills/orkestrel-dispatch/scripts/patch.ts +401 -0
  46. package/dist/host/agents/skills/orkestrel-dispatch/scripts/result.ts +199 -34
  47. package/dist/host/agents/skills/orkestrel-dispatch/scripts/sweep.ts +330 -69
  48. package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +14 -12
  49. package/dist/host/agents/skills/orkestrel-falsify/references/brief.md +2 -5
  50. package/dist/host/agents/skills/orkestrel-falsify/references/reconcile.md +2 -1
  51. package/dist/host/agents/skills/orkestrel-falsify/scripts/mutate.ts +701 -0
  52. package/dist/host/agents/skills/orkestrel-harden/SKILL.md +31 -24
  53. package/dist/host/agents/skills/orkestrel-harden/references/bindings.md +23 -81
  54. package/dist/host/agents/skills/orkestrel-harden/references/centralization.md +4 -5
  55. package/dist/host/agents/skills/orkestrel-harden/references/contract.md +2 -0
  56. package/dist/host/agents/skills/orkestrel-harden/references/document.md +33 -0
  57. package/dist/host/agents/skills/orkestrel-harden/references/equivalence.md +6 -3
  58. package/dist/host/agents/skills/orkestrel-harden/references/hardening.md +34 -18
  59. package/dist/host/agents/skills/orkestrel-harden/references/research.md +2 -0
  60. package/dist/host/agents/skills/orkestrel-harden/scripts/discovery.ts +1272 -279
  61. package/dist/host/agents/skills/orkestrel-harden/scripts/measure.ts +425 -0
  62. package/dist/host/agents/skills/orkestrel-harden/scripts/titles.ts +603 -98
  63. package/dist/host/agents/skills/orkestrel-journey/SKILL.md +79 -98
  64. package/dist/host/agents/skills/orkestrel-journey/references/captures.md +54 -17
  65. package/dist/host/agents/skills/orkestrel-journey/references/decide.md +1 -20
  66. package/dist/host/agents/skills/orkestrel-journey/references/layer.md +21 -31
  67. package/dist/host/agents/skills/orkestrel-journey/references/styles.md +1 -1
  68. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +33 -29
  69. package/dist/host/agents/skills/orkestrel-parallel/references/claude.md +15 -13
  70. package/dist/host/agents/skills/orkestrel-parallel/references/cloud.md +28 -0
  71. package/dist/host/agents/skills/orkestrel-parallel/references/codex.md +1 -0
  72. package/dist/host/agents/skills/orkestrel-parallel/references/cursor.md +13 -13
  73. package/dist/host/agents/skills/orkestrel-parallel/references/t3.md +13 -13
  74. package/dist/host/agents/skills/orkestrel-parallel/scripts/cases.ts +389 -0
  75. package/dist/host/agents/skills/orkestrel-polish/SKILL.md +16 -20
  76. package/dist/host/agents/skills/orkestrel-polish/references/capture-harness.md +16 -26
  77. package/dist/host/agents/skills/orkestrel-publish/SKILL.md +12 -26
  78. package/dist/host/agents/skills/orkestrel-publish/agents/openai.yaml +2 -2
  79. package/dist/host/agents/skills/orkestrel-publish/references/adopt.md +23 -0
  80. package/dist/host/agents/skills/orkestrel-publish/references/release.md +4 -4
  81. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +13 -10
  82. package/dist/host/agents/skills/orkestrel-publish/references/window.md +21 -26
  83. package/dist/host/agents/skills/orkestrel-publish/scripts/compare.ts +348 -59
  84. package/dist/host/agents/skills/orkestrel-publish/scripts/pins.ts +202 -22
  85. package/dist/host/agents/skills/orkestrel-publish/scripts/swap.ts +1061 -191
  86. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +812 -140
  87. package/dist/host/agents/skills/orkestrel-publish/scripts/window.ts +280 -38
  88. package/dist/host/agents/skills/orkestrel-scout/SKILL.md +3 -3
  89. package/dist/host/agents/skills/orkestrel-scout/scripts/map.ts +428 -70
  90. package/dist/host/agents/templates/brief.md +6 -2
  91. package/dist/host/agents/transports/claude-cli.md +3 -3
  92. package/dist/host/agents/transports/codex.md +3 -8
  93. package/dist/host/agents/transports/cursor.md +2 -3
  94. package/dist/host/claude/AGENTS.md +2 -3
  95. package/dist/host/claude/agents/analyst.md +3 -3
  96. package/dist/host/claude/agents/astra.md +4 -4
  97. package/dist/host/claude/agents/builder.md +4 -3
  98. package/dist/host/claude/agents/checker.md +1 -1
  99. package/dist/host/claude/agents/distiller.md +1 -1
  100. package/dist/host/claude/agents/grok.md +1 -1
  101. package/dist/host/claude/agents/opus.md +3 -3
  102. package/dist/host/claude/agents/orkestrel.md +57 -90
  103. package/dist/host/claude/agents/researcher.md +1 -1
  104. package/dist/host/claude/agents/reviewer.md +6 -2
  105. package/dist/host/claude/agents/scout.md +1 -1
  106. package/dist/host/claude/agents/verifier.md +2 -2
  107. package/dist/host/claude/rules/application.md +14 -21
  108. package/dist/host/claude/rules/architecture.md +34 -44
  109. package/dist/host/claude/rules/browser.md +3 -4
  110. package/dist/host/claude/rules/campaign.md +3 -2
  111. package/dist/host/claude/rules/documentation.md +25 -12
  112. package/dist/host/claude/rules/names.md +9 -4
  113. package/dist/host/claude/rules/patterns.md +6 -7
  114. package/dist/host/claude/rules/portability.md +1 -1
  115. package/dist/host/claude/rules/quality.md +7 -6
  116. package/dist/host/claude/rules/styles.md +2 -2
  117. package/dist/host/claude/rules/tests.md +68 -115
  118. package/dist/host/claude/rules/typescript.md +7 -9
  119. package/dist/host/claude/rules/workspace.md +27 -26
  120. package/dist/host/claude/rules/writing.md +2 -5
  121. package/dist/host/claude/skills/orkestrel-dispatch/SKILL.md +1 -1
  122. package/dist/host/claude/skills/orkestrel-harden/SKILL.md +1 -1
  123. package/dist/host/claude/skills/orkestrel-publish/SKILL.md +1 -1
  124. package/dist/host/claude/skills/orkestrel-scout/SKILL.md +1 -1
  125. package/dist/host/codex/agents/analyst.toml +9 -3
  126. package/dist/host/codex/agents/astra.toml +10 -7
  127. package/dist/host/codex/agents/builder.toml +4 -4
  128. package/dist/host/codex/agents/opus.toml +6 -6
  129. package/dist/host/codex/agents/orkestrel.toml +1 -1
  130. package/dist/host/codex/agents/researcher.toml +2 -2
  131. package/dist/host/codex/agents/reviewer.toml +2 -2
  132. package/dist/host/codex/agents/verifier.toml +4 -4
  133. package/dist/host/codex/config.toml +1 -1
  134. package/dist/host/configs/helpers.ts +21 -1
  135. package/dist/host/configs/policy.ts +299 -15
  136. package/dist/host/cursor/rules/orchestration.mdc +1 -1
  137. package/dist/host/dotfiles/oxlintrc.json +137 -3
  138. package/dist/host/guides/agent.md +111 -134
  139. package/dist/host/guides/capture.md +801 -0
  140. package/dist/host/guides/probe.md +27 -8
  141. package/dist/host/guides/scaffold.md +97 -19
  142. package/dist/host/guides/study.md +534 -440
  143. package/dist/host/guides/test.md +111 -44
  144. package/dist/host/manifest.json +170 -244
  145. package/dist/host/tests/config.test.ts +977 -187
  146. package/dist/host/tests/policy.test.ts +165 -1
  147. package/dist/host/tests/setupPolicy.ts +1246 -33
  148. package/dist/src/core/index.cjs +222 -90
  149. package/dist/src/core/index.cjs.map +1 -1
  150. package/dist/src/core/index.d.cts +126 -40
  151. package/dist/src/core/index.d.ts +126 -40
  152. package/dist/src/core/index.js +217 -89
  153. package/dist/src/core/index.js.map +1 -1
  154. package/dist/src/server/index.cjs +20 -27
  155. package/dist/src/server/index.cjs.map +1 -1
  156. package/dist/src/server/index.js +21 -28
  157. package/dist/src/server/index.js.map +1 -1
  158. package/package.json +11 -11
  159. package/dist/agents/skills/orkestrel-dispatch/scripts/helpers.js +0 -283
  160. package/dist/host/agents/skills/orkestrel-dispatch/references/bench.md +0 -25
  161. package/dist/host/agents/skills/orkestrel-dispatch/scripts/helpers.ts +0 -333
  162. package/dist/host/guides/supervisor.md +0 -4890
@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
4
4
  let _orkestrel_emitter = require("@orkestrel/emitter");
5
5
  var package_default = {
6
6
  name: "@orkestrel/scaffold",
7
- version: "0.0.108",
7
+ version: "0.0.110",
8
8
  description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
9
9
  keywords: [
10
10
  "audit",
@@ -81,7 +81,7 @@ var package_default = {
81
81
  "test:templates": "vitest run --config vite.config.ts --no-cache --reporter=dot --project templates",
82
82
  "test:distribution": "vitest run --config vite.config.ts --no-cache --reporter=dot --project distribution",
83
83
  "test:probe": "vitest run --config vite.config.ts --no-cache --reporter=verbose --project probe",
84
- "test:bench": "vitest bench --config vite.config.ts --no-cache --project probe",
84
+ "test:bench": "vitest bench --config vite.config.ts --no-cache --project \"probe (bench)\" --mode benchmark",
85
85
  "test:setup": "vitest run --config vite.config.ts --no-cache --reporter=dot --project setup",
86
86
  "build": "npm run clean && npm run build:src && npm run build:host && npm run build:skills && npm run build:inventory",
87
87
  "build:src": "npm run build:src:core && npm run build:src:server && npm run build:src:bin",
@@ -103,25 +103,24 @@ var package_default = {
103
103
  "@orkestrel/template": "^0.0.10"
104
104
  },
105
105
  devDependencies: {
106
- "@microsoft/api-extractor": "^7.59.4",
106
+ "@microsoft/api-extractor": "^7.60.0",
107
107
  "@orkestrel/browser": "^0.0.29",
108
108
  "@orkestrel/guide": "^0.0.25",
109
109
  "@orkestrel/html": "^0.0.12",
110
- "@orkestrel/probe": "^0.0.24",
111
- "@orkestrel/test": "^0.0.29",
110
+ "@orkestrel/probe": "^0.0.25",
111
+ "@orkestrel/test": "^0.0.30",
112
112
  "@types/node": "^24.19.2",
113
- "@vitest/browser-playwright": "^4.1.11",
114
- "oxfmt": "^0.74.0",
115
- "oxlint": "^1.89.0",
116
- "playwright": "^1.63.0",
117
- "typescript": "^6.0.3",
113
+ "@vitest/browser-playwright": "^5.0.5",
114
+ "oxfmt": "^0.75.0",
115
+ "oxlint": "^1.90.0",
116
+ "playwright": "^1.64.1",
117
+ "typescript": "^7.0.2",
118
118
  "vite": "^8.3.5",
119
- "vitest": "^4.1.12"
119
+ "vitest": "^5.0.5"
120
120
  },
121
121
  engines: { "node": ">=22.18.0" }
122
122
  };
123
- //#endregion
124
- //#region src/core/constants.ts
123
+ // src/core/constants.ts
125
124
  /**
126
125
  * Lists the `Environment` values, frozen.
127
126
  *
@@ -440,19 +439,19 @@ var CATALOG_AGENT_PATH = ".claude/agents/orkestrel.md";
440
439
  *
441
440
  * @remarks
442
441
  * The catalog verb rewrites the region between this marker and
443
- * {@link CATALOG_CLOSING_MARKER} and leaves every other byte of the file alone,
442
+ * {@link CATALOG_END_MARKER} and leaves every other byte of the file alone,
444
443
  * so the writer and every proof that reads the rendered file read the pair from
445
444
  * here rather than repeating a literal that only agrees by inspection.
446
445
  */
447
- var CATALOG_OPENING_MARKER = "<!-- orkestrel:catalog -->";
446
+ var CATALOG_START_MARKER = "<!-- orkestrel:catalog -->";
448
447
  /**
449
448
  * Names the marker closing the package table inside {@link CATALOG_AGENT_PATH}.
450
449
  *
451
450
  * @remarks
452
- * It pairs with {@link CATALOG_OPENING_MARKER}; a file missing either marker is
451
+ * It pairs with {@link CATALOG_START_MARKER}; a file missing either marker is
453
452
  * refused rather than rewritten.
454
453
  */
455
- var CATALOG_CLOSING_MARKER = "<!-- /orkestrel:catalog -->";
454
+ var CATALOG_END_MARKER = "<!-- /orkestrel:catalog -->";
456
455
  /**
457
456
  * Lists the package-facing skills a target receives pointers for, frozen and alphabetical.
458
457
  *
@@ -658,7 +657,7 @@ var WORKSPACE_DEV_ENGINES = Object.freeze({ packageManager: Object.freeze({
658
657
  version: `>=${MINIMUM_NPM_VERSION}`,
659
658
  onFail: "error"
660
659
  }) });
661
- /** Holds the tooling versions scaffold and every generated workspace share. */
660
+ /** Holds the baseline tooling versions, before framework holds apply. */
662
661
  var BASE_DEV_DEPENDENCIES = Object.freeze({
663
662
  "@orkestrel/guide": package_default.devDependencies["@orkestrel/guide"],
664
663
  "@orkestrel/probe": package_default.devDependencies["@orkestrel/probe"],
@@ -672,6 +671,19 @@ var BASE_DEV_DEPENDENCIES = Object.freeze({
672
671
  vitest: package_default.devDependencies.vitest
673
672
  });
674
673
  /**
674
+ * Holds foreign tool ranges required by selected browser frameworks, frozen.
675
+ *
676
+ * @remarks
677
+ * A selected framework overrides the baseline floor with its held range. `audit` names the hold
678
+ * where it would report a newer served major and reports a declaration past that hold. The
679
+ * constants proof ties the held range to the baseline manifest and the framework's planned range.
680
+ */
681
+ var TOOLCHAIN_HOLDS = Object.freeze({ typescript: Object.freeze({
682
+ framework: "vue",
683
+ range: "^6.0.3",
684
+ reason: "Vue workspaces require TypeScript 6.0.3 because no stable vue-tsc runs on TypeScript 7: vue-tsc resolves typescript/lib/tsc, which TypeScript 7.0.2 does not export, and the TypeScript 7.0 announcement directs Vue projects to stay on TypeScript 6.0"
685
+ }) });
686
+ /**
675
687
  * Lists the development dependencies that roll declarations up for published source.
676
688
  *
677
689
  * @remarks
@@ -695,6 +707,45 @@ var SOURCE_BROWSER_DEV_DEPENDENCIES = Object.freeze({
695
707
  */
696
708
  var BROWSE_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/browser": package_default.devDependencies["@orkestrel/browser"] });
697
709
  /**
710
+ * Names the development dependency a browser application's journey axis adds.
711
+ *
712
+ * @remarks
713
+ * Scaffold does not install this package, so its range is a seed. The planner withholds it
714
+ * from the workspaces {@link CAPTURE_UPSTREAM} lists.
715
+ *
716
+ * @example
717
+ * ```ts
718
+ * import { CAPTURE_DEV_DEPENDENCIES } from '@orkestrel/scaffold'
719
+ *
720
+ * CAPTURE_DEV_DEPENDENCIES['@orkestrel/capture'] // '^0.0.1'
721
+ * ```
722
+ */
723
+ var CAPTURE_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/capture": "^0.0.1" });
724
+ /**
725
+ * Lists the capture package and its fleet runtime dependency closure, frozen.
726
+ *
727
+ * @remarks
728
+ * The sorted list includes `@orkestrel/capture` and its transitive `@orkestrel/*` dependencies
729
+ * and peers, read from capture's installed manifests, and moves with the capture pin.
730
+ * A listed workspace cannot receive the capture development dependency without closing a cycle.
731
+ * Scaffold does not install capture, so the proof checks planning against this list; the
732
+ * installed closure-equality proof lands when scaffold installs capture.
733
+ *
734
+ * @example
735
+ * ```ts
736
+ * import { CAPTURE_UPSTREAM } from '@orkestrel/scaffold'
737
+ *
738
+ * CAPTURE_UPSTREAM.includes('@orkestrel/process') // true
739
+ * ```
740
+ */
741
+ var CAPTURE_UPSTREAM = Object.freeze([
742
+ "@orkestrel/capture",
743
+ "@orkestrel/contract",
744
+ "@orkestrel/emitter",
745
+ "@orkestrel/process",
746
+ "@orkestrel/timeout"
747
+ ]);
748
+ /**
698
749
  * Lists the packages `@orkestrel/browser` depends on at runtime, directly or transitively, frozen.
699
750
  *
700
751
  * @remarks
@@ -750,8 +801,7 @@ var APP_SERVER_DEV_DEPENDENCIES = Object.freeze({
750
801
  "@orkestrel/router": "^0.0.10",
751
802
  "@orkestrel/server": "^0.0.14"
752
803
  });
753
- //#endregion
754
- //#region src/core/templates.ts
804
+ // src/core/templates.ts
755
805
  /**
756
806
  * Holds formatter-stable template text for every configuration artifact.
757
807
  *
@@ -1249,6 +1299,7 @@ export function appJourney(
1249
1299
  variant: JourneyVariant,
1250
1300
  variants: readonly JourneyVariant[],
1251
1301
  mode?: string,
1302
+ override?: UserConfig,
1252
1303
  ): UserConfig {
1253
1304
  const application = resolveApplication(mode, applications)
1254
1305
  const browser = applications[application]()
@@ -1263,6 +1314,8 @@ export function appJourney(
1263
1314
  browser: {
1264
1315
  ...browser.test?.browser,
1265
1316
  enabled: true,
1317
+ // The runner UI CSS-scales the tester iframe, which scales observer root bounds and margins.
1318
+ ui: false,
1266
1319
  viewport: { width: variant.width, height: variant.height },
1267
1320
  instances: (browser.test?.browser?.instances ?? []).map(
1268
1321
  ({ name: _name, ...instance }) => instance,
@@ -1270,7 +1323,7 @@ export function appJourney(
1270
1323
  },
1271
1324
  },
1272
1325
  }
1273
- return mergeOverride(project)
1326
+ return mergeOverride(project, override)
1274
1327
  }
1275
1328
  `,
1276
1329
  showcase: `
@@ -1557,8 +1610,9 @@ export function service(override?: UserConfig): UserConfig {
1557
1610
  return mergeOverride(project, override)
1558
1611
  }
1559
1612
  `,
1560
- studies: `// Authored study proofs run installed packages through bounded subprocesses and protocol fixtures,
1561
- // so this project is isolated in its own gate script, test:studies.
1613
+ studies: `// The @orkestrel/study engine drives these proofs, running installed packages through bounded
1614
+ // subprocesses and protocol fixtures, so this project is isolated in its own gate script,
1615
+ // test:studies.
1562
1616
  export function studies(override?: UserConfig): UserConfig {
1563
1617
  const project: UserConfig = {
1564
1618
  resolve,
@@ -1596,9 +1650,9 @@ export function studies(override?: UserConfig): UserConfig {
1596
1650
  `,
1597
1651
  probe: `// A workbench, not a proof. No gate selects this project. Run in test mode by the
1598
1652
  // \`test:probe\` script, it collects \`tmp/probes/**/*.test.ts\`. Run in benchmark mode by the
1599
- // \`test:bench\` script, the same workbench also collects \`tests/**/*.test.ts\` for a \`bench\` block,
1600
- // so a suite may carry a bench beside its ordinary tests without a second project. The mode
1601
- // guard around each \`bench\` call keeps it out of test mode, so it never executes there.
1653
+ // \`test:bench\` script, it collects \`*.bench.ts\` files under \`tmp/probes\` and \`tests\`.
1654
+ // Each benchmark is a regular test that uses its context's \`bench\` fixture and awaits
1655
+ // \`bench(name, options, fn).run()\` or \`bench.compare(...)\`.
1602
1656
  export function probe(override?: UserConfig): UserConfig {
1603
1657
  const project: UserConfig = {
1604
1658
  resolve,
@@ -1611,7 +1665,7 @@ export function probe(override?: UserConfig): UserConfig {
1611
1665
  fileParallelism: false,
1612
1666
  sequence: { groupOrder: 1 },
1613
1667
  pool: 'threads',
1614
- benchmark: { include: ['tmp/probes/**/*.test.ts', 'tests/**/*.test.ts'] },
1668
+ benchmark: { include: ['tmp/probes/**/*.bench.ts', 'tests/**/*.bench.ts'] },
1615
1669
  },
1616
1670
  }
1617
1671
  return mergeOverride(project, override)
@@ -2626,11 +2680,14 @@ export const DISTRIBUTION_NPM = process.platform === 'win32' ? 'npm.cmd' : 'npm'
2626
2680
  // process: the command and its plain-text diagnostics are the same across the
2627
2681
  // compiler majors this toolchain supports, and its in-process API is not. It is
2628
2682
  // resolved from the workspace under proof, so a consumer of the packed artifact is
2629
- // checked by the same compiler that workspace's own \`check\` script runs.
2683
+ // checked by the same compiler that workspace's own \`check\` script runs. TypeScript 7 exports
2684
+ // \`package.json\` but not \`bin/tsc\`, so the path is joined from the manifest's directory.
2685
+ /** Names the TypeScript manifest installed by the workspace under proof. */
2686
+ export const DISTRIBUTION_TYPESCRIPT = createRequire(
2687
+ join(DISTRIBUTION_ROOT, 'package.json'),
2688
+ ).resolve('typescript/package.json')
2630
2689
  /** Names the compiler installed by the workspace under proof. */
2631
- export const DISTRIBUTION_COMPILER = createRequire(join(DISTRIBUTION_ROOT, 'package.json')).resolve(
2632
- 'typescript/bin/tsc',
2633
- )
2690
+ export const DISTRIBUTION_COMPILER = join(dirname(DISTRIBUTION_TYPESCRIPT), 'bin', 'tsc')
2634
2691
  // Windows needs a shell to launch a \`.cmd\`: Node refuses one directly since the
2635
2692
  // batch-argument hardening, and \`spawnSync\` returns \`EINVAL\` with a null status
2636
2693
  // rather than an exit code a caller can read. Every following argument is a literal or
@@ -2898,6 +2955,50 @@ export function readDistributionManifestName(path: string): string {
2898
2955
  return manifest.name
2899
2956
  }
2900
2957
 
2958
+ // A host carries a package's required peers at its own root. A consumer that carries none leaves
2959
+ // npm to place them, and npm can then resolve an optional peer of a peer to a release the
2960
+ // package's own range refuses, so the consumer declares them as a host would.
2961
+ /**
2962
+ * Reads the peers a host must carry: every peer dependency its metadata does not mark optional.
2963
+ *
2964
+ * @param path - The manifest to read.
2965
+ * @returns Each required peer's name mapped to its declared range.
2966
+ */
2967
+ export function readDistributionPeers(path: string): Readonly<Record<string, string>> {
2968
+ const manifest = readDistributionJSON(path)
2969
+ if (!isDistributionRecord(manifest) || !isDistributionRecord(manifest.peerDependencies)) {
2970
+ return {}
2971
+ }
2972
+ const meta = isDistributionRecord(manifest.peerDependenciesMeta)
2973
+ ? manifest.peerDependenciesMeta
2974
+ : undefined
2975
+ const peers = Object.entries(manifest.peerDependencies).filter(
2976
+ (entry): entry is [string, string] => typeof entry[1] === 'string',
2977
+ )
2978
+ return Object.fromEntries(
2979
+ peers.filter(([name]) => {
2980
+ const entry = meta?.[name]
2981
+ return !isDistributionRecord(entry) || entry.optional !== true
2982
+ }),
2983
+ )
2984
+ }
2985
+
2986
+ /**
2987
+ * Writes the consumer manifest, declaring the required peers as dependencies.
2988
+ *
2989
+ * @param peers - Each required peer's name mapped to its declared range.
2990
+ * @returns The manifest text; the bare manifest when the package declares no required peer.
2991
+ */
2992
+ export function createDistributionConsumerManifest(
2993
+ peers: Readonly<Record<string, string>>,
2994
+ ): string {
2995
+ const manifest: unknown = JSON.parse(DISTRIBUTION_CONSUMER_MANIFEST)
2996
+ if (Object.keys(peers).length === 0 || !isDistributionRecord(manifest)) {
2997
+ return DISTRIBUTION_CONSUMER_MANIFEST
2998
+ }
2999
+ return \`\${JSON.stringify({ ...manifest, dependencies: peers })}\\n\`
3000
+ }
3001
+
2901
3002
  /**
2902
3003
  * Writes a consumer file after creating its parent directory.
2903
3004
  *
@@ -3532,7 +3633,8 @@ export function buildDistributionStage(scratch: string): DistributionStage {
3532
3633
  if (archives.length !== 1 || archive === undefined) {
3533
3634
  throw new Error(\`npm pack wrote no single archive: \${archives.join(', ')}\`)
3534
3635
  }
3535
- writeDistributionFile(join(consumer, 'package.json'), DISTRIBUTION_CONSUMER_MANIFEST)
3636
+ const peers = readDistributionPeers(join(DISTRIBUTION_ROOT, 'package.json'))
3637
+ writeDistributionFile(join(consumer, 'package.json'), createDistributionConsumerManifest(peers))
3536
3638
  writeDistributionFile(join(consumer, DISTRIBUTION_ESM_DRIVER), DISTRIBUTION_ESM_DRIVER_SOURCE)
3537
3639
  writeDistributionFile(join(consumer, DISTRIBUTION_CJS_DRIVER), DISTRIBUTION_CJS_DRIVER_SOURCE)
3538
3640
  const install = runDistributionNpm(
@@ -4604,8 +4706,8 @@ skill itself ships with that package. Read the canonical \`SKILL.md\` completely
4604
4706
 
4605
4707
  Resolve every path the canonical skill names against the same root; under \`node_modules\` each
4606
4708
  segment drops its opening dot. Run a script the skill names through its built twin, as this
4607
- repository's \`AGENTS.md\` states. This pointer carries no process of its own; \`AGENTS.md\`, the applicable
4608
- rules, and the canonical skill remain authoritative in that order.
4709
+ repository's \`AGENTS.md\` states. This pointer carries no process of its own; the authority order is
4710
+ \`.agents/orchestration.md\` § Authority.
4609
4711
  `,
4610
4712
  service: `#!/usr/bin/env sh
4611
4713
  set -eu
@@ -4615,8 +4717,7 @@ printf '%s\\n' \\
4615
4717
  `
4616
4718
  })
4617
4719
  });
4618
- //#endregion
4619
- //#region src/core/errors.ts
4720
+ // src/core/errors.ts
4620
4721
  /**
4621
4722
  * Represents the one error this package throws, carrying the coded reason it was raised.
4622
4723
  *
@@ -4685,8 +4786,7 @@ var ScaffoldError = class extends Error {
4685
4786
  function isScaffoldError(value) {
4686
4787
  return (0, _orkestrel_contract.isInstance)(value, ScaffoldError);
4687
4788
  }
4688
- //#endregion
4689
- //#region src/core/validators.ts
4789
+ // src/core/validators.ts
4690
4790
  /**
4691
4791
  * Narrows a value to a logical target-relative path.
4692
4792
  *
@@ -5245,8 +5345,7 @@ var isCompilerOptions = (0, _orkestrel_contract.recordOf)({
5245
5345
  on: isCompilerHooks,
5246
5346
  error: _orkestrel_contract.isFunction
5247
5347
  }, true);
5248
- //#endregion
5249
- //#region src/core/cloners.ts
5348
+ // src/core/cloners.ts
5250
5349
  /**
5251
5350
  * Snapshots an untrusted value into exact JSON data the caller owns.
5252
5351
  *
@@ -5293,8 +5392,7 @@ function cloneValue(value) {
5293
5392
  const outcome = (0, _orkestrel_contract.attempt)(() => (0, _orkestrel_contract.cloneJSONValue)(value));
5294
5393
  return outcome.success ? outcome.value : void 0;
5295
5394
  }
5296
- //#endregion
5297
- //#region src/core/parsers.ts
5395
+ // src/core/parsers.ts
5298
5396
  /**
5299
5397
  * Coerces an extension value or a `surface:name` selection into an extension.
5300
5398
  * @param value - An extension record or its selection text.
@@ -5409,8 +5507,7 @@ function parseSnapshot(value) {
5409
5507
  function parseCompilerOptions(value) {
5410
5508
  return isCompilerOptions(value) ? value : void 0;
5411
5509
  }
5412
- //#endregion
5413
- //#region src/core/helpers.ts
5510
+ // src/core/helpers.ts
5414
5511
  /**
5415
5512
  * Encodes bytes as exact lowercase hexadecimal text.
5416
5513
  *
@@ -6429,9 +6526,9 @@ function manifestToDependencies(manifest) {
6429
6526
  function renderSkillPointer(canonical, name) {
6430
6527
  const lines = canonical.split(/\r\n|\n/u);
6431
6528
  if (lines[0] !== "---") return void 0;
6432
- const closing = lines.indexOf("---", 1);
6433
- if (closing === -1) return void 0;
6434
- return `${lines.slice(0, closing + 1).join("\n")}\n${(0, _orkestrel_template.fillTemplate)(ARTIFACT_TEMPLATES.orchestration.skill, { name })}`;
6529
+ const end = lines.indexOf("---", 1);
6530
+ if (end === -1) return void 0;
6531
+ return `${lines.slice(0, end + 1).join("\n")}\n${(0, _orkestrel_template.fillTemplate)(ARTIFACT_TEMPLATES.orchestration.skill, { name })}`;
6435
6532
  }
6436
6533
  /**
6437
6534
  * Scans manifest text for its strings and object braces, in order.
@@ -6477,8 +6574,7 @@ function scanManifestTokens(text) {
6477
6574
  }
6478
6575
  return tokens;
6479
6576
  }
6480
- //#endregion
6481
- //#region src/core/compilers.ts
6577
+ // src/core/compilers.ts
6482
6578
  /**
6483
6579
  * Projects a blueprint into browser extensions restricted to occupied browser axes.
6484
6580
  * @param blueprint - The workspace specification.
@@ -6654,8 +6750,10 @@ function srcToExports(src) {
6654
6750
  * @returns The merged set, sorted by package name.
6655
6751
  *
6656
6752
  * @remarks
6657
- * The shared toolchain is the baseline every generated workspace carries, and
6658
- * each declared axis adds the set its host needs. A declared extra or peer is
6753
+ * The shared toolchain is the baseline every generated workspace carries.
6754
+ * A selected browser framework applies its toolchain hold before the host-specific sets.
6755
+ * Vue faces on either axis select TypeScript 6.0.3; other workspaces select TypeScript 7.0.2.
6756
+ * Each declared axis adds the set its host needs. A declared extra or peer is
6659
6757
  * applied after those, so a workspace that pins a range for a package the
6660
6758
  * conditional sets also name gets the range it declared. An extra that restates
6661
6759
  * a shared toolchain pin never reaches here, because the gate refuses it. A peer
@@ -6670,6 +6768,11 @@ function srcToExports(src) {
6670
6768
  * to drive. A workspace {@link BROWSE_UPSTREAM} names receives nothing either, because
6671
6769
  * `@orkestrel/browser` depends on it at runtime and the declaration would close a cycle.
6672
6770
  *
6771
+ * A journey axis with a browser application receives {@link CAPTURE_DEV_DEPENDENCIES}.
6772
+ * A workspace {@link CAPTURE_UPSTREAM} names receives no capture seed, because it is capture
6773
+ * itself or a member of capture's runtime closure. A browser source, styles surface, or browser
6774
+ * setup alone selects no capture dependency.
6775
+ *
6673
6776
  * A peer is declared here as well as under `peerDependencies`, because a peer is
6674
6777
  * not installed by the workspace that declares it and developing against one
6675
6778
  * requires it present. A runtime dependency is the opposite case and is removed:
@@ -6696,7 +6799,9 @@ function blueprintToDevDependencies(blueprint) {
6696
6799
  const own = blueprint.src.length > 0 || sheets ? `@orkestrel/${blueprint.name}` : blueprint.name;
6697
6800
  const prior = {
6698
6801
  ...BASE_DEV_DEPENDENCIES,
6802
+ ...Object.fromEntries(Object.entries(blueprintToToolchainHolds(blueprint)).map(([name, hold]) => [name, hold.range])),
6699
6803
  ...rendered && !BROWSE_UPSTREAM.includes(own) ? BROWSE_DEV_DEPENDENCIES : {},
6804
+ ...blueprint.journey && blueprint.app.includes("browser") && !CAPTURE_UPSTREAM.includes(own) ? CAPTURE_DEV_DEPENDENCIES : {},
6700
6805
  ...sheets ? STYLES_DEV_DEPENDENCIES : {},
6701
6806
  ...blueprint.src.length > 0 || blueprint.bin ? DECLARATION_DEV_DEPENDENCIES : {},
6702
6807
  ...blueprint.src.includes("browser") || blueprint.setup.includes("browser") || sheets ? SOURCE_BROWSER_DEV_DEPENDENCIES : {},
@@ -6716,6 +6821,21 @@ function blueprintToDevDependencies(blueprint) {
6716
6821
  return Object.fromEntries(Object.entries(merged).filter(([name]) => name !== own && !runtime.has(name)).sort(([left], [right]) => (0, _orkestrel_contract.compareValues)(left, right)));
6717
6822
  }
6718
6823
  /**
6824
+ * Projects a blueprint into the toolchain holds its browser frameworks require.
6825
+ * @param blueprint - The workspace specification.
6826
+ * @returns The held tools for selected browser framework faces; empty without a framework.
6827
+ * @example
6828
+ * ```ts
6829
+ * import { blueprintToToolchainHolds, createBlueprint } from '@orkestrel/scaffold'
6830
+ *
6831
+ * blueprintToToolchainHolds(createBlueprint('router', { src: ['core'] })) // {}
6832
+ * ```
6833
+ */
6834
+ function blueprintToToolchainHolds(blueprint) {
6835
+ const frameworks = blueprintToFaces(blueprint).map((face) => face.name);
6836
+ return Object.fromEntries(Object.entries(TOOLCHAIN_HOLDS).filter(([, hold]) => frameworks.includes(hold.framework)));
6837
+ }
6838
+ /**
6719
6839
  * Projects the scoped npm overrides required by a selected browser showcase.
6720
6840
  *
6721
6841
  * @param blueprint - The workspace specification.
@@ -6852,6 +6972,9 @@ function replaceManifestOverride(manifest, path, range) {
6852
6972
  * The configuration paths interpolated here are the same ones `SRC_MATRIX` and
6853
6973
  * `APP_MATRIX` list as each environment's configuration files, so a rename in
6854
6974
  * either matrix is a rename in both places.
6975
+ * A browser application's journey axis adds `journey` (`capture journey`) and `capture`
6976
+ * (`capture frames`) beside `test:journey`. The scoped commands take an explicit selection;
6977
+ * the whole-suite `test:journey` invocation remains in the test chain.
6855
6978
  *
6856
6979
  * @example
6857
6980
  * ```ts
@@ -6950,6 +7073,8 @@ function blueprintToScripts(blueprint) {
6950
7073
  ...blueprint.setup.includes("browser") ? { "test:setup:browser": `${vitest} --project setup:browser` } : {},
6951
7074
  ...blueprint.journey && blueprint.app.includes("browser") ? {
6952
7075
  "test:journey": journey,
7076
+ journey: "capture journey",
7077
+ capture: "capture frames",
6953
7078
  ...Object.fromEntries(application.map((name) => [`test:journey:${name}`, `${journey} --mode ${name}`]))
6954
7079
  } : {},
6955
7080
  ...blueprint.skills ? { "test:skills": `${vitest} --project skills` } : {},
@@ -6957,7 +7082,7 @@ function blueprintToScripts(blueprint) {
6957
7082
  ...blueprint.conformance ? { "test:conformance": `${vitest} --project conformance` } : {},
6958
7083
  ...blueprint.tree ? { "test:tree": `${vitest} --project tree` } : {},
6959
7084
  "test:probe": "vitest run --config vite.config.ts --no-cache --reporter=verbose --project probe",
6960
- "test:bench": "vitest bench --config vite.config.ts --no-cache --project probe",
7085
+ "test:bench": "vitest bench --config vite.config.ts --no-cache --project \"probe (bench)\" --mode benchmark",
6961
7086
  ...publishes ? { "test:distribution": `${vitest} --project distribution` } : {},
6962
7087
  ...integrates ? { "test:integration": `${vitest} --project integration` } : {},
6963
7088
  ...blueprint.service ? { "test:service": `${vitest} --project service` } : {},
@@ -7022,12 +7147,16 @@ function blueprintToScripts(blueprint) {
7022
7147
  * rewrites, and one carrying skills adds `test:skills`. Publishing adds the pack and publication lifecycle scripts.
7023
7148
  * Sheet and framework faces add their check and build scripts, application frameworks add dev scripts,
7024
7149
  * and selected showcases and journeys add their mode scripts.
7150
+ * A browser application's journey axis also adds `journey` and `capture`. Their generated
7151
+ * commands are writable and have no predecessor forms; customized values remain caller-owned.
7025
7152
  * Aggregate test scripts and
7026
7153
  * maintainer-owned gate chains stay outside the region.
7027
7154
  *
7028
7155
  * `accepted` carries each generated predecessor the region can replace. The
7029
7156
  * guides entry accepts the generated command that invoked the guides project
7030
- * through Vitest alone. The pack hook accepts the build chain emitted before it
7157
+ * through Vitest alone. The benchmark entry accepts the one command that ran the
7158
+ * `probe` project through `vitest bench`, before the dedicated bench project
7159
+ * existed. The pack hook accepts the build chain emitted before it
7031
7160
  * delegated to `build`. The publication hook accepts the same gate chain without
7032
7161
  * {@link RELEASE_PROOF_COMMAND}. A workspace carrying studies also accepts the
7033
7162
  * chain without its study step and the chain without both its study step and
@@ -7053,11 +7182,11 @@ function blueprintToWritableScripts(blueprint) {
7053
7182
  const sheet = sheets.some((face) => name === `build:src:${face}` || name === `check:src:${face}`);
7054
7183
  const framework = blueprintToFaces(blueprint).some((extension) => extension.surface === "browser" && extension.axes.some((axis) => name === `check:${axis}:${extension.name}` || name === `build:${axis}:${extension.name}` || axis === "app" && name === `dev:${extension.name}`));
7055
7184
  const showcase = name === "showcase" || name.startsWith("showcase:") || name === "build:showcase" || name.startsWith("build:showcase:");
7056
- if (!direct && !sheet && !framework && !showcase) return [];
7185
+ if (!direct && !sheet && !framework && !showcase && !(name === "journey" || name === "capture")) return [];
7057
7186
  return [{
7058
7187
  name,
7059
7188
  command,
7060
- accepted: name === "test:guides" ? ["vitest run --config vite.config.ts --no-cache --reporter=dot --project guides"] : name === "build:src:styles" && blueprint.themes ? ["vite build --config configs/src/vite.styles.config.ts"] : sheets.some((face) => name === `test:src:${face}`) ? [command.slice(command.indexOf(" && ") + 4)] : []
7189
+ accepted: name === "test:guides" ? ["vitest run --config vite.config.ts --no-cache --reporter=dot --project guides"] : name === "test:bench" ? ["vitest bench --config vite.config.ts --no-cache --project probe"] : name === "build:src:styles" && blueprint.themes ? ["vite build --config configs/src/vite.styles.config.ts"] : sheets.some((face) => name === `test:src:${face}`) ? [command.slice(command.indexOf(" && ") + 4)] : []
7061
7190
  }];
7062
7191
  });
7063
7192
  const prepack = scripts.prepack;
@@ -7278,7 +7407,8 @@ function blueprintToRootTsconfig(blueprint) {
7278
7407
  * Projects a blueprint into the project labels its root Vitest configuration registers.
7279
7408
  *
7280
7409
  * @param blueprint - The workspace specification.
7281
- * @returns Project labels in registration order, including wrapper-registered sheet faces.
7410
+ * @returns Project labels in registration order, including wrapper-registered sheet faces and
7411
+ * the probe benchmark variant.
7282
7412
  *
7283
7413
  * @example
7284
7414
  * ```ts
@@ -7312,7 +7442,8 @@ function blueprintToProjects(blueprint) {
7312
7442
  ...blueprint.studies ? ["studies"] : [],
7313
7443
  ...blueprint.src.length > 0 || styled ? ["distribution"] : [],
7314
7444
  ...blueprint.integration ? ["integration"] : [],
7315
- "probe"
7445
+ "probe",
7446
+ "probe (bench)"
7316
7447
  ];
7317
7448
  }
7318
7449
  /**
@@ -8494,9 +8625,9 @@ function insertManifestSection(manifest, section, dependencies, present) {
8494
8625
  const root = tokens.find((token) => token.text === "}" && token.depth === 0)?.index;
8495
8626
  if (bounds === void 0) {
8496
8627
  if (present || root === void 0) return void 0;
8497
- const breaking = head === void 0 ? -1 : manifest.lastIndexOf("\n", head);
8498
- const margin = breaking < 0 ? "" : manifest.slice(breaking + 1, head);
8499
- const gap = breaking < 0 || /\S/u.test(margin) ? "" : `\n${margin}`;
8628
+ const lineBreak = head === void 0 ? -1 : manifest.lastIndexOf("\n", head);
8629
+ const margin = lineBreak < 0 ? "" : manifest.slice(lineBreak + 1, head);
8630
+ const gap = lineBreak < 0 || /\S/u.test(margin) ? "" : `\n${margin}`;
8500
8631
  const block = `${JSON.stringify(section)}: {${lines.map((line) => `${gap === "" ? "" : `${gap}${margin}`}${line}`).join(",")}${gap}}`;
8501
8632
  const tail = manifest.slice(1, root).trimEnd().length;
8502
8633
  const [position, insertion] = neighbor === void 0 ? [tail + 1, manifest.charAt(tail) === "{" ? block : `,${gap}${block}`] : section === "devDependencies" ? [neighbor.close + 1, `,${gap}${block}`] : [neighbor.start, `${block},${gap}`];
@@ -8518,11 +8649,11 @@ function insertManifestSection(manifest, section, dependencies, present) {
8518
8649
  const first = declarations[0];
8519
8650
  const last = declarations.at(-1);
8520
8651
  if (first === void 0 || last === void 0) {
8521
- const opening = manifest.lastIndexOf("\n", open);
8522
- const level = opening < 0 ? "" : /^\s*/u.exec(manifest.slice(opening + 1, open))?.[0] ?? "";
8523
- const separator = opening < 0 ? "" : `\n${level}${level}`;
8524
- const ending = opening < 0 ? "" : `\n${level}`;
8525
- return `${manifest.slice(0, open + 1)}${lines.map((line) => `${separator}${line}`).join(",")}${ending}${manifest.slice(close)}`;
8652
+ const lineBreak = manifest.lastIndexOf("\n", open);
8653
+ const level = lineBreak < 0 ? "" : /^\s*/u.exec(manifest.slice(lineBreak + 1, open))?.[0] ?? "";
8654
+ const separator = lineBreak < 0 ? "" : `\n${level}${level}`;
8655
+ const suffix = lineBreak < 0 ? "" : `\n${level}`;
8656
+ return `${manifest.slice(0, open + 1)}${lines.map((line) => `${separator}${line}`).join(",")}${suffix}${manifest.slice(close)}`;
8526
8657
  }
8527
8658
  const newline = manifest.lastIndexOf("\n", first.start);
8528
8659
  const indent = newline < 0 ? "" : manifest.slice(newline + 1, first.start);
@@ -8633,10 +8764,10 @@ function replaceManifestScripts(manifest, scripts) {
8633
8764
  }];
8634
8765
  });
8635
8766
  const missing = scripts.filter((script) => !written.has(script.name));
8636
- const opening = manifest.lastIndexOf("\n", start);
8637
- const level = opening < 0 ? "" : /^\s*/u.exec(manifest.slice(opening + 1, start))?.[0] ?? "";
8638
- const emptySeparator = opening < 0 ? "" : `\n${level}${level}`;
8639
- const emptyClosing = opening < 0 ? "" : `\n${level}`;
8767
+ const lineBreak = manifest.lastIndexOf("\n", start);
8768
+ const level = lineBreak < 0 ? "" : /^\s*/u.exec(manifest.slice(lineBreak + 1, start))?.[0] ?? "";
8769
+ const emptySeparator = lineBreak < 0 ? "" : `\n${level}${level}`;
8770
+ const emptySuffix = lineBreak < 0 ? "" : `\n${level}`;
8640
8771
  const tail = start + manifest.slice(start, end - 1).trimEnd().length;
8641
8772
  const newline = first === void 0 ? -1 : manifest.lastIndexOf("\n", first);
8642
8773
  const indent = first === void 0 || newline < 0 ? "" : manifest.slice(newline + 1, first);
@@ -8652,7 +8783,7 @@ function replaceManifestScripts(manifest, scripts) {
8652
8783
  const appended = missing.length === 0 ? [] : first === void 0 ? [{
8653
8784
  start: start + 1,
8654
8785
  end: end - 1,
8655
- text: `${missing.map((script) => `${emptySeparator}${JSON.stringify(script.name)}: ${JSON.stringify(script.command)}`).join(",")}${emptyClosing}`
8786
+ text: `${missing.map((script) => `${emptySeparator}${JSON.stringify(script.name)}: ${JSON.stringify(script.command)}`).join(",")}${emptySuffix}`
8656
8787
  }] : [...Map.groupBy(placements, ({ anchor }) => anchor)].map(([anchor, group]) => ({
8657
8788
  start: anchor,
8658
8789
  end: anchor,
@@ -9123,8 +9254,7 @@ function overridesToQuestions(overrides, artifacts) {
9123
9254
  }] : []];
9124
9255
  });
9125
9256
  }
9126
- //#endregion
9127
- //#region src/core/factories.ts
9257
+ // src/core/factories.ts
9128
9258
  /**
9129
9259
  * Constructs a {@link Blueprint} from a name and the fields that differ from the defaults.
9130
9260
  *
@@ -9201,8 +9331,7 @@ function createBlueprint(name, input) {
9201
9331
  if (blueprint === void 0) throw new ScaffoldError("INVALID", "The filled record is not a blueprint.", { name });
9202
9332
  return blueprint;
9203
9333
  }
9204
- //#endregion
9205
- //#region src/core/Compiler.ts
9334
+ // src/core/Compiler.ts
9206
9335
  /**
9207
9336
  * Represents the compile spine: draft, gate, pin, run in that order over a blueprint.
9208
9337
  *
@@ -9214,7 +9343,7 @@ function createBlueprint(name, input) {
9214
9343
  * records the coded reason beside them; the stages after a failed one never run,
9215
9344
  * so the records stop where the compile stopped.
9216
9345
  *
9217
- * The compile fails closed on one rule: a scaffolding carries a plan exactly
9346
+ * The compile fails closed on one rule: a compile result carries a plan exactly
9218
9347
  * when no question blocks. A refused blueprint is answered rather than raised,
9219
9348
  * so a caller reads the refusal from the value it asked for.
9220
9349
  *
@@ -9239,10 +9368,10 @@ function createBlueprint(name, input) {
9239
9368
  * import { Compiler, createBlueprint } from '@orkestrel/scaffold'
9240
9369
  *
9241
9370
  * const compiler = new Compiler()
9242
- * const scaffolding = compiler.compile(createBlueprint('router', { src: ['core'] }))
9371
+ * const result = compiler.compile(createBlueprint('router', { src: ['core'] }))
9243
9372
  *
9244
- * scaffolding.plan?.artifacts // every planned file, in group order
9245
- * scaffolding.stages // one CompileRecord per stage that ran
9373
+ * result.plan?.artifacts // every planned file, in group order
9374
+ * result.stages // one CompileRecord per stage that ran
9246
9375
  * compiler.destroy()
9247
9376
  * ```
9248
9377
  */
@@ -9279,7 +9408,7 @@ var Compiler = class {
9279
9408
  *
9280
9409
  * @param blueprint - The workspace specification to compile.
9281
9410
  * @param groups - The artifact groups to cover; every group when absent.
9282
- * @returns The scaffolding, carrying a plan only when the gate passed.
9411
+ * @returns The compile result, carrying a plan only when the gate passed.
9283
9412
  * @throws {@link ScaffoldError} coded `INVALID` when an argument is not the
9284
9413
  * exact shape, and `DESTROYED` when the compiler has been torn down.
9285
9414
  *
@@ -9308,10 +9437,10 @@ var Compiler = class {
9308
9437
  compile(blueprint, groups) {
9309
9438
  this.#assertAlive();
9310
9439
  const accepted = this.#accept(blueprint, parseBlueprint, "blueprint");
9311
- const scaffolding = this.#scaffold(accepted, this.#select(groups));
9312
- if (scaffolding.plan === void 0) this.#emitter.emit("block", scaffolding.questions);
9313
- this.#emitter.emit("compile", scaffolding);
9314
- return scaffolding;
9440
+ const result = this.#scaffold(accepted, this.#select(groups));
9441
+ if (result.plan === void 0) this.#emitter.emit("block", result.questions);
9442
+ this.#emitter.emit("compile", result);
9443
+ return result;
9315
9444
  }
9316
9445
  /**
9317
9446
  * Compiles a blueprint and compares its plan to a target's current content.
@@ -9347,11 +9476,11 @@ var Compiler = class {
9347
9476
  this.#assertAlive();
9348
9477
  const accepted = this.#accept(blueprint, parseBlueprint, "blueprint");
9349
9478
  const observed = this.#accept(current, parseSnapshot, "current");
9350
- const scaffolding = this.#scaffold(accepted, this.#select(groups));
9351
- if (scaffolding.plan === void 0) this.#emitter.emit("block", scaffolding.questions);
9479
+ const compiled = this.#scaffold(accepted, this.#select(groups));
9480
+ if (compiled.plan === void 0) this.#emitter.emit("block", compiled.questions);
9352
9481
  const result = {
9353
- findings: scaffolding.plan === void 0 ? [] : planToFindings(scaffolding.plan, observed),
9354
- questions: scaffolding.questions
9482
+ findings: compiled.plan === void 0 ? [] : planToFindings(compiled.plan, observed),
9483
+ questions: compiled.questions
9355
9484
  };
9356
9485
  this.#emitter.emit("audit", result);
9357
9486
  return result;
@@ -9502,7 +9631,6 @@ var Compiler = class {
9502
9631
  return error;
9503
9632
  }
9504
9633
  };
9505
- //#endregion
9506
9634
  exports.APP_BROWSER_DEV_DEPENDENCIES = APP_BROWSER_DEV_DEPENDENCIES;
9507
9635
  exports.APP_DEV_DEPENDENCIES = APP_DEV_DEPENDENCIES;
9508
9636
  exports.APP_MATRIX = APP_MATRIX;
@@ -9516,9 +9644,11 @@ exports.BIN_OUTPUT_PATH = BIN_OUTPUT_PATH;
9516
9644
  exports.BROWSE_DEV_DEPENDENCIES = BROWSE_DEV_DEPENDENCIES;
9517
9645
  exports.BROWSE_UPSTREAM = BROWSE_UPSTREAM;
9518
9646
  exports.CANON_PATHS = CANON_PATHS;
9647
+ exports.CAPTURE_DEV_DEPENDENCIES = CAPTURE_DEV_DEPENDENCIES;
9648
+ exports.CAPTURE_UPSTREAM = CAPTURE_UPSTREAM;
9519
9649
  exports.CATALOG_AGENT_PATH = CATALOG_AGENT_PATH;
9520
- exports.CATALOG_CLOSING_MARKER = CATALOG_CLOSING_MARKER;
9521
- exports.CATALOG_OPENING_MARKER = CATALOG_OPENING_MARKER;
9650
+ exports.CATALOG_END_MARKER = CATALOG_END_MARKER;
9651
+ exports.CATALOG_START_MARKER = CATALOG_START_MARKER;
9522
9652
  exports.CONFIG_TEMPLATES = CONFIG_TEMPLATES;
9523
9653
  exports.CONFORMANCE_TEST_PATH = CONFORMANCE_TEST_PATH;
9524
9654
  exports.CONTROL_CHARACTER_PATTERN = CONTROL_CHARACTER_PATTERN;
@@ -9591,6 +9721,7 @@ exports.TAB_WIDTH = TAB_WIDTH;
9591
9721
  exports.TARGET_SKILL_NAMES = TARGET_SKILL_NAMES;
9592
9722
  exports.THEMES_BARREL_PATH = THEMES_BARREL_PATH;
9593
9723
  exports.THEMES_ENTRY_PATH = THEMES_ENTRY_PATH;
9724
+ exports.TOOLCHAIN_HOLDS = TOOLCHAIN_HOLDS;
9594
9725
  exports.TREE_TEST_PATH = TREE_TEST_PATH;
9595
9726
  exports.VERSION_PATTERN = VERSION_PATTERN;
9596
9727
  exports.WORKSPACE_DEV_ENGINES = WORKSPACE_DEV_ENGINES;
@@ -9619,6 +9750,7 @@ exports.blueprintToScripts = blueprintToScripts;
9619
9750
  exports.blueprintToSheets = blueprintToSheets;
9620
9751
  exports.blueprintToSourceArtifacts = blueprintToSourceArtifacts;
9621
9752
  exports.blueprintToTestArtifacts = blueprintToTestArtifacts;
9753
+ exports.blueprintToToolchainHolds = blueprintToToolchainHolds;
9622
9754
  exports.blueprintToWritableScripts = blueprintToWritableScripts;
9623
9755
  exports.bytesToHex = bytesToHex;
9624
9756
  exports.catalogToLayers = catalogToLayers;