@vpxa/aikit 0.1.74 → 0.1.76

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;
-}

package/scaffold/adapters/flows.mjs

@@ -1,27 +0,0 @@
-/**
- * Flows adapter - generates flow instruction files from compiled definitions.
- *
- * Flow content is compiled into ../compiled/flows-data.mjs by compile.mjs.
- * This adapter provides the generateFlows() function used by the init command.
- * Note: flow.json files are NOT included - they are structural metadata
- * handled by the flow system.
- */
-
-import { FLOWS } from '../compiled/flows-data.mjs';
-
-/**
- * Generate all flow instruction files for deployment.
- * @returns {Array<{path: string, content: string}>}
- */
-export function generateFlows() {
-  const output = [];
-  for (const [flowName, files] of Object.entries(FLOWS)) {
-    for (const { file, content } of files) {
-      output.push({
-        path: `${flowName}/${file}`,
-        content,
-      });
-    }
-  }
-  return output;
-}

package/scaffold/adapters/skills.mjs

@@ -1,25 +0,0 @@
-/**
- * Skills adapter - generates skill files from compiled definitions.
- *
- * Skill content is compiled into ../compiled/skills-data.mjs by compile.mjs.
- * This adapter provides the generateSkills() function used by the init command.
- */
-
-import { SKILLS } from '../compiled/skills-data.mjs';
-
-/**
- * Generate all skill files for deployment.
- * @returns {Array<{path: string, content: string}>}
- */
-export function generateSkills() {
-  const output = [];
-  for (const [skillName, files] of Object.entries(SKILLS)) {
-    for (const { file, content } of files) {
-      output.push({
-        path: `${skillName}/${file}`,
-        content,
-      });
-    }
-  }
-  return output;
-}

package/scaffold/generate.mjs

@@ -1,92 +0,0 @@
-#!/usr/bin/env node
-/**
- * Scaffold generator — reads definitions, picks adapter, writes files.
- *
- * Usage:
- *   node scaffold/generate.mjs                  # Default: all adapters
- *   node scaffold/generate.mjs --ide copilot    # Copilot only
- *   node scaffold/generate.mjs --ide claude-code # Claude Code only [stub]
- *
- * Architecture:
- *   definitions/  — IDE-agnostic data (agents, models, tools, prompts, hooks, plugins)
- *   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';
-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: '_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 ───────────────────────────────────────────────────────────
-
-const args = process.argv.slice(2);
-const ideIdx = args.indexOf('--ide');
-const targetIde = ideIdx >= 0 ? args[ideIdx + 1] : null;
-
-const idesToRun = targetIde ? [targetIde] : Object.keys(ADAPTERS);
-
-// ─── Generate ─────────────────────────────────────────────────────────────
-
-for (const ide of idesToRun) {
-  const adapter = ADAPTERS[ide];
-  if (!adapter) {
-    console.error(`Unknown IDE: ${ide}. Available: ${Object.keys(ADAPTERS).join(', ')}`);
-    process.exit(1);
-  }
-
-  const outDir = resolve(__dirname, adapter.outDir);
-
-  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 ───`);
-
-  const files = adapter.generate();
-
-  if (files.length === 0) {
-    console.log(`  (stub — no files generated)`);
-    continue;
-  }
-
-  let count = 0;
-  for (const { path, content } of files) {
-    const fullPath = resolve(outDir, path);
-    mkdirSync(dirname(fullPath), { recursive: true });
-    writeFileSync(fullPath, content, 'utf-8');
-    console.log(`  ${path}`);
-    count++;
-  }
-
-  console.log(`  → ${count} files written to scaffold/${adapter.outDir}/`);
-}
-
-console.log('\nDone!');