@directive-run/mcp 0.2.3 → 0.3.1
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.
- package/README.md +7 -1
- package/dist/cli.js +21 -19
- package/dist/cli.js.map +1 -1
- package/dist/index.cjs +25 -23
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +28 -26
- package/dist/index.js.map +1 -1
- package/package.json +5 -4
package/dist/index.cjs
CHANGED
|
@@ -1,47 +1,49 @@
|
|
|
1
|
-
'use strict';var crypto=require('crypto'),claudePlugin=require('@directive-run/claude-plugin'),knowledge=require('@directive-run/knowledge'),scaffold=require('@directive-run/scaffold'),mcp_js=require('@modelcontextprotocol/sdk/server/mcp.js'),zod=require('zod'),url=require('url'),worker_threads=require('worker_threads'),lint=require('@directive-run/lint'),http=require('http'),sse_js=require('@modelcontextprotocol/sdk/server/sse.js');var f=[{name:"@directive-run/ai",version:"1.17.1",description:"AI guardrails and orchestration for Directive. Prompt injection, PII detection, cost tracking, multi-agent patterns.",homepage:"https://directive.run",keywords:["directive","ai","agents","guardrails","orchestration","llm","constraint-driven","ai-safety","prompt-injection","pii-detection","cost-tracking","multi-agent","openai","anthropic","ollama","gemini"],dependencies:[],peerDependencies:["@directive-run/core"],optionalDependencies:[],exports:[".","./anthropic","./devtools","./evals","./gemini","./guardrails","./mcp","./multi-agent","./ollama","./openai","./predicate","./testing"],directory:"ai",published:true},{name:"@directive-run/claude-plugin",version:"1.17.1",description:"Claude Code plugin for Directive \u2014 12 skills covering modules, constraints, resolvers, derivations, AI orchestration, and adapters. Installable via Claude Code's plugin marketplace or consumable programmatically as an npm package.",homepage:"https://directive.run/docs/ide-integration",keywords:["directive","claude","claude-code","skills","ai-rules","plugin","agents","knowledge"],dependencies:[],peerDependencies:[],optionalDependencies:[],exports:["."],directory:"claude-plugin",published:true},{name:"@directive-run/cli",version:"1.17.1",description:"CLI tools for Directive \u2014 AI coding rules, scaffolding, and more.",homepage:"https://directive.run",keywords:["directive","cli","ai-rules","cursor","copilot","claude","windsurf","cline","llms-txt"],dependencies:["@clack/prompts","@directive-run/knowledge","@directive-run/scaffold","picocolors"],peerDependencies:["@directive-run/timeline"],optionalDependencies:[],exports:[".","./llms.txt"],directory:"cli",published:true},{name:"@directive-run/core",version:"1.17.1",description:"The constraint-driven runtime for TypeScript. Declare what must be true \u2014 the runtime makes it happen.",homepage:"https://directive.run",keywords:["directive","constraint-driven","state-management","constraints","reactive","runtime","typescript","ai-guardrails","zero-dependencies","auto-tracking","framework-agnostic","declarative"],dependencies:[],peerDependencies:[],optionalDependencies:[],exports:[".","./adapter-utils","./internals","./migration","./plugins","./testing","./worker"],directory:"core",published:true},{name:"@directive-run/el",version:"1.1.0",description:"Vanilla DOM adapter for Directive. Typed element creation + reactive bindings + JSX runtime.",homepage:"https://directive.run",keywords:["directive","vanilla","dom","elements","jsx","htm","state-management","reactive","constraint-driven"],dependencies:[],peerDependencies:["@directive-run/core","htm"],optionalDependencies:[],exports:[".","./htm","./jsx-dev-runtime","./jsx-runtime"],directory:"el",published:true},{name:"@directive-run/knowledge",version:"1.17.1",description:"Knowledge files, examples, and validation for Directive \u2014 the constraint-driven TypeScript runtime.",homepage:"https://directive.run",keywords:["directive","knowledge","ai-rules","examples"],dependencies:[],peerDependencies:[],optionalDependencies:[],exports:["."],directory:"knowledge",published:true},{name:"@directive-run/lint",version:"0.1.2",description:"ts-morph-based static analysis for Directive code. Rule registry + executable checks + autofixes. Consumed by @directive-run/mcp (review_source, fix_code tools) and the future `directive doctor lint` CLI command. Anti-pattern data sourced from @directive-run/knowledge so rule IDs stay in lock-step.",homepage:"https://directive.run/docs/ide-integration",keywords:["directive","lint","ast","ts-morph","review","anti-patterns"],dependencies:[],peerDependencies:[],optionalDependencies:["ts-morph"],exports:[".","./executable","./worker"],directory:"lint",published:true},{name:"@directive-run/lit",version:"1.17.1",description:"Lit web components adapter for Directive.",homepage:"https://directive.run",keywords:["directive","lit","web-components","state-management","reactive","constraint-driven"],dependencies:[],peerDependencies:["@directive-run/core","lit"],optionalDependencies:[],exports:["."],directory:"lit",published:true},{name:"@directive-run/mcp",version:"0.2.3",description:"Model Context Protocol server that exposes Directive to AI clients \u2014 knowledge files, code examples, and Claude Code skill bundles today, with room to grow into runtime introspection and tooling. stdio for local clients (Claude Desktop, Cursor, MCP Inspector), SSE for hosted deployments at mcp.directive.run.",homepage:"https://directive.run/docs/ide-integration",keywords:["directive","mcp","model-context-protocol","knowledge","ai-rules","sse","stdio"],dependencies:["@directive-run/claude-plugin","@directive-run/knowledge","@directive-run/lint","@directive-run/scaffold","@modelcontextprotocol/sdk","zod"],peerDependencies:[],optionalDependencies:["ts-morph"],exports:["."],directory:"mcp",published:true},{name:"@directive-run/mutator",version:"0.3.1",description:"Discriminated mutation helper for Directive \u2014 collapse the pendingAction ceremony to a typed handler map.",homepage:"https://directive.run",keywords:["directive","mutator","state-management","discriminated-union","optimistic-update"],dependencies:[],peerDependencies:["@directive-run/core"],optionalDependencies:[],exports:["."],directory:"mutator",published:true},{name:"@directive-run/optimistic",version:"0.2.0",description:"Resolver-scope optimistic update + automatic rollback for Directive.",homepage:"https://directive.run",keywords:["directive","optimistic","rollback","snapshot","state-management"],dependencies:[],peerDependencies:["@directive-run/core"],optionalDependencies:[],exports:["."],directory:"optimistic",published:true},{name:"@directive-run/query",version:"1.2.0",description:"Declarative data fetching for Directive. Constraint-driven queries with causal cache invalidation.",homepage:"https://directive.run",keywords:["directive","data-fetching","query","cache","stale-while-revalidate","constraint-driven","reactive","typescript"],dependencies:[],peerDependencies:["@directive-run/core"],optionalDependencies:[],exports:["."],directory:"query",published:true},{name:"@directive-run/react",version:"1.17.1",description:"React hooks and components for Directive.",homepage:"https://directive.run",keywords:["directive","react","hooks","state-management","reactive","constraint-driven"],dependencies:[],peerDependencies:["@directive-run/core","@directive-run/query","react"],optionalDependencies:[],exports:["."],directory:"react",published:true},{name:"@directive-run/scaffold",version:"0.1.0",description:"Pure source-string generators for Directive modules and orchestrators. Shared substrate consumed by @directive-run/cli (its `directive new` command) and @directive-run/mcp (its `generate_module` tool). Zero runtime dependencies.",homepage:"https://directive.run/docs/ide-integration",keywords:["directive","scaffold","codegen","module-generator"],dependencies:[],peerDependencies:[],optionalDependencies:[],exports:["."],directory:"scaffold",published:true},{name:"@directive-run/solid",version:"1.17.1",description:"Solid.js signals adapter for Directive.",homepage:"https://directive.run",keywords:["directive","solid","solidjs","signals","state-management","reactive","constraint-driven"],dependencies:[],peerDependencies:["@directive-run/core","@directive-run/query","solid-js"],optionalDependencies:[],exports:["."],directory:"solid",published:true},{name:"@directive-run/svelte",version:"1.17.1",description:"Svelte stores adapter for Directive.",homepage:"https://directive.run",keywords:["directive","svelte","stores","state-management","reactive","constraint-driven"],dependencies:[],peerDependencies:["@directive-run/core","@directive-run/query","svelte"],optionalDependencies:[],exports:["."],directory:"svelte",published:true},{name:"@directive-run/timeline",version:"0.3.1",description:"Time-travel test REPL for Directive. Auto-renders the causal-graph timeline of any failing test.",homepage:"https://directive.run",keywords:["directive","time-travel","test-debugging","vitest","causal-graph","state-management"],dependencies:[],peerDependencies:["@directive-run/core","vitest"],optionalDependencies:[],exports:[".","./matchers","./reporter"],directory:"timeline",published:true},{name:"@directive-run/vite-plugin-api-proxy",version:"0.1.1",description:"",keywords:[],dependencies:[],peerDependencies:["vite"],optionalDependencies:[],exports:["."],directory:"vite-plugin-api-proxy",published:false},{name:"@directive-run/vue",version:"1.17.1",description:"Vue composition API adapter for Directive.",homepage:"https://directive.run",keywords:["directive","vue","composition-api","state-management","reactive","constraint-driven"],dependencies:[],peerDependencies:["@directive-run/core","@directive-run/query","vue"],optionalDependencies:[],exports:["."],directory:"vue",published:true}],T="2026-06-04T03:51:34.233Z";var D=2e5,E=5e3,q=/^[\w./-]{1,128}$/,l=class extends Error{constructor(r,i){super(r);this.code=i;}};function $(e){let t=Buffer.byteLength(e.source,"utf8");if(t>D)throw new l(`source is ${t} bytes (max ${D})`,"source-too-large");let r="fileName"in e?e.fileName:void 0;if(r!==void 0&&!q.test(r))throw new l("invalid fileName","bad-filename")}async function Q(){let e=await undefined("@directive-run/lint/worker");return url.fileURLToPath(e)}async function I(e){let t=await Q(),r=new worker_threads.Worker(t,{stderr:false}),i=null;try{return await new Promise((n,s)=>{let c=!1;r.once("message",a=>{c=!0,a.ok&&a.result!==void 0?n(a.result):s(new l(a.error??"worker returned without result","worker-error"));}),r.once("error",a=>{c=!0,s(new l(a.message,"worker-error"));}),r.once("exit",a=>{!c&&a!==0&&a!==null&&s(new l(`worker exited with code ${a} before responding`,"worker-error"));}),i=setTimeout(()=>{r.terminate(),s(new l(`parse exceeded ${E}ms budget`,"timeout"));},E),r.postMessage(e);})}finally{i&&clearTimeout(i),await r.terminate().catch(()=>{});}}function R(){return !(process.env.DIRECTIVE_MCP_USE_LINT_WORKER==="0"||process.env.VITEST==="true")}async function C(e){return $(e),R()?I({kind:"run",source:e.source,options:{fileName:e.fileName,ruleFilter:e.ruleFilter}}):lint.runRules(e.source,{fileName:e.fileName,ruleFilter:e.ruleFilter})}async function P(e){return $(e),R()?I({kind:"fix",source:e.source,finding:e.finding}):lint.applyFix(e.source,e.finding)}var ee=3600*1e3,te=3e3,A=new Map;function y(){return f.map(e=>({name:e.name,summary:e.description,published:e.published}))}async function L(e){let t=f.find(n=>n.name===e);if(!t)return;let{liveVersion:r,stale:i}=await ie(t);return re(t,r,i)}function re(e,t,r){return {name:e.name,description:e.description,homepage:e.homepage,keywords:e.keywords,dependencies:e.dependencies,peerDependencies:e.peerDependencies,optionalDependencies:e.optionalDependencies,exports:e.exports,published:e.published,npmUrl:e.published?`https://www.npmjs.com/package/${e.name}`:void 0,bakedVersion:e.version,liveVersion:t,stale:r}}async function ie(e){if(!e.published)return {stale:true};let t=A.get(e.name);if(t&&Date.now()-t.fetchedAt<ee)return {liveVersion:t.liveVersion,stale:t.liveVersion===void 0};let r=await ne(e.name);return A.set(e.name,{fetchedAt:Date.now(),liveVersion:r.liveVersion,latest:r.liveVersion,error:r.error}),{liveVersion:r.liveVersion,stale:r.liveVersion===void 0}}async function ne(e){let t=`https://registry.npmjs.org/${encodeURIComponent(e).replace(/%2F/g,"/")}/latest`,r=new AbortController,i=setTimeout(()=>r.abort(),te);try{let n=await fetch(t,{signal:r.signal});if(!n.ok)return {error:`HTTP ${n.status}`};let s=await n.json();return typeof s.version=="string"?{liveVersion:s.version}:{error:"no version field"}}catch(n){return {error:n.message}}finally{clearTimeout(i);}}var M="0.2.3",j=50,N=200,F=512;function we(e){return e.length>N?`${e.slice(0,N)}\u2026`:e}function V(e,t,r){let i=e.toLowerCase(),n=[];for(let[s,c]of t){let a=c.split(`
|
|
2
|
-
`);for(let
|
|
1
|
+
'use strict';var crypto=require('crypto'),claudePlugin=require('@directive-run/claude-plugin'),knowledge=require('@directive-run/knowledge'),scaffold=require('@directive-run/scaffold'),mcp_js=require('@modelcontextprotocol/sdk/server/mcp.js'),zod=require('zod'),url=require('url'),worker_threads=require('worker_threads'),lint=require('@directive-run/lint'),http=require('http'),sse_js=require('@modelcontextprotocol/sdk/server/sse.js');var fe=Object.create;var G=Object.defineProperty;var ve=Object.getOwnPropertyDescriptor;var he=Object.getOwnPropertyNames;var ye=Object.getPrototypeOf,we=Object.prototype.hasOwnProperty;var xe=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports);var ke=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of he(t))!we.call(e,i)&&i!==r&&G(e,i,{get:()=>t[i],enumerable:!(n=ve(t,i))||n.enumerable});return e};var be=(e,t,r)=>(r=e!=null?fe(ye(e)):{},ke(G(r,"default",{value:e,enumerable:true}),e));var ee=xe((Tt,I)=>{var M=(function(){var e=String.fromCharCode,t="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=",r="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+-$",n={};function i(o,s){if(!n[o]){n[o]={};for(var u=0;u<o.length;u++)n[o][o.charAt(u)]=u;}return n[o][s]}var d={compressToBase64:function(o){if(o==null)return "";var s=d._compress(o,6,function(u){return t.charAt(u)});switch(s.length%4){default:case 0:return s;case 1:return s+"===";case 2:return s+"==";case 3:return s+"="}},decompressFromBase64:function(o){return o==null?"":o==""?null:d._decompress(o.length,32,function(s){return i(t,o.charAt(s))})},compressToUTF16:function(o){return o==null?"":d._compress(o,15,function(s){return e(s+32)})+" "},decompressFromUTF16:function(o){return o==null?"":o==""?null:d._decompress(o.length,16384,function(s){return o.charCodeAt(s)-32})},compressToUint8Array:function(o){for(var s=d.compress(o),u=new Uint8Array(s.length*2),l=0,p=s.length;l<p;l++){var y=s.charCodeAt(l);u[l*2]=y>>>8,u[l*2+1]=y%256;}return u},decompressFromUint8Array:function(o){if(o==null)return d.decompress(o);for(var s=new Array(o.length/2),u=0,l=s.length;u<l;u++)s[u]=o[u*2]*256+o[u*2+1];var p=[];return s.forEach(function(y){p.push(e(y));}),d.decompress(p.join(""))},compressToEncodedURIComponent:function(o){return o==null?"":d._compress(o,6,function(s){return r.charAt(s)})},decompressFromEncodedURIComponent:function(o){return o==null?"":o==""?null:(o=o.replace(/ /g,"+"),d._decompress(o.length,32,function(s){return i(r,o.charAt(s))}))},compress:function(o){return d._compress(o,16,function(s){return e(s)})},_compress:function(o,s,u){if(o==null)return "";var l,p,y={},k={},b="",_="",h="",w=2,E=3,m=2,v=[],a=0,c=0,x;for(x=0;x<o.length;x+=1)if(b=o.charAt(x),Object.prototype.hasOwnProperty.call(y,b)||(y[b]=E++,k[b]=true),_=h+b,Object.prototype.hasOwnProperty.call(y,_))h=_;else {if(Object.prototype.hasOwnProperty.call(k,h)){if(h.charCodeAt(0)<256){for(l=0;l<m;l++)a=a<<1,c==s-1?(c=0,v.push(u(a)),a=0):c++;for(p=h.charCodeAt(0),l=0;l<8;l++)a=a<<1|p&1,c==s-1?(c=0,v.push(u(a)),a=0):c++,p=p>>1;}else {for(p=1,l=0;l<m;l++)a=a<<1|p,c==s-1?(c=0,v.push(u(a)),a=0):c++,p=0;for(p=h.charCodeAt(0),l=0;l<16;l++)a=a<<1|p&1,c==s-1?(c=0,v.push(u(a)),a=0):c++,p=p>>1;}w--,w==0&&(w=Math.pow(2,m),m++),delete k[h];}else for(p=y[h],l=0;l<m;l++)a=a<<1|p&1,c==s-1?(c=0,v.push(u(a)),a=0):c++,p=p>>1;w--,w==0&&(w=Math.pow(2,m),m++),y[_]=E++,h=String(b);}if(h!==""){if(Object.prototype.hasOwnProperty.call(k,h)){if(h.charCodeAt(0)<256){for(l=0;l<m;l++)a=a<<1,c==s-1?(c=0,v.push(u(a)),a=0):c++;for(p=h.charCodeAt(0),l=0;l<8;l++)a=a<<1|p&1,c==s-1?(c=0,v.push(u(a)),a=0):c++,p=p>>1;}else {for(p=1,l=0;l<m;l++)a=a<<1|p,c==s-1?(c=0,v.push(u(a)),a=0):c++,p=0;for(p=h.charCodeAt(0),l=0;l<16;l++)a=a<<1|p&1,c==s-1?(c=0,v.push(u(a)),a=0):c++,p=p>>1;}w--,w==0&&(w=Math.pow(2,m),m++),delete k[h];}else for(p=y[h],l=0;l<m;l++)a=a<<1|p&1,c==s-1?(c=0,v.push(u(a)),a=0):c++,p=p>>1;w--,w==0&&(w=Math.pow(2,m),m++);}for(p=2,l=0;l<m;l++)a=a<<1|p&1,c==s-1?(c=0,v.push(u(a)),a=0):c++,p=p>>1;for(;;)if(a=a<<1,c==s-1){v.push(u(a));break}else c++;return v.join("")},decompress:function(o){return o==null?"":o==""?null:d._decompress(o.length,32768,function(s){return o.charCodeAt(s)})},_decompress:function(o,s,u){var l=[],y=4,k=4,b=3,_="",h=[],w,E,m,v,a,c,x,g={val:u(0),position:s,index:1};for(w=0;w<3;w+=1)l[w]=w;for(m=0,a=Math.pow(2,2),c=1;c!=a;)v=g.val&g.position,g.position>>=1,g.position==0&&(g.position=s,g.val=u(g.index++)),m|=(v>0?1:0)*c,c<<=1;switch(m){case 0:for(m=0,a=Math.pow(2,8),c=1;c!=a;)v=g.val&g.position,g.position>>=1,g.position==0&&(g.position=s,g.val=u(g.index++)),m|=(v>0?1:0)*c,c<<=1;x=e(m);break;case 1:for(m=0,a=Math.pow(2,16),c=1;c!=a;)v=g.val&g.position,g.position>>=1,g.position==0&&(g.position=s,g.val=u(g.index++)),m|=(v>0?1:0)*c,c<<=1;x=e(m);break;case 2:return ""}for(l[3]=x,E=x,h.push(x);;){if(g.index>o)return "";for(m=0,a=Math.pow(2,b),c=1;c!=a;)v=g.val&g.position,g.position>>=1,g.position==0&&(g.position=s,g.val=u(g.index++)),m|=(v>0?1:0)*c,c<<=1;switch(x=m){case 0:for(m=0,a=Math.pow(2,8),c=1;c!=a;)v=g.val&g.position,g.position>>=1,g.position==0&&(g.position=s,g.val=u(g.index++)),m|=(v>0?1:0)*c,c<<=1;l[k++]=e(m),x=k-1,y--;break;case 1:for(m=0,a=Math.pow(2,16),c=1;c!=a;)v=g.val&g.position,g.position>>=1,g.position==0&&(g.position=s,g.val=u(g.index++)),m|=(v>0?1:0)*c,c<<=1;l[k++]=e(m),x=k-1,y--;break;case 2:return h.join("")}if(y==0&&(y=Math.pow(2,b),b++),l[x])_=l[x];else if(x===k)_=E+E.charAt(0);else return null;h.push(_),l[k++]=E+_.charAt(0),y--,E=_,y==0&&(y=Math.pow(2,b),b++);}}};return d})();typeof define=="function"&&define.amd?define(function(){return M}):typeof I<"u"&&I!=null?I.exports=M:typeof angular<"u"&&angular!=null&&angular.module("LZString",[]).factory("LZString",function(){return M});});var P=[{name:"@directive-run/ai",version:"1.17.1",description:"AI guardrails and orchestration for Directive. Prompt injection, PII detection, cost tracking, multi-agent patterns.",homepage:"https://directive.run",keywords:["directive","ai","agents","guardrails","orchestration","llm","constraint-driven","ai-safety","prompt-injection","pii-detection","cost-tracking","multi-agent","openai","anthropic","ollama","gemini"],dependencies:[],peerDependencies:["@directive-run/core"],optionalDependencies:[],exports:[".","./anthropic","./devtools","./evals","./gemini","./guardrails","./mcp","./multi-agent","./ollama","./openai","./predicate","./testing"],directory:"ai",published:true},{name:"@directive-run/claude-plugin",version:"1.17.1",description:"Claude Code plugin for Directive \u2014 12 skills covering modules, constraints, resolvers, derivations, AI orchestration, and adapters. Installable via Claude Code's plugin marketplace or consumable programmatically as an npm package.",homepage:"https://directive.run/docs/ide-integration",keywords:["directive","claude","claude-code","skills","ai-rules","plugin","agents","knowledge"],dependencies:[],peerDependencies:[],optionalDependencies:[],exports:["."],directory:"claude-plugin",published:true},{name:"@directive-run/cli",version:"1.17.1",description:"CLI tools for Directive \u2014 AI coding rules, scaffolding, and more.",homepage:"https://directive.run",keywords:["directive","cli","ai-rules","cursor","copilot","claude","windsurf","cline","llms-txt"],dependencies:["@clack/prompts","@directive-run/knowledge","@directive-run/scaffold","picocolors"],peerDependencies:["@directive-run/timeline"],optionalDependencies:[],exports:[".","./llms.txt"],directory:"cli",published:true},{name:"@directive-run/core",version:"1.17.1",description:"The constraint-driven runtime for TypeScript. Declare what must be true \u2014 the runtime makes it happen.",homepage:"https://directive.run",keywords:["directive","constraint-driven","state-management","constraints","reactive","runtime","typescript","ai-guardrails","zero-dependencies","auto-tracking","framework-agnostic","declarative"],dependencies:[],peerDependencies:[],optionalDependencies:[],exports:[".","./adapter-utils","./internals","./migration","./plugins","./testing","./worker"],directory:"core",published:true},{name:"@directive-run/el",version:"1.1.0",description:"Vanilla DOM adapter for Directive. Typed element creation + reactive bindings + JSX runtime.",homepage:"https://directive.run",keywords:["directive","vanilla","dom","elements","jsx","htm","state-management","reactive","constraint-driven"],dependencies:[],peerDependencies:["@directive-run/core","htm"],optionalDependencies:[],exports:[".","./htm","./jsx-dev-runtime","./jsx-runtime"],directory:"el",published:true},{name:"@directive-run/knowledge",version:"1.17.1",description:"Knowledge files, examples, and validation for Directive \u2014 the constraint-driven TypeScript runtime.",homepage:"https://directive.run",keywords:["directive","knowledge","ai-rules","examples"],dependencies:[],peerDependencies:[],optionalDependencies:[],exports:["."],directory:"knowledge",published:true},{name:"@directive-run/lint",version:"0.1.2",description:"ts-morph-based static analysis for Directive code. Rule registry + executable checks + autofixes. Consumed by @directive-run/mcp (review_source, fix_code tools) and the future `directive doctor lint` CLI command. Anti-pattern data sourced from @directive-run/knowledge so rule IDs stay in lock-step.",homepage:"https://directive.run/docs/ide-integration",keywords:["directive","lint","ast","ts-morph","review","anti-patterns"],dependencies:[],peerDependencies:[],optionalDependencies:["ts-morph"],exports:[".","./executable","./worker"],directory:"lint",published:true},{name:"@directive-run/lit",version:"1.17.1",description:"Lit web components adapter for Directive.",homepage:"https://directive.run",keywords:["directive","lit","web-components","state-management","reactive","constraint-driven"],dependencies:[],peerDependencies:["@directive-run/core","lit"],optionalDependencies:[],exports:["."],directory:"lit",published:true},{name:"@directive-run/mcp",version:"0.3.1",description:"Model Context Protocol server that exposes Directive to AI clients \u2014 knowledge files, code examples, and Claude Code skill bundles today, with room to grow into runtime introspection and tooling. stdio for local clients (Claude Desktop, Cursor, MCP Inspector), SSE for hosted deployments at mcp.directive.run.",homepage:"https://directive.run/docs/ide-integration",keywords:["directive","mcp","model-context-protocol","knowledge","ai-rules","sse","stdio"],dependencies:["@directive-run/claude-plugin","@directive-run/knowledge","@directive-run/lint","@directive-run/scaffold","@modelcontextprotocol/sdk","lz-string","zod"],peerDependencies:[],optionalDependencies:["ts-morph"],exports:["."],directory:"mcp",published:true},{name:"@directive-run/mutator",version:"0.3.1",description:"Discriminated mutation helper for Directive \u2014 collapse the pendingAction ceremony to a typed handler map.",homepage:"https://directive.run",keywords:["directive","mutator","state-management","discriminated-union","optimistic-update"],dependencies:[],peerDependencies:["@directive-run/core"],optionalDependencies:[],exports:["."],directory:"mutator",published:true},{name:"@directive-run/optimistic",version:"0.2.0",description:"Resolver-scope optimistic update + automatic rollback for Directive.",homepage:"https://directive.run",keywords:["directive","optimistic","rollback","snapshot","state-management"],dependencies:[],peerDependencies:["@directive-run/core"],optionalDependencies:[],exports:["."],directory:"optimistic",published:true},{name:"@directive-run/query",version:"1.2.0",description:"Declarative data fetching for Directive. Constraint-driven queries with causal cache invalidation.",homepage:"https://directive.run",keywords:["directive","data-fetching","query","cache","stale-while-revalidate","constraint-driven","reactive","typescript"],dependencies:[],peerDependencies:["@directive-run/core"],optionalDependencies:[],exports:["."],directory:"query",published:true},{name:"@directive-run/react",version:"1.17.1",description:"React hooks and components for Directive.",homepage:"https://directive.run",keywords:["directive","react","hooks","state-management","reactive","constraint-driven"],dependencies:[],peerDependencies:["@directive-run/core","@directive-run/query","react"],optionalDependencies:[],exports:["."],directory:"react",published:true},{name:"@directive-run/scaffold",version:"0.1.0",description:"Pure source-string generators for Directive modules and orchestrators. Shared substrate consumed by @directive-run/cli (its `directive new` command) and @directive-run/mcp (its `generate_module` tool). Zero runtime dependencies.",homepage:"https://directive.run/docs/ide-integration",keywords:["directive","scaffold","codegen","module-generator"],dependencies:[],peerDependencies:[],optionalDependencies:[],exports:["."],directory:"scaffold",published:true},{name:"@directive-run/solid",version:"1.17.1",description:"Solid.js signals adapter for Directive.",homepage:"https://directive.run",keywords:["directive","solid","solidjs","signals","state-management","reactive","constraint-driven"],dependencies:[],peerDependencies:["@directive-run/core","@directive-run/query","solid-js"],optionalDependencies:[],exports:["."],directory:"solid",published:true},{name:"@directive-run/svelte",version:"1.17.1",description:"Svelte stores adapter for Directive.",homepage:"https://directive.run",keywords:["directive","svelte","stores","state-management","reactive","constraint-driven"],dependencies:[],peerDependencies:["@directive-run/core","@directive-run/query","svelte"],optionalDependencies:[],exports:["."],directory:"svelte",published:true},{name:"@directive-run/timeline",version:"0.3.1",description:"Time-travel test REPL for Directive. Auto-renders the causal-graph timeline of any failing test.",homepage:"https://directive.run",keywords:["directive","time-travel","test-debugging","vitest","causal-graph","state-management"],dependencies:[],peerDependencies:["@directive-run/core","vitest"],optionalDependencies:[],exports:[".","./matchers","./reporter"],directory:"timeline",published:true},{name:"@directive-run/vite-plugin-api-proxy",version:"0.1.1",description:"",keywords:[],dependencies:[],peerDependencies:["vite"],optionalDependencies:[],exports:["."],directory:"vite-plugin-api-proxy",published:false},{name:"@directive-run/vue",version:"1.17.1",description:"Vue composition API adapter for Directive.",homepage:"https://directive.run",keywords:["directive","vue","composition-api","state-management","reactive","constraint-driven"],dependencies:[],peerDependencies:["@directive-run/core","@directive-run/query","vue"],optionalDependencies:[],exports:["."],directory:"vue",published:true}],H="2026-06-05T01:30:22.108Z";var z=2e5,K=5e3,De=/^[\w./-]{1,128}$/,S=class extends Error{constructor(r,n){super(r);this.code=n;}};function W(e){let t=Buffer.byteLength(e.source,"utf8");if(t>z)throw new S(`source is ${t} bytes (max ${z})`,"source-too-large");let r="fileName"in e?e.fileName:void 0;if(r!==void 0&&!De.test(r))throw new S("invalid fileName","bad-filename")}async function Re(){let e=await undefined("@directive-run/lint/worker");return url.fileURLToPath(e)}async function Y(e){let t=await Re(),r=new worker_threads.Worker(t,{stderr:false}),n=null;try{return await new Promise((i,d)=>{let o=!1;r.once("message",s=>{o=!0,s.ok&&s.result!==void 0?i(s.result):d(new S(s.error??"worker returned without result","worker-error"));}),r.once("error",s=>{o=!0,d(new S(s.message,"worker-error"));}),r.once("exit",s=>{!o&&s!==0&&s!==null&&d(new S(`worker exited with code ${s} before responding`,"worker-error"));}),n=setTimeout(()=>{r.terminate(),d(new S(`parse exceeded ${K}ms budget`,"timeout"));},K),r.postMessage(e);})}finally{n&&clearTimeout(n),await r.terminate().catch(()=>{});}}function X(){return !(process.env.DIRECTIVE_MCP_USE_LINT_WORKER==="0"||process.env.VITEST==="true")}async function J(e){return W(e),X()?Y({kind:"run",source:e.source,options:{fileName:e.fileName,ruleFilter:e.ruleFilter}}):lint.runRules(e.source,{fileName:e.fileName,ruleFilter:e.ruleFilter})}async function Z(e){return W(e),X()?Y({kind:"fix",source:e.source,finding:e.finding}):lint.applyFix(e.source,e.finding)}var $e=3600*1e3,Ie=3e3,q=new Map;function O(){return P.map(e=>({name:e.name,summary:e.description,published:e.published}))}async function Q(e){let t=P.find(i=>i.name===e);if(!t)return;let{liveVersion:r,stale:n}=await Le(t);return Ae(t,r,n)}function Ae(e,t,r){return {name:e.name,description:e.description,homepage:e.homepage,keywords:e.keywords,dependencies:e.dependencies,peerDependencies:e.peerDependencies,optionalDependencies:e.optionalDependencies,exports:e.exports,published:e.published,npmUrl:e.published?`https://www.npmjs.com/package/${e.name}`:void 0,bakedVersion:e.version,liveVersion:t,stale:r}}async function Le(e){if(!e.published)return {stale:true};let t=q.get(e.name);if(t&&Date.now()-t.fetchedAt<$e)return {liveVersion:t.liveVersion,stale:t.liveVersion===void 0};let r=await Ce(e.name);return q.set(e.name,{fetchedAt:Date.now(),liveVersion:r.liveVersion,latest:r.liveVersion,error:r.error}),{liveVersion:r.liveVersion,stale:r.liveVersion===void 0}}async function Ce(e){let t=`https://registry.npmjs.org/${encodeURIComponent(e).replace(/%2F/g,"/")}/latest`,r=new AbortController,n=setTimeout(()=>r.abort(),Ie);try{let i=await fetch(t,{signal:r.signal});if(!i.ok)return {error:`HTTP ${i.status}`};let d=await i.json();return typeof d.version=="string"?{liveVersion:d.version}:{error:"no version field"}}catch(i){return {error:i.message}}finally{clearTimeout(n);}}var te=be(ee()),D=8e3,Pe="https://directive.run/playground",R=class extends Error{constructor(r,n){super(r);this.code=n;}};function Oe(e){if(e.length===0)throw new R("source is empty","source-empty");let t=Buffer.byteLength(e,"utf8");if(t>D)throw new R(`source is ${t} bytes (max ${D}). Snippets larger than ${D} bytes don't fit reliably in a URL \u2014 copy the source into a fresh Stackblitz project instead.`,"source-too-large")}function Me(e){return encodeURIComponent(e)}function re(e){Oe(e.source);let r=[`src=${(0, te.compressToEncodedURIComponent)(e.source)}`];e.title&&r.push(`t=${Me(e.title)}`);let n=`${Pe}#${r.join("&")}`;return {url:n,sizeBytes:Buffer.byteLength(e.source,"utf8"),urlBytes:Buffer.byteLength(n,"utf8"),title:e.title}}var ie="0.3.1",le=50,oe=200,se=512;function Qe(e){return e.length>oe?`${e.slice(0,oe)}\u2026`:e}function ae(e,t,r){let n=e.toLowerCase(),i=[];for(let[d,o]of t){let s=o.split(`
|
|
2
|
+
`);for(let u=0;u<s.length;u++){let l=s[u];if(l.toLowerCase().includes(n)&&(i.push(`${d}${r}:${u+1}: ${Qe(l)}`),i.length>=le))return i}}return i}function ce(e,t){return t.length===0?`No matches for '${e}'.`:`${t.length===le?`${t.length}+ matches (truncated):`:`${t.length} matches:`}
|
|
3
3
|
${t.join(`
|
|
4
|
-
`)}`}var
|
|
5
|
-
`)}function
|
|
4
|
+
`)}`}var L=null;function et(){if(L)return L;let e=crypto.createHash("sha256");for(let[t,r]of Array.from(knowledge.getAllKnowledge()).sort(([n],[i])=>n.localeCompare(i)))e.update(t),e.update("\0"),e.update(r),e.update("\0");return L=e.digest("hex").slice(0,16),L}var $={transport:"stdio",authEnabled:false};function de(e){$=e;}function C(e,t,r){r.length!==0&&e.push("",`**${t}:**`,...r.map(n=>`- ${n}`));}function tt(e){let t=[`# ${e.name}`,e.description,"",`**Version (live):** ${e.liveVersion??"unknown"}`,`**Version (baked):** ${e.bakedVersion}${e.stale?" (live fetch failed; using baked)":""}`,`**Published to npm:** ${e.published?"yes":"no (private workspace package)"}`];return e.homepage&&t.push(`**Homepage:** ${e.homepage}`),e.npmUrl&&t.push(`**npm:** ${e.npmUrl}`),C(t,"Dependencies",e.dependencies),C(t,"Peer dependencies",e.peerDependencies),C(t,"Optional dependencies",e.optionalDependencies),C(t,"Exports",e.exports),t.join(`
|
|
5
|
+
`)}function B(){let e=new mcp_js.McpServer({name:"directive",version:ie});return e.registerTool("list_knowledge",{title:"List Directive knowledge files",description:"List every knowledge file shipped in @directive-run/knowledge. Returns the file names (without .md) that can be passed to get_knowledge. Covers core docs (engine, facts, constraints, resolvers, derivations, effects, plugins, modules, systems, testing) and AI docs (orchestrator, agents, adapters, guardrails, memory, MCP, RAG, security, evals, budget, multi-agent).",inputSchema:{}},async()=>{let t=knowledge.getAllKnowledge(),r=Array.from(t.keys()).sort();return {content:[{type:"text",text:`${r.length} knowledge files:
|
|
6
6
|
${r.join(`
|
|
7
7
|
`)}`}]}}),e.registerTool("get_knowledge",{title:"Get a Directive knowledge file",description:"Fetch the full Markdown contents of one Directive knowledge file by name. Use list_knowledge first to discover available names. Names match the file stem (e.g. 'constraints', 'ai-orchestrator', 'api-skeleton').",inputSchema:{name:zod.z.string().min(1).describe("The knowledge file name (no .md suffix). Example: 'constraints', 'ai-orchestrator', 'api-skeleton'.")}},async({name:t})=>{let r=knowledge.getKnowledge(t);return r?{content:[{type:"text",text:r}]}:{isError:true,content:[{type:"text",text:`Knowledge file not found: '${t}'. Call list_knowledge to see available names.`}]}}),e.registerTool("list_examples",{title:"List Directive code examples",description:"List every code example shipped in @directive-run/knowledge. Examples are minimal, working TypeScript files demonstrating one concept each. Pass the returned names to get_example.",inputSchema:{}},async()=>{let t=knowledge.getAllExamples(),r=Array.from(t.keys()).sort();return {content:[{type:"text",text:`${r.length} examples:
|
|
8
8
|
${r.join(`
|
|
9
9
|
`)}`}]}}),e.registerTool("get_example",{title:"Get a Directive code example",description:"Fetch the source of one Directive code example by name. Use list_examples first to discover available names. Returns raw TypeScript.",inputSchema:{name:zod.z.string().min(1).describe("The example file name (no .ts suffix). Example: 'basic-module', 'ai-orchestrator'.")}},async({name:t})=>{let r=knowledge.getExample(t);return r?{content:[{type:"text",text:`\`\`\`typescript
|
|
10
10
|
${r}
|
|
11
|
-
\`\`\``}]}:{isError:true,content:[{type:"text",text:`Example not found: '${t}'. Call list_examples to see available names.`}]}}),e.registerTool("search_knowledge",{title:"Search Directive knowledge files",description:"Case-insensitive substring search across every knowledge file. Returns existing reference material; does NOT generate code. Use this to find which knowledge file covers a topic before calling get_knowledge for the full document.",inputSchema:{query:zod.z.string().min(1).max(
|
|
11
|
+
\`\`\``}]}:{isError:true,content:[{type:"text",text:`Example not found: '${t}'. Call list_examples to see available names.`}]}}),e.registerTool("search_knowledge",{title:"Search Directive knowledge files",description:"Case-insensitive substring search across every knowledge file. Returns existing reference material; does NOT generate code. Use this to find which knowledge file covers a topic before calling get_knowledge for the full document.",inputSchema:{query:zod.z.string().min(1).max(se).describe("The search string. Matched case-insensitively against every line of every knowledge file.")}},async({query:t})=>{let r=ae(t,knowledge.getAllKnowledge(),".md");return {content:[{type:"text",text:ce(t,r)}]}}),e.registerTool("search_examples",{title:"Search Directive code examples",description:"Case-insensitive substring search across every bundled code example (.ts files in @directive-run/knowledge). Returns existing reference material; does NOT generate code. Use this to find which example demonstrates a concept before calling get_example for the full source.",inputSchema:{query:zod.z.string().min(1).max(se).describe("The search string. Matched case-insensitively against every line of every example file.")}},async({query:t})=>{let r=ae(t,knowledge.getAllExamples(),".ts");return {content:[{type:"text",text:ce(t,r)}]}}),e.registerTool("list_packages",{title:"List @directive-run/* packages",description:"Enumerate every @directive-run/* package known to this MCP server. Returns name + one-line description. Use this to answer 'what should I install for X?' and to discover names to pass to get_package_info or get_composable_packages. Returns existing reference material; does NOT generate code.",inputSchema:{}},async()=>{let t=O(),r=t.map(n=>`${n.name}${n.published?"":" (private)"} \u2014 ${n.summary}`);return {content:[{type:"text",text:`${t.length} packages:
|
|
12
12
|
${r.join(`
|
|
13
|
-
`)}`}]}}),e.registerTool("get_package_info",{title:"Get @directive-run/* package detail",description:"Fetch detailed info for one @directive-run/* package: description, dependencies, peerDependencies, exports, npm URL. Returns the version baked into this MCP build AND the live-from-npm version when available (1-hour cache, 3-second timeout, falls back to baked version on network failure). Returns existing reference material; does NOT generate code.",inputSchema:{name:zod.z.string().min(1).max(128).describe("Package name (e.g. '@directive-run/core'). Call list_packages first to discover valid names.")}},async({name:t})=>{let r=await
|
|
14
|
-
${
|
|
13
|
+
`)}`}]}}),e.registerTool("get_package_info",{title:"Get @directive-run/* package detail",description:"Fetch detailed info for one @directive-run/* package: description, dependencies, peerDependencies, exports, npm URL. Returns the version baked into this MCP build AND the live-from-npm version when available (1-hour cache, 3-second timeout, falls back to baked version on network failure). Returns existing reference material; does NOT generate code.",inputSchema:{name:zod.z.string().min(1).max(128).describe("Package name (e.g. '@directive-run/core'). Call list_packages first to discover valid names.")}},async({name:t})=>{let r=await Q(t);return r?{content:[{type:"text",text:tt(r)}]}:{isError:true,content:[{type:"text",text:`Package not found: '${t}'. Call list_packages to see available names.`}]}}),e.registerTool("get_composable_packages",{title:"Get composition siblings for a package",description:"Given a @directive-run/* package name, return the sibling packages it composes with (outgoing edges) AND the packages that compose with IT (incoming edges). Each edge carries a one-line reason. Returns existing reference material; does NOT generate code. Use this to answer 'what should I pair @directive-run/X with?' or 'who else uses @directive-run/Y?'.",inputSchema:{name:zod.z.string().min(1).max(128).describe("Package name (e.g. '@directive-run/query'). Call list_packages first to discover valid names.")}},async({name:t})=>{let r=knowledge.getCompositionsFor(t),n=knowledge.getReverseCompositionsFor(t);if(r.length===0&&n.length===0)return {isError:true,content:[{type:"text",text:O().some(o=>o.name===t)?`NO_COMPOSITIONS: '${t}' is a known package but has no composition edges yet. This is a coverage gap in compositions.json.`:`NOT_FOUND: '${t}' is not a known @directive-run/* package. Call list_packages to see available names.`}]};let i=[`# ${t}`,""];if(r.length>0){i.push("## Composes with:");for(let d of r)i.push(`- ${d.to} \u2014 ${d.reason}`);i.push("");}if(n.length>0){i.push("## Composed by:");for(let d of n)i.push(`- ${d.from} \u2014 ${d.reason}`);}return {content:[{type:"text",text:`<directive-data>
|
|
14
|
+
${i.join(`
|
|
15
15
|
`)}
|
|
16
|
-
</directive-data>`}]}}),e.registerTool("get_server_info",{title:"Get directive MCP server info",description:"Return version manifest for this MCP server build \u2014 package version, transport (stdio or SSE), whether auth is enabled, bundled-knowledge hash, package-registry build timestamp, and (for SSE) the current session count. Returns existing reference material; does NOT generate code. Use this to verify the client is talking to the expected build.",inputSchema:{}},async()=>{let t=[`# @directive-run/mcp@${
|
|
16
|
+
</directive-data>`}]}}),e.registerTool("get_server_info",{title:"Get directive MCP server info",description:"Return version manifest for this MCP server build \u2014 package version, transport (stdio or SSE), whether auth is enabled, bundled-knowledge hash, package-registry build timestamp, and (for SSE) the current session count. Returns existing reference material; does NOT generate code. Use this to verify the client is talking to the expected build.",inputSchema:{}},async()=>{let t=[`# @directive-run/mcp@${ie}`,`**Transport:** ${$.transport}`,`**Auth enabled:** ${$.authEnabled?"yes":"no"}`,`**Bundled knowledge hash:** ${et()}`,`**Package registry built at:** ${H}`];return $.sessionCount!==void 0&&t.push(`**Active SSE sessions:** ${$.sessionCount}`),{content:[{type:"text",text:t.join(`
|
|
17
17
|
`)}]}}),e.registerTool("list_module_sections",{title:"List valid module sections for generate_module",description:"Enumerate the valid `sections` values that `generate_module` accepts: derive, events, constraints, resolvers, effects. Call this before generate_module so the section list comes from the server (no hallucination risk). Returns existing reference material; does NOT generate code.",inputSchema:{}},async()=>({content:[{type:"text",text:`${scaffold.MODULE_SECTIONS.length} module sections:
|
|
18
18
|
${scaffold.MODULE_SECTIONS.join(`
|
|
19
|
-
`)}`}]})),e.registerTool("generate_module",{title:"Generate NEW Directive module source code",description:'Generate the source string for a new Directive module or AI orchestrator. Use this when the user wants to CREATE a module, not learn about one. Returns the source as text; never writes to disk \u2014 the caller decides where to put it. Strict regex on `name` (kebab-case, \u226464 chars). For `kind: "module"`, optionally pass `sections` to pick which blocks to include (default: every section). Discover valid section values via list_module_sections.',inputSchema:{name:zod.z.string().min(1).max(64).describe("Kebab-case identifier (e.g. 'traffic-light'). Must start with a lowercase letter and contain only lowercase letters, digits, and hyphens."),kind:zod.z.enum(["module","orchestrator"]).default("module").describe("What to generate. 'module' for a plain Directive module; 'orchestrator' for an AI agent orchestrator module with memory + guardrails scaffolding."),sections:zod.z.array(zod.z.enum(scaffold.MODULE_SECTIONS)).optional().describe("Which module sections to include. Defaults to every section. Only honored when kind === 'module'. Discover valid values via list_module_sections.")}},async({name:t,kind:r,sections:
|
|
20
|
-
`)}]}}catch(
|
|
19
|
+
`)}`}]})),e.registerTool("generate_module",{title:"Generate NEW Directive module source code",description:'Generate the source string for a new Directive module or AI orchestrator. Use this when the user wants to CREATE a module, not learn about one. Returns the source as text; never writes to disk \u2014 the caller decides where to put it. Strict regex on `name` (kebab-case, \u226464 chars). For `kind: "module"`, optionally pass `sections` to pick which blocks to include (default: every section). Discover valid section values via list_module_sections.',inputSchema:{name:zod.z.string().min(1).max(64).describe("Kebab-case identifier (e.g. 'traffic-light'). Must start with a lowercase letter and contain only lowercase letters, digits, and hyphens."),kind:zod.z.enum(["module","orchestrator"]).default("module").describe("What to generate. 'module' for a plain Directive module; 'orchestrator' for an AI agent orchestrator module with memory + guardrails scaffolding."),sections:zod.z.array(zod.z.enum(scaffold.MODULE_SECTIONS)).optional().describe("Which module sections to include. Defaults to every section. Only honored when kind === 'module'. Discover valid values via list_module_sections.")}},async({name:t,kind:r,sections:n})=>{let i=scaffold.validateModuleName(t);if(i!==true)return {isError:true,content:[{type:"text",text:`Invalid name '${t}': ${i}`}]};try{let d=r==="orchestrator"?scaffold.generateOrchestrator(t):scaffold.generateModule(t,n??scaffold.MODULE_SECTIONS),{sourceFileName:o,testFileName:s}=scaffold.suggestFileNames(t,r),u=scaffold.requiredPackages(r);return {content:[{type:"text",text:[`// Suggested file: src/${o}`,`// Suggested test: src/${s}`,`// Required packages: ${u.join(", ")}`,`// Run: pnpm add ${u.join(" ")}`,"",d].join(`
|
|
20
|
+
`)}]}}catch(d){return {isError:true,content:[{type:"text",text:d.message}]}}}),e.registerTool("list_review_rules",{title:"List Directive code-review rules",description:"Enumerate every anti-pattern Directive code can violate, parsed from @directive-run/knowledge. Each entry carries an id, severity, category, title, badExample, goodExample, and explanation. Use this to discover rule ids before calling get_review_rule or before passing ruleFilter to review_source. Returns existing reference material; does NOT generate code.",inputSchema:{}},async()=>{let t=knowledge.getAntiPatterns(),r=t.map(n=>({id:n.id,severity:n.severity,category:n.category,title:n.title}));return {content:[{type:"text",text:`<directive-data>
|
|
21
21
|
${t.length} review rules:
|
|
22
22
|
${JSON.stringify(r,null,2)}
|
|
23
|
-
</directive-data>`}]}}),e.registerTool("get_review_rule",{title:"Get a Directive code-review rule",description:"Fetch one anti-pattern's full detail: title, severity, category, explanation, and the WRONG/CORRECT code-example pair. Use list_review_rules first to discover valid ids. Returns existing reference material; does NOT generate code.",inputSchema:{id:zod.z.string().min(1).max(128).describe("Rule id (a kebab-case slug \u2014 e.g. 'flat-schema-missing-facts-wrapper'). Call list_review_rules first to discover valid ids.")}},async({id:t})=>{let r=knowledge.getAntiPatternById(t);if(!r)return {isError:true,content:[{type:"text",text:`Rule not found: '${t}'. Call list_review_rules to see available ids.`}]};let
|
|
24
|
-
${
|
|
23
|
+
</directive-data>`}]}}),e.registerTool("get_review_rule",{title:"Get a Directive code-review rule",description:"Fetch one anti-pattern's full detail: title, severity, category, explanation, and the WRONG/CORRECT code-example pair. Use list_review_rules first to discover valid ids. Returns existing reference material; does NOT generate code.",inputSchema:{id:zod.z.string().min(1).max(128).describe("Rule id (a kebab-case slug \u2014 e.g. 'flat-schema-missing-facts-wrapper'). Call list_review_rules first to discover valid ids.")}},async({id:t})=>{let r=knowledge.getAntiPatternById(t);if(!r)return {isError:true,content:[{type:"text",text:`Rule not found: '${t}'. Call list_review_rules to see available ids.`}]};let n=[`# ${r.title}`,`**id:** ${r.id}`,`**severity:** ${r.severity}`,`**category:** ${r.category}`];return r.explanation&&n.push("",r.explanation),r.badExample&&n.push("","## Wrong","```typescript",r.badExample,"```"),r.goodExample&&n.push("","## Correct","```typescript",r.goodExample,"```"),{content:[{type:"text",text:`<directive-data>
|
|
24
|
+
${n.join(`
|
|
25
25
|
`)}
|
|
26
26
|
</directive-data>`}]}}),e.registerTool("list_migration_sources",{title:"List supported migration source libraries",description:"Enumerate the source libraries get_migration_pattern accepts: redux, zustand, xstate, mobx, jotai, recoil. Call this before get_migration_pattern so the source list comes from the server (no hallucination risk). Returns existing reference material; does NOT generate code.",inputSchema:{}},async()=>({content:[{type:"text",text:`${knowledge.MIGRATION_SOURCES.length} sources:
|
|
27
27
|
${knowledge.MIGRATION_SOURCES.join(`
|
|
28
28
|
`)}`}]})),e.registerTool("get_migration_pattern",{title:"Get migration pattern from a state-management library",description:"Fetch the concept-mapping table + step list + before/after exemplars for migrating from a popular state-management library to Directive. Use this when a user asks 'how do I migrate from Redux / Zustand / XState / MobX / Jotai / Recoil'. Returns existing reference material; does NOT generate code.",inputSchema:{source:zod.z.enum(knowledge.MIGRATION_SOURCES).describe("Source library. Discover valid values via list_migration_sources.")}},async({source:t})=>{let r=knowledge.getMigrationPattern(t);return r?{content:[{type:"text",text:`<directive-data>
|
|
29
|
-
${[`# Migrating from ${r.name} to Directive`,"","## Concept map","","| From | To | Note |","|---|---|---|",...r.conceptMap.map(
|
|
29
|
+
${[`# Migrating from ${r.name} to Directive`,"","## Concept map","","| From | To | Note |","|---|---|---|",...r.conceptMap.map(i=>`| ${i.from} | ${i.to} | ${i.note} |`),"","## Steps",...r.steps.map((i,d)=>`${d+1}. ${i}`),"","## Before","```typescript",r.before,"```","","## After","```typescript",r.after,"```"].join(`
|
|
30
30
|
`)}
|
|
31
|
-
</directive-data>`}]}:{isError:true,content:[{type:"text",text:`Migration pattern not found: '${t}'. Call list_migration_sources to see valid values.`}]}}),e.registerTool("review_source",{title:"Review Directive code with ts-morph rules",description:"Run the @directive-run/lint rule registry against a TypeScript source string. Returns structured findings (line, column, severity, message, fixable) for every match. Use this when the user asks 'review this Directive code' or 'lint this'. Source is parsed in a worker thread with a 5-second budget and 200 KB cap.",inputSchema:{source:zod.z.string().min(1).max(2e5).describe("TypeScript source to review. Max 200,000 bytes; longer inputs are rejected pre-parse."),fileName:zod.z.string().regex(/^[\w./-]{1,128}$/).optional().describe("Optional file name shown in findings. Must match /^[\\w./-]{1,128}$/."),ruleFilter:zod.z.array(zod.z.string().max(64)).max(32).optional().describe("Optional whitelist of rule ids to run. Discover valid ids via list_review_rules.")}},async({source:t,fileName:r,ruleFilter:
|
|
32
|
-
${JSON.stringify(n,null,2)}
|
|
33
|
-
</directive-data>`}]}}catch(n){return {isError:true,content:[{type:"text",text:`review_source failed \u2014 ${n instanceof l?`${n.code}: ${n.message}`:n.message}`}]}}}),e.registerTool("fix_code",{title:"Apply a mechanical fix for a Directive review finding",description:"Given a source string and a Finding returned by review_source, run the rule's mechanical fix and return { ok, diff, fixedSource, explanation } \u2014 or { ok: false, reason } when the rule has no fix. Useful for closing the loop: review_source \u2192 user picks \u2192 fix_code. The fixed source is NOT written to disk \u2014 the caller decides.",inputSchema:{source:zod.z.string().min(1).max(2e5).describe("The same source you passed to review_source."),finding:zod.z.object({ruleId:zod.z.string().min(1).max(64),severity:zod.z.enum(["error","warning","info"]),line:zod.z.number().int().nonnegative(),column:zod.z.number().int().nonnegative(),message:zod.z.string(),findingId:zod.z.string(),suggestion:zod.z.string().optional()}).describe("The Finding returned by review_source. Pass the WHOLE object \u2014 the worker uses ruleId + line + column to locate the AST node.")}},async({source:t,finding:r})=>{try{let i=await P({source:t,finding:r});return {content:[{type:"text",text:`<directive-data>
|
|
31
|
+
</directive-data>`}]}:{isError:true,content:[{type:"text",text:`Migration pattern not found: '${t}'. Call list_migration_sources to see valid values.`}]}}),e.registerTool("review_source",{title:"Review Directive code with ts-morph rules",description:"Run the @directive-run/lint rule registry against a TypeScript source string. Returns structured findings (line, column, severity, message, fixable) for every match. Use this when the user asks 'review this Directive code' or 'lint this'. Source is parsed in a worker thread with a 5-second budget and 200 KB cap.",inputSchema:{source:zod.z.string().min(1).max(2e5).describe("TypeScript source to review. Max 200,000 bytes; longer inputs are rejected pre-parse."),fileName:zod.z.string().regex(/^[\w./-]{1,128}$/).optional().describe("Optional file name shown in findings. Must match /^[\\w./-]{1,128}$/."),ruleFilter:zod.z.array(zod.z.string().max(64)).max(32).optional().describe("Optional whitelist of rule ids to run. Discover valid ids via list_review_rules.")}},async({source:t,fileName:r,ruleFilter:n})=>{try{let i=await J({source:t,fileName:r,ruleFilter:n});return {content:[{type:"text",text:`<directive-data>
|
|
34
32
|
${JSON.stringify(i,null,2)}
|
|
35
|
-
</directive-data>`}]}}catch(i){return {isError:true,content:[{type:"text",text:`
|
|
33
|
+
</directive-data>`}]}}catch(i){return {isError:true,content:[{type:"text",text:`review_source failed \u2014 ${i instanceof S?`${i.code}: ${i.message}`:i.message}`}]}}}),e.registerTool("fix_code",{title:"Apply a mechanical fix for a Directive review finding",description:"Given a source string and a Finding returned by review_source, run the rule's mechanical fix and return { ok, diff, fixedSource, explanation } \u2014 or { ok: false, reason } when the rule has no fix. Useful for closing the loop: review_source \u2192 user picks \u2192 fix_code. The fixed source is NOT written to disk \u2014 the caller decides.",inputSchema:{source:zod.z.string().min(1).max(2e5).describe("The same source you passed to review_source."),finding:zod.z.object({ruleId:zod.z.string().min(1).max(64),severity:zod.z.enum(["error","warning","info"]),line:zod.z.number().int().nonnegative(),column:zod.z.number().int().nonnegative(),message:zod.z.string(),findingId:zod.z.string(),suggestion:zod.z.string().optional()}).describe("The Finding returned by review_source. Pass the WHOLE object \u2014 the worker uses ruleId + line + column to locate the AST node.")}},async({source:t,finding:r})=>{try{let n=await Z({source:t,finding:r});return {content:[{type:"text",text:`<directive-data>
|
|
34
|
+
${JSON.stringify(n,null,2)}
|
|
35
|
+
</directive-data>`}]}}catch(n){return {isError:true,content:[{type:"text",text:`fix_code failed \u2014 ${n instanceof S?`${n.code}: ${n.message}`:n.message}`}]}}}),e.registerTool("list_skills",{title:"List Directive Claude Code skills",description:"List every skill bundled in @directive-run/claude-plugin. Each skill is a gerund-named bundle of one SKILL.md plus supporting knowledge files. Pass a returned name to get_skill.",inputSchema:{}},async()=>{let t=claudePlugin.getAllSkills(),r=Array.from(t.keys()).sort();return {content:[{type:"text",text:`${r.length} skills:
|
|
36
36
|
${r.join(`
|
|
37
|
-
`)}`}]}}),e.registerTool("get_skill",{title:"Get a Directive Claude Code skill",description:"Fetch one skill bundle: the SKILL.md manifest plus every supporting knowledge file concatenated into a single document. Use list_skills to discover names.",inputSchema:{name:zod.z.string().min(1).describe("The skill name (e.g. 'building-ai-orchestrators', 'writing-directive-constraints').")}},async({name:t})=>{let r=claudePlugin.getSkill(t);if(!r)return {isError:true,content:[{type:"text",text:`Skill not found: '${t}'. Call list_skills to see available names.`}]};let
|
|
37
|
+
`)}`}]}}),e.registerTool("get_skill",{title:"Get a Directive Claude Code skill",description:"Fetch one skill bundle: the SKILL.md manifest plus every supporting knowledge file concatenated into a single document. Use list_skills to discover names.",inputSchema:{name:zod.z.string().min(1).describe("The skill name (e.g. 'building-ai-orchestrators', 'writing-directive-constraints').")}},async({name:t})=>{let r=claudePlugin.getSkill(t);if(!r)return {isError:true,content:[{type:"text",text:`Skill not found: '${t}'. Call list_skills to see available names.`}]};let n=[`# Skill: ${r.name}
|
|
38
38
|
|
|
39
|
-
${r.manifest}`];for(let[
|
|
39
|
+
${r.manifest}`];for(let[i,d]of r.files)n.push(`---
|
|
40
40
|
|
|
41
|
-
## ${
|
|
41
|
+
## ${i}.md
|
|
42
42
|
|
|
43
|
-
${
|
|
43
|
+
${d}`);return {content:[{type:"text",text:n.join(`
|
|
44
44
|
|
|
45
|
-
`)}]}}),e
|
|
46
|
-
|
|
45
|
+
`)}]}}),e.registerTool("playground_link",{title:"Build a shareable playground link for a Directive snippet",description:"Turn a TypeScript snippet (from generate_module, get_example, fix_code, or anywhere) into a directive.run/playground URL. The page decompresses the source, renders it with syntax highlighting, and offers a one-click 'Open in StackBlitz' button that boots a real running Directive project with the snippet as src/main.ts. Hand this URL to the user when you want to say 'try it now'. Source is encoded in the URL hash (not query) so it never hits server logs.",inputSchema:{source:zod.z.string().min(1).max(D).describe(`The TypeScript source to embed. Max ${D} bytes \u2014 anything larger should be opened in a real sandbox directly.`),title:zod.z.string().min(1).max(120).optional().describe("Optional short label shown as the editor tab title on the playground page. Defaults to 'Untitled snippet'.")}},async({source:t,title:r})=>{try{let n=re({source:t,title:r}),i={url:n.url,sizeBytes:n.sizeBytes,urlBytes:n.urlBytes,title:n.title??null};return {content:[{type:"text",text:`<directive-data>
|
|
46
|
+
${JSON.stringify(i,null,2)}
|
|
47
|
+
</directive-data>`}]}}catch(n){return {isError:true,content:[{type:"text",text:`playground_link failed \u2014 ${n instanceof R?`${n.code}: ${n.message}`:n.message}`}]}}}),e}var ue="/messages",pe="/sse",it="/healthz",ot=1e6,st=64,at=300*1e3,ct=3e4,lt=new Set(["127.0.0.1","localhost","::1","0:0:0:0:0:0:0:1"]),F=class extends Error{};function dt(e){return lt.has(e.toLowerCase())}function ut(e){let t=e.port??3e3,r=e.host??"127.0.0.1",n=e.logger??console,i=e.token??process.env.DIRECTIVE_MCP_TOKEN??void 0;if(!dt(r)&&!i)throw new F("Public hosts require a token. Pass --token <value> or set DIRECTIVE_MCP_TOKEN, or bind to 127.0.0.1 for local dev.");return {port:t,host:r,logger:n,token:i,allowOrigins:e.allowOrigins??[],bodyLimitBytes:e.bodyLimitBytes??ot,maxSessions:e.maxSessions??st,idleTimeoutMs:e.idleTimeoutMs??at}}function ge(e,t){if(!t)return true;let r=e.headers.authorization;return typeof r!="string"?false:/^Bearer\s+(.+)$/i.exec(r)?.[1]?.trim()===t}function me(e,t){if(t.length===0)return true;let r=e.headers.origin;return typeof r!="string"?false:t.includes(r)}function T(e,t,r,n={}){e.writeHead(t,{"Content-Type":"text/plain",...n}),e.end(r);}function V(e,t){de({transport:"sse",authEnabled:t,sessionCount:e.size});}var j=0;async function pt(e,t,r,n){if(!ge(e,n.token)){T(t,401,"unauthorized");return}if(!me(e,n.allowOrigins)){T(t,403,"origin not allowed");return}if(r.size+j>=n.maxSessions){T(t,429,"session cap reached",{"Retry-After":"60"});return}j+=1;let i=false;try{let d=new sse_js.SSEServerTransport(ue,t),o=B();r.set(d.sessionId,{transport:d,lastActivity:Date.now()}),i=!0,V(r,!!n.token);let s=()=>{r.delete(d.sessionId),V(r,!!n.token);};t.on("close",s),d.onclose=s,await o.connect(d),n.logger.log(`[directive-mcp] sse session opened: ${d.sessionId}`);}finally{j-=1;}}async function gt(e,t,r,n,i){if(!ge(e,i.token)){T(t,401,"unauthorized");return}if(!me(e,i.allowOrigins)){T(t,403,"origin not allowed");return}let d=Number(e.headers["content-length"]??"0");if(Number.isFinite(d)&&d>i.bodyLimitBytes){T(t,413,`body exceeds ${i.bodyLimitBytes} bytes`);return}let o=r.searchParams.get("sessionId");if(!o){T(t,400,"missing sessionId query parameter");return}let s=n.get(o);if(!s){T(t,404,`unknown session: ${o}`);return}s.lastActivity=Date.now();let u=0,l=false;e.on("data",p=>{u+=Buffer.byteLength(p),u>i.bodyLimitBytes&&!l&&(l=true,T(t,413,`body exceeds ${i.bodyLimitBytes} bytes`),e.destroy());}),!l&&await s.transport.handlePostMessage(e,t);}async function mt(e,t,r,n){let i=new URL(e.url??"/",`http://${e.headers.host??n.host}`);if(e.method==="GET"&&i.pathname===it){t.writeHead(200,{"Content-Type":"text/plain"}),t.end("ok");return}if(e.method==="GET"&&i.pathname===pe){await pt(e,t,r,n);return}if(e.method==="POST"&&i.pathname===ue){await gt(e,t,i,r,n);return}T(t,404,"not found");}function ft(e,t){return setInterval(()=>{let r=Date.now();for(let[n,i]of e)r-i.lastActivity>t.idleTimeoutMs&&(e.delete(n),i.transport.close().catch(()=>{}),V(e,!!t.token),t.logger.log(`[directive-mcp] pruned idle session: ${n}`));},ct).unref()}async function vt(e={}){let t=ut(e),r=new Map,n=http.createServer(async(d,o)=>{try{await mt(d,o,r,t);}catch(s){t.logger.error("[directive-mcp] request error:",s),o.headersSent||o.writeHead(500,{"Content-Type":"text/plain"}),o.end("internal server error");}}),i=ft(r,t);return n.on("close",()=>{clearInterval(i);}),await new Promise(d=>{n.listen(t.port,t.host,()=>{t.logger.log(`[directive-mcp] sse server listening at http://${t.host}:${t.port}${pe}${t.token?" (auth: bearer-token)":" (auth: none, loopback only)"}`),d();});}),n}
|
|
48
|
+
exports.createDirectiveServer=B;exports.startSseServer=vt;//# sourceMappingURL=index.cjs.map
|
|
47
49
|
//# sourceMappingURL=index.cjs.map
|