@orkestrel/scaffold 0.0.84 → 0.0.85

package/dist/host/AGENTS.md

@@ -34,7 +34,7 @@ configs/  thin target wrappers around root Vite/TypeScript configuration
 
 - **NEVER** use `any`; accept `unknown` and narrow with guards.
 - **NEVER** use non-null assertions (`!`) or type assertions (`as`); narrow or validate.
-- **NEVER** use `@ts-nocheck`, `@ts-ignore`, `@ts-expect-error`, or a lint-disable directive; fix the cause.
+- **NEVER** use `@ts-nocheck`, `@ts-ignore`, `@ts-expect-error`, a lint-disable directive, or a formatter-ignore directive, and never exclude a source file from a gate; fix the cause.
 - **NEVER** add an npm package unless the user explicitly requests it; prefer native APIs.
 - **NEVER** remove a symbol to silence lint. Implement it or annotate `// TODO: [Feature] Brief purpose`.
 - **NEVER** write `public`, `protected`, `private`, or a parameter property; use `#` fields.

package/dist/host/agents/skills/orkestrel-publish/references/wave.md

@@ -107,6 +107,10 @@ Prepare a published package's layer in this order, after the visit has ruled the
    bumped manifest.
 3. **Sweep the self-pins**, per the following section: the bump moves the version class.
 4. **Run each package's own `prepublishOnly` script to green.**
+   When the host npm is below the `MINIMUM_NPM_VERSION` floor a generated workspace declares in
+   `devEngines`, prepend a local npm 11 install's `node_modules/.bin` to `PATH` for the visit and
+   this script; a distribution proof that installs a generated workspace under an older npm fails
+   `EBADDEVENGINES`.
 5. **Write the release commit and push before the window opens.** The preparation commit inside
    the visit is a different commit at a different moment.
 
@@ -152,3 +156,10 @@ Refresh the registry evidence between layers and derive each round's pins from i
 name a version the registry already serves, so a dependency shipping in the same window keeps the
 resolvable previous pin and takes its development-only re-pin after the window closes. That re-pin
 takes the self-pin sweep too, because the snapshot class moves with no bump.
+
+- After a window confirms a release, poll its tarball URL, read with
+  `npm view NAME@VERSION dist.tarball`, until it answers `200` before an install names that
+  version. The registry lists a version in the packument minutes before it serves the tarball, and
+  an install in that gap fails `E404`.
+- Run every visit and install that follows a publish with `npm_config_prefer_online=true`. A
+  cached packument answers `notarget` for a version the registry already serves.

package/dist/host/claude/agents/orkestrel.md

@@ -78,7 +78,7 @@ so network-controlled descriptions never enter agent instruction context.
 | `@orkestrel/reason`     | `0.0.12` | L2    | `@orkestrel/emitter` `^0.0.11`, `@orkestrel/contract` `^0.0.18`                                                                                                                                                                                                                                                             |                                                                |
 | `@orkestrel/relation`   | `0.0.14` | L3    | `@orkestrel/emitter` `^0.0.11`, `@orkestrel/contract` `^0.0.18`, `@orkestrel/database` `^0.0.16`                                                                                                                                                                                                                            |                                                                |
 | `@orkestrel/router`     | `0.0.16` | L2    | `@orkestrel/abort` `^0.0.12`, `@orkestrel/emitter` `^0.0.11`, `@orkestrel/contract` `^0.0.18`                                                                                                                                                                                                                               |                                                                |
-| `@orkestrel/scaffold`   | `0.0.83` | L3    | `@orkestrel/console` `^0.0.15`, `@orkestrel/emitter` `^0.0.11`, `@orkestrel/process` `^0.0.14`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/markdown` `^0.0.17`, `@orkestrel/template` `^0.0.9`                                                                                                                            |                                                                |
+| `@orkestrel/scaffold`   | `0.0.84` | L3    | `@orkestrel/console` `^0.0.15`, `@orkestrel/emitter` `^0.0.11`, `@orkestrel/process` `^0.0.14`, `@orkestrel/contract` `^0.0.19`, `@orkestrel/markdown` `^0.0.17`, `@orkestrel/template` `^0.0.9`                                                                                                                            |                                                                |
 | `@orkestrel/sea`        | `0.0.18` | L3    | `@orkestrel/emitter` `^0.0.11`, `@orkestrel/process` `^0.0.14`, `@orkestrel/contract` `^0.0.18`                                                                                                                                                                                                                             |                                                                |
 | `@orkestrel/server`     | `0.0.22` | L3    | `@orkestrel/abort` `^0.0.12`, `@orkestrel/codec` `^0.0.5`, `@orkestrel/router` `^0.0.16`, `@orkestrel/emitter` `^0.0.11`, `@orkestrel/timeout` `^0.0.12`, `@orkestrel/contract` `^0.0.19`                                                                                                                                   |                                                                |
 | `@orkestrel/sqlite`     | `0.0.13` | L1    | `@orkestrel/contract` `^0.0.18`                                                                                                                                                                                                                                                                                             |                                                                |

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

@@ -108,8 +108,8 @@ neither reads meaning.
   data-kind file, that every centralized declaration is exported, that a class sits in its matching
   implementation or errors file, and that `constants.ts` declares only UPPER_SNAKE_CASE consts with
   no bare collection literal.
-- The sweep proves that no source, test, config, or script file carries an `eslint-disable` or
-  `oxlint-disable` directive.
+- The sweep proves that no source, test, config, script, or sheet file carries an `eslint-disable`,
+  `oxlint-disable`, or `prettier-ignore` directive.
 - The sweep proves that every `.claude/rules/*.md` file has a rule-map row in `AGENTS.md` and that
   every row resolves to a file.
 - The sweep proves the host portability rules that are path- or text-shaped over the population

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

@@ -14,14 +14,15 @@ SCSS mirrors TypeScript centralization. Concrete token prefixes are project-spec
 
 ## Centralized files
 
-| File                | Sole responsibility                                           |
-| ------------------- | ------------------------------------------------------------- |
-| `_mixins.scss`      | `@function` values and `@mixin` declaration emitters          |
-| `_tokens.scss`      | `:root` public custom-property tokens and cascade-layer order |
-| `_theme.scss`       | Token overrides under theme selectors                         |
-| `_reset.scss`       | The face's reset declarations, when that face owns a reset    |
-| `themes/index.scss` | Barrel of named theme packs, compiled into its own sheet      |
-| `index.scss`        | Sole compilation barrel                                       |
+| File                | Sole responsibility                                                                                                                                                                               |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `_mixins.scss`      | `@function` values, `@mixin` declaration emitters, and the `!default` switch an emitter reads, which `_tokens.scss` configures through `@use … with`                                              |
+| `_tokens.scss`      | `:root` public custom-property tokens and cascade-layer order                                                                                                                                     |
+| `_theme.scss`       | Token overrides under theme selectors                                                                                                                                                             |
+| `_reset.scss`       | The face's reset declarations, when that face owns a reset                                                                                                                                        |
+| `_utilities.scss`   | The utility map and its emission schedule, on a face that generates its utilities from data; that face has no `utilities/` folder, and the one emitter the schedule calls lives in `_mixins.scss` |
+| `themes/index.scss` | Barrel of named theme packs, compiled into its own sheet                                                                                                                                          |
+| `index.scss`        | Sole compilation barrel                                                                                                                                                                           |
 
 - Apply this table and the folder barrels in § Folders to every sheet face: `src/styles` and each
   `src/<name>` styles extension. `.claude/rules/workspace.md` § Environments fixes the `sheet.ts`
@@ -51,6 +52,14 @@ SCSS mirrors TypeScript centralization. Concrete token prefixes are project-spec
   declared. A face whose contract is the exact recreation of a pinned external artifact keeps
   the literals, declarations, and order the pin declares, and records tokenization and
   accessibility additions in its separate authored face.
+- Format a pinned recreation face like every other file: never a `prettier-ignore` directive and
+  never a `.prettierignore` entry for a source file. Sass re-emits every value and selector it
+  parses in its own form, so the formatter's canonicalisation of those vanishes at compile; a
+  custom-property value is the one text Sass emits verbatim, so write every custom-property
+  declaration in a literal partial as a Sass string interpolation (`--name: #{'VALUE'};`), which the
+  formatter reads as a string and Sass emits byte for byte. Keep a pinned expected output in a JSON
+  fixture, never in a CSS file the formatter would canonicalise. The face's byte proofs (link 1, the
+  per-module region cases, the sample cases) hold under `npm run format`.
 - Never repeat per-color/per-variant blocks; drive shared structure with one `@each` over a shared list.
 - If a pattern appears in at least two partials, move it to `_mixins.scss`.
 - Treat a declaration block two partials share because each records an external value as a
@@ -69,7 +78,7 @@ SCSS mirrors TypeScript centralization. Concrete token prefixes are project-spec
 ## Folders
 
 - Give each folder an `_index.scss` barrel that loads its partials with `@use`; keep the barrel when the folder is empty.
-- Put a rule that styles one element in `elements/`, a class skin that applies with no script running in `components/`, and a class that sets one property in `utilities/`.
+- Put a rule that styles one element in `elements/`, a class skin that applies with no script running in `components/`, and a class that sets one property in `utilities/`. A face that generates its utilities from a map keeps that map and its emission schedule in `_utilities.scss` instead of a `utilities/` folder; never keep both, because `@use 'utilities'` resolves to either.
 - Add another folder only for a job `elements/`, `components/`, and `utilities/` do not hold, and give it its own barrel and its own layer.
 
 ## Proofs

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

@@ -287,7 +287,7 @@ Build/check config alignment:
 
 - In a publishing workspace, `prepublishOnly` runs `build:showcase` and every
   `build:showcase:<framework>` script after `npm run build`.
-- List `showcase/` in `.prettierignore`, so formatting never rewrites a committed page.
+- List `showcase/` and `*.min.*` in `.prettierignore`, so formatting never rewrites a committed page or a minified generated record. Give the `.min` suffix only to a record an instrument writes from an installed package in compact form (a JSON inventory over 1 MB, for example), never to authored source, and read such a record through a guarded reader. Never list a source file there; `.claude/rules/styles.md` § Prohibitions states how a pinned recreation stays formatter-stable.
 
 ## Tooling
 

package/dist/host/dotfiles/prettierignore

@@ -15,3 +15,6 @@ tests/mirrors/
 
 # The vendored host inventory: `npm run build` regenerates it (`stageInventory`), so its bytes are the generator's, not the formatter's.
 host.json
+
+# A minified generated record (`*.min.*`, such as a compact JSON inventory an instrument writes from an installed package) keeps its compact bytes: nothing in it is authored, and a formatted copy would be a second artifact of the same bytes. Authored source never takes the suffix.
+*.min.*

package/dist/host/manifest.json

@@ -4,7 +4,7 @@
 			"storage": "AGENTS.md",
 			"destination": "AGENTS.md",
 			"executable": false,
-			"digest": "54707c4e20210dc0a925274d76bb6b9a5d65d4b9b8d8535252dbd53a1a72fd38"
+			"digest": "357cfbe336a026543ec68f3eb999f1094c3139d33331b0ba5f153352cef75fde"
 		},
 		{
 			"storage": "LICENSE",
@@ -370,7 +370,7 @@
 			"storage": "agents/skills/orkestrel-publish/references/wave.md",
 			"destination": ".agents/skills/orkestrel-publish/references/wave.md",
 			"executable": false,
-			"digest": "d86fc6b60f12eb09a54442cc6c6e6c3e9b901b310af0bdb19b7d3084b010b059"
+			"digest": "e519a148a47dbf3271bf3f8a57428a4182afedf9230b56774a97ba5449208325"
 		},
 		{
 			"storage": "agents/skills/orkestrel-publish/references/window.md",
@@ -496,7 +496,7 @@
 			"storage": "claude/agents/orkestrel.md",
 			"destination": ".claude/agents/orkestrel.md",
 			"executable": false,
-			"digest": "4b3dd60e59e6c0737d526083d70bcea0b010efbeaaf068f391ab1b76cac99280"
+			"digest": "9a093f83f23cc1f0d1fe1ba139e97afa0d1a38ab45522cc3e150fffc796c3ae3"
 		},
 		{
 			"storage": "claude/agents/planner.md",
@@ -538,7 +538,7 @@
 			"storage": "claude/rules/architecture.md",
 			"destination": ".claude/rules/architecture.md",
 			"executable": false,
-			"digest": "c3695c2deb808b04e55dbea6b06e66af65b46794d08cc7be67f5661e634c4ad0"
+			"digest": "e30f034c8de38ce7c86506dfaa51844201d745181caed45ef427d0325e80afd3"
 		},
 		{
 			"storage": "claude/rules/browser.md",
@@ -580,7 +580,7 @@
 			"storage": "claude/rules/styles.md",
 			"destination": ".claude/rules/styles.md",
 			"executable": false,
-			"digest": "f0f07cba616023b0c1d8f0a4cb23bd70129af1f4d818f41bfc82ff3f5c0f8e84"
+			"digest": "869f88c392b4795e47af881d668f4dc591e0c419229a843eb4105e38dfb6f831"
 		},
 		{
 			"storage": "claude/rules/tests.md",
@@ -598,7 +598,7 @@
 			"storage": "claude/rules/workspace.md",
 			"destination": ".claude/rules/workspace.md",
 			"executable": false,
-			"digest": "a3c0e392dfe6c1aceac54a00cd4f735600c0ddd49bc2d997b9a977015c81a89e"
+			"digest": "3c9e269acd88935ee6c4f34dd07784f09f45bb6bfd1e27c6a183da3420da4fcc"
 		},
 		{
 			"storage": "claude/rules/writing.md",
@@ -832,7 +832,7 @@
 			"storage": "dotfiles/prettierignore",
 			"destination": ".prettierignore",
 			"executable": false,
-			"digest": "fa3c916de6f5d2a4c07ee65281da26d21aca8db9974ec6199536fc7c36070e52"
+			"digest": "abd137ce9568994c74d4473765a70ba04554548b840e4a3275ab749e397ab69b"
 		},
 		{
 			"storage": "guides/README.md",
@@ -1180,7 +1180,7 @@
 			"storage": "tests/setupPolicy.ts",
 			"destination": "tests/setupPolicy.ts",
 			"executable": false,
-			"digest": "a6155fc5a2653d847014c4e7ec3fcf936bcbd7ab02e05827e6cf1f71beedcced"
+			"digest": "2571274f92e75e6caffa86b2703ef9a38828db4ec8f51a7b38510f8bc48c6aee"
 		}
 	],
 	"roots": [
@@ -2144,5 +2144,5 @@
 			]
 		}
 	],
-	"digest": "410ca4bbfc4639a33cea13a791dffd130f507b8efb3aa2d54b84f5143babab4b"
+	"digest": "f8711433145a8b302c5c8c626c1be5ddbdd2e5a44c1f971fb6fce1ed4f5703b6"
 }

package/dist/host/tests/setupPolicy.ts

@@ -281,10 +281,13 @@ export const POLICY_TEST_GLOB = 'tests/{app,src}/**/*.test.ts'
 // Compose suppression tokens so the instrument does not report its own definitions or controls.
 export const POLICY_SUPPRESSION_DIRECTIVE = ['oxlint', '-disable'].join('')
 
-/** Matches the source, test, config, and script files inspected for lint suppression directives. */
+/** Names the formatter directive the text sweep refuses, composed so the instrument does not report itself. */
+export const POLICY_FORMATTER_DIRECTIVE = ['prettier', '-ignore'].join('')
+
+/** Matches the source, test, config, script, and sheet files inspected for lint and formatter suppression directives. */
 export const POLICY_SUPPRESSION_GLOB: readonly string[] = Object.freeze([
-	'{src,app,tests,configs,scripts}/**/*.{cjs,cts,js,jsx,mjs,mts,ts,tsx,vue}',
-	'*.{cjs,cts,js,jsx,mjs,mts,ts,tsx,vue}',
+	'{src,app,tests,configs,scripts}/**/*.{cjs,css,cts,js,jsx,mjs,mts,scss,ts,tsx,vue}',
+	'*.{cjs,css,cts,js,jsx,mjs,mts,scss,ts,tsx,vue}',
 ])
 
 /** Lists the rules whose workspace-wide lint wiring must not be weakened by configuration. */
@@ -305,9 +308,11 @@ export const POLICY_WIRING_ROOTS: readonly string[] = Object.freeze([
 	'configs',
 ])
 
-/** Matches either lint suppression token the text sweep refuses. */
+/** Matches either lint suppression token or the formatter directive the text sweep refuses. */
 export const POLICY_SUPPRESSION_PATTERN = new RegExp(
-	[['eslint', '-disable'].join(''), POLICY_SUPPRESSION_DIRECTIVE].join('|'),
+	[['eslint', '-disable'].join(''), POLICY_SUPPRESSION_DIRECTIVE, POLICY_FORMATTER_DIRECTIVE].join(
+		'|',
+	),
 	'u',
 )
 
@@ -577,7 +582,7 @@ export function inspectPolicySetup(root: string): readonly PolicyViolation[] {
 }
 
 /**
- * Inspects code-shaped workspace files for lint suppression directives.
+ * Inspects code-shaped and sheet workspace files for lint and formatter suppression directives.
  *
  * @param root - The workspace root to inspect.
  * @returns Every suppression occurrence in path and line order.
@@ -594,7 +599,7 @@ export function inspectPolicySuppressions(root: string): readonly PolicyViolatio
 					createPolicyViolation(
 						'suppression',
 						path,
-						'file carries a lint suppression directive',
+						'file carries a lint or formatter suppression directive',
 						index + 1,
 					),
 				)
@@ -2687,6 +2692,17 @@ export const POLICY_CONTROLS: readonly PolicyControl[] = Object.freeze([
 			},
 		],
 	},
+	{
+		label: 'rejects a formatter directive in a sheet partial',
+		membership: 'sheet files in the suppression population',
+		rule: 'suppression',
+		files: [
+			{
+				path: 'src/styles/_control.scss',
+				content: `// ${POLICY_FORMATTER_DIRECTIVE}\n.control {\n\tcolor: red;\n}\n`,
+			},
+		],
+	},
 	{
 		label: 'rejects an unmirrored module test',
 		membership: 'module tests below tests/src or tests/app except integration.test.ts',

package/dist/src/core/index.cjs

@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
 let _orkestrel_emitter = require("@orkestrel/emitter");
 var package_default = {
 	name: "@orkestrel/scaffold",
-	version: "0.0.84",
+	version: "0.0.85",
 	description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",