@directive-run/cli 0.2.0 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/templates/claude.ts","../src/templates/cursor.ts","../src/templates/copilot.ts","../src/templates/cline.ts","../src/templates/llms-txt.ts","../src/templates/windsurf.ts","../src/templates/index.ts","../src/lib/detect.ts","../src/lib/monorepo.ts","../src/lib/constants.ts","../src/lib/merge.ts","../src/lib/loader.ts"],"names":["getKnowledge","knowledge","getAllKnowledge","getAllExamples","existsSync","join","resolve","dirname","readFileSync","pc"],"mappings":"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","file":"index.cjs","sourcesContent":["import { getKnowledge } from \"../lib/knowledge.js\";\n\n/**\n * Generate Claude Code rules (~30KB).\n * Strategy: Full anti-patterns + core-patterns + naming + schema-types (most critical),\n * condensed summaries for everything else.\n */\nexport function generateClaudeRules(): string {\n // These 4 files are included in full (~25KB)\n const corePatterns = getKnowledge(\"core-patterns\");\n const antiPatterns = getKnowledge(\"anti-patterns\");\n const naming = getKnowledge(\"naming\");\n const schemaTypes = getKnowledge(\"schema-types\");\n\n return `# Directive — Complete AI Coding Rules\n\n> Constraint-driven runtime for TypeScript. Declare requirements, let the runtime resolve them.\n> https://directive.run | \\`npm install @directive-run/core\\`\n> Full reference with examples: https://directive.run/llms.txt\n\n## Core Patterns\n\n${corePatterns}\n\n---\n\n## Anti-Patterns (All 36)\n\n${antiPatterns}\n\n### AI Package Anti-Patterns (21-36)\n\n| # | WRONG | CORRECT |\n|---|-------|---------|\n| 21 | TS types for factsSchema: \\`{ confidence: number }\\` | Use \\`{ confidence: t.number() }\\` |\n| 22 | \\`facts.cache.push(item)\\` in orchestrator | \\`facts.cache = [...facts.cache, item]\\` |\n| 23 | Returning data from orchestrator \\`resolve\\` | Resolvers return \\`void\\` — mutate \\`context.facts\\` |\n| 24 | Forgetting \\`orchestrator.start()\\` multi-agent | Single: implicit. Multi: must call \\`start()\\` |\n| 25 | Catching \\`Error\\` not \\`GuardrailError\\` | \\`GuardrailError\\` has \\`.guardrailName\\`, \\`.errorCode\\` |\n| 26 | \\`from '@directive-run/ai'\\` for adapters | Subpath: \\`from '@directive-run/ai/openai'\\` |\n| 27 | Assuming \\`{ input_tokens }\\` structure | Normalized: \\`{ inputTokens, outputTokens }\\` |\n| 28 | Same CircuitBreaker across agents | Create separate instances per dependency |\n| 29 | \\`budgetWarningThreshold: 1.5\\` | Must be 0-1 (percentage) |\n| 30 | \\`race\\` minSuccess > agents.length | Must be \\`1 ≤ minSuccess ≤ agents.length\\` |\n| 31 | Async summarizer with autoManage: true | Use \\`autoManage: false\\` for sync control |\n| 32 | Side effects in reflect \\`evaluator\\` | Evaluator must be pure |\n| 33 | Task calling \\`runSingleAgent\\` | Tasks can't call agents — separate node |\n| 34 | Task expecting object input | Input is always \\`string\\` — \\`JSON.parse(input)\\` |\n| 35 | Task ID same as agent ID | IDs share namespace — distinct names |\n| 36 | \\`from '@directive-run/ai/mcp'\\` | \\`from '@directive-run/ai'\\` (main export) |\n\n---\n\n## Naming Conventions\n\n${naming}\n\n---\n\n## Schema Type Builders\n\n${schemaTypes}\n\n---\n\n## Multi-Module Quick Reference\n\n\\`\\`\\`typescript\n// Two modules with cross-module dependency\nconst authSchema = { facts: { token: t.string(), isAuth: t.boolean() } };\nconst authModule = createModule(\"auth\", { schema: authSchema, /* ... */ });\n\nconst cartModule = createModule(\"cart\", {\n schema: { facts: { items: t.array<CartItem>() } },\n crossModuleDeps: { auth: authSchema }, // Declare dependency\n constraints: {\n checkout: {\n when: (facts) => facts.self.items.length > 0 && facts.auth.isAuth, // facts.self.* for own, facts.auth.* for cross\n require: () => ({ type: \"CHECKOUT\" }),\n },\n },\n // ...\n});\n\nconst system = createSystem({ modules: { auth: authModule, cart: cartModule } });\n// Access: system.facts.auth.token, system.events.cart.addItem({...})\n\\`\\`\\`\n\nKey rules:\n- \\`facts.self.*\\` for own module facts in constraints/resolvers\n- \\`facts.otherModule.*\\` for cross-module reads\n- \\`crossModuleDeps\\` must declare consumed schemas\n- \\`system.events.moduleName.eventName(payload)\\` for namespaced events\n- The \\`::\\` separator is internal — always use dot notation\n\n---\n\n## Constraints\n\n- \\`when(facts)\\` → boolean. When true, requirement is emitted.\n- \\`require(facts)\\` → \\`{ type: \"TYPE\", ...data }\\` object (never string literal)\n- \\`priority: number\\` — higher evaluated first\n- \\`after: [\"constraintName\"]\\` — ordering within same priority\n- Async: \\`async: true\\` + \\`deps: ['factName']\\` (deps REQUIRED for async)\n- Constraints DECLARE needs, resolvers FULFILL them — decoupled.\n\n---\n\n## Resolvers\n\n- \\`resolve(req, context)\\` — async, returns \\`void\\`. Mutate \\`context.facts.*\\`.\n- \\`requirement: \"TYPE\"\\` — which type this handles\n- \\`key: (req) => string\\` — deduplication key\n- \\`retry: { attempts: 3, backoff: \"exponential\", initialDelay: 100 }\\`\n- \\`batch: { maxSize: 10, windowMs: 50 }\\` for N+1 prevention\n- Always \\`await system.settle()\\` after start to wait for resolution\n\n---\n\n## System API\n\n- \\`system.facts.fieldName\\` — read/write facts\n- \\`system.derive.derivationName\\` — read derived values\n- \\`system.events.eventName(payload)\\` — dispatch events\n- \\`system.subscribe(listener)\\` — subscribe to all changes\n- \\`system.read(key)\\` — read fact or derivation by string key\n- \\`system.inspect()\\` — full state snapshot\n- \\`system.settle()\\` — wait for async operations\n- \\`system.start()\\` / \\`system.stop()\\` / \\`system.destroy()\\`\n\n---\n\n## React (\\`@directive-run/react\\`)\n\n\\`\\`\\`typescript\nimport { useSelector, useEvent } from \"@directive-run/react\";\n\nconst count = useSelector(system, (s) => s.facts.count);\nconst events = useEvent(system);\n// onClick={() => events.increment()}\n\\`\\`\\`\n\n**NO** \\`useDirective()\\` hook. Use \\`useSelector\\` + \\`useEvent\\`.\n\n---\n\n## Plugins (\\`@directive-run/core/plugins\\`)\n\n\\`devtoolsPlugin()\\`, \\`loggingPlugin()\\`, \\`persistencePlugin(config)\\`,\n\\`createCircuitBreaker(config)\\`, \\`createObservability(config)\\`\n\n---\n\n## AI Package (\\`@directive-run/ai\\`)\n\n### Single-Agent Orchestrator\n\n\\`\\`\\`typescript\nimport { createAgentOrchestrator, t } from '@directive-run/ai';\nimport { createAnthropicRunner } from '@directive-run/ai/anthropic';\n\nconst orchestrator = createAgentOrchestrator({\n runner: createAnthropicRunner({ apiKey }),\n factsSchema: { result: t.string(), confidence: t.number() },\n init: (facts) => { facts.result = \"\"; facts.confidence = 0; },\n maxTokenBudget: 100000,\n budgetWarningThreshold: 0.8,\n guardrails: { input: [...], output: [...] },\n memory: createAgentMemory({ strategy: createSlidingWindowStrategy({ maxMessages: 30 }) }),\n debug: true,\n});\n\nconst result = await orchestrator.run(agent, \"analyze this\");\n\\`\\`\\`\n\n### Multi-Agent\n\n\\`\\`\\`typescript\nimport { createMultiAgentOrchestrator, parallel, sequential, dag } from '@directive-run/ai';\n\nconst orch = createMultiAgentOrchestrator({\n agents: { researcher: agentA, writer: agentB },\n patterns: {\n pipeline: sequential([\"researcher\", \"writer\"]),\n brainstorm: parallel([\"researcher\", \"writer\"], mergeResults),\n workflow: dag([\n { id: \"research\", handler: \"researcher\" },\n { id: \"write\", handler: \"writer\", dependencies: [\"research\"] },\n ]),\n },\n runner,\n});\norch.start(); // Required for multi-agent!\n\\`\\`\\`\n\n8 patterns: \\`parallel\\`, \\`sequential\\`, \\`supervisor\\`, \\`dag\\`, \\`reflect\\`, \\`race\\`, \\`debate\\`, \\`goal\\`\n\n### Adapter Imports (Subpath!)\n\n\\`\\`\\`typescript\nimport { createAnthropicRunner } from '@directive-run/ai/anthropic';\nimport { createOpenAIRunner } from '@directive-run/ai/openai';\nimport { createOllamaRunner } from '@directive-run/ai/ollama';\nimport { createGeminiRunner } from '@directive-run/ai/gemini';\n\\`\\`\\`\n\n### Guardrails\n\n\\`createPIIGuardrail\\`, \\`createModerationGuardrail\\`, \\`createRateLimitGuardrail\\`,\n\\`createToolGuardrail\\`, \\`createOutputSchemaGuardrail\\`, \\`createLengthGuardrail\\`,\n\\`createContentFilterGuardrail\\`\n\n\\`GuardrailResult: { passed: boolean, reason?: string, transformed?: unknown }\\`\n\n### Memory\n\n\\`createAgentMemory({ strategy, summarizer?, autoManage? })\\`\nStrategies: \\`createSlidingWindowStrategy\\`, \\`createTokenBasedStrategy\\`, \\`createHybridStrategy\\`\nSummarizers: \\`createTruncationSummarizer\\`, \\`createKeyPointsSummarizer\\`, \\`createLLMSummarizer(runner)\\`\n\n### Streaming\n\n\\`\\`\\`typescript\nconst streamResult = orchestrator.runStream(agent, \"analyze\");\nfor await (const chunk of streamResult.stream) {\n switch (chunk.type) {\n case \"token\": process.stdout.write(chunk.data); break;\n case \"done\": console.log(\"Tokens:\", chunk.totalTokens); break;\n case \"error\": console.error(chunk.error); break;\n }\n}\n\\`\\`\\`\n\nBackpressure: \\`\"buffer\"\\` (default), \\`\"block\"\\`, \\`\"drop\"\\`\n`;\n}\n","/**\n * Generate Cursor rules (<10KB).\n * Handcrafted condensed content — core patterns, top 10 anti-patterns, naming, 1 mini example.\n */\nexport function generateCursorRules(): string {\n return `# Directive — 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 — 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)\\` — 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 — never \"computed\" or \"selectors\"\n- Resolvers return \\`void\\` — 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)\\` — 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 → Requirement → Resolver\n\nWhen the user wants \"do X when Y\": create THREE things:\n1. **Constraint**: \\`when: (facts) => Y_condition\\` → \\`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`;\n}\n","import { generateCursorRules } from \"./cursor.js\";\n\n/**\n * Generate GitHub Copilot instructions (~12KB).\n * Cursor content + all 20 anti-patterns + schema types detail + AI basics.\n */\nexport function generateCopilotRules(): string {\n const base = generateCursorRules();\n\n // Add anti-patterns 11-20 that cursor doesn't include\n const extraAntiPatterns = `\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\\` — 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 — 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`;\n\n // Add multi-module basics\n const multiModule = `\n## Multi-Module\n\n\\`\\`\\`typescript\nconst system = createSystem({\n modules: { auth: authModule, cart: cartModule },\n});\n\n// Access: system.facts.auth.token, system.events.cart.addItem({...})\n// In constraints/resolvers: use facts.self.* for own module\n// Declare deps: crossModuleDeps: { auth: authSchema }\n\\`\\`\\`\n`;\n\n // Add AI basics\n const aiBasics = `\n## AI Package Basics (\\`@directive-run/ai\\`)\n\n\\`\\`\\`typescript\nimport { createAgentOrchestrator, t } from '@directive-run/ai';\nimport { createAnthropicRunner } from '@directive-run/ai/anthropic'; // Subpath import!\n\nconst orchestrator = createAgentOrchestrator({\n runner: createAnthropicRunner({ apiKey: process.env.ANTHROPIC_API_KEY }),\n factsSchema: { result: t.string(), confidence: t.number() }, // Use t.*() !\n init: (facts) => { facts.result = \"\"; facts.confidence = 0; },\n});\n\nconst result = await orchestrator.run(agent, \"analyze this\");\n\\`\\`\\`\n\n**AI Anti-Patterns:**\n- Use \\`t.number()\\` not \\`number\\` for factsSchema\n- Subpath imports: \\`from '@directive-run/ai/anthropic'\\` not \\`from '@directive-run/ai'\\`\n- Token usage normalized: \\`{ inputTokens, outputTokens }\\` (not provider-specific)\n- \\`facts.cache = [...facts.cache, item]\\` not \\`facts.cache.push(item)\\`\n`;\n\n return base + extraAntiPatterns + multiModule + aiBasics;\n}\n","import { generateCopilotRules } from \"./copilot.js\";\n\n/**\n * Generate Cline rules (~12KB).\n * Same content as Copilot.\n */\nexport function generateClineRules(): string {\n return generateCopilotRules();\n}\n","import { getAllExamples, getAllKnowledge } from \"../lib/knowledge.js\";\n\n/**\n * Generate llms.txt (no size limit).\n * Content: complete reference + all 7 examples + full 26-file knowledge base.\n */\nexport function generateLlmsTxt(): string {\n const knowledge = getAllKnowledge();\n const examples = getAllExamples();\n\n // Order: core knowledge first, then AI, then api-skeleton\n const coreOrder = [\n \"core-patterns\",\n \"anti-patterns\",\n \"naming\",\n \"multi-module\",\n \"constraints\",\n \"resolvers\",\n \"error-boundaries\",\n \"testing\",\n \"time-travel\",\n \"schema-types\",\n \"system-api\",\n \"react-adapter\",\n \"plugins\",\n ];\n\n const aiOrder = [\n \"ai-orchestrator\",\n \"ai-multi-agent\",\n \"ai-tasks\",\n \"ai-agents-streaming\",\n \"ai-guardrails-memory\",\n \"ai-adapters\",\n \"ai-budget-resilience\",\n \"ai-mcp-rag\",\n \"ai-communication\",\n \"ai-debug-observability\",\n \"ai-security\",\n \"ai-testing-evals\",\n ];\n\n const exampleOrder = [\n \"counter\",\n \"auth-flow\",\n \"shopping-cart\",\n \"error-boundaries\",\n \"ai-orchestrator\",\n \"fraud-analysis\",\n \"ai-checkpoint\",\n ];\n\n const sections = [\n \"# Directive — Complete AI Reference (llms.txt)\",\n \"\",\n \"> Constraint-driven runtime for TypeScript.\",\n \"> Declare requirements. Let the runtime resolve them.\",\n \"> https://directive.run\",\n \"\",\n \"## Core API (@directive-run/core)\",\n \"\",\n ];\n\n for (const name of coreOrder) {\n const content = knowledge.get(name);\n if (content) {\n sections.push(content, \"\", \"---\", \"\");\n }\n }\n\n sections.push(\"## AI Package (@directive-run/ai)\", \"\");\n\n for (const name of aiOrder) {\n const content = knowledge.get(name);\n if (content) {\n sections.push(content, \"\", \"---\", \"\");\n }\n }\n\n // API Skeleton\n const apiSkeleton = knowledge.get(\"api-skeleton\");\n if (apiSkeleton) {\n sections.push(\"## API Reference (Auto-Generated)\", \"\", apiSkeleton, \"\");\n }\n\n // All examples\n sections.push(\"## Complete Examples\", \"\");\n\n for (const name of exampleOrder) {\n const content = examples.get(name);\n if (content) {\n sections.push(\n `### ${name}`,\n \"\",\n \"```typescript\",\n content,\n \"```\",\n \"\",\n );\n }\n }\n\n return sections.join(\"\\n\");\n}\n","import { generateCopilotRules } from \"./copilot.js\";\n\n/**\n * Generate Windsurf rules (~12KB).\n * Same content as Copilot.\n */\nexport function generateWindsurfRules(): string {\n return generateCopilotRules();\n}\n","import type { DetectedTool } from \"../lib/detect.js\";\nimport { generateClaudeRules } from \"./claude.js\";\nimport { generateClineRules } from \"./cline.js\";\nimport { generateCopilotRules } from \"./copilot.js\";\nimport { generateCursorRules } from \"./cursor.js\";\nimport { generateLlmsTxt } from \"./llms-txt.js\";\nimport { generateWindsurfRules } from \"./windsurf.js\";\n\nconst generators: Record<DetectedTool[\"id\"], () => string> = {\n cursor: generateCursorRules,\n claude: generateClaudeRules,\n copilot: generateCopilotRules,\n windsurf: generateWindsurfRules,\n cline: generateClineRules,\n};\n\nexport function getTemplate(toolId: DetectedTool[\"id\"]): string {\n const generator = generators[toolId];\n if (!generator) {\n throw new Error(`No template for tool: ${toolId}`);\n }\n\n return generator();\n}\n\nexport { generateLlmsTxt };\n","import { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface DetectedTool {\n name: string;\n id: \"cursor\" | \"claude\" | \"copilot\" | \"windsurf\" | \"cline\";\n outputPath: string;\n}\n\nconst TOOL_SIGNALS: Array<{\n id: DetectedTool[\"id\"];\n name: string;\n signals: string[];\n outputPath: string;\n}> = [\n {\n id: \"cursor\",\n name: \"Cursor\",\n signals: [\".cursor\", \".cursorrules\"],\n outputPath: \".cursorrules\",\n },\n {\n id: \"claude\",\n name: \"Claude Code\",\n signals: [\".claude\"],\n outputPath: \".claude/CLAUDE.md\",\n },\n {\n id: \"copilot\",\n name: \"GitHub Copilot\",\n signals: [\".github\"],\n outputPath: \".github/copilot-instructions.md\",\n },\n {\n id: \"windsurf\",\n name: \"Windsurf\",\n signals: [\".windsurfrules\"],\n outputPath: \".windsurfrules\",\n },\n {\n id: \"cline\",\n name: \"Cline\",\n signals: [\".clinerules\"],\n outputPath: \".clinerules\",\n },\n];\n\nexport function detectTools(rootDir: string): DetectedTool[] {\n const detected: DetectedTool[] = [];\n\n for (const tool of TOOL_SIGNALS) {\n const hasSignal = tool.signals.some((signal) =>\n existsSync(join(rootDir, signal)),\n );\n\n if (hasSignal) {\n detected.push({\n name: tool.name,\n id: tool.id,\n outputPath: join(rootDir, tool.outputPath),\n });\n }\n }\n\n return detected;\n}\n\nexport function getToolConfig(id: DetectedTool[\"id\"]) {\n const tool = TOOL_SIGNALS.find((t) => t.id === id);\n if (!tool) {\n throw new Error(`Unknown tool: ${id}`);\n }\n\n return tool;\n}\n\nexport function getAllToolIds(): DetectedTool[\"id\"][] {\n return TOOL_SIGNALS.map((t) => t.id);\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\n\nexport interface MonorepoInfo {\n isMonorepo: boolean;\n rootDir: string;\n tool?: \"pnpm\" | \"turbo\" | \"npm\" | \"yarn\";\n}\n\nconst MONOREPO_SIGNALS = [\n { file: \"pnpm-workspace.yaml\", tool: \"pnpm\" as const },\n { file: \"turbo.json\", tool: \"turbo\" as const },\n];\n\nexport function detectMonorepo(startDir: string): MonorepoInfo {\n let dir = resolve(startDir);\n\n while (dir !== dirname(dir)) {\n for (const signal of MONOREPO_SIGNALS) {\n if (existsSync(join(dir, signal.file))) {\n return { isMonorepo: true, rootDir: dir, tool: signal.tool };\n }\n }\n\n const pkgPath = join(dir, \"package.json\");\n if (existsSync(pkgPath)) {\n try {\n const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\"));\n if (pkg.workspaces) {\n const tool = existsSync(join(dir, \"yarn.lock\"))\n ? (\"yarn\" as const)\n : (\"npm\" as const);\n\n return { isMonorepo: true, rootDir: dir, tool };\n }\n } catch {\n // ignore parse errors\n }\n }\n\n dir = dirname(dir);\n }\n\n return { isMonorepo: false, rootDir: startDir };\n}\n","export const CLI_NAME = \"directive\";\nexport const CLI_ALIAS = \"dr\";\nexport const PACKAGE_NAME = \"@directive-run/cli\";\nexport const SECTION_START = \"<!-- directive:start -->\";\nexport const SECTION_END = \"<!-- directive:end -->\";\n","import { SECTION_END, SECTION_START } from \"./constants.js\";\n\n/**\n * Replace the Directive section within existing content, or append it.\n * Section markers: <!-- directive:start --> ... <!-- directive:end -->\n */\nexport function mergeSection(\n existingContent: string,\n newSection: string,\n): string {\n const startIdx = existingContent.indexOf(SECTION_START);\n const endIdx = existingContent.indexOf(SECTION_END);\n\n const wrapped = `${SECTION_START}\\n${newSection}\\n${SECTION_END}`;\n\n if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {\n return (\n existingContent.slice(0, startIdx) +\n wrapped +\n existingContent.slice(endIdx + SECTION_END.length)\n );\n }\n\n const separator = existingContent.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\";\n\n return existingContent + separator + wrapped + \"\\n\";\n}\n\n/**\n * Check if content already has a Directive section.\n */\nexport function hasDirectiveSection(content: string): boolean {\n return (\n content.includes(SECTION_START) && content.includes(SECTION_END)\n );\n}\n","import { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport pc from \"picocolors\";\n\n/**\n * Loads a Directive system from a user's TypeScript file.\n *\n * Uses tsx to handle TypeScript imports. Looks for:\n * 1. Default export of a System instance\n * 2. Named \"system\" export\n *\n * Returns the live System object for inspection/explain/graph commands.\n */\nexport async function loadSystem(filePath: string): Promise<any> {\n const resolved = resolve(filePath);\n\n if (!existsSync(resolved)) {\n throw new Error(`File not found: ${resolved}`);\n }\n\n // Use tsx register to handle TypeScript imports\n try {\n // Dynamic import with tsx — tsx must be available\n const mod = await import(resolved);\n\n // Look for default export first\n if (mod.default && isSystem(mod.default)) {\n return mod.default;\n }\n\n // Look for named \"system\" export\n if (mod.system && isSystem(mod.system)) {\n return mod.system;\n }\n\n // Look for any export that looks like a System\n for (const key of Object.keys(mod)) {\n if (isSystem(mod[key])) {\n return mod[key];\n }\n }\n\n throw new Error(\n `No Directive system found in ${pc.dim(filePath)}\\n` +\n `Export a system as default or named \"system\":\\n\\n` +\n ` ${pc.cyan(\"export default\")} createSystem({ module: myModule });\\n` +\n ` ${pc.cyan(\"export const system\")} = createSystem({ module: myModule });`,\n );\n } catch (err) {\n if (err instanceof Error && err.message.includes(\"No Directive system\")) {\n throw err;\n }\n\n throw new Error(\n `Failed to load ${pc.dim(filePath)}: ${err instanceof Error ? err.message : String(err)}\\n\\n` +\n `Make sure the file is valid TypeScript and tsx is installed:\\n` +\n ` ${pc.cyan(\"npm install -D tsx\")}`,\n );\n }\n}\n\n/**\n * Duck-type check for a Directive System object.\n */\nfunction isSystem(obj: unknown): boolean {\n if (typeof obj !== \"object\" || obj === null) {\n return false;\n }\n\n const sys = obj as Record<string, unknown>;\n\n return (\n typeof sys.inspect === \"function\" &&\n typeof sys.start === \"function\" &&\n typeof sys.stop === \"function\" &&\n \"facts\" in sys\n );\n}\n"]}
1
+ {"version":3,"sources":["../src/templates/claude.ts","../src/templates/cursor.ts","../src/templates/copilot.ts","../src/templates/cline.ts","../src/templates/llms-txt.ts","../src/templates/windsurf.ts","../src/templates/index.ts","../src/lib/detect.ts","../src/lib/monorepo.ts","../src/lib/constants.ts","../src/lib/merge.ts","../src/lib/loader.ts"],"names":["generateClaudeRules","corePatterns","getKnowledge","antiPatterns","naming","schemaTypes","generateCursorRules","generateCopilotRules","generateClineRules","generateLlmsTxt","knowledge","getAllKnowledge","examples","getAllExamples","coreOrder","aiOrder","exampleOrder","sections","name","content","apiSkeleton","generateWindsurfRules","generators","getTemplate","toolId","generator","TOOL_SIGNALS","detectTools","rootDir","detected","tool","signal","existsSync","join","MONOREPO_SIGNALS","detectMonorepo","startDir","dir","resolve","dirname","pkgPath","readFileSync","CLI_NAME","PACKAGE_NAME","SECTION_START","SECTION_END","mergeSection","existingContent","newSection","startIdx","endIdx","wrapped","separator","hasDirectiveSection","loadSystem","filePath","resolved","mod","isSystem","key","pc","err","obj","sys"],"mappings":"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","file":"index.cjs","sourcesContent":["import { getKnowledge } from \"../lib/knowledge.js\";\n\n/**\n * Generate Claude Code rules (~30KB).\n * Strategy: Full anti-patterns + core-patterns + naming + schema-types (most critical),\n * condensed summaries for everything else.\n */\nexport function generateClaudeRules(): string {\n // These 4 files are included in full (~25KB)\n const corePatterns = getKnowledge(\"core-patterns\");\n const antiPatterns = getKnowledge(\"anti-patterns\");\n const naming = getKnowledge(\"naming\");\n const schemaTypes = getKnowledge(\"schema-types\");\n\n return `# Directive — Complete AI Coding Rules\n\n> Constraint-driven runtime for TypeScript. Declare requirements, let the runtime resolve them.\n> https://directive.run | \\`npm install @directive-run/core\\`\n> Full reference with examples: https://directive.run/llms.txt\n\n## Core Patterns\n\n${corePatterns}\n\n---\n\n## Anti-Patterns (All 36)\n\n${antiPatterns}\n\n### AI Package Anti-Patterns (21-36)\n\n| # | WRONG | CORRECT |\n|---|-------|---------|\n| 21 | TS types for factsSchema: \\`{ confidence: number }\\` | Use \\`{ confidence: t.number() }\\` |\n| 22 | \\`facts.cache.push(item)\\` in orchestrator | \\`facts.cache = [...facts.cache, item]\\` |\n| 23 | Returning data from orchestrator \\`resolve\\` | Resolvers return \\`void\\` — mutate \\`context.facts\\` |\n| 24 | Forgetting \\`orchestrator.start()\\` multi-agent | Single: implicit. Multi: must call \\`start()\\` |\n| 25 | Catching \\`Error\\` not \\`GuardrailError\\` | \\`GuardrailError\\` has \\`.guardrailName\\`, \\`.errorCode\\` |\n| 26 | \\`from '@directive-run/ai'\\` for adapters | Subpath: \\`from '@directive-run/ai/openai'\\` |\n| 27 | Assuming \\`{ input_tokens }\\` structure | Normalized: \\`{ inputTokens, outputTokens }\\` |\n| 28 | Same CircuitBreaker across agents | Create separate instances per dependency |\n| 29 | \\`budgetWarningThreshold: 1.5\\` | Must be 0-1 (percentage) |\n| 30 | \\`race\\` minSuccess > agents.length | Must be \\`1 ≤ minSuccess ≤ agents.length\\` |\n| 31 | Async summarizer with autoManage: true | Use \\`autoManage: false\\` for sync control |\n| 32 | Side effects in reflect \\`evaluator\\` | Evaluator must be pure |\n| 33 | Task calling \\`runSingleAgent\\` | Tasks can't call agents — separate node |\n| 34 | Task expecting object input | Input is always \\`string\\` — \\`JSON.parse(input)\\` |\n| 35 | Task ID same as agent ID | IDs share namespace — distinct names |\n| 36 | \\`from '@directive-run/ai/mcp'\\` | \\`from '@directive-run/ai'\\` (main export) |\n\n---\n\n## Naming Conventions\n\n${naming}\n\n---\n\n## Schema Type Builders\n\n${schemaTypes}\n\n---\n\n## Multi-Module Quick Reference\n\n\\`\\`\\`typescript\n// Two modules with cross-module dependency\nconst authSchema = { facts: { token: t.string(), isAuth: t.boolean() } };\nconst authModule = createModule(\"auth\", { schema: authSchema, /* ... */ });\n\nconst cartModule = createModule(\"cart\", {\n schema: { facts: { items: t.array<CartItem>() } },\n crossModuleDeps: { auth: authSchema }, // Declare dependency\n constraints: {\n checkout: {\n when: (facts) => facts.self.items.length > 0 && facts.auth.isAuth, // facts.self.* for own, facts.auth.* for cross\n require: () => ({ type: \"CHECKOUT\" }),\n },\n },\n // ...\n});\n\nconst system = createSystem({ modules: { auth: authModule, cart: cartModule } });\n// Access: system.facts.auth.token, system.events.cart.addItem({...})\n\\`\\`\\`\n\nKey rules:\n- \\`facts.self.*\\` for own module facts in constraints/resolvers\n- \\`facts.otherModule.*\\` for cross-module reads\n- \\`crossModuleDeps\\` must declare consumed schemas\n- \\`system.events.moduleName.eventName(payload)\\` for namespaced events\n- The \\`::\\` separator is internal — always use dot notation\n\n---\n\n## Constraints\n\n- \\`when(facts)\\` → boolean. When true, requirement is emitted.\n- \\`require(facts)\\` → \\`{ type: \"TYPE\", ...data }\\` object (never string literal)\n- \\`priority: number\\` — higher evaluated first\n- \\`after: [\"constraintName\"]\\` — ordering within same priority\n- Async: \\`async: true\\` + \\`deps: ['factName']\\` (deps REQUIRED for async)\n- Constraints DECLARE needs, resolvers FULFILL them — decoupled.\n\n---\n\n## Resolvers\n\n- \\`resolve(req, context)\\` — async, returns \\`void\\`. Mutate \\`context.facts.*\\`.\n- \\`requirement: \"TYPE\"\\` — which type this handles\n- \\`key: (req) => string\\` — deduplication key\n- \\`retry: { attempts: 3, backoff: \"exponential\", initialDelay: 100 }\\`\n- \\`batch: { maxSize: 10, windowMs: 50 }\\` for N+1 prevention\n- Always \\`await system.settle()\\` after start to wait for resolution\n\n---\n\n## System API\n\n- \\`system.facts.fieldName\\` — read/write facts\n- \\`system.derive.derivationName\\` — read derived values\n- \\`system.events.eventName(payload)\\` — dispatch events\n- \\`system.subscribe(listener)\\` — subscribe to all changes\n- \\`system.read(key)\\` — read fact or derivation by string key\n- \\`system.inspect()\\` — full state snapshot\n- \\`system.settle()\\` — wait for async operations\n- \\`system.start()\\` / \\`system.stop()\\` / \\`system.destroy()\\`\n\n---\n\n## React (\\`@directive-run/react\\`)\n\n\\`\\`\\`typescript\nimport { useSelector, useEvent } from \"@directive-run/react\";\n\nconst count = useSelector(system, (s) => s.facts.count);\nconst events = useEvent(system);\n// onClick={() => events.increment()}\n\\`\\`\\`\n\n**NO** \\`useDirective()\\` hook. Use \\`useSelector\\` + \\`useEvent\\`.\n\n---\n\n## Plugins (\\`@directive-run/core/plugins\\`)\n\n\\`devtoolsPlugin()\\`, \\`loggingPlugin()\\`, \\`persistencePlugin(config)\\`,\n\\`createCircuitBreaker(config)\\`, \\`createObservability(config)\\`\n\n---\n\n## AI Package (\\`@directive-run/ai\\`)\n\n### Single-Agent Orchestrator\n\n\\`\\`\\`typescript\nimport { createAgentOrchestrator, t } from '@directive-run/ai';\nimport { createAnthropicRunner } from '@directive-run/ai/anthropic';\n\nconst orchestrator = createAgentOrchestrator({\n runner: createAnthropicRunner({ apiKey }),\n factsSchema: { result: t.string(), confidence: t.number() },\n init: (facts) => { facts.result = \"\"; facts.confidence = 0; },\n maxTokenBudget: 100000,\n budgetWarningThreshold: 0.8,\n guardrails: { input: [...], output: [...] },\n memory: createAgentMemory({ strategy: createSlidingWindowStrategy({ maxMessages: 30 }) }),\n debug: true,\n});\n\nconst result = await orchestrator.run(agent, \"analyze this\");\n\\`\\`\\`\n\n### Multi-Agent\n\n\\`\\`\\`typescript\nimport { createMultiAgentOrchestrator, parallel, sequential, dag } from '@directive-run/ai';\n\nconst orch = createMultiAgentOrchestrator({\n agents: { researcher: agentA, writer: agentB },\n patterns: {\n pipeline: sequential([\"researcher\", \"writer\"]),\n brainstorm: parallel([\"researcher\", \"writer\"], mergeResults),\n workflow: dag([\n { id: \"research\", handler: \"researcher\" },\n { id: \"write\", handler: \"writer\", dependencies: [\"research\"] },\n ]),\n },\n runner,\n});\norch.start(); // Required for multi-agent!\n\\`\\`\\`\n\n8 patterns: \\`parallel\\`, \\`sequential\\`, \\`supervisor\\`, \\`dag\\`, \\`reflect\\`, \\`race\\`, \\`debate\\`, \\`goal\\`\n\n### Adapter Imports (Subpath!)\n\n\\`\\`\\`typescript\nimport { createAnthropicRunner } from '@directive-run/ai/anthropic';\nimport { createOpenAIRunner } from '@directive-run/ai/openai';\nimport { createOllamaRunner } from '@directive-run/ai/ollama';\nimport { createGeminiRunner } from '@directive-run/ai/gemini';\n\\`\\`\\`\n\n### Guardrails\n\n\\`createPIIGuardrail\\`, \\`createModerationGuardrail\\`, \\`createRateLimitGuardrail\\`,\n\\`createToolGuardrail\\`, \\`createOutputSchemaGuardrail\\`, \\`createLengthGuardrail\\`,\n\\`createContentFilterGuardrail\\`\n\n\\`GuardrailResult: { passed: boolean, reason?: string, transformed?: unknown }\\`\n\n### Memory\n\n\\`createAgentMemory({ strategy, summarizer?, autoManage? })\\`\nStrategies: \\`createSlidingWindowStrategy\\`, \\`createTokenBasedStrategy\\`, \\`createHybridStrategy\\`\nSummarizers: \\`createTruncationSummarizer\\`, \\`createKeyPointsSummarizer\\`, \\`createLLMSummarizer(runner)\\`\n\n### Streaming\n\n\\`\\`\\`typescript\nconst streamResult = orchestrator.runStream(agent, \"analyze\");\nfor await (const chunk of streamResult.stream) {\n switch (chunk.type) {\n case \"token\": process.stdout.write(chunk.data); break;\n case \"done\": console.log(\"Tokens:\", chunk.totalTokens); break;\n case \"error\": console.error(chunk.error); break;\n }\n}\n\\`\\`\\`\n\nBackpressure: \\`\"buffer\"\\` (default), \\`\"block\"\\`, \\`\"drop\"\\`\n`;\n}\n","/**\n * Generate Cursor rules (<10KB).\n * Handcrafted condensed content — core patterns, top 10 anti-patterns, naming, 1 mini example.\n */\nexport function generateCursorRules(): string {\n return `# Directive — 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 — 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)\\` — 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 — never \"computed\" or \"selectors\"\n- Resolvers return \\`void\\` — 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)\\` — 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 → Requirement → Resolver\n\nWhen the user wants \"do X when Y\": create THREE things:\n1. **Constraint**: \\`when: (facts) => Y_condition\\` → \\`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`;\n}\n","import { generateCursorRules } from \"./cursor.js\";\n\n/**\n * Generate GitHub Copilot instructions (~12KB).\n * Cursor content + all 20 anti-patterns + schema types detail + AI basics.\n */\nexport function generateCopilotRules(): string {\n const base = generateCursorRules();\n\n // Add anti-patterns 11-20 that cursor doesn't include\n const extraAntiPatterns = `\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\\` — 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 — 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`;\n\n // Add multi-module basics\n const multiModule = `\n## Multi-Module\n\n\\`\\`\\`typescript\nconst system = createSystem({\n modules: { auth: authModule, cart: cartModule },\n});\n\n// Access: system.facts.auth.token, system.events.cart.addItem({...})\n// In constraints/resolvers: use facts.self.* for own module\n// Declare deps: crossModuleDeps: { auth: authSchema }\n\\`\\`\\`\n`;\n\n // Add AI basics\n const aiBasics = `\n## AI Package Basics (\\`@directive-run/ai\\`)\n\n\\`\\`\\`typescript\nimport { createAgentOrchestrator, t } from '@directive-run/ai';\nimport { createAnthropicRunner } from '@directive-run/ai/anthropic'; // Subpath import!\n\nconst orchestrator = createAgentOrchestrator({\n runner: createAnthropicRunner({ apiKey: process.env.ANTHROPIC_API_KEY }),\n factsSchema: { result: t.string(), confidence: t.number() }, // Use t.*() !\n init: (facts) => { facts.result = \"\"; facts.confidence = 0; },\n});\n\nconst result = await orchestrator.run(agent, \"analyze this\");\n\\`\\`\\`\n\n**AI Anti-Patterns:**\n- Use \\`t.number()\\` not \\`number\\` for factsSchema\n- Subpath imports: \\`from '@directive-run/ai/anthropic'\\` not \\`from '@directive-run/ai'\\`\n- Token usage normalized: \\`{ inputTokens, outputTokens }\\` (not provider-specific)\n- \\`facts.cache = [...facts.cache, item]\\` not \\`facts.cache.push(item)\\`\n`;\n\n return base + extraAntiPatterns + multiModule + aiBasics;\n}\n","import { generateCopilotRules } from \"./copilot.js\";\n\n/**\n * Generate Cline rules (~12KB).\n * Same content as Copilot.\n */\nexport function generateClineRules(): string {\n return generateCopilotRules();\n}\n","import { getAllExamples, getAllKnowledge } from \"../lib/knowledge.js\";\n\n/**\n * Generate llms.txt (no size limit).\n * Content: complete reference + all 7 examples + full 26-file knowledge base.\n */\nexport function generateLlmsTxt(): string {\n const knowledge = getAllKnowledge();\n const examples = getAllExamples();\n\n // Order: core knowledge first, then AI, then api-skeleton\n const coreOrder = [\n \"core-patterns\",\n \"anti-patterns\",\n \"naming\",\n \"multi-module\",\n \"constraints\",\n \"resolvers\",\n \"error-boundaries\",\n \"testing\",\n \"time-travel\",\n \"schema-types\",\n \"system-api\",\n \"react-adapter\",\n \"plugins\",\n ];\n\n const aiOrder = [\n \"ai-orchestrator\",\n \"ai-multi-agent\",\n \"ai-tasks\",\n \"ai-agents-streaming\",\n \"ai-guardrails-memory\",\n \"ai-adapters\",\n \"ai-budget-resilience\",\n \"ai-mcp-rag\",\n \"ai-communication\",\n \"ai-debug-observability\",\n \"ai-security\",\n \"ai-testing-evals\",\n ];\n\n const exampleOrder = [\n \"counter\",\n \"auth-flow\",\n \"shopping-cart\",\n \"error-boundaries\",\n \"ai-orchestrator\",\n \"fraud-analysis\",\n \"ai-checkpoint\",\n ];\n\n const sections = [\n \"# Directive — Complete AI Reference (llms.txt)\",\n \"\",\n \"> Constraint-driven runtime for TypeScript.\",\n \"> Declare requirements. Let the runtime resolve them.\",\n \"> https://directive.run\",\n \"\",\n \"## Core API (@directive-run/core)\",\n \"\",\n ];\n\n for (const name of coreOrder) {\n const content = knowledge.get(name);\n if (content) {\n sections.push(content, \"\", \"---\", \"\");\n }\n }\n\n sections.push(\"## AI Package (@directive-run/ai)\", \"\");\n\n for (const name of aiOrder) {\n const content = knowledge.get(name);\n if (content) {\n sections.push(content, \"\", \"---\", \"\");\n }\n }\n\n // API Skeleton\n const apiSkeleton = knowledge.get(\"api-skeleton\");\n if (apiSkeleton) {\n sections.push(\"## API Reference (Auto-Generated)\", \"\", apiSkeleton, \"\");\n }\n\n // All examples\n sections.push(\"## Complete Examples\", \"\");\n\n for (const name of exampleOrder) {\n const content = examples.get(name);\n if (content) {\n sections.push(\n `### ${name}`,\n \"\",\n \"```typescript\",\n content,\n \"```\",\n \"\",\n );\n }\n }\n\n return sections.join(\"\\n\");\n}\n","import { generateCopilotRules } from \"./copilot.js\";\n\n/**\n * Generate Windsurf rules (~12KB).\n * Same content as Copilot.\n */\nexport function generateWindsurfRules(): string {\n return generateCopilotRules();\n}\n","import type { DetectedTool } from \"../lib/detect.js\";\nimport { generateClaudeRules } from \"./claude.js\";\nimport { generateClineRules } from \"./cline.js\";\nimport { generateCopilotRules } from \"./copilot.js\";\nimport { generateCursorRules } from \"./cursor.js\";\nimport { generateLlmsTxt } from \"./llms-txt.js\";\nimport { generateWindsurfRules } from \"./windsurf.js\";\n\nconst generators: Record<DetectedTool[\"id\"], () => string> = {\n cursor: generateCursorRules,\n claude: generateClaudeRules,\n copilot: generateCopilotRules,\n windsurf: generateWindsurfRules,\n cline: generateClineRules,\n};\n\nexport function getTemplate(toolId: DetectedTool[\"id\"]): string {\n const generator = generators[toolId];\n if (!generator) {\n throw new Error(`No template for tool: ${toolId}`);\n }\n\n return generator();\n}\n\nexport { generateLlmsTxt };\n","import { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport interface DetectedTool {\n name: string;\n id: \"cursor\" | \"claude\" | \"copilot\" | \"windsurf\" | \"cline\";\n outputPath: string;\n}\n\nconst TOOL_SIGNALS: Array<{\n id: DetectedTool[\"id\"];\n name: string;\n signals: string[];\n outputPath: string;\n}> = [\n {\n id: \"cursor\",\n name: \"Cursor\",\n signals: [\".cursor\", \".cursorrules\"],\n outputPath: \".cursorrules\",\n },\n {\n id: \"claude\",\n name: \"Claude Code\",\n signals: [\".claude\"],\n outputPath: \".claude/CLAUDE.md\",\n },\n {\n id: \"copilot\",\n name: \"GitHub Copilot\",\n signals: [\".github\"],\n outputPath: \".github/copilot-instructions.md\",\n },\n {\n id: \"windsurf\",\n name: \"Windsurf\",\n signals: [\".windsurfrules\"],\n outputPath: \".windsurfrules\",\n },\n {\n id: \"cline\",\n name: \"Cline\",\n signals: [\".clinerules\"],\n outputPath: \".clinerules\",\n },\n];\n\nexport function detectTools(rootDir: string): DetectedTool[] {\n const detected: DetectedTool[] = [];\n\n for (const tool of TOOL_SIGNALS) {\n const hasSignal = tool.signals.some((signal) =>\n existsSync(join(rootDir, signal)),\n );\n\n if (hasSignal) {\n detected.push({\n name: tool.name,\n id: tool.id,\n outputPath: join(rootDir, tool.outputPath),\n });\n }\n }\n\n return detected;\n}\n\nexport function getToolConfig(id: DetectedTool[\"id\"]) {\n const tool = TOOL_SIGNALS.find((t) => t.id === id);\n if (!tool) {\n throw new Error(`Unknown tool: ${id}`);\n }\n\n return tool;\n}\n\nexport function getAllToolIds(): DetectedTool[\"id\"][] {\n return TOOL_SIGNALS.map((t) => t.id);\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\n\nexport interface MonorepoInfo {\n isMonorepo: boolean;\n rootDir: string;\n tool?: \"pnpm\" | \"turbo\" | \"npm\" | \"yarn\";\n}\n\nconst MONOREPO_SIGNALS = [\n { file: \"pnpm-workspace.yaml\", tool: \"pnpm\" as const },\n { file: \"turbo.json\", tool: \"turbo\" as const },\n];\n\nexport function detectMonorepo(startDir: string): MonorepoInfo {\n let dir = resolve(startDir);\n\n while (dir !== dirname(dir)) {\n for (const signal of MONOREPO_SIGNALS) {\n if (existsSync(join(dir, signal.file))) {\n return { isMonorepo: true, rootDir: dir, tool: signal.tool };\n }\n }\n\n const pkgPath = join(dir, \"package.json\");\n if (existsSync(pkgPath)) {\n try {\n const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\"));\n if (pkg.workspaces) {\n const tool = existsSync(join(dir, \"yarn.lock\"))\n ? (\"yarn\" as const)\n : (\"npm\" as const);\n\n return { isMonorepo: true, rootDir: dir, tool };\n }\n } catch {\n // ignore parse errors\n }\n }\n\n dir = dirname(dir);\n }\n\n return { isMonorepo: false, rootDir: startDir };\n}\n","export const CLI_NAME = \"directive\";\nexport const CLI_ALIAS = \"dr\";\nexport const PACKAGE_NAME = \"@directive-run/cli\";\nexport const SECTION_START = \"<!-- directive:start -->\";\nexport const SECTION_END = \"<!-- directive:end -->\";\n","import { SECTION_END, SECTION_START } from \"./constants.js\";\n\n/**\n * Replace the Directive section within existing content, or append it.\n * Section markers: <!-- directive:start --> ... <!-- directive:end -->\n */\nexport function mergeSection(\n existingContent: string,\n newSection: string,\n): string {\n const startIdx = existingContent.indexOf(SECTION_START);\n const endIdx = existingContent.indexOf(SECTION_END);\n\n const wrapped = `${SECTION_START}\\n${newSection}\\n${SECTION_END}`;\n\n if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {\n return (\n existingContent.slice(0, startIdx) +\n wrapped +\n existingContent.slice(endIdx + SECTION_END.length)\n );\n }\n\n const separator = existingContent.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\";\n\n return existingContent + separator + wrapped + \"\\n\";\n}\n\n/**\n * Check if content already has a Directive section.\n */\nexport function hasDirectiveSection(content: string): boolean {\n return (\n content.includes(SECTION_START) && content.includes(SECTION_END)\n );\n}\n","import { existsSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport pc from \"picocolors\";\n\n/**\n * Loads a Directive system from a user's TypeScript file.\n *\n * Uses tsx to handle TypeScript imports. Looks for:\n * 1. Default export of a System instance\n * 2. Named \"system\" export\n *\n * Returns the live System object for inspection/explain/graph commands.\n */\nexport async function loadSystem(filePath: string): Promise<any> {\n const resolved = resolve(filePath);\n\n if (!existsSync(resolved)) {\n throw new Error(`File not found: ${resolved}`);\n }\n\n // Use tsx register to handle TypeScript imports\n try {\n // Dynamic import with tsx — tsx must be available\n const mod = await import(resolved);\n\n // Look for default export first\n if (mod.default && isSystem(mod.default)) {\n return mod.default;\n }\n\n // Look for named \"system\" export\n if (mod.system && isSystem(mod.system)) {\n return mod.system;\n }\n\n // Look for any export that looks like a System\n for (const key of Object.keys(mod)) {\n if (isSystem(mod[key])) {\n return mod[key];\n }\n }\n\n throw new Error(\n `No Directive system found in ${pc.dim(filePath)}\\n` +\n `Export a system as default or named \"system\":\\n\\n` +\n ` ${pc.cyan(\"export default\")} createSystem({ module: myModule });\\n` +\n ` ${pc.cyan(\"export const system\")} = createSystem({ module: myModule });`,\n );\n } catch (err) {\n if (err instanceof Error && err.message.includes(\"No Directive system\")) {\n throw err;\n }\n\n throw new Error(\n `Failed to load ${pc.dim(filePath)}: ${err instanceof Error ? err.message : String(err)}\\n\\n` +\n `Make sure the file is valid TypeScript and tsx is installed:\\n` +\n ` ${pc.cyan(\"npm install -D tsx\")}`,\n );\n }\n}\n\n/**\n * Duck-type check for a Directive System object.\n */\nfunction isSystem(obj: unknown): boolean {\n if (typeof obj !== \"object\" || obj === null) {\n return false;\n }\n\n const sys = obj as Record<string, unknown>;\n\n return (\n typeof sys.inspect === \"function\" &&\n typeof sys.start === \"function\" &&\n typeof sys.stop === \"function\" &&\n \"facts\" in sys\n );\n}\n"]}
package/dist/index.js CHANGED
@@ -1,18 +1,4 @@
1
- import { getAllKnowledge, getAllExamples, getKnowledge } from '@directive-run/knowledge';
2
- export { getAllExamples, getAllKnowledge, getExample, getExampleFiles, getKnowledge, getKnowledgeFiles } from '@directive-run/knowledge';
3
- import { existsSync, readFileSync } from 'fs';
4
- import { join, resolve, dirname } from 'path';
5
- import pc from 'picocolors';
6
-
7
- // src/lib/knowledge.ts
8
-
9
- // src/templates/claude.ts
10
- function generateClaudeRules() {
11
- const corePatterns = getKnowledge("core-patterns");
12
- const antiPatterns = getKnowledge("anti-patterns");
13
- const naming = getKnowledge("naming");
14
- const schemaTypes = getKnowledge("schema-types");
15
- return `# Directive \u2014 Complete AI Coding Rules
1
+ import {getAllKnowledge,getAllExamples,getKnowledge}from'@directive-run/knowledge';export{getAllExamples,getAllKnowledge,getExample,getExampleFiles,getKnowledge,getKnowledgeFiles}from'@directive-run/knowledge';import {existsSync,readFileSync}from'fs';import {join,resolve,dirname}from'path';import d from'picocolors';function A(){let e=getKnowledge("core-patterns"),r=getKnowledge("anti-patterns"),t=getKnowledge("naming"),s=getKnowledge("schema-types");return `# Directive \u2014 Complete AI Coding Rules
16
2
 
17
3
  > Constraint-driven runtime for TypeScript. Declare requirements, let the runtime resolve them.
18
4
  > https://directive.run | \`npm install @directive-run/core\`
@@ -20,13 +6,13 @@ function generateClaudeRules() {
20
6
 
21
7
  ## Core Patterns
22
8
 
23
- ${corePatterns}
9
+ ${e}
24
10
 
25
11
  ---
26
12
 
27
13
  ## Anti-Patterns (All 36)
28
14
 
29
- ${antiPatterns}
15
+ ${r}
30
16
 
31
17
  ### AI Package Anti-Patterns (21-36)
32
18
 
@@ -53,13 +39,13 @@ ${antiPatterns}
53
39
 
54
40
  ## Naming Conventions
55
41
 
56
- ${naming}
42
+ ${t}
57
43
 
58
44
  ---
59
45
 
60
46
  ## Schema Type Builders
61
47
 
62
- ${schemaTypes}
48
+ ${s}
63
49
 
64
50
  ---
65
51
 
@@ -232,120 +218,7 @@ for await (const chunk of streamResult.stream) {
232
218
  \`\`\`
233
219
 
234
220
  Backpressure: \`"buffer"\` (default), \`"block"\`, \`"drop"\`
235
- `;
236
- }
237
-
238
- // src/templates/cursor.ts
239
- function generateCursorRules() {
240
- return `# Directive \u2014 AI Coding Rules
241
-
242
- > Constraint-driven runtime for TypeScript. \`npm install @directive-run/core\`
243
- > Full reference: https://directive.run/llms.txt
244
-
245
- ## Schema Shape (CRITICAL)
246
-
247
- \`\`\`typescript
248
- import { createModule, createSystem, t } from "@directive-run/core";
249
-
250
- const myModule = createModule("name", {
251
- schema: {
252
- facts: { count: t.number(), items: t.array<string>() },
253
- derivations: { total: "number" },
254
- events: { increment: "void", addItem: "string" },
255
- requirements: { FETCH_DATA: { url: "string" } },
256
- },
257
- init: (facts) => { facts.count = 0; facts.items = []; },
258
- derive: {
259
- total: (facts) => facts.items.length + facts.count,
260
- },
261
- events: {
262
- increment: (facts) => { facts.count += 1; },
263
- addItem: (facts, item) => { facts.items = [...facts.items, item]; },
264
- },
265
- constraints: {
266
- fetchWhenReady: {
267
- when: (facts) => facts.count > 0 && facts.items.length === 0,
268
- require: (facts) => ({ type: "FETCH_DATA", url: "/api/items" }),
269
- },
270
- },
271
- resolvers: {
272
- fetchData: {
273
- requirement: "FETCH_DATA",
274
- resolve: async (req, context) => {
275
- const data = await fetch(req.url).then(r => r.json());
276
- context.facts.items = data;
277
- },
278
- },
279
- },
280
- });
281
-
282
- const system = createSystem({ module: myModule });
283
- await system.settle();
284
- \`\`\`
285
-
286
- ## Top 10 Anti-Patterns
287
-
288
- | # | WRONG | CORRECT |
289
- |---|-------|---------|
290
- | 1 | \`facts.profile as ResourceState<Profile>\` | Remove cast \u2014 schema provides types |
291
- | 2 | \`{ phase: t.string() }\` flat schema | \`schema: { facts: { phase: t.string() } }\` |
292
- | 3 | \`facts.items\` in multi-module | \`facts.self.items\` |
293
- | 4 | \`t.map()\`, \`t.set()\`, \`t.promise()\` | Don't exist. Use \`t.object<Map<K,V>>()\` |
294
- | 5 | \`(req, ctx)\` in resolver | \`(req, context)\` \u2014 never abbreviate |
295
- | 6 | \`createModule("n", { phase: t.string() })\` | Must wrap: \`schema: { facts: { ... } }\` |
296
- | 7 | \`system.dispatch('login', {...})\` | \`system.events.login({...})\` |
297
- | 8 | \`facts.items.push(item)\` | \`facts.items = [...facts.items, item]\` |
298
- | 9 | \`useDirective(system)\` | \`useSelector(system, s => s.facts.count)\` |
299
- | 10 | \`facts['auth::status']\` | \`facts.auth.status\` dot notation |
300
-
301
- ## Naming
302
-
303
- - \`req\` = requirement (not request). Parameter: \`(req, context)\`
304
- - \`derive\` / derivations \u2014 never "computed" or "selectors"
305
- - Resolvers return \`void\` \u2014 mutate \`context.facts\` instead
306
- - Always use braces for returns: \`if (x) { return y; }\`
307
- - Multi-module: \`facts.self.fieldName\` for own module facts
308
- - Events: \`system.events.eventName(payload)\` \u2014 not \`system.dispatch()\`
309
- - Import from main: \`import { createModule } from '@directive-run/core'\`
310
-
311
- ## Schema Types That Exist
312
-
313
- \`t.string<T>()\`, \`t.number()\`, \`t.boolean()\`, \`t.array<T>()\`, \`t.object<T>()\`,
314
- \`t.enum("a","b")\`, \`t.literal(value)\`, \`t.nullable(inner)\`, \`t.optional(inner)\`, \`t.union(...)\`
315
-
316
- Chainable: \`.default()\`, \`.validate()\`, \`.transform()\`, \`.brand<>()\`, \`.refine()\`
317
-
318
- **DO NOT USE** (hallucinations): \`t.map()\`, \`t.set()\`, \`t.date()\`, \`t.tuple()\`, \`t.record()\`, \`t.promise()\`, \`t.any()\`
319
-
320
- ## Key Pattern: Constraint \u2192 Requirement \u2192 Resolver
321
-
322
- When the user wants "do X when Y": create THREE things:
323
- 1. **Constraint**: \`when: (facts) => Y_condition\` \u2192 \`require: { type: "DO_X" }\`
324
- 2. **Resolver**: handles "DO_X", calls API, sets \`context.facts\`
325
- 3. They are **decoupled**. Constraint declares need, resolver fulfills it.
326
- `;
327
- }
328
-
329
- // src/templates/copilot.ts
330
- function generateCopilotRules() {
331
- const base = generateCursorRules();
332
- const extraAntiPatterns = `
333
- ## Anti-Patterns 11-20
334
-
335
- | # | WRONG | CORRECT |
336
- |---|-------|---------|
337
- | 11 | \`module("name").schema({...}).build()\` | Prefer \`createModule("name", {...})\` object syntax |
338
- | 12 | Returning data from \`resolve\` | Resolvers return \`void\` \u2014 mutate \`context.facts\` |
339
- | 13 | Async logic in \`init\` | \`init\` is synchronous, facts assignment only |
340
- | 14 | \`await system.start()\` without settle | Add \`await system.settle()\` after start |
341
- | 15 | Missing \`crossModuleDeps\` | Declare \`crossModuleDeps: { auth: authSchema }\` |
342
- | 16 | \`require: "TYPE"\` string literal | \`require: { type: "TYPE" }\` object form |
343
- | 17 | Passthrough derivation \`(f) => f.count\` | Remove \u2014 read fact directly |
344
- | 18 | \`from '@directive-run/core/module'\` | \`from '@directive-run/core'\` (main export) |
345
- | 19 | \`async when()\` without \`deps\` | Add \`deps: ['factName']\` for async constraints |
346
- | 20 | No error boundary on resolver | Use try-catch or module error boundary config |
347
- `;
348
- const multiModule = `
221
+ `}function p(){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 u(){return p()+'\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'+`
349
222
  ## Multi-Module
350
223
 
351
224
  \`\`\`typescript
@@ -357,8 +230,7 @@ const system = createSystem({
357
230
  // In constraints/resolvers: use facts.self.* for own module
358
231
  // Declare deps: crossModuleDeps: { auth: authSchema }
359
232
  \`\`\`
360
- `;
361
- const aiBasics = `
233
+ `+`
362
234
  ## AI Package Basics (\`@directive-run/ai\`)
363
235
 
364
236
  \`\`\`typescript
@@ -379,264 +251,20 @@ const result = await orchestrator.run(agent, "analyze this");
379
251
  - Subpath imports: \`from '@directive-run/ai/anthropic'\` not \`from '@directive-run/ai'\`
380
252
  - Token usage normalized: \`{ inputTokens, outputTokens }\` (not provider-specific)
381
253
  - \`facts.cache = [...facts.cache, item]\` not \`facts.cache.push(item)\`
382
- `;
383
- return base + extraAntiPatterns + multiModule + aiBasics;
384
- }
385
-
386
- // src/templates/cline.ts
387
- function generateClineRules() {
388
- return generateCopilotRules();
389
- }
390
-
391
- // src/templates/llms-txt.ts
392
- function generateLlmsTxt() {
393
- const knowledge = getAllKnowledge();
394
- const examples = getAllExamples();
395
- const coreOrder = [
396
- "core-patterns",
397
- "anti-patterns",
398
- "naming",
399
- "multi-module",
400
- "constraints",
401
- "resolvers",
402
- "error-boundaries",
403
- "testing",
404
- "time-travel",
405
- "schema-types",
406
- "system-api",
407
- "react-adapter",
408
- "plugins"
409
- ];
410
- const aiOrder = [
411
- "ai-orchestrator",
412
- "ai-multi-agent",
413
- "ai-tasks",
414
- "ai-agents-streaming",
415
- "ai-guardrails-memory",
416
- "ai-adapters",
417
- "ai-budget-resilience",
418
- "ai-mcp-rag",
419
- "ai-communication",
420
- "ai-debug-observability",
421
- "ai-security",
422
- "ai-testing-evals"
423
- ];
424
- const exampleOrder = [
425
- "counter",
426
- "auth-flow",
427
- "shopping-cart",
428
- "error-boundaries",
429
- "ai-orchestrator",
430
- "fraud-analysis",
431
- "ai-checkpoint"
432
- ];
433
- const sections = [
434
- "# Directive \u2014 Complete AI Reference (llms.txt)",
435
- "",
436
- "> Constraint-driven runtime for TypeScript.",
437
- "> Declare requirements. Let the runtime resolve them.",
438
- "> https://directive.run",
439
- "",
440
- "## Core API (@directive-run/core)",
441
- ""
442
- ];
443
- for (const name of coreOrder) {
444
- const content = knowledge.get(name);
445
- if (content) {
446
- sections.push(content, "", "---", "");
447
- }
448
- }
449
- sections.push("## AI Package (@directive-run/ai)", "");
450
- for (const name of aiOrder) {
451
- const content = knowledge.get(name);
452
- if (content) {
453
- sections.push(content, "", "---", "");
454
- }
455
- }
456
- const apiSkeleton = knowledge.get("api-skeleton");
457
- if (apiSkeleton) {
458
- sections.push("## API Reference (Auto-Generated)", "", apiSkeleton, "");
459
- }
460
- sections.push("## Complete Examples", "");
461
- for (const name of exampleOrder) {
462
- const content = examples.get(name);
463
- if (content) {
464
- sections.push(
465
- `### ${name}`,
466
- "",
467
- "```typescript",
468
- content,
469
- "```",
470
- ""
471
- );
472
- }
473
- }
474
- return sections.join("\n");
475
- }
476
-
477
- // src/templates/windsurf.ts
478
- function generateWindsurfRules() {
479
- return generateCopilotRules();
480
- }
481
-
482
- // src/templates/index.ts
483
- var generators = {
484
- cursor: generateCursorRules,
485
- claude: generateClaudeRules,
486
- copilot: generateCopilotRules,
487
- windsurf: generateWindsurfRules,
488
- cline: generateClineRules
489
- };
490
- function getTemplate(toolId) {
491
- const generator = generators[toolId];
492
- if (!generator) {
493
- throw new Error(`No template for tool: ${toolId}`);
494
- }
495
- return generator();
496
- }
497
- var TOOL_SIGNALS = [
498
- {
499
- id: "cursor",
500
- name: "Cursor",
501
- signals: [".cursor", ".cursorrules"],
502
- outputPath: ".cursorrules"
503
- },
504
- {
505
- id: "claude",
506
- name: "Claude Code",
507
- signals: [".claude"],
508
- outputPath: ".claude/CLAUDE.md"
509
- },
510
- {
511
- id: "copilot",
512
- name: "GitHub Copilot",
513
- signals: [".github"],
514
- outputPath: ".github/copilot-instructions.md"
515
- },
516
- {
517
- id: "windsurf",
518
- name: "Windsurf",
519
- signals: [".windsurfrules"],
520
- outputPath: ".windsurfrules"
521
- },
522
- {
523
- id: "cline",
524
- name: "Cline",
525
- signals: [".clinerules"],
526
- outputPath: ".clinerules"
527
- }
528
- ];
529
- function detectTools(rootDir) {
530
- const detected = [];
531
- for (const tool of TOOL_SIGNALS) {
532
- const hasSignal = tool.signals.some(
533
- (signal) => existsSync(join(rootDir, signal))
534
- );
535
- if (hasSignal) {
536
- detected.push({
537
- name: tool.name,
538
- id: tool.id,
539
- outputPath: join(rootDir, tool.outputPath)
540
- });
541
- }
542
- }
543
- return detected;
544
- }
545
- var MONOREPO_SIGNALS = [
546
- { file: "pnpm-workspace.yaml", tool: "pnpm" },
547
- { file: "turbo.json", tool: "turbo" }
548
- ];
549
- function detectMonorepo(startDir) {
550
- let dir = resolve(startDir);
551
- while (dir !== dirname(dir)) {
552
- for (const signal of MONOREPO_SIGNALS) {
553
- if (existsSync(join(dir, signal.file))) {
554
- return { isMonorepo: true, rootDir: dir, tool: signal.tool };
555
- }
556
- }
557
- const pkgPath = join(dir, "package.json");
558
- if (existsSync(pkgPath)) {
559
- try {
560
- const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
561
- if (pkg.workspaces) {
562
- const tool = existsSync(join(dir, "yarn.lock")) ? "yarn" : "npm";
563
- return { isMonorepo: true, rootDir: dir, tool };
564
- }
565
- } catch {
566
- }
567
- }
568
- dir = dirname(dir);
569
- }
570
- return { isMonorepo: false, rootDir: startDir };
571
- }
572
-
573
- // src/lib/constants.ts
574
- var CLI_NAME = "directive";
575
- var PACKAGE_NAME = "@directive-run/cli";
576
- var SECTION_START = "<!-- directive:start -->";
577
- var SECTION_END = "<!-- directive:end -->";
578
-
579
- // src/lib/merge.ts
580
- function mergeSection(existingContent, newSection) {
581
- const startIdx = existingContent.indexOf(SECTION_START);
582
- const endIdx = existingContent.indexOf(SECTION_END);
583
- const wrapped = `${SECTION_START}
584
- ${newSection}
585
- ${SECTION_END}`;
586
- if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
587
- return existingContent.slice(0, startIdx) + wrapped + existingContent.slice(endIdx + SECTION_END.length);
588
- }
589
- const separator = existingContent.endsWith("\n") ? "\n" : "\n\n";
590
- return existingContent + separator + wrapped + "\n";
591
- }
592
- function hasDirectiveSection(content) {
593
- return content.includes(SECTION_START) && content.includes(SECTION_END);
594
- }
595
- async function loadSystem(filePath) {
596
- const resolved = resolve(filePath);
597
- if (!existsSync(resolved)) {
598
- throw new Error(`File not found: ${resolved}`);
599
- }
600
- try {
601
- const mod = await import(resolved);
602
- if (mod.default && isSystem(mod.default)) {
603
- return mod.default;
604
- }
605
- if (mod.system && isSystem(mod.system)) {
606
- return mod.system;
607
- }
608
- for (const key of Object.keys(mod)) {
609
- if (isSystem(mod[key])) {
610
- return mod[key];
611
- }
612
- }
613
- throw new Error(
614
- `No Directive system found in ${pc.dim(filePath)}
254
+ `}function w(){return u()}function T(){let e=getAllKnowledge(),r=getAllExamples(),t=["core-patterns","anti-patterns","naming","multi-module","constraints","resolvers","error-boundaries","testing","time-travel","schema-types","system-api","react-adapter","plugins"],s=["ai-orchestrator","ai-multi-agent","ai-tasks","ai-agents-streaming","ai-guardrails-memory","ai-adapters","ai-budget-resilience","ai-mcp-rag","ai-communication","ai-debug-observability","ai-security","ai-testing-evals"],o=["counter","auth-flow","shopping-cart","error-boundaries","ai-orchestrator","fraud-analysis","ai-checkpoint"],n=["# Directive \u2014 Complete AI Reference (llms.txt)","","> Constraint-driven runtime for TypeScript.","> Declare requirements. Let the runtime resolve them.","> https://directive.run","","## Core API (@directive-run/core)",""];for(let i of t){let a=e.get(i);a&&n.push(a,"","---","");}n.push("## AI Package (@directive-run/ai)","");for(let i of s){let a=e.get(i);a&&n.push(a,"","---","");}let S=e.get("api-skeleton");S&&n.push("## API Reference (Auto-Generated)","",S,""),n.push("## Complete Examples","");for(let i of o){let a=r.get(i);a&&n.push(`### ${i}`,"","```typescript",a,"```","");}return n.join(`
255
+ `)}function x(){return u()}var E={cursor:p,claude:A,copilot:u,windsurf:x,cline:w};function D(e){let r=E[e];if(!r)throw new Error(`No template for tool: ${e}`);return r()}var P=[{id:"cursor",name:"Cursor",signals:[".cursor",".cursorrules"],outputPath:".cursorrules"},{id:"claude",name:"Claude Code",signals:[".claude"],outputPath:".claude/CLAUDE.md"},{id:"copilot",name:"GitHub Copilot",signals:[".github"],outputPath:".github/copilot-instructions.md"},{id:"windsurf",name:"Windsurf",signals:[".windsurfrules"],outputPath:".windsurfrules"},{id:"cline",name:"Cline",signals:[".clinerules"],outputPath:".clinerules"}];function N(e){let r=[];for(let t of P)t.signals.some(o=>existsSync(join(e,o)))&&r.push({name:t.name,id:t.id,outputPath:join(e,t.outputPath)});return r}var _=[{file:"pnpm-workspace.yaml",tool:"pnpm"},{file:"turbo.json",tool:"turbo"}];function G(e){let r=resolve(e);for(;r!==dirname(r);){for(let s of _)if(existsSync(join(r,s.file)))return {isMonorepo:true,rootDir:r,tool:s.tool};let t=join(r,"package.json");if(existsSync(t))try{if(JSON.parse(readFileSync(t,"utf-8")).workspaces){let o=existsSync(join(r,"yarn.lock"))?"yarn":"npm";return {isMonorepo:!0,rootDir:r,tool:o}}}catch{}r=dirname(r);}return {isMonorepo:false,rootDir:e}}var L="directive";var K="@directive-run/cli",m="<!-- directive:start -->",l="<!-- directive:end -->";function $(e,r){let t=e.indexOf(m),s=e.indexOf(l),o=`${m}
256
+ ${r}
257
+ ${l}`;if(t!==-1&&s!==-1&&s>t)return e.slice(0,t)+o+e.slice(s+l.length);let n=e.endsWith(`
258
+ `)?`
259
+ `:`
260
+
261
+ `;return e+n+o+`
262
+ `}function F(e){return e.includes(m)&&e.includes(l)}async function U(e){let r=resolve(e);if(!existsSync(r))throw new Error(`File not found: ${r}`);try{let t=await import(r);if(t.default&&v(t.default))return t.default;if(t.system&&v(t.system))return t.system;for(let s of Object.keys(t))if(v(t[s]))return t[s];throw new Error(`No Directive system found in ${d.dim(e)}
615
263
  Export a system as default or named "system":
616
264
 
617
- ${pc.cyan("export default")} createSystem({ module: myModule });
618
- ${pc.cyan("export const system")} = createSystem({ module: myModule });`
619
- );
620
- } catch (err) {
621
- if (err instanceof Error && err.message.includes("No Directive system")) {
622
- throw err;
623
- }
624
- throw new Error(
625
- `Failed to load ${pc.dim(filePath)}: ${err instanceof Error ? err.message : String(err)}
265
+ ${d.cyan("export default")} createSystem({ module: myModule });
266
+ ${d.cyan("export const system")} = createSystem({ module: myModule });`)}catch(t){throw t instanceof Error&&t.message.includes("No Directive system")?t:new Error(`Failed to load ${d.dim(e)}: ${t instanceof Error?t.message:String(t)}
626
267
 
627
268
  Make sure the file is valid TypeScript and tsx is installed:
628
- ${pc.cyan("npm install -D tsx")}`
629
- );
630
- }
631
- }
632
- function isSystem(obj) {
633
- if (typeof obj !== "object" || obj === null) {
634
- return false;
635
- }
636
- const sys = obj;
637
- return typeof sys.inspect === "function" && typeof sys.start === "function" && typeof sys.stop === "function" && "facts" in sys;
638
- }
639
-
640
- export { CLI_NAME, PACKAGE_NAME, SECTION_END, SECTION_START, detectMonorepo, detectTools, generateLlmsTxt, getTemplate, hasDirectiveSection, loadSystem, mergeSection };
641
- //# sourceMappingURL=index.js.map
269
+ ${d.cyan("npm install -D tsx")}`)}}function v(e){if(typeof e!="object"||e===null)return false;let r=e;return typeof r.inspect=="function"&&typeof r.start=="function"&&typeof r.stop=="function"&&"facts"in r}export{L as CLI_NAME,K as PACKAGE_NAME,l as SECTION_END,m as SECTION_START,G as detectMonorepo,N as detectTools,T as generateLlmsTxt,D as getTemplate,F as hasDirectiveSection,U as loadSystem,$ as mergeSection};//# sourceMappingURL=index.js.map
642
270
  //# sourceMappingURL=index.js.map