@orkestrel/scaffold 0.0.130 → 0.0.131

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.
@@ -992,22 +992,27 @@ Scaffold writes one part of the manifest rather than advising on it: the writabl
992
992
  and `prepublishOnly`. Each sheet face adds its `check:src:<face>` and `build:src:<face>` scripts.
993
993
  Each occupied framework face adds `check:<axis>:vue` and `build:<axis>:vue`; the application face also adds `dev:vue`.
994
994
  Selected showcase pages add `showcase`, `showcase:<framework>`, `build:showcase`, and `build:showcase:<framework>`; application journeys add `test:journey:<framework>`.
995
+ A workspace that plans the application server barrel adds `build:app:barrel`, which has no
996
+ predecessor form. A workspace with the server application adds `serve:build`, which runs `build`
997
+ before `serve` and accepts `npm run build:app:server && npm run serve` as its generated predecessor.
995
998
  Its `test:src:<face>` script accepts, as its generated predecessor, the command that ran the project
996
999
  without building the face first, and `build:src:styles` accepts the styles-only build as the
997
1000
  predecessor of the chain that builds themes after it. A publishing `test` chain joins the region when
998
1001
  it matches byte for byte the planned chain with the generated `test:app`, `test:journey`, and framework
999
1002
  journey invocations inserted after `test:src`, where that blueprint emitted them before.
1000
1003
  `repair` and `overwrite` remove those helper invocations from that exact predecessor.
1001
- The `test` chain also joins the region as a generated predecessor when it runs fewer steps than
1002
- the planned chain and every step it runs is a planned step in the planned
1003
- order, `repair` and `overwrite` write the planned chain in its place. That write lands only when
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
1004
1007
  every step the planned chain adds runs a script the manifest declares or the region writes. The
1005
1008
  `test:src` and `test:app` aggregates sit outside the region. Only a private workspace's planned
1006
1009
  chain invokes `test:app`. A chain whose planned form adds an
1007
1010
  aggregate the manifest lacks stays with the package, and the `projects` question keeps its remedy.
1008
- `audit` reports this chain write only through the `projects` question, so a planned step that
1011
+ `audit` reports this `test` chain write only through the `projects` question, so a planned step that
1009
1012
  registers no Vitest project, such as `npm run test:guides`, lands on the next `repair` without an
1010
- earlier advisory. A `test` chain running any other step or order stays maintainer-owned, as do the
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
1011
1016
  `check`, `build`, `dev`, `serve`, `format`, `lint`, `clean`, and `copy` gate chains. A
1012
1017
  declared value is overwritten only when it is already the value being written or is a recognized
1013
1018
  generated predecessor. The overwrite happens in place,
@@ -1693,7 +1698,9 @@ A workspace that selects `studies` and the `server` application also builds the
1693
1698
  `app/server/index.ts`, because `@orkestrel/study` loads the package under study as ES modules. The
1694
1699
  `appBarrel` factory, the content-owned `configs/app/vite.barrel.config.ts` wrapper, and the
1695
1700
  `build:app:barrel` script exist only under that condition, and `build:app` runs the script after
1696
- `build:app:server`. The build emits the single file `dist/app/server/index.js` with `@app/*` and
1701
+ `build:app:server`. `serve:build` runs `build` before `serve`, so the barrel, which the server
1702
+ 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
1697
1704
  `@src/*` specifiers and relative imports inlined, and `node:` and every installed package specifier
1698
1705
  left external. It sets `emptyOutDir` to `false`, so `main.cjs` stays byte-identical. A workspace
1699
1706
  without both conditions plans none of the three. Scaffold's `tests/src/core/templates.test.ts` builds both entries in a
@@ -28,7 +28,7 @@
28
28
  "storage": "agents/platforms/windows.md",
29
29
  "destination": ".agents/platforms/windows.md",
30
30
  "executable": false,
31
- "digest": "a0c5593da4d898339208686be0c7adc23f1faca6041c84fa54340b83c81d764f"
31
+ "digest": "c852ff9886b2a2d24b8a0d69efe10f58dac37bd217d676c133048c148b5e877e"
32
32
  },
33
33
  {
34
34
  "storage": "agents/skills/enterprise-bootstrap/SKILL.md",
@@ -448,7 +448,7 @@
448
448
  "storage": "agents/skills/orkestrel-polish/SKILL.md",
449
449
  "destination": ".agents/skills/orkestrel-polish/SKILL.md",
450
450
  "executable": false,
451
- "digest": "33880efd86b950d4d43ada3e556adab33a14be55ad9764cd7abdb2ce0809d763"
451
+ "digest": "bb30bfc7b29d63176e39e345188e5eec45a14921a40671c9d8a4084c2a2e9512"
452
452
  },
453
453
  {
454
454
  "storage": "agents/skills/orkestrel-polish/agents/openai.yaml",
@@ -628,7 +628,7 @@
628
628
  "storage": "claude/agents/orkestrel.md",
629
629
  "destination": ".claude/agents/orkestrel.md",
630
630
  "executable": false,
631
- "digest": "e6f261104a09bb01690031878c76254a83428ce2686b502b4a3d4cedaf4ec938"
631
+ "digest": "74c10351b39d44a2f59609664a42cfdfdcd7cc7e2839ef037e0221be2d04ca86"
632
632
  },
633
633
  {
634
634
  "storage": "claude/agents/planner.md",
@@ -700,7 +700,7 @@
700
700
  "storage": "claude/rules/patterns.md",
701
701
  "destination": ".claude/rules/patterns.md",
702
702
  "executable": false,
703
- "digest": "43920dca62ed88f1f117131f5830085cc709059bdb05ee98d90c807361f1d808"
703
+ "digest": "2ad9c0e6ca3c995fccb1163f52537252b3cc83e2e8ef0ca6365a20811959c942"
704
704
  },
705
705
  {
706
706
  "storage": "claude/rules/portability.md",
@@ -994,7 +994,7 @@
994
994
  "storage": "guides/agent.md",
995
995
  "destination": "guides/agent.md",
996
996
  "executable": false,
997
- "digest": "18ee2db2e6c120f2fbec55642a6230d1b48de5f9b07fa4143f644a3139f159dc"
997
+ "digest": "e254fceecdd111c66193ccaa2ec065ceaaba68a3386a1e4c29000fd02ec69ec9"
998
998
  },
999
999
  {
1000
1000
  "storage": "guides/brief.md",
@@ -1198,7 +1198,7 @@
1198
1198
  "storage": "guides/scaffold.md",
1199
1199
  "destination": "guides/scaffold.md",
1200
1200
  "executable": false,
1201
- "digest": "655087dbab9aa83f336b353ebbc1faf23eeea3454c184cc3292753ae0901555b"
1201
+ "digest": "9e17c6cdf212c440be057a5336983488329bb67bd66f334b85624d8e457c034a"
1202
1202
  },
1203
1203
  {
1204
1204
  "storage": "guides/sea.md",
@@ -1417,5 +1417,5 @@
1417
1417
  "scripts"
1418
1418
  ],
1419
1419
  "surface": [],
1420
- "digest": "330a0fb610a98e81c08d3eec813975d3fd59ee6a22db45d3381df695245e0079"
1420
+ "digest": "76a071e6da224c1cfef62b9e73f4f08e16b7cf91ff8a68b9a2464da95eaed082"
1421
1421
  }
@@ -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.130",
7
+ version: "0.0.131",
8
8
  description: "Scaffold workspaces with commands: new, audit, surface, repair, catalog, and overwrite.",
9
9
  keywords: [
10
10
  "audit",
@@ -1690,7 +1690,8 @@ export function service(override?: UserConfig): UserConfig {
1690
1690
  return mergeOverride(project, override)
1691
1691
  }
1692
1692
  `,
1693
- studies: `// Run these @orkestrel/study proofs on demand with npm run test:studies; no gate or chain runs them.
1693
+ studies: `// Run these @orkestrel/study proofs on demand with npm run test:studies;
1694
+ // no gate or chain runs them.
1694
1695
  export function studies(override?: UserConfig): UserConfig {
1695
1696
  const project: UserConfig = {
1696
1697
  resolve,
@@ -7469,7 +7470,7 @@ function blueprintToScripts(blueprint) {
7469
7470
  ...blueprint.showcase ? Object.fromEntries(application.flatMap((name) => [[`showcase:${name}`, `${showcase} --mode ${name}`], [`build:showcase:${name}`, `${buildShowcase} --mode ${name}`]])) : {},
7470
7471
  ...blueprint.app.includes("server") ? {
7471
7472
  serve: "node dist/app/server/main.cjs",
7472
- "serve:build": "npm run build:app:server && npm run serve"
7473
+ "serve:build": "npm run build && npm run serve"
7473
7474
  } : {},
7474
7475
  ...publishes ? {
7475
7476
  prepack: "npm run build",
@@ -7499,6 +7500,9 @@ function blueprintToScripts(blueprint) {
7499
7500
  * A base browser application's journey axis also adds `journey` and `capture`, and each
7500
7501
  * app-side browser face adds `journey:<name>` and `capture:<name>`. Their generated
7501
7502
  * commands are writable and have no predecessor forms; customized values remain caller-owned.
7503
+ * A workspace that plans the application server barrel adds `build:app:barrel`, which has no
7504
+ * predecessor form. A workspace with the server application adds `serve:build`, which runs `build`
7505
+ * before `serve`, so the barrel and every browser face the server serves are rebuilt.
7502
7506
  * Aggregate test scripts and
7503
7507
  * maintainer-owned gate chains stay outside the region.
7504
7508
  *
@@ -7509,8 +7513,8 @@ function blueprintToScripts(blueprint) {
7509
7513
  * existed. The pack hook accepts the build chain emitted before it
7510
7514
  * delegated to `build`. The publication hook accepts the same gate chain without
7511
7515
  * {@link RELEASE_PROOF_COMMAND}. No accepted publication chain carries a study
7512
- * step. The value being written is always writable, so
7513
- * it is not repeated there. Any other value is a script the workspace author
7516
+ * step. `serve:build` accepts the server-only chain it ran before it delegated to
7517
+ * `build`. The value being written is always writable, so it is not repeated there. Any other value is a script the workspace author
7514
7518
  * customized, and {@link replaceManifestScripts} retains it while writing the
7515
7519
  * other named scripts independently.
7516
7520
  *
@@ -7531,11 +7535,14 @@ function blueprintToWritableScripts(blueprint) {
7531
7535
  const sheet = sheets.some((face) => name === `build:src:${face}` || name === `check:src:${face}`);
7532
7536
  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}` || name === `journey:${extension.name}` || name === `capture:${extension.name}`)));
7533
7537
  const showcase = name === "showcase" || name.startsWith("showcase:") || name === "build:showcase" || name.startsWith("build:showcase:");
7534
- if (!direct && !sheet && !framework && !showcase && !(name === "journey" || name === "capture")) return [];
7538
+ const capture = name === "journey" || name === "capture";
7539
+ const barrel = matchesBarrel(blueprint) && name === "build:app:barrel";
7540
+ const served = blueprint.app.includes("server") && name === "serve:build";
7541
+ if (!direct && !sheet && !framework && !showcase && !capture && !barrel && !served) return [];
7535
7542
  return [{
7536
7543
  name,
7537
7544
  command,
7538
- 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)] : []
7545
+ 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)] : name === "serve:build" ? ["npm run build:app:server && npm run serve"] : []
7539
7546
  }];
7540
7547
  });
7541
7548
  const prepack = scripts.prepack;