@vpxa/aikit 0.1.209 → 0.1.211

package/packages/tools/package.json

@@ -17,6 +17,11 @@
     "test": "vitest run"
   },
   "dependencies": {
+    "@aikit/analyzers": "workspace:*",
+    "@aikit/chunker": "workspace:*",
+    "@aikit/core": "workspace:*",
+    "@aikit/embeddings": "workspace:*",
+    "@aikit/store": "workspace:*",
     "diff": "^9.x",
     "gpt-tokenizer": "^3.x",
     "linkedom": "^0.x",
@@ -24,11 +29,6 @@
     "turndown": "^7.x"
   },
   "devDependencies": {
-    "@aikit/analyzers": "workspace:*",
-    "@aikit/chunker": "workspace:*",
-    "@aikit/core": "workspace:*",
-    "@aikit/embeddings": "workspace:*",
-    "@aikit/store": "workspace:*",
     "@types/turndown": "^5.x"
   }
 }

package/scaffold/dist/adapters/claude-code.mjs

@@ -1,11 +1,11 @@
-import{AGENTS as e}from"../definitions/agents.mjs";import{AGENT_BODIES as t}from"../definitions/bodies.mjs";import{HOOKS as n}from"../definitions/hooks.mjs";import{MCP_SERVER_ENTRY as r,SERVER_NAME as i}from"../definitions/mcp.mjs";import{CLAUDE_MODELS as a}from"../definitions/models.mjs";import{PROMPTS as o}from"../definitions/prompts.mjs";import{PROTOCOLS as s}from"../definitions/protocols.mjs";import{AIKIT_TOOLS as c,CLAUDE_CODE_TOOL_MAP as l,IDE_CAPABILITIES as u}from"../definitions/tools.mjs";import{buildAgentTable as d,buildCompactAgentTable as f,buildHooksSection as p,buildMcpConfigJson as m,buildSkillsSection as h,lowerFirst as g}from"./_shared.mjs";const _=[`## Flows`,``,"This project uses aikit's pluggable flow system. Check flow status with the `flow` MCP tool.","If a flow is active, follow the current step's skill instructions. Advance with `flow({ action: 'step', advance: 'next' })`.","Use `flow({ action: 'list' })` to see available flows and `flow({ action: 'start', name, topic })` to begin one."].join(`
-`),v=[`## Flows`,``,"This project uses aikit's pluggable flow system. Check flow status with the `flow` MCP tool.","If a flow is active, follow the current step's skill instructions. Advance with `flow({ action: 'step', advance: 'next' })`.","Use `flow({ action: 'list' })` to see available flows and `flow({ action: 'start', name, topic })` to begin one."].join(`
-`),y=[`## Flows`,``,"This project uses aikit's pluggable flow system. Use `flow({ action: 'status' })` to check if a flow is active.",`If dispatched as part of a flow, your work contributes to the current step. Do NOT advance or manage the flow — the Orchestrator handles flow lifecycle.`].join(`
-`);function b(e){return e.replace(/([a-z0-9])([A-Z])/g,`$1-$2`).replace(/[^a-zA-Z0-9]+/g,`-`).replace(/^-+|-+$/g,``).toLowerCase()}function x(e){return`"${String(e).replace(/\\/g,`\\\\`).replace(/"/g,`\\"`)}"`}function S(e){let t=(u[e]||[]).flatMap(e=>l[e]||[]),n=c.map(e=>`mcp__aikit__${e}`);return[...new Set([...t,...n])].sort((e,t)=>e.localeCompare(t))}function C(e,t){let n=[];return n.push(`# aikit ${e}`),n.push(``),t.description&&(n.push(`> ${t.description}`),n.push(``)),n.push(t.content.trim()),n.push(``),n.join(`
-`)}function w(e,n){let r=t[e];return typeof r==`function`?r(n):r||``}function T(e){let t=[];e.extraBody&&t.push(e.extraBody),e.sharedBase&&s[e.sharedBase]&&t.push(s[e.sharedBase]);for(let n of e.sharedProtocols||[])s[n]&&t.push(s[n]);return t}function E(){let t=[];for(let[n,r]of Object.entries(e)){if(r.variants){for(let[e,i]of Object.entries(r.variants))t.push({name:`${n}-${e}`,description:i.description||r.description});continue}t.push({name:n,description:r.description})}return t}function D(e){return E().map(({name:t,description:n})=>`- \`${e}/${t}.md\` — ${n}`).join(`
-`)}function O(t=d(e,a)){return[`# aikit — Claude Code Agents`,``,"This workspace keeps the root `CLAUDE.md` intentionally small. Full agent instructions are split into per-agent files under `.claude/agents/`.",``,`## MCP Server`,``,"Server name: `aikit`","Configured in `.mcp.json` (already done if scaffold was deployed).",``,`## Agents`,``,t,``,`## Agent Files`,``,D(`.claude/agents`),``,`## Commands`,``,"Slash commands live under `.claude/commands/`.",``,`## Session Protocol`,``,p(n),``].join(`
-`)}function k(){return[`# aikit — Claude Code Instructions`,``,"Detailed workspace instructions live in `AGENTS.md`.","Full sub-agent instructions live in `.claude/agents/`.","Slash commands live in `.claude/commands/`.","MCP server config lives in `.mcp.json`.",``,"Start with `AGENTS.md`, then open the specific sub-agent file you want to use.",``].join(`
-`)}function A(e,t,n,r){let i=S(t.toolRole),a=T(t),o=h(t.skills),s=e===`Orchestrator`?[_,v]:[y],c=[n,...a,t.bodyAddendum,o,...s].filter(Boolean).join(`
+import{AGENTS as e}from"../definitions/agents.mjs";import{AGENT_BODIES as t}from"../definitions/bodies.mjs";import{HOOKS as n}from"../definitions/hooks.mjs";import{MCP_SERVER_ENTRY as r,SERVER_NAME as i}from"../definitions/mcp.mjs";import{CLAUDE_MODELS as a}from"../definitions/models.mjs";import{PROMPTS as o}from"../definitions/prompts.mjs";import{PROTOCOLS as s}from"../definitions/protocols.mjs";import{AIKIT_TOOLS as c,CLAUDE_CODE_TOOL_MAP as l,IDE_CAPABILITIES as u}from"../definitions/tools.mjs";import{buildAgentTable as d,buildCompactAgentTable as f,buildHooksSection as p,buildMcpConfigJson as m,buildSkillsSection as h,lowerFirst as g}from"./_shared.mjs";import{generateHooks as _}from"./hooks.mjs";const v=[`## Flows`,``,"This project uses aikit's pluggable flow system. Check flow status with the `flow` MCP tool.","If a flow is active, follow the current step's skill instructions. Advance with `flow({ action: 'step', advance: 'next' })`.","Use `flow({ action: 'list' })` to see available flows and `flow({ action: 'start', name, topic })` to begin one."].join(`
+`),y=[`## Flows`,``,"This project uses aikit's pluggable flow system. Check flow status with the `flow` MCP tool.","If a flow is active, follow the current step's skill instructions. Advance with `flow({ action: 'step', advance: 'next' })`.","Use `flow({ action: 'list' })` to see available flows and `flow({ action: 'start', name, topic })` to begin one."].join(`
+`),b=[`## Flows`,``,"This project uses aikit's pluggable flow system. Use `flow({ action: 'status' })` to check if a flow is active.",`If dispatched as part of a flow, your work contributes to the current step. Do NOT advance or manage the flow — the Orchestrator handles flow lifecycle.`].join(`
+`);function x(e){return e.replace(/([a-z0-9])([A-Z])/g,`$1-$2`).replace(/[^a-zA-Z0-9]+/g,`-`).replace(/^-+|-+$/g,``).toLowerCase()}function S(e){return`"${String(e).replace(/\\/g,`\\\\`).replace(/"/g,`\\"`)}"`}function C(e){let t=(u[e]||[]).flatMap(e=>l[e]||[]),n=c.map(e=>`mcp__aikit__${e}`);return[...new Set([...t,...n])].sort((e,t)=>e.localeCompare(t))}function w(e,t){let n=[];return n.push(`# aikit ${e}`),n.push(``),t.description&&(n.push(`> ${t.description}`),n.push(``)),n.push(t.content.trim()),n.push(``),n.join(`
+`)}function T(e,n){let r=t[e];return typeof r==`function`?r(n):r||``}function E(e){let t=[];e.extraBody&&t.push(e.extraBody),e.sharedBase&&s[e.sharedBase]&&t.push(s[e.sharedBase]);for(let n of e.sharedProtocols||[])s[n]&&t.push(s[n]);return t}function D(){let t=[];for(let[n,r]of Object.entries(e)){if(r.variants){for(let[e,i]of Object.entries(r.variants))t.push({name:`${n}-${e}`,description:i.description||r.description});continue}t.push({name:n,description:r.description})}return t}function O(e){return D().map(({name:t,description:n})=>`- \`${e}/${t}.md\` — ${n}`).join(`
+`)}function k(t=d(e,a)){return[`# aikit — Claude Code Agents`,``,"This workspace keeps the root `CLAUDE.md` intentionally small. Full agent instructions are split into per-agent files under `.claude/agents/`.",``,`## MCP Server`,``,"Server name: `aikit`","Configured in `.mcp.json` (already done if scaffold was deployed).",``,`## Agents`,``,t,``,`## Agent Files`,``,O(`.claude/agents`),``,`## Commands`,``,"Slash commands live under `.claude/commands/`.",``,`## Session Protocol`,``,p(n),``].join(`
+`)}function A(){return[`# aikit — Claude Code Instructions`,``,"Detailed workspace instructions live in `AGENTS.md`.","Full sub-agent instructions live in `.claude/agents/`.","Slash commands live in `.claude/commands/`.","MCP server config lives in `.mcp.json`.",``,"Start with `AGENTS.md`, then open the specific sub-agent file you want to use.",``].join(`
+`)}function j(e,t,n,r){let i=C(t.toolRole),a=E(t),o=h(t.skills),s=e===`Orchestrator`?[v,y]:[b],c=[n,...a,t.bodyAddendum,o,...s].filter(Boolean).join(`
 
-`).trim(),l=t.identity?`You are the **${e}**${t.identity}`:`You are the **${e}**, ${g(t.description)}.`,u=[`---`,`name: ${b(e)}`,`description: ${x(t.description)}`,`allowedTools:`,...i.map(e=>`  - ${e}`),`---`,``,`# ${e} - ${t.title||e}`,``,l];return c&&u.push(``,c),u.push(``),u.join(`
-`)}function j(){let t=[],n=d(e,a),s=f(e);t.push({path:`.mcp.json`,content:`${m({serverName:i,mcpEntry:r,configKey:`mcpServers`})}\n`}),t.push({path:`CLAUDE.md`,content:k()}),t.push({path:`AGENTS.md`,content:O(n)});for(let[e,n]of Object.entries(o))t.push({path:`.claude/commands/aikit-${e}.md`,content:C(e,n)});for(let[r,i]of Object.entries(e)){let e=w(r,s);if(i.variants){for(let[a,o]of Object.entries(i.variants)){let s=`${r}-${a}`;t.push({path:`.claude/agents/${s}.md`,content:A(s,{...i,description:o.description||i.description,identity:o.identity,bodyAddendum:o.bodyAddendum},e,n)})}continue}t.push({path:`.claude/agents/${r}.md`,content:A(r,i,e,n)})}return t}export{_ as CLAUDE_FLOWS_SECTION,v as CLAUDE_ORCHESTRATOR_FLOW_ROUTING_SECTION,j as generateClaudeCode};
+`).trim(),l=t.identity?`You are the **${e}**${t.identity}`:`You are the **${e}**, ${g(t.description)}.`,u=[`---`,`name: ${x(e)}`,`description: ${S(t.description)}`,`allowedTools:`,...i.map(e=>`  - ${e}`),`---`,``,`# ${e} - ${t.title||e}`,``,l];return c&&u.push(``,c),u.push(``),u.join(`
+`)}function M(){let t=[],n=d(e,a),s=f(e);t.push({path:`.mcp.json`,content:`${m({serverName:i,mcpEntry:r,configKey:`mcpServers`})}\n`}),t.push({path:`CLAUDE.md`,content:A()}),t.push({path:`AGENTS.md`,content:k(n)});let c=_(`claude`,`~/.copilot/hooks/scripts`);t.push(...c.map(e=>({path:e.path,content:e.content})));for(let[e,n]of Object.entries(o))t.push({path:`.claude/commands/aikit-${e}.md`,content:w(e,n)});for(let[r,i]of Object.entries(e)){let e=T(r,s);if(i.variants){for(let[a,o]of Object.entries(i.variants)){let s=`${r}-${a}`;t.push({path:`.claude/agents/${s}.md`,content:j(s,{...i,description:o.description||i.description,identity:o.identity,bodyAddendum:o.bodyAddendum},e,n)})}continue}t.push({path:`.claude/agents/${r}.md`,content:j(r,i,e,n)})}return t}export{v as CLAUDE_FLOWS_SECTION,y as CLAUDE_ORCHESTRATOR_FLOW_ROUTING_SECTION,M as generateClaudeCode};

package/scaffold/dist/adapters/copilot.mjs

@@ -1,46 +1,46 @@
-import{AGENTS as e}from"../definitions/agents.mjs";import{AGENT_BODIES as t}from"../definitions/bodies.mjs";import{COPILOT_MODELS as n,VARIANT_GROUPS as r}from"../definitions/models.mjs";import{PROMPTS as i}from"../definitions/prompts.mjs";import{PROTOCOLS as a,TEMPLATES as o}from"../definitions/protocols.mjs";import{IDE_CAPABILITIES as s}from"../definitions/tools.mjs";import{buildCompactAgentTable as c}from"./_shared.mjs";const l={terminal:`execute/runInTerminal`,problems:`read/problems`,readFile:`read/readFile`,lastCommand:`read/terminalLastCommand`,subagent:`agent/runSubagent`,createFile:`edit/createFile`,editFiles:`edit/editFiles`,rename:`edit/rename`,createDirectory:`edit/createDirectory`,search:`search/changes, search/codebase, search/usages`,web:`web/fetch, web/githubRepo`,todo:`todo`,memory:`vscode/memory`,newWorkspace:`vscode/newWorkspace`,reviewPlan:`vscode/reviewPlan`,askQuestions:`vscode/askQuestions`,resolveMemoryFileUri:`vscode/resolveMemoryFileUri`,runCommand:`vscode/runCommand`,switchAgent:`vscode/switchAgent`,killTerminal:`execute/killTerminal`,createTask:`execute/createAndRunTask`,terminalSel:`read/terminalSelection`,fileSearch:`search/fileSearch`,listDir:`search/listDirectory`,textSearch:`search/textSearch`,searchSubagent:`search/searchSubagent`};function u(e){return`[${[...(s[e]||[]).map(e=>l[e]).filter(Boolean),`aikit/*`].join(`, `)}]`}function d(e){let t=n[e];return t?Array.isArray(t)?t[0]||`Auto (copilot)`:t:`Auto (copilot)`}const f=[`## Flows`,``,"This project uses aikit's pluggable flow system. Check flow status with the `flow` MCP tool.","If a flow is active, follow the current step's skill instructions. Advance with `flow({ action: 'step', advance: 'next' })`.","Use `flow({ action: 'list' })` to see available flows and `flow({ action: 'start', name, topic })` to begin one."].join(`
-`),p=[`## Flows`,``,"This project uses aikit's pluggable flow system. Use `flow({ action: 'status' })` to check if a flow is active.",`If dispatched as part of a flow, your work contributes to the current step. Do NOT advance or manage the flow — the Orchestrator handles flow lifecycle.`].join(`
-`);function m(){let t=[];for(let[i,a]of Object.entries(e))if(a.variants)for(let e of r[i]||[]){let r=`${i}-${e}`,o=n[r]||n[i],s=Array.isArray(o)?o[0]:o||`Unknown`,c=(a.variants[e]||{}).description||a.description;t.push(`| **${r}** | ${c} | ${s} | ${a.category} |`)}else{let e=n[i],r=Array.isArray(e)?e[0]:e||`Unknown`;t.push(`| **${i}** | ${a.description} | ${r} | ${a.category} |`)}return`| Agent | Purpose | Model | Category |\n|-------|---------|-------|----------|\n${t.join(`
-`)}`}function h(e,t,n){let i=`${e}-${t}`,o=n.variants[t]||{},s=d(i),c=o.description||n.description,l=o.identity||(t===r[e]?.[0]?`, the primary ${e} agent.`:`, a variant of ${e}. Same responsibilities, different model perspective.`),f=n.sharedBase&&a[n.sharedBase]?`\n\n${a[n.sharedBase]}`:``,m=n.extraBody?`\n\n${n.extraBody}`:``,h=o.bodyAddendum?`\n\n${o.bodyAddendum}`:``,g=n.skills?.length?`\n\n## Skills (load on demand)\n\n| Skill | When to load |\n|-------|--------------|\n${n.skills.map(([e,t])=>`| ${e} | ${t} |`).join(`
+import{AGENTS as e}from"../definitions/agents.mjs";import{AGENT_BODIES as t}from"../definitions/bodies.mjs";import{COPILOT_MODELS as n,VARIANT_GROUPS as r}from"../definitions/models.mjs";import{PROMPTS as i}from"../definitions/prompts.mjs";import{PROTOCOLS as a,TEMPLATES as o}from"../definitions/protocols.mjs";import{IDE_CAPABILITIES as s}from"../definitions/tools.mjs";import{buildCompactAgentTable as c}from"./_shared.mjs";import{generateHooks as l,getHookScriptFiles as u}from"./hooks.mjs";const d={terminal:`execute/runInTerminal`,problems:`read/problems`,readFile:`read/readFile`,lastCommand:`read/terminalLastCommand`,subagent:`agent/runSubagent`,createFile:`edit/createFile`,editFiles:`edit/editFiles`,rename:`edit/rename`,createDirectory:`edit/createDirectory`,search:`search/changes, search/codebase, search/usages`,web:`web/fetch, web/githubRepo`,todo:`todo`,memory:`vscode/memory`,newWorkspace:`vscode/newWorkspace`,reviewPlan:`vscode/reviewPlan`,askQuestions:`vscode/askQuestions`,resolveMemoryFileUri:`vscode/resolveMemoryFileUri`,runCommand:`vscode/runCommand`,switchAgent:`vscode/switchAgent`,killTerminal:`execute/killTerminal`,createTask:`execute/createAndRunTask`,terminalSel:`read/terminalSelection`,fileSearch:`search/fileSearch`,listDir:`search/listDirectory`,textSearch:`search/textSearch`,searchSubagent:`search/searchSubagent`};function f(e){return`[${[...(s[e]||[]).map(e=>d[e]).filter(Boolean),`aikit/*`].join(`, `)}]`}function p(e){let t=n[e];return t?Array.isArray(t)?t[0]||`Auto (copilot)`:t:`Auto (copilot)`}const m=[`## Flows`,``,"This project uses aikit's pluggable flow system. Check flow status with the `flow` MCP tool.","If a flow is active, follow the current step's skill instructions. Advance with `flow({ action: 'step', advance: 'next' })`.","Use `flow({ action: 'list' })` to see available flows and `flow({ action: 'start', name, topic })` to begin one."].join(`
+`),h=[`## Flows`,``,"This project uses aikit's pluggable flow system. Use `flow({ action: 'status' })` to check if a flow is active.",`If dispatched as part of a flow, your work contributes to the current step. Do NOT advance or manage the flow — the Orchestrator handles flow lifecycle.`].join(`
+`);function g(){let t=[];for(let[i,a]of Object.entries(e))if(a.variants)for(let e of r[i]||[]){let r=`${i}-${e}`,o=n[r]||n[i],s=Array.isArray(o)?o[0]:o||`Unknown`,c=(a.variants[e]||{}).description||a.description;t.push(`| **${r}** | ${c} | ${s} | ${a.category} |`)}else{let e=n[i],r=Array.isArray(e)?e[0]:e||`Unknown`;t.push(`| **${i}** | ${a.description} | ${r} | ${a.category} |`)}return`| Agent | Purpose | Model | Category |\n|-------|---------|-------|----------|\n${t.join(`
+`)}`}function _(e,t,n){let i=`${e}-${t}`,o=n.variants[t]||{},s=p(i),c=o.description||n.description,l=o.identity||(t===r[e]?.[0]?`, the primary ${e} agent.`:`, a variant of ${e}. Same responsibilities, different model perspective.`),u=n.sharedBase&&a[n.sharedBase]?`\n\n${a[n.sharedBase]}`:``,d=n.extraBody?`\n\n${n.extraBody}`:``,m=o.bodyAddendum?`\n\n${o.bodyAddendum}`:``,g=n.skills?.length?`\n\n## Skills (load on demand)\n\n| Skill | When to load |\n|-------|--------------|\n${n.skills.map(([e,t])=>`| ${e} | ${t} |`).join(`
 `)}`:``,_=n.title||e;return`---
 description: '${c}'
-${n.argumentHint?`argument-hint: "${n.argumentHint}"\n`:``}tools: ${u(n.toolRole)}
+${n.argumentHint?`argument-hint: "${n.argumentHint}"\n`:``}tools: ${f(n.toolRole)}
 model: ${s}
 ---
 
 # ${i} - ${_}
 
-You are **${i}**${l}${m}
-${f}${h}${g}
+You are **${i}**${l}${d}
+${u}${m}${g}
 
-${p}
-`}function g(n,r){let i=d(n),o=typeof t[n]==`function`?t[n](c(e)):t[n]||``,s=r.sharedBase&&a[r.sharedBase]?`\n\n${a[r.sharedBase]}`:``,l=(r.sharedProtocols||[]).map(e=>a[e]?`\n\n${a[e]}`:``).join(``),m=r.title||n,h=r.skills?.length?`\n## Skills (load on demand)\n\n| Skill | When to load |\n|-------|--------------|\n${r.skills.map(([e,t])=>`| ${e} | ${t} |`).join(`
+${h}
+`}function v(n,r){let i=p(n),o=typeof t[n]==`function`?t[n](c(e)):t[n]||``,s=r.sharedBase&&a[r.sharedBase]?`\n\n${a[r.sharedBase]}`:``,l=(r.sharedProtocols||[]).map(e=>a[e]?`\n\n${a[e]}`:``).join(``),u=r.title||n,d=r.skills?.length?`\n## Skills (load on demand)\n\n| Skill | When to load |\n|-------|--------------|\n${r.skills.map(([e,t])=>`| ${e} | ${t} |`).join(`
 `)}\n`:``;return`---
 description: '${r.description}'
-${r.argumentHint?`argument-hint: "${r.argumentHint}"\n`:``}tools: ${u(r.toolRole)}
+${r.argumentHint?`argument-hint: "${r.argumentHint}"\n`:``}tools: ${f(r.toolRole)}
 model: ${i}
 ---
 
-# ${n} - ${m}
+# ${n} - ${u}
 
 You are the **${n}**, ${r.description.toLowerCase().replace(/^./,e=>e.toLowerCase())}
 
-${o}${s}${l}${h}
+${o}${s}${l}${d}
 
-${n===`Orchestrator`?f:p}
-`}function _(e,t){return`---
+${n===`Orchestrator`?m:h}
+`}function y(e,t){return`---
 description: "${t.description}"
 agent: "${t.agent}"
 ---
 
 ${t.content}
-`}function v(){return`# Agents
+`}function b(){return`# Agents
 
 This directory contains AI agent definitions generated by \`@vpxa/aikit init\`.
 
 ## Agent Roster
 
-${m()}
+${g()}
 
 ## Multi-Model Pattern
 
@@ -73,4 +73,4 @@ To regenerate after changing models or agent definitions:
 cd knowledge-base
 node scaffold/generate.mjs
 \`\`\`
-`}function y(){let t=[];for(let[n,i]of Object.entries(e))if(i.variants)for(let e of r[n]||[])t.push({path:`agents/${n}-${e}.agent.md`,content:h(n,e,i)});else t.push({path:`agents/${n}.agent.md`,content:g(n,i)});for(let[e,n]of Object.entries(a))t.push({path:`agents/_shared/${e}.md`,content:`${n}\n`});for(let[e,n]of Object.entries(o))t.push({path:`agents/templates/${e}.md`,content:`${n}\n`});t.push({path:`agents/README.md`,content:v()});for(let[e,n]of Object.entries(i))t.push({path:`prompts/aikit-${e}.prompt.md`,content:_(e,n)});return t}export{y as generateCopilot};
+`}function x(){let t=[];if(u().length===0)throw Error(`Executable hooks are not configured.`);for(let[n,i]of Object.entries(e))if(i.variants)for(let e of r[n]||[])t.push({path:`agents/${n}-${e}.agent.md`,content:_(n,e,i)});else t.push({path:`agents/${n}.agent.md`,content:v(n,i)});for(let[e,n]of Object.entries(a))t.push({path:`agents/_shared/${e}.md`,content:`${n}\n`});for(let[e,n]of Object.entries(o))t.push({path:`agents/templates/${e}.md`,content:`${n}\n`});t.push({path:`agents/README.md`,content:b()});for(let[e,n]of Object.entries(i))t.push({path:`prompts/aikit-${e}.prompt.md`,content:y(e,n)});let n=l(`copilot`,`~/.copilot/hooks/scripts`);return t.push(...n.map(e=>({path:`hooks/${e.path}`,content:e.content}))),t}export{x as generateCopilot};

package/scaffold/dist/adapters/hooks.mjs

@@ -0,0 +1 @@
+import{EXEC_HOOKS as e,HOOK_EVENTS as t,HOOK_TOOL_MATCHERS as n}from"../definitions/exec-hooks.mjs";const r={PreCompact:3e3,PostToolUse:3e3},i={copilot:`hooks.json`,claude:`hooks-settings.json`,copilotCli:`hooks.json`};function a(e,t){return(e.matcher||[]).flatMap(e=>{let r=n[e];if(!r)throw Error(`Unknown hook matcher: ${e}`);return r[t]||[]})}function o(e,t,n,i){let o=`${n}/${e.script}`;return a(e,i),i===`copilot`?{event:t,steps:[{type:`command`,command:`node`,args:[o],timeout:r[e.event]||5e3}]}:i===`claude`?{type:`command`,command:`node ${o}`}:{command:`node`,args:[o]}}function s(n,r){if(n===`copilot`){let a=Object.values(e).map(e=>{let i=t[e.event]?.[n];if(!i)throw Error(`Unsupported hook event ${e.event} for ${n}`);return o(e,i,r,n)});return[{path:i[n],content:JSON.stringify({hooks:a},null,2)}]}let a={};for(let i of Object.values(e)){let e=t[i.event]?.[n];if(!e)throw Error(`Unsupported hook event ${i.event} for ${n}`);a[e]||=[],a[e].push(o(i,e,r,n))}return[{path:i[n],content:JSON.stringify({hooks:a},null,2)}]}function c(){return[`_runtime.mjs`,...Object.values(e).map(e=>e.script)]}export{s as generateHooks,c as getHookScriptFiles};

package/scaffold/dist/definitions/bodies.mjs

@@ -1,4 +1,4 @@
-const e=()=>"**`AGENTS.md` is already in your context** — do NOT re-read it. Just load the `aikit` skill.\n\nLoad the `aikit` skill for full tool documentation, workflow chains, and session protocol.",t={Orchestrator:e=>`You orchestrate the full development lifecycle: **planning → implementation → review → recovery → commit**. You own the contract — what gets done, in what order, by whom. The \`multi-agents-development\` skill owns the craft — how to decompose, dispatch, and review. **Load that skill before any delegation work.**
+import{postTaskLesson as e,preTaskKnowledgeRecall as t}from"./protocols.mjs";const n=()=>``,r={Orchestrator:e=>`You orchestrate the full development lifecycle: **planning → implementation → review → recovery → commit**. You own the contract — what gets done, in what order, by whom. The \`multi-agents-development\` skill owns the craft — how to decompose, dispatch, and review. **Load that skill before any delegation work.**
 
 ## Bootstrap (before any work)
 
@@ -332,7 +332,8 @@ When a subagent reports \`NEEDS_CONTEXT\` with an access failure:
 ### Start
 
 1. \`flow({ action: 'status' })\` → if active, \`flow({ action: 'read' })\` and follow current step; skip remaining start steps.
-2. If no active flow: \`status({})\` → \`flow({ action: 'list' })\` → \`search({ query: "SESSION CHECKPOINT", origin: "curated" })\` → select flow → \`flow({ action: 'start', name, topic })\`.
+2. If no active flow: \`status({ includePrelude: true })\` → \`flow({ action: 'list' })\` → \`search({ query: "SESSION CHECKPOINT", origin: "curated" })\` → select flow → \`flow({ action: 'start', name, topic })\`.
+   - Prelude returns top 3 lessons + top 2 conventions + last checkpoint alongside normal status.
 
 ### During
 
@@ -363,7 +364,7 @@ After any \`status()\` call, check the \`contextPressure\` value (0-100):
 This project uses aikit's pluggable flow system. Check flow status with the \`flow\` MCP tool.
 If a flow is active, follow the current step's instructions. Advance with \`flow({ action: 'step', advance: 'next' })\`.
 Use \`flow({ action: 'list' })\` to see available flows and \`flow({ action: 'start', name, topic })\` to begin one.
-`,Planner:`${e()}
+`,Planner:`${n()}
 
 > **Reminder:** Follow ## MANDATORY FIRST ACTION from your shared base protocol.
 
@@ -440,9 +441,7 @@ The Planner is typically activated by the Orchestrator as part of a flow step (e
 | \`adr-skill\` | When the plan involves non-trivial technical decisions — create executable ADRs |
 | \`session-handoff\` | When context window is filling up, planning session ending, or major milestone completed |
 | \`repo-access\` | When the plan involves accessing private, enterprise, or self-hosted repositories |
-| \`browser-use\` | When the plan involves browser-based auth recovery, web scraping, or interacting with web applications that require login |`,Implementer:`${e()}
-
-> **HARD RULE:** NEVER use \`read_file\` to understand code. Use \`file_summary\`/\`compact\`/\`digest\`. \`read_file\` is ONLY for exact edit lines. NEVER use \`run_in_terminal\` for tsc/lint/test — use \`check({})\`/\`test_run({})\`.
+| \`browser-use\` | When the plan involves browser-based auth recovery, web scraping, or interacting with web applications that require login |`,Implementer:`${n()}
 
 ## Implementation Protocol
 
@@ -471,22 +470,7 @@ The Planner is typically activated by the Orchestrator as part of a flow step (e
 4. **Estimate blast radius** — \`blast_radius({ path: ".", files: [...] })\` BEFORE editing when changing a public/shared symbol; re-run AFTER to confirm actual impact matches.
 5. **TDD when tests exist** — write/extend the failing test first, then minimum code to pass.
 
-## Pre-Task: Knowledge Recall (MANDATORY)
-
-Before starting implementation, recall relevant lessons and conventions **scoped to your specific task**:
-
-\`\`\`
-// Extract 2-3 keywords from your assigned task
-knowledge({ action: "lesson", subAction: "list-lessons", topic: "<task keywords>", minConfidence: 70, limit: 3 })
-search({ query: "<task area> convention", category: "conventions", limit: 3 })
-\`\`\`
-
-**Rules:**
-- ALWAYS scope by topic — NEVER call \`list-lessons\` without \`topic\` param
-- ALWAYS limit results — \`limit: 3\` for search, \`minConfidence: 70\` for lessons
-- If recalled lessons apply → follow them, note which you followed in Status
-- If recalled lessons conflict → note the conflict in Status
-- Skip ONLY if task is pure config/formatting with zero logic
+${t({intro:`Before starting implementation, recall relevant lessons and conventions **scoped to your specific task**:`,commands:[`// Extract 2-3 keywords from your assigned task`,`knowledge({ action: "lesson", subAction: "list-lessons", topic: "<task keywords>", minConfidence: 70, limit: 3 })`,`search({ query: "<task area> convention", category: "conventions", limit: 3 })`],followUp:"**Rules:**\n- ALWAYS scope by topic — NEVER call `list-lessons` without `topic` param\n- ALWAYS limit results — `limit: 3` for search, `minConfidence: 70` for lessons\n- If recalled lessons apply → follow them, note which you followed in Status\n- If recalled lessons conflict → note the conflict in Status\n- Skip ONLY if task is pure config/formatting with zero logic"})}
 
 ## Post-Edit Checklist
 
@@ -494,18 +478,7 @@ search({ query: "<task area> convention", category: "conventions", limit: 3 })
 2. \`test_run({})\` — full suite or targeted pattern
 3. If Orchestrator passed a \`task_id\`: \`evidence_map({action:'add', task_id, claim, status:'V', receipt:'file.ts#Lxx'})\` for each verified contract/acceptance claim. Do NOT run the gate — Orchestrator owns it.
 
-## Post-Task: Capture Lesson
-
-**HARD RULE:** Before reporting DONE status, load the \`lesson-learned\` skill and extract 1-2 engineering lessons from the changes made. Skip ONLY if changes are pure config/formatting with no logic modified.
-
-Quick lesson capture (when full skill feels heavy):
-\`\`\`
-knowledge({ action: "lesson", subAction: "create", context: "<what situation you faced>", insight: "<what principle the solution demonstrates>", evidence: "<file:line or commit that proves it>", confidence: 65 })
-\`\`\`
-
-**Confirm/Contradict (if pre-task recalled relevant lessons):**
-- Lesson proved correct → \`knowledge({ action: "lesson", subAction: "confirm", id: "<recalled-lesson-path>" })\`
-- Lesson was wrong/outdated → \`knowledge({ action: "lesson", subAction: "contradict", id: "<recalled-lesson-path>", evidence: "<what actually happened>" })\`
+${e()}
 
 ## Structured Output (MANDATORY)
 
@@ -532,9 +505,7 @@ Every implementation response MUST end with a structured status block:
 | Skill | When to load |
 |-------|--------------|
 | \`typescript\` | When implementing TypeScript code — type patterns, generics, utility types |
-| \`react\` | When implementing React components — hooks, patterns, Server Components |`,Frontend:`${e()}
-
-> **HARD RULE:** NEVER use \`read_file\` to understand code. Use \`file_summary\`/\`compact\`/\`digest\`. \`read_file\` is ONLY for exact edit lines. NEVER use \`run_in_terminal\` for tsc/lint/test — use \`check({})\`/\`test_run({})\`.
+| \`react\` | When implementing React components — hooks, patterns, Server Components |`,Frontend:`${n()}
 
 ## Frontend Protocol
 
@@ -583,29 +554,9 @@ Every implementation response MUST end with a structured status block:
 If the pre-flight dev server cannot be started (e.g. sandbox), fall back to
 \`compact\` inspection of the component source + describe expected visual behavior.
 
-## Pre-Task: Pattern Recall (MANDATORY)
-
-Before implementing UI work, check existing component patterns:
-
-\`\`\`
-search({ query: "<component/feature area> pattern", category: "conventions", limit: 3 })
-knowledge({ action: "lesson", subAction: "list-lessons", topic: "<UI area>", minConfidence: 70, limit: 3 })
-\`\`\`
-
-Follow discovered patterns for consistency. Note any patterns followed in Status.
-
-## Post-Task: Capture Lesson
-
-**HARD RULE:** Before reporting DONE status, load the \`lesson-learned\` skill and extract 1-2 engineering lessons from the changes made. Skip ONLY if changes are pure config/formatting with no logic modified.
-
-Quick lesson capture (when full skill feels heavy):
-\`\`\`
-knowledge({ action: "lesson", subAction: "create", context: "<what situation you faced>", insight: "<what principle the solution demonstrates>", evidence: "<file:line or commit that proves it>", confidence: 65 })
-\`\`\`
+${t({title:`Pattern Recall`,intro:`Before implementing UI work, check existing component patterns:`,commands:[`search({ query: "<component/feature area> pattern", category: "conventions", limit: 3 })`,`knowledge({ action: "lesson", subAction: "list-lessons", topic: "<UI area>", minConfidence: 70, limit: 3 })`],followUp:`Follow discovered patterns for consistency. Note any patterns followed in Status.`})}
 
-**Confirm/Contradict (if pre-task recalled relevant lessons):**
-- Lesson proved correct → \`knowledge({ action: "lesson", subAction: "confirm", id: "<recalled-lesson-path>" })\`
-- Lesson was wrong/outdated → \`knowledge({ action: "lesson", subAction: "contradict", id: "<recalled-lesson-path>", evidence: "<what actually happened>" })\`
+${e()}
 
 ## Skills (load on demand)
 
@@ -614,9 +565,7 @@ knowledge({ action: "lesson", subAction: "create", context: "<what situation you
 | \`typescript\` | When implementing TypeScript code — type patterns, generics, utility types |
 | \`react\` | When implementing React components — hooks, patterns, Server Components |
 | \`frontend-design\` | When making visual/UX decisions — design tokens, typography, color, spacing |
-| \`browser-use\` | When needing to visually validate rendered UI in a browser |`,Debugger:`${e()}
-
-> **HARD RULE:** NEVER use \`read_file\` to understand code. Use \`file_summary\`/\`compact\`/\`digest\`. \`read_file\` is ONLY for exact edit lines. NEVER use \`run_in_terminal\` for tsc/lint/test — use \`check({})\`/\`test_run({})\`.
+| \`browser-use\` | When needing to visually validate rendered UI in a browser |`,Debugger:`${n()}
 
 ## Debugging Protocol
 
@@ -694,38 +643,15 @@ When debugging tool invocation issues, use the replay audit trail with traceId:
    - Server middleware context (\`ctx.requestId\`)
 4. Filter by traceId: search replay.jsonl for the specific UUID to trace the full invocation lifecycle
 
-## Pre-Task: Error Pattern Recall (MANDATORY)
-
-Before diagnosing, search for prior solutions to similar errors:
-
-\`\`\`
-// Use error message keywords or failing module name
-search({ query: "<error keywords or module name>", category: "context", limit: 3 })
-knowledge({ action: "lesson", subAction: "list-lessons", topic: "<error area>", minConfidence: 60, limit: 3 })
-\`\`\`
-
-If a prior fix exists for the same pattern → try it first before deep investigation.
-
-## Post-Task: Capture Lesson
-
-**HARD RULE:** Before reporting DONE status, load the \`lesson-learned\` skill and extract 1-2 engineering lessons from the changes made. Skip ONLY if changes are pure config/formatting with no logic modified.
-
-Quick lesson capture (when full skill feels heavy):
-\`\`\`
-knowledge({ action: "lesson", subAction: "create", context: "<what situation you faced>", insight: "<what principle the solution demonstrates>", evidence: "<file:line or commit that proves it>", confidence: 65 })
-\`\`\`
+${t({title:`Error Pattern Recall`,intro:`Before diagnosing, search for prior solutions to similar errors:`,commands:[`// Use error message keywords or failing module name`,`search({ query: "<error keywords or module name>", category: "context", limit: 3 })`,`knowledge({ action: "lesson", subAction: "list-lessons", topic: "<error area>", minConfidence: 60, limit: 3 })`],followUp:`If a prior fix exists for the same pattern → try it first before deep investigation.`})}
 
-**Confirm/Contradict (if pre-task recalled relevant lessons):**
-- Lesson proved correct → \`knowledge({ action: "lesson", subAction: "confirm", id: "<recalled-lesson-path>" })\`
-- Lesson was wrong/outdated → \`knowledge({ action: "lesson", subAction: "contradict", id: "<recalled-lesson-path>", evidence: "<what actually happened>" })\`
+${e()}
 
 ## Skills (load on demand)
 
 | Skill | When to load |
 |-------|--------------|
-| \`typescript\` | When debugging TypeScript code — type narrowing, compiler errors |`,Refactor:`${e()}
-
-> **HARD RULE:** NEVER use \`read_file\` to understand code. Use \`file_summary\`/\`compact\`/\`digest\`. \`read_file\` is ONLY for exact edit lines. NEVER use \`run_in_terminal\` for tsc/lint/test — use \`check({})\`/\`test_run({})\`.
+| \`typescript\` | When debugging TypeScript code — type narrowing, compiler errors |`,Refactor:`${n()}
 
 ## Refactoring Protocol
 
@@ -777,36 +703,16 @@ For multi-approach uncertainty (A vs B), do NOT create lanes. Instead:
   for read-only exploration and return a recommendation
 - You then apply the winning approach under the checkpoint protocol above
 
-## Pre-Task: Convention Recall (MANDATORY)
-
-Before refactoring, check existing conventions for the target area:
-
-\`\`\`
-search({ query: "<module/pattern being refactored> convention", category: "conventions", limit: 3 })
-knowledge({ action: "lesson", subAction: "list-lessons", topic: "<refactor area>", minConfidence: 70, limit: 3 })
-\`\`\`
-
-Follow discovered conventions. Do NOT introduce patterns that contradict established conventions without surfacing the conflict.
-
-## Post-Task: Capture Lesson
-
-**HARD RULE:** Before reporting DONE status, load the \`lesson-learned\` skill and extract 1-2 engineering lessons from the changes made. Skip ONLY if changes are pure config/formatting with no logic modified.
-
-Quick lesson capture (when full skill feels heavy):
-\`\`\`
-knowledge({ action: "lesson", subAction: "create", context: "<what situation you faced>", insight: "<what principle the solution demonstrates>", evidence: "<file:line or commit that proves it>", confidence: 65 })
-\`\`\`
+${t({title:`Convention Recall`,intro:`Before refactoring, check existing conventions for the target area:`,commands:[`search({ query: "<module/pattern being refactored> convention", category: "conventions", limit: 3 })`,`knowledge({ action: "lesson", subAction: "list-lessons", topic: "<refactor area>", minConfidence: 70, limit: 3 })`],followUp:`Follow discovered conventions. Do NOT introduce patterns that contradict established conventions without surfacing the conflict.`})}
 
-**Confirm/Contradict (if pre-task recalled relevant lessons):**
-- Lesson proved correct → \`knowledge({ action: "lesson", subAction: "confirm", id: "<recalled-lesson-path>" })\`
-- Lesson was wrong/outdated → \`knowledge({ action: "lesson", subAction: "contradict", id: "<recalled-lesson-path>", evidence: "<what actually happened>" })\`
+${e()}
 
 ## Skills (load on demand)
 
 | Skill | When to load |
 |-------|--------------|
 | \`lesson-learned\` | After completing a refactor — extract principles from the before/after diff |
-| \`typescript\` | When refactoring TypeScript code — type patterns, generics, utility types |`,Security:`${e()}
+| \`typescript\` | When refactoring TypeScript code — type patterns, generics, utility types |`,Security:`${n()}
 
 > **Reminder:** Follow ## MANDATORY FIRST ACTION from your shared base protocol.
 
@@ -857,7 +763,7 @@ After shared bootstrap, run \`search({ query: "security vulnerabilities conventi
 
 | Skill | When to load |
 |-------|--------------|
-| \`typescript\` | When reviewing TypeScript for type-safety vulnerabilities |`,Documenter:`${e()}
+| \`typescript\` | When reviewing TypeScript for type-safety vulnerabilities |`,Documenter:`${n()}
 
 > **Reminder:** Follow ## MANDATORY FIRST ACTION from your shared base protocol.
 
@@ -927,7 +833,7 @@ Rules adapted from *The Elements of Agent Style* (CC BY 4.0, Yue Zhao) and class
 | \`present\` | When presenting documentation previews, API tables, or architecture visuals to the user |
 | \`c4-architecture\` | When documenting system architecture — generate C4 Mermaid diagrams |
 | \`adr-skill\` | When documenting architecture decisions — create or update ADRs |
-| \`typescript\` | When documenting TypeScript APIs — type signatures, JSDoc patterns |`,Explorer:`${e()}
+| \`typescript\` | When documenting TypeScript APIs — type signatures, JSDoc patterns |`,Explorer:`${n()}
 
 ## MANDATORY FIRST ACTION
 
@@ -998,4 +904,4 @@ When dispatched as a subagent within an active flow:
 
 - **Speed over depth** — Provide a useful map quickly, not an exhaustive analysis
 - **Read-only** — Never create, edit, or delete files
-- **Structured output** — Always return findings in the format above`};export{t as AGENT_BODIES};
+- **Structured output** — Always return findings in the format above`};export{r as AGENT_BODIES};

package/scaffold/dist/definitions/exec-hooks.mjs

@@ -0,0 +1 @@
+const e={SessionStart:{copilot:`SessionStart`,claude:`PreToolCall`,copilotCli:`sessionStart`},PreToolUse:{copilot:`PreToolUse`,claude:`PreToolCall`,copilotCli:`preToolUse`},PostToolUse:{copilot:`PostToolUse`,claude:`PostToolCall`,copilotCli:`postToolUse`},SubagentStart:{copilot:`SubagentStart`,claude:`PreToolCall`,copilotCli:`subagentStart`},PreCompact:{copilot:`PreCompact`,claude:`PreToolCall`,copilotCli:`preCompact`},Stop:{copilot:`Stop`,claude:`PostToolCall`,copilotCli:`stop`}},t={fileRead:{copilot:[`read_file`,`readFile`],claude:[`Read`],copilotCli:[`read_file`]},fileWrite:{copilot:[`editFiles`,`replace_string_in_file`,`create_file`],claude:[`Write`,`Edit`],copilotCli:[`editFiles`,`replace_string_in_file`]},fileSearch:{copilot:[`grep_search`,`semantic_search`,`find`],claude:[`Bash`],copilotCli:[`grep_search`]}},n={"privacy-guard":{id:`privacy-guard`,event:`PreToolUse`,tier:`safety`,description:`Blocks reads of secret-bearing env files, key material, SSH paths, and credential artifacts.`,script:`privacy-guard.mjs`,matcher:[`fileRead`],scope:`user`,patterns:[`.env`,`*.pem`,`*.key`,`id_rsa*`,`.ssh/*`,`*credentials*`,`*.secret`]},"scout-guard":{id:`scout-guard`,event:`PreToolUse`,tier:`safety`,description:`Blocks reads and searches inside generated, dependency, and git object directories.`,script:`scout-guard.mjs`,matcher:[`fileRead`,`fileSearch`],scope:`user`,patterns:[`node_modules/`,`dist/`,`.git/objects/`,`vendor/`,`build/`]},"subagent-context":{id:`subagent-context`,event:`SubagentStart`,tier:`efficiency`,description:`Injects compact project context into each subagent spawn to reduce repeated discovery.`,script:`subagent-context.mjs`,scope:`user`},"pre-compact-save":{id:`pre-compact-save`,event:`PreCompact`,tier:`efficiency`,description:`Persists critical state before context compaction truncates recent session history.`,script:`pre-compact-save.mjs`,scope:`user`},"post-edit-check":{id:`post-edit-check`,event:`PostToolUse`,tier:`nudge`,description:`After repeated file edits, injects a validation reminder so checks are not skipped.`,script:`post-edit-check.mjs`,matcher:[`fileWrite`],scope:`user`},"session-init":{id:`session-init`,event:`SessionStart`,tier:`nudge`,description:`Detects project stack and injects workspace metadata and environment context at startup.`,script:`session-init.mjs`,scope:`user`},"session-observer":{id:`session-observer`,event:`PostToolUse`,tier:`efficiency`,description:`Captures tool usage patterns for autonomous lesson extraction. Writes to session buffer.`,script:`session-observer.mjs`,scope:`user`},"session-learn":{id:`session-learn`,event:`Stop`,tier:`efficiency`,description:`Nudges final pattern analysis on buffered observations at session end.`,script:`session-learn.mjs`,scope:`user`}};export{n as EXEC_HOOKS,e as HOOK_EVENTS,t as HOOK_TOOL_MATCHERS};