@orkestrel/scaffold 0.0.133 → 0.0.135

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 (92) 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 +1568 -213
  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 +387 -109
  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 +275 -33
  25. package/dist/bin/main.js.map +1 -1
  26. package/dist/host/AGENTS.md +1 -1
  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 +1990 -274
  46. package/dist/host/agents/skills/orkestrel-publish/references/release.md +1 -0
  47. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +28 -7
  48. package/dist/host/agents/skills/orkestrel-publish/scripts/compare.ts +58 -79
  49. package/dist/host/agents/skills/orkestrel-publish/scripts/pins.ts +66 -87
  50. package/dist/host/agents/skills/orkestrel-publish/scripts/steps.ts +84 -102
  51. package/dist/host/agents/skills/orkestrel-publish/scripts/swap.ts +92 -99
  52. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +483 -127
  53. package/dist/host/agents/skills/orkestrel-publish/scripts/window.ts +82 -120
  54. package/dist/host/agents/skills/orkestrel-scout/SKILL.md +3 -3
  55. package/dist/host/agents/skills/orkestrel-scout/scripts/map.ts +85 -112
  56. package/dist/host/claude/agents/orkestrel.md +16 -16
  57. package/dist/host/claude/rules/architecture.md +1 -1
  58. package/dist/host/claude/rules/documentation.md +1 -1
  59. package/dist/host/claude/rules/patterns.md +7 -4
  60. package/dist/host/claude/rules/styles.md +1 -1
  61. package/dist/host/claude/rules/tests.md +3 -3
  62. package/dist/host/claude/rules/workspace.md +50 -37
  63. package/dist/host/configs/helpers.ts +117 -71
  64. package/dist/host/dotfiles/oxlintrc.json +6 -0
  65. package/dist/host/guides/agent.md +989 -395
  66. package/dist/host/guides/database.md +357 -342
  67. package/dist/host/guides/form.md +79 -4
  68. package/dist/host/guides/middleware.md +5 -5
  69. package/dist/host/guides/ollama.md +41 -42
  70. package/dist/host/guides/scaffold.md +170 -70
  71. package/dist/host/guides/study.md +12 -12
  72. package/dist/host/guides/table.md +20 -6
  73. package/dist/host/guides/test.md +166 -52
  74. package/dist/host/guides/toolbox.md +127 -81
  75. package/dist/host/guides/workspace.md +21 -14
  76. package/dist/host/manifest.json +54 -54
  77. package/dist/host/tests/config.test.ts +251 -7
  78. package/dist/host/tests/policy.test.ts +14 -21
  79. package/dist/host/tests/setupPolicy.ts +43 -36
  80. package/dist/src/core/index.cjs +533 -139
  81. package/dist/src/core/index.cjs.map +1 -1
  82. package/dist/src/core/index.d.cts +223 -16
  83. package/dist/src/core/index.d.ts +223 -16
  84. package/dist/src/core/index.js +524 -139
  85. package/dist/src/core/index.js.map +1 -1
  86. package/dist/src/server/index.cjs +23 -14
  87. package/dist/src/server/index.cjs.map +1 -1
  88. package/dist/src/server/index.d.cts +3 -2
  89. package/dist/src/server/index.d.ts +3 -2
  90. package/dist/src/server/index.js +24 -15
  91. package/dist/src/server/index.js.map +1 -1
  92. package/package.json +2 -2
@@ -103,7 +103,8 @@ Exported from `@orkestrel/scaffold`, and reachable from
103
103
  | `HydratedArtifact` | interface | `{ origin, ownership, source?, hex, content? }` | Represents a vendored file whose exact bytes have been read, so its content can be compared. |
104
104
  | `ManifestDependencySet` | interface | `{ runtime, development, peer }` | Describes the runtime, development, and peer sections read from an existing package manifest. |
105
105
  | `ManifestEdit` | interface | `{ start, end, text }` | Represents one in-place replacement of manifest text. |
106
- | `ManifestRegionSet` | interface | `{ pins, scripts, additions?, overrides? }` | Describes the manifest regions a writing operation may change. |
106
+ | `ManifestEntrySet` | interface | `{ bin, files, exports }` | Describes the `bin`, `files`, and `exports` entries a manifest carries. |
107
+ | `ManifestRegionSet` | interface | `{ pins, scripts, additions?, overrides?, entries? }` | Describes the manifest regions a writing operation may change. |
107
108
  | `ManifestScript` | interface | `{ name, command, accepted }` | Represents one manifest script a region-writing operation may replace. |
108
109
  | `ManifestToken` | interface | `{ text, index, depth, value }` | Represents one string or object brace found in manifest text. |
109
110
  | `Override` | interface | `{ path, content }` | Represents one artifact override. |
@@ -133,7 +134,6 @@ Exported from `@orkestrel/scaffold`, and reachable from
133
134
  | Name | Kind | Signature | Summary |
134
135
  | --------------------------------- | ----- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
135
136
  | `APP_BROWSER_DEV_DEPENDENCIES` | const | `Readonly<Record<string, string>>` | Lists the development dependencies a private browser application adds. |
136
- | `APP_DEV_DEPENDENCIES` | const | `Readonly<Record<string, string>>` | Names the development dependency every private `app` environment adds. |
137
137
  | `APP_MATRIX` | const | `Readonly<Record<Environment, AppDefinition>>` | Holds the configuration and runtime-entry settings each private `app` environment contributes, frozen. |
138
138
  | `APP_SERVER_DEV_DEPENDENCIES` | const | `Readonly<Record<string, string>>` | Lists the development dependencies a private server application adds. |
139
139
  | `ARTIFACT_GROUPS` | const | `readonly ArtifactGroup[]` | Lists the `ArtifactGroup` values in plan order, frozen. |
@@ -142,7 +142,8 @@ Exported from `@orkestrel/scaffold`, and reachable from
142
142
  | `BARREL_CONFIGS` | const | `readonly string[]` | Lists the configuration file a workspace with studies and a server application adds, frozen. |
143
143
  | `BASE_DEV_DEPENDENCIES` | const | `Readonly<Record<string, string>>` | Holds the baseline tooling versions, before framework holds apply. |
144
144
  | `BIN_CONFIGS` | const | `readonly string[]` | Lists the configuration files a workspace that ships its own executable adds, frozen. |
145
- | `BIN_ENTRY_PATH` | const | `"src/bin/main.ts"` | Names the executable entry whose presence makes a workspace `bin`. |
145
+ | `BIN_ENTRY_PATH` | const | `"src/bin/main.ts"` | Names the executable entry, the `main` module of `src/bin`. |
146
+ | `BIN_MODULE_PATTERN` | const | `RegExp` | Matches the stem of a `src/bin` module: lowercase letters and digits, letter first, no hyphen. |
146
147
  | `BIN_OUTPUT_PATH` | const | `"dist/bin/main.js"` | Names the built executable a bin workspace's manifest command runs. |
147
148
  | `BROWSE_DEV_DEPENDENCIES` | const | `Readonly<Record<string, string>>` | Names the development dependency a browser or styles surface adds. |
148
149
  | `BROWSE_UPSTREAM` | const | `readonly string[]` | Lists the packages `@orkestrel/browser` depends on at runtime, directly or transitively, frozen. |
@@ -153,6 +154,7 @@ Exported from `@orkestrel/scaffold`, and reachable from
153
154
  | `CATALOG_AGENT_PATH` | const | `".claude/agents/orkestrel.md"` | Names the agent file whose marker-bounded package table the catalog verb alone owns. |
154
155
  | `CATALOG_END_MARKER` | const | `"<!-- /orkestrel:catalog -->"` | Names the marker closing the package table inside `CATALOG_AGENT_PATH`. |
155
156
  | `CATALOG_START_MARKER` | const | `"<!-- orkestrel:catalog -->"` | Names the marker opening the package table inside `CATALOG_AGENT_PATH`. |
157
+ | `CENTRAL_FILE_NAMES` | const | `readonly string[]` | Lists the stems of the centralized files the architecture kind table names, which no `src/bin` module takes, frozen. |
156
158
  | `CONFIG_TEMPLATES` | const | `ConfigTemplateSet` | Holds formatter-stable template text for every configuration artifact. |
157
159
  | `CONFORMANCE_TEST_PATH` | const | `"tests/conformance.test.ts"` | Names the official-tooling drift proof whose presence makes a workspace `conformance`. |
158
160
  | `CONTROL_CHARACTER_PATTERN` | const | `RegExp` | Matches the Unicode controls, formatting controls, and line and paragraph separators rejected in text. |
@@ -178,6 +180,7 @@ Exported from `@orkestrel/scaffold`, and reachable from
178
180
  | `INTEGRATION_TEST_PATH` | const | `"tests/integration.test.ts"` | Names the cross-environment composition proof whose presence makes a workspace `integration`. |
179
181
  | `INVALID_PATH_CHARACTER_PATTERN` | const | `RegExp` | Matches the visible characters a target-relative path and a Markdown path cell both forbid. |
180
182
  | `JOURNEY_CONFIG_PATH` | const | `"configs/app/vite.journey.config.ts"` | Names the Vite wrapper whose presence makes a workspace `journey`. |
183
+ | `MANIFEST_KEY_ORDER` | const | `readonly string[]` | Lists the top-level manifest keys in the order a compiled manifest emits them. |
181
184
  | `MANIFEST_PATH` | const | `"package.json"` | Names the manifest path every compiler plan emits with birth ownership. |
182
185
  | `MAX_ARTIFACT_BYTES` | const | `5242880` | Caps the bytes accepted for one artifact. |
183
186
  | `MAX_ARTIFACT_HEX_LENGTH` | const | `number` | Caps the length of the hexadecimal string carrying one artifact's bytes. |
@@ -232,36 +235,38 @@ Exported from `@orkestrel/scaffold`, and reachable from
232
235
 
233
236
  #### Guards
234
237
 
235
- | Name | Kind | Signature | Summary |
236
- | -------------------- | -------- | ------------------------------------------------- | --------------------------------------------------------------------------------- |
237
- | `isArtifact` | const | `Guard<Artifact>` | Narrows a value to an `Artifact`. |
238
- | `isArtifactFinding` | const | `Guard<ArtifactFinding>` | Narrows a value to an `ArtifactFinding`. |
239
- | `isArtifactGroup` | const | `Guard<ArtifactGroup>` | Narrows a value to one `ArtifactGroup` a plan selects over. |
240
- | `isArtifactGroups` | const | `Guard<readonly ArtifactGroup[]>` | Narrows a value to a bounded group selection. |
241
- | `isAudit` | const | `Guard<Audit>` | Narrows a value to an `Audit`. |
242
- | `isBlueprint` | const | `Guard<Blueprint>` | Narrows a value to a `Blueprint`. |
243
- | `isBrowserExtension` | const | `Guard<BrowserExtension>` | Narrows a value to a supported browser framework with distinct occupied axes. |
244
- | `isCatalogEntry` | const | `Guard<CatalogEntry>` | Narrows a value to a `CatalogEntry`. |
245
- | `isCollection` | function | `(value: unknown) => value is readonly unknown[]` | Narrows a value to an array within the limit one public collection accepts. |
246
- | `isCompilerHooks` | const | `Guard<EmitterHooks<CompilerEventMap>>` | Narrows a value to the compiler's initial listener record. |
247
- | `isCompilerOptions` | const | `Guard<CompilerOptions>` | Narrows a value to `CompilerOptions`. |
248
- | `isContent` | const | `Guard<string>` | Narrows a value to text this package will accept as one artifact's content. |
249
- | `isDependency` | const | `Guard<Dependency>` | Narrows a value to a `Dependency`. |
250
- | `isDependencyName` | const | `Guard<string>` | Narrows a value to the scoped package name a runtime dependency carries. |
251
- | `isEnvironment` | const | `Guard<Environment>` | Narrows a value to one `Environment` a workspace may select. |
252
- | `isExtension` | const | `Guard<Extension>` | Narrows a value to an extension of a supported surface. |
253
- | `isHexContent` | const | `Guard<string>` | Narrows a value to exact lowercase hexadecimal bytes within one artifact's limit. |
254
- | `isManifestScript` | const | `Guard<ManifestScript>` | Narrows a value to a `ManifestScript`. |
255
- | `isMirror` | const | `Guard<Mirror>` | Narrows a value to a `Mirror`. |
256
- | `isOverride` | const | `Guard<Override>` | Narrows a value to an `Override`. |
257
- | `isPath` | function | `(value: unknown) => value is string` | Narrows a value to a logical target-relative path. |
258
- | `isPlan` | const | `Guard<Plan>` | Narrows a value to a `Plan`. |
259
- | `isQuestion` | const | `Guard<Question>` | Narrows a value to a `Question`. |
260
- | `isScaffoldError` | function | `(value: unknown) => value is ScaffoldError` | Narrows a caught value to a `ScaffoldError`. |
261
- | `isSheetName` | function | `(value: unknown) => value is string` | Narrows a value to a non-reserved sheet face name. |
262
- | `isSnapshot` | function | `(value: unknown) => value is Snapshot` | Narrows a value to a `Snapshot`. |
263
- | `isStylesExtension` | const | `Guard<StylesExtension>` | Narrows a value to a named non-reserved stylesheet face. |
264
- | `isSurface` | const | `Guard<Surface>` | Narrows a value to a surface an extension can extend. |
238
+ | Name | Kind | Signature | Summary |
239
+ | -------------------- | -------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------- |
240
+ | `isArtifact` | const | `Guard<Artifact>` | Narrows a value to an `Artifact`. |
241
+ | `isArtifactFinding` | const | `Guard<ArtifactFinding>` | Narrows a value to an `ArtifactFinding`. |
242
+ | `isArtifactGroup` | const | `Guard<ArtifactGroup>` | Narrows a value to one `ArtifactGroup` a plan selects over. |
243
+ | `isArtifactGroups` | const | `Guard<readonly ArtifactGroup[]>` | Narrows a value to a bounded group selection. |
244
+ | `isAudit` | const | `Guard<Audit>` | Narrows a value to an `Audit`. |
245
+ | `isBlueprint` | const | `Guard<Blueprint>` | Narrows a value to a `Blueprint`. |
246
+ | `isBinModule` | function | `(value: unknown) => value is string` | Narrows a value to the stem of a `src/bin` module. |
247
+ | `isBrowserExtension` | const | `Guard<BrowserExtension>` | Narrows a value to a supported browser framework with distinct occupied axes. |
248
+ | `isCatalogEntry` | const | `Guard<CatalogEntry>` | Narrows a value to a `CatalogEntry`. |
249
+ | `isCollection` | function | `(value: unknown) => value is readonly unknown[]` | Narrows a value to an array within the limit one public collection accepts. |
250
+ | `isCompilerHooks` | const | `Guard<EmitterHooks<CompilerEventMap>>` | Narrows a value to the compiler's initial listener record. |
251
+ | `isCompilerOptions` | const | `Guard<CompilerOptions>` | Narrows a value to `CompilerOptions`. |
252
+ | `isContent` | const | `Guard<string>` | Narrows a value to text this package will accept as one artifact's content. |
253
+ | `isDependency` | const | `Guard<Dependency>` | Narrows a value to a `Dependency`. |
254
+ | `isDependencyName` | const | `Guard<string>` | Narrows a value to the scoped package name a runtime dependency carries. |
255
+ | `isEnvironment` | const | `Guard<Environment>` | Narrows a value to one `Environment` a workspace may select. |
256
+ | `isExtension` | const | `Guard<Extension>` | Narrows a value to an extension of a supported surface. |
257
+ | `isHexContent` | const | `Guard<string>` | Narrows a value to exact lowercase hexadecimal bytes within one artifact's limit. |
258
+ | `isManifestScript` | const | `Guard<ManifestScript>` | Narrows a value to a `ManifestScript`. |
259
+ | `isMirror` | const | `Guard<Mirror>` | Narrows a value to a `Mirror`. |
260
+ | `isOverride` | const | `Guard<Override>` | Narrows a value to an `Override`. |
261
+ | `isPath` | function | `(value: unknown) => value is string` | Narrows a value to a logical target-relative path. |
262
+ | `isPlan` | const | `Guard<Plan>` | Narrows a value to a `Plan`. |
263
+ | `isQuestion` | const | `Guard<Question>` | Narrows a value to a `Question`. |
264
+ | `isScaffoldError` | function | `(value: unknown) => value is ScaffoldError` | Narrows a caught value to a `ScaffoldError`. |
265
+ | `isSheetName` | function | `(value: unknown) => value is string` | Narrows a value to a non-reserved sheet face name. |
266
+ | `isSnapshot` | function | `(value: unknown) => value is Snapshot` | Narrows a value to a `Snapshot`. |
267
+ | `isStylesExtension` | const | `Guard<StylesExtension>` | Narrows a value to a named non-reserved stylesheet face. |
268
+ | `isSubpathMap` | function | `(value: unknown) => value is Readonly<Record<string, unknown>>` | Narrows a manifest `exports` value to a map of subpaths. |
269
+ | `isSurface` | const | `Guard<Surface>` | Narrows a value to a surface an extension can extend. |
265
270
 
266
271
  #### Parsers
267
272
 
@@ -296,14 +301,17 @@ Exported from `@orkestrel/scaffold`, and reachable from
296
301
  | `isRetainedPath` | function | `(path: string) => boolean` | Checks whether another surface owns a target's present bytes at a path. |
297
302
  | `iterateAnswers` | function | `<TValue, TAnswer>(source: Iterable<TValue>, answer: (value: TValue) => TAnswer \| undefined) => Generator<TAnswer \| undefined, void, undefined>` | Yields the answer to each value of a source and ends after the first refused answer. |
298
303
  | `manifestToDependencies` | function | `(manifest: string) => ManifestDependencySet` | Projects a package manifest's text to the `@orkestrel/*` packages each dependency section declares. |
304
+ | `manifestToEntries` | function | `(manifest: string, planned: ManifestEntrySet) => ManifestEntrySet` | Projects a package manifest's text to the planned `bin`, `files`, and `exports` entries it lacks. |
299
305
  | `manifestToName` | function | `(manifest: string) => string \| undefined` | Projects a package manifest's text to its own name. |
300
306
  | `matchesArtifactDriftReachability` | function | `(ownership: Ownership, finding: ArtifactFinding) => boolean` | Tests whether `inferArtifactDrift` could have produced a finding for an ownership. |
301
307
  | `matchesBarrel` | function | `(blueprint: Blueprint) => boolean` | Tests whether a workspace plans the application server barrel build. |
302
308
  | `matchesEngines` | function | `(engines: string) => boolean` | Tests whether a declared engines floor is at or above the supported minimum. |
303
309
  | `matchesOrchestrationPath` | function | `(path: string) => boolean` | Tests whether a path instructs or wires an agent rather than the toolchain. |
310
+ | `matchesPackedPath` | function | `(declared: string, planned: string) => boolean` | Checks whether a declared `files` entry packs a planned one. |
304
311
  | `matchesPrintWidth` | function | `(line: string) => boolean` | Tests whether one emitted line fits the vendored formatter width. |
305
312
  | `matchesRange` | function | `(range: string, latest: string) => boolean` | Tests whether a declared range already admits a published version. |
306
313
  | `nameToGuide` | function | `(name: string) => string` | Derives the guide mirror path a package name answers for. |
314
+ | `normalizePackagePath` | function | `(path: string) => string` | Returns the canonical form of a path a manifest names inside its package. |
307
315
  | `parseOwnedJSONValue` | function | `(value: unknown) => JSONValue \| undefined` | Snapshots an untrusted value into exact JSON data the caller owns. |
308
316
  | `planToSummary` | function | `(plan: Plan) => PlanSummary` | Projects a plan into its tally by artifact origin. |
309
317
  | `renderSkillPointer` | function | `(canonical: string, name: string) => string \| undefined` | Renders the `SKILL.md` pointer a target carries in place of a canonical skill. |
@@ -333,7 +341,8 @@ Exported from `@orkestrel/scaffold`, and reachable from
333
341
  | `blueprintToDevDependencies` | function | `(blueprint: Blueprint) => Readonly<Record<string, string>>` | Projects a blueprint into the development dependencies its manifest declares. |
334
342
  | `blueprintToToolchainHolds` | function | `(blueprint: Blueprint) => Readonly<Record<string, ToolchainHold>>` | Projects a blueprint into the toolchain holds its browser frameworks require. |
335
343
  | `blueprintToDocumentArtifacts` | function | `(blueprint: Blueprint) => readonly ContentArtifact[]` | Compiles the generated workspace's root documentation. |
336
- | `blueprintToExports` | function | `(blueprint: Blueprint) => Readonly<Record<string, unknown>>` | Projects published environments and sheets into the manifest export map. |
344
+ | `blueprintToEntries` | function | `(blueprint: Blueprint) => ManifestEntrySet` | Projects a blueprint into the `bin`, `files`, and `exports` entries its manifest carries. |
345
+ | `blueprintToExports` | function | `(blueprint: Blueprint) => Readonly<Record<string, unknown>>` | Projects published environments, sheets, and `src/bin` modules into the manifest export map. |
337
346
  | `blueprintToFaces` | function | `(blueprint: Blueprint) => readonly BrowserExtension[]` | Projects a blueprint into browser extensions restricted to occupied browser axes. |
338
347
  | `blueprintToGuideArtifacts` | function | `(blueprint: Blueprint) => readonly ContentArtifact[]` | Compiles the generated workspace's guide index. |
339
348
  | `blueprintToHostArtifacts` | function | `(blueprint: Blueprint) => readonly Artifact[]` | Compiles the vendored host artifacts a workspace plans. |
@@ -353,6 +362,7 @@ Exported from `@orkestrel/scaffold`, and reachable from
353
362
  | `blueprintToWritableScripts` | function | `(blueprint: Blueprint) => readonly ManifestScript[]` | Projects a blueprint into the manifest scripts a region write may replace. |
354
363
  | `dependenciesToQuestions` | function | `(dependencies: readonly Dependency[], field: string, name: RegExp, range: RegExp) => readonly Question[]` | Measures one declared package list against the name and range syntax it accepts. |
355
364
  | `insertManifestDependencies` | function | `(manifest: string, additions: DependencyPinSet) => string \| undefined` | Inserts dependencies a package manifest does not declare into the section each one names. |
365
+ | `insertManifestEntries` | function | `(manifest: string, planned: ManifestEntrySet) => string \| undefined` | Inserts the planned `bin`, `files`, and `exports` entries a package manifest lacks. |
356
366
  | `insertManifestSection` | function | `(manifest: string, section: 'dependencies' \| 'devDependencies', dependencies: readonly Dependency[], present: boolean) => string \| undefined` | Inserts dependencies into one section of package manifest text. |
357
367
  | `overridesToQuestions` | function | `(overrides: readonly Override[], artifacts: readonly Artifact[]) => readonly Question[]` | Measures a blueprint's overrides against the artifacts drafted for it. |
358
368
  | `pathToCondition` | function | `(path: string, formats: readonly BuildFormat[]) => Readonly<Record<string, unknown>>` | Builds one `exports` condition block for a built environment. |
@@ -697,9 +707,49 @@ files on `main`, the scaffold repository's `host.json` file, and changed vendore
697
707
  `ORKESTREL_SCAFFOLD_REPOSITORY` replaces the repository base. These settings change which host
698
708
  answers a read and grant no verb write authority that it did not already have.
699
709
 
700
- `new --bin` creates the executable entry, its test, and its scoped Vite and TypeScript wrappers. The
701
- `new --app browser` command selects the journey axis, creates its birth-owned wrapper, defines
702
- `appJourney` in the root configuration, and excludes the browser integration suite from
710
+ `new --bin` creates the executable entry, its test, and its scoped Vite and TypeScript wrappers.
711
+
712
+ A `src/bin` module takes no creation option. Write it as a direct child `src/bin/<name>.ts` whose
713
+ name `BIN_MODULE_PATTERN` admits and `CENTRAL_FILE_NAMES` does not name, as an import from a library
714
+ environment through its `@src/*` alias followed by `export default` of the imported value, because
715
+ a host tool such as Vitest's `--reporter=<specifier>` loads the module's default export. The reading
716
+ verbs list every direct `.ts` file whose name opens with a lowercase letter and names no
717
+ centralized file in `bin`, and the gate refuses one `isBinModule` rejects, such as `my-tool`.
718
+ `main` stays the executable. Each module other than
719
+ `main` builds through `srcBin` and `configs/src/vite.bin.config.ts` to the ES-only
720
+ `dist/bin/<name>.js` with its rolled-up `dist/bin/<name>.d.ts`, and the manifest exports it as
721
+ `./<name>`. Only `main.js` carries the `#!/usr/bin/env node` banner, and only `main` plans the `bin`
722
+ command. Every module shares `check:src:bin`, `build:src:bin`, `test:src:bin`, and the `src:bin`
723
+ project over `tests/src/bin`. The build keeps every `@src/*` specifier external and rewrites it
724
+ through `output.paths` to the built `../src/<environment>/index.js`, and `rewriteSourceSpecifier`
725
+ writes the same path into each declaration. The vendored `.oxlintrc.json` admits a default export
726
+ in `src/bin/*.ts` and refuses a relative import of `src/core` or `src/server` from `src/bin`, which
727
+ would bundle a second copy of the environment. The distribution proof reads `dist/bin` as its own
728
+ face and reports a library source copied into it. The gate refuses a module whose `./<name>`
729
+ subpath another planned subpath takes, such as `src/bin/server.ts` beside `src/server`, and names
730
+ both. A consumer loads a module by its subpath, as `--reporter=@orkestrel/test/reporter` loads the
731
+ `reporter` module of `@orkestrel/test`.
732
+
733
+ When an existing workspace adds a `src/bin` module, `overwrite` writes every row its manifest
734
+ lacks: `exports["./<name>"]`, `dist/bin` in `files`, `check:src:bin`, `build:src:bin`, and
735
+ `test:src:bin`. It extends `test:src`, `check:src`, and `build:src` where each still holds a value
736
+ an earlier plan generated. `repair` writes the scripts and none of the entries. Before the write,
737
+ `audit` reports the missing entries in its `entries` question and the missing scripts in its
738
+ `scripts` question. Where the package owns `check:src` or `build:src`, the `scripts` question asks
739
+ you to invoke `npm run check:src:bin` from the `check:src` chain and `npm run build:src:bin` from
740
+ the `build:src` chain. Where the manifest declares no `check:src` or `build:src`, the question names
741
+ the script to add and the `check` or `build` chain that invokes it. Where the package owns
742
+ `test:src`, the `projects` question asks you to add `--project src:bin` to it, and `overwrite`
743
+ refuses the `configs` group with that same step named until a chain from `test` reaches the
744
+ project. `src/bin/main.ts` adds the `bin` command to the same rows. An executable reaches `dist/src` only through
745
+ the `@src/*` specifiers its build rewrites, one per library environment, so `dist/src` is packed
746
+ only where a library environment or a sheet builds into it, and an executable beside neither packs
747
+ `dist/bin` and no `dist/src`. An added library environment follows the
748
+ same rule: `overwrite` writes its subpath, `check:src:<environment>`, `build:src:<environment>`,
749
+ and `test:src:<environment>`, and extends the generated aggregates.
750
+
751
+ The `new --app browser` command selects the journey axis, creates its birth-owned wrapper,
752
+ defines `appJourney` in the root configuration, and excludes the browser integration suite from
703
753
  `app:browser`. Its manifest declares `test:journey`. A `private: true` workspace invokes it after
704
754
  `npm run test:app` in `test`; a publishing workspace runs application and journey suites on demand,
705
755
  outside release gates and chains. It also declares `journey: capture journey` and `capture: capture frames` for explicit
@@ -771,7 +821,8 @@ environment's export a distinct name. The record never holds a conflict, so a co
771
821
  run that reads its owner as a candidate.
772
822
 
773
823
  A candidate refuses, naming its path, when its manifest is unreadable, when it has neither its guide
774
- nor `src/`, when its guide exists but is not UTF-8 text within the artifact bound, or when a
824
+ nor `src/` (an app-only workspace, which publishes no surface and relies on its `test:policy`
825
+ `surface` rule), when its guide exists but is not UTF-8 text within the artifact bound, or when a
775
826
  TypeScript source under `src/` cannot be read. Only `.ts` files under `src/` are read, so a binary
776
827
  asset there is ignored. A barrel holding a statement other than `export * from './module.js'`
777
828
  refuses with the statement named, because the reflection follows nothing else and an incomplete
@@ -877,7 +928,7 @@ and the declared `@orkestrel/*` packages come from `package.json`. The environme
877
928
  the directories the target actually ships, because a directory is the fact and a declaration beside
878
929
  it could disagree. The styles surface, its themes target, the showcase, and every extension are
879
930
  read from the markers Surfaces and extensions lists. The remaining facts come from exact-case
880
- files: `src/bin/main.ts` selects `bin`, each root `tests/setup*.test.ts` match selects `setup`,
931
+ files: each direct `src/bin` module adds its name to `bin`, each root `tests/setup*.test.ts` match selects `setup`,
881
932
  `tests/guides.test.ts` selects `guides`, `tests/integration.test.ts` selects `integration`,
882
933
  `tests/conformance.test.ts` selects `conformance`, `tests/tree.test.ts` selects `tree`,
883
934
  `tests/setupService.ts` selects `service`,
@@ -990,6 +1041,8 @@ Scaffold writes one part of the manifest rather than advising on it: the writabl
990
1041
  `repair` and `overwrite` write every direct `test:<project>` script the blueprint computes,
991
1042
  `test:probe`, and `test:bench`. A publishing workspace also receives `test:distribution`, `prepack`,
992
1043
  and `prepublishOnly`. Each sheet face adds its `check:src:<face>` and `build:src:<face>` scripts.
1044
+ Each library environment adds its `check:src:<environment>` and `build:src:<environment>` scripts.
1045
+ The `src/bin` modules add `check:src:bin` and `build:src:bin`.
993
1046
  Each occupied framework face adds `check:<axis>:vue` and `build:<axis>:vue`; the application face also adds `dev:vue`.
994
1047
  Selected showcase pages add `showcase`, `showcase:<framework>`, `build:showcase`, and `build:showcase:<framework>`; application journeys add `test:journey:<framework>`.
995
1048
  A workspace that plans the application server barrel adds `build:app:barrel`, which has no
@@ -1001,18 +1054,26 @@ predecessor of the chain that builds themes after it. A publishing `test` chain
1001
1054
  it matches byte for byte the planned chain with the generated `test:app`, `test:journey`, and framework
1002
1055
  journey invocations inserted after `test:src`, where that blueprint emitted them before.
1003
1056
  `repair` and `overwrite` remove those helper invocations from that exact predecessor.
1004
- When the `test` or `build:app` chain is a generated predecessor, which runs fewer steps than
1005
- the planned chain and runs only planned steps in the planned order, that chain joins the region
1006
- and `repair` and `overwrite` write the planned chain in its place. That write lands only when
1007
- every step the planned chain adds runs a script the manifest declares or the region writes. The
1008
- `test:src` and `test:app` aggregates sit outside the region. Only a private workspace's planned
1009
- chain invokes `test:app`. A chain whose planned form adds an
1057
+ When the `test`, `test:src`, `check:src`, `build:src`, or `build:app` chain is a generated
1058
+ predecessor, which runs fewer steps or names fewer `--project` values than the planned chain and
1059
+ runs only planned steps and projects in the planned order, that chain joins the region and `repair`
1060
+ and `overwrite` write the planned chain in its place. That write lands only when every step the
1061
+ planned chain adds runs a Vitest command or a script the manifest declares or the region writes. An
1062
+ absent aggregate is never written, and `test:app` sits outside the region. Only a private
1063
+ workspace's planned chain invokes `test:app`. A chain whose planned form adds an
1010
1064
  aggregate the manifest lacks stays with the package, and the `projects` question keeps its remedy.
1011
1065
  `audit` reports this `test` chain write only through the `projects` question, so a planned step that
1012
1066
  registers no Vitest project, such as `npm run test:guides`, lands on the next `repair` without an
1013
- earlier advisory. `audit` reports no `build:app` chain write, so in a barrel workspace only the
1014
- `scripts` question's report of a missing `build:app:barrel` script precedes that write. A `test` or
1015
- `build:app` chain running any other step or order stays maintainer-owned, as do the
1067
+ earlier advisory. `audit` reports no `build:app` chain write, so `repair` rewrites a predecessor
1068
+ `build:app` with no earlier advisory after `build:app:barrel` is declared, and before then only the
1069
+ `scripts` question's report of a missing `build:app:barrel` script precedes that write. A
1070
+ package-owned `build:app` chain that omits the barrel step stays with the package, and the `scripts`
1071
+ question reports that no chain from `build` reaches `build:app:barrel`. A package-owned `check:src`
1072
+ or `build:src` chain that omits an entry's step stays with the package, and the `scripts` question
1073
+ reports each of `check:src:bin` and `build:src:bin`
1074
+ that no chain from `check` or `build` reaches. A package-owned `test:src` that omits an entry's
1075
+ project raises the `projects` question, which names `test:src` and the missing `--project` value.
1076
+ A chain the region lists running any other step or order stays maintainer-owned, as do the
1016
1077
  `check`, `build`, `dev`, `serve`, `format`, `lint`, `clean`, and `copy` gate chains. A
1017
1078
  declared value is overwritten only when it is already the value being written or is a recognized
1018
1079
  generated predecessor. The overwrite happens in place,
@@ -1038,6 +1099,38 @@ reconcile the declared ranges and write the script region on every run, whatever
1038
1099
  names. A run scoped to `manifest` for a script write takes the reconciled `@orkestrel/*`
1039
1100
  ranges with it, and a run that excludes `manifest` still takes the ranges and the scripts.
1040
1101
 
1102
+ `overwrite` also inserts each planned `bin` command, `files` path, and `exports` subpath the
1103
+ manifest lacks, whatever `--groups` selects, and `repair` inserts none. The entries land in the
1104
+ offline half beside the dependency declarations, so a catalog step that cannot complete keeps them.
1105
+ An inserted entry lands before the first declared entry the plan orders after it and copies the
1106
+ section's indentation; an absent section is created before the first declared key the born
1107
+ manifest orders after it. A declared entry keeps its value whatever the plan holds, and each
1108
+ section reads a planned entry as declared by its own rule:
1109
+
1110
+ - A planned command is declared when `bin` names it, or when any declared command runs the planned
1111
+ file, so a package that publishes its executable under another name, such as `browse`, keeps
1112
+ that name. A string `bin` declares the planned command when it names the planned file. Both
1113
+ forms read a path as npm does: a backslash is a separator and a run of separators is one, so
1114
+ `dist\bin\main.js` and `dist//bin/main.js` name `dist/bin/main.js`.
1115
+ - A planned `files` path is declared when a declared path equals it or names a directory above it,
1116
+ compared by path segments, so `dist` packs `dist/app` and `dist-old` does not. A declared path
1117
+ ending in `/**` or `/*` names the directory before it, so `dist/**` packs `dist/app`. No other
1118
+ glob is read: `dist/*.js` declares no planned path it does not equal. A negated path is declared
1119
+ only by an equal entry.
1120
+ - A planned subpath is declared when the `exports` map names it. A string `exports`, a fallback
1121
+ array, or an object whose keys are conditions such as `import` and `require` publishes the root
1122
+ export alone, so it declares `.` and takes no other subpath: Node refuses an object that mixes
1123
+ conditions with subpaths.
1124
+
1125
+ A `bin` value that is not an object, an `exports` value that is not a map of subpaths, or a
1126
+ `files` value that is not an array of strings takes no entry. `audit` reports every missing entry
1127
+ in its non-blocking `entries` question, which names each entry with its JSON value and each section
1128
+ whose shape refuses it, with the shape that admits the entry. The human report of `overwrite`
1129
+ prints one `Inserted <entry> in package.json.` line per entry it wrote. When a workspace plans an
1130
+ executable and declares `"sideEffects": false`, `audit` adds a non-blocking `sideEffects` note
1131
+ that a bundler may drop the imports the executable runs only for their side effects, and names
1132
+ the value a born manifest carries. No verb changes the declared value.
1133
+
1041
1134
  Before resolving overwrite's version ranges, the declaration step lifts each planned foreign tool
1042
1135
  whose `devDependencies` major is earlier than the canon's to the blueprint's planned range,
1043
1136
  including selected framework holds. An equal or later declared major stays, as does a disjunction
@@ -1228,7 +1321,7 @@ import { createBlueprint } from '@orkestrel/scaffold'
1228
1321
  const blueprint = createBlueprint('router', {
1229
1322
  src: ['core', 'server'],
1230
1323
  dependencies: [{ name: '@orkestrel/emitter', range: '^0.0.5' }],
1231
- bin: true,
1324
+ bin: ['main'],
1232
1325
  })
1233
1326
 
1234
1327
  blueprint.version // '0.0.1'
@@ -1273,8 +1366,8 @@ because the shape is chosen once and read afterwards: `new` refuses the advisory
1273
1366
  `repair` need the plan to describe and restore a target that already has that shape. A library
1274
1367
  caller creating a workspace holds the same refusal, and the Compile section states it.
1275
1368
 
1276
- `bin`, `setup`, `guides`, `integration`, `conformance`, `tree`, `service`, `vendors`, `studies`,
1277
- `global`, `styles`, `themes`, `showcase`, `journey`, `base`, and `skills` are structural facts, and `extensions` lists the
1369
+ `bin`, `setup`, `guides`, `integration`, `conformance`, `tree`, `service`, `vendors`,
1370
+ `studies`, `global`, `styles`, `themes`, `showcase`, `journey`, `base`, and `skills` are structural facts, and `extensions` lists the
1278
1371
  extension faces. Reading verbs set each fact and list each extension only when the workspace
1279
1372
  physically ships the directory or exact-case file that defines it, never because of the workspace's
1280
1373
  name and never because a sibling fact is set.
@@ -1448,8 +1541,8 @@ workspace carries:
1448
1541
  `BrowserExtension.axes` lists the axes a browser extension physically occupies, so a target holding
1449
1542
  `app/vue` and no `src/vue` carries `axes: ['app']`. `FRAMEWORKS` holds `vue` alone. A
1450
1543
  `StylesExtension` name passes `isSheetName`: it matches `NAME_PATTERN` and is none of the
1451
- `RESERVED_SHEET_NAMES` values, which are `core`, `browser`, `server`, `bin`, `styles`, `themes`, and
1452
- `vue`.
1544
+ `RESERVED_SHEET_NAMES` values, which are `core`, `browser`, `server`, `bin`, `styles`,
1545
+ `themes`, and `vue`.
1453
1546
 
1454
1547
  `parseExtension` reads one `surface:name` entry, and `isSurface` decides whether its surface is
1455
1548
  one the generator plans, so `styles:print` parses and `themes:print` does not. Browser text carries
@@ -1600,8 +1693,8 @@ The `vue` extension gives each axis it occupies a face of its own:
1600
1693
  `check` script typechecks the whole tree through `vue-tsc` in place of `tsc`.
1601
1694
 
1602
1695
  The vendored `.oxlintrc.json` holds each face to the import direction `AGENTS.md` § Project model fixes, and
1603
- refuses, from `src/browser`, `src/server`, `src/vue`, and `src/bin`, a relative path to `src/core`, to
1604
- `src/browser` from `src/vue`, or to `src/server` from `src/bin` with a message naming the alias, because a face's
1696
+ refuses, from `src/browser`, `src/server`, `src/vue`, and `src/bin`, a relative path to
1697
+ `src/core`, to `src/browser` from `src/vue`, or to `src/server` from `src/bin` with a message naming the alias, because a face's
1605
1698
  build bundles what a relative path reaches. The vendored
1606
1699
  `tests/config.test.ts` drives those directions through Oxlint.
1607
1700
 
@@ -1700,14 +1793,14 @@ A workspace that selects `studies` and the `server` application also builds the
1700
1793
  `build:app:barrel` script exist only under that condition, and `build:app` runs the script after
1701
1794
  `build:app:server`. `serve:build` runs `build` before `serve`, so the barrel, which the server
1702
1795
  build's emptied `dist/app/server` would otherwise lose, and every browser face the server serves are
1703
- rebuilt. The build emits the single file `dist/app/server/index.js` with `@app/*` and
1704
- `@src/*` specifiers and relative imports inlined, and `node:` and every installed package specifier
1705
- left external. It sets `emptyOutDir` to `false`, so `main.cjs` stays byte-identical. A workspace
1706
- without both conditions plans none of the three. Scaffold's `tests/src/core/templates.test.ts` builds both entries in a
1707
- staged root, compares the `main.cjs` digest across the barrel step, builds the barrel twice for one
1708
- `index.js` digest, imports the file in Node, and holds each claim under a control. The vendored
1709
- `tests/config.test.ts` repeats the externals, digest, and `main.cjs` readings in each target that
1710
- plans the barrel.
1796
+ rebuilt. The build emits the single file `dist/app/server/index.js` with `@app/*` and `@src/*`
1797
+ specifiers and relative imports inlined, and `node:` and every installed package specifier left
1798
+ external. It sets `emptyOutDir` to `false`, so `main.cjs` stays byte-identical. A workspace without
1799
+ both conditions plans none of the three. Scaffold's `tests/src/core/templates.test.ts` builds both
1800
+ entries in a staged root, compares the `main.cjs` digest across the barrel step, builds the barrel
1801
+ twice for one `index.js` digest, imports the file in Node, and holds each claim under a control.
1802
+ The vendored `tests/config.test.ts` repeats the externals, digest, and `main.cjs` readings in each
1803
+ target that plans the barrel.
1711
1804
 
1712
1805
  ### The migration guard
1713
1806
 
@@ -2007,8 +2100,10 @@ declaration, a binding that is not an identifier, a barrel statement outside the
2007
2100
  A missing guide root, an empty catalog, a catalog row with no hosted guide, and a hosted guide
2008
2101
  carrying no `Surface` section report one the same way, so a reading the sweep could not complete
2009
2102
  never reports clean. A collision reads
2010
- `surface name belongs to one package: NAME (OWNER)` and carries the declaring path and line, sorted
2011
- by path, line, and message. Which package keeps a claimed name is the answer
2103
+ `surface name belongs to one package: NAME (OWNER)`, then the correction: delete the local declaration
2104
+ and `import { NAME } from "@orkestrel/OWNER"` (or the owner's environment entry that exports it)
2105
+ where the contracts match, and rename only where the local contract differs. It carries the
2106
+ declaring path and line, sorted by path, line, and message. Which package keeps a claimed name is the answer
2012
2107
  `.claude/rules/names.md` § Fleet name ownership gives; the rule carries no allowlist and no
2013
2108
  suppression.
2014
2109
 
@@ -2029,6 +2124,7 @@ set is reachable through a published specifier.
2029
2124
  | `POLICY_SURFACE_HOST` | const | Names the installed host root containing the fleet's reference guides. |
2030
2125
  | `createPolicySurfaceFixture` | function | Creates a scratch target with a complete installed guide population. |
2031
2126
  | `createPolicySurfaceGuide` | function | Creates a guide whose surface claims the supplied fixture names. |
2127
+ | `describeSurfaceCollision` | function | Describes the refusal for a name that two packages claim, with the owner's import. |
2032
2128
  | `inspectPolicySurface` | function | Inspects source and target-owned setup names against the hosted fleet guides. |
2033
2129
  | `readPolicyDeclarations` | function | Locates parsed exports at their physical declaration lines. |
2034
2130
  | `readPolicySurface` | function | Reads reachable source declarations and refuses unread barrel statements or targets. |
@@ -2599,10 +2695,10 @@ Nothing is fixed except the manifest.
2599
2695
  `--ignore-scripts` to `npm pack` so a suite never re-runs the build it already gates.
2600
2696
  - One template artifact per configuration file the selection needs: the root `tsconfig.json` and
2601
2697
  `vite.config.ts`, plus a Vite config and a scoped TypeScript config per selected environment and
2602
- for `bin` when it is set. The root `tsconfig.json` maps the `@src` and `@app` aliases the selection
2698
+ for `bin` when it lists a module. The root `tsconfig.json` maps the `@src` and `@app` aliases the selection
2603
2699
  reaches, and beside them the workspace's own published specifiers — `@orkestrel/<name>` and one
2604
- `@orkestrel/<name>/<environment>` entry per subpath the `exports` map publishes — each to its
2605
- source entry. Without them the workspace's own name resolves through that `exports` map to
2700
+ `@orkestrel/<name>/<environment>` entry per environment subpath the `exports` map publishes —
2701
+ each to its source entry. A `src/bin` module's subpath and each sheet subpath map no entry. Without them the workspace's own name resolves through that `exports` map to
2606
2702
  `dist/`, and `npm run check` would wait on `npm run build`. Every subpath is written before the
2607
2703
  bare specifier, because `vite.config.ts` derives its `alias` record from these entries in order and
2608
2704
  a bare specifier also matches its own subpaths. An `app` environment publishes nothing and maps no
@@ -2739,8 +2835,12 @@ workspace installs, so a publishing workspace declares `@microsoft/api-extractor
2739
2835
  compiler API of its own. The browser and server faces pass `rewriteCoreSpecifier`: the compiler
2740
2836
  emits the `@src/core` specifier unrewritten and the extractor keeps it external, so the rewrite
2741
2837
  replaces it with the workspace's own published name and a consumer of the packed face reaches core
2742
- through the root export the tarball declares. The seeded `bin` config calls no roll-up, because an
2743
- executable ships no declarations.
2838
+ through the root export the tarball declares. The seeded `bin` config rolls up each module its
2839
+ `entries` list names, every `src/bin` module but `main`, because an executable ships no
2840
+ declarations. It passes `rewriteSourceSpecifier`, which replaces each `@src/<environment>` with
2841
+ `../src/<environment>/index.js`, so `dist/bin/<name>.d.ts` reads the environment's declarations at
2842
+ the path `dist/bin/<name>.js` imports. Each roll-up takes its entry's name, so a face ships
2843
+ `index.d.ts` and a `reporter` module ships `reporter.d.ts`.
2744
2844
 
2745
2845
  `planToSummary` reports the tally rather than a number written down here:
2746
2846