@orkestrel/scaffold 0.0.29 → 0.0.30

package/dist/host/claude/rules/tests.md

@@ -36,18 +36,28 @@ paths:
 A proof that covers the workspace instead of one module has a fixed location, so no package invents
 its own:
 
-| Path                         | Proves                                                          |
-| ---------------------------- | --------------------------------------------------------------- |
-| `tests/policy.test.ts`       | Every source file obeys the syntactic coding and placement law  |
-| `tests/config.test.ts`       | Root configuration resolves its aliases, projects, and outputs  |
-| `tests/guides.test.ts`       | Every documented API exists and every public API is documented  |
-| `tests/conformance.test.ts`  | Where this package drifts from the official tooling it tracks   |
-| `tests/integration.test.ts`  | The built package works when installed and driven from outside  |
-| `tests/service/**/*.test.ts` | The live external services this package drives, driven for real |
+| Path                         | Proves                                                              |
+| ---------------------------- | ------------------------------------------------------------------- |
+| `tests/policy.test.ts`       | Every source file obeys the syntactic coding and placement law      |
+| `tests/config.test.ts`       | Root configuration resolves its aliases, projects, and outputs      |
+| `tests/guides.test.ts`       | Every documented API exists and every public API is documented      |
+| `tests/conformance.test.ts`  | Where this package drifts from the official tooling it tracks       |
+| `tests/integration.test.ts`  | The package's features work together end to end across environments |
+| `tests/service/**/*.test.ts` | The live external services this package drives, driven for real     |
 
 - `.claude/rules/workspace.md` names the Vitest project each location belongs to.
 - `integration.test.ts` is a reserved filename at any level. It names a scope rather than a module,
   so the mirror rule does not reach it; its scope is the directory it sits in.
+- An integration test is an end-to-end test: it composes the package's own features and drives them
+  together, through the public API, with no part of the system under test replaced.
+- Scope it by where the composition happens. `tests/integration.test.ts` drives features **across**
+  environments — core through server, core through browser, one environment's output consumed by
+  another. A nested `tests/src/<environment>/integration.test.ts` drives features **within** that one
+  environment.
+- Do not put a packaging, install, or distribution check in an integration test. What the tarball
+  contains is a different question from whether the features compose.
+- A test the mirror rule flags is a misplaced test until its placement is checked. Move it to the
+  location its scope names. Never widen the rule to accept it.
 - Give every nested `integration.test.ts` its own exact-path project entry. A glob such as
   `tests/src/**/integration.test.ts` double-claims a file another project already owns.
 

package/dist/host/claude/rules/workspace.md

@@ -114,14 +114,14 @@ environment:
 The second axis is cross-cutting workspace proofs. Each one covers the whole workspace rather than
 one environment, so each is its own project:
 
-| Project       | Files                        | Proves                                                          | In `test` |
-| ------------- | ---------------------------- | --------------------------------------------------------------- | --------- |
-| `policy`      | `tests/policy.test.ts`       | Every source file obeys the syntactic coding and placement law  | Yes       |
-| `config`      | `tests/config.test.ts`       | Root configuration resolves its aliases, projects, and outputs  | Yes       |
-| `guides`      | `tests/guides.test.ts`       | Every documented API exists and every public API is documented  | Yes       |
-| `conformance` | `tests/conformance.test.ts`  | Where this package drifts from the official tooling it tracks   | Yes       |
-| `integration` | `tests/integration.test.ts`  | The built package works when installed and driven from outside  | No        |
-| `service`     | `tests/service/**/*.test.ts` | The live external services this package drives, driven for real | No        |
+| Project       | Files                        | Proves                                                              | In `test` |
+| ------------- | ---------------------------- | ------------------------------------------------------------------- | --------- |
+| `policy`      | `tests/policy.test.ts`       | Every source file obeys the syntactic coding and placement law      | Yes       |
+| `config`      | `tests/config.test.ts`       | Root configuration resolves its aliases, projects, and outputs      | Yes       |
+| `guides`      | `tests/guides.test.ts`       | Every documented API exists and every public API is documented      | Yes       |
+| `conformance` | `tests/conformance.test.ts`  | Where this package drifts from the official tooling it tracks       | Yes       |
+| `integration` | `tests/integration.test.ts`  | The package's features work together end to end across environments | No        |
+| `service`     | `tests/service/**/*.test.ts` | The live external services this package drives, driven for real     | No        |
 
 `conformance` and `service` are two subjects, not two names for one. `conformance` measures this
 package against an official artifact it stays compatible with and drives nothing external: the

package/dist/src/core/index.cjs

@@ -290,7 +290,7 @@ var DEFAULT_ENGINES = `>=${MINIMUM_NODE_VERSION}`;
 var BASE_DEV_DEPENDENCIES = Object.freeze({
 	"@microsoft/api-extractor": "^7.58.12",
 	"@orkestrel/guide": "^0.0.10",
-	"@orkestrel/scaffold": "^0.0.29",
+	"@orkestrel/scaffold": "^0.0.30",
 	"@types/node": "^26.2.0",
 	oxfmt: "^0.62.0",
 	oxlint: "^1.77.0",
@@ -482,6 +482,7 @@ const resolve = {
 				name: { label: 'src:browser', color: 'yellow' },
 				include: ['tests/src/browser/**/*.test.ts'],
 {{exclude}}				setupFiles: ['./tests/setup.ts', './tests/setupBrowser.ts'],
+{{global}}
 				browser: {
 					enabled: true,
 					provider: playwright(browserOptions),
@@ -3374,7 +3375,8 @@ function blueprintToRootVite(blueprint) {
 		factories.push((0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.src.browser, {
 			external: core ? "external: (id: string) => id === '@src/core' || id.startsWith('@orkestrel/')," : "external: (id: string) => id.startsWith('@orkestrel/'),",
 			output: core ? "					output: { paths: { '@src/core': '../core/index.js' } }," : "					output: {},",
-			exclude: core ? "				exclude: ['tests/src/core/**/*.test.ts'],\n" : ""
+			exclude: core ? "				exclude: ['tests/src/core/**/*.test.ts'],\n" : "",
+			global: blueprint.global ? "				globalSetup: ['./tests/setupGlobal.ts'],\n" : ""
 		}));
 		projects.push("srcBrowser");
 	}