@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.
- package/dist/agents/skills/orkestrel-dispatch/scripts/bench.js +326 -91
- package/dist/agents/skills/orkestrel-dispatch/scripts/brief.js +110 -14
- package/dist/agents/skills/orkestrel-dispatch/scripts/chain.js +280 -0
- package/dist/agents/skills/orkestrel-dispatch/scripts/cite.js +188 -26
- package/dist/agents/skills/orkestrel-dispatch/scripts/launch.js +142 -43
- package/dist/agents/skills/orkestrel-dispatch/scripts/login.js +240 -62
- package/dist/agents/skills/orkestrel-dispatch/scripts/patch.js +323 -0
- package/dist/agents/skills/orkestrel-dispatch/scripts/result.js +169 -32
- package/dist/agents/skills/orkestrel-dispatch/scripts/sweep.js +290 -69
- package/dist/agents/skills/orkestrel-falsify/scripts/mutate.js +560 -0
- package/dist/agents/skills/orkestrel-harden/scripts/discovery.js +1052 -205
- package/dist/agents/skills/orkestrel-harden/scripts/measure.js +361 -0
- package/dist/agents/skills/orkestrel-harden/scripts/titles.js +455 -80
- package/dist/agents/skills/orkestrel-parallel/scripts/cases.js +327 -0
- package/dist/agents/skills/orkestrel-publish/scripts/compare.js +298 -51
- package/dist/agents/skills/orkestrel-publish/scripts/pins.js +170 -13
- package/dist/agents/skills/orkestrel-publish/scripts/swap.js +956 -191
- package/dist/agents/skills/orkestrel-publish/scripts/wave.js +707 -112
- package/dist/agents/skills/orkestrel-publish/scripts/window.js +235 -41
- package/dist/agents/skills/orkestrel-scout/scripts/map.js +341 -54
- package/dist/agents/templates/brief.md +6 -2
- package/dist/bin/main.js +51 -46
- package/dist/bin/main.js.map +1 -1
- package/dist/host/AGENTS.md +23 -21
- package/dist/host/agents/orchestration.md +85 -54
- package/dist/host/agents/platforms/windows.md +8 -3
- package/dist/host/agents/skills/orkestrel-align/SKILL.md +10 -13
- package/dist/host/agents/skills/orkestrel-align/references/fleet.md +4 -10
- package/dist/host/agents/skills/orkestrel-align/references/integration.md +1 -1
- package/dist/host/agents/skills/orkestrel-build/SKILL.md +16 -48
- package/dist/host/agents/skills/orkestrel-build/agents/openai.yaml +1 -1
- package/dist/host/agents/skills/orkestrel-debrief/SKILL.md +19 -16
- package/dist/host/agents/skills/orkestrel-debrief/agents/openai.yaml +1 -1
- package/dist/host/agents/skills/orkestrel-debrief/references/field-testing.md +15 -28
- package/dist/host/agents/skills/orkestrel-debrief/references/instruction-audit.md +5 -6
- package/dist/host/agents/skills/orkestrel-debrief/references/retention.md +4 -6
- package/dist/host/agents/skills/orkestrel-dispatch/SKILL.md +36 -25
- package/dist/host/agents/skills/orkestrel-dispatch/references/launch.md +4 -5
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/bench.ts +366 -75
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/brief.ts +126 -16
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/chain.ts +323 -0
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/cite.ts +220 -31
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/launch.ts +176 -33
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/login.ts +294 -59
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/patch.ts +401 -0
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/result.ts +199 -34
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/sweep.ts +330 -69
- package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +14 -12
- package/dist/host/agents/skills/orkestrel-falsify/references/brief.md +2 -5
- package/dist/host/agents/skills/orkestrel-falsify/references/reconcile.md +2 -1
- package/dist/host/agents/skills/orkestrel-falsify/scripts/mutate.ts +701 -0
- package/dist/host/agents/skills/orkestrel-harden/SKILL.md +31 -24
- package/dist/host/agents/skills/orkestrel-harden/references/bindings.md +23 -81
- package/dist/host/agents/skills/orkestrel-harden/references/centralization.md +4 -5
- package/dist/host/agents/skills/orkestrel-harden/references/contract.md +2 -0
- package/dist/host/agents/skills/orkestrel-harden/references/document.md +33 -0
- package/dist/host/agents/skills/orkestrel-harden/references/equivalence.md +6 -3
- package/dist/host/agents/skills/orkestrel-harden/references/hardening.md +34 -18
- package/dist/host/agents/skills/orkestrel-harden/references/research.md +2 -0
- package/dist/host/agents/skills/orkestrel-harden/scripts/discovery.ts +1272 -279
- package/dist/host/agents/skills/orkestrel-harden/scripts/measure.ts +425 -0
- package/dist/host/agents/skills/orkestrel-harden/scripts/titles.ts +603 -98
- package/dist/host/agents/skills/orkestrel-journey/SKILL.md +79 -98
- package/dist/host/agents/skills/orkestrel-journey/references/captures.md +54 -17
- package/dist/host/agents/skills/orkestrel-journey/references/decide.md +1 -20
- package/dist/host/agents/skills/orkestrel-journey/references/layer.md +21 -31
- package/dist/host/agents/skills/orkestrel-journey/references/styles.md +1 -1
- package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +33 -29
- package/dist/host/agents/skills/orkestrel-parallel/references/claude.md +15 -13
- package/dist/host/agents/skills/orkestrel-parallel/references/cloud.md +28 -0
- package/dist/host/agents/skills/orkestrel-parallel/references/codex.md +1 -0
- package/dist/host/agents/skills/orkestrel-parallel/references/cursor.md +13 -13
- package/dist/host/agents/skills/orkestrel-parallel/references/t3.md +13 -13
- package/dist/host/agents/skills/orkestrel-parallel/scripts/cases.ts +389 -0
- package/dist/host/agents/skills/orkestrel-polish/SKILL.md +16 -20
- package/dist/host/agents/skills/orkestrel-polish/references/capture-harness.md +16 -26
- package/dist/host/agents/skills/orkestrel-publish/SKILL.md +12 -26
- package/dist/host/agents/skills/orkestrel-publish/agents/openai.yaml +2 -2
- package/dist/host/agents/skills/orkestrel-publish/references/adopt.md +23 -0
- package/dist/host/agents/skills/orkestrel-publish/references/release.md +4 -4
- package/dist/host/agents/skills/orkestrel-publish/references/wave.md +13 -10
- package/dist/host/agents/skills/orkestrel-publish/references/window.md +21 -26
- package/dist/host/agents/skills/orkestrel-publish/scripts/compare.ts +348 -59
- package/dist/host/agents/skills/orkestrel-publish/scripts/pins.ts +202 -22
- package/dist/host/agents/skills/orkestrel-publish/scripts/swap.ts +1061 -191
- package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +812 -140
- package/dist/host/agents/skills/orkestrel-publish/scripts/window.ts +280 -38
- package/dist/host/agents/skills/orkestrel-scout/SKILL.md +3 -3
- package/dist/host/agents/skills/orkestrel-scout/scripts/map.ts +428 -70
- package/dist/host/agents/templates/brief.md +6 -2
- package/dist/host/agents/transports/claude-cli.md +3 -3
- package/dist/host/agents/transports/codex.md +3 -8
- package/dist/host/agents/transports/cursor.md +2 -3
- package/dist/host/claude/AGENTS.md +2 -3
- package/dist/host/claude/agents/analyst.md +3 -3
- package/dist/host/claude/agents/astra.md +4 -4
- package/dist/host/claude/agents/builder.md +4 -3
- package/dist/host/claude/agents/checker.md +1 -1
- package/dist/host/claude/agents/distiller.md +1 -1
- package/dist/host/claude/agents/grok.md +1 -1
- package/dist/host/claude/agents/opus.md +3 -3
- package/dist/host/claude/agents/orkestrel.md +57 -90
- package/dist/host/claude/agents/researcher.md +1 -1
- package/dist/host/claude/agents/reviewer.md +6 -2
- package/dist/host/claude/agents/scout.md +1 -1
- package/dist/host/claude/agents/verifier.md +2 -2
- package/dist/host/claude/rules/application.md +14 -21
- package/dist/host/claude/rules/architecture.md +34 -44
- package/dist/host/claude/rules/browser.md +3 -4
- package/dist/host/claude/rules/campaign.md +3 -2
- package/dist/host/claude/rules/documentation.md +25 -12
- package/dist/host/claude/rules/names.md +9 -4
- package/dist/host/claude/rules/patterns.md +6 -7
- package/dist/host/claude/rules/portability.md +1 -1
- package/dist/host/claude/rules/quality.md +7 -6
- package/dist/host/claude/rules/styles.md +2 -2
- package/dist/host/claude/rules/tests.md +68 -115
- package/dist/host/claude/rules/typescript.md +7 -9
- package/dist/host/claude/rules/workspace.md +27 -26
- package/dist/host/claude/rules/writing.md +2 -5
- package/dist/host/claude/skills/orkestrel-dispatch/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-harden/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-publish/SKILL.md +1 -1
- package/dist/host/claude/skills/orkestrel-scout/SKILL.md +1 -1
- package/dist/host/codex/agents/analyst.toml +9 -3
- package/dist/host/codex/agents/astra.toml +10 -7
- package/dist/host/codex/agents/builder.toml +4 -4
- package/dist/host/codex/agents/opus.toml +6 -6
- package/dist/host/codex/agents/orkestrel.toml +1 -1
- package/dist/host/codex/agents/researcher.toml +2 -2
- package/dist/host/codex/agents/reviewer.toml +2 -2
- package/dist/host/codex/agents/verifier.toml +4 -4
- package/dist/host/codex/config.toml +1 -1
- package/dist/host/configs/helpers.ts +21 -1
- package/dist/host/configs/policy.ts +299 -15
- package/dist/host/cursor/rules/orchestration.mdc +1 -1
- package/dist/host/dotfiles/oxlintrc.json +137 -3
- package/dist/host/guides/agent.md +111 -134
- package/dist/host/guides/capture.md +801 -0
- package/dist/host/guides/probe.md +27 -8
- package/dist/host/guides/scaffold.md +97 -19
- package/dist/host/guides/study.md +534 -440
- package/dist/host/guides/test.md +111 -44
- package/dist/host/manifest.json +170 -244
- package/dist/host/tests/config.test.ts +977 -187
- package/dist/host/tests/policy.test.ts +165 -1
- package/dist/host/tests/setupPolicy.ts +1246 -33
- package/dist/src/core/index.cjs +222 -90
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.d.cts +126 -40
- package/dist/src/core/index.d.ts +126 -40
- package/dist/src/core/index.js +217 -89
- package/dist/src/core/index.js.map +1 -1
- package/dist/src/server/index.cjs +20 -27
- package/dist/src/server/index.cjs.map +1 -1
- package/dist/src/server/index.js +21 -28
- package/dist/src/server/index.js.map +1 -1
- package/package.json +11 -11
- package/dist/agents/skills/orkestrel-dispatch/scripts/helpers.js +0 -283
- package/dist/host/agents/skills/orkestrel-dispatch/references/bench.md +0 -25
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/helpers.ts +0 -333
- package/dist/host/guides/supervisor.md +0 -4890
package/dist/src/core/index.cjs
CHANGED
|
@@ -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.
|
|
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.
|
|
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.
|
|
111
|
-
"@orkestrel/test": "^0.0.
|
|
110
|
+
"@orkestrel/probe": "^0.0.25",
|
|
111
|
+
"@orkestrel/test": "^0.0.30",
|
|
112
112
|
"@types/node": "^24.19.2",
|
|
113
|
-
"@vitest/browser-playwright": "^
|
|
114
|
-
"oxfmt": "^0.
|
|
115
|
-
"oxlint": "^1.
|
|
116
|
-
"playwright": "^1.
|
|
117
|
-
"typescript": "^
|
|
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": "^
|
|
119
|
+
"vitest": "^5.0.5"
|
|
120
120
|
},
|
|
121
121
|
engines: { "node": ">=22.18.0" }
|
|
122
122
|
};
|
|
123
|
-
|
|
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
|
|
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
|
|
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
|
|
451
|
+
* It pairs with {@link CATALOG_START_MARKER}; a file missing either marker is
|
|
453
452
|
* refused rather than rewritten.
|
|
454
453
|
*/
|
|
455
|
-
var
|
|
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
|
|
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
|
-
|
|
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: `//
|
|
1561
|
-
// so this project is isolated in its own gate script,
|
|
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,
|
|
1600
|
-
//
|
|
1601
|
-
//
|
|
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/**/*.
|
|
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 =
|
|
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
|
-
|
|
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;
|
|
4608
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
6433
|
-
if (
|
|
6434
|
-
return `${lines.slice(0,
|
|
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
|
-
|
|
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
|
|
6658
|
-
*
|
|
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
|
|
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
|
|
8498
|
-
const margin =
|
|
8499
|
-
const gap =
|
|
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
|
|
8522
|
-
const level =
|
|
8523
|
-
const separator =
|
|
8524
|
-
const
|
|
8525
|
-
return `${manifest.slice(0, open + 1)}${lines.map((line) => `${separator}${line}`).join(",")}${
|
|
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
|
|
8637
|
-
const level =
|
|
8638
|
-
const emptySeparator =
|
|
8639
|
-
const
|
|
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(",")}${
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
9371
|
+
* const result = compiler.compile(createBlueprint('router', { src: ['core'] }))
|
|
9243
9372
|
*
|
|
9244
|
-
*
|
|
9245
|
-
*
|
|
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
|
|
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
|
|
9312
|
-
if (
|
|
9313
|
-
this.#emitter.emit("compile",
|
|
9314
|
-
return
|
|
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
|
|
9351
|
-
if (
|
|
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:
|
|
9354
|
-
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.
|
|
9521
|
-
exports.
|
|
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;
|