@vpxa/aikit 0.1.74 → 0.1.75

package/scaffold/definitions/hooks.mjs

@@ -1,43 +0,0 @@
-/**
- * Hook definitions — lifecycle events that agents can respond to.
- *
- * Not all IDEs support hooks natively:
- *   - Copilot: No native hook support (hooks are documented in instructions only)
- *   - Claude Code: Maps to hooks config in settings.json
- *   - Claude Code: Supports hooks via settings.json
- *
- * Each adapter decides how to surface these:
- *   - Copilot adapter: Embeds as rules in copilot-instructions.md
- *   - Claude Code adapter: Generates hooks config [future]
- */
-
-export const HOOKS = {
-  sessionStart: {
-    description: 'Run at the start of every agent session',
-    actions: ['status({})', 'list()', 'search({ query: "SESSION CHECKPOINT", origin: "curated" })'],
-    rationale: 'Resume prior work, load existing knowledge',
-  },
-
-  sessionEnd: {
-    description: 'Run at the end of every agent session',
-    actions: [
-      'remember({ title: "Session checkpoint: <topic>", content: "<decisions, next steps>", category: "conventions" })',
-    ],
-    rationale: 'Persist decisions for future sessions',
-  },
-
-  beforeCodeChange: {
-    description: 'Run before modifying any code',
-    actions: [
-      'search({ query: "<what you are changing>" })',
-      'scope_map({ task: "<description>" })',
-    ],
-    rationale: 'Check for prior decisions and understand impact',
-  },
-
-  beforeCommit: {
-    description: 'Run before committing changes',
-    actions: ['check({})', 'test_run({})', 'blast_radius({ changed_files: ["..."] })'],
-    rationale: 'Validate changes before they enter version control',
-  },
-};

package/scaffold/definitions/models.mjs

@@ -1,84 +0,0 @@
-/**
- * Centralized model assignments — THE SINGLE FILE to update when models change.
- *
- * Keys are agent names (stable, model-agnostic).
- * COPILOT_MODELS keeps the full fallback list in Copilot format.
- * CLAUDE_MODELS maps each agent to its primary model as a single plain string.
- *
- * 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 = {
-  // ─── Single-role agents ───────────────────────────────────────────────
-  Orchestrator: ['Claude Opus 4.6 (copilot)', 'GPT-5.4 (copilot)', 'Auto (copilot)'],
-  Planner: ['Claude Opus 4.6 (copilot)', 'GPT-5.4 (copilot)', 'Auto (copilot)'],
-  Implementer: [
-    'GPT-5.4 (copilot)',
-    'Gemini 3.1 Pro (Preview) (copilot)',
-    'GPT-5.3-Codex (copilot)',
-    'Auto (copilot)',
-  ],
-  Frontend: [
-    'Gemini 3.1 Pro (Preview) (copilot)',
-    'GPT-5.4 (copilot)',
-    'GPT-5.3-Codex (copilot)',
-    'Auto (copilot)',
-  ],
-  Debugger: [
-    'Claude Opus 4.6 (copilot)',
-    'GPT-5.4 (copilot)',
-    'GPT-5.3-Codex (copilot)',
-    'Auto (copilot)',
-  ],
-  Refactor: ['GPT-5.4 (copilot)', 'GPT-5.3-Codex (copilot)', 'Auto (copilot)'],
-  Security: ['Claude Opus 4.6 (copilot)', 'GPT-5.4 (copilot)', 'Auto (copilot)'],
-  Documenter: ['GPT-5.4 (copilot)', 'Gemini 3.1 Pro (Preview) (copilot)', 'Auto (copilot)'],
-  Explorer: ['Gemini 3 Flash (Preview) (copilot)', 'Claude Haiku 4.5 (copilot)', 'Auto (copilot)'],
-
-  // ─── Researcher variants (4 models for multi-model decision protocol) ────────────
-  'Researcher-Alpha': ['Claude Opus 4.6 (copilot)', 'Auto (copilot)'],
-  'Researcher-Beta': ['Claude Sonnet 4.6 (copilot)', 'Auto (copilot)'],
-  'Researcher-Gamma': ['GPT-5.4 (copilot)', 'Auto (copilot)'],
-  'Researcher-Delta': ['Gemini 3.1 Pro (Preview) (copilot)', 'Auto (copilot)'],
-
-  // ─── Code-Reviewer variants (2 models for dual review) ───────────────
-  'Code-Reviewer-Alpha': ['GPT-5.4 (copilot)', 'Auto (copilot)'],
-  'Code-Reviewer-Beta': ['Claude Opus 4.6 (copilot)', 'Auto (copilot)'],
-
-  // ─── Architect-Reviewer variants (2 models for dual review) ──────────
-  'Architect-Reviewer-Alpha': ['GPT-5.4 (copilot)', 'Auto (copilot)'],
-  'Architect-Reviewer-Beta': ['Claude Opus 4.6 (copilot)', 'Auto (copilot)'],
-};
-
-export const CLAUDE_MODELS = Object.fromEntries(
-  Object.entries(COPILOT_MODELS).map(([agentName, models]) => {
-    const primaryModel = Array.isArray(models) ? models[0] : models;
-    return [agentName, primaryModel?.replace(/ \(copilot\)$/, '') || 'Auto'];
-  }),
-);
-
-/**
- * Variant group definitions — maps role to variant suffixes.
- * Used by adapters to know which agents are variants of the same role.
- */
-export const VARIANT_GROUPS = {
-  Researcher: ['Alpha', 'Beta', 'Gamma', 'Delta'],
-  'Code-Reviewer': ['Alpha', 'Beta'],
-  'Architect-Reviewer': ['Alpha', 'Beta'],
-};
-
-/**
- * Primary variant per role — the "default" one for single-agent invocation.
- */
-export const PRIMARY_VARIANT = {
-  Researcher: 'Alpha',
-  'Code-Reviewer': 'Alpha',
-  'Architect-Reviewer': 'Alpha',
-};

package/scaffold/definitions/plugins.mjs

@@ -1,147 +0,0 @@
-/**
- * Plugin/skill definitions — packages of domain knowledge for agents.
- *
- * Copilot: .github/skills/{name}/SKILL.md
- * 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/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/skills/aikit/SKILL.md',
-    required: true,
-  },
-
-  brainstorming: {
-    description: 'Brainstorming & design exploration workflow',
-    source: 'scaffold/skills/brainstorming/SKILL.md',
-    required: true,
-    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/skills/multi-agents-development/SKILL.md',
-    required: true,
-    sidecars: [
-      '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/skills/adr-skill/SKILL.md',
-    required: true,
-    sidecars: [
-      '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/skills/c4-architecture/SKILL.md',
-    required: true,
-    sidecars: [
-      '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/skills/frontend-design/SKILL.md',
-    required: false,
-  },
-
-  'lesson-learned': {
-    description: 'Extract engineering lessons from recent code changes via git history analysis',
-    source: 'scaffold/skills/lesson-learned/SKILL.md',
-    required: true,
-    sidecars: [
-      '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/skills/present/SKILL.md',
-    required: true,
-  },
-
-  react: {
-    description:
-      'React development patterns — component architecture, React 19 APIs, Server Components, TypeScript integration',
-    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/skills/requirements-clarity/SKILL.md',
-    required: true,
-  },
-
-  'session-handoff': {
-    description:
-      'Comprehensive handoff documents for seamless AI agent session transfers and context preservation',
-    source: 'scaffold/skills/session-handoff/SKILL.md',
-    required: true,
-    sidecars: [
-      '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/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/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/skills/repo-access/SKILL.md',
-    required: true,
-    sidecars: [
-      'scaffold/skills/repo-access/references/platform-matrix.md',
-      'scaffold/skills/repo-access/references/error-patterns.md',
-    ],
-  },
-};

package/scaffold/definitions/tools.mjs

@@ -1,250 +0,0 @@
-/**
- * Tool lists by agent role category.
- *
- * `kb` — Knowledge-base MCP tools (IDE-agnostic, same across all adapters).
- * `ide` — IDE-native tool permissions, keyed by role. Each IDE adapter
- *          maps these to its own format (e.g., Copilot tool identifiers).
- *
- * When AI Kit adds/removes a tool, update `kb` here — all agents pick it up.
- *
- * NOTE: The copilot adapter currently uses `aikit/*` wildcard instead
- * of listing individual tools. This array is kept as a reference and for future
- * adapters that may need explicit tool lists (e.g., claude-code).
- */
-
-export const AIKIT_TOOLS = [
-  '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',
-];
-
-/**
- * IDE-native tool categories by role.
- * These are abstract capability names — each IDE adapter maps them to concrete tool IDs.
- *
- * Categories:
- *   terminal    — run commands
- *   problems    — read diagnostics
- *   readFile    — read file contents
- *   lastCommand — read terminal output
- *   subagent    — invoke other agents
- *   createFile  — create new files
- *   editFiles   — edit existing files
- *   search      — search codebase (code, text, usages, changes)
- *   web         — web fetch, web search, GitHub
- *   todo        — manage task lists
- *   memory      — persistent memory (VS Code)
- *   runCommand  — run VS Code commands
- *   switchAgent — switch to another agent
- *   killTerminal — kill a terminal
- *   createTask  — create and run tasks
- *   terminalSel — read terminal selection
- *   fileSearch  — search by filename
- *   listDir     — list directory
- *   textSearch  — text search
- *   searchSubagent — search via subagent
- */
-export const IDE_CAPABILITIES = {
-  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',
-  ],
-};

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!');