wyrm-mcp 7.10.0 → 7.12.0

package/dist/context-ranking.js

@@ -1 +1 @@
-import{logger as _}from"./logger.js";const o={confidence:.4,recency:.2,relevance:.3,usefulness:.1};function R(e=process.env){const n=e.WYRM_RANK_WEIGHTS;if(!n)return{...o};try{const t=JSON.parse(n),c={confidence:s(t.confidence??o.confidence),recency:s(t.recency??o.recency),relevance:s(t.relevance??o.relevance),usefulness:s(t.usefulness??o.usefulness)},r=c.confidence+c.recency+c.relevance+c.usefulness;return r<=0?{...o}:(c.confidence/=r,c.recency/=r,c.relevance/=r,c.usefulness/=r,c)}catch(t){return _.warn(`Invalid WYRM_RANK_WEIGHTS, using defaults: ${t.message}`),{...o}}}function s(e){return Number.isFinite(e)?Math.max(0,Math.min(1,e)):0}const d=.25,f=30;function N(e=process.env){const n=Number(e.WYRM_RECALL_RECENCY_WEIGHT);return Number.isFinite(n)?s(n):d}function L(e=process.env){const n=Number(e.WYRM_RECALL_RECENCY_HALFLIFE_DAYS);return Number.isFinite(n)&&n>=1?n:f}function T(e,n,t,c=new Date){const r=s(n);if(r===0)return 1;const a=e&&/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}/.test(e)?e.replace(" ","T")+"Z":e,u=a?new Date(a).getTime():NaN;if(!Number.isFinite(u))return 1-r;const i=Math.max(0,(c.getTime()-u)/864e5),l=t>=1?t:f;return 1-r+r*Math.pow(2,-i/l)}const p=.5,A=/^\s*\[auto:(precompact|sessionend|sessionstart)/i;function M(e){return e&&A.test(e)?p:0}function m(e,n,t=new Date){const c=s(e.confidence??.5),r=s(e.usefulness??.5),a=s(e.relevance??.5),u=e.updatedAt?Math.max(0,(t.getTime()-new Date(e.updatedAt).getTime())/(1440*60*1e3)):1/0,i=Number.isFinite(u)?Math.exp(-u/30):0,l=c*n.confidence+i*n.recency+a*n.relevance+r*n.usefulness,E=s(e.sourcePenalty??0);return s(l*(1-E))}export{p as AUTO_SUMMARY_PENALTY,f as DEFAULT_RECALL_RECENCY_HALFLIFE_DAYS,d as DEFAULT_RECALL_RECENCY_WEIGHT,o as DEFAULT_WEIGHTS,M as autoSummaryPenalty,R as loadWeightsFromEnv,L as recallRecencyHalfLifeDays,N as recallRecencyWeight,T as recencyMultiplier,m as score};
+import{logger as m}from"./logger.js";const u={confidence:.4,recency:.2,relevance:.3,usefulness:.1};function E(e=process.env){const t=e.WYRM_RANK_WEIGHTS;if(!t)return{...u};try{const n=JSON.parse(t),s={confidence:c(n.confidence??u.confidence),recency:c(n.recency??u.recency),relevance:c(n.relevance??u.relevance),usefulness:c(n.usefulness??u.usefulness)},r=s.confidence+s.recency+s.relevance+s.usefulness;return r<=0?{...u}:(s.confidence/=r,s.recency/=r,s.relevance/=r,s.usefulness/=r,s)}catch(n){return m.warn(`Invalid WYRM_RANK_WEIGHTS, using defaults: ${n.message}`),{...u}}}function c(e){return Number.isFinite(e)?Math.max(0,Math.min(1,e)):0}const p=.25,f=30;function _(e=process.env){const t=Number(e.WYRM_RECALL_RECENCY_WEIGHT);return Number.isFinite(t)?c(t):p}function N(e=process.env){const t=Number(e.WYRM_RECALL_RECENCY_HALFLIFE_DAYS);return Number.isFinite(t)&&t>=1?t:f}const y=[/\bignore\s+(all\s+)?(previous|prior|above|earlier)\s+(instructions?|prompts?|context)\b/i,/\bdisregard\s+(all\s+)?(previous|prior|your)\s+(instructions?|rules|guidelines)\b/i,/\byou\s+(must|are\s+required\s+to)\s+(now\s+)?(obey|comply|execute|run|send|forward|delete)\b/i,/\b(system|assistant)\s*prompt\s*[:=]/i,/\bBEGIN\s+(SYSTEM|ADMIN|OVERRIDE)\b/,/\bnew\s+(system\s+)?instructions?\s*[:=]/i,/\b(reveal|print|exfiltrate|send)\s+(your|the)\s+(api\s*key|token|secret|password|credentials)\b/i,/\bcurl\s+[^\n]{0,120}\|\s*(ba)?sh\b/i,/\bact\s+as\s+(the\s+)?(root|admin|system)\b/i,/\bdo\s+not\s+(tell|inform|alert)\s+the\s+(user|operator|owner)\b/i];function D(e){return e?y.some(t=>t.test(e)):!1}function M(e){return e==="imported"?"\u26A0 [imported] ":e==="untrusted"?"\u26A0 [untrusted] ":""}function T(e,t=new Date){const n=e.toLowerCase();if(/\btoday\b/.test(n))return{fromDaysAgo:1.5,toDaysAgo:0};if(/\byesterday\b/.test(n))return{fromDaysAgo:2.5,toDaysAgo:.5};if(/\b(this|past)\s+week\b/.test(n))return{fromDaysAgo:7,toDaysAgo:0};if(/\blast\s+week\b/.test(n))return{fromDaysAgo:14,toDaysAgo:5};const s=n.match(/\blast\s+(\d{1,3})\s+days?\b/);if(s)return{fromDaysAgo:Number(s[1])+.5,toDaysAgo:0};const r=n.match(/\b(\d{1,3})\s+days?\s+ago\b/);if(r){const o=Number(r[1]);return{fromDaysAgo:o+1.5,toDaysAgo:Math.max(0,o-1.5)}}const a=n.match(/\b(\d{4})-(\d{2})-(\d{2})\b/);if(a){const o=new Date(`${a[1]}-${a[2]}-${a[3]}T12:00:00Z`).getTime();if(Number.isFinite(o)){const i=(t.getTime()-o)/864e5;return{fromDaysAgo:i+1,toDaysAgo:Math.max(0,i-1)}}}return null}function x(e=process.env){const t=Number(e.WYRM_RECALL_TEMPORAL_WEIGHT);return Number.isFinite(t)?c(t):.5}function R(e,t,n,s=new Date){const r=c(n);if(r===0)return 1;const a=e&&/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}/.test(e)?e.replace(" ","T")+"Z":e,o=a?new Date(a).getTime():NaN;if(!Number.isFinite(o))return 1-r;const i=(s.getTime()-o)/864e5;return i<=t.fromDaysAgo&&i>=t.toDaysAgo?1:1-r}function h(e=process.env){const t=Number(e.WYRM_RECALL_USEFULNESS_WEIGHT);return Number.isFinite(t)?Math.max(0,Math.min(.5,t)):.15}function w(e,t,n){const s=Math.max(0,Math.min(.5,n));if(s===0||!e||e<=0)return 1;const r=Math.max(0,Math.min(1,(t??0)/e));return 1+s*r*Math.min(1,e/3)}function L(e,t,n,s=new Date){const r=c(t);if(r===0)return 1;const a=e&&/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}/.test(e)?e.replace(" ","T")+"Z":e,o=a?new Date(a).getTime():NaN;if(!Number.isFinite(o))return 1-r;const i=Math.max(0,(s.getTime()-o)/864e5),l=n>=1?n:f;return 1-r+r*Math.pow(2,-i/l)}const b=.5,A=/^\s*\[auto:(precompact|sessionend|sessionstart)/i;function v(e){return e&&A.test(e)?b:0}function F(e,t,n=new Date){const s=c(e.confidence??.5),r=c(e.usefulness??.5),a=c(e.relevance??.5),o=e.updatedAt?Math.max(0,(n.getTime()-new Date(e.updatedAt).getTime())/(1440*60*1e3)):1/0,i=Number.isFinite(o)?Math.exp(-o/30):0,l=s*t.confidence+i*t.recency+a*t.relevance+r*t.usefulness,d=c(e.sourcePenalty??0);return c(l*(1-d))}export{b as AUTO_SUMMARY_PENALTY,f as DEFAULT_RECALL_RECENCY_HALFLIFE_DAYS,p as DEFAULT_RECALL_RECENCY_WEIGHT,u as DEFAULT_WEIGHTS,v as autoSummaryPenalty,T as extractTemporalWindow,E as loadWeightsFromEnv,D as looksInjectionShaped,N as recallRecencyHalfLifeDays,_ as recallRecencyWeight,x as recallTemporalWeight,h as recallUsefulnessWeight,L as recencyMultiplier,F as score,R as temporalMultiplier,M as trustMarker,w as usefulnessMultiplier};

package/dist/handlers/capture.js

@@ -1,78 +1,78 @@
-import{join as B}from"path";import{createHash as K}from"crypto";import{TOOL_ANNOTATIONS as C}from"../tool-annotations.js";import{renderResult as S,withGlyph as E,renderErrorResponse as R,validationErrorBody as A}from"../render.js";import{ValidationError as J,asEnum as Y}from"../validate.js";import{daemonOr as L}from"../daemon-writer.js";import{classifyCapture as Q}from"../capture.js";import{recordWrite as D}from"../receipts.js";import{extractCandidates as O,candidateToArtifact as F,escapeLikePattern as M}from"../auto-capture.js";import{parseTrace as X,segmentsToText as G}from"../trace-harvest.js";import{getActor as V,runWithActor as z}from"./boundary.js";import{harvestProjects as Z}from"../harvest.js";import{readFileSync as N,readdirSync as ee,statSync as W}from"fs";import{join as U}from"path";import{homedir as te}from"os";import{readSpecDir as re,specTaskSignature as ie}from"../spec-kit.js";const ve=[{name:"wyrm_capture",description:"Use to save anything worth keeping - the single write funnel. Auto-classifies notes, decisions, and lessons into quest, ground truth, or memory; risky writes queue for wyrm_review. mode=direct (store a proven pattern or lesson learned so future agents reuse it), extract (pull memories from a conversation transcript or freeform text), trace (harvest a session JSONL / tool-call log into run-tagged review candidates), session (close out a work session into reusable knowledge), artifacts (harvest a repo's READMEs and recent commits into durable facts), import source=git|pr|rules, spec (turn a tasks.md into tracked work items), checklist. Keywords: remember this, jot down, write down, future reference.",inputSchema:{type:"object",properties:{content:{type:"string",description:"classify/rules"},project_id:{type:"number",description:"classify/import/spec"},tags:{type:"array",items:{type:"string"}},mode:{type:"string",enum:["auto","quest","truth","memory","classify","direct","extract","trace","session","artifacts","import","spec","checklist"],description:"quest|truth|memory force the type"},source:{type:"string",enum:["git","pr","rules"],description:"import"},projectPath:{type:"string",description:"non-classify"},kind:{type:"string",description:"direct"},problem:{type:"string",description:"direct"},validatedFix:{type:"string",description:"direct"},text:{type:"string",description:"extract"},sessionId:{type:"string",description:"session"},candidates:{type:"array",items:{type:"object"},description:"session"},dryRun:{type:"boolean",description:"artifacts"},commits:{type:"array",items:{type:"object"},description:"import git"},title:{type:"string",description:"import pr"},body:{type:"string",description:"import pr"},specDir:{type:"string",description:"spec"},problemType:{type:"string",description:"checklist"},whenToUse:{type:"string",description:"checklist"},steps:{type:"array",items:{type:"string"},description:"checklist"}},required:[]},outputSchema:{type:"object",properties:{status:{type:"string",enum:["captured","queued_for_review"]},type:{type:"string"},subtype:{type:"string"},confidence:{type:"number"},reasoning:{type:"string"},id:{type:"integer"},ref:{type:"string"},needs_review:{type:"boolean"},reason:{type:"string"},artifact_id:{type:"integer"},conflicts_with:{type:"array"},advisory_conflicts:{type:"array"}},required:["status"]},annotations:C.wyrm_capture,aliases:[],handler:async(k,{store:_,raw:$,memory:y,truths:m,cache:w})=>{const{content:a,project_id:f,projectPath:d,tags:l,mode:u}=k;if(typeof a!="string"||!a.trim()){const o=k;return o.problem||o.validated_fix||o.validatedFix||o.kind?R(A("wyrm_capture","mode","you passed pattern/lesson fields (kind/problem/validated_fix) \u2014 set mode:'direct' to store them as a distilled artifact.")):R(A("wyrm_capture","content","content is required for auto capture (or use mode:'direct' with problem + validated_fix)."))}let b=Q(a);u&&u!=="auto"&&(b={type:u,subtype:{quest:"quest",truth:"decision",memory:"pattern"}[u]??u,confidence:100,reasoning:`Mode override: ${u}`});const{type:i,subtype:t,confidence:g,reasoning:r}=b,e=f??(d?_.getProject(d)?.id??null:null);let c=0,n="",v=!1,s;if(i==="quest"){if(e===null)return R(A("wyrm_capture","projectPath","is required for quest capture"));c=(await L("quest_add",e,{title:a.slice(0,200),description:"",priority:"medium",tags:l?.join(",")},()=>_.addQuest(e,a.slice(0,200),"","medium",l?.join(",")))).id,n="quest",w.invalidate("wyrm_all_quests"),w.invalidate("wyrm_stats")}else if(i==="truth"){if(e===null)return R(A("wyrm_capture","projectPath","is required for truth capture"));if(g>=80){const o=t??"other",I=m.getCurrent(e).filter(p=>p.category===o);if(I.length>0){const p={kind:"pattern",problem:`Potential conflict with ${I.length} existing truth(s) in category "${o}"`,validatedFix:a,whyItWorked:"Pending review \u2014 possible supersession",tags:l??[],confidence:g/100,needsReview:1},j=await L("artifact_add",e,p,()=>y.add(e,p)),q=D($(),{tool:"wyrm_capture",outcome:"queued",refTable:"mem",refId:j.id,reason:`conflict_check \u2014 possible supersession of ${I.length} truth(s) in "${o}"; invisible to recall until wyrm_review`,projectId:e});return S({status:"queued_for_review",reason:"conflict_check",artifact_id:j.id,conflicts_with:I.map(T=>({id:T.id,content:T.value.slice(0,80)})),receipt:q})}}if(u!=="truth"&&g<100){const o={kind:"pattern",problem:a,validatedFix:"",whyItWorked:"",tags:l??[],confidence:g/100,needsReview:1};c=(await L("artifact_add",e,o,()=>y.add(e,o))).id,n="mem",v=!0}else{const o={category:"decision",key:a.slice(0,60),value:a};c=(await L("truth_set",e,o,()=>m.set(e,o))).id,n="truth",w.invalidate("wyrm_truth_get"),w.invalidate("wyrm_context_build")}}else{if(e===null)return R(A("wyrm_capture","projectPath","is required for memory capture"));const o=g>=75,x={kind:t,problem:a,validatedFix:"",whyItWorked:"",tags:l??[],confidence:g/100,needsReview:o?0:1};if(c=(await L("artifact_add",e,x,()=>y.add(e,x))).id,n="mem",v=!o,t==="heuristic"&&g>=75&&e!==null)try{const p=a.replace(/['"*]/g," ").trim().split(/\s+/).slice(0,5).join(" "),j=$().prepare(`
+import{join as K}from"path";import{createHash as O}from"crypto";import{TOOL_ANNOTATIONS as D}from"../tool-annotations.js";import{renderResult as S,withGlyph as E,renderErrorResponse as R,validationErrorBody as C}from"../render.js";import{ValidationError as J,asEnum as Y}from"../validate.js";import{daemonOr as L}from"../daemon-writer.js";import{classifyCapture as Q}from"../capture.js";import{recordWrite as A}from"../receipts.js";import{extractCandidates as F,candidateToArtifact as N,escapeLikePattern as M}from"../auto-capture.js";import{parseTrace as X,segmentsToText as G}from"../trace-harvest.js";import{getActor as V,runWithActor as z}from"./boundary.js";import{harvestProjects as Z}from"../harvest.js";import{readFileSync as U,readdirSync as ee,statSync as W}from"fs";import{join as H}from"path";import{homedir as te}from"os";import{readSpecDir as re,specTaskSignature as ie}from"../spec-kit.js";const ve=[{name:"wyrm_capture",description:"Use to save anything worth keeping - the single write funnel. Auto-classifies notes, decisions, and lessons into quest, ground truth, or memory; risky writes queue for wyrm_review. mode=direct (store a proven pattern or lesson learned so future agents reuse it), extract (pull memories from a conversation transcript or freeform text), trace (harvest a session JSONL / tool-call log into run-tagged review candidates), session (close out a work session into reusable knowledge), artifacts (harvest a repo's READMEs and recent commits into durable facts), import source=git|pr|rules, spec (turn a tasks.md into tracked work items), checklist. Keywords: remember this, jot down, write down, future reference.",inputSchema:{type:"object",properties:{content:{type:"string",description:"classify/rules"},project_id:{type:"number",description:"classify/import/spec"},tags:{type:"array",items:{type:"string"}},mode:{type:"string",enum:["auto","quest","truth","memory","classify","direct","extract","trace","session","artifacts","import","spec","checklist"],description:"quest|truth|memory force the type"},source:{type:"string",enum:["git","pr","rules"],description:"import"},projectPath:{type:"string",description:"non-classify"},kind:{type:"string",description:"direct"},problem:{type:"string",description:"direct"},validatedFix:{type:"string",description:"direct"},text:{type:"string",description:"extract"},sessionId:{type:"string",description:"session"},candidates:{type:"array",items:{type:"object"},description:"session"},dryRun:{type:"boolean",description:"artifacts"},commits:{type:"array",items:{type:"object"},description:"import git"},title:{type:"string",description:"import pr"},body:{type:"string",description:"import pr"},specDir:{type:"string",description:"spec"},problemType:{type:"string",description:"checklist"},whenToUse:{type:"string",description:"checklist"},steps:{type:"array",items:{type:"string"},description:"checklist"}},required:[]},outputSchema:{type:"object",properties:{status:{type:"string",enum:["captured","queued_for_review"]},type:{type:"string"},subtype:{type:"string"},confidence:{type:"number"},reasoning:{type:"string"},id:{type:"integer"},ref:{type:"string"},needs_review:{type:"boolean"},reason:{type:"string"},artifact_id:{type:"integer"},conflicts_with:{type:"array"},advisory_conflicts:{type:"array"}},required:["status"]},annotations:D.wyrm_capture,aliases:[],handler:async($,{store:b,raw:x,memory:w,truths:l,cache:h})=>{const{content:a,project_id:g,projectPath:n,tags:f,mode:p}=$;if(typeof a!="string"||!a.trim()){const r=$;return r.problem||r.validated_fix||r.validatedFix||r.kind?R(C("wyrm_capture","mode","you passed pattern/lesson fields (kind/problem/validated_fix) \u2014 set mode:'direct' to store them as a distilled artifact.")):R(C("wyrm_capture","content","content is required for auto capture (or use mode:'direct' with problem + validated_fix)."))}let v=Q(a);p&&p!=="auto"&&(v={type:p,subtype:{quest:"quest",truth:"decision",memory:"pattern"}[p]??p,confidence:100,reasoning:`Mode override: ${p}`});const{type:d,subtype:s,confidence:u,reasoning:o}=v,e=g??(n?b.getProject(n)?.id??null:null);let i=0,y="",j=!1,t;if(d==="quest"){if(e===null)return R(C("wyrm_capture","projectPath","is required for quest capture"));i=(await L("quest_add",e,{title:a.slice(0,200),description:"",priority:"medium",tags:f?.join(",")},()=>b.addQuest(e,a.slice(0,200),"","medium",f?.join(",")))).id,y="quest",h.invalidate("wyrm_all_quests"),h.invalidate("wyrm_stats")}else if(d==="truth"){if(e===null)return R(C("wyrm_capture","projectPath","is required for truth capture"));if(u>=80){const r=s??"other",P=l.getCurrent(e).filter(c=>c.category===r);if(P.length>0){const c={kind:"pattern",problem:`Potential conflict with ${P.length} existing truth(s) in category "${r}"`,validatedFix:a,whyItWorked:"Pending review \u2014 possible supersession",tags:f??[],confidence:u/100,needsReview:1},k=await L("artifact_add",e,c,()=>w.add(e,c)),q=A(x(),{tool:"wyrm_capture",outcome:"queued",refTable:"mem",refId:k.id,reason:`conflict_check \u2014 possible supersession of ${P.length} truth(s); review to activate`,projectId:e});return S({status:"queued_for_review",reason:"conflict_check",artifact_id:k.id,conflicts_with:P.map(T=>({id:T.id,content:T.value.slice(0,80)})),receipt:q})}}if(p!=="truth"&&u<100){const r={kind:"pattern",problem:a,validatedFix:"",whyItWorked:"",tags:f??[],confidence:u/100,needsReview:1};i=(await L("artifact_add",e,r,()=>w.add(e,r))).id,y="mem",j=!0}else{const r={category:"decision",key:a.slice(0,60),value:a};i=(await L("truth_set",e,r,()=>l.set(e,r))).id,y="truth",h.invalidate("wyrm_truth_get"),h.invalidate("wyrm_context_build")}}else{if(e===null)return R(C("wyrm_capture","projectPath","is required for memory capture"));const r=u>=75,I={kind:s,problem:a,validatedFix:"",whyItWorked:"",tags:f??[],confidence:u/100,needsReview:r?0:1};if(i=(await L("artifact_add",e,I,()=>w.add(e,I))).id,y="mem",j=!r,s==="heuristic"&&u>=75&&e!==null)try{const c=a.replace(/['"*]/g," ").trim().split(/\s+/).slice(0,5).join(" "),k=x().prepare(`
               SELECT a.id, a.problem FROM memory_artifacts a
               JOIN memory_artifacts_fts ON a.id = memory_artifacts_fts.rowid
               WHERE memory_artifacts_fts MATCH ? AND a.project_id = ? AND a.kind = 'heuristic' AND a.needs_review = 0
               LIMIT 3
-            `).all(p,e);j.length>0&&(s=j.map(q=>({id:q.id,content:q.problem.slice(0,80)})))}catch{}}const h=D($(),{tool:"wyrm_capture",outcome:v?"queued":"stored",refTable:n,refId:c,reason:v?`needs_review (classifier confidence ${g}%) \u2014 invisible to recall until wyrm_review`:void 0,projectId:e??void 0}),P={status:"captured",type:i,subtype:t,confidence:g,reasoning:r,id:c,ref:`${n}:${c}`,needs_review:v,receipt:h,...s&&s.length>0?{advisory_conflicts:s}:{}};return S(P,(o,x)=>{let I=`Captured as ${o.type}: ${o.subtype}
-Confidence: ${o.confidence}% | ${o.reasoning}
-ID: ${o.ref}`;o.needs_review&&(I+=`
-`+E(x.warn,"Stored for review -- run `wyrm_review` to activate"));const p=o.advisory_conflicts;return p&&p.length>0&&(I+=`
-
-`+E(x.warn,`Advisory: ${p.length} similar heuristic(s) found:`)+`
-`+p.map(j=>`  ${x.bullet} [${j.id}] ${j.content}`).join(`
-`)),I})}},{name:"wyrm_remember",description:"Store a distilled knowledge artifact \u2014 proven patterns, lessons learned, anti-patterns, and reasoning traces. These are recalled automatically by wyrm_context_build to help AI models apply past knowledge to new tasks. Example: wyrm_remember({ projectPath: '/home/user/api', kind: 'anti_pattern', problem: 'Jest suite hung after adding the SSE server', validatedFix: 'close() the server in afterAll \u2014 its keep-alive timer held the event loop open', whyItWorked: 'open handles block jest exit', outcome: 'positive', tags: ['jest', 'sse'] })",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project this knowledge belongs to"},kind:{type:"string",enum:["reasoning_trace","lesson","pattern","anti_pattern","heuristic"],description:"reasoning_trace: a solved problem with steps; lesson: a general insight; pattern: a proven approach; anti_pattern: what NOT to do; heuristic: a rule of thumb"},problem:{type:"string",description:"What was being solved or observed (be specific and searchable)"},constraints:{type:"string",description:"What conditions or constraints applied"},validatedFix:{type:"string",description:"What actually worked \u2014 the validated solution or approach"},whyItWorked:{type:"string",description:"The insight behind WHY this worked (key for transfer learning)"},outcome:{type:"string",enum:["positive","negative","neutral"],description:"Was this approach successful?"},tags:{type:"array",items:{type:"string"},description:"Searchable tags (e.g. ['auth', 'rate-limit', 'typescript'])"},confidence:{type:"number",description:"Confidence level 0.0\u20131.0 (default: 1.0)"},sourceSessionId:{type:"number",description:"Session ID where this was discovered (optional)"}},required:["projectPath","kind","problem"]},outputSchema:{type:"object",properties:{id:{type:"integer"},kind:{type:"string",enum:["reasoning_trace","lesson","pattern","anti_pattern","heuristic"]},problem:{type:"string"},validated_fix:{type:["string","null"]},why_it_worked:{type:["string","null"]},confidence:{type:"number"},tags:{type:["string","null"]}},required:["id","kind","problem","validated_fix","why_it_worked","confidence","tags"]},annotations:C.wyrm_remember,aliases:[],handler:async(k,{store:_,memory:$,raw:y})=>{const{projectPath:m,kind:w,problem:a,constraints:f,outcome:d,tags:l,confidence:u,sourceSessionId:b}=k,i=k,t=i.validatedFix??i.validated_fix,g=i.whyItWorked??i.why_it_worked,r=Y("kind",w,["reasoning_trace","lesson","pattern","anti_pattern","heuristic"]);if(r===void 0)throw new J("kind","is required");const e=_.getProject(m);if(!e)return R(A("wyrm_remember","projectPath","project not found"));const c={kind:r,problem:a,constraints:f,validatedFix:t,whyItWorked:g,outcome:d,tags:l,confidence:u,sourceSessionId:b},n=await L("artifact_add",e.id,c,()=>$.add(e.id,c)),v=D(y(),{tool:"wyrm_remember",outcome:n.needs_review===1?"queued":"stored",refTable:"mem",refId:n.id,reason:n.needs_review===1?"needs_review \u2014 invisible to recall until approved (wyrm_review)":void 0,source:n.created_by,projectId:e.id}),s={id:n.id,kind:n.kind,problem:n.problem,validated_fix:n.validated_fix??null,why_it_worked:n.why_it_worked??null,confidence:n.confidence,tags:n.tags??null,receipt:v};return S(s,(h,P)=>{let o=E(P.brand,"**Memory Stored**")+`
-
-`;return o+=`${P.bullet} **Kind:** ${h.kind}
-`,o+=`${P.bullet} **ID:** ${h.id}
-`,o+=`${P.bullet} **Problem:** ${h.problem}
-`,h.validated_fix&&(o+=`${P.bullet} **Solution:** ${h.validated_fix}
-`),h.why_it_worked&&(o+=`${P.bullet} **Why it worked:** ${h.why_it_worked}
-`),o+=`${P.bullet} **Confidence:** ${(h.confidence*100).toFixed(0)}%
-`,h.tags&&(o+=`${P.bullet} **Tags:** ${h.tags}
-`),o+="\n_Use `wyrm_recall` to retrieve similar memories, or `wyrm_context_build` to assemble a task brief._",o})}},{name:"wyrm_auto_capture",description:"Auto-extract durable memories from freeform text (a session transcript, notes, a chat) into the REVIEW QUEUE. A LOCAL extractor \u2014 a configurable Ollama model (WYRM_EXTRACT_MODEL / the `model` arg) if set, else a deterministic heuristic \u2014 pulls out truths, failures, decisions, patterns, and lessons as needs_review candidates; approve/reject with wyrm_review (nothing auto-trusted). Closes the 'just talk, it remembers' gap without a cloud LLM. Deduped + idempotent. Example: wyrm_auto_capture({ projectPath: '/home/user/api', text: 'Deploy failed twice because wrangler.toml pointed at the old KV id; switched to the new binding and decided to pin binding names in CI.' })",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project to file the extracted candidates under"},text:{type:"string",description:"Freeform text to extract durable memories from"},model:{type:"string",description:"Optional Ollama model for extraction (overrides WYRM_EXTRACT_MODEL); omit for deterministic extraction"}},required:["projectPath","text"]},outputSchema:{type:"object",properties:{method:{type:"string"},model:{type:["string","null"]},added:{type:"integer"},skipped:{type:"integer"},candidates:{type:"array",items:{type:"object",properties:{kind:{type:"string"},text:{type:"string"}},required:["kind","text"]}}},required:["method","model","added","skipped","candidates"]},annotations:C.wyrm_auto_capture,aliases:[],handler:async(k,{store:_,raw:$,memory:y,cache:m})=>{const{projectPath:w,text:a,model:f}=k,d=_.getProject(w);if(!d)return R(A("wyrm_auto_capture","projectPath","project not found"));if(!a||a.trim().length<20)return R(A("wyrm_auto_capture","text","must be at least 20 characters"));const{candidates:l,method:u,model:b}=await O(a,{model:f}),i=$();let t=0,g=0;for(const e of l){const c=F(e),n=c.tags[c.tags.length-1];if(i.prepare("SELECT 1 FROM memory_artifacts WHERE project_id = ? AND tags LIKE ? ESCAPE '\\' LIMIT 1").get(d.id,"%"+M(n)+"%")){g++,D(i,{tool:"wyrm_auto_capture",outcome:"dropped",reason:"dedup \u2014 identical extraction signature already present",source:"auto-extract",projectId:d.id});continue}const v=y.add(d.id,{kind:c.kind,problem:c.problem,tags:c.tags,confidence:c.confidence,needsReview:1,createdBy:"auto-extract"});D(i,{tool:"wyrm_auto_capture",outcome:"queued",refTable:"mem",refId:v.id,reason:"needs_review \u2014 auto-extracted candidate; invisible to recall until wyrm_review",source:"auto-extract",projectId:d.id}),t++}t>0&&m.invalidate();const r={method:u,model:b??null,added:t,skipped:g,receipt:{outcome:t>0?"queued":"dropped",reason:`${t} queued for review, ${g} dropped as duplicates`},candidates:l.slice(0,8).map(e=>({kind:e.kind,text:e.text.slice(0,80)}))};return S(r,(e,c)=>{const n=e.candidates.map(v=>`   ${c.bullet} [${v.kind}] ${v.text}`).join(`
-`);return E(c.brand,`Auto-capture (${e.method}${e.model?` - ${e.model}`:""}) -- ${e.added} candidate(s) -> review queue, ${e.skipped} already present.`)+`
-${n}
-
-Approve/reject with wyrm_review.`})}},{name:"wyrm_capture_trace",description:"Harvest a harness's working trace into run-tagged review-queue candidates \u2014 OFFLINE. Ingests a Claude Code session transcript (JSONL), a ~/.dragon/traces file/dir, or WYRM_TRACE_TOOL_CALLS event output. The SAME local extractor as auto-capture (Ollama WYRM_EXTRACT_MODEL if set, else deterministic \u2014 never a cloud LLM) pulls durable truths/failures/decisions/patterns/lessons; secrets (API keys, tokens, passwords) are REDACTED before anything is stored; candidates land needs_review=1 stamped with the run_id (arg or ambient envelope). Approve/reject with wyrm_review; deduped + idempotent. Pass `trace` (inline text) OR `path` (a trace file or the ~/.dragon/traces dir). Reached via wyrm_capture({ mode: 'trace' }).",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project to file the candidates under"},trace:{type:"string",description:"Inline trace text (JSONL transcript / dragon records / tool-call events)"},path:{type:"string",description:"Path to a trace file, or the ~/.dragon/traces directory (newest file is read); omit ~ for absolute"},format:{type:"string",enum:["auto","claude-jsonl","dragon","tool-calls"],description:"Trace format (default auto-detect)"},run_id:{type:"string",description:"Tag candidates with this run (default: ambient envelope run_id)"},model:{type:"string",description:"Optional Ollama model for extraction (overrides WYRM_EXTRACT_MODEL); omit for deterministic"}},required:["projectPath"]},outputSchema:{type:"object",properties:{method:{type:"string"},model:{type:["string","null"]},format:{type:"string"},source:{type:"string"},run_id:{type:["string","null"]},segments:{type:"integer"},added:{type:"integer"},skipped:{type:"integer"},candidates:{type:"array",items:{type:"object",properties:{kind:{type:"string"},text:{type:"string"}},required:["kind","text"]}}},required:["method","model","format","source","run_id","segments","added","skipped","candidates"]},annotations:C.wyrm_capture_trace,aliases:[],handler:async(k,{store:_,raw:$,memory:y,cache:m})=>{const{projectPath:w,trace:a,path:f,format:d,run_id:l,model:u}=k,b=_.getProject(w);if(!b)return R(A("wyrm_capture_trace","projectPath","project not found"));const i=V(),t=typeof l=="string"&&l.trim()?l.trim().slice(0,64):i.run_id;let g="",r="inline";if(typeof a=="string"&&a.trim())g=a,r="inline";else if(typeof f=="string"&&f.trim()){let p=f.trim();(p==="~"||p.startsWith("~/"))&&(p=U(te(),p.slice(1)));try{if(W(p).isDirectory()){const q=ee(p).map(T=>U(p,T)).filter(T=>{try{return W(T).isFile()}catch{return!1}}).sort((T,H)=>W(H).mtimeMs-W(T).mtimeMs);if(q.length===0)return R(A("wyrm_capture_trace","path","no trace files in directory"));g=N(q[0],"utf-8"),r=q[0]}else g=N(p,"utf-8"),r=p}catch(j){return R(A("wyrm_capture_trace","path",`could not read trace path: ${j.message}`))}}else return R(A("wyrm_capture_trace","trace","provide inline trace or path to trace file"));const{segments:e,format:c}=X(g,d??"auto"),n=G(e);if(n.trim().length<20){const p={method:"deterministic",model:null,format:c,source:r,run_id:t,segments:e.length,added:0,skipped:0,candidates:[]};return S(p,(j,q)=>E(q.brand,`Trace harvest (${j.format}) -- no durable content extracted from ${j.segments} segment(s).`))}const{candidates:v,method:s,model:h}=await O(n,{model:u}),P=$();let o=0,x=0;for(const p of v){const j=F(p),q=j.tags[j.tags.length-1];if(P.prepare("SELECT 1 FROM memory_artifacts WHERE project_id = ? AND tags LIKE ? ESCAPE '\\' LIMIT 1").get(b.id,"%"+M(q)+"%")){x++;continue}const T=t?[...j.tags,"trace",`run:${t}`]:[...j.tags,"trace"];z({agent_id:i.agent_id,run_id:t,source:t?"param":i.source},()=>y.add(b.id,{kind:j.kind,problem:j.problem,tags:T,confidence:j.confidence,needsReview:1,createdBy:"trace-harvest"})),o++}o>0&&m.invalidate();const I={method:s,model:h??null,format:c,source:r,run_id:t,segments:e.length,added:o,skipped:x,candidates:v.slice(0,8).map(p=>({kind:p.kind,text:p.text.slice(0,80)}))};return S(I,(p,j)=>{const q=p.candidates.map(T=>`   ${j.bullet} [${T.kind}] ${T.text}`).join(`
-`);return E(j.brand,`Trace harvest (${p.format}, ${p.method}${p.model?` - ${p.model}`:""}) -- ${p.segments} segment(s) -> ${p.added} candidate(s) to review queue, ${p.skipped} already present${p.run_id?` [run:${p.run_id}]`:""}.`)+(q?`
+            `).all(c,e);k.length>0&&(t=k.map(q=>({id:q.id,content:q.problem.slice(0,80)})))}catch{}}const _=A(x(),{tool:"wyrm_capture",outcome:j?"queued":"stored",refTable:y,refId:i,reason:j?`needs_review (confidence ${u}%) \u2014 review to activate`:void 0,projectId:e??void 0}),m={status:"captured",type:d,subtype:s,confidence:u,reasoning:o,id:i,ref:`${y}:${i}`,needs_review:j,receipt:_,...t&&t.length>0?{advisory_conflicts:t}:{}};return S(m,(r,I)=>{let P=`Captured as ${r.type}: ${r.subtype}
+Confidence: ${r.confidence}% | ${r.reasoning}
+ID: ${r.ref}`;r.needs_review&&(P+=`
+`+E(I.warn,"Stored for review -- run `wyrm_review` to activate"));const c=r.advisory_conflicts;return c&&c.length>0&&(P+=`
+
+`+E(I.warn,`Advisory: ${c.length} similar heuristic(s) found:`)+`
+`+c.map(k=>`  ${I.bullet} [${k.id}] ${k.content}`).join(`
+`)),P})}},{name:"wyrm_remember",description:"Store a distilled knowledge artifact \u2014 proven patterns, lessons learned, anti-patterns, and reasoning traces. These are recalled automatically by wyrm_context_build to help AI models apply past knowledge to new tasks. Example: wyrm_remember({ projectPath: '/home/user/api', kind: 'anti_pattern', problem: 'Jest suite hung after adding the SSE server', validatedFix: 'close() the server in afterAll \u2014 its keep-alive timer held the event loop open', whyItWorked: 'open handles block jest exit', outcome: 'positive', tags: ['jest', 'sse'] })",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project this knowledge belongs to"},kind:{type:"string",enum:["reasoning_trace","lesson","pattern","anti_pattern","heuristic"],description:"reasoning_trace: a solved problem with steps; lesson: a general insight; pattern: a proven approach; anti_pattern: what NOT to do; heuristic: a rule of thumb"},problem:{type:"string",description:"What was being solved or observed (be specific and searchable)"},constraints:{type:"string",description:"What conditions or constraints applied"},validatedFix:{type:"string",description:"What actually worked \u2014 the validated solution or approach"},whyItWorked:{type:"string",description:"The insight behind WHY this worked (key for transfer learning)"},outcome:{type:"string",enum:["positive","negative","neutral"],description:"Was this approach successful?"},tags:{type:"array",items:{type:"string"},description:"Searchable tags (e.g. ['auth', 'rate-limit', 'typescript'])"},confidence:{type:"number",description:"Confidence level 0.0\u20131.0 (default: 1.0)"},sourceSessionId:{type:"number",description:"Session ID where this was discovered (optional)"}},required:["projectPath","kind","problem"]},outputSchema:{type:"object",properties:{id:{type:"integer"},kind:{type:"string",enum:["reasoning_trace","lesson","pattern","anti_pattern","heuristic"]},problem:{type:"string"},validated_fix:{type:["string","null"]},why_it_worked:{type:["string","null"]},confidence:{type:"number"},tags:{type:["string","null"]}},required:["id","kind","problem","validated_fix","why_it_worked","confidence","tags"]},annotations:D.wyrm_remember,aliases:[],handler:async($,{store:b,memory:x,raw:w})=>{const{projectPath:l,kind:h,problem:a,constraints:g,outcome:n,tags:f,confidence:p,sourceSessionId:v}=$,d=$,s=d.validatedFix??d.validated_fix,u=d.whyItWorked??d.why_it_worked,o=Y("kind",h,["reasoning_trace","lesson","pattern","anti_pattern","heuristic"]);if(o===void 0)throw new J("kind","is required");const e=b.getProject(l);if(!e)return R(C("wyrm_remember","projectPath","project not found"));const i={kind:o,problem:a,constraints:g,validatedFix:s,whyItWorked:u,outcome:n,tags:f,confidence:p,sourceSessionId:v},y=await L("artifact_add",e.id,i,()=>x.add(e.id,i)),j=A(w(),{tool:"wyrm_remember",outcome:y.needs_review===1?"queued":"stored",refTable:"mem",refId:y.id,reason:y.needs_review===1?"needs_review \u2014 hidden until approved":void 0,source:y.created_by,projectId:e.id}),t={id:y.id,kind:y.kind,problem:y.problem,validated_fix:y.validated_fix??null,why_it_worked:y.why_it_worked??null,confidence:y.confidence,tags:y.tags??null,receipt:j};return S(t,(_,m)=>{let r=E(m.brand,"**Memory Stored**")+`
+
+`;return r+=`${m.bullet} **Kind:** ${_.kind}
+`,r+=`${m.bullet} **ID:** ${_.id}
+`,r+=`${m.bullet} **Problem:** ${_.problem}
+`,_.validated_fix&&(r+=`${m.bullet} **Solution:** ${_.validated_fix}
+`),_.why_it_worked&&(r+=`${m.bullet} **Why it worked:** ${_.why_it_worked}
+`),r+=`${m.bullet} **Confidence:** ${(_.confidence*100).toFixed(0)}%
+`,_.tags&&(r+=`${m.bullet} **Tags:** ${_.tags}
+`),r+="\n_Use `wyrm_recall` to retrieve similar memories, or `wyrm_context_build` to assemble a task brief._",r})}},{name:"wyrm_auto_capture",description:"Auto-extract durable memories from freeform text (a session transcript, notes, a chat) into the REVIEW QUEUE. A LOCAL extractor \u2014 a configurable Ollama model (WYRM_EXTRACT_MODEL / the `model` arg) if set, else a deterministic heuristic \u2014 pulls out truths, failures, decisions, patterns, and lessons as needs_review candidates; approve/reject with wyrm_review (nothing auto-trusted). Closes the 'just talk, it remembers' gap without a cloud LLM. Deduped + idempotent. Example: wyrm_auto_capture({ projectPath: '/home/user/api', text: 'Deploy failed twice because wrangler.toml pointed at the old KV id; switched to the new binding and decided to pin binding names in CI.' })",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project to file the extracted candidates under"},text:{type:"string",description:"Freeform text to extract durable memories from"},model:{type:"string",description:"Optional Ollama model for extraction (overrides WYRM_EXTRACT_MODEL); omit for deterministic extraction"}},required:["projectPath","text"]},outputSchema:{type:"object",properties:{method:{type:"string"},model:{type:["string","null"]},added:{type:"integer"},skipped:{type:"integer"},candidates:{type:"array",items:{type:"object",properties:{kind:{type:"string"},text:{type:"string"}},required:["kind","text"]}}},required:["method","model","added","skipped","candidates"]},annotations:D.wyrm_auto_capture,aliases:[],handler:async($,{store:b,raw:x,memory:w,cache:l})=>{const{projectPath:h,text:a,model:g}=$,n=b.getProject(h);if(!n)return R(C("wyrm_auto_capture","projectPath","project not found"));if(!a||a.trim().length<20)return R(C("wyrm_auto_capture","text","must be at least 20 characters"));const{candidates:f,method:p,model:v}=await F(a,{model:g}),d=x();let s=0,u=0;for(const e of f){const i=N(e),y=i.tags[i.tags.length-1];if(d.prepare("SELECT 1 FROM memory_artifacts WHERE project_id = ? AND tags LIKE ? ESCAPE '\\' LIMIT 1").get(n.id,"%"+M(y)+"%")){u++,A(d,{tool:"wyrm_auto_capture",outcome:"dropped",reason:"dedup \u2014 already captured",source:"auto-extract",projectId:n.id});continue}const j=w.add(n.id,{kind:i.kind,problem:i.problem,tags:i.tags,confidence:i.confidence,needsReview:1,createdBy:"auto-extract"});A(d,{tool:"wyrm_auto_capture",outcome:"queued",refTable:"mem",refId:j.id,reason:"needs_review \u2014 auto-extracted; review to activate",source:"auto-extract",projectId:n.id}),s++}s>0&&l.invalidate();const o={method:p,model:v??null,added:s,skipped:u,receipt:{outcome:s>0?"queued":"dropped",reason:`${s} queued for review, ${u} dropped as duplicates`},candidates:f.slice(0,8).map(e=>({kind:e.kind,text:e.text.slice(0,80)}))};return S(o,(e,i)=>{const y=e.candidates.map(j=>`   ${i.bullet} [${j.kind}] ${j.text}`).join(`
+`);return E(i.brand,`Auto-capture (${e.method}${e.model?` - ${e.model}`:""}) -- ${e.added} candidate(s) -> review queue, ${e.skipped} already present.`)+`
+${y}
+
+Approve/reject with wyrm_review.`})}},{name:"wyrm_capture_trace",description:"Harvest a harness's working trace into run-tagged review-queue candidates \u2014 OFFLINE. Ingests a Claude Code session transcript (JSONL), a ~/.dragon/traces file/dir, or WYRM_TRACE_TOOL_CALLS event output. The SAME local extractor as auto-capture (Ollama WYRM_EXTRACT_MODEL if set, else deterministic \u2014 never a cloud LLM) pulls durable truths/failures/decisions/patterns/lessons; secrets (API keys, tokens, passwords) are REDACTED before anything is stored; candidates land needs_review=1 stamped with the run_id (arg or ambient envelope). Approve/reject with wyrm_review; deduped + idempotent. Pass `trace` (inline text) OR `path` (a trace file or the ~/.dragon/traces dir). Reached via wyrm_capture({ mode: 'trace' }).",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project to file the candidates under"},trace:{type:"string",description:"Inline trace text (JSONL transcript / dragon records / tool-call events)"},path:{type:"string",description:"Path to a trace file, or the ~/.dragon/traces directory (newest file is read); omit ~ for absolute"},format:{type:"string",enum:["auto","claude-jsonl","dragon","tool-calls"],description:"Trace format (default auto-detect)"},run_id:{type:"string",description:"Tag candidates with this run (default: ambient envelope run_id)"},model:{type:"string",description:"Optional Ollama model for extraction (overrides WYRM_EXTRACT_MODEL); omit for deterministic"}},required:["projectPath"]},outputSchema:{type:"object",properties:{method:{type:"string"},model:{type:["string","null"]},format:{type:"string"},source:{type:"string"},run_id:{type:["string","null"]},segments:{type:"integer"},added:{type:"integer"},skipped:{type:"integer"},candidates:{type:"array",items:{type:"object",properties:{kind:{type:"string"},text:{type:"string"}},required:["kind","text"]}}},required:["method","model","format","source","run_id","segments","added","skipped","candidates"]},annotations:D.wyrm_capture_trace,aliases:[],handler:async($,{store:b,raw:x,memory:w,cache:l})=>{const{projectPath:h,trace:a,path:g,format:n,run_id:f,model:p}=$,v=b.getProject(h);if(!v)return R(C("wyrm_capture_trace","projectPath","project not found"));const d=V(),s=typeof f=="string"&&f.trim()?f.trim().slice(0,64):d.run_id;let u="",o="inline";if(typeof a=="string"&&a.trim())u=a,o="inline";else if(typeof g=="string"&&g.trim()){let c=g.trim();(c==="~"||c.startsWith("~/"))&&(c=H(te(),c.slice(1)));try{if(W(c).isDirectory()){const q=ee(c).map(T=>H(c,T)).filter(T=>{try{return W(T).isFile()}catch{return!1}}).sort((T,B)=>W(B).mtimeMs-W(T).mtimeMs);if(q.length===0)return R(C("wyrm_capture_trace","path","no trace files in directory"));u=U(q[0],"utf-8"),o=q[0]}else u=U(c,"utf-8"),o=c}catch(k){return R(C("wyrm_capture_trace","path",`could not read trace path: ${k.message}`))}}else return R(C("wyrm_capture_trace","trace","provide inline trace or path to trace file"));const{segments:e,format:i}=X(u,n??"auto"),y=G(e);if(y.trim().length<20){const c={method:"deterministic",model:null,format:i,source:o,run_id:s,segments:e.length,added:0,skipped:0,candidates:[]};return S(c,(k,q)=>E(q.brand,`Trace harvest (${k.format}) -- no durable content extracted from ${k.segments} segment(s).`))}const{candidates:j,method:t,model:_}=await F(y,{model:p}),m=x();let r=0,I=0;for(const c of j){const k=N(c),q=k.tags[k.tags.length-1];if(m.prepare("SELECT 1 FROM memory_artifacts WHERE project_id = ? AND tags LIKE ? ESCAPE '\\' LIMIT 1").get(v.id,"%"+M(q)+"%")){I++;continue}const T=s?[...k.tags,"trace",`run:${s}`]:[...k.tags,"trace"];z({agent_id:d.agent_id,run_id:s,source:s?"param":d.source},()=>w.add(v.id,{kind:k.kind,problem:k.problem,tags:T,confidence:k.confidence,needsReview:1,createdBy:"trace-harvest"})),r++}r>0&&l.invalidate();const P={method:t,model:_??null,format:i,source:o,run_id:s,segments:e.length,added:r,skipped:I,candidates:j.slice(0,8).map(c=>({kind:c.kind,text:c.text.slice(0,80)}))};return S(P,(c,k)=>{const q=c.candidates.map(T=>`   ${k.bullet} [${T.kind}] ${T.text}`).join(`
+`);return E(k.brand,`Trace harvest (${c.format}, ${c.method}${c.model?` - ${c.model}`:""}) -- ${c.segments} segment(s) -> ${c.added} candidate(s) to review queue, ${c.skipped} already present${c.run_id?` [run:${c.run_id}]`:""}.`)+(q?`
 ${q}`:"")+`
 
-Approve/reject with wyrm_review.`})}},{name:"wyrm_distill",description:"Distill a work session into candidate memory artifacts for review. Parses the session's objectives, decisions, and outcomes into structured artifacts (lessons, patterns, anti-patterns) and queues them for approval via wyrm_review. Use at session end to extract institutional knowledge.",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project root path"},sessionId:{type:"string",description:"Session ID to distill"},candidates:{type:"array",description:"Pre-parsed candidate artifacts to store for review",items:{type:"object",properties:{kind:{type:"string",enum:["lesson","pattern","anti_pattern","heuristic","reasoning_trace"]},title:{type:"string"},content:{type:"string"},tags:{type:"array",items:{type:"string"}},confidence:{type:"number"}},required:["kind","title","content"]}}},required:["projectPath","candidates"]},outputSchema:{type:"object",properties:{count:{type:"integer"},artifacts:{type:"array",items:{type:"object",properties:{id:{type:"integer"},kind:{type:"string"},title:{type:"string"}},required:["id","kind","title"]}}},required:["count","artifacts"]},annotations:C.wyrm_distill,aliases:[],handler:(k,{store:_,memory:$})=>{const{projectPath:y,candidates:m}=k,w=_.getProject(y);if(!w)return{content:[{type:"text",text:`Project not found: ${y}`}],isError:!0};if(!m||m.length===0)return{content:[{type:"text",text:`**Distill**
+Approve/reject with wyrm_review.`})}},{name:"wyrm_distill",description:"Distill a work session into candidate memory artifacts for review. Parses the session's objectives, decisions, and outcomes into structured artifacts (lessons, patterns, anti-patterns) and queues them for approval via wyrm_review. Use at session end to extract institutional knowledge.",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project root path"},sessionId:{type:"string",description:"Session ID to distill"},candidates:{type:"array",description:"Pre-parsed candidate artifacts to store for review",items:{type:"object",properties:{kind:{type:"string",enum:["lesson","pattern","anti_pattern","heuristic","reasoning_trace"]},title:{type:"string"},content:{type:"string"},tags:{type:"array",items:{type:"string"}},confidence:{type:"number"}},required:["kind","title","content"]}}},required:["projectPath","candidates"]},outputSchema:{type:"object",properties:{count:{type:"integer"},artifacts:{type:"array",items:{type:"object",properties:{id:{type:"integer"},kind:{type:"string"},title:{type:"string"}},required:["id","kind","title"]}}},required:["count","artifacts"]},annotations:D.wyrm_distill,aliases:[],handler:($,{store:b,memory:x})=>{const{projectPath:w,candidates:l}=$,h=b.getProject(w);if(!h)return{content:[{type:"text",text:`Project not found: ${w}`}],isError:!0};if(!l||l.length===0)return{content:[{type:"text",text:`**Distill**
 
-No candidates provided. Provide an array of candidate artifacts to distill.`}],isError:!0};const a=[];for(const d of m){const l=$.add(w.id,{kind:d.kind,problem:d.title,validatedFix:d.content,tags:d.tags??[],confidence:d.confidence??.7,needsReview:1});a.push({id:l.id,kind:d.kind,title:d.title})}const f={count:a.length,artifacts:a};return S(f,(d,l)=>{let u=E(l.brand,`**Distillation Complete** -- ${d.count} artifact${d.count!==1?"s":""} queued for review`)+`
+No candidates provided. Provide an array of candidate artifacts to distill.`}],isError:!0};const a=[];for(const n of l){const f=x.add(h.id,{kind:n.kind,problem:n.title,validatedFix:n.content,tags:n.tags??[],confidence:n.confidence??.7,needsReview:1});a.push({id:f.id,kind:n.kind,title:n.title})}const g={count:a.length,artifacts:a};return S(g,(n,f)=>{let p=E(f.brand,`**Distillation Complete** -- ${n.count} artifact${n.count!==1?"s":""} queued for review`)+`
 
-`;return u+=d.artifacts.map(b=>`${l.bullet} [#${b.id}] **${b.kind}**: ${b.title}`).join(`
-`),u+="\n\nUse `wyrm_review` with each ID to approve or reject.",u})}},{name:"wyrm_harvest",description:"Auto-populate memory from artifacts you already produce. Walks a project (or ALL registered projects) and harvests durable facts from its docs (README/CLAUDE/AGENTS/ARCHITECTURE) plus recent commit subjects (git log) into the REVIEW QUEUE \u2014 approve/reject with wyrm_review, nothing is auto-trusted. Idempotent (re-runs skip what's already harvested). Use dryRun to preview. The fix for a thin corpus.",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Harvest one project; omit to harvest ALL registered projects"},dryRun:{type:"boolean",description:"Preview what would be harvested without writing anything"},gitLimit:{type:"number",description:"How many recent commits to scan per project (default 30, max 200)"},includeCode:{type:"boolean",description:"Also harvest CODE: tech-stack facts from manifests (package.json/Cargo.toml/\u2026) + TODO/FIXME markers into the review queue, AND index code symbols (functions/classes/types) for search. Heavier \u2014 scope to one project for the full code pass."}}},outputSchema:{type:"object",properties:{dry_run:{type:"boolean"},projects_scanned:{type:"integer"},added:{type:"integer"},skipped:{type:"integer"},top:{type:"array",items:{type:"object",properties:{project:{type:"string"},added:{type:"integer"},skipped:{type:"integer"}},required:["project","added","skipped"]}},sample:{type:"array",items:{type:"string"}},code_symbols:{type:["object","null"],properties:{symbols:{type:"integer"},projects:{type:"integer"},files:{type:"integer"}},required:["symbols","projects","files"]}},required:["dry_run","projects_scanned","added","skipped","top","sample","code_symbols"]},annotations:C.wyrm_harvest,aliases:[],handler:(k,{store:_,raw:$,memory:y,symbols:m,cache:w})=>{const{projectPath:a,dryRun:f,gitLimit:d,includeCode:l}=k,u=$(),b={existsBySig:(s,h)=>!!u.prepare("SELECT 1 FROM memory_artifacts WHERE project_id = ? AND tags LIKE ? ESCAPE '\\' LIMIT 1").get(s,"%"+M(h)+"%"),addCandidate:(s,h)=>{y.add(s,{kind:h.kind,problem:h.text,tags:[...h.tags,h.sig],confidence:h.confidence,needsReview:1,createdBy:"harvest"})}};let i;if(a){const s=_.getProject(a);if(!s)return{content:[{type:"text",text:"Project not found"}],isError:!0};i=[{id:s.id,name:s.name,path:s.path}]}else i=_.getAllProjects(500).map(s=>({id:s.id,name:s.name,path:s.path}));const{reports:t,totalAdded:g,totalSkipped:r}=Z(b,i,{dryRun:f,gitLimit:d,includeCode:l});!f&&g>0&&w.invalidate();let e=null;if(l&&!f){let s=0,h=0,P=0;for(const o of i)try{const x=m.indexProject(o.id,o.path);s+=x.files,h+=x.symbols,P++}catch{}e={symbols:h,projects:P,files:s}}const c=t.filter(s=>s.added>0).sort((s,h)=>h.added-s.added).slice(0,15).map(s=>({project:s.project,added:s.added,skipped:s.skipped})),n=t.flatMap(s=>s.sample??[]).slice(0,6),v={dry_run:!!f,projects_scanned:i.length,added:g,skipped:r,top:c,sample:n,code_symbols:e};return S(v,(s,h)=>{const P=s.code_symbols?`
-Indexed ${s.code_symbols.symbols} code symbols across ${s.code_symbols.projects} project(s) (${s.code_symbols.files} files) -> searchable via wyrm_symbol_search.`:"",o=s.top.map(I=>`  +${String(I.added).padStart(3)} (skip ${I.skipped})  ${I.project}`).join(`
-`),x=s.sample.map(I=>`   ${h.bullet} ${I}`).join(`
-`);return E(h.brand,`Harvest ${s.dry_run?"(dry run) ":""}-- ${s.added} candidate(s) -> review queue across ${s.projects_scanned} project(s); ${s.skipped} already present.`)+`${P}
-${o}`+(x?`
+`;return p+=n.artifacts.map(v=>`${f.bullet} [#${v.id}] **${v.kind}**: ${v.title}`).join(`
+`),p+="\n\nUse `wyrm_review` with each ID to approve or reject.",p})}},{name:"wyrm_harvest",description:"Auto-populate memory from artifacts you already produce. Walks a project (or ALL registered projects) and harvests durable facts from its docs (README/CLAUDE/AGENTS/ARCHITECTURE) plus recent commit subjects (git log) into the REVIEW QUEUE \u2014 approve/reject with wyrm_review, nothing is auto-trusted. Idempotent (re-runs skip what's already harvested). Use dryRun to preview. The fix for a thin corpus.",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Harvest one project; omit to harvest ALL registered projects"},dryRun:{type:"boolean",description:"Preview what would be harvested without writing anything"},gitLimit:{type:"number",description:"How many recent commits to scan per project (default 30, max 200)"},includeCode:{type:"boolean",description:"Also harvest CODE: tech-stack facts from manifests (package.json/Cargo.toml/\u2026) + TODO/FIXME markers into the review queue, AND index code symbols (functions/classes/types) for search. Heavier \u2014 scope to one project for the full code pass."}}},outputSchema:{type:"object",properties:{dry_run:{type:"boolean"},projects_scanned:{type:"integer"},added:{type:"integer"},skipped:{type:"integer"},top:{type:"array",items:{type:"object",properties:{project:{type:"string"},added:{type:"integer"},skipped:{type:"integer"}},required:["project","added","skipped"]}},sample:{type:"array",items:{type:"string"}},code_symbols:{type:["object","null"],properties:{symbols:{type:"integer"},projects:{type:"integer"},files:{type:"integer"}},required:["symbols","projects","files"]}},required:["dry_run","projects_scanned","added","skipped","top","sample","code_symbols"]},annotations:D.wyrm_harvest,aliases:[],handler:($,{store:b,raw:x,memory:w,symbols:l,cache:h})=>{const{projectPath:a,dryRun:g,gitLimit:n,includeCode:f}=$,p=x(),v={existsBySig:(t,_)=>!!p.prepare("SELECT 1 FROM memory_artifacts WHERE project_id = ? AND tags LIKE ? ESCAPE '\\' LIMIT 1").get(t,"%"+M(_)+"%"),addCandidate:(t,_)=>{const m=w.add(t,{kind:_.kind,problem:_.text,tags:[..._.tags,_.sig],confidence:_.confidence,needsReview:1,createdBy:"harvest"});A(p,{tool:"wyrm_harvest",outcome:"queued",refTable:"mem",refId:m.id,reason:"needs_review \u2014 harvested; review to activate",source:"harvest",projectId:t})},onSkip:t=>{A(p,{tool:"wyrm_harvest",outcome:"dropped",reason:"dedup \u2014 signature already harvested",source:"harvest",projectId:t})}};let d;if(a){const t=b.getProject(a);if(!t)return{content:[{type:"text",text:"Project not found"}],isError:!0};d=[{id:t.id,name:t.name,path:t.path}]}else d=b.getAllProjects(500).map(t=>({id:t.id,name:t.name,path:t.path}));const{reports:s,totalAdded:u,totalSkipped:o}=Z(v,d,{dryRun:g,gitLimit:n,includeCode:f});!g&&u>0&&h.invalidate();let e=null;if(f&&!g){let t=0,_=0,m=0;for(const r of d)try{const I=l.indexProject(r.id,r.path);t+=I.files,_+=I.symbols,m++}catch{}e={symbols:_,projects:m,files:t}}const i=s.filter(t=>t.added>0).sort((t,_)=>_.added-t.added).slice(0,15).map(t=>({project:t.project,added:t.added,skipped:t.skipped})),y=s.flatMap(t=>t.sample??[]).slice(0,6),j={dry_run:!!g,projects_scanned:d.length,added:u,skipped:o,top:i,sample:y,code_symbols:e};return S(j,(t,_)=>{const m=t.code_symbols?`
+Indexed ${t.code_symbols.symbols} code symbols across ${t.code_symbols.projects} project(s) (${t.code_symbols.files} files) -> searchable via wyrm_symbol_search.`:"",r=t.top.map(P=>`  +${String(P.added).padStart(3)} (skip ${P.skipped})  ${P.project}`).join(`
+`),I=t.sample.map(P=>`   ${_.bullet} ${P}`).join(`
+`);return E(_.brand,`Harvest ${t.dry_run?"(dry run) ":""}-- ${t.added} candidate(s) -> review queue across ${t.projects_scanned} project(s); ${t.skipped} already present.`)+`${m}
+${r}`+(I?`
 
 Sample:
-${x}`:"")+`
+${I}`:"")+`
 
-Approve/reject with wyrm_review.`})}},{name:"wyrm_import_git",description:"Import a list of commits into the Wyrm memory review queue. Useful for onboarding a project's history or capturing recent work.",inputSchema:{type:"object",properties:{project_id:{type:"number",description:"Project ID"},commits:{type:"array",description:"Array of commit objects",items:{type:"object",properties:{message:{type:"string"},diff_summary:{type:"string"},author:{type:"string"},date:{type:"string"}},required:["message"]}},auto_approve:{type:"boolean",description:"Skip review queue and activate immediately (default: false)"}},required:["project_id","commits"]},outputSchema:{type:"object",properties:{captured:{type:"integer"},skipped:{type:"integer"},auto_approved:{type:"boolean"}},required:["captured","skipped","auto_approved"]},annotations:C.wyrm_import_git,aliases:[],handler:(k,{store:_,memory:$,raw:y})=>{const{project_id:m,commits:w,auto_approve:a}=k;if(!_.getProjectById(m))return{content:[{type:"text",text:`Project ID ${m} not found.`}],isError:!0};let d=0,l=0;const u=y();for(const i of w){const t=i.message??"";if(/^Merge /i.test(t)){l++;continue}if(/^(chore|bump|release|version)/i.test(t)){l++;continue}const g="gi:"+K("sha1").update(`${t}
-${i.diff_summary??""}`).digest("hex").slice(0,16);if(u.prepare("SELECT 1 FROM memory_artifacts WHERE project_id = ? AND tags LIKE ? ESCAPE '\\' LIMIT 1").get(m,"%"+M(g)+"%")){l++,D(u,{tool:"wyrm_import_git",outcome:"dropped",reason:"dedup \u2014 this commit was already imported (gi: signature match)",source:"import:git",projectId:m});continue}let r="pattern";/^fix(\(.+\))?:/i.test(t)?r="lesson":/^feat(\(.+\))?:/i.test(t)?r="pattern":/^refactor(\(.+\))?:/i.test(t)&&(r="heuristic");const e=t.split(":")[0]??"commit",c=$.add(m,{kind:r,problem:t,validatedFix:i.diff_summary??"",whyItWorked:`Committed by ${i.author??"unknown"} on ${i.date??"unknown"}`,tags:["git","commit",e.toLowerCase(),g],confidence:.6,needsReview:a?0:1});D(u,{tool:"wyrm_import_git",outcome:a?"stored":"queued",refTable:"mem",refId:c.id,reason:a?void 0:"needs_review \u2014 imported trust lane; invisible to recall until wyrm_review",source:"import:git",projectId:m}),d++}return S({captured:d,skipped:l,auto_approved:!!a},(i,t)=>E(t.brand,"**Git Import Complete**")+`
+Approve/reject with wyrm_review.`})}},{name:"wyrm_import_git",description:"Import a list of commits into the Wyrm memory review queue. Useful for onboarding a project's history or capturing recent work.",inputSchema:{type:"object",properties:{project_id:{type:"number",description:"Project ID"},commits:{type:"array",description:"Array of commit objects",items:{type:"object",properties:{message:{type:"string"},diff_summary:{type:"string"},author:{type:"string"},date:{type:"string"}},required:["message"]}},auto_approve:{type:"boolean",description:"Skip review queue and activate immediately (default: false)"}},required:["project_id","commits"]},outputSchema:{type:"object",properties:{captured:{type:"integer"},skipped:{type:"integer"},auto_approved:{type:"boolean"}},required:["captured","skipped","auto_approved"]},annotations:D.wyrm_import_git,aliases:[],handler:($,{store:b,memory:x,raw:w})=>{const{project_id:l,commits:h,auto_approve:a}=$;if(!b.getProjectById(l))return{content:[{type:"text",text:`Project ID ${l} not found.`}],isError:!0};let n=0,f=0;const p=w();for(const d of h){const s=d.message??"";if(/^Merge /i.test(s)){f++;continue}if(/^(chore|bump|release|version)/i.test(s)){f++;continue}const u="gi:"+O("sha1").update(`${s}
+${d.diff_summary??""}`).digest("hex").slice(0,16);if(p.prepare("SELECT 1 FROM memory_artifacts WHERE project_id = ? AND tags LIKE ? ESCAPE '\\' LIMIT 1").get(l,"%"+M(u)+"%")){f++,A(p,{tool:"wyrm_import_git",outcome:"dropped",reason:"dedup \u2014 this commit was already imported (gi: signature match)",source:"import:git",projectId:l});continue}let o="pattern";/^fix(\(.+\))?:/i.test(s)?o="lesson":/^feat(\(.+\))?:/i.test(s)?o="pattern":/^refactor(\(.+\))?:/i.test(s)&&(o="heuristic");const e=s.split(":")[0]??"commit",i=x.add(l,{kind:o,problem:s,validatedFix:d.diff_summary??"",whyItWorked:`Committed by ${d.author??"unknown"} on ${d.date??"unknown"}`,tags:["git","commit",e.toLowerCase(),u],confidence:.6,needsReview:a?0:1});A(p,{tool:"wyrm_import_git",outcome:a?"stored":"queued",refTable:"mem",refId:i.id,reason:a?void 0:"needs_review \u2014 imported; review to activate",source:"import:git",projectId:l}),n++}return S({captured:n,skipped:f,auto_approved:!!a},(d,s)=>E(s.brand,"**Git Import Complete**")+`
 
-${t.bullet} **Captured:** ${i.captured}
-${t.bullet} **Skipped:** ${i.skipped} (merges/chores)
-${t.bullet} **Review needed:** ${i.auto_approved?"No (auto-approved)":`Yes -- run \`wyrm_review\` to activate ${i.captured} artifact${i.captured!==1?"s":""}`}`)}},{name:"wyrm_import_pr",description:"Import a pull request (title, body, review comments) into the Wyrm memory review queue to extract patterns and heuristics.",inputSchema:{type:"object",properties:{project_id:{type:"number",description:"Project ID"},title:{type:"string",description:"PR title"},body:{type:"string",description:"PR description / body"},review_comments:{type:"array",items:{type:"string"},description:"Review comment strings"},auto_approve:{type:"boolean",description:"Skip review queue (default: false)"}},required:["project_id","title","body"]},outputSchema:{type:"object",properties:{created:{type:"integer"},auto_approved:{type:"boolean"}},required:["created","auto_approved"]},annotations:C.wyrm_import_pr,aliases:[],handler:(k,{store:_,memory:$})=>{const{project_id:y,title:m,body:w,review_comments:a,auto_approve:f}=k;if(!_.getProjectById(y))return{content:[{type:"text",text:`Project ID ${y} not found.`}],isError:!0};let l=0;const u=f?0:1;$.add(y,{kind:"pattern",problem:`${m}
+${s.bullet} **Captured:** ${d.captured}
+${s.bullet} **Skipped:** ${d.skipped} (merges/chores)
+${s.bullet} **Review needed:** ${d.auto_approved?"No (auto-approved)":`Yes -- run \`wyrm_review\` to activate ${d.captured} artifact${d.captured!==1?"s":""}`}`)}},{name:"wyrm_import_pr",description:"Import a pull request (title, body, review comments) into the Wyrm memory review queue to extract patterns and heuristics.",inputSchema:{type:"object",properties:{project_id:{type:"number",description:"Project ID"},title:{type:"string",description:"PR title"},body:{type:"string",description:"PR description / body"},review_comments:{type:"array",items:{type:"string"},description:"Review comment strings"},auto_approve:{type:"boolean",description:"Skip review queue (default: false)"}},required:["project_id","title","body"]},outputSchema:{type:"object",properties:{created:{type:"integer"},auto_approved:{type:"boolean"}},required:["created","auto_approved"]},annotations:D.wyrm_import_pr,aliases:[],handler:($,{store:b,memory:x,raw:w})=>{const{project_id:l,title:h,body:a,review_comments:g,auto_approve:n}=$;if(!b.getProjectById(l))return{content:[{type:"text",text:`Project ID ${l} not found.`}],isError:!0};let p=0,v=0;const d=n?0:1,s=w(),u=(e,i,y)=>{const j="pr:"+O("sha1").update(i).digest("hex").slice(0,16);if(s.prepare("SELECT 1 FROM memory_artifacts WHERE project_id = ? AND tags LIKE ? ESCAPE '\\' LIMIT 1").get(l,"%"+M(j)+"%")){v++,A(s,{tool:"wyrm_import_pr",outcome:"dropped",reason:"dedup \u2014 already imported (pr: signature)",source:"import:pr",projectId:l});return}const t=x.add(l,{kind:e,problem:i,validatedFix:"",whyItWorked:"",tags:[...y,j],confidence:.65,needsReview:d,createdBy:"import:pr"});A(s,{tool:"wyrm_import_pr",outcome:n?"stored":"queued",refTable:"mem",refId:t.id,reason:n?void 0:"needs_review \u2014 imported; review to activate",source:"import:pr",projectId:l}),p++};u("pattern",`${h}
 
-${w}`,validatedFix:"",whyItWorked:"",tags:["git","pr"],confidence:.65,needsReview:u}),l++;for(const i of a??[])/\b(should|must|always|never|prefer|avoid|use|don't)\b/i.test(i)&&($.add(y,{kind:"heuristic",problem:i,validatedFix:"",whyItWorked:"",tags:["git","pr","review"],confidence:.65,needsReview:u}),l++);return S({created:l,auto_approved:!!f},(i,t)=>E(t.brand,"**PR Import Complete**")+`
+${a}`,["git","pr"]);for(const e of g??[])/\b(should|must|always|never|prefer|avoid|use|don't)\b/i.test(e)&&u("heuristic",e,["git","pr","review"]);return S({created:p,skipped:v,auto_approved:!!n},(e,i)=>E(i.brand,"**PR Import Complete**")+`
 
-${t.bullet} **Artifacts created:** ${i.created}
-${t.bullet} **Review needed:** ${i.auto_approved?"No (auto-approved)":"Yes -- run `wyrm_review` to activate"}`)}},{name:"wyrm_import_rules",description:"Import a .cursorrules / copilot-instructions file into Wyrm. Parses by section and creates ground truths (for constraint/rule language) or memory artifacts (for general guidelines).",inputSchema:{type:"object",properties:{project_id:{type:"number",description:"Project ID"},content:{type:"string",description:"Full text of the rules file"},format:{type:"string",enum:["cursorrules","copilot","plain"],description:"Source format (default: plain)"},source_file:{type:"string",description:"Filename for provenance (optional)"}},required:["project_id","content"]},outputSchema:{type:"object",properties:{format:{type:"string"},source:{type:"string"},truths_created:{type:"integer"},artifacts_created:{type:"integer"}},required:["format","source","truths_created","artifacts_created"]},annotations:C.wyrm_import_rules,aliases:[],handler:(k,{store:_,memory:$,truths:y})=>{const{project_id:m,content:w,format:a,source_file:f}=k;if(!_.getProjectById(m))return{content:[{type:"text",text:`Project ID ${m} not found.`}],isError:!0};const l=a??"plain",u=f??"rules",b=["imported",l,u],i=w.split(/\n(?=#)/),t=w.split(/\n\n+/),g=(i.length>=t.length?i:t).map(n=>n.trim()).filter(n=>n.length>=15);let r=0,e=0;for(const n of g)/\b(always|never|must|use|don't|avoid|prefer)\b/i.test(n)?(y.set(m,{category:"constraint",key:n.slice(0,50).replace(/\n/g," "),value:n,source:u}),r++):($.add(m,{kind:"heuristic",problem:n,validatedFix:"",whyItWorked:"",tags:b,confidence:.7,needsReview:1}),e++);return S({format:l,source:u,truths_created:r,artifacts_created:e},(n,v)=>E(v.brand,`**Rules Import Complete** (${n.format})`)+`
+${i.bullet} **Artifacts created:** ${e.created}
+${i.bullet} **Review needed:** ${e.auto_approved?"No (auto-approved)":"Yes -- run `wyrm_review` to activate"}`)}},{name:"wyrm_import_rules",description:"Import a .cursorrules / copilot-instructions file into Wyrm. Parses by section and creates ground truths (for constraint/rule language) or memory artifacts (for general guidelines).",inputSchema:{type:"object",properties:{project_id:{type:"number",description:"Project ID"},content:{type:"string",description:"Full text of the rules file"},format:{type:"string",enum:["cursorrules","copilot","plain"],description:"Source format (default: plain)"},source_file:{type:"string",description:"Filename for provenance (optional)"}},required:["project_id","content"]},outputSchema:{type:"object",properties:{format:{type:"string"},source:{type:"string"},truths_created:{type:"integer"},artifacts_created:{type:"integer"}},required:["format","source","truths_created","artifacts_created"]},annotations:D.wyrm_import_rules,aliases:[],handler:async($,{store:b,memory:x,truths:w,raw:l})=>{const{project_id:h,content:a,format:g,source_file:n}=$;if(!b.getProjectById(h))return{content:[{type:"text",text:`Project ID ${h} not found.`}],isError:!0};const p=g??"plain",v=n??"rules",d=["imported",p,v],s=a.split(/\n(?=#)/),u=a.split(/\n\n+/),o=(s.length>=u.length?s:u).map(m=>m.trim()).filter(m=>m.length>=15);let e=0,i=0,y=0;const{isConfigShapedTruth:j}=await import("../metabolize.js"),t=l();for(const m of o){const r=m.slice(0,50).replace(/\n/g," ");if(/\b(always|never|must|use|don't|avoid|prefer)\b/i.test(m)&&!j(r,m)){const I=w.set(h,{category:"constraint",key:r,value:m,source:v});A(t,{tool:"wyrm_import_rules",outcome:"stored",refTable:"truth",refId:I.id,source:"import:rules",projectId:h}),e++}else{const I=x.add(h,{kind:"heuristic",problem:m,validatedFix:"",whyItWorked:"",tags:d,confidence:.7,needsReview:1,createdBy:"import:rules"});j(r,m)&&y++,A(t,{tool:"wyrm_import_rules",outcome:"queued",refTable:"mem",refId:I.id,reason:j(r,m)?"truth-shape lint \u2014 config shape routed to review":"needs_review \u2014 imported; review to activate",source:"import:rules",projectId:h}),i++}}return S({format:p,source:v,truths_created:e,artifacts_created:i,linted:y},(m,r)=>E(r.brand,`**Rules Import Complete** (${m.format})`)+`
 
-${v.bullet} **Ground truths created:** ${n.truths_created} (active immediately)
-${v.bullet} **Memory artifacts created:** ${n.artifacts_created} (pending review)
-${v.bullet} **Source:** ${n.source}
+${r.bullet} **Ground truths created:** ${m.truths_created} (active immediately)
+${r.bullet} **Memory artifacts created:** ${m.artifacts_created} (pending review)
+${r.bullet} **Source:** ${m.source}
 
-Run \`wyrm_review\` to approve the memory artifacts.`)}},{name:"wyrm_spec_register",description:"Make spec-kit Wyrm-native. Reads a spec directory (spec.md title/summary + tasks.md task list) and creates one Wyrm quest per task, linked to a project, with a stored spec\u2192project link. Idempotent \u2014 re-running updates the same quests (deduped by a per-spec-task signature) instead of duplicating.",inputSchema:{type:"object",properties:{specDir:{type:"string",description:"Absolute path to the spec directory (e.g. '.../dragon-platform/specs/001-ghostmesh')"},projectPath:{type:"string",description:"Path of the Wyrm project to attach the spec + quests to (must already be registered)"},priority:{type:"string",enum:["critical","high","medium","low"],description:"Priority for the generated quests (default 'medium')"}},required:["specDir","projectPath"]},outputSchema:{type:"object",properties:{spec_dir:{type:"string"},title:{type:["string","null"]},project:{type:"string"},tasks_parsed:{type:"integer"},quests_created:{type:"integer"},quests_updated:{type:"integer"},quest_ids:{type:"array",items:{type:"integer"}}},required:["spec_dir","title","project","tasks_parsed","quests_created","quests_updated","quest_ids"]},annotations:C.wyrm_spec_register,aliases:[],handler:(k,{store:_,indexing:$})=>{const{specDir:y,projectPath:m,priority:w}=k,a=["specDir","projectPath"].filter(r=>{const e=k[r];return!e&&e!==0&&e!==!1});if(a.length>0)return{content:[{type:"text",text:`Missing required arguments: ${a.join(", ")}`}],isError:!0};const f=_.getProject(m);if(!f)return{content:[{type:"text",text:`**Spec Register**: Project not found at "${m}". Register it first (wyrm_scan_projects / wyrm_session_start).`}],isError:!0};const d=re(y);if(d.tasks.length===0){const r={spec_dir:y,title:d.title??null,project:f.name,tasks_parsed:0,quests_created:0,quests_updated:0,quest_ids:[]};return S(r,(e,c)=>E(c.brand,`**Spec Register**: No tasks found in ${B(e.spec_dir,"tasks.md")}. Nothing to create.`))}const l=w||"medium";let u=0,b=0;const i=[];for(const r of d.tasks){const e=ie(y,r.id),c=`${r.id}: ${r.title}`,n=e,v=_.findQuestBySpecSignature(f.id,e);if(v)_.updateQuestFields(v.id,{title:c,tags:n}),i.push(v.id),b++;else{const s=_.addQuest(f.id,c,`spec-kit task from ${y}`,l,n);$()?.enqueue("quest",s.id,f.id),i.push(s.id),u++}}const t=_.upsertSpec(f.id,y,d.title,d.summary,d.tasks.length),g={spec_dir:t.spec_dir,title:t.title??null,project:f.name,tasks_parsed:d.tasks.length,quests_created:u,quests_updated:b,quest_ids:i};return S(g,(r,e)=>{let c=E(e.brand,"**Spec Registered**")+`
+Run \`wyrm_review\` to approve the memory artifacts.`)}},{name:"wyrm_spec_register",description:"Make spec-kit Wyrm-native. Reads a spec directory (spec.md title/summary + tasks.md task list) and creates one Wyrm quest per task, linked to a project, with a stored spec\u2192project link. Idempotent \u2014 re-running updates the same quests (deduped by a per-spec-task signature) instead of duplicating.",inputSchema:{type:"object",properties:{specDir:{type:"string",description:"Absolute path to the spec directory (e.g. '.../dragon-platform/specs/001-ghostmesh')"},projectPath:{type:"string",description:"Path of the Wyrm project to attach the spec + quests to (must already be registered)"},priority:{type:"string",enum:["critical","high","medium","low"],description:"Priority for the generated quests (default 'medium')"}},required:["specDir","projectPath"]},outputSchema:{type:"object",properties:{spec_dir:{type:"string"},title:{type:["string","null"]},project:{type:"string"},tasks_parsed:{type:"integer"},quests_created:{type:"integer"},quests_updated:{type:"integer"},quest_ids:{type:"array",items:{type:"integer"}}},required:["spec_dir","title","project","tasks_parsed","quests_created","quests_updated","quest_ids"]},annotations:D.wyrm_spec_register,aliases:[],handler:($,{store:b,indexing:x})=>{const{specDir:w,projectPath:l,priority:h}=$,a=["specDir","projectPath"].filter(o=>{const e=$[o];return!e&&e!==0&&e!==!1});if(a.length>0)return{content:[{type:"text",text:`Missing required arguments: ${a.join(", ")}`}],isError:!0};const g=b.getProject(l);if(!g)return{content:[{type:"text",text:`**Spec Register**: Project not found at "${l}". Register it first (wyrm_scan_projects / wyrm_session_start).`}],isError:!0};const n=re(w);if(n.tasks.length===0){const o={spec_dir:w,title:n.title??null,project:g.name,tasks_parsed:0,quests_created:0,quests_updated:0,quest_ids:[]};return S(o,(e,i)=>E(i.brand,`**Spec Register**: No tasks found in ${K(e.spec_dir,"tasks.md")}. Nothing to create.`))}const f=h||"medium";let p=0,v=0;const d=[];for(const o of n.tasks){const e=ie(w,o.id),i=`${o.id}: ${o.title}`,y=e,j=b.findQuestBySpecSignature(g.id,e);if(j)b.updateQuestFields(j.id,{title:i,tags:y}),d.push(j.id),v++;else{const t=b.addQuest(g.id,i,`spec-kit task from ${w}`,f,y);x()?.enqueue("quest",t.id,g.id),d.push(t.id),p++}}const s=b.upsertSpec(g.id,w,n.title,n.summary,n.tasks.length),u={spec_dir:s.spec_dir,title:s.title??null,project:g.name,tasks_parsed:n.tasks.length,quests_created:p,quests_updated:v,quest_ids:d};return S(u,(o,e)=>{let i=E(e.brand,"**Spec Registered**")+`
 
-`;return c+=`Spec: ${r.title||"(untitled)"}
-`,t.summary&&(c+=`Summary: ${t.summary}
-`),c+=`Dir: ${r.spec_dir}
-`,c+=`Project: ${r.project}
-`,c+=`Tasks parsed: ${r.tasks_parsed}
-`,c+=`Quests created: ${r.quests_created} - updated: ${r.quests_updated}
-`,c+=`
+`;return i+=`Spec: ${o.title||"(untitled)"}
+`,s.summary&&(i+=`Summary: ${s.summary}
+`),i+=`Dir: ${o.spec_dir}
+`,i+=`Project: ${o.project}
+`,i+=`Tasks parsed: ${o.tasks_parsed}
+`,i+=`Quests created: ${o.quests_created} - updated: ${o.quests_updated}
+`,i+=`
 \`\`\`json
-${JSON.stringify({spec:r.spec_dir,title:r.title,project:r.project,tasksParsed:r.tasks_parsed,questsCreated:r.quests_created,questsUpdated:r.quests_updated,questIds:r.quest_ids},null,2)}
-\`\`\``,c})}},{name:"wyrm_scaffold_save",description:"Save a reasoning scaffold \u2014 a structured checklist that guides step-by-step thinking for a specific problem type. Scaffolds are automatically surfaced by wyrm_context_build when the task matches, helping AI models apply proven reasoning patterns.",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project path (optional, null for global scaffolds)"},problemType:{type:"string",description:"Short slug for the problem type (e.g. 'api-design', 'security-review', 'db-migration')"},description:{type:"string",description:"What kind of task this scaffold helps with"},whenToUse:{type:"string",description:"Conditions that indicate this scaffold should be applied"},steps:{type:"array",items:{type:"string"},description:"Ordered checklist steps to follow"},verificationSteps:{type:"array",items:{type:"string"},description:"Steps to verify the work is correct"},doNotApplyIf:{type:"string",description:"Conditions where this scaffold does NOT apply"},tags:{type:"array",items:{type:"string"},description:"Searchable tags"}},required:["problemType","description","whenToUse","steps"]},outputSchema:{type:"object",properties:{id:{type:"integer"},problem_type:{type:"string"},description:{type:"string"},steps:{type:"integer"}},required:["id","problem_type","description","steps"]},annotations:C.wyrm_scaffold_save,aliases:[],handler:(k,{store:_,scaffolds:$,cache:y})=>{const{projectPath:m,problemType:w,description:a,whenToUse:f,steps:d,verificationSteps:l,doNotApplyIf:u,tags:b}=k,i=m?_.getProject(m)?.id??void 0:void 0,t=$.save({projectId:i,problemType:w,description:a,whenToUse:f,steps:d,verificationSteps:l??void 0,doNotApplyIf:u?[u]:void 0,tags:b??[]});y.invalidate("wyrm_scaffold_get"),y.invalidate("wyrm_context_build");const g={id:t.id,problem_type:w,description:a,steps:d.length};return S(g,(r,e)=>E(e.brand,"**Reasoning Scaffold Saved**")+`
+${JSON.stringify({spec:o.spec_dir,title:o.title,project:o.project,tasksParsed:o.tasks_parsed,questsCreated:o.quests_created,questsUpdated:o.quests_updated,questIds:o.quest_ids},null,2)}
+\`\`\``,i})}},{name:"wyrm_scaffold_save",description:"Save a reasoning scaffold \u2014 a structured checklist that guides step-by-step thinking for a specific problem type. Scaffolds are automatically surfaced by wyrm_context_build when the task matches, helping AI models apply proven reasoning patterns.",inputSchema:{type:"object",properties:{projectPath:{type:"string",description:"Project path (optional, null for global scaffolds)"},problemType:{type:"string",description:"Short slug for the problem type (e.g. 'api-design', 'security-review', 'db-migration')"},description:{type:"string",description:"What kind of task this scaffold helps with"},whenToUse:{type:"string",description:"Conditions that indicate this scaffold should be applied"},steps:{type:"array",items:{type:"string"},description:"Ordered checklist steps to follow"},verificationSteps:{type:"array",items:{type:"string"},description:"Steps to verify the work is correct"},doNotApplyIf:{type:"string",description:"Conditions where this scaffold does NOT apply"},tags:{type:"array",items:{type:"string"},description:"Searchable tags"}},required:["problemType","description","whenToUse","steps"]},outputSchema:{type:"object",properties:{id:{type:"integer"},problem_type:{type:"string"},description:{type:"string"},steps:{type:"integer"}},required:["id","problem_type","description","steps"]},annotations:D.wyrm_scaffold_save,aliases:[],handler:($,{store:b,scaffolds:x,cache:w})=>{const{projectPath:l,problemType:h,description:a,whenToUse:g,steps:n,verificationSteps:f,doNotApplyIf:p,tags:v}=$,d=l?b.getProject(l)?.id??void 0:void 0,s=x.save({projectId:d,problemType:h,description:a,whenToUse:g,steps:n,verificationSteps:f??void 0,doNotApplyIf:p?[p]:void 0,tags:v??[]});w.invalidate("wyrm_scaffold_get"),w.invalidate("wyrm_context_build");const u={id:s.id,problem_type:h,description:a,steps:n.length};return S(u,(o,e)=>E(e.brand,"**Reasoning Scaffold Saved**")+`
 
-${e.bullet} **Problem Type:** ${r.problem_type}
-${e.bullet} **Description:** ${r.description}
-${e.bullet} **Steps:** ${r.steps} checklist items
-${e.bullet} **ID:** ${r.id}
+${e.bullet} **Problem Type:** ${o.problem_type}
+${e.bullet} **Description:** ${o.description}
+${e.bullet} **Steps:** ${o.steps} checklist items
+${e.bullet} **ID:** ${o.id}
 
-This scaffold will be surfaced by \`wyrm_context_build\` when tasks match "${r.problem_type}".`)}}];export{ve as captureToolSpecs};
+This scaffold will be surfaced by \`wyrm_context_build\` when tasks match "${o.problem_type}".`)}}];export{ve as captureToolSpecs};