@orkestrel/scaffold 0.0.143 → 0.0.145

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/agents/skills/orkestrel-publish/scripts/swap.js +111 -5
  2. package/dist/agents/templates/brief.md +1 -0
  3. package/dist/bin/main.js +87 -30
  4. package/dist/bin/main.js.map +1 -1
  5. package/dist/host/agents/platforms/windows.md +1 -0
  6. package/dist/host/agents/skills/orkestrel-publish/references/release.md +1 -0
  7. package/dist/host/agents/skills/orkestrel-publish/scripts/swap.ts +133 -6
  8. package/dist/host/agents/templates/brief.md +1 -0
  9. package/dist/host/claude/agents/orkestrel.md +52 -52
  10. package/dist/host/claude/rules/documentation.md +1 -0
  11. package/dist/host/claude/rules/quality.md +1 -0
  12. package/dist/host/claude/rules/tests.md +1 -0
  13. package/dist/host/claude/rules/workspace.md +14 -13
  14. package/dist/host/dotfiles/oxlintrc.json +1 -1
  15. package/dist/host/guides/browser.md +1 -1
  16. package/dist/host/guides/codec.md +29 -12
  17. package/dist/host/guides/contract.md +58 -57
  18. package/dist/host/guides/scaffold.md +63 -43
  19. package/dist/host/guides/server.md +1 -1
  20. package/dist/host/manifest.json +18 -18
  21. package/dist/host/scripts/browsers.sh +0 -0
  22. package/dist/host/scripts/codex.sh +0 -0
  23. package/dist/host/scripts/cursor.sh +0 -0
  24. package/dist/host/scripts/deps.sh +0 -0
  25. package/dist/host/scripts/npm.sh +0 -0
  26. package/dist/host/scripts/ollama.sh +0 -0
  27. package/dist/host/tests/config.test.ts +5 -0
  28. package/dist/host/tests/setupPolicy.ts +1 -0
  29. package/dist/src/core/index.cjs +64 -24
  30. package/dist/src/core/index.cjs.map +1 -1
  31. package/dist/src/core/index.d.cts +17 -2
  32. package/dist/src/core/index.d.ts +17 -2
  33. package/dist/src/core/index.js +64 -25
  34. package/dist/src/core/index.js.map +1 -1
  35. package/package.json +13 -13
@@ -243,6 +243,7 @@ export declare interface ArtifactTemplateSet {
243
243
  readonly module: string;
244
244
  readonly proof: string;
245
245
  };
246
+ readonly isolation: string;
246
247
  readonly entry: string;
247
248
  readonly bin: string;
248
249
  readonly distribution: {
@@ -380,7 +381,7 @@ export declare const BIN_OUTPUT_PATH = "dist/bin/main.js";
380
381
  * fleet pin; every other peer is a floor. `extras` are package-specific
381
382
  * development dependencies and may carry any valid npm name.
382
383
  * `bin`, `setup`, `guides`, `integration`, `conformance`, `tree`, `service`,
383
- * `vendors`, `studies`, `global`, `showcase`, `journey`, `base`, `styles`, `themes`, and `skills` are structural facts: each is
384
+ * `vendors`, `studies`, `global`, `isolation`, `showcase`, `journey`, `base`, `styles`, `themes`, and `skills` are structural facts: each is
384
385
  * set only when the workspace physically ships the directory or exact-case file
385
386
  * that defines it, never because of the workspace's name and never because a
386
387
  * sibling fact is set.
@@ -414,6 +415,12 @@ export declare const BIN_OUTPUT_PATH = "dist/bin/main.js";
414
415
  * directory, which Vitest's default exclude never collects, and it alone registers
415
416
  * the `studies` Vitest project over that directory. The harness module the study tests import,
416
417
  * `tests/setupStudy.ts`, selects nothing and is not planned.
418
+ *
419
+ * `isolation` says the workspace holds the exact-case `tests/setupIsolation.ts` guard. It gives
420
+ * the `src:browser` and `app:browser` projects the `Cross-Origin-Opener-Policy: same-origin` and
421
+ * `Cross-Origin-Embedder-Policy: require-corp` response headers and appends the guard to their
422
+ * setup files, so a test page is cross-origin isolated. The gate answers an absent
423
+ * `src:browser` and `app:browser` environment with a non-blocking question.
417
424
  */
418
425
  export declare interface Blueprint {
419
426
  readonly name: string;
@@ -443,6 +450,7 @@ export declare interface Blueprint {
443
450
  readonly vendors: readonly string[];
444
451
  readonly studies: boolean;
445
452
  readonly global: boolean;
453
+ readonly isolation: boolean;
446
454
  readonly showcase: boolean;
447
455
  readonly journey: boolean;
448
456
  /** Selects the exact-case `app/browser/main.ts` entry of the base browser application. */
@@ -1763,6 +1771,7 @@ export declare class Compiler implements CompilerInterface {
1763
1771
  readonly root: {
1764
1772
  readonly tsconfig: string;
1765
1773
  readonly vite: string;
1774
+ readonly isolation: string;
1766
1775
  };
1767
1776
  readonly factories: {
1768
1777
  readonly sheet: string;
@@ -2795,6 +2804,9 @@ export declare class Compiler implements CompilerInterface {
2795
2804
  */
2796
2805
  export declare const isMirror: Guard<Mirror>;
2797
2806
 
2807
+ /** Names the browser-isolation guard module whose presence makes a workspace `isolation`. */
2808
+ export declare const ISOLATION_SETUP_PATH = "tests/setupIsolation.ts";
2809
+
2798
2810
  /**
2799
2811
  * Narrows a value to an {@link Override}.
2800
2812
  *
@@ -4020,7 +4032,10 @@ export declare class Compiler implements CompilerInterface {
4020
4032
  * `range` is the declared range, and `latest` is the version the producer
4021
4033
  * selected. A found lookup carries that selected version; one that produced no
4022
4034
  * answer carries the cause and no selected version. `major`, when present, is
4023
- * the stable major named by the registry's `latest` tag in the same answer.
4035
+ * the stable major named by the registry's `latest` tag in the same answer. A
4036
+ * `missing` lookup on an `@orkestrel` package means the registry answered 404, or
4037
+ * the organization catalog does not list the package, and `repair`, `overwrite`,
4038
+ * and `catalog` keep its declared range.
4024
4039
  */
4025
4040
  export declare type Release = {
4026
4041
  readonly name: string;
@@ -243,6 +243,7 @@ export declare interface ArtifactTemplateSet {
243
243
  readonly module: string;
244
244
  readonly proof: string;
245
245
  };
246
+ readonly isolation: string;
246
247
  readonly entry: string;
247
248
  readonly bin: string;
248
249
  readonly distribution: {
@@ -380,7 +381,7 @@ export declare const BIN_OUTPUT_PATH = "dist/bin/main.js";
380
381
  * fleet pin; every other peer is a floor. `extras` are package-specific
381
382
  * development dependencies and may carry any valid npm name.
382
383
  * `bin`, `setup`, `guides`, `integration`, `conformance`, `tree`, `service`,
383
- * `vendors`, `studies`, `global`, `showcase`, `journey`, `base`, `styles`, `themes`, and `skills` are structural facts: each is
384
+ * `vendors`, `studies`, `global`, `isolation`, `showcase`, `journey`, `base`, `styles`, `themes`, and `skills` are structural facts: each is
384
385
  * set only when the workspace physically ships the directory or exact-case file
385
386
  * that defines it, never because of the workspace's name and never because a
386
387
  * sibling fact is set.
@@ -414,6 +415,12 @@ export declare const BIN_OUTPUT_PATH = "dist/bin/main.js";
414
415
  * directory, which Vitest's default exclude never collects, and it alone registers
415
416
  * the `studies` Vitest project over that directory. The harness module the study tests import,
416
417
  * `tests/setupStudy.ts`, selects nothing and is not planned.
418
+ *
419
+ * `isolation` says the workspace holds the exact-case `tests/setupIsolation.ts` guard. It gives
420
+ * the `src:browser` and `app:browser` projects the `Cross-Origin-Opener-Policy: same-origin` and
421
+ * `Cross-Origin-Embedder-Policy: require-corp` response headers and appends the guard to their
422
+ * setup files, so a test page is cross-origin isolated. The gate answers an absent
423
+ * `src:browser` and `app:browser` environment with a non-blocking question.
417
424
  */
418
425
  export declare interface Blueprint {
419
426
  readonly name: string;
@@ -443,6 +450,7 @@ export declare interface Blueprint {
443
450
  readonly vendors: readonly string[];
444
451
  readonly studies: boolean;
445
452
  readonly global: boolean;
453
+ readonly isolation: boolean;
446
454
  readonly showcase: boolean;
447
455
  readonly journey: boolean;
448
456
  /** Selects the exact-case `app/browser/main.ts` entry of the base browser application. */
@@ -1763,6 +1771,7 @@ export declare class Compiler implements CompilerInterface {
1763
1771
  readonly root: {
1764
1772
  readonly tsconfig: string;
1765
1773
  readonly vite: string;
1774
+ readonly isolation: string;
1766
1775
  };
1767
1776
  readonly factories: {
1768
1777
  readonly sheet: string;
@@ -2795,6 +2804,9 @@ export declare class Compiler implements CompilerInterface {
2795
2804
  */
2796
2805
  export declare const isMirror: Guard<Mirror>;
2797
2806
 
2807
+ /** Names the browser-isolation guard module whose presence makes a workspace `isolation`. */
2808
+ export declare const ISOLATION_SETUP_PATH = "tests/setupIsolation.ts";
2809
+
2798
2810
  /**
2799
2811
  * Narrows a value to an {@link Override}.
2800
2812
  *
@@ -4020,7 +4032,10 @@ export declare class Compiler implements CompilerInterface {
4020
4032
  * `range` is the declared range, and `latest` is the version the producer
4021
4033
  * selected. A found lookup carries that selected version; one that produced no
4022
4034
  * answer carries the cause and no selected version. `major`, when present, is
4023
- * the stable major named by the registry's `latest` tag in the same answer.
4035
+ * the stable major named by the registry's `latest` tag in the same answer. A
4036
+ * `missing` lookup on an `@orkestrel` package means the registry answered 404, or
4037
+ * the organization catalog does not list the package, and `repair`, `overwrite`,
4038
+ * and `catalog` keep its declared range.
4024
4039
  */
4025
4040
  export declare type Release = {
4026
4041
  readonly name: string;
@@ -3,7 +3,7 @@ import { fillTemplate } from "@orkestrel/template";
3
3
  import { Emitter } from "@orkestrel/emitter";
4
4
  var package_default = {
5
5
  name: "@orkestrel/scaffold",
6
- version: "0.0.143",
6
+ version: "0.0.145",
7
7
  description: "Scaffold workspaces with commands: new, audit, surface, repair, catalog, and overwrite.",
8
8
  keywords: [
9
9
  "audit",
@@ -95,20 +95,20 @@ var package_default = {
95
95
  "prepublishOnly": "npm run format:check && npm run lint:check && npm run check && npm run build && npm test && npm run test:templates && npm run test:distribution -- --mode release"
96
96
  },
97
97
  dependencies: {
98
- "@orkestrel/console": "^0.0.22",
99
- "@orkestrel/contract": "^0.0.26",
100
- "@orkestrel/emitter": "^0.0.18",
101
- "@orkestrel/markdown": "^0.0.23",
102
- "@orkestrel/process": "^0.0.22",
103
- "@orkestrel/template": "^0.0.16"
98
+ "@orkestrel/console": "^0.0.23",
99
+ "@orkestrel/contract": "^0.0.27",
100
+ "@orkestrel/emitter": "^0.0.19",
101
+ "@orkestrel/markdown": "^0.0.24",
102
+ "@orkestrel/process": "^0.0.23",
103
+ "@orkestrel/template": "^0.0.17"
104
104
  },
105
105
  devDependencies: {
106
106
  "@microsoft/api-extractor": "^7.60.1",
107
- "@orkestrel/browser": "^0.0.35",
108
- "@orkestrel/guide": "^0.0.33",
109
- "@orkestrel/html": "^0.0.18",
110
- "@orkestrel/probe": "^0.0.32",
111
- "@orkestrel/test": "^0.0.44",
107
+ "@orkestrel/browser": "^0.0.36",
108
+ "@orkestrel/guide": "^0.0.34",
109
+ "@orkestrel/html": "^0.0.19",
110
+ "@orkestrel/probe": "^0.0.33",
111
+ "@orkestrel/test": "^0.0.45",
112
112
  "@types/node": "^24.19.2",
113
113
  "@vitest/browser-playwright": "^5.1.0",
114
114
  "oxfmt": "^0.79.0",
@@ -116,7 +116,7 @@ var package_default = {
116
116
  "playwright": "^1.64.1",
117
117
  "typescript": "^7.0.2",
118
118
  "vite": "^8.3.8",
119
- "vitest": "^5.1.0"
119
+ "vitest": "^5.1.1"
120
120
  },
121
121
  engines: { "node": ">=22.18.0" }
122
122
  };
@@ -514,6 +514,8 @@ var TARGET_SKILL_NAMES = Object.freeze([
514
514
  var SERVICE_SCRIPT_PATH = "scripts/service.sh";
515
515
  /** Names the shared Vitest global-setup module whose presence makes a workspace `global`. */
516
516
  var GLOBAL_SETUP_PATH = "tests/setupGlobal.ts";
517
+ /** Names the browser-isolation guard module whose presence makes a workspace `isolation`. */
518
+ var ISOLATION_SETUP_PATH = "tests/setupIsolation.ts";
517
519
  /** Names the package-owned guide-parity entry used by `test:guides` and to select the `guides` project. */
518
520
  var GUIDES_TEST_PATH = "tests/guides.test.ts";
519
521
  /** Names the generated packed-package proof every publishing workspace is planned at. */
@@ -901,9 +903,9 @@ var SHOWCASE_OVERRIDES = Object.freeze({ [`vite-plugin-singlefile@${SHOWCASE_DEV
901
903
  /** Lists the development dependencies a private server application adds. */
902
904
  var APP_SERVER_DEV_DEPENDENCIES = Object.freeze({
903
905
  "@orkestrel/emitter": package_default.dependencies["@orkestrel/emitter"],
904
- "@orkestrel/middleware": "^0.0.36",
905
- "@orkestrel/router": "^0.0.24",
906
- "@orkestrel/server": "^0.0.30"
906
+ "@orkestrel/middleware": "^0.0.37",
907
+ "@orkestrel/router": "^0.0.25",
908
+ "@orkestrel/server": "^0.0.31"
907
909
  });
908
910
  // src/core/templates.ts
909
911
  /**
@@ -1094,6 +1096,13 @@ function isNamedPlugin(plugin: PluginOption): plugin is { name: string } {
1094
1096
  {{projects}}
1095
1097
  },
1096
1098
  })
1099
+ `,
1100
+ isolation: `// A cross-origin isolated page reads SharedArrayBuffer.\n// srcBrowser and appBrowser, and the projects and servers that spread them, serve these headers.
1101
+ export const isolation = {
1102
+ 'Cross-Origin-Opener-Policy': 'same-origin',
1103
+ 'Cross-Origin-Embedder-Policy': 'require-corp',
1104
+ }
1105
+
1097
1106
  `
1098
1107
  }),
1099
1108
  factories: Object.freeze({
@@ -1198,7 +1207,7 @@ export function srcBrowser(override?: UserConfig): UserConfig {
1198
1207
  resolve,
1199
1208
  optimizeDeps,
1200
1209
  publicDir: false,
1201
- plugins: [outputBoundary('dist/src/browser'), environmentBoundary('src/browser'){{vuePlugin}}],
1210
+ {{headers}} plugins: [outputBoundary('dist/src/browser'), environmentBoundary('src/browser'){{vuePlugin}}],
1202
1211
  build: {
1203
1212
  emptyOutDir: true,
1204
1213
  sourcemap: true,
@@ -1218,7 +1227,7 @@ export function srcBrowser(override?: UserConfig): UserConfig {
1218
1227
  test: {
1219
1228
  name: { label: 'src:browser', color: 'yellow' },
1220
1229
  include: ['tests/src/browser/**/*.test.ts'],
1221
- {{exclude}} setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'],
1230
+ {{exclude}} setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'{{isolation}}],
1222
1231
  {{global}}
1223
1232
  browser: {
1224
1233
  enabled: true,
@@ -1341,7 +1350,7 @@ export function srcBin(override?: UserConfig): UserConfig {
1341
1350
  const project: UserConfig = {
1342
1351
  resolve,
1343
1352
  optimizeDeps,
1344
- plugins: [outputBoundary(output), environmentBoundary('app/browser'){{vuePlugin}}],
1353
+ {{headers}} plugins: [outputBoundary(output), environmentBoundary('app/browser'){{vuePlugin}}],
1345
1354
  root: resolveWorkspacePath('app/browser'),
1346
1355
  publicDir: false,
1347
1356
  build: {
@@ -1358,7 +1367,7 @@ export function srcBin(override?: UserConfig): UserConfig {
1358
1367
  root: resolveWorkspacePath('.'),
1359
1368
  dir: resolveWorkspacePath('.'),
1360
1369
  include: ['tests/app/browser/**/*.test.ts'],
1361
- {{journeyExclude}} setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'],
1370
+ {{journeyExclude}} setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'{{isolation}}],
1362
1371
  browser: {
1363
1372
  enabled: true,
1364
1373
  provider: playwright(browserOptions),
@@ -2855,6 +2864,12 @@ describe('global setup', () => {
2855
2864
  })
2856
2865
  `
2857
2866
  }),
2867
+ isolation: `if (!globalThis.crossOriginIsolated) {
2868
+ throw new Error(
2869
+ 'The tester page is not cross-origin isolated: src:browser and app:browser must serve Cross-Origin-Opener-Policy: same-origin and Cross-Origin-Embedder-Policy: require-corp.',
2870
+ )
2871
+ }
2872
+ `,
2858
2873
  entry: `import * as entry from {{specifier}}
2859
2874
  import { describe, expect, it } from 'vitest'
2860
2875
 
@@ -5411,6 +5426,7 @@ var isBlueprint = recordOf({
5411
5426
  vendors: andOf(isCollection, arrayOf(isString)),
5412
5427
  studies: isBoolean,
5413
5428
  global: isBoolean,
5429
+ isolation: isBoolean,
5414
5430
  showcase: isBoolean,
5415
5431
  journey: isBoolean,
5416
5432
  base: isBoolean,
@@ -8206,6 +8222,9 @@ function blueprintToRootVite(blueprint) {
8206
8222
  const sheets = blueprintToSheets(blueprint);
8207
8223
  const styled = sheets.length > 0 || blueprint.themes;
8208
8224
  const global = blueprint.global ? " globalSetup: ['./tests/setupGlobal.ts'],\n" : "";
8225
+ const isolated = blueprint.isolation && (planned.has("src:browser") || planned.has("app:browser"));
8226
+ const headers = isolated ? " server: { headers: isolation },\n" : "";
8227
+ const guard = isolated ? ", './tests/setupIsolation.ts'" : "";
8209
8228
  const imports = [
8210
8229
  ...styled || machinery.showcase ? [`import { ${[...styled ? ["existsSync"] : [], ...machinery.showcase ? ["renameSync"] : []].join(", ")} } from 'node:fs'`] : [],
8211
8230
  ...machinery.browser ? ["import { playwright } from '@vitest/browser-playwright'"] : [],
@@ -8237,7 +8256,9 @@ function blueprintToRootVite(blueprint) {
8237
8256
  vuePlugin: machinery.frameworks.includes("vue") ? ", vue()" : "",
8238
8257
  output: core ? " output: { paths: { '@src/core': '../core/index.js' } }," : " output: {},",
8239
8258
  exclude: core ? " exclude: ['tests/src/core/**/*.test.ts'],\n" : "",
8240
- global
8259
+ global,
8260
+ headers,
8261
+ isolation: guard
8241
8262
  })) : [],
8242
8263
  ...planned.has("src:server") ? [blueprint.src.includes("core")].map((core) => fillTemplate(CONFIG_TEMPLATES.factories.src.server, {
8243
8264
  external,
@@ -8260,6 +8281,8 @@ function blueprintToRootVite(blueprint) {
8260
8281
  ...planned.has("app:core") ? [CONFIG_TEMPLATES.factories.app.core] : [],
8261
8282
  ...planned.has("app:browser") ? [fillTemplate(CONFIG_TEMPLATES.factories.app.browser, {
8262
8283
  vuePlugin: machinery.frameworks.includes("vue") ? ", vue()" : "",
8284
+ headers,
8285
+ isolation: guard,
8263
8286
  showcaseFactory: machinery.showcase ? CONFIG_TEMPLATES.factories.app.showcase : "",
8264
8287
  journeyFactory: journeyed ? CONFIG_TEMPLATES.factories.app.journey : "",
8265
8288
  journeyExclude: blueprint.journey && base ? " exclude: ['tests/app/browser/integration.test.ts'],\n" : ""
@@ -8338,7 +8361,7 @@ ${projects.map((project) => `\t\t\t${project},`).join("\n")}
8338
8361
  vitest: benches.length === 0 ? "" : "defaultExclude, ",
8339
8362
  helpers: helpers.length === 0 ? "" : matchesPrintWidth(helperImport.trimEnd()) ? helperImport : `import {\n${helpers.map((helper) => `\t${helper},`).join("\n")}\n} from './configs/helpers.js'\n`,
8340
8363
  browsers: machinery.browser ? "import { resolveBrowser, resolvePinnedBrowser } from './configs/browsers.js'\nimport { commands } from './configs/commands.js'\n" : "",
8341
- options: (machinery.browser ? "const browserOptions = resolveBrowser(resolvePinnedBrowser(), process.platform, process.env)\n// Vitest writes a page.screenshot() capture beside its test file unless a directory is named.\nconst screenshots = resolveWorkspacePath('tmp/captures/screenshots')\n\n" + blueprintToOptimizedDependencies(blueprint) : "") + ((blueprint.journey || blueprint.showcase) && (base || applicationFaces.length > 0) ? `const applications = {\n${base ? " browser: appBrowser,\n" : ""}${applicationFaces.map((extension) => `\t${extension.name}: app${extension.name[0]?.toUpperCase()}${extension.name.slice(1)},\n`).join("")}}\n\n` : ""),
8364
+ options: (machinery.browser ? "const browserOptions = resolveBrowser(resolvePinnedBrowser(), process.platform, process.env)\n// Vitest writes a page.screenshot() capture beside its test file unless a directory is named.\nconst screenshots = resolveWorkspacePath('tmp/captures/screenshots')\n\n" + blueprintToOptimizedDependencies(blueprint) + (isolated ? CONFIG_TEMPLATES.root.isolation : "") : "") + ((blueprint.journey || blueprint.showcase) && (base || applicationFaces.length > 0) ? `const applications = {\n${base ? " browser: appBrowser,\n" : ""}${applicationFaces.map((extension) => `\t${extension.name}: app${extension.name[0]?.toUpperCase()}${extension.name.slice(1)},\n`).join("")}}\n\n` : ""),
8342
8365
  factories: body,
8343
8366
  projects: projectRows
8344
8367
  });
@@ -8453,7 +8476,8 @@ ${paths.join("\n")}
8453
8476
  ...blueprint.app.includes("core") ? includeSuffixes.map((suffix) => `../../app/core/**/*.${suffix}`) : [],
8454
8477
  ...includeSuffixes.map((suffix) => `../../tests/app/browser/**/*.${suffix}`),
8455
8478
  "../../tests/setup.ts",
8456
- "../../tests/setupBrowser.ts"
8479
+ "../../tests/setupBrowser.ts",
8480
+ ...blueprint.isolation ? ["../../tests/setupIsolation.ts"] : []
8457
8481
  ].map((entry, index, entries) => `\t\t${JSON.stringify(entry)}${index === entries.length - 1 ? "" : ","}`).join("\n") }) : path === "configs/app/vite.server.config.ts" ? CONFIG_TEMPLATES.vites.app.server : path === "configs/app/tsconfig.server.json" ? fillTemplate(CONFIG_TEMPLATES.tsconfigs.app.server, { include: [
8458
8482
  ...includeSuffixes.map((suffix) => `../../app/server/**/*.${suffix}`),
8459
8483
  ...blueprint.app.includes("core") ? includeSuffixes.map((suffix) => `../../app/core/**/*.${suffix}`) : [],
@@ -8485,7 +8509,8 @@ ${paths.join("\n")}
8485
8509
  ...FRAMEWORK_MATRIX[extension.name].suffixes
8486
8510
  ].map((suffix) => `../../tests/app/${extension.name}/**/*.${suffix}`),
8487
8511
  "../../tests/setup.ts",
8488
- "../../tests/setupBrowser.ts"
8512
+ "../../tests/setupBrowser.ts",
8513
+ ...blueprint.isolation ? ["../../tests/setupIsolation.ts"] : []
8489
8514
  ];
8490
8515
  const siblings = blueprint.src.filter((environment) => environment === "core" || environment === "browser").flatMap((environment) => ["ts", "js"].map((suffix) => {
8491
8516
  const key = `\t[resolveWorkspacePath('src/${environment}/index.${suffix}').replaceAll('\\\\', '/')]:`;
@@ -8782,6 +8807,13 @@ function blueprintToTestArtifacts(blueprint) {
8782
8807
  origin: "template",
8783
8808
  content: ARTIFACT_TEMPLATES.tests.setup
8784
8809
  }] : [];
8810
+ const isolations = blueprint.isolation ? [{
8811
+ path: ISOLATION_SETUP_PATH,
8812
+ group: "tests",
8813
+ ownership: "birth",
8814
+ origin: "template",
8815
+ content: ARTIFACT_TEMPLATES.tests.isolation
8816
+ }] : [];
8785
8817
  const globals = blueprint.global ? [{
8786
8818
  path: GLOBAL_SETUP_PATH,
8787
8819
  group: "tests",
@@ -8890,6 +8922,7 @@ function blueprintToTestArtifacts(blueprint) {
8890
8922
  ...servers,
8891
8923
  ...services,
8892
8924
  ...globals,
8925
+ ...isolations,
8893
8926
  ...journeys,
8894
8927
  ...sources,
8895
8928
  ...bins,
@@ -10034,6 +10067,11 @@ function blueprintToQuestions(blueprint) {
10034
10067
  message: "showcase projects a browser app, and this workspace declares none, so it emits nothing.",
10035
10068
  blocking: false
10036
10069
  }] : [],
10070
+ ...blueprint.isolation && !blueprint.src.includes("browser") && !blueprint.app.includes("browser") ? [{
10071
+ field: "isolation",
10072
+ message: "isolation serves the src:browser and app:browser projects, and this workspace declares neither, so it emits no headers.",
10073
+ blocking: false
10074
+ }] : [],
10037
10075
  ...blueprint.journey && (!blueprint.app.includes("browser") || !blueprint.base && blueprint.extensions.every((extension) => extension.surface !== "browser" || !extension.axes.includes("app"))) ? [{
10038
10076
  field: "journey",
10039
10077
  message: blueprint.app.includes("browser") ? "journey projects a browser application, and this workspace declares neither a base entry nor an app-side browser face, so it emits nothing." : "journey projects a browser app, and this workspace declares none, so it emits nothing.",
@@ -10242,6 +10280,7 @@ function createBlueprint(name, input) {
10242
10280
  vendors: input?.vendors ?? [],
10243
10281
  studies: input?.studies ?? false,
10244
10282
  global: input?.global ?? false,
10283
+ isolation: input?.isolation ?? false,
10245
10284
  showcase: input?.showcase ?? false,
10246
10285
  journey: input?.journey ?? false,
10247
10286
  base: input?.base ?? input?.app?.includes("browser") ?? false,
@@ -10550,6 +10589,6 @@ var Compiler = class {
10550
10589
  return error;
10551
10590
  }
10552
10591
  };
10553
- export { APP_BROWSER_DEV_DEPENDENCIES, APP_MATRIX, APP_SERVER_DEV_DEPENDENCIES, ARTIFACT_GROUPS, ARTIFACT_TEMPLATES, AXES, BARREL_CONFIGS, BASE_DEV_DEPENDENCIES, BIN_CONFIGS, BIN_ENTRY_PATH, BIN_MODULE_PATTERN, BIN_OUTPUT_PATH, BROWSER_ENTRIES, BROWSE_DEV_DEPENDENCIES, BROWSE_UPSTREAM, CANON_PATHS, CAPTURE_DEV_DEPENDENCIES, CAPTURE_UPSTREAM, CATALOG_AGENT_PATH, CATALOG_END_MARKER, CATALOG_START_MARKER, CENTRAL_FILE_NAMES, CONFIG_TEMPLATES, CONFORMANCE_TEST_PATH, CONTROL_CHARACTER_PATTERN, Compiler, DECLARATION_DEV_DEPENDENCIES, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, DISTRIBUTION_SETUP_PATH, DISTRIBUTION_TEST_PATH, ENGINES_PATTERN, ENVIRONMENTS, EXECUTABLE_PATHS, EXTRA_RANGE_PATTERN, FLOOR_RANGE_PATTERN, FOREIGN_NAME_PATTERN, FRAMEWORKS, FRAMEWORK_MATRIX, GLOBAL_SETUP_PATH, GUIDES_TEST_PATH, HEX_PATTERN, HOST_INVENTORY_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, INVALID_PATH_CHARACTER_PATTERN, JOURNEY_CONFIG_PATH, MANIFEST_KEY_ORDER, MANIFEST_PATH, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_AUDIT_FINDINGS, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_NAME_LENGTH, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_REGISTRY_BYTES, MAX_SCRIPT_LENGTH, MAX_TOTAL_ARTIFACT_BYTES, MAX_TOTAL_REGISTRY_BYTES, MINIMUM_NODE_VERSION, MINIMUM_NPM_VERSION, NAME_PATTERN, ORCHESTRATION_PATH_NAMES, ORCHESTRATION_PATH_PREFIXES, ORKESTREL_RANGE_PATTERN, PRINT_WIDTH, REFERENCE_PATHS, RELEASE_PROOF_COMMAND, RESERVED_SHEET_NAMES, SEED_GUIDE_PATHS, SERVICE_SCRIPT_PATH, SERVICE_SETUP_PATH, SERVICE_TEST_INCLUDE, SHEET_ENTRY_NAME, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SHOWCASE_OVERRIDES, SHOWCASE_PAGES_PATH, SKILLS_CONFIG_PATH, SOURCE_BROWSER_DEV_DEPENDENCIES, SRC_MATRIX, STUDIES_TEST_INCLUDE, STYLES_DEV_DEPENDENCIES, STYLES_ENTRY_PATH, SURFACES, SURFACE_EDIT_LENGTH, SURFACE_TRANSFERS, ScaffoldError, TAB_WIDTH, TARGET_SKILL_NAMES, THEMES_BARREL_PATH, THEMES_ENTRY_PATH, TOOLCHAIN_HOLDS, TREE_TEST_PATH, VERSION_PATTERN, WORKSPACE_DEV_ENGINES, WORKSPACE_OWNED_PATHS, applyOverrides, artifactToArtifactFinding, artifactToHex, artifactsToQuestions, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToDocumentArtifacts, blueprintToEntries, blueprintToExports, blueprintToFaces, blueprintToGuideArtifacts, blueprintToHostArtifacts, blueprintToMachinery, blueprintToManifest, blueprintToManifestOverrides, blueprintToOptimizedDependencies, blueprintToOrchestrationArtifacts, blueprintToProjects, blueprintToQuestions, blueprintToRootTsconfig, blueprintToRootVite, blueprintToScripts, blueprintToSheets, blueprintToSourceArtifacts, blueprintToTestArtifacts, blueprintToToolchainHolds, blueprintToWritableScripts, bytesToHex, catalogToLayers, collectSurfaceAdvisories, collectSurfaceCollisions, collectSurfaceConflicts, compareSurfaceCollisions, compareVersions, computeBytes, computeHash, computeTotal, contentToHex, createBlueprint, dependenciesToQuestions, extractRangeMajor, extractVersion, inferArtifactDrift, inferArtifactGroup, inferSurfaceSimilarity, insertManifestDependencies, insertManifestEntries, insertManifestSection, isArtifact, isArtifactFinding, isArtifactGroup, isArtifactGroups, isAudit, isBinModule, isBlueprint, isBrowserExtension, isCanonPath, isCatalogEntry, isCollection, isCompilerHooks, isCompilerOptions, isContent, isDeferredPath, isDependency, isDependencyName, isEnvironment, isExtension, isFloorPath, isHexContent, isManifestScript, isMirror, isOverride, isPath, isPlan, isQuestion, isRetainedPath, isScaffoldError, isSheetName, isSnapshot, isStylesExtension, isSubpathMap, isSurface, iterateAnswers, manifestToDependencies, manifestToEntries, manifestToName, matchesArtifactDriftReachability, matchesBarrel, matchesEngines, matchesGuideRefusal, matchesOrchestrationPath, matchesPackedPath, matchesPrintWidth, matchesRange, matchesSurfaceStructure, nameToGuide, normalizePackagePath, overridesToQuestions, parseArtifactGroups, parseBlueprint, parseCompilerOptions, parseExtension, parseOwnedJSONValue, parseSnapshot, pathToCondition, planToArtifactFindings, planToHash, planToSummary, projectsToBenches, renderSkillPointer, replaceManifestOverride, replaceManifestOverrides, replaceManifestRanges, replaceManifestScripts, replacePlanRanges, scanManifestTokens, selectArtifactGroups, selectHostPaths, serializeTypeScriptString, srcToEntry, srcToExports, srcToRoot };
10592
+ export { APP_BROWSER_DEV_DEPENDENCIES, APP_MATRIX, APP_SERVER_DEV_DEPENDENCIES, ARTIFACT_GROUPS, ARTIFACT_TEMPLATES, AXES, BARREL_CONFIGS, BASE_DEV_DEPENDENCIES, BIN_CONFIGS, BIN_ENTRY_PATH, BIN_MODULE_PATTERN, BIN_OUTPUT_PATH, BROWSER_ENTRIES, BROWSE_DEV_DEPENDENCIES, BROWSE_UPSTREAM, CANON_PATHS, CAPTURE_DEV_DEPENDENCIES, CAPTURE_UPSTREAM, CATALOG_AGENT_PATH, CATALOG_END_MARKER, CATALOG_START_MARKER, CENTRAL_FILE_NAMES, CONFIG_TEMPLATES, CONFORMANCE_TEST_PATH, CONTROL_CHARACTER_PATTERN, Compiler, DECLARATION_DEV_DEPENDENCIES, DEFAULT_ENGINES, DEFAULT_VERSION, DEPENDENCY_NAME_PATTERN, DISTRIBUTION_SETUP_PATH, DISTRIBUTION_TEST_PATH, ENGINES_PATTERN, ENVIRONMENTS, EXECUTABLE_PATHS, EXTRA_RANGE_PATTERN, FLOOR_RANGE_PATTERN, FOREIGN_NAME_PATTERN, FRAMEWORKS, FRAMEWORK_MATRIX, GLOBAL_SETUP_PATH, GUIDES_TEST_PATH, HEX_PATTERN, HOST_INVENTORY_PATH, HOST_PATHS, INTEGRATION_TEST_PATH, INVALID_PATH_CHARACTER_PATTERN, ISOLATION_SETUP_PATH, JOURNEY_CONFIG_PATH, MANIFEST_KEY_ORDER, MANIFEST_PATH, MAX_ARTIFACT_BYTES, MAX_ARTIFACT_HEX_LENGTH, MAX_AUDIT_FINDINGS, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_NAME_LENGTH, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_REGISTRY_BYTES, MAX_SCRIPT_LENGTH, MAX_TOTAL_ARTIFACT_BYTES, MAX_TOTAL_REGISTRY_BYTES, MINIMUM_NODE_VERSION, MINIMUM_NPM_VERSION, NAME_PATTERN, ORCHESTRATION_PATH_NAMES, ORCHESTRATION_PATH_PREFIXES, ORKESTREL_RANGE_PATTERN, PRINT_WIDTH, REFERENCE_PATHS, RELEASE_PROOF_COMMAND, RESERVED_SHEET_NAMES, SEED_GUIDE_PATHS, SERVICE_SCRIPT_PATH, SERVICE_SETUP_PATH, SERVICE_TEST_INCLUDE, SHEET_ENTRY_NAME, SHOWCASE_CONFIG_PATH, SHOWCASE_DEV_DEPENDENCIES, SHOWCASE_OVERRIDES, SHOWCASE_PAGES_PATH, SKILLS_CONFIG_PATH, SOURCE_BROWSER_DEV_DEPENDENCIES, SRC_MATRIX, STUDIES_TEST_INCLUDE, STYLES_DEV_DEPENDENCIES, STYLES_ENTRY_PATH, SURFACES, SURFACE_EDIT_LENGTH, SURFACE_TRANSFERS, ScaffoldError, TAB_WIDTH, TARGET_SKILL_NAMES, THEMES_BARREL_PATH, THEMES_ENTRY_PATH, TOOLCHAIN_HOLDS, TREE_TEST_PATH, VERSION_PATTERN, WORKSPACE_DEV_ENGINES, WORKSPACE_OWNED_PATHS, applyOverrides, artifactToArtifactFinding, artifactToHex, artifactsToQuestions, blueprintToConfigArtifacts, blueprintToDevDependencies, blueprintToDocumentArtifacts, blueprintToEntries, blueprintToExports, blueprintToFaces, blueprintToGuideArtifacts, blueprintToHostArtifacts, blueprintToMachinery, blueprintToManifest, blueprintToManifestOverrides, blueprintToOptimizedDependencies, blueprintToOrchestrationArtifacts, blueprintToProjects, blueprintToQuestions, blueprintToRootTsconfig, blueprintToRootVite, blueprintToScripts, blueprintToSheets, blueprintToSourceArtifacts, blueprintToTestArtifacts, blueprintToToolchainHolds, blueprintToWritableScripts, bytesToHex, catalogToLayers, collectSurfaceAdvisories, collectSurfaceCollisions, collectSurfaceConflicts, compareSurfaceCollisions, compareVersions, computeBytes, computeHash, computeTotal, contentToHex, createBlueprint, dependenciesToQuestions, extractRangeMajor, extractVersion, inferArtifactDrift, inferArtifactGroup, inferSurfaceSimilarity, insertManifestDependencies, insertManifestEntries, insertManifestSection, isArtifact, isArtifactFinding, isArtifactGroup, isArtifactGroups, isAudit, isBinModule, isBlueprint, isBrowserExtension, isCanonPath, isCatalogEntry, isCollection, isCompilerHooks, isCompilerOptions, isContent, isDeferredPath, isDependency, isDependencyName, isEnvironment, isExtension, isFloorPath, isHexContent, isManifestScript, isMirror, isOverride, isPath, isPlan, isQuestion, isRetainedPath, isScaffoldError, isSheetName, isSnapshot, isStylesExtension, isSubpathMap, isSurface, iterateAnswers, manifestToDependencies, manifestToEntries, manifestToName, matchesArtifactDriftReachability, matchesBarrel, matchesEngines, matchesGuideRefusal, matchesOrchestrationPath, matchesPackedPath, matchesPrintWidth, matchesRange, matchesSurfaceStructure, nameToGuide, normalizePackagePath, overridesToQuestions, parseArtifactGroups, parseBlueprint, parseCompilerOptions, parseExtension, parseOwnedJSONValue, parseSnapshot, pathToCondition, planToArtifactFindings, planToHash, planToSummary, projectsToBenches, renderSkillPointer, replaceManifestOverride, replaceManifestOverrides, replaceManifestRanges, replaceManifestScripts, replacePlanRanges, scanManifestTokens, selectArtifactGroups, selectHostPaths, serializeTypeScriptString, srcToEntry, srcToExports, srcToRoot };
10554
10593
 
10555
10594
  //# sourceMappingURL=index.js.map