@vpxa/aikit 0.1.73 → 0.1.75

package/scaffold/{definitions → dist/definitions}/protocols.mjs

@@ -1,12 +1,4 @@
-/**
- * Shared protocol content — base instructions referenced by multiple agents.
- *
- * Keys map to filenames: 'code-agent-base' → '_shared/code-agent-base.md'
- * Content is IDE-agnostic markdown, but adapters may wrap it differently.
- */
-
-export const PROTOCOLS = {
-  'code-agent-base': `# Code Agent — Shared Base Instructions
+const e={"code-agent-base":`# Code Agent — Shared Base Instructions
 
 > This file contains shared protocols for all code-modifying agents (Implementer, Frontend, Refactor, Debugger). Each agent's definition file contains only its unique identity, constraints, and workflow. **Do not duplicate this content in agent files.**
 
@@ -371,9 +363,7 @@ Always return this structure when invoked as a sub-agent:
   <blockers>{any blocking issues}</blockers>
 </handoff>
 \`\`\`
-`,
-
-  'researcher-base': `# Researcher — Shared Base Instructions
+`,"researcher-base":`# Researcher — Shared Base Instructions
 
 > Shared methodology for all Researcher variants. Each variant's definition contains only its unique identity and model assignment. **Do not duplicate.**
 
@@ -486,9 +476,7 @@ For questions that require trying approach A vs approach B in isolation:
 4. Apply approach B mentally; record observations
 5. \`lane({ action:'diff', names:['approach-a','approach-b'] })\` — compare
 6. Include the diff summary in your output; do NOT merge lanes back (read-only role)
-`,
-
-  'code-reviewer-base': `# Code-Reviewer — Shared Base Instructions
+`,"code-reviewer-base":`# Code-Reviewer — Shared Base Instructions
 
 > Shared methodology for all Code-Reviewer variants. Each variant's definition contains only identity and model. **Do not duplicate.**
 
@@ -574,9 +562,7 @@ Do NOT:
 - Create a new \`evidence_map\` (the Orchestrator already did)
 - Run \`evidence_map({action:'gate'})\` yourself — the Orchestrator owns the gate
 - Duplicate findings into the map that weren't CRITICAL/HIGH
-`,
-
-  'architect-reviewer-base': `# Architect-Reviewer — Shared Base Instructions
+`,"architect-reviewer-base":`# Architect-Reviewer — Shared Base Instructions
 
 > Shared methodology for all Architect-Reviewer variants. Each variant's definition contains only identity and model. **Do not duplicate.**
 
@@ -679,9 +665,7 @@ to the Evidence Map per the tier protocol above.
 
 **Do NOT use \`shortest_path\`** — that action does not exist. Use \`depth_traverse\`
 or repeated \`neighbors\` calls.
-`,
-
-  'decision-protocol': `# Multi-Model Decision Protocol
+`,"decision-protocol":`# Multi-Model Decision Protocol
 
 The Orchestrator uses **multi-model decision analysis** to resolve non-trivial technical choices. This is the autonomous decision-making process — distinct from the interactive brainstorming skill.
 
@@ -707,9 +691,7 @@ Trigger the decision protocol when there is an **unresolved non-trivial technica
 - Never make a non-trivial technical decision without multi-model analysis
 - **Produce an ADR** after every decision resolution
 - \`remember\` the decision for future recall
-`,
-
-  'forge-protocol': `# FORGE Protocol — Quality Overlay
+`,"forge-protocol":`# FORGE Protocol — Quality Overlay
 
 > Follow the FORGE (Fact-Oriented Reasoning with Graduated Evidence) protocol for all code generation and modification tasks.
 
@@ -798,14 +780,7 @@ evidence_map({ action: "gate", task_id: "add-user-api" })  → YIELD ✅
 3. **Standard**: \`evidence_map create\` → add 3-8 claims during work → \`evidence_map gate\`
 4. **Critical**: Full 4-phase flow with comprehensive evidence
 5. **After gate**: YIELD = done, HOLD = fix + re-gate, HARD_BLOCK = escalate
-`,
-};
-
-// ─── Templates ──────────────────────────────────────────────────────────────
-// Keys map to filenames under agents/templates/
-
-export const TEMPLATES = {
-  'execution-state': `# Execution State: {Task Title}
+`},t={"execution-state":`# Execution State: {Task Title}
 
 **Status:** PLANNING | IN_PROGRESS | REVIEW | COMPLETED | BLOCKED
 **Started:** {timestamp}
@@ -830,9 +805,7 @@ export const TEMPLATES = {
 
 | Issue | Severity | Assigned |
 |-------|----------|----------|
-`,
-
-  'adr-template': `# DR-NNN: {Short Title}
+`,"adr-template":`# DR-NNN: {Short Title}
 
 **Status:** Proposed | Accepted | Rejected | Deprecated | Superseded
 **Date:** YYYY-MM-DD
@@ -859,5 +832,4 @@ export const TEMPLATES = {
 
 ## Alternatives Considered
 {Other approaches evaluated and why they were rejected — keeps the "why not" alongside the "why"}
-`,
-};
+`};export{e as PROTOCOLS,t as TEMPLATES};

package/scaffold/dist/definitions/tools.mjs

@@ -0,0 +1 @@
+const e=`analyze_dependencies.analyze_diagram.analyze_entry_points.analyze_patterns.analyze_structure.analyze_symbols.audit.batch.blast_radius.brainstorm.changelog.check.checkpoint.codemod.compact.config.data_transform.dead_symbols.delegate.describe_tool.diff_parse.digest.encode.env.eval.evidence_map.file_summary.find.flow_add.flow_info.flow_list.flow_read_instruction.flow_remove.flow_reset.flow_start.flow_status.flow_step.flow_update.forge_classify.forge_ground.forget.git_context.graph.guide.health.http.lane.list.list_tools.lookup.measure.onboard.parse_output.present.process.produce_knowledge.queue.read.regex_test.reindex.remember.rename.replay.restore.schema_validate.scope_map.search.search_tools.session_digest.snippet.stash.status.stratum_card.symbol.test_run.time.trace.update.watch.web_fetch.web_search.workset`.split(`.`),t={orchestrator:[`memory`,`runCommand`,`switchAgent`,`newWorkspace`,`reviewPlan`,`killTerminal`,`createTask`,`terminal`,`terminalSel`,`lastCommand`,`problems`,`readFile`,`subagent`,`createFile`,`editFiles`,`rename`,`createDirectory`,`search`,`web`,`todo`,`searchSubagent`,`textSearch`,`browser`,`askQuestions`,`resolveMemoryFileUri`],researcher:[`terminal`,`problems`,`readFile`,`lastCommand`,`subagent`,`search`,`web`,`browser`],reviewer:[`terminal`,`problems`,`readFile`,`lastCommand`,`subagent`,`search`,`web`,`browser`],codeAgent:[`createTask`,`terminal`,`problems`,`readFile`,`lastCommand`,`subagent`,`createFile`,`editFiles`,`rename`,`createDirectory`,`search`,`todo`,`browser`],debugger:[`terminal`,`problems`,`readFile`,`terminalSel`,`lastCommand`,`subagent`,`createFile`,`editFiles`,`search`,`browser`],refactor:[`terminal`,`problems`,`readFile`,`lastCommand`,`subagent`,`createFile`,`editFiles`,`rename`,`createDirectory`,`search`,`browser`],explorer:[`problems`,`readFile`,`search`,`fileSearch`,`listDir`,`textSearch`,`browser`],planner:[`terminal`,`problems`,`readFile`,`reviewPlan`,`memory`,`askQuestions`,`resolveMemoryFileUri`,`lastCommand`,`subagent`,`createFile`,`editFiles`,`rename`,`createDirectory`,`search`,`web`,`todo`,`searchSubagent`,`browser`],security:[`terminal`,`problems`,`readFile`,`subagent`,`search`,`web`,`browser`],documenter:[`terminal`,`problems`,`readFile`,`lastCommand`,`subagent`,`createFile`,`editFiles`,`rename`,`createDirectory`,`search`,`web`,`browser`]};export{e as AIKIT_TOOLS,t as IDE_CAPABILITIES};

package/packages/cli/dist/scaffold-CJwkHf-q.js

@@ -1,2 +0,0 @@
-import{existsSync as e,mkdirSync as t,readFileSync as n,readdirSync as r,rmSync as i,statSync as a,unlinkSync as o,writeFileSync as s}from"node:fs";import{dirname as c,resolve as l}from"node:path";import{createHash as u}from"node:crypto";const d=[`inputs`,`outputs`,`requires`,`relatedSkills`],f=[`model`],p=[`category`,`domain`,`applicability`],m=new Set([`__proto__`,`constructor`,`prototype`]);function h(e,t){return e.metadata[t]??e.fields[t]}function g(e,t){let n=h(e,t);return n?v(n):[]}function _(e){let t=Object.create(null),n=Object.create(null),r=[],i=e,a=e.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);if(!a)return{fields:t,metadata:n,tools:r,body:i};let o=a[1];i=a[2];let s=!1;for(let e of o.split(/\r?\n/)){if(s){if(e.trim()===``)continue;let t=e.match(/^\s{2,}(\S+?):\s*(.*)$/);if(t){let[,e,r]=t;if(m.has(e))continue;n[e]=r;continue}s=!1}let i=e.match(/^(\S+?):\s*(.*)$/);if(!i)continue;let[,a,o]=i;if(a===`metadata`&&o.trim()===``){s=!0;continue}m.has(a)||(t[a]=o,a===`tools`&&(r=v(o)))}return{fields:t,metadata:n,tools:r,body:i}}function v(e){let t=e.trim();if(!t.startsWith(`[`)||!t.endsWith(`]`))return[];let n=t.slice(1,-1).trim();return n?n.split(`,`).map(e=>e.trim()).filter(Boolean):[]}function y(e){return`[${e.join(`, `)}]`}function b(e,t){let n=_(e),r=_(t),i={...n.fields},a={...n.metadata};for(let[e,t]of Object.entries(r.metadata))e in a||(a[e]=t);for(let e of f)r.fields[e]&&(i[e]=r.fields[e]);for(let e of p){let t=h(r,e);t&&(a[e]=t)}for(let e of[...p,...d])delete i[e];delete i.metadata;let o=n.tools,s=r.tools,c=new Set(o),l=s.filter(e=>!c.has(e)),u=[...o,...l];u.length>0&&(i.tools=y(u));for(let e of d){let t=g(n,e),i=g(r,e),o=new Set(t),s=i.filter(e=>!o.has(e)),c=[...t,...s];c.length>0?a[e]=y(c):delete a[e]}let m=[`---`],v=[`name`,`description`,`argument-hint`,`tools`,`model`],b=[`category`,`domain`,`applicability`,`inputs`,`outputs`,`requires`,`relatedSkills`],x=new Set;for(let e of v)e in i&&(m.push(`${e}: ${i[e]}`),x.add(e));for(let[e,t]of Object.entries(i))x.has(e)||m.push(`${e}: ${t}`);let S=[],C=new Set;for(let e of b){let t=a[e];t&&(S.push(`  ${e}: ${t}`),C.add(e))}for(let[e,t]of Object.entries(a))!C.has(e)&&t&&S.push(`  ${e}: ${t}`);return S.length>0&&(m.push(`metadata:`),m.push(...S)),m.push(`---`),`${m.join(`
-`)}\n${n.body}`}function x(e){return u(`sha256`).update(e).digest(`hex`).slice(0,16)}function S(t){if(!e(t))return null;try{let e=n(t,`utf-8`),r=JSON.parse(e);return!r.version||!r.files?null:r}catch{return null}}function C(e,t){s(e,`${JSON.stringify(t,null,2)}\n`,`utf-8`)}function w(e){return e.endsWith(`.agent.md`)&&!e.startsWith(`_shared/`)&&!e.startsWith(`agents/_shared/`)&&!e.startsWith(`templates/`)||e.endsWith(`SKILL.md`)&&!e.startsWith(`_shared/`)&&!e.startsWith(`templates/`)?`merge-frontmatter`:`overwrite`}function T(e,t,n){if(!e)return`new`;let r=e.files[t];return r?r.sourceHash===x(n)?`current`:`outdated`:`new`}function E(e,t,n,r){e.files[t]={sourceHash:x(n),strategy:r??w(t),updatedAt:new Date().toISOString()}}function D(e){return{version:e,generatedAt:new Date().toISOString(),files:{}}}function O(i,o,u,d=``,f=!1){if(e(i)){t(o,{recursive:!0});for(let p of r(i)){let r=l(i,p),m=l(o,p),h=d?`${d}/${p}`:p;if(a(r).isDirectory()){O(r,m,u,h,f);continue}let g=n(r,`utf-8`);if(f){t(c(m),{recursive:!0}),s(m,g,`utf-8`),E(u,h,g);continue}let _=T(u,h,g);if(_!==`current`){if(_===`new`&&!e(m)){t(c(m),{recursive:!0}),s(m,g,`utf-8`),E(u,h,g);continue}if(_===`new`&&e(m)){E(u,h,g);continue}w(h)===`merge-frontmatter`&&e(m)?s(m,b(g,n(m,`utf-8`)),`utf-8`):(t(c(m),{recursive:!0}),s(m,g,`utf-8`)),E(u,h,g)}}}}function k(t,n,i,s){let c=new Set;if(e(t)){let e=(t,n)=>{for(let i of r(t)){let r=l(t,i),o=n?`${n}/${i}`:i;a(r).isDirectory()?e(r,o):c.add(`${s}/${o}`)}};e(t,``)}let u=[];for(let t of Object.keys(i.files)){if(!t.startsWith(`${s}/`)||c.has(t))continue;let r=l(n,t.slice(s.length+1));e(r)&&(o(r),u.push(t)),delete i.files[t]}return u}function A(t,n,r,i,a=!1){let o=l(n,`scaffold`,r),s=l(t,`.github`),c=l(s,`.aikit-scaffold.json`),u=S(c)??D(i);u.version=i;for(let t of[`agents`,`prompts`]){let n=l(o,t);e(n)&&O(n,l(s,t),u,t,a)}if(a)for(let e of[`agents`,`prompts`]){let t=k(l(o,e),l(s,e),u,e);for(let e of t)console.log(`  Removed orphaned scaffold file: ${e}`)}C(c,u)}function j(t,n,r,i,a=!1){let o=l(t,`.github`),s=l(o,`.aikit-scaffold.json`),c=S(s)??D(i);c.version=i;for(let t of r){let r=l(n,`scaffold`,`general`,`skills`,t);e(r)&&O(r,l(o,`skills`,t),c,`skills/${t}`,a)}C(s,c)}function M(t,n,r,i,a=!1){let o=l(t,r);if(!e(o))return;let s=l(n,r),c=l(n,`.aikit-scaffold.json`),u=S(c)??D(i);if(u.version=i,O(o,s,u,r,a),a){let e=k(o,s,u,r);for(let t of e)console.log(`  Removed orphaned scaffold file: ${t}`)}C(c,u)}function N(t,i,o,s){if(e(t))for(let c of r(t)){let r=l(t,c),u=o?`${o}/${c}`:c;if(a(r).isDirectory())N(r,l(i,c),u,s);else{let t=l(i,c),a=n(r,`utf-8`);e(t)?a===n(t,`utf-8`)?s.push({status:`current`,relativePath:u,sourcePath:r}):s.push({status:`outdated`,relativePath:u,sourcePath:r,content:a}):s.push({status:`new`,relativePath:u,sourcePath:r,content:a})}}}function P(e,t,n){let r=[],i=l(t,`scaffold`,n);for(let t of[`agents`,`prompts`])N(l(i,t),l(e,`.github`,t),t,r);return r}function F(t,n,r){let i=[];for(let a of r){let r=l(n,`scaffold`,`general`,`skills`,a);e(r)&&N(r,l(t,`.github`,`skills`,a),`skills/${a}`,i)}return i}function I(t,n,r,a,o=!1){let s=l(t,`.github`),c=l(s,`.aikit-scaffold.json`),u=S(c)??D(a);u.version=a;for(let t of r){let r=l(n,`scaffold`,`flows`,t,`steps`);if(!e(r))continue;let a=l(s,`flows`,t,`skills`);e(a)&&i(a,{recursive:!0,force:!0}),O(r,l(s,`flows`,t,`steps`),u,`flows/${t}/steps`,o)}C(c,u)}function L(t,n,r){let i=[];for(let a of r){let r=l(n,`scaffold`,`flows`,a,`steps`);e(r)&&N(r,l(t,`.github`,`flows`,a,`steps`),`flows/${a}/steps`,i)}return i}function R(i,o,c,d=!1){let f=l(o,`scaffold`,`claude-code`,`commands`);if(!e(f))return;let p=l(i,`.claude`),m=l(p,`.aikit-scaffold.json`),h;h=e(m)?JSON.parse(n(m,`utf-8`)):{version:c,generatedAt:new Date().toISOString(),files:{}},h.version=c,h.generatedAt=new Date().toISOString(),t(l(p,`commands`),{recursive:!0});let g=r(f);for(let t of g){let r=l(f,t);if(!a(r).isFile())continue;let i=`commands/${t}`,o=l(p,i),c=n(r,`utf-8`),m=u(`sha256`).update(c).digest(`hex`).slice(0,16),g=h.files[i];if(g&&!d&&e(o)){let e=n(o,`utf-8`);if(u(`sha256`).update(e).digest(`hex`).slice(0,16)!==g.sourceHash)continue}s(o,c,`utf-8`),h.files[i]={sourceHash:m,strategy:`overwrite`,updatedAt:new Date().toISOString()}}if(d){let e=k(f,l(p,`commands`),h,`commands`);for(let t of e)console.log(`  Removed orphaned scaffold file: ${t}`)}s(m,JSON.stringify(h,null,2),`utf-8`)}export{L as guideFlows,P as guideScaffold,F as guideSkills,R as smartCopyClaudeCommands,I as smartCopyFlows,A as smartCopyScaffold,j as smartCopySkills,M as smartCopySubdir};

package/packages/cli/dist/user-BEmVW8Tp.js

@@ -1,5 +0,0 @@
-import{a as e,i as t,n,r,t as i}from"./constants-B8_CApx0.js";import{n as a,t as o}from"./templates-DJ7EC5vw.js";import{smartCopySubdir as s}from"./scaffold-CJwkHf-q.js";import{existsSync as c,mkdirSync as l,readFileSync as u,rmSync as d,unlinkSync as f,writeFileSync as p}from"node:fs";import{dirname as m,join as h,resolve as g}from"node:path";import{fileURLToPath as _}from"node:url";import{getGlobalDataDir as v,saveRegistry as y}from"../../core/dist/index.js";import{homedir as b}from"node:os";function x(e){let t=e;for(let e=0;e<10;e++){try{let e=h(t,`package.json`);if(c(e)&&JSON.parse(u(e,`utf8`)).name===`@vpxa/aikit`)return t}catch{}let e=m(t);if(e===t)break;t=e}return g(e,`..`,`..`,`..`)}function S(){let e=b(),t=process.platform,n=[],r=g(e,`.copilot`),i=g(r,`instructions`),a=g(e,`.claude`),o=g(e,`.cursor`),s=g(e,`.windsurf`);if(t===`win32`){let t=process.env.APPDATA??g(e,`AppData`,`Roaming`);n.push({ide:`VS Code`,configDir:g(t,`Code`,`User`),mcpConfigPath:g(t,`Code`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VS Code Insiders`,configDir:g(t,`Code - Insiders`,`User`),mcpConfigPath:g(t,`Code - Insiders`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VSCodium`,configDir:g(t,`VSCodium`,`User`),mcpConfigPath:g(t,`VSCodium`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`Cursor`,configDir:g(t,`Cursor`,`User`),mcpConfigPath:g(t,`Cursor`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Cursor Nightly`,configDir:g(t,`Cursor Nightly`,`User`),mcpConfigPath:g(t,`Cursor Nightly`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Windsurf`,configDir:g(t,`Windsurf`,`User`),mcpConfigPath:g(t,`Windsurf`,`User`,`mcp.json`),globalScaffoldRoot:s,instructionsRoot:null})}else if(t===`darwin`){let t=g(e,`Library`,`Application Support`);n.push({ide:`VS Code`,configDir:g(t,`Code`,`User`),mcpConfigPath:g(t,`Code`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VS Code Insiders`,configDir:g(t,`Code - Insiders`,`User`),mcpConfigPath:g(t,`Code - Insiders`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VSCodium`,configDir:g(t,`VSCodium`,`User`),mcpConfigPath:g(t,`VSCodium`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`Cursor`,configDir:g(t,`Cursor`,`User`),mcpConfigPath:g(t,`Cursor`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Cursor Nightly`,configDir:g(t,`Cursor Nightly`,`User`),mcpConfigPath:g(t,`Cursor Nightly`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Windsurf`,configDir:g(t,`Windsurf`,`User`),mcpConfigPath:g(t,`Windsurf`,`User`,`mcp.json`),globalScaffoldRoot:s,instructionsRoot:null})}else{let t=process.env.XDG_CONFIG_HOME??g(e,`.config`);n.push({ide:`VS Code`,configDir:g(t,`Code`,`User`),mcpConfigPath:g(t,`Code`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VS Code Insiders`,configDir:g(t,`Code - Insiders`,`User`),mcpConfigPath:g(t,`Code - Insiders`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VSCodium`,configDir:g(t,`VSCodium`,`User`),mcpConfigPath:g(t,`VSCodium`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`Cursor`,configDir:g(t,`Cursor`,`User`),mcpConfigPath:g(t,`Cursor`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Cursor Nightly`,configDir:g(t,`Cursor Nightly`,`User`),mcpConfigPath:g(t,`Cursor Nightly`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Windsurf`,configDir:g(t,`Windsurf`,`User`),mcpConfigPath:g(t,`Windsurf`,`User`,`mcp.json`),globalScaffoldRoot:s,instructionsRoot:null})}return n.push({ide:`Claude Code`,configDir:g(e,`.claude`),mcpConfigPath:g(e,`.claude`,`mcp.json`),globalScaffoldRoot:a,instructionsRoot:null}),n.push({ide:`Copilot CLI`,configDir:r,mcpConfigPath:g(r,`mcp-config.json`),globalScaffoldRoot:null,instructionsRoot:null}),n.filter(e=>c(e.configDir))}function C(e,t,r=!1){let{mcpConfigPath:i,configDir:a}=e,o={...n},s={};if(c(i)){try{let e=u(i,`utf-8`);s=JSON.parse(e)}catch{let e=`${i}.bak`;p(e,u(i,`utf-8`),`utf-8`),console.log(`  Backed up invalid ${i} to ${e}`),s={}}if((s.servers??s.mcpServers??{})[t]&&!r){console.log(`  ${e.ide}: ${t} already configured (use --force to update)`);return}}let d=new Set([`VS Code`,`VS Code Insiders`,`VSCodium`,`Windsurf`]).has(e.ide)?`servers`:`mcpServers`,f=s[d]??{};e.ide===`Copilot CLI`?f[t]={...o,tools:[`*`]}:f[t]=o,s[d]=f,l(a,{recursive:!0}),p(i,`${JSON.stringify(s,null,2)}\n`,`utf-8`),console.log(`  ${e.ide}: configured ${t} in ${i}`)}const w=new Set([`VS Code`,`VS Code Insiders`,`VSCodium`]);function T(t,n=!1){if(!w.has(t.ide))return;let r=g(t.configDir,`settings.json`),i={};if(c(r))try{let e=u(r,`utf-8`);i=JSON.parse(e)}catch{console.log(`  ${t.ide}: skipped settings.json (invalid JSON)`);return}let a=!1;for(let[t,r]of Object.entries(e))if(typeof r==`object`&&r){let e=typeof i[t]==`object`&&i[t]!==null?i[t]:{},n={...e,...r};JSON.stringify(n)!==JSON.stringify(e)&&(i[t]=n,a=!0)}else (n||!(t in i))&&(i[t]=r,a=!0);a&&(p(r,`${JSON.stringify(i,null,2)}\n`,`utf-8`),console.log(`  ${t.ide}: updated settings.json`))}function E(e,n,r,u,f=!1){let m=new Set;for(let e of n)e.globalScaffoldRoot&&m.add(e.globalScaffoldRoot);if(m.size===0){console.log(`  No IDEs with global scaffold support detected.`);return}let h=g(e,`scaffold`,`general`);for(let n of m){s(h,n,`agents`,u,f),s(h,n,`prompts`,u,f);let r=0;for(let e of t)c(g(h,`skills`,e))&&(s(h,n,`skills/${e}`,u,f),r++);for(let t of i){let r=g(e,`scaffold`,`flows`,t);if(!c(g(r,`steps`)))continue;let i=g(n,`flows`,t);l(i,{recursive:!0});let a=g(i,`skills`);c(a)&&(d(a,{recursive:!0,force:!0}),console.log(`  ${n}: migrated ${t} flow to steps/ layout`)),s(r,i,`steps`,u,f)}console.log(`  ${n}: scaffold updated (${r} skills)`)}let _=new Set,v=a(`aikit`,r),y=o(`aikit`,r);for(let e of n){if(!e.globalScaffoldRoot)continue;let t=e.globalScaffoldRoot;if(e.ide===`Claude Code`){let e=g(t,`CLAUDE.md`);p(e,`${v}\n---\n\n${y}`,`utf-8`),_.add(e)}else if(e.ide===`VS Code`||e.ide===`VS Code Insiders`||e.ide===`VSCodium`){let n=e.instructionsRoot??t;l(n,{recursive:!0});let r=g(n,`copilot-instructions.md`);_.has(r)||(p(r,`---\napplyTo: "**"\n---\n\n${v}\n---\n\n${y}`,`utf-8`),_.add(r));let i=g(b(),`.github`),a=g(i,`copilot-instructions.md`);_.has(a)||(l(i,{recursive:!0}),p(a,`${v}\n---\n\n${y}`,`utf-8`),_.add(a)),s(h,e.configDir,`prompts`,u,f)}else if(e.ide===`Cursor`||e.ide===`Cursor Nightly`){let e=g(t,`rules`);l(e,{recursive:!0});let n=g(e,`aikit.mdc`);_.has(n)||(p(n,`${v}\n---\n\n${y}`,`utf-8`),_.add(n))}else if(e.ide===`Windsurf`){let e=g(t,`rules`);l(e,{recursive:!0});let n=g(e,`aikit.md`);_.has(n)||(p(n,`${v}\n---\n\n${y}`,`utf-8`),_.add(n))}}_.size>0&&console.log(`  Instruction files: ${[..._].join(`, `)}`)}function D(e){let t=[];for(let n of e){if(!n.globalScaffoldRoot)continue;let e=n.globalScaffoldRoot;if(n.ide===`VS Code`||n.ide===`VS Code Insiders`||n.ide===`VSCodium`){let r=n.instructionsRoot??e;t.push(g(r,`kb.instructions.md`)),t.push(g(r,`aikit.instructions.md`))}else n.ide===`Cursor`||n.ide===`Cursor Nightly`?t.push(g(e,`rules`,`kb.mdc`)):n.ide===`Windsurf`&&t.push(g(e,`rules`,`kb.md`))}for(let e of t)c(e)&&(f(e),console.log(`  Removed legacy file: ${e}`))}async function O(e){let t=r,n=x(m(_(import.meta.url))),i=JSON.parse(u(g(n,`package.json`),`utf-8`)).version;console.log(`Initializing @vpxa/aikit v${i}...\n`);let a=v();l(a,{recursive:!0}),console.log(`  Global data store: ${a}`),y({version:1,workspaces:{}}),console.log(`  Created registry.json`);let o=S();if(o.length===0)console.log(`
-  No supported IDEs detected. You can manually add the MCP server config.`);else{console.log(`\n  Detected ${o.length} IDE(s):`);for(let n of o)C(n,t,e.force),T(n,e.force)}console.log(`
-  Installing scaffold files:`),E(n,o,t,i,e.force),D(o),console.log(`
-User-level AI Kit installation complete!`),console.log(`
-Next steps:`),console.log(`  1. Open any workspace in your IDE`),console.log(`  2. The AI Kit server will auto-start and index the workspace`),console.log(`  3. Agents, prompts, skills & instructions are available globally`),console.log(`  4. No per-workspace init needed — just open a project and start coding`)}export{O as initUser};

package/scaffold/adapters/claude-code.mjs

@@ -1,73 +0,0 @@
-/**
- * Claude Code adapter — generates Claude Code config from definitions.
- *
- * Output format:
- *   CLAUDE.md                     — Main instructions (agents + protocols inline)
- *   .claude/settings.json         — Hooks config
- *   .mcp.json                     — MCP server config
- *   .claude/commands/{name}.md    — Slash commands (from prompts)
- *
- * Status: STUB — not yet implemented.
- */
-
-// biome-ignore lint/correctness/noUnusedImports: reserved for implementation
-import { AGENTS } from '../definitions/agents.mjs';
-// biome-ignore lint/correctness/noUnusedImports: reserved for implementation
-import { AGENT_BODIES } from '../definitions/bodies.mjs';
-// biome-ignore lint/correctness/noUnusedImports: reserved for implementation
-import { CLAUDE_MODELS, VARIANT_GROUPS } from '../definitions/models.mjs';
-import { PROMPTS } from '../definitions/prompts.mjs';
-// biome-ignore lint/correctness/noUnusedImports: reserved for implementation
-import { IDE_CAPABILITIES } from '../definitions/tools.mjs';
-
-export const CLAUDE_FLOWS_SECTION = [
-  '## Flows',
-  '',
-  "This project uses aikit's pluggable flow system. Check flow status with the `flow_status` MCP tool.",
-  "If a flow is active, follow the current step's skill instructions. Advance with `flow_step({ action: 'next' })`.",
-  'Use `flow_list` to see available flows and `flow_start` to begin one.',
-].join('\n');
-
-export const CLAUDE_ORCHESTRATOR_FLOW_ROUTING_SECTION = [
-  '## Flows',
-  '',
-  "This project uses aikit's pluggable flow system. Check flow status with the `flow_status` MCP tool.",
-  "If a flow is active, follow the current step's skill instructions. Advance with `flow_step({ action: 'next' })`.",
-  'Use `flow_list` to see available flows and `flow_start` to begin one.',
-].join('\n');
-
-// ── Command generator ──────────────────────────────────────────────
-/**
- * Generate a Claude Code slash command (.md) from a prompt definition.
- * Claude Code commands are plain markdown — no YAML frontmatter needed.
- * Invoked as /project:aikit-{name} in Claude Code.
- */
-function generateCommand(name, def) {
-  const lines = [];
-  lines.push(`# aikit ${name}`);
-  lines.push('');
-  if (def.description) {
-    lines.push(`> ${def.description}`);
-    lines.push('');
-  }
-  lines.push(def.content.trim());
-  lines.push('');
-  return lines.join('\n');
-}
-
-export function generateClaudeCode() {
-  const files = [];
-
-  // ── Slash commands from PROMPTS definitions ──────────────────────
-  for (const [name, def] of Object.entries(PROMPTS)) {
-    files.push({
-      path: `commands/aikit-${name}.md`,
-      content: generateCommand(name, def),
-    });
-  }
-
-  // TODO: Inline agent instructions into CLAUDE.md sections
-  // TODO: Generate .mcp.json (server name, env vars)
-
-  return files;
-}

package/scaffold/adapters/copilot.mjs

@@ -1,292 +0,0 @@
-/**
- * Copilot adapter — generates GitHub Copilot agent files from definitions.
- *
- * Output format:
- *   agents/{Name}.agent.md          — YAML frontmatter + markdown body
- *   agents/_shared/{name}.md        — Shared protocol files
- *   agents/templates/execution-state.md
- *   agents/README.md
- *   prompts/{name}.prompt.md        — YAML frontmatter + markdown body
- *
- * Copilot-specific conventions:
- *   - model field appends " (copilot)" suffix
- *   - tools are listed as YAML array in frontmatter
- *   - prompts target a specific agent via `agent:` field
- *   - hooks are embedded in copilot-instructions.md (not separate files)
- *   - plugins/skills are SKILL.md files in .github/skills/
- */
-
-import { AGENTS } from '../definitions/agents.mjs';
-import { AGENT_BODIES } from '../definitions/bodies.mjs';
-import { COPILOT_MODELS, VARIANT_GROUPS } from '../definitions/models.mjs';
-import { PROMPTS } from '../definitions/prompts.mjs';
-import { PROTOCOLS, TEMPLATES } from '../definitions/protocols.mjs';
-import { IDE_CAPABILITIES } from '../definitions/tools.mjs';
-
-// ─── Copilot tool mapping ─────────────────────────────────────────────────
-
-/** Map abstract IDE capability names to Copilot tool identifiers */
-const COPILOT_TOOL_MAP = {
-  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',
-  browser:
-    'browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog',
-};
-
-function buildToolsYaml(toolRole) {
-  const capabilities = IDE_CAPABILITIES[toolRole] || [];
-  const copilotTools = capabilities.map((cap) => COPILOT_TOOL_MAP[cap]).filter(Boolean);
-  // Use server wildcard instead of listing all 67 tools individually.
-  // VS Code expands `<server-name>/*` to all tools from that MCP server.
-  return `[${[...copilotTools, 'aikit/*'].join(', ')}]`;
-}
-
-function copilotModel(agentName) {
-  const models = COPILOT_MODELS[agentName];
-  if (!models) return 'Auto (copilot)';
-  // NOTE: Model array syntax (e.g. [model1, model2]) is experimental and
-  // requires a VS Code experiment flag to be enabled. For now, we always
-  // emit the primary (first) model as a plain string.
-  if (Array.isArray(models)) {
-    return models[0] || 'Auto (copilot)';
-  }
-  return models;
-}
-
-const FLOWS_SECTION = [
-  '## Flows',
-  '',
-  "This project uses aikit's pluggable flow system. Check flow status with the `flow_status` MCP tool.",
-  "If a flow is active, follow the current step's skill instructions. Advance with `flow_step({ action: 'next' })`.",
-  'Use `flow_list` to see available flows and `flow_start` to begin one.',
-].join('\n');
-
-// ─── Agent file generators ────────────────────────────────────────────────
-
-function buildAgentTable() {
-  const rows = [];
-  for (const [name, def] of Object.entries(AGENTS)) {
-    if (def.variants) {
-      for (const suffix of VARIANT_GROUPS[name] || []) {
-        const fullName = `${name}-${suffix}`;
-        const models = COPILOT_MODELS[fullName] || COPILOT_MODELS[name];
-        const model = Array.isArray(models) ? models[0] : models || 'Unknown';
-        const varDef = def.variants[suffix] || {};
-        const desc = varDef.description || def.description;
-        rows.push(`| **${fullName}** | ${desc} | ${model} | ${def.category} |`);
-      }
-    } else {
-      const models = COPILOT_MODELS[name];
-      const model = Array.isArray(models) ? models[0] : models || 'Unknown';
-      rows.push(`| **${name}** | ${def.description} | ${model} | ${def.category} |`);
-    }
-  }
-  return `| Agent | Purpose | Model | Category |\n|-------|---------|-------|----------|\n${rows.join('\n')}`;
-}
-
-function generateVariantAgent(roleName, suffix, def) {
-  const fullName = `${roleName}-${suffix}`;
-  const varDef = def.variants[suffix] || {};
-  const model = copilotModel(fullName);
-  const desc = varDef.description || def.description;
-  const identity =
-    varDef.identity ||
-    (suffix === VARIANT_GROUPS[roleName]?.[0]
-      ? `, the primary ${roleName} agent.`
-      : `, a variant of ${roleName}. Same responsibilities, different model perspective.`);
-
-  const sharedContent =
-    def.sharedBase && PROTOCOLS[def.sharedBase] ? `\n\n${PROTOCOLS[def.sharedBase]}` : '';
-
-  const extra = def.extraBody ? `\n\n${def.extraBody}` : '';
-  const variantAddendum = varDef.bodyAddendum ? `\n\n${varDef.bodyAddendum}` : '';
-
-  const skillsSection = def.skills?.length
-    ? `\n\n## Skills (load on demand)\n\n| Skill | When to load |\n|-------|--------------|\n${def.skills.map(([s, w]) => `| ${s} | ${w} |`).join('\n')}`
-    : '';
-
-  const title = def.title || roleName;
-
-  return `---
-description: '${desc}'
-${def.argumentHint ? `argument-hint: "${def.argumentHint}"\n` : ''}tools: ${buildToolsYaml(def.toolRole)}
-model: ${model}
----
-
-# ${fullName} - ${title}
-
-You are **${fullName}**${identity}${extra}
-${sharedContent}${variantAddendum}${skillsSection}
-
-${FLOWS_SECTION}
-`;
-}
-
-function generateSingleAgent(name, def) {
-  const model = copilotModel(name);
-  const body =
-    typeof AGENT_BODIES[name] === 'function'
-      ? AGENT_BODIES[name](buildAgentTable())
-      : AGENT_BODIES[name] || '';
-
-  const sharedContent =
-    def.sharedBase && PROTOCOLS[def.sharedBase] ? `\n\n${PROTOCOLS[def.sharedBase]}` : '';
-
-  const additionalContent = (def.sharedProtocols || [])
-    .map((key) => (PROTOCOLS[key] ? `\n\n${PROTOCOLS[key]}` : ''))
-    .join('');
-
-  const title = def.title || name;
-  const skillsSection = def.skills?.length
-    ? `\n## Skills (load on demand)\n\n| Skill | When to load |\n|-------|--------------|\n${def.skills.map(([s, w]) => `| ${s} | ${w} |`).join('\n')}\n`
-    : '';
-
-  return `---
-description: '${def.description}'
-${def.argumentHint ? `argument-hint: "${def.argumentHint}"\n` : ''}tools: ${buildToolsYaml(def.toolRole)}
-model: ${model}
----
-
-# ${name} - ${title}
-
-You are the **${name}**, ${def.description.toLowerCase().replace(/^./, (c) => c.toLowerCase())}
-
-${body}${sharedContent}${additionalContent}${skillsSection}
-
-${FLOWS_SECTION}
-`;
-}
-
-// ─── Prompt file generator ────────────────────────────────────────────────
-
-function generatePrompt(_name, def) {
-  // NOTE: Do NOT emit a `tools:` field in prompt files.
-  // Prompt `tools:` is an exclusive allowlist in VS Code — it replaces the
-  // agent's tools entirely. Since prompts only list aikit/* MCP tools (which
-  // are all deferred), the API rejects with "All tools cannot be deferred."
-  // Omitting `tools:` lets the prompt inherit the full tool set from `agent:`.
-  return `---
-description: "${def.description}"
-agent: "${def.agent}"
----
-
-${def.content}
-`;
-}
-
-// ─── README generator ─────────────────────────────────────────────────────
-
-function generateReadme() {
-  return `# Agents
-
-This directory contains AI agent definitions generated by \`@vpxa/aikit init\`.
-
-## Agent Roster
-
-${buildAgentTable()}
-
-## Multi-Model Pattern
-
-Variant agents (Researcher-Alpha/Beta/Gamma/Delta, Code-Reviewer-Alpha/Beta, Architect-Reviewer-Alpha/Beta) share the same methodology via files in \`_shared/\`. They differ only in which LLM model backs them — enabling multi-model decision analysis and dual-review workflows.
-
-**Agent names are model-agnostic.** The model behind Alpha/Beta/Gamma/Delta can be changed in \`scaffold/definitions/models.mjs\` without renaming any agent files.
-
-## Structure
-
-\`\`\`
-agents/
-  {Name}.agent.md          — Agent definition (YAML frontmatter + instructions)
-  _shared/                  — Shared protocols referenced by multiple agents
-    code-agent-base.md      — Base for all code-modifying agents
-    researcher-base.md      — Base for all Researcher variants
-    code-reviewer-base.md   — Base for all Code-Reviewer variants
-    architect-reviewer-base.md — Base for all Architect-Reviewer variants
-    decision-protocol.md    — Multi-model decision protocol rules
-    forge-protocol.md       — FORGE quality gate protocol
-  templates/
-    execution-state.md      — Orchestrator state tracking template
-    adr-template.md         — Architecture Decision Record template
-\`\`\`
-
-## Regenerating
-
-To regenerate after changing models or agent definitions:
-
-\`\`\`bash
-cd knowledge-base
-node scaffold/generate.mjs
-\`\`\`
-`;
-}
-
-// ─── Public API ───────────────────────────────────────────────────────────
-
-/**
- * Generate all Copilot scaffold files.
- * Returns an array of { path, content } objects.
- * The caller (generate.mjs) is responsible for writing them to disk.
- */
-export function generateCopilot() {
-  const files = [];
-
-  // Agent files
-  for (const [name, def] of Object.entries(AGENTS)) {
-    if (def.variants) {
-      for (const suffix of VARIANT_GROUPS[name] || []) {
-        files.push({
-          path: `agents/${name}-${suffix}.agent.md`,
-          content: generateVariantAgent(name, suffix, def),
-        });
-      }
-    } else {
-      files.push({
-        path: `agents/${name}.agent.md`,
-        content: generateSingleAgent(name, def),
-      });
-    }
-  }
-
-  // Shared protocols
-  for (const [name, content] of Object.entries(PROTOCOLS)) {
-    files.push({ path: `agents/_shared/${name}.md`, content: `${content}\n` });
-  }
-
-  // Templates
-  for (const [name, content] of Object.entries(TEMPLATES)) {
-    files.push({ path: `agents/templates/${name}.md`, content: `${content}\n` });
-  }
-
-  // README
-  files.push({ path: 'agents/README.md', content: generateReadme() });
-
-  // Prompts
-  for (const [name, def] of Object.entries(PROMPTS)) {
-    files.push({ path: `prompts/aikit-${name}.prompt.md`, content: generatePrompt(name, def) });
-  }
-
-  return files;
-}