@vibgrate/haile 2026.902.2 → 2026.903.2

package/README.md

@@ -24,7 +24,7 @@ import { createHaileProvider } from "@vibgrate/haile";
 const kernel = createHaileProvider();
 // null when dist/engine/haile.wasm is missing — never a dummy provider.
 kernel?.version();
-// "haile-fast/0.1.1" (or the version string the wasm exports)
+// "haile-fast/0.3.0" (or the version string the wasm exports)
 kernel?.classify({
   name: "CreateUser",
   path: "src/controllers/UsersController.cs",

package/dist/index.d.ts

@@ -5,10 +5,34 @@ interface HaileClassifyInput {
     path: string;
     symbolKind?: string;
     fileKind?: string;
+    /** Callee names; qualified (`ProductRepository.save`) when the graph knows them. */
     calls?: readonly string[];
+    /** Parameter types (a thin host may append the return type last). */
     types?: readonly string[];
     idents?: readonly string[];
     profile?: HaileProfile;
+    /** `Class.method` — the enclosing class names the role and the domain noun. */
+    qualifiedName?: string;
+    /** Leading doc-comment / docstring summary, as extracted by vg. */
+    doc?: string;
+    /** Raw signature incl. decorators / annotations / attributes. */
+    signature?: string;
+    /** Parameter names, in order. */
+    params?: readonly string[];
+    /** Return type as written. */
+    returnType?: string;
+    /** File paths of resolved callees (layer cues for the caller's purposes). */
+    calleePaths?: readonly string[];
+    /** Module specifiers imported by the callable's file. */
+    imports?: readonly string[];
+    /** Catalog AST role for the file, if the host has one. */
+    astRole?: string;
+    /**
+     * What the body executes (vg-graph `node.effects`): bounded counts such as
+     * `sqlWrite`, `http`, `respond`, `render`, `calls`, `branches`, plus
+     * `apis`. The kernel scores purposes from these ahead of names.
+     */
+    effects?: Readonly<Record<string, number | readonly string[]>>;
 }
 interface HaileClassification {
     primary: string;
@@ -41,7 +65,7 @@ interface HaileProvider {
 declare const HAILE_MAGIC = "vg.haile.v1";
 declare const HAILE_TAXONOMY = "haile.taxonomy.v1";
 declare const HAILE_IR = "haile.ir.v1";
-declare const HAILE_ENGINE_VERSION = "haile-fast/0.1.1";
+declare const HAILE_ENGINE_VERSION = "haile-fast/0.3.0";
 declare const DEFAULT_PROFILE: HaileProfile;
 declare const DEFAULT_SYMBOL_CAP = 8000;
 
@@ -77,6 +101,10 @@ interface GraphNodeLike {
     file: string;
     lang?: string;
     signature?: string;
+    /** Short leading doc-comment / docstring summary (vg-graph ≥ 1.1). */
+    doc?: string;
+    /** Body effect profile (vg-graph ≥ 1.1, additive). */
+    effects?: Record<string, number | string[]>;
 }
 interface GraphEdgeLike {
     kind: string;
@@ -99,6 +127,14 @@ interface HaileCallable {
     return_type?: string;
     file_layer?: string;
     ast_role?: string;
+    /** Leading doc summary, capped. */
+    doc?: string;
+    /** Distinct file paths of resolved callees, in edge order. */
+    callee_paths: string[];
+    /** Module specifiers the callable's file imports, in edge order. */
+    imports: string[];
+    /** Body effect profile, passed through untouched. */
+    effects?: Record<string, number | string[]>;
 }
 declare function isCallableKind(kind: string): boolean;
 declare function symbolKindOf(kind: string): string;

package/dist/index.js

@@ -1,10 +1,10 @@
-import{pathToFileURL as j}from"node:url";import*as u from"node:fs";import*as g from"node:path";var b="vg.haile.v1",_="haile.taxonomy.v1",h="haile.ir.v1",v="haile-fast/0.1.1",w="balanced",H=8e3,k=new Set(["function","method","route","test","component","job"]);function C(n){return k.has(n)}function P(n){switch(n){case"method":return"method";case"route":return"route";case"test":return"test";case"job":return"job";case"component":return"handler";default:return"function"}}function N(n){let r=n.indexOf("("),s=n.lastIndexOf(")");if(r<0||s<=r)return[];let i=n.slice(r+1,s).trim();return!i||i==="void"?[]:i.split(",").map(a=>a.trim()).filter(Boolean).slice(0,16).map(a=>{let e=a.replace(/\b(const|mut|ref|public|private|protected|readonly|final)\b/g,"").trim();if(e.includes(":")){let[l,c]=e.split(":").map(d=>d.trim());return{name:l||"arg",type_name:c||void 0}}let t=e.split(/\s+/);return t.length>=2?{name:t[t.length-1],type_name:t[0]}:{name:e}})}function R(n){let r=n.lastIndexOf("->");if(r>=0)return n.slice(r+2).replace(/[{;].*$/,"").trim()||void 0;let s=n.lastIndexOf(":"),i=n.lastIndexOf(")");if(s>i&&i>=0)return n.slice(s+1).replace(/[{;=>].*$/,"").trim()||void 0}function T(n,r,s){let i=[],a=new Set;for(let e of r){if(e.src!==n||e.kind!=="call"&&e.kind!=="references")continue;let t=s.get(e.dst);if(!(!t||a.has(t))&&(a.add(t),i.push(t),i.length>=24))break}return i}function x(n){let r=n.nodes??[],s=n.edges??[],i=new Map;for(let e of r)i.set(e.id,e.name);let a=[];for(let e of r){if(!C(e.kind))continue;let t=e.signature??"";a.push({node_id:e.id,file_path:e.file,name:e.name,qualified_name:e.qualifiedName||e.name,symbol_kind:P(e.kind),language:e.lang??"",signature:t,calls:T(e.id,s,i),parameters:N(t),return_type:R(t)})}return a.sort((e,t)=>e.node_id<t.node_id?-1:e.node_id>t.node_id?1:0),a}import*as m from"node:fs";import{fileURLToPath as F}from"node:url";var f;function G(){return[new URL("./engine/haile.wasm",import.meta.url),new URL("../engine/haile.wasm",import.meta.url),new URL("../crate/target/wasm32-unknown-unknown/release/vibgrate_haile_kernel.wasm",import.meta.url)].map(n=>F(n))}function A(){if(f!==void 0)return f;f=null;try{let n=G().find(t=>m.existsSync(t));if(!n)return f;let r=new WebAssembly.Module(m.readFileSync(n)),i=new WebAssembly.Instance(r,{}).exports;if(typeof i.vg_alloc!="function"||typeof i.vg_free!="function"||typeof i.vg_version!="function"||typeof i.vg_classify!="function"||!i.memory)return f;let a=t=>{let l=new TextEncoder().encode(t),c=i.vg_alloc(l.length);return new Uint8Array(i.memory.buffer,c,l.length).set(l),{ptr:c,len:l.length}},e=t=>{if(!t)return"";let l=new DataView(i.memory.buffer,t,4).getUint32(0,!0),c=new TextDecoder().decode(new Uint8Array(i.memory.buffer,t+4,l));return i.vg_free(t,4+l),c};return f={version:()=>{try{return e(i.vg_version())||"haile-fast/0.1.1"}catch{return"haile-fast/0.1.1"}},classifyJson:t=>{let l=JSON.stringify({name:t.name??"",path:t.path??"",symbolKind:t.symbolKind??"function",fileKind:t.fileKind??"source",calls:t.calls??[],types:t.types??[],idents:t.idents??[],profile:t.profile??"balanced"}),{ptr:c,len:d}=a(l);try{return e(i.vg_classify(c,d))}finally{i.vg_free(c,d)}}},f}catch{return f=null,f}}function M(){f=void 0}function S(n){return Array.isArray(n)?n.filter(r=>typeof r=="string"):[]}function U(n){if(!n)return null;try{let r=JSON.parse(n);if(!r||typeof r!="object")return null;let s=r.role&&typeof r.role=="object"?r.role:r,i=typeof s.primary=="string"?s.primary:"";if(!i)return null;let a=r.intent&&typeof r.intent=="object"?r.intent:{};return{primary:i,confidence:typeof s.confidence=="number"?s.confidence:0,band:typeof s.band=="string"?s.band:"abstain",alternatives:Array.isArray(s.alternatives)?s.alternatives.filter(e=>typeof e?.role=="string").map(e=>({role:e.role,confidence:typeof e.confidence=="number"?e.confidence:0})):[],purposes:Array.isArray(r.purposes)?r.purposes.filter(e=>typeof e?.purpose=="string").map(e=>({purpose:e.purpose,confidence:typeof e.confidence=="number"?e.confidence:0})):[],intent:{text:typeof a.text=="string"?a.text:"",verbs:S(a.verbs),objects:S(a.objects)},evidence:Array.isArray(r.evidence)?r.evidence.filter(e=>typeof e?.kind=="string"&&typeof e?.signal=="string").map(e=>({kind:e.kind,signal:e.signal,weight:typeof e.weight=="number"?e.weight:0})):[]}}catch{return null}}function I(n){let r=n===void 0?A():n;return r?{version:()=>r.version(),classify:s=>{try{return U(r.classifyJson(s))}catch{return null}}}:null}var D=new Set(["strict","balanced","exploratory"]);function O(n,r){let s=n.indexOf(r);if(!(s<0||s+1>=n.length))return n[s+1]}function W(){return new Promise((n,r)=>{let s=[];process.stdin.on("data",i=>s.push(Buffer.from(i))),process.stdin.on("end",()=>n(Buffer.concat(s).toString("utf8"))),process.stdin.on("error",r)})}async function L(n=process.argv.slice(2),r={}){if(n[0]!=="sidecar")return process.stderr.write(`usage: node index.js sidecar --stdin --out <file> --profile <strict|balanced|exploratory>
+import{pathToFileURL as X}from"node:url";import*as y from"node:fs";import*as b from"node:path";var v="vg.haile.v1",w="haile.taxonomy.v1",H="haile.ir.v1",g="haile-fast/0.3.0",x="balanced",A=8e3,k=new Set(["function","method","route","test","component","job"]);var R=240,K=400,T=16,G=32,W=new Set(["public","private","protected","internal","static","async","override","virtual","abstract","final","def","fn","function","func","sub","pub","export","const","let","var","new","sealed","extern","unsafe","readonly","partial","default","synchronized","native","inline","constexpr","friend","explicit","operator","suspend","open","lateinit","get","set"]);function N(n){return k.has(n)}function C(n){switch(n){case"method":return"method";case"route":return"route";case"test":return"test";case"job":return"job";case"component":return"handler";default:return"function"}}function M(n,t=""){let i=t?n.indexOf(`${t}(`):-1;if(i<0&&(n.startsWith("@")||n.startsWith("[")))return[];let s=i>=0?i+t.length:n.indexOf("("),f=n.lastIndexOf(")");if(s<0||f<=s)return[];let r=n.slice(s+1,f).trim();return!r||r==="void"?[]:r.split(",").map(e=>e.trim()).filter(Boolean).slice(0,16).map(e=>{let o=e.replace(/\b(const|mut|ref|public|private|protected|readonly|final)\b/g,"").trim();if(o.includes(":")){let[a,d]=o.split(":").map(p=>p.trim());return{name:a||"arg",type_name:d||void 0}}let c=o.split(/\s+/);return c.length>=2?{name:c[c.length-1],type_name:c[0]}:{name:o}})}function U(n,t){let i=n.lastIndexOf("->");if(i>=0)return n.slice(i+2).replace(/[{;].*$/,"").trim()||void 0;let s=n.lastIndexOf(":"),f=n.lastIndexOf(")");if(s>f&&f>=0)return n.slice(s+1).replace(/[{;].*$/,"").replace(/\s*=>.*$/,"").trim()||void 0;let r=t?n.indexOf(`${t}(`):-1;if(r>0){let e=n.slice(0,r).trim(),o=0,c=0;for(let d=e.length-1;d>=0;d--){let p=e[d];if(p===">"||p==="]"||p===")")o++;else if(p==="<"||p==="["||p==="(")o--;else if(/\s/.test(p)&&o===0){c=d+1;break}}let a=e.slice(c).trim();if(a&&!a.startsWith("@")&&!a.startsWith("[")&&!W.has(a)&&a!=="void"&&!a.endsWith(")")&&!a.endsWith("]"))return a}}function q(n,t,i,s){let f=[],r=[],e=new Set,o=new Set;for(let c of t){if(c.src!==n||c.kind!=="call"&&c.kind!=="references")continue;let a=i.get(c.dst);if(!a)continue;let d=a.qualifiedName||a.name;if(!(!d||e.has(d))&&(e.add(d),f.push(d),a.file&&a.file!==s&&!o.has(a.file)&&r.length<T&&(o.add(a.file),r.push(a.file)),f.length>=24))break}return{calls:f,calleePaths:r}}function D(n,t,i){let s=new Map;for(let r of n)(r.kind==="file"||r.kind==="module")&&s.set(r.id,r.file);let f=new Map;for(let r of t){if(r.kind!=="import")continue;let e=s.get(r.src);if(!e)continue;let o=i.get(r.dst),c=o?.qualifiedName||o?.name;if(!c)continue;let a=f.get(e);a||(a=[],f.set(e,a)),a.length<G&&!a.includes(c)&&a.push(c)}return f}function I(n){let t=n.nodes??[],i=n.edges??[],s=new Map;for(let e of t)s.set(e.id,e);let f=D(t,i,s),r=[];for(let e of t){if(!N(e.kind))continue;let o=(e.signature??"").slice(0,K),{calls:c,calleePaths:a}=q(e.id,i,s,e.file),d=typeof e.doc=="string"?e.doc.trim().slice(0,R):"";r.push({node_id:e.id,file_path:e.file,name:e.name,qualified_name:e.qualifiedName||e.name,symbol_kind:C(e.kind),language:e.lang??"",signature:o,calls:c,parameters:M(o,e.name),return_type:U(o,e.name),...d?{doc:d}:{},callee_paths:a,imports:f.get(e.file)??[],...e.effects&&typeof e.effects=="object"?{effects:e.effects}:{}})}return r.sort((e,o)=>e.node_id<o.node_id?-1:e.node_id>o.node_id?1:0),r}import*as _ from"node:fs";import{fileURLToPath as F}from"node:url";var u;function j(){return[new URL("./engine/haile.wasm",import.meta.url),new URL("../engine/haile.wasm",import.meta.url),new URL("../crate/target/wasm32-unknown-unknown/release/vibgrate_haile_kernel.wasm",import.meta.url)].map(n=>F(n))}function B(n){try{let t=new WebAssembly.Module(n),s=new WebAssembly.Instance(t,{}).exports;if(typeof s.vg_alloc!="function"||typeof s.vg_free!="function"||typeof s.vg_version!="function"||typeof s.vg_classify!="function"||!s.memory)return null;let f=e=>{let o=new TextEncoder().encode(e),c=s.vg_alloc(o.length);return new Uint8Array(s.memory.buffer,c,o.length).set(o),{ptr:c,len:o.length}},r=e=>{if(!e)return"";let o=new DataView(s.memory.buffer,e,4).getUint32(0,!0),c=new TextDecoder().decode(new Uint8Array(s.memory.buffer,e+4,o));return s.vg_free(e,4+o),c};return{version:()=>{try{return r(s.vg_version())||g}catch{return g}},classifyJson:e=>{let o=JSON.stringify({name:e.name??"",path:e.path??"",symbolKind:e.symbolKind??"function",fileKind:e.fileKind??"source",calls:e.calls??[],types:e.types??[],idents:e.idents??[],profile:e.profile??"balanced",qualifiedName:e.qualifiedName??"",doc:e.doc??"",signature:e.signature??"",params:e.params??[],returnType:e.returnType??"",calleePaths:e.calleePaths??[],imports:e.imports??[],astRole:e.astRole??"",effects:e.effects??{}}),{ptr:c,len:a}=f(o);try{return r(s.vg_classify(c,a))}finally{s.vg_free(c,a)}}}}catch{return null}}function E(){if(u!==void 0)return u;u=null;try{let n=j().find(t=>_.existsSync(t));return n&&(u=B(_.readFileSync(n))),u}catch{return u=null,u}}function $(){u=void 0}function S(n){return Array.isArray(n)?n.filter(t=>typeof t=="string"):[]}function J(n){if(!n)return null;try{let t=JSON.parse(n);if(!t||typeof t!="object")return null;let i=t.role&&typeof t.role=="object"?t.role:t,s=typeof i.primary=="string"?i.primary:"";if(!s)return null;let f=t.intent&&typeof t.intent=="object"?t.intent:{};return{primary:s,confidence:typeof i.confidence=="number"?i.confidence:0,band:typeof i.band=="string"?i.band:"abstain",alternatives:Array.isArray(i.alternatives)?i.alternatives.filter(r=>typeof r?.role=="string").map(r=>({role:r.role,confidence:typeof r.confidence=="number"?r.confidence:0})):[],purposes:Array.isArray(t.purposes)?t.purposes.filter(r=>typeof r?.purpose=="string").map(r=>({purpose:r.purpose,confidence:typeof r.confidence=="number"?r.confidence:0})):[],intent:{text:typeof f.text=="string"?f.text:"",verbs:S(f.verbs),objects:S(f.objects)},evidence:Array.isArray(t.evidence)?t.evidence.filter(r=>typeof r?.kind=="string"&&typeof r?.signal=="string").map(r=>({kind:r.kind,signal:r.signal,weight:typeof r.weight=="number"?r.weight:0})):[]}}catch{return null}}function L(n){let t=n===void 0?E():n;return t?{version:()=>t.version(),classify:i=>{try{return J(t.classifyJson(i))}catch{return null}}}:null}var V=new Set(["strict","balanced","exploratory"]);function O(n,t){let i=n.indexOf(t);if(!(i<0||i+1>=n.length))return n[i+1]}function Y(){return new Promise((n,t)=>{let i=[];process.stdin.on("data",s=>i.push(Buffer.from(s))),process.stdin.on("end",()=>n(Buffer.concat(i).toString("utf8"))),process.stdin.on("error",t)})}async function P(n=process.argv.slice(2),t={}){if(n[0]!=="sidecar")return process.stderr.write(`usage: node index.js sidecar --stdin --out <file> --profile <strict|balanced|exploratory>
 `),1;if(!n.includes("--stdin"))return process.stderr.write(`sidecar requires --stdin
-`),1;let s=O(n,"--out");if(!s)return process.stderr.write(`sidecar requires --out <file>
-`),1;let i=O(n,"--profile")??w;if(!D.has(i))return process.stderr.write(`invalid --profile ${i}
-`),1;let a=i,e=r.provider===void 0?I():r.provider;if(!e)return process.stderr.write(`architecture kernel wasm missing \u2014 refusing to classify
-`),1;let t;try{let o=(await(r.readInput??W)()).trim();if(!o)return process.stderr.write(`sidecar stdin was empty
-`),1;t=JSON.parse(o)}catch{return process.stderr.write(`sidecar stdin was not valid JSON
-`),1}let l=x({nodes:Array.isArray(t.nodes)?t.nodes:[],edges:Array.isArray(t.edges)?t.edges:[]}),c=e.version()||v,d=[],E=!1;for(let o of l){if(d.length>=8e3){E=!0;break}let p=e.classify({name:o.name,path:o.file_path,symbolKind:o.symbol_kind,fileKind:"source",calls:o.calls,types:[...o.parameters.map(y=>y.type_name).filter(y=>!!y),...o.return_type?[o.return_type]:[]],idents:[o.name,...o.calls].slice(0,24),profile:a});p&&d.push({node_id:o.node_id,file_path:o.file_path,name:o.name,qualified_name:o.qualified_name,symbol_kind:o.symbol_kind,role:{primary:p.primary,alternatives:p.alternatives,confidence:p.confidence,band:p.band},purposes:p.purposes,intent:p.intent,evidence:p.evidence})}let K={magic:b,taxonomy:_,ir:h,corpus_hash:t.provenance?.corpusHash??"",engine_version:c,profile:a,symbols:d,...E?{symbols_capped:!0}:{}};try{u.mkdirSync(g.dirname(g.resolve(s)),{recursive:!0});let o=`${s}.${process.pid}.tmp`;u.writeFileSync(o,`${JSON.stringify(K)}
-`),u.renameSync(o,s)}catch{return process.stderr.write(`sidecar failed to write ${s}
-`),1}return 0}function B(){let n=process.argv[1];if(!n)return!1;try{return import.meta.url===j(n).href}catch{return!1}}B()&&L().then(n=>{process.exit(n)});export{w as DEFAULT_PROFILE,H as DEFAULT_SYMBOL_CAP,v as HAILE_ENGINE_VERSION,h as HAILE_IR,b as HAILE_MAGIC,_ as HAILE_TAXONOMY,x as adaptGraph,I as createHaileProvider,C as isCallableKind,A as loadWasmHaileKernel,M as resetWasmHaileKernelCache,L as runSidecarCli,P as symbolKindOf};
+`),1;let i=O(n,"--out");if(!i)return process.stderr.write(`sidecar requires --out <file>
+`),1;let s=O(n,"--profile")??x;if(!V.has(s))return process.stderr.write(`invalid --profile ${s}
+`),1;let f=s,r=t.provider===void 0?L():t.provider;if(!r)return process.stderr.write(`architecture kernel wasm missing \u2014 refusing to classify
+`),1;let e;try{let l=(await(t.readInput??Y)()).trim();if(!l)return process.stderr.write(`sidecar stdin was empty
+`),1;e=JSON.parse(l)}catch{return process.stderr.write(`sidecar stdin was not valid JSON
+`),1}let o=I({nodes:Array.isArray(e.nodes)?e.nodes:[],edges:Array.isArray(e.edges)?e.edges:[]}),c=r.version()||g,a=[],d=!1;for(let l of o){if(a.length>=8e3){d=!0;break}let m=r.classify({name:l.name,path:l.file_path,symbolKind:l.symbol_kind,fileKind:"source",calls:l.calls,types:[...l.parameters.map(h=>h.type_name).filter(h=>!!h),...l.return_type?[l.return_type]:[]],idents:[l.name,...l.calls].slice(0,24),profile:f,qualifiedName:l.qualified_name,doc:l.doc??"",signature:l.signature,params:l.parameters.map(h=>h.name),returnType:l.return_type??"",calleePaths:l.callee_paths,imports:l.imports,...l.ast_role?{astRole:l.ast_role}:{},...l.effects?{effects:l.effects}:{}});m&&a.push({node_id:l.node_id,file_path:l.file_path,name:l.name,qualified_name:l.qualified_name,symbol_kind:l.symbol_kind,role:{primary:m.primary,alternatives:m.alternatives,confidence:m.confidence,band:m.band},purposes:m.purposes,intent:m.intent,evidence:m.evidence})}let p={magic:v,taxonomy:w,ir:H,corpus_hash:e.provenance?.corpusHash??"",engine_version:c,profile:f,symbols:a,...d?{symbols_capped:!0}:{}};try{y.mkdirSync(b.dirname(b.resolve(i)),{recursive:!0});let l=`${i}.${process.pid}.tmp`;y.writeFileSync(l,`${JSON.stringify(p)}
+`),y.renameSync(l,i)}catch{return process.stderr.write(`sidecar failed to write ${i}
+`),1}return 0}function z(){let n=process.argv[1];if(!n)return!1;try{return import.meta.url===X(n).href}catch{return!1}}z()&&P().then(n=>{process.exit(n)});export{x as DEFAULT_PROFILE,A as DEFAULT_SYMBOL_CAP,g as HAILE_ENGINE_VERSION,H as HAILE_IR,v as HAILE_MAGIC,w as HAILE_TAXONOMY,I as adaptGraph,L as createHaileProvider,N as isCallableKind,E as loadWasmHaileKernel,$ as resetWasmHaileKernelCache,P as runSidecarCli,C as symbolKindOf};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibgrate/haile",
-  "version": "2026.902.2",
+  "version": "2026.903.2",
   "description": "Vibgrate HAILE architecture kernel: deterministic callable classification (role, purposes, intent, band) over a vg-graph. Proprietary distribution — compiled WASM engine plus a minified loader; the taxonomy is not included.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",