@orkestrel/scaffold 0.0.125 → 0.0.127
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/bin/main.js +50 -14
- package/dist/bin/main.js.map +1 -1
- package/dist/host/AGENTS.md +1 -1
- package/dist/host/agents/orchestration.md +5 -4
- package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +1 -1
- package/dist/host/agents/skills/orkestrel-harden/references/methods.md +2 -2
- package/dist/host/agents/skills/orkestrel-journey/SKILL.md +18 -19
- package/dist/host/agents/skills/orkestrel-parallel/references/codex.md +2 -1
- package/dist/host/claude/AGENTS.md +2 -2
- package/dist/host/claude/agents/orkestrel.md +18 -18
- package/dist/host/claude/agents/planner.md +2 -2
- package/dist/host/claude/rules/quality.md +3 -0
- package/dist/host/claude/rules/tests.md +3 -0
- package/dist/host/claude/rules/workspace.md +11 -5
- package/dist/host/codex/agents/planner.toml +2 -2
- package/dist/host/guides/agent.md +285 -161
- package/dist/host/guides/capture.md +123 -123
- package/dist/host/guides/database.md +18 -7
- package/dist/host/guides/ndjson.md +4 -3
- package/dist/host/guides/ollama.md +2 -2
- package/dist/host/guides/program.md +3 -3
- package/dist/host/guides/qualifier.md +1 -1
- package/dist/host/guides/relation.md +71 -31
- package/dist/host/guides/scaffold.md +101 -64
- package/dist/host/guides/study.md +22 -12
- package/dist/host/guides/toolbox.md +9 -2
- package/dist/host/manifest.json +26 -26
- package/dist/host/tests/config.test.ts +24 -6
- package/dist/src/core/index.cjs +134 -79
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.d.cts +30 -7
- package/dist/src/core/index.d.ts +30 -7
- package/dist/src/core/index.js +134 -80
- package/dist/src/core/index.js.map +1 -1
- package/package.json +4 -4
|
@@ -376,7 +376,7 @@ export declare const BIN_OUTPUT_PATH = "dist/bin/main.js";
|
|
|
376
376
|
* fleet pin; every other peer is a floor. `extras` are package-specific
|
|
377
377
|
* development dependencies and may carry any valid npm name.
|
|
378
378
|
* `bin`, `setup`, `guides`, `integration`, `conformance`, `tree`, `service`,
|
|
379
|
-
* `vendors`, `studies`, `global`, `showcase`, `journey`, `styles`, `themes`, and `skills` are structural facts: each is
|
|
379
|
+
* `vendors`, `studies`, `global`, `showcase`, `journey`, `base`, `styles`, `themes`, and `skills` are structural facts: each is
|
|
380
380
|
* set only when the workspace physically ships the directory or exact-case file
|
|
381
381
|
* that defines it, never because of the workspace's name and never because a
|
|
382
382
|
* sibling fact is set.
|
|
@@ -388,6 +388,7 @@ export declare const BIN_OUTPUT_PATH = "dist/bin/main.js";
|
|
|
388
388
|
* `skills` registers the `skills` Vitest project over the mirrored proofs of the skill
|
|
389
389
|
* scripts a workspace ships under each `.agents/skills/<skill>/scripts/` directory, and adds their
|
|
390
390
|
* scoped typecheck.
|
|
391
|
+
* `base` selects the exact-case `app/browser/main.ts` entry of the base browser application.
|
|
391
392
|
* `showcase` projects only a browser `app`. The gate answers an absent browser
|
|
392
393
|
* axis with a non-blocking question, so a caller that set the flag learns it
|
|
393
394
|
* emitted nothing and the compile still completes.
|
|
@@ -435,6 +436,8 @@ export declare interface Blueprint {
|
|
|
435
436
|
readonly global: boolean;
|
|
436
437
|
readonly showcase: boolean;
|
|
437
438
|
readonly journey: boolean;
|
|
439
|
+
/** Selects the exact-case `app/browser/main.ts` entry of the base browser application. */
|
|
440
|
+
readonly base: boolean;
|
|
438
441
|
readonly skills: boolean;
|
|
439
442
|
}
|
|
440
443
|
|
|
@@ -722,9 +725,9 @@ export declare function blueprintToManifestOverrides(blueprint: Blueprint): Read
|
|
|
722
725
|
*
|
|
723
726
|
* @remarks
|
|
724
727
|
* A browser-mode run that discovers a runtime package mid-collection reloads the page, so the
|
|
725
|
-
* list names the test package,
|
|
726
|
-
*
|
|
727
|
-
* otherwise.
|
|
728
|
+
* list names the test package, every Orkestrel runtime package the blueprint declares or peers
|
|
729
|
+
* with, and the `/browser` entry of each one {@link BROWSER_ENTRIES} lists, inline when the
|
|
730
|
+
* line fits the print width and stacked otherwise.
|
|
728
731
|
*
|
|
729
732
|
* @example
|
|
730
733
|
* ```ts
|
|
@@ -898,6 +901,8 @@ export declare function blueprintToRootVite(blueprint: Blueprint): string;
|
|
|
898
901
|
* private workspace therefore omits it and runs a live-service proof from `test`.
|
|
899
902
|
* Study proofs run on demand through `test:studies` in either workspace; no gate
|
|
900
903
|
* or chain runs them.
|
|
904
|
+
* Application and journey suites run on demand in a publishing workspace,
|
|
905
|
+
* outside release gates and chains. A private workspace keeps them in `test`.
|
|
901
906
|
* Integration and conformance stay in `test` because they neither pack nor
|
|
902
907
|
* install the workspace and drive no external service. A conformance run may
|
|
903
908
|
* start a server, but it starts its own and reaches it over loopback, so the run
|
|
@@ -908,7 +913,7 @@ export declare function blueprintToRootVite(blueprint: Blueprint): string;
|
|
|
908
913
|
* either matrix is a rename in both places.
|
|
909
914
|
* A browser application's journey axis adds `journey` (`capture journey`) and `capture`
|
|
910
915
|
* (`capture frames`) beside `test:journey`. The scoped commands take an explicit selection;
|
|
911
|
-
* the whole-suite `test:journey` invocation
|
|
916
|
+
* the whole-suite `test:journey` invocation joins `test` only in a private workspace.
|
|
912
917
|
*
|
|
913
918
|
* @example
|
|
914
919
|
* ```ts
|
|
@@ -1019,7 +1024,8 @@ export declare function blueprintToToolchainHolds(blueprint: Blueprint): Readonl
|
|
|
1019
1024
|
* rewrites, and one carrying skills adds `test:skills`. Publishing adds the pack and publication lifecycle scripts.
|
|
1020
1025
|
* Sheet and framework faces add their check and build scripts, application frameworks add dev scripts,
|
|
1021
1026
|
* and selected showcases and journeys add their mode scripts.
|
|
1022
|
-
* A browser application's journey axis also adds `journey` and `capture
|
|
1027
|
+
* A base browser application's journey axis also adds `journey` and `capture`, and each
|
|
1028
|
+
* app-side browser face adds `journey:<name>` and `capture:<name>`. Their generated
|
|
1023
1029
|
* commands are writable and have no predecessor forms; customized values remain caller-owned.
|
|
1024
1030
|
* Aggregate test scripts and
|
|
1025
1031
|
* maintainer-owned gate chains stay outside the region.
|
|
@@ -1069,6 +1075,23 @@ export declare const BROWSE_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
|
|
|
1069
1075
|
*/
|
|
1070
1076
|
export declare const BROWSE_UPSTREAM: readonly string[];
|
|
1071
1077
|
|
|
1078
|
+
/**
|
|
1079
|
+
* Lists the Orkestrel packages that publish a `/browser` entry, frozen.
|
|
1080
|
+
*
|
|
1081
|
+
* @remarks
|
|
1082
|
+
* A browser test project pre-bundles `<package>/browser` for each declared package listed here,
|
|
1083
|
+
* so a first import mid-run does not reload the page. Each listed package's vendored guide names
|
|
1084
|
+
* its own `/browser` specifier, and the constants test holds the list to the guide mirrors.
|
|
1085
|
+
*
|
|
1086
|
+
* @example
|
|
1087
|
+
* ```ts
|
|
1088
|
+
* import { BROWSER_ENTRIES } from '@orkestrel/scaffold'
|
|
1089
|
+
*
|
|
1090
|
+
* BROWSER_ENTRIES.includes('@orkestrel/router') // true
|
|
1091
|
+
* ```
|
|
1092
|
+
*/
|
|
1093
|
+
export declare const BROWSER_ENTRIES: readonly string[];
|
|
1094
|
+
|
|
1072
1095
|
/** Represents a browser framework and its physically occupied axes. */
|
|
1073
1096
|
export declare interface BrowserExtension {
|
|
1074
1097
|
readonly surface: 'browser';
|
|
@@ -1148,7 +1171,7 @@ export declare const CANON_PATHS: readonly string[];
|
|
|
1148
1171
|
* ```ts
|
|
1149
1172
|
* import { CAPTURE_DEV_DEPENDENCIES } from '@orkestrel/scaffold'
|
|
1150
1173
|
*
|
|
1151
|
-
* CAPTURE_DEV_DEPENDENCIES['@orkestrel/capture'] // '^0.0.
|
|
1174
|
+
* CAPTURE_DEV_DEPENDENCIES['@orkestrel/capture'] // '^0.0.5'
|
|
1152
1175
|
* ```
|
|
1153
1176
|
*/
|
|
1154
1177
|
export declare const CAPTURE_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
|
package/dist/src/core/index.d.ts
CHANGED
|
@@ -376,7 +376,7 @@ export declare const BIN_OUTPUT_PATH = "dist/bin/main.js";
|
|
|
376
376
|
* fleet pin; every other peer is a floor. `extras` are package-specific
|
|
377
377
|
* development dependencies and may carry any valid npm name.
|
|
378
378
|
* `bin`, `setup`, `guides`, `integration`, `conformance`, `tree`, `service`,
|
|
379
|
-
* `vendors`, `studies`, `global`, `showcase`, `journey`, `styles`, `themes`, and `skills` are structural facts: each is
|
|
379
|
+
* `vendors`, `studies`, `global`, `showcase`, `journey`, `base`, `styles`, `themes`, and `skills` are structural facts: each is
|
|
380
380
|
* set only when the workspace physically ships the directory or exact-case file
|
|
381
381
|
* that defines it, never because of the workspace's name and never because a
|
|
382
382
|
* sibling fact is set.
|
|
@@ -388,6 +388,7 @@ export declare const BIN_OUTPUT_PATH = "dist/bin/main.js";
|
|
|
388
388
|
* `skills` registers the `skills` Vitest project over the mirrored proofs of the skill
|
|
389
389
|
* scripts a workspace ships under each `.agents/skills/<skill>/scripts/` directory, and adds their
|
|
390
390
|
* scoped typecheck.
|
|
391
|
+
* `base` selects the exact-case `app/browser/main.ts` entry of the base browser application.
|
|
391
392
|
* `showcase` projects only a browser `app`. The gate answers an absent browser
|
|
392
393
|
* axis with a non-blocking question, so a caller that set the flag learns it
|
|
393
394
|
* emitted nothing and the compile still completes.
|
|
@@ -435,6 +436,8 @@ export declare interface Blueprint {
|
|
|
435
436
|
readonly global: boolean;
|
|
436
437
|
readonly showcase: boolean;
|
|
437
438
|
readonly journey: boolean;
|
|
439
|
+
/** Selects the exact-case `app/browser/main.ts` entry of the base browser application. */
|
|
440
|
+
readonly base: boolean;
|
|
438
441
|
readonly skills: boolean;
|
|
439
442
|
}
|
|
440
443
|
|
|
@@ -722,9 +725,9 @@ export declare function blueprintToManifestOverrides(blueprint: Blueprint): Read
|
|
|
722
725
|
*
|
|
723
726
|
* @remarks
|
|
724
727
|
* A browser-mode run that discovers a runtime package mid-collection reloads the page, so the
|
|
725
|
-
* list names the test package,
|
|
726
|
-
*
|
|
727
|
-
* otherwise.
|
|
728
|
+
* list names the test package, every Orkestrel runtime package the blueprint declares or peers
|
|
729
|
+
* with, and the `/browser` entry of each one {@link BROWSER_ENTRIES} lists, inline when the
|
|
730
|
+
* line fits the print width and stacked otherwise.
|
|
728
731
|
*
|
|
729
732
|
* @example
|
|
730
733
|
* ```ts
|
|
@@ -898,6 +901,8 @@ export declare function blueprintToRootVite(blueprint: Blueprint): string;
|
|
|
898
901
|
* private workspace therefore omits it and runs a live-service proof from `test`.
|
|
899
902
|
* Study proofs run on demand through `test:studies` in either workspace; no gate
|
|
900
903
|
* or chain runs them.
|
|
904
|
+
* Application and journey suites run on demand in a publishing workspace,
|
|
905
|
+
* outside release gates and chains. A private workspace keeps them in `test`.
|
|
901
906
|
* Integration and conformance stay in `test` because they neither pack nor
|
|
902
907
|
* install the workspace and drive no external service. A conformance run may
|
|
903
908
|
* start a server, but it starts its own and reaches it over loopback, so the run
|
|
@@ -908,7 +913,7 @@ export declare function blueprintToRootVite(blueprint: Blueprint): string;
|
|
|
908
913
|
* either matrix is a rename in both places.
|
|
909
914
|
* A browser application's journey axis adds `journey` (`capture journey`) and `capture`
|
|
910
915
|
* (`capture frames`) beside `test:journey`. The scoped commands take an explicit selection;
|
|
911
|
-
* the whole-suite `test:journey` invocation
|
|
916
|
+
* the whole-suite `test:journey` invocation joins `test` only in a private workspace.
|
|
912
917
|
*
|
|
913
918
|
* @example
|
|
914
919
|
* ```ts
|
|
@@ -1019,7 +1024,8 @@ export declare function blueprintToToolchainHolds(blueprint: Blueprint): Readonl
|
|
|
1019
1024
|
* rewrites, and one carrying skills adds `test:skills`. Publishing adds the pack and publication lifecycle scripts.
|
|
1020
1025
|
* Sheet and framework faces add their check and build scripts, application frameworks add dev scripts,
|
|
1021
1026
|
* and selected showcases and journeys add their mode scripts.
|
|
1022
|
-
* A browser application's journey axis also adds `journey` and `capture
|
|
1027
|
+
* A base browser application's journey axis also adds `journey` and `capture`, and each
|
|
1028
|
+
* app-side browser face adds `journey:<name>` and `capture:<name>`. Their generated
|
|
1023
1029
|
* commands are writable and have no predecessor forms; customized values remain caller-owned.
|
|
1024
1030
|
* Aggregate test scripts and
|
|
1025
1031
|
* maintainer-owned gate chains stay outside the region.
|
|
@@ -1069,6 +1075,23 @@ export declare const BROWSE_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
|
|
|
1069
1075
|
*/
|
|
1070
1076
|
export declare const BROWSE_UPSTREAM: readonly string[];
|
|
1071
1077
|
|
|
1078
|
+
/**
|
|
1079
|
+
* Lists the Orkestrel packages that publish a `/browser` entry, frozen.
|
|
1080
|
+
*
|
|
1081
|
+
* @remarks
|
|
1082
|
+
* A browser test project pre-bundles `<package>/browser` for each declared package listed here,
|
|
1083
|
+
* so a first import mid-run does not reload the page. Each listed package's vendored guide names
|
|
1084
|
+
* its own `/browser` specifier, and the constants test holds the list to the guide mirrors.
|
|
1085
|
+
*
|
|
1086
|
+
* @example
|
|
1087
|
+
* ```ts
|
|
1088
|
+
* import { BROWSER_ENTRIES } from '@orkestrel/scaffold'
|
|
1089
|
+
*
|
|
1090
|
+
* BROWSER_ENTRIES.includes('@orkestrel/router') // true
|
|
1091
|
+
* ```
|
|
1092
|
+
*/
|
|
1093
|
+
export declare const BROWSER_ENTRIES: readonly string[];
|
|
1094
|
+
|
|
1072
1095
|
/** Represents a browser framework and its physically occupied axes. */
|
|
1073
1096
|
export declare interface BrowserExtension {
|
|
1074
1097
|
readonly surface: 'browser';
|
|
@@ -1148,7 +1171,7 @@ export declare const CANON_PATHS: readonly string[];
|
|
|
1148
1171
|
* ```ts
|
|
1149
1172
|
* import { CAPTURE_DEV_DEPENDENCIES } from '@orkestrel/scaffold'
|
|
1150
1173
|
*
|
|
1151
|
-
* CAPTURE_DEV_DEPENDENCIES['@orkestrel/capture'] // '^0.0.
|
|
1174
|
+
* CAPTURE_DEV_DEPENDENCIES['@orkestrel/capture'] // '^0.0.5'
|
|
1152
1175
|
* ```
|
|
1153
1176
|
*/
|
|
1154
1177
|
export declare const CAPTURE_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
|