@vpxa/aikit 0.1.23 → 0.1.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpxa/aikit",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "type": "module",
   "description": "Local-first AI developer toolkit — knowledge base, code analysis, context management, and developer tools for LLM agents",
   "license": "MIT",

package/packages/cli/dist/commands/init/templates.js

@@ -71,6 +71,31 @@ This project has specialized agents in \`.github/agents/\`. Use them instead of
 | Documentation | **Documenter** | Comprehensive project docs |
 
 Check \`.github/agents/\` for the full list of available agents.
+
+## Persistent Memory
+
+AI Kit provides cross-session persistent memory. **Use it actively** — decisions, patterns, and context that survive between conversations.
+
+| Action | Tool | Example |
+|--------|------|---------|
+| Store | \`remember\` | \`remember({ title: "Auth uses JWT RS256", content: "...", category: "decisions" })\` |
+| Search | \`search\` | \`search({ query: "authentication", origin: "curated" })\` |
+| Browse | \`list\` | \`list()\` or \`list({ category: "decisions" })\` |
+| Read | \`read\` | \`read({ id: "<entry-id>" })\` |
+| Update | \`update\` | \`update({ id: "<entry-id>", content: "Updated info" })\` |
+| Remove | \`forget\` | \`forget({ id: "<entry-id>" })\` |
+
+**Categories:** \`conventions\`, \`decisions\`, \`patterns\`, \`context\`, \`session\`
+
+**Session checkpoint** (do at end of every session):
+\`\`\`
+remember({ title: "Session checkpoint: <topic>", content: "Done: ... / Decisions: ... / Next: ... / Blockers: ...", category: "session" })
+\`\`\`
+
+**Session resume** (do at start of every session):
+\`\`\`
+search({ query: "SESSION CHECKPOINT", origin: "curated" })
+\`\`\`
 `}function t(e,t){return`# ${e} — Agent Instructions
 
 ## AI Kit MCP Server (\`${t}\`)
@@ -168,6 +193,31 @@ For long sessions or context approaching capacity, use the \`session-handoff\` s
 
 ---
 
+## Persistent Memory (Long-Term Knowledge)
+
+AI Kit provides cross-session persistent memory via curated knowledge. **Use it actively** to remember decisions, patterns, and context across conversations.
+
+### Writing
+| Tool | Purpose | Example |
+|------|---------|---------|
+| \`remember\` | Store new entry | \`remember({ title: "Auth uses JWT RS256", content: "All API auth uses RS256...", category: "decisions" })\` |
+| \`update\` | Modify existing | \`update({ id: "<id>", content: "Updated info" })\` |
+| \`produce_knowledge\` | Auto-generate from code | \`produce_knowledge({ path: "src/" })\` |
+
+### Reading
+| Tool | Purpose | Example |
+|------|---------|---------|
+| \`list\` | Browse entries | \`list()\` or \`list({ category: "decisions" })\` |
+| \`read\` | Read by ID | \`read({ id: "<id>" })\` |
+| \`search\` | Find by content | \`search({ query: "auth", origin: "curated" })\` |
+| \`forget\` | Remove outdated | \`forget({ id: "<id>" })\` |
+
+**Categories:** \`conventions\` · \`decisions\` · \`patterns\` · \`context\` · \`session\`
+
+**Best practices:** Remember *why* not *what*. Search before remembering (avoid duplicates). Checkpoint at milestones. Clean up outdated entries.
+
+---
+
 ## Search Modes
 
 | Mode | When | Example |

package/packages/cli/dist/commands/init/user.js

@@ -1,4 +1,4 @@
-import{FLOW_DIRS as e,MCP_SERVER_ENTRY as t,SERVER_NAME as n,SKILL_NAMES as r,VSCODE_SETTINGS as i}from"./constants.js";import{buildAgentsMd as a,buildCopilotInstructions as o}from"./templates.js";import{smartCopySubdir as s}from"./scaffold.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,resolve as h}from"node:path";import{fileURLToPath as g}from"node:url";import{getGlobalDataDir as _,saveRegistry as v}from"../../../../core/dist/index.js";import{homedir as y}from"node:os";function b(){let e=y(),t=process.platform,n=[],r=h(e,`.copilot`),i=h(r,`instructions`),a=h(e,`.claude`),o=h(e,`.cursor`),s=h(e,`.windsurf`);if(t===`win32`){let t=process.env.APPDATA??h(e,`AppData`,`Roaming`);n.push({ide:`VS Code`,configDir:h(t,`Code`,`User`),mcpConfigPath:h(t,`Code`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VS Code Insiders`,configDir:h(t,`Code - Insiders`,`User`),mcpConfigPath:h(t,`Code - Insiders`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VSCodium`,configDir:h(t,`VSCodium`,`User`),mcpConfigPath:h(t,`VSCodium`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`Cursor`,configDir:h(t,`Cursor`,`User`),mcpConfigPath:h(t,`Cursor`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Cursor Nightly`,configDir:h(t,`Cursor Nightly`,`User`),mcpConfigPath:h(t,`Cursor Nightly`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Windsurf`,configDir:h(t,`Windsurf`,`User`),mcpConfigPath:h(t,`Windsurf`,`User`,`mcp.json`),globalScaffoldRoot:s,instructionsRoot:null})}else if(t===`darwin`){let t=h(e,`Library`,`Application Support`);n.push({ide:`VS Code`,configDir:h(t,`Code`,`User`),mcpConfigPath:h(t,`Code`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VS Code Insiders`,configDir:h(t,`Code - Insiders`,`User`),mcpConfigPath:h(t,`Code - Insiders`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VSCodium`,configDir:h(t,`VSCodium`,`User`),mcpConfigPath:h(t,`VSCodium`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`Cursor`,configDir:h(t,`Cursor`,`User`),mcpConfigPath:h(t,`Cursor`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Cursor Nightly`,configDir:h(t,`Cursor Nightly`,`User`),mcpConfigPath:h(t,`Cursor Nightly`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Windsurf`,configDir:h(t,`Windsurf`,`User`),mcpConfigPath:h(t,`Windsurf`,`User`,`mcp.json`),globalScaffoldRoot:s,instructionsRoot:null})}else{let t=process.env.XDG_CONFIG_HOME??h(e,`.config`);n.push({ide:`VS Code`,configDir:h(t,`Code`,`User`),mcpConfigPath:h(t,`Code`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VS Code Insiders`,configDir:h(t,`Code - Insiders`,`User`),mcpConfigPath:h(t,`Code - Insiders`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VSCodium`,configDir:h(t,`VSCodium`,`User`),mcpConfigPath:h(t,`VSCodium`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`Cursor`,configDir:h(t,`Cursor`,`User`),mcpConfigPath:h(t,`Cursor`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Cursor Nightly`,configDir:h(t,`Cursor Nightly`,`User`),mcpConfigPath:h(t,`Cursor Nightly`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Windsurf`,configDir:h(t,`Windsurf`,`User`),mcpConfigPath:h(t,`Windsurf`,`User`,`mcp.json`),globalScaffoldRoot:s,instructionsRoot:null})}return n.push({ide:`Claude Code`,configDir:h(e,`.claude`),mcpConfigPath:h(e,`.claude`,`mcp.json`),globalScaffoldRoot:a,instructionsRoot:null}),n.push({ide:`Copilot CLI`,configDir:r,mcpConfigPath:h(r,`mcp-config.json`),globalScaffoldRoot:null,instructionsRoot:null}),n.filter(e=>c(e.configDir))}function x(e,n,r=!1){let{mcpConfigPath:i,configDir:a}=e,o={...t},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??{})[n]&&!r){console.log(`  ${e.ide}: ${n} 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[n]={...o,tools:[`*`]}:f[n]=o,s[d]=f,l(a,{recursive:!0}),p(i,`${JSON.stringify(s,null,2)}\n`,`utf-8`),console.log(`  ${e.ide}: configured ${n} in ${i}`)}const S=new Set([`VS Code`,`VS Code Insiders`,`VSCodium`]);function C(e,t=!1){if(!S.has(e.ide))return;let n=h(e.configDir,`settings.json`),r={};if(c(n))try{let e=u(n,`utf-8`);r=JSON.parse(e)}catch{console.log(`  ${e.ide}: skipped settings.json (invalid JSON)`);return}let a=!1;for(let[e,n]of Object.entries(i))if(typeof n==`object`&&n){let t=typeof r[e]==`object`&&r[e]!==null?r[e]:{},i={...t,...n};JSON.stringify(i)!==JSON.stringify(t)&&(r[e]=i,a=!0)}else (t||!(e in r))&&(r[e]=n,a=!0);a&&(p(n,`${JSON.stringify(r,null,2)}\n`,`utf-8`),console.log(`  ${e.ide}: updated settings.json`))}function w(t,n,i,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 g=h(t,`scaffold`,`general`);for(let n of m){s(g,n,`agents`,u,f),s(g,n,`prompts`,u,f);let i=0;for(let e of r)c(h(g,`skills`,e))&&(s(g,n,`skills/${e}`,u,f),i++);for(let r of e){let e=h(t,`scaffold`,`flows`,r);if(!c(h(e,`steps`)))continue;let i=h(n,`flows`,r);l(i,{recursive:!0});let a=h(i,`skills`);c(a)&&(d(a,{recursive:!0,force:!0}),console.log(`  ${n}: migrated ${r} flow to steps/ layout`)),s(e,i,`steps`,u,f)}console.log(`  ${n}: scaffold updated (${i} skills)`)}let _=new Set,v=o(`aikit`,i),y=a(`aikit`,i);for(let e of n){if(!e.globalScaffoldRoot)continue;let t=e.globalScaffoldRoot;if(e.ide===`Claude Code`){let e=h(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=h(n,`copilot-instructions.md`);_.has(r)||(p(r,`---\napplyTo: "**"\n---\n\n${v}\n---\n\n${y}`,`utf-8`),_.add(r))}else if(e.ide===`Cursor`||e.ide===`Cursor Nightly`){let e=h(t,`rules`);l(e,{recursive:!0});let n=h(e,`aikit.mdc`);_.has(n)||(p(n,`${v}\n---\n\n${y}`,`utf-8`),_.add(n))}else if(e.ide===`Windsurf`){let e=h(t,`rules`);l(e,{recursive:!0});let n=h(e,`aikit.md`);_.has(n)||(p(n,`${v}\n---\n\n${y}`,`utf-8`),_.add(n))}}_.size>0&&console.log(`  Instruction files: ${[..._].join(`, `)}`)}function T(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(h(r,`kb.instructions.md`)),t.push(h(r,`aikit.instructions.md`))}else n.ide===`Cursor`||n.ide===`Cursor Nightly`?t.push(h(e,`rules`,`kb.mdc`)):n.ide===`Windsurf`&&t.push(h(e,`rules`,`kb.md`))}for(let e of t)c(e)&&(f(e),console.log(`  Removed legacy file: ${e}`))}async function E(e){let t=n,r=h(m(g(import.meta.url)),`..`,`..`,`..`,`..`,`..`,`package.json`),i=JSON.parse(u(r,`utf-8`)).version;console.log(`Initializing @vpxa/aikit v${i}...\n`);let a=_();l(a,{recursive:!0}),console.log(`  Global data store: ${a}`),v({version:1,workspaces:{}}),console.log(`  Created registry.json`);let o=b();if(o.length===0)console.log(`
+import{FLOW_DIRS as e,MCP_SERVER_ENTRY as t,SERVER_NAME as n,SKILL_NAMES as r,VSCODE_SETTINGS as i}from"./constants.js";import{buildAgentsMd as a,buildCopilotInstructions as o}from"./templates.js";import{smartCopySubdir as s}from"./scaffold.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,resolve as h}from"node:path";import{fileURLToPath as g}from"node:url";import{getGlobalDataDir as _,saveRegistry as v}from"../../../../core/dist/index.js";import{homedir as y}from"node:os";function b(){let e=y(),t=process.platform,n=[],r=h(e,`.copilot`),i=h(r,`instructions`),a=h(e,`.claude`),o=h(e,`.cursor`),s=h(e,`.windsurf`);if(t===`win32`){let t=process.env.APPDATA??h(e,`AppData`,`Roaming`);n.push({ide:`VS Code`,configDir:h(t,`Code`,`User`),mcpConfigPath:h(t,`Code`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VS Code Insiders`,configDir:h(t,`Code - Insiders`,`User`),mcpConfigPath:h(t,`Code - Insiders`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VSCodium`,configDir:h(t,`VSCodium`,`User`),mcpConfigPath:h(t,`VSCodium`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`Cursor`,configDir:h(t,`Cursor`,`User`),mcpConfigPath:h(t,`Cursor`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Cursor Nightly`,configDir:h(t,`Cursor Nightly`,`User`),mcpConfigPath:h(t,`Cursor Nightly`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Windsurf`,configDir:h(t,`Windsurf`,`User`),mcpConfigPath:h(t,`Windsurf`,`User`,`mcp.json`),globalScaffoldRoot:s,instructionsRoot:null})}else if(t===`darwin`){let t=h(e,`Library`,`Application Support`);n.push({ide:`VS Code`,configDir:h(t,`Code`,`User`),mcpConfigPath:h(t,`Code`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VS Code Insiders`,configDir:h(t,`Code - Insiders`,`User`),mcpConfigPath:h(t,`Code - Insiders`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VSCodium`,configDir:h(t,`VSCodium`,`User`),mcpConfigPath:h(t,`VSCodium`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`Cursor`,configDir:h(t,`Cursor`,`User`),mcpConfigPath:h(t,`Cursor`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Cursor Nightly`,configDir:h(t,`Cursor Nightly`,`User`),mcpConfigPath:h(t,`Cursor Nightly`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Windsurf`,configDir:h(t,`Windsurf`,`User`),mcpConfigPath:h(t,`Windsurf`,`User`,`mcp.json`),globalScaffoldRoot:s,instructionsRoot:null})}else{let t=process.env.XDG_CONFIG_HOME??h(e,`.config`);n.push({ide:`VS Code`,configDir:h(t,`Code`,`User`),mcpConfigPath:h(t,`Code`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VS Code Insiders`,configDir:h(t,`Code - Insiders`,`User`),mcpConfigPath:h(t,`Code - Insiders`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`VSCodium`,configDir:h(t,`VSCodium`,`User`),mcpConfigPath:h(t,`VSCodium`,`User`,`mcp.json`),globalScaffoldRoot:r,instructionsRoot:i},{ide:`Cursor`,configDir:h(t,`Cursor`,`User`),mcpConfigPath:h(t,`Cursor`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Cursor Nightly`,configDir:h(t,`Cursor Nightly`,`User`),mcpConfigPath:h(t,`Cursor Nightly`,`User`,`mcp.json`),globalScaffoldRoot:o,instructionsRoot:null},{ide:`Windsurf`,configDir:h(t,`Windsurf`,`User`),mcpConfigPath:h(t,`Windsurf`,`User`,`mcp.json`),globalScaffoldRoot:s,instructionsRoot:null})}return n.push({ide:`Claude Code`,configDir:h(e,`.claude`),mcpConfigPath:h(e,`.claude`,`mcp.json`),globalScaffoldRoot:a,instructionsRoot:null}),n.push({ide:`Copilot CLI`,configDir:r,mcpConfigPath:h(r,`mcp-config.json`),globalScaffoldRoot:null,instructionsRoot:null}),n.filter(e=>c(e.configDir))}function x(e,n,r=!1){let{mcpConfigPath:i,configDir:a}=e,o={...t},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??{})[n]&&!r){console.log(`  ${e.ide}: ${n} 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[n]={...o,tools:[`*`]}:f[n]=o,s[d]=f,l(a,{recursive:!0}),p(i,`${JSON.stringify(s,null,2)}\n`,`utf-8`),console.log(`  ${e.ide}: configured ${n} in ${i}`)}const S=new Set([`VS Code`,`VS Code Insiders`,`VSCodium`]);function C(e,t=!1){if(!S.has(e.ide))return;let n=h(e.configDir,`settings.json`),r={};if(c(n))try{let e=u(n,`utf-8`);r=JSON.parse(e)}catch{console.log(`  ${e.ide}: skipped settings.json (invalid JSON)`);return}let a=!1;for(let[e,n]of Object.entries(i))if(typeof n==`object`&&n){let t=typeof r[e]==`object`&&r[e]!==null?r[e]:{},i={...t,...n};JSON.stringify(i)!==JSON.stringify(t)&&(r[e]=i,a=!0)}else (t||!(e in r))&&(r[e]=n,a=!0);a&&(p(n,`${JSON.stringify(r,null,2)}\n`,`utf-8`),console.log(`  ${e.ide}: updated settings.json`))}function w(t,n,i,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 g=h(t,`scaffold`,`general`);for(let n of m){s(g,n,`agents`,u,f),s(g,n,`prompts`,u,f);let i=0;for(let e of r)c(h(g,`skills`,e))&&(s(g,n,`skills/${e}`,u,f),i++);for(let r of e){let e=h(t,`scaffold`,`flows`,r);if(!c(h(e,`steps`)))continue;let i=h(n,`flows`,r);l(i,{recursive:!0});let a=h(i,`skills`);c(a)&&(d(a,{recursive:!0,force:!0}),console.log(`  ${n}: migrated ${r} flow to steps/ layout`)),s(e,i,`steps`,u,f)}console.log(`  ${n}: scaffold updated (${i} skills)`)}let _=new Set,v=o(`aikit`,i),b=a(`aikit`,i);for(let e of n){if(!e.globalScaffoldRoot)continue;let t=e.globalScaffoldRoot;if(e.ide===`Claude Code`){let e=h(t,`CLAUDE.md`);p(e,`${v}\n---\n\n${b}`,`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=h(n,`copilot-instructions.md`);_.has(r)||(p(r,`---\napplyTo: "**"\n---\n\n${v}\n---\n\n${b}`,`utf-8`),_.add(r));let i=h(y(),`.github`),a=h(i,`copilot-instructions.md`);_.has(a)||(l(i,{recursive:!0}),p(a,`${v}\n---\n\n${b}`,`utf-8`),_.add(a))}else if(e.ide===`Cursor`||e.ide===`Cursor Nightly`){let e=h(t,`rules`);l(e,{recursive:!0});let n=h(e,`aikit.mdc`);_.has(n)||(p(n,`${v}\n---\n\n${b}`,`utf-8`),_.add(n))}else if(e.ide===`Windsurf`){let e=h(t,`rules`);l(e,{recursive:!0});let n=h(e,`aikit.md`);_.has(n)||(p(n,`${v}\n---\n\n${b}`,`utf-8`),_.add(n))}}_.size>0&&console.log(`  Instruction files: ${[..._].join(`, `)}`)}function T(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(h(r,`kb.instructions.md`)),t.push(h(r,`aikit.instructions.md`))}else n.ide===`Cursor`||n.ide===`Cursor Nightly`?t.push(h(e,`rules`,`kb.mdc`)):n.ide===`Windsurf`&&t.push(h(e,`rules`,`kb.md`))}for(let e of t)c(e)&&(f(e),console.log(`  Removed legacy file: ${e}`))}async function E(e){let t=n,r=h(m(g(import.meta.url)),`..`,`..`,`..`,`..`,`..`,`package.json`),i=JSON.parse(u(r,`utf-8`)).version;console.log(`Initializing @vpxa/aikit v${i}...\n`);let a=_();l(a,{recursive:!0}),console.log(`  Global data store: ${a}`),v({version:1,workspaces:{}}),console.log(`  Created registry.json`);let o=b();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)x(n,t,e.force),C(n,e.force)}let s=h(m(g(import.meta.url)),`..`,`..`,`..`,`..`,`..`);console.log(`
   Installing scaffold files:`),w(s,o,t,i,e.force),T(o),console.log(`
 User-level AI Kit installation complete!`),console.log(`

package/scaffold/adapters/copilot.mjs

@@ -66,10 +66,11 @@ function buildToolsYaml(toolRole) {
 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)) {
-    if (models.length === 0) return 'Auto (copilot)';
-    if (models.length === 1) return models[0];
-    return `[${models.join(', ')}]`;
+    return models[0] || 'Auto (copilot)';
   }
   return models;
 }

package/scaffold/definitions/models.mjs

@@ -7,6 +7,12 @@
  *
  * Naming convention for variants: {Role}-Alpha, {Role}-Beta, {Role}-Gamma, {Role}-Delta
  * These are abstract labels — the actual model behind each is defined HERE.
+ *
+ * NOTE (Experimental): VS Code supports a model array syntax (e.g. [model1, model2])
+ * for agent files, but it requires an experiment flag to be enabled. Until the flag
+ * is generally available, adapters should emit only the first (primary) model as a
+ * plain string. The full fallback arrays are retained here so adapters can switch to
+ * array output when the flag is GA.
  */
 
 export const COPILOT_MODELS = {

package/scaffold/general/agents/Architect-Reviewer-Alpha.agent.md

@@ -2,7 +2,7 @@
 description: 'Primary architecture reviewer'
 argument-hint: "Files, PR, or subsystem to architecture-review"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [GPT-5.4 (copilot), Auto (copilot)]
+model: GPT-5.4 (copilot)
 ---
 
 # Architect-Reviewer-Alpha - The Structural Guardian

package/scaffold/general/agents/Architect-Reviewer-Beta.agent.md

@@ -2,7 +2,7 @@
 description: 'Architecture reviewer variant — different LLM perspective for dual review'
 argument-hint: "Files, PR, or subsystem to architecture-review"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Opus 4.6 (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Architect-Reviewer-Beta - The Structural Guardian

package/scaffold/general/agents/Code-Reviewer-Alpha.agent.md

@@ -2,7 +2,7 @@
 description: 'Primary code reviewer'
 argument-hint: "File path, PR, or code to review"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [GPT-5.4 (copilot), Auto (copilot)]
+model: GPT-5.4 (copilot)
 ---
 
 # Code-Reviewer-Alpha - The Quality Guardian

package/scaffold/general/agents/Code-Reviewer-Beta.agent.md

@@ -2,7 +2,7 @@
 description: 'Code reviewer variant — different LLM perspective for dual review'
 argument-hint: "File path, PR, or code to review"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Opus 4.6 (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Code-Reviewer-Beta - The Quality Guardian

package/scaffold/general/agents/Debugger.agent.md

@@ -2,7 +2,7 @@
 description: 'Expert debugger that diagnoses issues, traces errors, and provides solutions'
 argument-hint: "Error message, stack trace, or description of issue"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalSelection, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, search/changes, search/codebase, search/usages, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Opus 4.6 (copilot), GPT-5.4 (copilot), GPT-5.3-Codex (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Debugger - The Problem Solver

package/scaffold/general/agents/Documenter.agent.md

@@ -2,7 +2,7 @@
 description: 'Documentation specialist that creates and maintains comprehensive project documentation'
 argument-hint: "Component, API, feature, or area to document"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [GPT-5.4 (copilot), Gemini 3.1 Pro (Preview) (copilot), Auto (copilot)]
+model: GPT-5.4 (copilot)
 ---
 
 # Documenter - The Knowledge Keeper

package/scaffold/general/agents/Explorer.agent.md

@@ -2,7 +2,7 @@
 description: 'Rapid codebase exploration to find files, usages, dependencies, and structural context'
 argument-hint: "Find files, usages, and context related to: {topic or goal}"
 tools: [read/problems, read/readFile, search/changes, search/codebase, search/usages, search/fileSearch, search/listDirectory, search/textSearch, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Gemini 3 Flash (Preview) (copilot), Claude Haiku 4.5 (copilot), Auto (copilot)]
+model: Gemini 3 Flash (Preview) (copilot)
 ---
 
 # Explorer - The Rapid Scout

package/scaffold/general/agents/Frontend.agent.md

@@ -2,7 +2,7 @@
 description: 'UI/UX specialist for React, styling, responsive design, and frontend implementation'
 argument-hint: "UI component, styling task, or frontend feature"
 tools: [execute/createAndRunTask, execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, todo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Gemini 3.1 Pro (Preview) (copilot), GPT-5.4 (copilot), GPT-5.3-Codex (copilot), Auto (copilot)]
+model: Gemini 3.1 Pro (Preview) (copilot)
 ---
 
 # Frontend - The UI Specialist

package/scaffold/general/agents/Implementer.agent.md

@@ -2,7 +2,7 @@
 description: 'Persistent implementation agent that writes code following TDD practices until all tasks are complete'
 argument-hint: "Implementation task, feature, or phase from plan"
 tools: [execute/createAndRunTask, execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, todo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [GPT-5.4 (copilot), Gemini 3.1 Pro (Preview) (copilot), GPT-5.3-Codex (copilot), Auto (copilot)]
+model: GPT-5.4 (copilot)
 ---
 
 # Implementer - The Code Builder

package/scaffold/general/agents/Orchestrator.agent.md

@@ -1,7 +1,7 @@
 ---
 description: 'Master conductor that orchestrates the full development lifecycle: Planning → Implementation → Review → Recovery → Commit'
 tools: [vscode/memory, vscode/runCommand, vscode/switchAgent, execute/killTerminal, execute/createAndRunTask, execute/runInTerminal, read/terminalSelection, read/terminalLastCommand, read/problems, read/readFile, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, todo, search/searchSubagent, search/textSearch, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, vscode/askQuestions, vscode/resolveMemoryFileUri, aikit/*]
-model: [Claude Opus 4.6 (copilot), GPT-5.4 (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Orchestrator - The Master Conductor

package/scaffold/general/agents/Planner.agent.md

@@ -1,7 +1,7 @@
 ---
 description: 'Autonomous planner that researches codebases and writes comprehensive TDD implementation plans'
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, todo, search/searchSubagent, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Opus 4.6 (copilot), GPT-5.4 (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Planner - The Strategic Architect

package/scaffold/general/agents/Refactor.agent.md

@@ -2,7 +2,7 @@
 description: 'Code refactoring specialist that improves structure, readability, and maintainability'
 argument-hint: "Code, component, or pattern to refactor"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, edit/createFile, edit/editFiles, edit/rename, edit/createDirectory, search/changes, search/codebase, search/usages, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [GPT-5.4 (copilot), GPT-5.3-Codex (copilot), Auto (copilot)]
+model: GPT-5.4 (copilot)
 ---
 
 # Refactor - The Code Sculptor

package/scaffold/general/agents/Researcher-Alpha.agent.md

@@ -2,7 +2,7 @@
 description: 'Primary deep research agent — also serves as default Researcher'
 argument-hint: "Research question, problem statement, or subsystem to investigate"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Opus 4.6 (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Researcher-Alpha - The Context Gatherer

package/scaffold/general/agents/Researcher-Beta.agent.md

@@ -2,7 +2,7 @@
 description: 'Research variant — pragmatic analysis with focus on trade-offs and edge cases'
 argument-hint: "Research question, problem statement, or subsystem to investigate"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Sonnet 4.6 (copilot), Auto (copilot)]
+model: Claude Sonnet 4.6 (copilot)
 ---
 
 # Researcher-Beta - The Context Gatherer

package/scaffold/general/agents/Researcher-Delta.agent.md

@@ -2,7 +2,7 @@
 description: 'Research variant — implementation feasibility and performance implications'
 argument-hint: "Research question, problem statement, or subsystem to investigate"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Gemini 3.1 Pro (Preview) (copilot), Auto (copilot)]
+model: Gemini 3.1 Pro (Preview) (copilot)
 ---
 
 # Researcher-Delta - The Context Gatherer

package/scaffold/general/agents/Researcher-Gamma.agent.md

@@ -2,7 +2,7 @@
 description: 'Research variant — broad pattern matching across domains and technologies'
 argument-hint: "Research question, problem statement, or subsystem to investigate"
 tools: [execute/runInTerminal, read/problems, read/readFile, read/terminalLastCommand, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [GPT-5.4 (copilot), Auto (copilot)]
+model: GPT-5.4 (copilot)
 ---
 
 # Researcher-Gamma - The Context Gatherer

package/scaffold/general/agents/Security.agent.md

@@ -2,7 +2,7 @@
 description: 'Security specialist that analyzes code for vulnerabilities and compliance'
 argument-hint: "Code, feature, or component to security review"
 tools: [execute/runInTerminal, read/problems, read/readFile, agent/runSubagent, search/changes, search/codebase, search/usages, web/fetch, web/githubRepo, browser/openBrowserPage, browser/readPage, browser/screenshotPage, browser/navigatePage, browser/clickElement, browser/dragElement, browser/hoverElement, browser/typeInPage, browser/runPlaywrightCode, browser/handleDialog, aikit/*]
-model: [Claude Opus 4.6 (copilot), GPT-5.4 (copilot), Auto (copilot)]
+model: Claude Opus 4.6 (copilot)
 ---
 
 # Security - The Vulnerability Hunter

package/scaffold/general/skills/aikit/SKILL.md

@@ -414,6 +414,73 @@ git_context({ diff: true })
 → check({}) → test_run({})
 ```
 
+---
+
+## Persistent Memory (Long-Term Knowledge)
+
+AI Kit provides cross-session persistent memory via a curated knowledge store. Use it to remember decisions, patterns, conventions, and context that should survive beyond the current conversation.
+
+### Writing to Memory
+
+| Tool | Purpose | Example |
+|------|---------|---------|
+| `remember` | Store a new knowledge entry | `remember({ title: "Auth uses JWT RS256", content: "All API auth uses RS256 JWT tokens issued by /auth/token. Refresh via httpOnly cookie.", category: "decisions" })` |
+| `update` | Modify an existing entry | `update({ id: "<entry-id>", content: "Updated: now also supports Ed25519" })` |
+| `produce_knowledge` | Auto-generate analysis entries from code | `produce_knowledge({ path: "src/" })` |
+
+**Categories** — use these to organize entries:
+- `conventions` — coding standards, naming rules, file organization
+- `decisions` — architecture decisions, technology choices, trade-offs made
+- `patterns` — recurring code patterns, design patterns in use
+- `context` — project context, domain knowledge, business rules
+- `session` — session checkpoints for resuming work
+
+### Reading from Memory
+
+| Tool | Purpose | Example |
+|------|---------|---------|
+| `list` | Browse all stored entries | `list()` or `list({ category: "decisions" })` |
+| `read` | Read a specific entry by ID | `read({ id: "<entry-id>" })` |
+| `search` | Find entries by content/query | `search({ query: "authentication", origin: "curated" })` |
+| `forget` | Remove an outdated entry | `forget({ id: "<entry-id>" })` |
+
+### When to Remember
+
+| Situation | What to store | Category |
+|-----------|--------------|----------|
+| Architecture decision made | Decision + rationale + alternatives considered | `decisions` |
+| Pattern discovered in codebase | Pattern description + example locations | `patterns` |
+| Convention established | Rule + enforcement approach | `conventions` |
+| Session ending | Checkpoint: what was done, what's next, blockers | `session` |
+| Bug root cause found | Root cause + fix approach + prevention strategy | `context` |
+| External API behavior learned | Behavior quirks, rate limits, gotchas | `context` |
+
+### Session Checkpoint Pattern
+
+At the END of every meaningful work session:
+```
+remember({
+  title: "Session checkpoint: <topic>",
+  content: "## Done\n- <completed items>\n\n## Decisions\n- <key decisions made>\n\n## Next\n- <pending work>\n\n## Blockers\n- <issues encountered>",
+  category: "session"
+})
+```
+
+At the START of the next session:
+```
+search({ query: "SESSION CHECKPOINT", origin: "curated" })    # Find last checkpoint
+list({ category: "session" })                                  # Browse all checkpoints
+```
+
+### Memory Best Practices
+
+1. **Remember decisions, not code** — store *why*, not *what*. Code changes; rationale persists.
+2. **Search before remembering** — avoid duplicates: `search({ query: "..." })` first.
+3. **Use categories** — structured categories enable filtered `list()` queries.
+4. **Checkpoint regularly** — don't wait for session end. Checkpoint at milestones.
+5. **Clean up** — `forget()` outdated entries. Memory is only valuable when accurate.
+6. **Cross-reference** — mention related entry titles in content for discoverability.
+
 ## CLI Quick Reference
 
 ```bash