@orkestrel/scaffold 0.0.75 → 0.0.76

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

@@ -39,7 +39,8 @@ SCSS mirrors TypeScript centralization. Concrete token prefixes are project-spec
 - Check `_tokens.scss` before inventing a token.
 - Put global tokens in `_tokens.scss`; put truly component-scoped custom properties on the component selector.
 - Never bury tokens in unrelated partials.
-- Never use literal colors. Use `var(--token)` or `color-mix()` over tokens.
+- Never use literal colors. Use `var(--token)` or `color-mix()` over tokens. The one file a
+  literal color may appear in is `_tokens.scss`, where the token itself is declared.
 - 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`.
 - A one-partial pattern stays inline; do not create a mixin for one caller.

package/dist/host/manifest.json

@@ -454,7 +454,7 @@
 			"storage": "claude/rules/styles.md",
 			"destination": ".claude/rules/styles.md",
 			"executable": false,
-			"digest": "5d0a8b9d36f0cff90e6cd4296ea1055c5a835c81b430c67b16d802c7adc2b6fc"
+			"digest": "9393ce28750e93f790da32e991e2edc7ca3d8cc1c527f40a43aeaabb202d52bc"
 		},
 		{
 			"storage": "claude/rules/tests.md",
@@ -1048,7 +1048,7 @@
 			"storage": "tests/setupPolicy.ts",
 			"destination": "tests/setupPolicy.ts",
 			"executable": false,
-			"digest": "9065dde1bc5ef6541a36dfb9b478d990102f804af9e5c78e0ed6b44521678974"
+			"digest": "3600093f5ea69b236df634aadf9a67ea73aec4bdcd799ae5178a2d1d26797f10"
 		}
 	],
 	"roots": [
@@ -2001,5 +2001,5 @@
 			]
 		}
 	],
-	"digest": "6e8e2b0524717bfc2b648acba0de5901c7c267a9c189155b45e3cb681b14bf6d"
+	"digest": "88c796ee06464183378d3918ab25854ad2c5b0211f072f3b904e00d49bcdf26c"
 }

package/dist/host/tests/setupPolicy.ts

@@ -96,6 +96,13 @@ export const POLICY_SURFACE_EXPORT_CASES = Object.freeze([
 export const POLICY_SURFACE_BARREL_PATTERN =
 	/^\s*export\s+\*\s+from\s+(?:'(\.\.?\/[^']+\.js)'|"(\.\.?\/[^"]+\.js)")\s*;?\s*$/u
 
+/** Names the workspace-relative styles side-effect entry the workspace rule prescribes. */
+export const POLICY_SURFACE_STYLES_ENTRY = 'src/styles/index.ts'
+
+/** Names the violation reported when the styles side-effect entry does not import `./index.scss` alone. */
+export const POLICY_SURFACE_STYLES_MESSAGE =
+	'surface population incomplete: styles entry must import ./index.scss and nothing else'
+
 /**
  * Creates a guide whose surface claims the supplied fixture names.
  *
@@ -2233,15 +2240,46 @@ export function collectPolicyDeclarations(
  *
  * @param root - The workspace root to inspect.
  * @returns The parsed declarations and incomplete-population violations.
+ * @remarks
+ * The `src/styles/index.ts` side-effect entry is excluded from barrel validation and instead
+ * requires exactly one bare `./index.scss` import.
  */
 export function readPolicySurface(root: string): PolicySurfacePopulation {
 	const files: Record<string, string> = {}
 	for (const path of globSync('src/**/*.ts', { cwd: root }).map(normalizePolicyPath).sort()) {
 		files[path] = readFileSync(join(root, path), 'utf8')
 	}
-	const barrels = Object.keys(files).filter((path) => path.endsWith('/index.ts'))
+	const barrels = Object.keys(files).filter(
+		(path) => path.endsWith('/index.ts') && path !== POLICY_SURFACE_STYLES_ENTRY,
+	)
 	const targets = new Set<string>()
 	const violations: PolicyViolation[] = []
+	const stylesEntry = files[POLICY_SURFACE_STYLES_ENTRY]
+	if (stylesEntry !== undefined) {
+		const stylesSource = parseSync(POLICY_SURFACE_STYLES_ENTRY, stylesEntry)
+		const stylesStatement =
+			stylesSource.errors.length === 0 ? stylesSource.program.body[0] : undefined
+		const stylesValid =
+			stylesSource.errors.length === 0 &&
+			stylesSource.program.body.length === 1 &&
+			stylesStatement?.type === 'ImportDeclaration' &&
+			stylesStatement.specifiers.length === 0 &&
+			stylesStatement.source.value === './index.scss'
+		if (!stylesValid) {
+			const line =
+				stylesStatement === undefined
+					? 1
+					: stylesEntry.slice(0, stylesStatement.start).split(/\r\n|\n/u).length
+			violations.push(
+				createPolicyViolation(
+					'surface',
+					POLICY_SURFACE_STYLES_ENTRY,
+					POLICY_SURFACE_STYLES_MESSAGE,
+					line,
+				),
+			)
+		}
+	}
 	for (const path of barrels) {
 		const text = files[path]
 		if (text === undefined) continue

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.75",
+	version: "0.0.76",
 	description: "Scaffold workspaces with commands: new, audit, repair, catalog, and overwrite.",
 	keywords: [
 		"audit",