@vpxa/aikit 0.1.73 → 0.1.74

package/scaffold/definitions/exclusions.mjs

@@ -0,0 +1,58 @@
+/**
+ * Permanent Exclusions — things aikit intentionally will NOT do.
+ *
+ * Each exclusion includes rationale grounded in the Bitter Lesson:
+ * systems should leverage computation over hand-crafted features.
+ * These exclusions are injected into copilot-instructions.md.
+ */
+
+export const PERMANENT_EXCLUSIONS = [
+  {
+    name: 'Hard-coded lint rules',
+    rationale:
+      'Project-specific linting belongs in ESLint or Biome config, not baked into agent instructions. Configurable tooling and automated checks scale better than hand-crafted rules embedded in prompts.',
+    bitterLessonSafe: true,
+  },
+
+  {
+    name: 'Framework-specific boilerplate generation',
+    rationale:
+      'Framework CLIs and IDE scaffolds already generate boilerplate from evolving upstream knowledge. Delegating to those computational systems is safer than freezing hand-written templates into aikit instructions.',
+    bitterLessonSafe: true,
+  },
+
+  {
+    name: 'Git workflow enforcement',
+    rationale:
+      'Branch policies, commit formatting, and merge gates belong in git hooks and CI where they can be enforced automatically. Reliable computation beats informal agent-side reminders and hand-crafted behavior rules.',
+    bitterLessonSafe: true,
+  },
+
+  {
+    name: 'IDE-specific keybinding and config guidance',
+    rationale:
+      'Editor shortcuts, panel layouts, and workspace settings are IDE concerns that change across clients and teams. Runtime tooling and local editor config are the right computational layer, not static agent instructions.',
+    bitterLessonSafe: true,
+  },
+
+  {
+    name: 'Package manager lock file manipulation',
+    rationale:
+      'Lock files should be produced by the package manager and verified in CI or release pipelines, not manually curated by agent policy. Deterministic tool execution is more robust than hand-crafted lockfile guidance.',
+    bitterLessonSafe: true,
+  },
+
+  {
+    name: 'Hard-coded file naming conventions',
+    rationale:
+      'Naming rules vary by repository and should live in project generators, linters, or review automation. Letting configurable computation enforce conventions scales better than embedding brittle file-name doctrine in prompts.',
+    bitterLessonSafe: true,
+  },
+
+  {
+    name: 'Runtime environment variable validation',
+    rationale:
+      'Environment validation belongs in application startup code, schemas, and deployment checks where real runtime state is available. Computed validation with executable code outperforms hand-crafted agent assumptions about env shape.',
+    bitterLessonSafe: true,
+  },
+];

package/scaffold/definitions/plugins.mjs

@@ -5,143 +5,143 @@
  * Claude Code: Maps to tool_use permissions and MCP config
  * Claude Code: Referenced via CLAUDE.md or MCP
  *
- * Skills are NOT generated — they live in scaffold/general/skills/.
+ * Skills are NOT generated — they live in scaffold/skills/.
  * This file defines WHICH skills to copy and their metadata.
  */
 
 export const PLUGINS = {
   aikit: {
     description: 'AI Kit search, analysis, memory, and developer tools',
-    source: 'scaffold/general/skills/aikit/SKILL.md',
+    source: 'scaffold/skills/aikit/SKILL.md',
     required: true,
   },
 
   brainstorming: {
     description: 'Brainstorming & design exploration workflow',
-    source: 'scaffold/general/skills/brainstorming/SKILL.md',
+    source: 'scaffold/skills/brainstorming/SKILL.md',
     required: true,
-    sidecars: ['scaffold/general/skills/brainstorming/spec-document-reviewer-prompt.md'],
+    sidecars: ['scaffold/skills/brainstorming/spec-document-reviewer-prompt.md'],
   },
 
   'multi-agents-development': {
     description:
       'Multi-agent orchestration, task decomposition, parallel dispatch, and review pipeline patterns',
-    source: 'scaffold/general/skills/multi-agents-development/SKILL.md',
+    source: 'scaffold/skills/multi-agents-development/SKILL.md',
     required: true,
     sidecars: [
-      'scaffold/general/skills/multi-agents-development/implementer-prompt.md',
-      'scaffold/general/skills/multi-agents-development/spec-review-prompt.md',
-      'scaffold/general/skills/multi-agents-development/code-quality-review-prompt.md',
-      'scaffold/general/skills/multi-agents-development/architecture-review-prompt.md',
-      'scaffold/general/skills/multi-agents-development/parallel-dispatch-example.md',
+      'scaffold/skills/multi-agents-development/implementer-prompt.md',
+      'scaffold/skills/multi-agents-development/spec-review-prompt.md',
+      'scaffold/skills/multi-agents-development/code-quality-review-prompt.md',
+      'scaffold/skills/multi-agents-development/architecture-review-prompt.md',
+      'scaffold/skills/multi-agents-development/parallel-dispatch-example.md',
     ],
   },
 
   'adr-skill': {
     description:
       'Architecture Decision Records — create, maintain, and review ADRs for significant technical decisions',
-    source: 'scaffold/general/skills/adr-skill/SKILL.md',
+    source: 'scaffold/skills/adr-skill/SKILL.md',
     required: true,
     sidecars: [
-      'scaffold/general/skills/adr-skill/assets/templates/adr-madr.md',
-      'scaffold/general/skills/adr-skill/assets/templates/adr-readme.md',
-      'scaffold/general/skills/adr-skill/assets/templates/adr-simple.md',
-      'scaffold/general/skills/adr-skill/references/adr-conventions.md',
-      'scaffold/general/skills/adr-skill/references/examples.md',
-      'scaffold/general/skills/adr-skill/references/review-checklist.md',
-      'scaffold/general/skills/adr-skill/references/template-variants.md',
-      'scaffold/general/skills/adr-skill/scripts/bootstrap_adr.js',
-      'scaffold/general/skills/adr-skill/scripts/new_adr.js',
-      'scaffold/general/skills/adr-skill/scripts/set_adr_status.js',
+      'scaffold/skills/adr-skill/assets/templates/adr-madr.md',
+      'scaffold/skills/adr-skill/assets/templates/adr-readme.md',
+      'scaffold/skills/adr-skill/assets/templates/adr-simple.md',
+      'scaffold/skills/adr-skill/references/adr-conventions.md',
+      'scaffold/skills/adr-skill/references/examples.md',
+      'scaffold/skills/adr-skill/references/review-checklist.md',
+      'scaffold/skills/adr-skill/references/template-variants.md',
+      'scaffold/skills/adr-skill/scripts/bootstrap_adr.js',
+      'scaffold/skills/adr-skill/scripts/new_adr.js',
+      'scaffold/skills/adr-skill/scripts/set_adr_status.js',
     ],
   },
 
   'c4-architecture': {
     description:
       'C4 model architecture diagrams using Mermaid — system context, container, component, and deployment views',
-    source: 'scaffold/general/skills/c4-architecture/SKILL.md',
+    source: 'scaffold/skills/c4-architecture/SKILL.md',
     required: true,
     sidecars: [
-      'scaffold/general/skills/c4-architecture/references/advanced-patterns.md',
-      'scaffold/general/skills/c4-architecture/references/c4-syntax.md',
-      'scaffold/general/skills/c4-architecture/references/common-mistakes.md',
+      'scaffold/skills/c4-architecture/references/advanced-patterns.md',
+      'scaffold/skills/c4-architecture/references/c4-syntax.md',
+      'scaffold/skills/c4-architecture/references/common-mistakes.md',
     ],
   },
 
   'frontend-design': {
     description:
       'Frontend design system — visual design thinking, typography, color, layout, motion, accessibility, and anti-pattern detection',
-    source: 'scaffold/general/skills/frontend-design/SKILL.md',
+    source: 'scaffold/skills/frontend-design/SKILL.md',
     required: false,
   },
 
   'lesson-learned': {
     description: 'Extract engineering lessons from recent code changes via git history analysis',
-    source: 'scaffold/general/skills/lesson-learned/SKILL.md',
+    source: 'scaffold/skills/lesson-learned/SKILL.md',
     required: true,
     sidecars: [
-      'scaffold/general/skills/lesson-learned/references/anti-patterns.md',
-      'scaffold/general/skills/lesson-learned/references/se-principles.md',
+      'scaffold/skills/lesson-learned/references/anti-patterns.md',
+      'scaffold/skills/lesson-learned/references/se-principles.md',
     ],
   },
 
   present: {
     description:
       'Rich interactive dashboards, charts, tables, timelines, and data visualizations via the present MCP tool',
-    source: 'scaffold/general/skills/present/SKILL.md',
+    source: 'scaffold/skills/present/SKILL.md',
     required: true,
   },
 
   react: {
     description:
       'React development patterns — component architecture, React 19 APIs, Server Components, TypeScript integration',
-    source: 'scaffold/general/skills/react/SKILL.md',
+    source: 'scaffold/skills/react/SKILL.md',
     required: false,
   },
 
   'requirements-clarity': {
     description:
       'Clarify ambiguous requirements through focused dialogue — score 0-100 until ≥90 before implementation',
-    source: 'scaffold/general/skills/requirements-clarity/SKILL.md',
+    source: 'scaffold/skills/requirements-clarity/SKILL.md',
     required: true,
   },
 
   'session-handoff': {
     description:
       'Comprehensive handoff documents for seamless AI agent session transfers and context preservation',
-    source: 'scaffold/general/skills/session-handoff/SKILL.md',
+    source: 'scaffold/skills/session-handoff/SKILL.md',
     required: true,
     sidecars: [
-      'scaffold/general/skills/session-handoff/references/handoff-template.md',
-      'scaffold/general/skills/session-handoff/references/resume-checklist.md',
-      'scaffold/general/skills/session-handoff/scripts/check_staleness.js',
-      'scaffold/general/skills/session-handoff/scripts/create_handoff.js',
-      'scaffold/general/skills/session-handoff/scripts/list_handoffs.js',
-      'scaffold/general/skills/session-handoff/scripts/validate_handoff.js',
+      'scaffold/skills/session-handoff/references/handoff-template.md',
+      'scaffold/skills/session-handoff/references/resume-checklist.md',
+      'scaffold/skills/session-handoff/scripts/check_staleness.js',
+      'scaffold/skills/session-handoff/scripts/create_handoff.js',
+      'scaffold/skills/session-handoff/scripts/list_handoffs.js',
+      'scaffold/skills/session-handoff/scripts/validate_handoff.js',
     ],
   },
 
   typescript: {
     description:
       'TypeScript development patterns — type system, compiler config, advanced types, async patterns, module organization',
-    source: 'scaffold/general/skills/typescript/SKILL.md',
+    source: 'scaffold/skills/typescript/SKILL.md',
     required: false,
   },
   docs: {
     description:
       'Living documentation management — Diátaxis framework, docs/ convention, staleness detection, integration with adr-skill and c4-architecture',
-    source: 'scaffold/general/skills/docs/SKILL.md',
+    source: 'scaffold/skills/docs/SKILL.md',
     required: true,
   },
 
   'repo-access': {
     description:
       'Progressive repository access recovery for private and enterprise git repos — strategy ladder from HTTPS to SSH to CLI OAuth to PAT to local clone',
-    source: 'scaffold/general/skills/repo-access/SKILL.md',
+    source: 'scaffold/skills/repo-access/SKILL.md',
     required: true,
     sidecars: [
-      'scaffold/general/skills/repo-access/references/platform-matrix.md',
-      'scaffold/general/skills/repo-access/references/error-patterns.md',
+      'scaffold/skills/repo-access/references/platform-matrix.md',
+      'scaffold/skills/repo-access/references/error-patterns.md',
     ],
   },
 };

package/scaffold/generate.mjs

@@ -9,12 +9,8 @@
  *
  * Architecture:
  *   definitions/  — IDE-agnostic data (agents, models, tools, prompts, hooks, plugins)
- *   adapters/     — IDE-specific generators (copilot, claude-code)
- *   general/      — Output directory (agents, prompts, skills) — `aikit init` copies from here
- *
- * The copilot adapter writes directly to general/ since all IDEs currently
- * consume the same VS Code-format .agent.md files. When a future adapter
- * needs a different format, it gets its own output directory.
+ *   adapters/     — Generator adapters (copilot, claude-code, skills, flows)
+ *   _preview/     — Preview output directory (dev only — `aikit init` uses adapters directly)
  */
 
 import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
@@ -22,12 +18,24 @@ import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { generateClaudeCode } from './adapters/claude-code.mjs';
 import { generateCopilot } from './adapters/copilot.mjs';
+import { generateFlows } from './adapters/flows.mjs';
+import { generateSkills } from './adapters/skills.mjs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
 const ADAPTERS = {
-  copilot: { generate: generateCopilot, outDir: 'general' },
-  'claude-code': { generate: generateClaudeCode, outDir: 'claude-code' },
+  copilot: {
+    generate: generateCopilot,
+    outDir: '_preview',
+    cleanDirs: ['agents', 'prompts', 'commands'],
+  },
+  'claude-code': {
+    generate: generateClaudeCode,
+    outDir: 'claude-code',
+    cleanDirs: ['agents', 'prompts', 'commands'],
+  },
+  skills: { generate: generateSkills, outDir: '_preview/skills', cleanDirs: null },
+  flows: { generate: generateFlows, outDir: '_preview/flows', cleanDirs: null },
 };
 
 // ─── Parse args ───────────────────────────────────────────────────────────
@@ -49,13 +57,15 @@ for (const ide of idesToRun) {
 
   const outDir = resolve(__dirname, adapter.outDir);
 
-  // Clean only the subdirectories the generator manages (agents/, prompts/).
-  // This avoids wiping hand-maintained files if they coexist in general/.
-  for (const subdir of ['agents', 'prompts', 'commands']) {
-    const sub = resolve(outDir, subdir);
-    if (existsSync(sub)) {
-      rmSync(sub, { recursive: true });
+  if (adapter.cleanDirs) {
+    for (const subdir of adapter.cleanDirs) {
+      const sub = resolve(outDir, subdir);
+      if (existsSync(sub)) {
+        rmSync(sub, { recursive: true });
+      }
     }
+  } else if (existsSync(outDir)) {
+    rmSync(outDir, { recursive: true });
   }
 
   console.log(`\n─── Generating ${ide} scaffold ───`);

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/flows/aikit-advanced/flow.json

@@ -1,69 +0,0 @@
-{
-  "name": "aikit:advanced",
-  "version": "0.1.0",
-  "description": "Full development flow for new features, API design, and architecture changes",
-  "steps": [
-    {
-      "id": "design",
-      "name": "Design Gate",
-      "instruction": "steps/design/README.md",
-      "produces": ["design-decisions.md"],
-      "requires": [],
-      "agents": ["Researcher-Alpha", "Researcher-Beta", "Researcher-Gamma", "Researcher-Delta"],
-      "description": "Full brainstorming, FORGE classification, decision protocol with parallel research. ADR for critical-tier tasks."
-    },
-    {
-      "id": "spec",
-      "name": "Specification",
-      "instruction": "steps/spec/README.md",
-      "produces": ["spec.md"],
-      "requires": ["design-decisions.md"],
-      "agents": ["Researcher-Alpha"],
-      "description": "Elicit requirements, clarify scope, define acceptance criteria"
-    },
-    {
-      "id": "plan",
-      "name": "Planning",
-      "instruction": "steps/plan/README.md",
-      "produces": ["plan.md"],
-      "requires": ["spec.md"],
-      "agents": ["Planner", "Explorer"],
-      "description": "Analyze codebase, design architecture, create implementation plan"
-    },
-    {
-      "id": "task",
-      "name": "Task Breakdown",
-      "instruction": "steps/task/README.md",
-      "produces": ["tasks.md"],
-      "requires": ["plan.md"],
-      "agents": ["Planner", "Architect-Reviewer-Alpha"],
-      "description": "Break plan into ordered implementation tasks with dependencies"
-    },
-    {
-      "id": "execute",
-      "name": "Execution",
-      "instruction": "steps/execute/README.md",
-      "produces": ["progress.md"],
-      "requires": ["tasks.md"],
-      "agents": ["Orchestrator", "Implementer", "Frontend", "Refactor"],
-      "description": "Implement all tasks, write code, write tests"
-    },
-    {
-      "id": "verify",
-      "name": "Verification",
-      "instruction": "steps/verify/README.md",
-      "produces": ["verify-report.md"],
-      "requires": ["progress.md"],
-      "agents": [
-        "Code-Reviewer-Alpha",
-        "Code-Reviewer-Beta",
-        "Architect-Reviewer-Alpha",
-        "Architect-Reviewer-Beta",
-        "Security"
-      ],
-      "description": "Dual code review, architecture review, security review, test validation"
-    }
-  ],
-  "artifacts_dir": ".spec",
-  "install": []
-}

package/scaffold/flows/aikit-basic/flow.json

@@ -1,45 +0,0 @@
-{
-  "name": "aikit:basic",
-  "version": "0.1.0",
-  "description": "Quick development flow for bug fixes, small features, and refactoring",
-  "steps": [
-    {
-      "id": "design",
-      "name": "Design Gate",
-      "instruction": "steps/design/README.md",
-      "produces": ["design-decisions.md"],
-      "requires": [],
-      "agents": ["Researcher-Alpha", "Researcher-Beta", "Researcher-Gamma", "Researcher-Delta"],
-      "description": "Evaluate task type, run brainstorming for features, FORGE classification. Auto-skips for bug fixes and refactors."
-    },
-    {
-      "id": "assess",
-      "name": "Assessment",
-      "instruction": "steps/assess/README.md",
-      "produces": ["assessment.md"],
-      "requires": ["design-decisions.md"],
-      "agents": ["Explorer", "Researcher-Alpha"],
-      "description": "Understand scope, analyze codebase, identify approach"
-    },
-    {
-      "id": "implement",
-      "name": "Implementation",
-      "instruction": "steps/implement/README.md",
-      "produces": ["progress.md"],
-      "requires": ["assessment.md"],
-      "agents": ["Implementer", "Frontend"],
-      "description": "Write code following the assessment plan"
-    },
-    {
-      "id": "verify",
-      "name": "Verification",
-      "instruction": "steps/verify/README.md",
-      "produces": ["verify-report.md"],
-      "requires": ["progress.md"],
-      "agents": ["Code-Reviewer-Alpha", "Security"],
-      "description": "Review code, run tests, validate changes"
-    }
-  ],
-  "artifacts_dir": ".spec",
-  "install": []
-}