@directive-run/cli 0.5.0 → 0.8.0

package/dist/cli.js

@@ -226,7 +226,7 @@ for await (const chunk of streamResult.stream) {
 \`\`\`
 
 Backpressure: \`"buffer"\` (default), \`"block"\`, \`"drop"\`
-`}function z(){return '# Directive \u2014 AI Coding Rules\n\n> Constraint-driven runtime for TypeScript. `npm install @directive-run/core`\n> Full reference: https://directive.run/llms.txt\n\n## Schema Shape (CRITICAL)\n\n```typescript\nimport { createModule, createSystem, t } from "@directive-run/core";\n\nconst myModule = createModule("name", {\n  schema: {\n    facts: { count: t.number(), items: t.array<string>() },\n    derivations: { total: "number" },\n    events: { increment: "void", addItem: "string" },\n    requirements: { FETCH_DATA: { url: "string" } },\n  },\n  init: (facts) => { facts.count = 0; facts.items = []; },\n  derive: {\n    total: (facts) => facts.items.length + facts.count,\n  },\n  events: {\n    increment: (facts) => { facts.count += 1; },\n    addItem: (facts, item) => { facts.items = [...facts.items, item]; },\n  },\n  constraints: {\n    fetchWhenReady: {\n      when: (facts) => facts.count > 0 && facts.items.length === 0,\n      require: (facts) => ({ type: "FETCH_DATA", url: "/api/items" }),\n    },\n  },\n  resolvers: {\n    fetchData: {\n      requirement: "FETCH_DATA",\n      resolve: async (req, context) => {\n        const data = await fetch(req.url).then(r => r.json());\n        context.facts.items = data;\n      },\n    },\n  },\n});\n\nconst system = createSystem({ module: myModule });\nawait system.settle();\n```\n\n## Top 10 Anti-Patterns\n\n| # | WRONG | CORRECT |\n|---|-------|---------|\n| 1 | `facts.profile as ResourceState<Profile>` | Remove cast \u2014 schema provides types |\n| 2 | `{ phase: t.string() }` flat schema | `schema: { facts: { phase: t.string() } }` |\n| 3 | `facts.items` in multi-module | `facts.self.items` |\n| 4 | `t.map()`, `t.set()`, `t.promise()` | Don\'t exist. Use `t.object<Map<K,V>>()` |\n| 5 | `(req, ctx)` in resolver | `(req, context)` \u2014 never abbreviate |\n| 6 | `createModule("n", { phase: t.string() })` | Must wrap: `schema: { facts: { ... } }` |\n| 7 | `system.dispatch(\'login\', {...})` | `system.events.login({...})` |\n| 8 | `facts.items.push(item)` | `facts.items = [...facts.items, item]` |\n| 9 | `useDirective(system)` | `useSelector(system, s => s.facts.count)` |\n| 10 | `facts[\'auth::status\']` | `facts.auth.status` dot notation |\n\n## Naming\n\n- `req` = requirement (not request). Parameter: `(req, context)`\n- `derive` / derivations \u2014 never "computed" or "selectors"\n- Resolvers return `void` \u2014 mutate `context.facts` instead\n- Always use braces for returns: `if (x) { return y; }`\n- Multi-module: `facts.self.fieldName` for own module facts\n- Events: `system.events.eventName(payload)` \u2014 not `system.dispatch()`\n- Import from main: `import { createModule } from \'@directive-run/core\'`\n\n## Schema Types That Exist\n\n`t.string<T>()`, `t.number()`, `t.boolean()`, `t.array<T>()`, `t.object<T>()`,\n`t.enum("a","b")`, `t.literal(value)`, `t.nullable(inner)`, `t.optional(inner)`, `t.union(...)`\n\nChainable: `.default()`, `.validate()`, `.transform()`, `.brand<>()`, `.refine()`\n\n**DO NOT USE** (hallucinations): `t.map()`, `t.set()`, `t.date()`, `t.tuple()`, `t.record()`, `t.promise()`, `t.any()`\n\n## Key Pattern: Constraint \u2192 Requirement \u2192 Resolver\n\nWhen the user wants "do X when Y": create THREE things:\n1. **Constraint**: `when: (facts) => Y_condition` \u2192 `require: { type: "DO_X" }`\n2. **Resolver**: handles "DO_X", calls API, sets `context.facts`\n3. They are **decoupled**. Constraint declares need, resolver fulfills it.\n'}function E(){return z()+'\n## Anti-Patterns 11-20\n\n| # | WRONG | CORRECT |\n|---|-------|---------|\n| 11 | `module("name").schema({...}).build()` | Prefer `createModule("name", {...})` object syntax |\n| 12 | Returning data from `resolve` | Resolvers return `void` \u2014 mutate `context.facts` |\n| 13 | Async logic in `init` | `init` is synchronous, facts assignment only |\n| 14 | `await system.start()` without settle | Add `await system.settle()` after start |\n| 15 | Missing `crossModuleDeps` | Declare `crossModuleDeps: { auth: authSchema }` |\n| 16 | `require: "TYPE"` string literal | `require: { type: "TYPE" }` object form |\n| 17 | Passthrough derivation `(f) => f.count` | Remove \u2014 read fact directly |\n| 18 | `from \'@directive-run/core/module\'` | `from \'@directive-run/core\'` (main export) |\n| 19 | `async when()` without `deps` | Add `deps: [\'factName\']` for async constraints |\n| 20 | No error boundary on resolver | Use try-catch or module error boundary config |\n'+`
+`}function z(){return '# Directive \u2014 AI Coding Rules\n\n> Constraint-driven runtime for TypeScript. `npm install @directive-run/core`\n> Full reference: https://directive.run/llms.txt\n\n## Schema Shape (CRITICAL)\n\n```typescript\nimport { createModule, createSystem, t } from "@directive-run/core";\n\nconst myModule = createModule("name", {\n  schema: {\n    facts: { count: t.number(), items: t.array<string>() },\n    derivations: { total: "number" },\n    events: { increment: "void", addItem: "string" },\n    requirements: { FETCH_DATA: { url: "string" } },\n  },\n  init: (facts) => { facts.count = 0; facts.items = []; },\n  derive: {\n    total: (facts) => facts.items.length + facts.count,\n  },\n  events: {\n    increment: (facts) => { facts.count += 1; },\n    addItem: (facts, item) => { facts.items = [...facts.items, item]; },\n  },\n  constraints: {\n    fetchWhenReady: {\n      when: (facts) => facts.count > 0 && facts.items.length === 0,\n      require: (facts) => ({ type: "FETCH_DATA", url: "/api/items" }),\n    },\n  },\n  resolvers: {\n    fetchData: {\n      requirement: "FETCH_DATA",\n      resolve: async (req, context) => {\n        const data = await fetch(req.url).then(r => r.json());\n        context.facts.items = data;\n      },\n    },\n  },\n});\n\nconst system = createSystem({ module: myModule });\nawait system.settle();\n```\n\n## Top 10 Anti-Patterns\n\n| # | WRONG | CORRECT |\n|---|-------|---------|\n| 1 | `facts.profile as ResourceState<Profile>` | Remove cast \u2014 schema provides types |\n| 2 | `{ phase: t.string() }` flat schema | `schema: { facts: { phase: t.string() } }` |\n| 3 | `facts.items` in multi-module | `facts.self.items` |\n| 4 | `t.map()`, `t.set()`, `t.promise()` | Don\'t exist. Use `t.object<Map<K,V>>()` |\n| 5 | `(req, ctx)` in resolver | `(req, context)` \u2014 never abbreviate |\n| 6 | `createModule("n", { phase: t.string() })` | Must wrap: `schema: { facts: { ... } }` |\n| 7 | `system.dispatch(\'login\', {...})` | `system.events.login({...})` |\n| 8 | `facts.items.push(item)` | `facts.items = [...facts.items, item]` |\n| 9 | `useDirective(system)` | `useSelector(system, s => s.facts.count)` |\n| 10 | `facts[\'auth::status\']` | `facts.auth.status` dot notation |\n\n## Naming\n\n- `req` = requirement (not request). Parameter: `(req, context)`\n- `derive` / derivations \u2014 never "computed" or "selectors"\n- Resolvers return `void` \u2014 mutate `context.facts` instead\n- Always use braces for returns: `if (x) { return y; }`\n- Multi-module: `facts.self.fieldName` for own module facts\n- Events: `system.events.eventName(payload)` \u2014 not `system.dispatch()`\n- Import from main: `import { createModule } from \'@directive-run/core\'`\n\n## Schema Types That Exist\n\n`t.string<T>()`, `t.number()`, `t.boolean()`, `t.array<T>()`, `t.object<T>()`,\n`t.enum("a","b")`, `t.literal(value)`, `t.nullable(inner)`, `t.optional(inner)`, `t.union(...)`\n\nChainable: `.default()`, `.validate()`, `.transform()`, `.brand<>()`, `.refine()`\n\n**DO NOT USE** (hallucinations): `t.map()`, `t.set()`, `t.date()`, `t.tuple()`, `t.record()`, `t.promise()`, `t.any()`\n\n## Key Pattern: Constraint \u2192 Requirement \u2192 Resolver\n\nWhen the user wants "do X when Y": create THREE things:\n1. **Constraint**: `when: (facts) => Y_condition` \u2192 `require: { type: "DO_X" }`\n2. **Resolver**: handles "DO_X", calls API, sets `context.facts`\n3. They are **decoupled**. Constraint declares need, resolver fulfills it.\n'}function E(){return z()+"\n## Anti-Patterns 11-19\n\n| # | WRONG | CORRECT |\n|---|-------|---------|\n| 11 | Returning data from `resolve` | Resolvers return `void` \u2014 mutate `context.facts` |\n| 12 | Async logic in `init` | `init` is synchronous, facts assignment only |\n| 13 | `await system.start()` without settle | Add `await system.settle()` after start |\n| 14 | Missing `crossModuleDeps` | Declare `crossModuleDeps: { auth: authSchema }` |\n| 15 | `require: \"TYPE\"` string literal | `require: { type: \"TYPE\" }` object form |\n| 16 | Passthrough derivation `(f) => f.count` | Remove \u2014 read fact directly |\n| 17 | `from '@directive-run/core/module'` | `from '@directive-run/core'` (main export) |\n| 18 | `async when()` without `deps` | Add `deps: ['factName']` for async constraints |\n| 19 | No error boundary on resolver | Use try-catch or module error boundary config |\n"+`
 ## Multi-Module
 
 \`\`\`typescript