@orkestrel/scaffold 0.0.86 → 0.0.87

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

@@ -57,7 +57,7 @@ so network-controlled descriptions never enter agent instruction context.
 | `@orkestrel/database`   | `0.0.16` | L2    | `@orkestrel/sqlite` `^0.0.13`, `@orkestrel/emitter` `^0.0.11`, `@orkestrel/contract` `^0.0.18`, `@orkestrel/indexeddb` `^0.0.13`                                                                                                                                                                                            |                                                                |
 | `@orkestrel/emitter`    | `0.0.11` | L1    | `@orkestrel/contract` `^0.0.18`                                                                                                                                                                                                                                                                                             |                                                                |
 | `@orkestrel/form`       | `0.0.8`  | L2    | `@orkestrel/emitter` `^0.0.11`, `@orkestrel/contract` `^0.0.18`                                                                                                                                                                                                                                                             |                                                                |
-| `@orkestrel/guide`      | `0.0.22` | L3    | `@orkestrel/contract` `^0.0.18`, `@orkestrel/markdown` `^0.0.16`                                                                                                                                                                                                                                                            |                                                                |
+| `@orkestrel/guide`      | `0.0.24` | L3    | `@orkestrel/contract` `^0.0.19`, `@orkestrel/markdown` `^0.0.17`                                                                                                                                                                                                                                                            |                                                                |
 | `@orkestrel/html`       | `0.0.12` | L1    | `@orkestrel/contract` `^0.0.19`                                                                                                                                                                                                                                                                                             |                                                                |
 | `@orkestrel/indexeddb`  | `0.0.13` | L1    | `@orkestrel/contract` `^0.0.18`                                                                                                                                                                                                                                                                                             |                                                                |
 | `@orkestrel/interpret`  | `0.0.15` | L3    | `@orkestrel/reason` `^0.0.12`, `@orkestrel/emitter` `^0.0.11`, `@orkestrel/contract` `^0.0.18`, `@orkestrel/template` `^0.0.9`                                                                                                                                                                                              |                                                                |
@@ -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.85` | 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.86` | 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

@@ -28,6 +28,7 @@ paths:
 | Shape/algorithm compilers | `*/compilers.ts`                                             |
 | Entity/value factories    | `*/factories.ts`                                             |
 | Middleware factories      | `*/middlewares.ts`                                           |
+| Plugin factories          | `*/plugins.ts`                                               |
 | Request handlers          | `*/handlers.ts`                                              |
 | Route tables              | `*/routes.ts`                                                |
 | Seeders                   | `*/seeders.ts`                                               |
@@ -63,7 +64,8 @@ Use only the centralized files an environment needs.
   - non-trivial or reusable → extract, export, unit-test, and route every duplicate through it.
 - `factories.ts`, `compilers.ts`, and `parsers.ts` are centralized files, not hiding places. Factory glue extracts to `helpers.ts`; pure compiler/parser recursion remains exported in its own kind file.
 - Every exported function in `parsers.ts` is named `parse*`. Every exported function in
-  `factories.ts` is named `create*`.
+  `factories.ts` is named `create*`. Every exported function in `plugins.ts` is named
+  `create{Entity}Plugin`, or `create{Name}Plugins` when it returns a collection.
 - Those name forms are one-directional. A name does not place a function: `createWriteDirectory`
   creates a directory rather than an entity and `isVacant` is a predicate rather than a `Guard<T>`,
   so both stay in `helpers.ts`. Placement follows what the function is; the name form follows
@@ -86,7 +88,7 @@ Use only the centralized files an environment needs.
 - Keep the leaf pair class-free. `helpers.ts` and `validators.ts` sit at the bottom of a module's
   graph: they import types, constants, errors, and each other, and they import no implementation
   class. Every file that constructs or drives a class — `cloners.ts`, `compilers.ts`, `factories.ts`,
-  `shapers.ts` — sits above them, consumes them, and is never consumed by them. One cycle between
+  `plugins.ts`, `shapers.ts` — sits above them, consumes them, and is never consumed by them. One cycle between
   the leaves is the shape this produces and is acceptable; an edge running downward from a
   class-importing file into the leaf pair is not.
 - `templates.ts` and `contracts.ts` hold data only — shipped template definitions and compiled
@@ -126,10 +128,10 @@ neither reads meaning.
   freeze obligation in the earlier kind-purity rules binds regardless; only the bare literal is
   mechanical.
 - The plugin does not tell one function kind from another. Every centralized file that permits
-  functions reads the same to it apart from the `parse*` and `create*` name forms: `cloners.ts`,
-  `combinators.ts`, `compilers.ts`, `errors.ts`, `factories.ts`, `handlers.ts`, `helpers.ts`,
-  `inferers.ts`, `middlewares.ts`, `parsers.ts`, `relations.ts`, `schemas.ts`, `seeders.ts`,
-  `shapers.ts`, and `validators.ts`. That list is exhaustive, a new function kind joins it, and no
+  functions reads the same to it apart from the `parse*`, `create*`, `create*Plugin`, and `create*Plugins` name
+  forms: `cloners.ts`, `combinators.ts`, `compilers.ts`, `errors.ts`, `factories.ts`, `handlers.ts`,
+  `helpers.ts`, `inferers.ts`, `middlewares.ts`, `parsers.ts`, `plugins.ts`, `relations.ts`,
+  `schemas.ts`, `seeders.ts`, `shapers.ts`, and `validators.ts`. That list is exhaustive, a new function kind joins it, and no
   later version of the plugin claims more.
 - The plugin reports no `data` violation in `helpers.ts`. The kind rules place a camelCase
   namespace of functions there, and a namespace of callables is not separable from a data table by
@@ -202,6 +204,13 @@ Store child managers in `#` fields and expose readonly getters typed as their in
 - Extract reusable cross-middleware machinery to helpers/classes.
 - `MiddlewareManager` is the sole manager of the middleware composition chain; do not create one manager per middleware.
 
+## Plugins
+
+- A plugin is a value a host composes at creation: the binding of one entity class to the host's extension seam. The entity class stays unaware of it.
+- Place plugin factories in `plugins.ts` as `create{Entity}Plugin(options?)`, and a factory of a host's collection as `create{Name}Plugins()`; keep them distinct from the entity factories in `factories.ts`.
+- A plugin factory builds and returns the value; it never registers, installs, or boots anything. The host's creation options take the plugin list, and registration happens there.
+- A plugin drives its entity through the entity's public interface. When the host needs behavior the interface lacks, add it to the interface as a real entity capability; never reach a private member from the plugin.
+
 ## Environment/module placement
 
 - Shared cross-environment logic belongs in the central core/shared layer. Other environments import core; core imports neither browser nor server.

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

@@ -169,17 +169,18 @@ Keep canonical case:
 
 ## Value-level identifiers
 
-| Kind           | Required form                         |
-| -------------- | ------------------------------------- |
-| Class          | PascalCase `{Entity}`                 |
-| Manager class  | PascalCase `{Entity}Manager`          |
-| Factory        | camelCase `create{Entity}`            |
-| Guard          | camelCase `is{Condition}`             |
-| Helper         | camelCase `{verb}{Noun}`              |
-| Constant       | UPPER_SNAKE_CASE `{QUALIFIER}_{NOUN}` |
-| Property/field | camelCase bare noun                   |
-| Method         | camelCase bare verb                   |
-| Boolean        | camelCase adjective/past participle   |
+| Kind           | Required form                                                        |
+| -------------- | -------------------------------------------------------------------- |
+| Class          | PascalCase `{Entity}`                                                |
+| Manager class  | PascalCase `{Entity}Manager`                                         |
+| Factory        | camelCase `create{Entity}`                                           |
+| Plugin factory | camelCase `create{Entity}Plugin`; a collection `create{Name}Plugins` |
+| Guard          | camelCase `is{Condition}`                                            |
+| Helper         | camelCase `{verb}{Noun}`                                             |
+| Constant       | UPPER_SNAKE_CASE `{QUALIFIER}_{NOUN}`                                |
+| Property/field | camelCase bare noun                                                  |
+| Method         | camelCase bare verb                                                  |
+| Boolean        | camelCase adjective/past participle                                  |
 
 ## Fixed derivation/construction forms
 
@@ -187,6 +188,7 @@ Keep canonical case:
 - `is*`: total `Guard<T>`; never throws; returns false off-shape.
 - `parse*`: coercion producing `T | undefined`; cross-type conversion never belongs in a guard.
 - `create*`: the factory form; `.claude/rules/architecture.md` § Kind purity states what a factory is and where it lives.
+- `create*Plugin` and `create*Plugins`: the plugin-factory forms; `.claude/rules/architecture.md` § Plugins owns what a plugin is and what its factory does. Never name a plugin factory `register*` or `install*`.
 - `*Of`: combinator named for its constituents, combining them into a container/guard/value, such as `arrayOf(guard)` or `boundsOf(min, max)`.
 - `{noun}To{Noun}`: projection from a whole to a derived view, such as `definitionToSnapshot`.
 - `*Shape`: `ContractShape` value/JSON-Schema blueprint, not a function or type.

package/dist/host/configs/policy.ts

@@ -31,6 +31,13 @@ export interface PolicyExpression extends PolicyNode {
 	readonly source?: PolicyExpression
 	readonly specifiers?: readonly PolicyExpression[]
 	readonly imported?: PolicyExpression
+	readonly exported?: PolicyExpression
+}
+
+/** Pairs a name-form kind file's name pattern with the message id a misnamed export reports. */
+export interface PolicyNameForm {
+	readonly pattern: RegExp
+	readonly messageId: string
 }
 
 /** Pairs one declared module function with the name a prefix rule reads. */
@@ -145,6 +152,7 @@ export const CENTRAL_SOURCE_FILES: readonly string[] = Object.freeze([
 	'inferers.ts',
 	'middlewares.ts',
 	'parsers.ts',
+	'plugins.ts',
 	'relations.ts',
 	'routes.ts',
 	'schemas.ts',
@@ -167,6 +175,7 @@ export const FUNCTION_SOURCE_FILES: readonly string[] = Object.freeze([
 	'inferers.ts',
 	'middlewares.ts',
 	'parsers.ts',
+	'plugins.ts',
 	'relations.ts',
 	'schemas.ts',
 	'seeders.ts',
@@ -274,6 +283,13 @@ export const POLICY_TAG_PATTERN = /\{@(?:linkcode|linkplain|link|inheritDoc)\b[^
 /** Matches a URL, whose segments are an address rather than prose. */
 export const POLICY_URL_PATTERN = /https?:\/\/\S+/gu
 
+/** Maps each name-form kind file to the form every function it exports must take. */
+export const POLICY_NAME_FORMS: Readonly<Record<string, PolicyNameForm>> = Object.freeze({
+	'parsers.ts': Object.freeze({ pattern: /^parse/u, messageId: 'parser' }),
+	'factories.ts': Object.freeze({ pattern: /^create/u, messageId: 'factory' }),
+	'plugins.ts': Object.freeze({ pattern: /^create[A-Z]\w*Plugins?$/u, messageId: 'plugin' }),
+})
+
 /**
  * Lists the words ending in `s` that open a sentence without being a third-person verb.
  *
@@ -992,24 +1008,37 @@ export function reportConstant(context: PolicyContext, node: PolicyExpression):
 	}
 }
 
-/** Reports a parsers.ts function whose name lacks the parse prefix. */
-export function reportParser(context: PolicyContext, node: PolicyExpression): void {
-	if (isPolicyAmbient(context.filename) || !isPolicyTop(node)) return
-	if (pathToPolicyFile(context.filename) !== 'parsers.ts') return
-	for (const binding of statementToPolicyBindings(node)) {
-		if (binding.name === undefined || !binding.name.startsWith('parse')) {
-			context.report({ node: binding.node, messageId: 'parser' })
+/**
+ * Reports a function in the named kind file whose name breaks that file's form, an export specifier
+ * there that publishes a name outside it, and a star re-export there, whose names the form cannot
+ * read.
+ */
+export function reportName(context: PolicyContext, node: PolicyExpression, file: string): void {
+	const form = POLICY_NAME_FORMS[file]
+	if (form === undefined || pathToPolicyFile(context.filename) !== file) return
+	if (node.type === 'ExportAllDeclaration') {
+		context.report({ node, messageId: form.messageId })
+		return
+	}
+	if (node.type === 'ExportNamedDeclaration') {
+		for (const specifier of node.specifiers ?? []) {
+			const exported = specifier.exported
+			const name =
+				typeof exported?.name === 'string'
+					? exported.name
+					: typeof exported?.value === 'string'
+						? exported.value
+						: undefined
+			if (name === undefined || !form.pattern.test(name)) {
+				context.report({ node: specifier, messageId: form.messageId })
+			}
 		}
+		return
 	}
-}
-
-/** Reports a factories.ts function whose name lacks the create prefix. */
-export function reportFactory(context: PolicyContext, node: PolicyExpression): void {
-	if (isPolicyAmbient(context.filename) || !isPolicyTop(node)) return
-	if (pathToPolicyFile(context.filename) !== 'factories.ts') return
+	if (!isPolicyTop(node)) return
 	for (const binding of statementToPolicyBindings(node)) {
-		if (binding.name === undefined || !binding.name.startsWith('create')) {
-			context.report({ node: binding.node, messageId: 'factory' })
+		if (binding.name === undefined || !form.pattern.test(binding.name)) {
+			context.report({ node: binding.node, messageId: form.messageId })
 		}
 	}
 }
@@ -1252,44 +1281,73 @@ export const CONSTANT_RULE: PolicyRuleInterface = {
 	},
 }
 
-/** Bans a parsers.ts function whose name lacks the parse prefix. */
+/** Bans a parsers.ts function or export whose name lacks the parse prefix. */
 export const PARSER_RULE: PolicyRuleInterface = {
 	meta: {
 		type: 'problem',
 		docs: {
-			description: 'Disallow a parsers.ts function whose name does not start with parse.',
+			description: 'Disallow a parsers.ts function or export whose name does not start with parse.',
 		},
 		messages: {
 			parser:
-				'Name this parsers.ts function with the parse prefix, or move it to its own kind file.',
+				'Name this parsers.ts function or export with the parse prefix, or move it to its own kind file.',
 		},
 	},
 	create(context) {
 		return {
-			FunctionDeclaration: (node) => reportParser(context, node),
-			TSDeclareFunction: (node) => reportParser(context, node),
-			VariableDeclaration: (node) => reportParser(context, node),
+			ExportAllDeclaration: (node) => reportName(context, node, 'parsers.ts'),
+			ExportNamedDeclaration: (node) => reportName(context, node, 'parsers.ts'),
+			FunctionDeclaration: (node) => reportName(context, node, 'parsers.ts'),
+			TSDeclareFunction: (node) => reportName(context, node, 'parsers.ts'),
+			VariableDeclaration: (node) => reportName(context, node, 'parsers.ts'),
 		}
 	},
 }
 
-/** Bans a factories.ts function whose name lacks the create prefix. */
+/** Bans a factories.ts function or export whose name lacks the create prefix. */
 export const FACTORY_RULE: PolicyRuleInterface = {
 	meta: {
 		type: 'problem',
 		docs: {
-			description: 'Disallow a factories.ts function whose name does not start with create.',
+			description:
+				'Disallow a factories.ts function or export whose name does not start with create.',
 		},
 		messages: {
 			factory:
-				'Name this factories.ts function with the create prefix, or move it to its own kind file.',
+				'Name this factories.ts function or export with the create prefix, or move it to its own kind file.',
+		},
+	},
+	create(context) {
+		return {
+			ExportAllDeclaration: (node) => reportName(context, node, 'factories.ts'),
+			ExportNamedDeclaration: (node) => reportName(context, node, 'factories.ts'),
+			FunctionDeclaration: (node) => reportName(context, node, 'factories.ts'),
+			TSDeclareFunction: (node) => reportName(context, node, 'factories.ts'),
+			VariableDeclaration: (node) => reportName(context, node, 'factories.ts'),
+		}
+	},
+}
+
+/** Bans a plugins.ts function or export whose name is not a create-prefixed plugin or plugins form. */
+export const PLUGIN_RULE: PolicyRuleInterface = {
+	meta: {
+		type: 'problem',
+		docs: {
+			description:
+				'Disallow a plugins.ts function or export whose name is not create…Plugin or create…Plugins.',
+		},
+		messages: {
+			plugin:
+				'Name this plugins.ts function or export create…Plugin, or create…Plugins for a collection, or move it to its own kind file.',
 		},
 	},
 	create(context) {
 		return {
-			FunctionDeclaration: (node) => reportFactory(context, node),
-			TSDeclareFunction: (node) => reportFactory(context, node),
-			VariableDeclaration: (node) => reportFactory(context, node),
+			ExportAllDeclaration: (node) => reportName(context, node, 'plugins.ts'),
+			ExportNamedDeclaration: (node) => reportName(context, node, 'plugins.ts'),
+			FunctionDeclaration: (node) => reportName(context, node, 'plugins.ts'),
+			TSDeclareFunction: (node) => reportName(context, node, 'plugins.ts'),
+			VariableDeclaration: (node) => reportName(context, node, 'plugins.ts'),
 		}
 	},
 }
@@ -1392,6 +1450,7 @@ export default {
 		'no-malformed-constant': CONSTANT_RULE,
 		'no-misnamed-parser': PARSER_RULE,
 		'no-misnamed-factory': FACTORY_RULE,
+		'no-misnamed-plugin': PLUGIN_RULE,
 		'no-malformed-domain': DOMAIN_RULE,
 		'no-host-line-endings': ENDING_RULE,
 		'no-malformed-summary': VOICE_RULE,

package/dist/host/dotfiles/oxlintrc.json

@@ -109,6 +109,7 @@
 				"policy/no-malformed-constant": "error",
 				"policy/no-misnamed-parser": "error",
 				"policy/no-misnamed-factory": "error",
+				"policy/no-misnamed-plugin": "error",
 				"policy/no-malformed-domain": "error"
 			}
 		},

package/dist/host/guides/guide.md

@@ -129,7 +129,7 @@ directly.
 | `extractSourceLines`    | function | `(source: string) => readonly SourceLine[]`                                                                              | Extracts aligned physical source-line records in one character traversal. Real line and block comments and complete template tokens become spaces in `SourceLine.code`, while ordinary code, quoted strings, and recognized regex literals retain their columns. Genuine JSDoc opened from reflection code is retained span by span at its exact physical column in `SourceLine.jsdoc`; faux openers in comments and templates are excluded. Membership remains each consumer's separate anchored grammar.                                                                                                                                                                |
 | `extractExports`        | function | `(source: string) => readonly SurfaceSymbol[]`                                                                           | Extracts the module-scope exports declared in one file's source text — the declaration keys `collectKeys` reports, each split back into the keyword and name that built it, deduped by (keyword, name).                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 | `extractHidden`         | function | `(source: string) => readonly SurfaceSymbol[]`                                                                           | Extracts the module-scope declarations lacking the `export` keyword in one file's source text — the mirror image of `extractExports`'s grammar, anchored the same way (column 0, so an indented inner declaration never matches).                                                                                                                                                                                                                                                                                                                                                                                                                                         |
-| `joinHead`              | function | `(lines: readonly string[], start: number) => DeclarationHead \| undefined`                                              | Joins the declaration head starting at `start` into one space-separated line, consuming lines until the first that ends with `{`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `joinHead`              | function | `(lines: readonly string[], start: number) => DeclarationHead \| undefined`                                              | Joins the declaration head starting at `start` into one space-separated line, consuming lines until the first that opens a body: one that ends with `{`, or one that closes an empty body with `{}` or `{ }`.                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
 | `escapeRegExp`          | function | `(value: string) => string`                                                                                              | Escapes every regex metacharacter in a literal string so it reads as text inside a larger `RegExp` source rather than as syntax.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | `collectDeclarations`   | function | `(source: string) => ReadonlyMap<string, Declaration>`                                                                   | Collects every `export class` / `export interface` declaration one file's source text declares, each keyed `${keyword} ${name}` and carrying the body lines and the base identifiers read from its own head, so a body and a heritage clause always come from the same declaration.                                                                                                                                                                                                                                                                                                                                                                                       |
 | `extractDeclaration`    | function | `(source: string, keyword: DeclarationKeyword, name: string) => Declaration \| undefined`                                | Locates the named `export class` / `export interface` declaration in one file's source text and returns its body lines and its base identifiers read from that one head, so a body and a heritage clause always come from the same declaration, or `undefined` when the file declares no such head.                                                                                                                                                                                                                                                                                                                                                                       |
@@ -577,7 +577,9 @@ keyed `${keyword} ${name}`. One collector is what keeps a body and a heritage cl
 declaration. The identifier is the head's own run up to its generic parameter list or its heritage
 clause, so it enters the key as literal text: a name carrying a regex metacharacter reaches no
 `RegExp`, and a lookup of that name matches the character rather than a wildcard. A head that opens
-no column-zero close records nothing, and a later head of a key already collected adds nothing.
+no column-zero close records nothing, a head whose last line closes its own body with `{}` or
+`{ }` records an empty body, and a later head of a key already collected adds nothing unless the
+earlier head recorded neither a body nor bases, which the later head then replaces.
 `extractDeclaration` is the named lookup over that map: it spells the `${keyword} ${name}` key so a
 consumer reading one name never writes that convention, and it collects the file afresh on every
 call. A consumer reading many names from one file calls `collectDeclarations` once and reads the
@@ -592,12 +594,15 @@ reads as `Base`, and a class's `implements` clause is excluded. `Source.methods(
 located declaration's own members with those of every declaration it extends, following each base
 through the same module scope and keeping the keyword it started from — an interface chain resolves
 through interfaces, a class chain through classes, so an interface extending a name only a class
-declares gets nothing from it. One declaration answers for a name: the module scope's files are read
-in sorted key order, and the first one whose located head has a body or has bases supplies both the
-members and the bases; a head with neither a body nor bases does not count as declared, so an empty
-`export interface X {}` is skipped and the scan continues to a later file or falls through to a
-same-named class, and a second file declaring the same name after one is found adds nothing. The
-inventory is the further bound: a base the selected directories do not declare, whether it is
+declares gets nothing from it. One declaration answers under each keyword: the module scope's files
+are read in sorted key order, and the first one whose located head has a body or has bases supplies
+both the members and the bases; a head with neither a body nor bases does not count as declared, so
+an empty `export interface X {}` is skipped and the scan continues to a later file, and a second
+file declaring the same name under that keyword adds nothing. The interface answers for a name, and
+the class answers when no interface declares it. Where one file declares a name as both an interface
+and a class, which TypeScript merges into one type, both answer: each shape's own members come ahead
+of inherited ones, the interface's own first. Shapes from two files stay separate declarations, and
+Parity lets the class of a merge the barrel exports answer for its interface half. The inventory is the further bound: a base the selected directories do not declare, whether it is
 imported from another package or written as a qualified name such as `external.Store`, contributes
 no members and is not an error, and one visited set per call collapses a cycle and a diamond to a
 single visit. `Source.examples(name)` is deliberately asymmetric with it — it reads only the named

package/dist/host/manifest.json

@@ -496,7 +496,7 @@
 			"storage": "claude/agents/orkestrel.md",
 			"destination": ".claude/agents/orkestrel.md",
 			"executable": false,
-			"digest": "6b3af62e323ff6725680f6a13c3505904154e1d2c0afcb8ba7151a00ff5875c2"
+			"digest": "02c8bfcfa26ee23e91cef48771e5a3038bdb8d4018f0510bef5cd17db82f5893"
 		},
 		{
 			"storage": "claude/agents/planner.md",
@@ -538,7 +538,7 @@
 			"storage": "claude/rules/architecture.md",
 			"destination": ".claude/rules/architecture.md",
 			"executable": false,
-			"digest": "e30f034c8de38ce7c86506dfaa51844201d745181caed45ef427d0325e80afd3"
+			"digest": "6d8936e85dd3c01e915a91a5b7bb9aaafa9b09a899b0cf8ff6bb8f9e8ff8e629"
 		},
 		{
 			"storage": "claude/rules/browser.md",
@@ -556,7 +556,7 @@
 			"storage": "claude/rules/names.md",
 			"destination": ".claude/rules/names.md",
 			"executable": false,
-			"digest": "1c9aeda4a47d94ef174e1f513da7b2710fe2a162e56a450270572ad942c95a7d"
+			"digest": "6606f4f8b219c6631029235f4081f29b055952a635e76477dfd6febdbe61afe2"
 		},
 		{
 			"storage": "claude/rules/patterns.md",
@@ -772,7 +772,7 @@
 			"storage": "configs/policy.ts",
 			"destination": "configs/policy.ts",
 			"executable": false,
-			"digest": "2ba8395040b41b30245a0e09de3a87b10546f29eab359a2884b5cde76aff4fc8"
+			"digest": "de238996682d2eb35a40941214dc5c1d6427c57159afc3055f243bf93a5e8f83"
 		},
 		{
 			"storage": "cursor/mcp.json",
@@ -826,7 +826,7 @@
 			"storage": "dotfiles/oxlintrc.json",
 			"destination": ".oxlintrc.json",
 			"executable": false,
-			"digest": "8deab17f02176cb061f4c80a068eead4ac44ffc62cbb388587a962dc6afd8431"
+			"digest": "043a5c3eb0fb52d6cd841590e77c94ce03797b4b6a742fd57127bc9b9242153c"
 		},
 		{
 			"storage": "dotfiles/prettierignore",
@@ -916,7 +916,7 @@
 			"storage": "guides/guide.md",
 			"destination": "guides/guide.md",
 			"executable": false,
-			"digest": "1cdcd2e03b005cd8e7e12319f083ef31847a96682b4f9e33a084ea249c6a857c"
+			"digest": "4749d6a2a7da1d8d89a8c3ee3b60c5f21fcfb112074db80d7b1a2edcdef93afd"
 		},
 		{
 			"storage": "guides/html.md",
@@ -1168,7 +1168,7 @@
 			"storage": "tests/config.test.ts",
 			"destination": "tests/config.test.ts",
 			"executable": false,
-			"digest": "6550d3edb31603777ce713985b6648063e105c1ce2bee82c66570382faed7c67"
+			"digest": "395ac8782ae05c678c13e460de654e32140125f159fcb882053340ab193bb5f3"
 		},
 		{
 			"storage": "tests/policy.test.ts",
@@ -2144,5 +2144,5 @@
 			]
 		}
 	],
-	"digest": "ccbd92a2462e0a17fb972b7582bf05e6deec0c1f11cf4d2d17e6ebec5cc431bf"
+	"digest": "5c7e45000c69dd7340b13478851fcfaeaa972f3f25311e230def9b740dc82e15"
 }