@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.
Files changed (35) hide show
  1. package/dist/bin/main.js +50 -14
  2. package/dist/bin/main.js.map +1 -1
  3. package/dist/host/AGENTS.md +1 -1
  4. package/dist/host/agents/orchestration.md +5 -4
  5. package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +1 -1
  6. package/dist/host/agents/skills/orkestrel-harden/references/methods.md +2 -2
  7. package/dist/host/agents/skills/orkestrel-journey/SKILL.md +18 -19
  8. package/dist/host/agents/skills/orkestrel-parallel/references/codex.md +2 -1
  9. package/dist/host/claude/AGENTS.md +2 -2
  10. package/dist/host/claude/agents/orkestrel.md +18 -18
  11. package/dist/host/claude/agents/planner.md +2 -2
  12. package/dist/host/claude/rules/quality.md +3 -0
  13. package/dist/host/claude/rules/tests.md +3 -0
  14. package/dist/host/claude/rules/workspace.md +11 -5
  15. package/dist/host/codex/agents/planner.toml +2 -2
  16. package/dist/host/guides/agent.md +285 -161
  17. package/dist/host/guides/capture.md +123 -123
  18. package/dist/host/guides/database.md +18 -7
  19. package/dist/host/guides/ndjson.md +4 -3
  20. package/dist/host/guides/ollama.md +2 -2
  21. package/dist/host/guides/program.md +3 -3
  22. package/dist/host/guides/qualifier.md +1 -1
  23. package/dist/host/guides/relation.md +71 -31
  24. package/dist/host/guides/scaffold.md +101 -64
  25. package/dist/host/guides/study.md +22 -12
  26. package/dist/host/guides/toolbox.md +9 -2
  27. package/dist/host/manifest.json +26 -26
  28. package/dist/host/tests/config.test.ts +24 -6
  29. package/dist/src/core/index.cjs +134 -79
  30. package/dist/src/core/index.cjs.map +1 -1
  31. package/dist/src/core/index.d.cts +30 -7
  32. package/dist/src/core/index.d.ts +30 -7
  33. package/dist/src/core/index.js +134 -80
  34. package/dist/src/core/index.js.map +1 -1
  35. 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, its browser entry, and every Orkestrel runtime package the
726
- * blueprint declares or peers with, inline when the line fits the print width and stacked
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 remains in the test chain.
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`. Their generated
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.1'
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>>;
@@ -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, its browser entry, and every Orkestrel runtime package the
726
- * blueprint declares or peers with, inline when the line fits the print width and stacked
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 remains in the test chain.
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`. Their generated
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.1'
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>>;