@vielzeug/codex 26.11.1 → 26.11.3

package/dist/refine-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"refine-catalog.js","sourceRoot":"","sources":["../src/refine-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAS3E,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IACvC,UAAU,CAAmB;IAC7B,eAAe,CAA8B;IAE9D,YAAY,QAAwB;QAClC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,gBAAgB,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,CAC5B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAC7G,CAAC;IACJ,CAAC;IAED,cAAc;QACZ,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,YAAY,CAAC,aAAa,EAAE,4DAA4D,CAAC,CAAC;QACtG,CAAC;QAED,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEpD,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,cAAc,OAAO,cAAc,CAAC,CAAC;QACzF,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}
+{"version":3,"file":"refine-catalog.js","sourceRoot":"","sources":["../src/refine-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAS3E,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IACvC,UAAU,CAA4B;IACtC,eAAe,CAA8B;IAE9D,YAAY,QAAwB;QAClC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChB,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,gBAAgB,CAAC;QAC5C,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,CAC5B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAC7G,CAAC;IACJ,CAAC;IAEO,yBAAyB;QAC/B,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,YAAY,CAAC,aAAa,EAAE,4DAA4D,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEpD,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,cAAc,OAAO,cAAc,CAAC,CAAC;QACzF,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/refine.d.ts

@@ -1,12 +1,7 @@
-/**
- * `@vielzeug/codex/refine`: opt-in Refine component tools.
- *
- * The main entry (`@vielzeug/codex`) registers only generic, product-agnostic package
- * tools. Refine-specific tools (`refine-*`) live here behind a subpath so the core
- * documentation server stays reusable without Refine. Call `registerRefineTools()` on
- * a server created by `createMcpServer()` to upgrade it to the full Refine-augmented
- * tool surface.
- */
+import type { Server } from '@modelcontextprotocol/server';
+import type { RefineCatalog } from './refine-catalog.js';
+import { type McpServerOptions } from './server.js';
+/** Creates an MCP server with both package and Refine component tools. */
+export declare function createMcpServerWithRefine(catalog: RefineCatalog, options: McpServerOptions): Server;
 export { type RefineCatalog, SnapshotRefineCatalog } from './refine-catalog.js';
-export { refineTools, registerRefineTools } from './tools/refine.js';
 export type { CemAttribute, CemCssPart, CemCssProperty, CemDeclaration, CemEvent, CemMember, CemSlot, } from './types.js';

package/dist/refine.js

@@ -1,12 +1,9 @@
-/**
- * `@vielzeug/codex/refine`: opt-in Refine component tools.
- *
- * The main entry (`@vielzeug/codex`) registers only generic, product-agnostic package
- * tools. Refine-specific tools (`refine-*`) live here behind a subpath so the core
- * documentation server stays reusable without Refine. Call `registerRefineTools()` on
- * a server created by `createMcpServer()` to upgrade it to the full Refine-augmented
- * tool surface.
- */
+import { createMcpServerWithTools } from './server.js';
+import { packageTools } from './tools/index.js';
+import { refineTools } from './tools/refine.js';
+/** Creates an MCP server with both package and Refine component tools. */
+export function createMcpServerWithRefine(catalog, options) {
+    return createMcpServerWithTools(catalog, options, [...packageTools, ...refineTools]);
+}
 export { SnapshotRefineCatalog } from './refine-catalog.js';
-export { refineTools, registerRefineTools } from './tools/refine.js';
 //# sourceMappingURL=refine.js.map

package/dist/refine.js.map

@@ -1 +1 @@
-{"version":3,"file":"refine.js","sourceRoot":"","sources":["../src/refine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAsB,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"refine.js","sourceRoot":"","sources":["../src/refine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAyB,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,0EAA0E;AAC1E,MAAM,UAAU,yBAAyB,CAAC,OAAsB,EAAE,OAAyB;IACzF,OAAO,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,YAAY,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,OAAO,EAAsB,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/server.d.ts

@@ -1,11 +1,10 @@
 import { Server } from '@modelcontextprotocol/server';
 import type { Catalog } from './catalog.js';
-/**
- * Creates an MCP server with the generic package tools registered. Refine-specific
- * tools are opt-in via `@vielzeug/codex/refine`'s `registerRefineTools()`: the main
- * library entry stays product-agnostic.
- */
-export declare function createMcpServer(catalog: Catalog, options: {
+import type { ToolDefinition } from './tools/shared.js';
+export interface McpServerOptions {
     debug?: boolean;
     version: string;
-}): Server;
+}
+export declare function createMcpServerWithTools<CatalogType extends Catalog>(catalog: CatalogType, options: McpServerOptions, tools: readonly ToolDefinition<CatalogType>[]): Server;
+/** Creates an MCP server with the generic package tools registered. */
+export declare function createMcpServer(catalog: Catalog, options: McpServerOptions): Server;

package/dist/server.js

@@ -1,13 +1,12 @@
 import { Server } from '@modelcontextprotocol/server';
 import { packageTools, registerTools } from './tools/index.js';
-/**
- * Creates an MCP server with the generic package tools registered. Refine-specific
- * tools are opt-in via `@vielzeug/codex/refine`'s `registerRefineTools()`: the main
- * library entry stays product-agnostic.
- */
-export function createMcpServer(catalog, options) {
+export function createMcpServerWithTools(catalog, options, tools) {
     const server = new Server({ name: 'vielzeug', version: options.version }, { capabilities: { tools: {} } });
-    registerTools(server, catalog, packageTools, options.debug);
+    registerTools(server, catalog, tools, options.debug);
     return server;
 }
+/** Creates an MCP server with the generic package tools registered. */
+export function createMcpServer(catalog, options) {
+    return createMcpServerWithTools(catalog, options, packageTools);
+}
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAItD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,OAA6C;IAC7F,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAE3G,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAE5D,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAItD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAQ/D,MAAM,UAAU,wBAAwB,CACtC,OAAoB,EACpB,OAAyB,EACzB,KAA6C;IAE7C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAE3G,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAErD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,OAAyB;IACzE,OAAO,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;AAClE,CAAC"}

package/dist/snapshot.d.ts

@@ -6,11 +6,11 @@ export declare function parseContent(value: unknown, slug: string): PackageConte
 export declare function parseSearch(value: unknown, catalog: CatalogFile): SearchRecord[];
 export declare function parseRefine(value: unknown): CemDeclaration[];
 export interface LoadedSnapshot {
-    catalog: CatalogFile;
-    contentDirectory: string;
-    manifest: SnapshotManifest;
-    refineComponents: CemDeclaration[];
-    search: SearchRecord[];
+    readonly catalog: CatalogFile;
+    readonly contentDirectory: string;
+    readonly manifest: SnapshotManifest;
+    readonly refineComponents: readonly CemDeclaration[];
+    readonly search: readonly SearchRecord[];
 }
 export declare function loadSnapshotDirectory(directory: string, options?: {
     validateContents?: boolean;

package/dist/tools/refine.d.ts

@@ -1,5 +1,3 @@
-import type { Server } from '@modelcontextprotocol/server';
 import type { RefineCatalog } from '../refine-catalog.js';
 import type { ToolDefinition } from './shared.js';
 export declare const refineTools: readonly ToolDefinition<RefineCatalog>[];
-export declare function registerRefineTools(server: Server, catalog: RefineCatalog, debug?: boolean): void;

package/dist/tools/refine.js

@@ -1,4 +1,3 @@
-import { packageTools, registerTools } from './index.js';
 import { EMPTY_SCHEMA, parseArgs } from './schema.js';
 const tag = {
     additionalProperties: false,
@@ -132,7 +131,4 @@ export const refineTools = [
         name: 'refine-validate-usage',
     },
 ];
-export function registerRefineTools(server, catalog, debug = false) {
-    registerTools(server, catalog, [...packageTools, ...refineTools], debug);
-}
 //# sourceMappingURL=refine.js.map

package/dist/tools/refine.js.map

@@ -1 +1 @@
-{"version":3,"file":"refine.js","sourceRoot":"","sources":["../../src/tools/refine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"refine.js","sourceRoot":"","sources":["../../src/tools/refine.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -2,113 +2,113 @@ export declare const DOC_PAGES: readonly ["index", "api", "usage", "examples"];
 export type DocPage = (typeof DOC_PAGES)[number];
 export declare const SNAPSHOT_SCHEMA_VERSION: 1;
 export interface CemTypeRef {
-    text: string;
+    readonly text: string;
 }
 export interface CemAttribute {
-    default?: string;
-    description?: string;
-    fieldName?: string;
-    name: string;
-    type?: CemTypeRef;
+    readonly default?: string;
+    readonly description?: string;
+    readonly fieldName?: string;
+    readonly name: string;
+    readonly type?: CemTypeRef;
 }
 export interface CemCssPart {
-    description?: string;
-    name: string;
+    readonly description?: string;
+    readonly name: string;
 }
 export interface CemCssProperty {
-    default?: string;
-    description?: string;
-    name: string;
+    readonly default?: string;
+    readonly description?: string;
+    readonly name: string;
 }
 export interface CemEvent {
-    description?: string;
-    name: string;
-    type?: CemTypeRef;
+    readonly description?: string;
+    readonly name: string;
+    readonly type?: CemTypeRef;
 }
 export interface CemMember {
-    description?: string;
-    kind?: 'field' | 'method';
-    name: string;
-    type?: CemTypeRef;
+    readonly description?: string;
+    readonly kind?: 'field' | 'method';
+    readonly name: string;
+    readonly type?: CemTypeRef;
 }
 export interface CemSlot {
-    description?: string;
-    name: string;
+    readonly description?: string;
+    readonly name: string;
 }
 export interface CemDeclaration {
-    attributes?: CemAttribute[];
-    cssParts?: CemCssPart[];
-    cssProperties?: CemCssProperty[];
-    description?: string;
-    events?: CemEvent[];
-    members?: CemMember[];
-    name?: string;
-    slots?: CemSlot[];
-    superclass?: {
-        name: string;
-        package?: string;
+    readonly attributes?: readonly CemAttribute[];
+    readonly cssParts?: readonly CemCssPart[];
+    readonly cssProperties?: readonly CemCssProperty[];
+    readonly description?: string;
+    readonly events?: readonly CemEvent[];
+    readonly members?: readonly CemMember[];
+    readonly name?: string;
+    readonly slots?: readonly CemSlot[];
+    readonly superclass?: {
+        readonly name: string;
+        readonly package?: string;
     };
-    tagName?: string;
-    [key: string]: unknown;
+    readonly tagName?: string;
+    readonly [key: string]: unknown;
 }
 export interface Example {
-    code: string;
-    id: string;
-    name: string;
+    readonly code: string;
+    readonly id: string;
+    readonly name: string;
 }
 export interface PackageMeta {
-    availableDocPages: DocPage[];
-    category: string;
-    description: string;
-    exampleIds: string[];
-    exports: string[];
-    hasSource: boolean;
-    keywords: string[];
-    name: string;
-    related: string[];
-    slug: string;
-    version: string;
+    readonly availableDocPages: readonly DocPage[];
+    readonly category: string;
+    readonly description: string;
+    readonly exampleIds: readonly string[];
+    readonly exports: readonly string[];
+    readonly hasSource: boolean;
+    readonly keywords: readonly string[];
+    readonly name: string;
+    readonly related: readonly string[];
+    readonly slug: string;
+    readonly version: string;
 }
 export interface PackageContent {
-    apiSource: string | null;
-    docs: Partial<Record<DocPage, string>>;
-    examples: Example[];
-    typeSignatures: Record<string, string>;
+    readonly apiSource: string | null;
+    readonly docs: Readonly<Partial<Record<DocPage, string>>>;
+    readonly examples: readonly Example[];
+    readonly typeSignatures: Readonly<Record<string, string>>;
 }
 export interface CatalogFile {
-    packages: PackageMeta[];
-    version: string;
+    readonly packages: readonly PackageMeta[];
+    readonly version: string;
 }
 export interface SearchRecord {
-    category: string;
-    description: string;
-    docs: Partial<Record<DocPage, string>>;
-    examples: Array<{
-        id: string;
-        text: string;
-    }>;
-    exports: string;
-    keywords: string;
-    name: string;
-    related: string;
-    slug: string;
-    source: string | null;
+    readonly category: string;
+    readonly description: string;
+    readonly docs: Readonly<Partial<Record<DocPage, string>>>;
+    readonly examples: readonly {
+        readonly id: string;
+        readonly text: string;
+    }[];
+    readonly exports: string;
+    readonly keywords: string;
+    readonly name: string;
+    readonly related: string;
+    readonly slug: string;
+    readonly source: string | null;
 }
 export interface SnapshotPointer {
-    directory: string;
+    readonly directory: string;
 }
 export interface SnapshotManifest {
-    catalog: 'catalog.json';
-    contentDirectory: 'packages';
-    refine: 'refine.json' | null;
-    schemaVersion: typeof SNAPSHOT_SCHEMA_VERSION;
-    search: 'search.json';
-    version: string;
+    readonly catalog: 'catalog.json';
+    readonly contentDirectory: 'packages';
+    readonly refine: 'refine.json' | null;
+    readonly schemaVersion: typeof SNAPSHOT_SCHEMA_VERSION;
+    readonly search: 'search.json';
+    readonly version: string;
 }
 export interface SnapshotArtifacts {
-    catalog: CatalogFile;
-    contents: ReadonlyMap<string, PackageContent>;
-    manifest: SnapshotManifest;
-    refineComponents: CemDeclaration[];
-    search: SearchRecord[];
+    readonly catalog: CatalogFile;
+    readonly contents: ReadonlyMap<string, PackageContent>;
+    readonly manifest: SnapshotManifest;
+    readonly refineComponents: readonly CemDeclaration[];
+    readonly search: readonly SearchRecord[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vielzeug/codex",
-  "version": "26.11.1",
+  "version": "26.11.3",
   "description": "MCP server exposing all Vielzeug docs to AI clients",
   "repository": {
     "type": "git",
@@ -63,7 +63,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.6.5",
-    "@vielzeug/refine": "26.11.1",
+    "@vielzeug/refine": "26.11.3",
     "typescript": "^6.0.3",
     "vitest": "^5.0.5"
   }

package/skills/vielzeug/SKILL.md

@@ -9,7 +9,7 @@ Vielzeug is a monorepo of independently published TypeScript packages. "Zero dep
 
 ## Detect
 
-1. Read `package.json` (`dependencies`, `devDependencies`, `peerDependencies`) and list every `@vielzeug/*` entry.
+1. Read `package.json` (`dependencies`, `devDependencies`, `peerDependencies`) and list every `@vielzeug/*` entry. Resolve each installed version from `node_modules/@vielzeug/<pkg>/package.json` when present, otherwise from the package-manager lockfile.
 2. Note whether `@vielzeug/refine` is installed. If it is, the **Refine** and **Theme** sections below are mandatory for any UI work.
 3. Read the project's own agent contract (`AGENTS.md`, `.github/copilot-instructions.md`) first: project rules win over this skill.
 
@@ -26,10 +26,12 @@ Never guess exports, attributes, events, slots, or token names. Look them up:
 | Which Refine components exist? | `refine-list-components` | `node_modules/@vielzeug/refine/dist/custom-elements.json` |
 | Attributes, properties, events, slots, CSS parts of `ore-*` | `refine-get-component` | same manifest |
 | Available design tokens | `refine-get-tokens` | `node_modules/@vielzeug/refine/dist/styles/tokens.css` |
-| Is my markup valid? | `refine-validate-usage` | compare against the manifest |
+| Are component attribute names recognized? | `refine-validate-usage` | compare against the manifest |
 | Blank component scaffold | `refine-generate-template` | N/A |
 
-If MCP is unavailable, use the offline fallback first. If it does not contain the needed information and MCP setup would help, ask before running `npx -y @vielzeug/codex` or changing MCP configuration; setup details are in `node_modules/@vielzeug/codex/mcp-setup.json`.
+Codex serves a versioned snapshot, which may not match the versions installed in the project or include the newest packages. Compare `get-package`'s `version` with the installed version before using its API docs or signatures. If they differ, treat the installed package's declarations, docs, and runtime as authoritative; do not use newer snapshot APIs unless the dependency is deliberately updated. Treat the generated package list as a discovery aid, not proof that no other package exists.
+
+If MCP is unavailable, use the offline fallback first. Check installed packages and the lockfile when the generated package list has no match. If the needed information is still unavailable and MCP setup would help, ask before running `npx -y @vielzeug/codex` or changing MCP configuration; setup details are in `node_modules/@vielzeug/codex/mcp-setup.json`.
 
 ## Use the owning package
 
@@ -88,7 +90,7 @@ Common compositions (verify each API with `get-docs` before writing code):
 - **Data**: `courier` for HTTP with caching and structured errors; `sourcerer` for paged/cursor/infinite collections; `vault` for storage; `postmaster` for durable jobs; `scout` for fuzzy search; `mesh` for backendless peer sessions on a LAN; `sigil` for QR generation/scanning: prefer `ore-qr-code` / `ore-qr-scanner` when Refine is installed.
 - **Forms**: `forge` for form state, validation, and submission; `spell` for schemas; render fields with Refine inputs when Refine is installed.
 - **App shell**: `wayfinder` routing; `conduit` DI; `herald` events; `lingua` i18n; `rune` logging; `ward` authorization; `keymap` shortcuts.
-- **Dispose** every handle you create (`effect`, subscriptions, clients) when its owner unmounts. Vielzeug APIs return disposables: use them.
+- **Own cleanup** for every stateful handle or subscription whose API documents disposal or unsubscription, and tie it to the owner's lifecycle. Pure functions and value-returning APIs need no cleanup; verify the specific API contract rather than assuming it returns a disposable.
 
 ## Refine (when `@vielzeug/refine` is installed)
 
@@ -105,17 +107,17 @@ Refine is the UI layer. Build interfaces from `ore-*` elements before anything e
 
 2. **Register per component** through explicit side-effect subpaths (`import '@vielzeug/refine/button'`), never the whole library, unless the project already does so.
 
-3. **Component first.** For any of these needs, use the Refine element rather than a native element, a hand-built composite, or a third-party widget: buttons, inputs, selects, comboboxes, checkboxes, radios, switches, sliders, date/time pickers, file inputs, OTP, rating, textareas, forms, cards, tables, data grids, lists, tabs, accordions, dialogs, drawers, menus, popovers, tooltips, toasts, alerts, badges, chips, progress, skeletons, avatars, breadcrumbs, pagination, steppers, navbars, sidebars, grids, command palettes. Confirm the tag with `refine-list-components`; read its contract with `refine-get-component`.
+3. **Prefer Refine components when they fit.** For common interface controls and widgets such as buttons, inputs, selects, dialogs, menus, tables, and tabs, first check whether Refine has a component whose documented behavior fits the feature and the project's framework, accessibility, and runtime requirements. Confirm the tag with `refine-list-components`; read its contract with `refine-get-component`. If no component fits or a project requirement makes it unsuitable, use the simplest appropriate native element or other package and briefly explain the choice; do not build a parallel composite when a suitable Refine component exists.
 
-4. **Native elements only for document semantics** that no Refine component duplicates (`<main>`, `<section>`, `<article>`, `<h1>`–`<h6>`, `<p>`, `<a>` for plain links, `<img>`).
+4. **Use native elements for document semantics** (`<main>`, `<section>`, `<article>`, headings, paragraphs, plain links, and images), and when they are the better fit for a documented project or platform constraint.
 
 5. **Follow the element contract**: attributes for primitives, JavaScript properties for objects/arrays/callbacks, standard DOM events (read state from `event.target`), named slots for composition. Icon-only controls need an accessible label.
 
 6. **Type the tags** once in a type entry point: `import type {} from '@vielzeug/refine/frameworks/elements'` (or `/react`, `/vue`). Framework wiring (React 18/19, Vue, Svelte, Angular, SSR guards) is documented in the Refine `frameworks` doc: fetch it with `get-docs` before integrating.
 
-7. **Validate** every fragment you write with `refine-validate-usage` before finishing.
+7. **Check attribute names** with `refine-validate-usage` when available. It only checks for unknown attributes on the specified component's opening tag; it does not validate HTML generally, attribute values, JavaScript properties, events, slots, accessibility, or runtime behavior. Check those against the component docs and relevant tests instead.
 
-8. **Missing capability?** Do not build a parallel component in the app. Compose existing `ore-*` elements (optionally with `@vielzeug/ore` for a custom element), and report the gap.
+8. **Missing capability?** Compose existing `ore-*` elements when they fit. If none meets the documented feature and project requirements, use the simplest appropriate native element or other package and report the gap; avoid a parallel composite when a suitable Refine component exists.
 
 ## Theme (when `@vielzeug/refine` is installed)
 
@@ -128,7 +130,7 @@ Refine is the UI layer. Build interfaces from `ore-*` elements before anything e
 
 ## Other UI packages
 
-Refine covers the widget layer; these cover what it does not. Use them directly only when no `ore-*` element already provides the behavior:
+Refine covers the widget layer; these provide specialized behavior it may not cover. Use the package that best fits the requirement, and prefer an `ore-*` element when it provides the needed behavior:
 
 - `prism`: SVG charts (line, bar, area, pie, sparkline) plus `@vielzeug/prism/theme`.
 - `scroll`: virtualized large lists (prefer `ore-datagrid`/`ore-list` for ordinary sizes).
@@ -141,8 +143,8 @@ Refine covers the widget layer; these cover what it does not. Use them directly
 ## Anti-patterns
 
 - Hand-rolled signals, fetch wrappers, validators, routers, i18n, or DI when the package is installed.
-- Custom modal, dropdown, tooltip, select, tabs, or toast implementations while Refine is installed.
-- `<button>`, `<input>`, `<select>`, `<table>` for interactive UI while Refine is installed.
+- Custom modal, dropdown, tooltip, select, tabs, or toast implementations when a suitable Refine component meets the project requirements.
+- Native `<button>`, `<input>`, `<select>`, or `<table>` for interactive UI when a suitable Refine component meets the project requirements.
 - Inline colors, magic pixel values, `!important`, or `@media (prefers-color-scheme)` color rules.
 - Inventing an attribute, event, or slot that `refine-get-component` does not list.
 - Forgetting `tokens.css`/`fouc.css`, or importing the whole library when subpaths suffice.
@@ -152,6 +154,6 @@ Refine covers the widget layer; these cover what it does not. Use them directly
 
 - Every new capability maps to an installed `@vielzeug/*` package or is justified as out of scope.
 - No parallel implementation of something an installed package provides.
-- With Refine installed: all interactive UI is `ore-*`, `tokens.css` + `fouc.css` are loaded once, every fragment passed `refine-validate-usage`, and app CSS uses tokens only.
-- Every disposable is disposed by its owner.
+- With Refine installed: prefer `ore-*` for interactive UI when its documented contract fits; load `tokens.css` + `fouc.css` once, use the attribute checker within its stated limits, and use Refine tokens for app styling where suitable tokens exist.
+- Every API that documents an owned resource or cleanup operation is integrated with the owning lifecycle; pure and value-returning APIs are not given invented cleanup.
 - Claims about package APIs were verified with `get-docs` / `get-type-signature`, not recalled.