@grvmithas/create-aies-kit 1.0.0 → 1.3.0

package/lib/kit-core/install-api.js

@@ -0,0 +1,173 @@
+/**
+ * Client-safe kit helpers — no node:fs, safe for Next.js client components.
+ *
+ * Layout contract:
+ * - IDE root (.cursor / .github / .claude / …) = prompts + skills + agents (+ IDE rules/MCP config)
+ * - Repo root shared dirs = cookbook, guides, mcps, templates, policy (never nest these under .github)
+ */
+import { SITE_URL } from './options.js';
+
+/** Shared repo-root paths — identical for every IDE. */
+const SHARED = {
+  cookbookBase: 'cookbook',
+  guidesDir: 'guides',
+  mcpsDir: 'mcps',
+  templatesDir: 'templates',
+  policyFile: 'MODEL_POLICY.md',
+  hooksFile: 'aies-hooks.json',
+};
+
+/**
+ * @param {string} ide
+ * @param {{ cookbookId?: string | null }} [opts]
+ */
+export function layoutFor(ide, opts = {}) {
+  const cookbookId = opts.cookbookId ?? null;
+  const cookbookDir = cookbookId ? `${SHARED.cookbookBase}/${cookbookId}` : SHARED.cookbookBase;
+
+  switch (ide) {
+    case 'cursor':
+      return {
+        ide,
+        ...SHARED,
+        cookbookDir,
+        root: '.cursor',
+        rulesFile: '.cursor/rules/aies.mdc',
+        skillsDir: '.cursor/skills',
+        skillStyle: 'cursor-skill',
+        promptsDir: '.cursor/prompts',
+        agentsDir: '.cursor/agents',
+        mcpFile: '.cursor/mcp.json',
+        hooksFile: '.cursor/aies-hooks.json',
+      };
+    case 'copilot':
+      return {
+        ide,
+        ...SHARED,
+        cookbookDir,
+        root: '.github',
+        rulesFile: '.github/copilot-instructions.md',
+        skillsDir: '.github/skills',
+        skillStyle: 'flat',
+        promptsDir: '.github/prompts',
+        agentsDir: '.github/agents',
+        // Copilot discovery only under .github — MCP config at repo root
+        mcpFile: '.mcp.json',
+      };
+    case 'claude-code':
+      return {
+        ide,
+        ...SHARED,
+        cookbookDir,
+        root: '.claude',
+        rulesFile: 'CLAUDE.md',
+        skillsDir: '.claude/skills',
+        skillStyle: 'cursor-skill',
+        promptsDir: '.claude/prompts',
+        agentsDir: '.claude/agents',
+        mcpFile: '.mcp.json',
+      };
+    case 'vscode':
+      return {
+        ide,
+        ...SHARED,
+        cookbookDir,
+        root: '.vscode',
+        rulesFile: '.vscode/aies-instructions.md',
+        skillsDir: '.vscode/skills',
+        skillStyle: 'flat',
+        promptsDir: '.vscode/prompts',
+        agentsDir: '.vscode/agents',
+        mcpFile: '.vscode/mcp.json',
+      };
+    case 'windsurf':
+      return {
+        ide,
+        ...SHARED,
+        cookbookDir,
+        root: '.windsurf',
+        rulesFile: '.windsurfrules',
+        skillsDir: '.windsurf/skills',
+        skillStyle: 'flat',
+        promptsDir: '.windsurf/prompts',
+        agentsDir: '.windsurf/agents',
+        mcpFile: '.windsurf/mcp.json',
+      };
+    case 'continue':
+      return {
+        ide,
+        ...SHARED,
+        cookbookDir,
+        root: '.continue',
+        rulesFile: '.continue/aies-context.md',
+        skillsDir: '.continue/skills',
+        skillStyle: 'flat',
+        promptsDir: '.continue/prompts',
+        agentsDir: '.continue/agents',
+        mcpFile: '.continue/mcp.json',
+      };
+    default:
+      return layoutFor('vscode', opts);
+  }
+}
+
+export function describeInstallLayout(ide, opts = {}) {
+  const L = layoutFor(ide, opts);
+  return {
+    rootFiles: [
+      'AIES.md',
+      'implementation_plan.md',
+      'CLAUDE.md',
+      'AGENTS.md',
+      'copilot-instructions.md',
+      'MODEL_POLICY.md',
+      'aies-hooks.json',
+    ],
+    ideRoot: L.root,
+    ideOnly: [L.promptsDir, L.skillsDir, L.agentsDir],
+    sharedRoot: [L.cookbookDir, L.guidesDir, L.mcpsDir, L.templatesDir],
+    rulesFile: L.rulesFile,
+    skillsDir: L.skillsDir,
+    promptsDir: L.promptsDir,
+    cookbookDir: L.cookbookDir,
+    guidesDir: L.guidesDir,
+    agentsDir: L.agentsDir,
+    mcpsDir: L.mcpsDir,
+    templatesDir: L.templatesDir,
+    mcpFile: L.mcpFile,
+    policyFile: L.policyFile,
+    hooksFile: L.hooksFile,
+  };
+}
+
+export function buildInstallQuery(profile) {
+  return new URLSearchParams({
+    stack: profile.stack,
+    ide: profile.ide,
+    role: profile.role,
+    maturity: profile.maturity,
+    goal: profile.goal,
+    model: profile.model ?? 'undecided',
+    dataClass: profile.dataClass ?? 'internal',
+  }).toString();
+}
+
+export function getInstallCommands(profile) {
+  const q = buildInstallQuery(profile);
+  const flags = [
+    `--stack ${profile.stack}`,
+    `--ide ${profile.ide}`,
+    `--role ${profile.role}`,
+    `--maturity ${profile.maturity}`,
+    `--goal ${profile.goal}`,
+    `--model ${profile.model ?? 'undecided'}`,
+    `--data-class ${profile.dataClass ?? 'internal'}`,
+    '--yes',
+  ].join(' ');
+  return {
+    npx: `npx @grvmithas/create-aies-kit ${flags}`,
+    enhance: 'npx @grvmithas/create-aies-kit enhance',
+    powershell: `irm "${SITE_URL}/api/kit?${q}&shell=ps1" | iex`,
+    bash: `curl -fsSL "${SITE_URL}/api/kit?${q}&shell=bash" | bash`,
+  };
+}

package/lib/kit-core/mcp-catalog.js

@@ -0,0 +1,170 @@
+/**
+ * MCP recommendations for kit install + enhance.
+ * Specs live under content/mcps/; configs here are enable-ready stubs (secrets via env).
+ */
+import path from 'node:path';
+
+export const MCP_SPECS = [
+  { id: 'github', category: 'version-control', file: 'version-control/github.mcp.md', label: 'GitHub' },
+  { id: 'gitlab', category: 'version-control', file: 'version-control/gitlab.mcp.md', label: 'GitLab' },
+  { id: 'azure-devops', category: 'version-control', file: 'version-control/azure-devops.mcp.md', label: 'Azure DevOps' },
+  { id: 'bitbucket-cloud', category: 'version-control', file: 'version-control/bitbucket-cloud.mcp.md', label: 'Bitbucket Cloud' },
+  { id: 'filesystem', category: 'infrastructure-data', file: 'infrastructure-data/filesystem.mcp.md', label: 'Filesystem' },
+  { id: 'docker', category: 'infrastructure-data', file: 'infrastructure-data/docker.mcp.md', label: 'Docker' },
+  { id: 'kubernetes', category: 'infrastructure-data', file: 'infrastructure-data/kubernetes.mcp.md', label: 'Kubernetes' },
+  { id: 'postgresql', category: 'infrastructure-data', file: 'infrastructure-data/postgresql.mcp.md', label: 'PostgreSQL' },
+  { id: 'redis', category: 'infrastructure-data', file: 'infrastructure-data/redis.mcp.md', label: 'Redis' },
+  { id: 'supabase', category: 'infrastructure-data', file: 'infrastructure-data/supabase.mcp.md', label: 'Supabase' },
+  { id: 'playwright', category: 'browser-testing', file: 'browser-testing/playwright.mcp.md', label: 'Playwright' },
+  { id: 'chrome-devtools', category: 'browser-testing', file: 'browser-testing/chrome-devtools.mcp.md', label: 'Chrome DevTools' },
+  { id: 'sentry', category: 'observability', file: 'observability/sentry.mcp.md', label: 'Sentry' },
+  { id: 'datadog', category: 'observability', file: 'observability/datadog.mcp.md', label: 'Datadog' },
+  { id: 'grafana', category: 'observability', file: 'observability/grafana.mcp.md', label: 'Grafana' },
+  { id: 'opentelemetry', category: 'observability', file: 'observability/opentelemetry.mcp.md', label: 'OpenTelemetry' },
+  { id: 'jira', category: 'project-management', file: 'project-management/jira.mcp.md', label: 'Jira' },
+  { id: 'linear', category: 'project-management', file: 'project-management/linear.mcp.md', label: 'Linear' },
+  { id: 'notion', category: 'project-management', file: 'project-management/notion.mcp.md', label: 'Notion' },
+  { id: 'asana', category: 'project-management', file: 'project-management/asana.mcp.md', label: 'Asana' },
+  { id: 'monday', category: 'project-management', file: 'project-management/monday.mcp.md', label: 'Monday' },
+  { id: 'slack', category: 'communication', file: 'communication/slack.mcp.md', label: 'Slack' },
+  { id: 'microsoft-teams', category: 'communication', file: 'communication/microsoft-teams.mcp.md', label: 'Microsoft Teams' },
+  { id: 'discord', category: 'communication', file: 'communication/discord.mcp.md', label: 'Discord' },
+];
+
+/** Runnable stubs — copy into mcpServers only after human approval + secrets. */
+export const MCP_SERVER_STUBS = {
+  github: {
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-github'],
+    env: { GITHUB_PERSONAL_ACCESS_TOKEN: '${GITHUB_TOKEN}' },
+  },
+  filesystem: {
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-filesystem', '${WORKSPACE_ROOT}'],
+  },
+  docker: {
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-docker'],
+  },
+  postgresql: {
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-postgres'],
+    env: { POSTGRES_CONNECTION_STRING: '${DATABASE_URL}' },
+  },
+  redis: {
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-redis'],
+    env: { REDIS_URL: '${REDIS_URL}' },
+  },
+  playwright: {
+    command: 'npx',
+    args: ['-y', '@playwright/mcp@latest'],
+  },
+  sentry: {
+    command: 'npx',
+    args: ['-y', '@sentry/mcp-server'],
+    env: { SENTRY_AUTH_TOKEN: '${SENTRY_AUTH_TOKEN}' },
+  },
+  linear: {
+    command: 'npx',
+    args: ['-y', 'mcp-linear'],
+    env: { LINEAR_API_KEY: '${LINEAR_API_KEY}' },
+  },
+  slack: {
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-slack'],
+    env: { SLACK_BOT_TOKEN: '${SLACK_BOT_TOKEN}' },
+  },
+};
+
+export function stackMcpIds(stackId) {
+  const base = ['github', 'filesystem'];
+  switch (stackId) {
+    case 'react':
+    case 'nextjs':
+    case 'react-native':
+      return [...base, 'playwright', 'chrome-devtools', 'sentry'];
+    case 'nodejs':
+    case 'nestjs':
+      return [...base, 'docker', 'postgresql', 'redis', 'playwright', 'sentry'];
+    case 'python':
+    case 'fastapi':
+      return [...base, 'docker', 'postgresql', 'redis', 'sentry'];
+    case 'java':
+    case 'dotnet':
+      return [...base, 'docker', 'postgresql', 'kubernetes', 'sentry'];
+    default:
+      return base;
+  }
+}
+
+/**
+ * Heuristic scan of a product repo (enhance mode).
+ * @param {string} cwd
+ * @param {{ existsSync: Function, readFileSync: Function }} fs
+ */
+export function detectRepoSignals(cwd, fs) {
+  const exists = rel => fs.existsSync(path.join(cwd, rel));
+  const read = rel => {
+    try {
+      return fs.readFileSync(path.join(cwd, rel), 'utf8');
+    } catch {
+      return '';
+    }
+  };
+
+  const signals = {
+    packageJson: exists('package.json'),
+    pyproject: exists('pyproject.toml') || exists('requirements.txt'),
+    dockerfile: exists('Dockerfile') || exists('docker-compose.yml') || exists('compose.yml'),
+    kubernetes: exists('k8s') || exists('kubernetes') || exists('helm') || exists('Chart.yaml'),
+    githubActions: exists('.github/workflows'),
+    playwright: false,
+    sentry: false,
+    prisma: false,
+    next: false,
+    nest: false,
+    fastapi: false,
+    redis: false,
+    postgres: false,
+  };
+
+  const pkg = read('package.json');
+  if (pkg) {
+    signals.playwright = /playwright/i.test(pkg);
+    signals.sentry = /sentry/i.test(pkg);
+    signals.prisma = /prisma/i.test(pkg);
+    signals.next = /"next"/i.test(pkg);
+    signals.nest = /@nestjs/i.test(pkg);
+    signals.redis = /ioredis|"redis"/i.test(pkg);
+    signals.postgres = /pg\b|postgres|prisma/i.test(pkg);
+  }
+  const py = read('requirements.txt') + read('pyproject.toml');
+  if (py) {
+    signals.fastapi = /fastapi/i.test(py);
+    signals.sentry = signals.sentry || /sentry/i.test(py);
+    signals.redis = signals.redis || /redis/i.test(py);
+    signals.postgres = signals.postgres || /psycopg|sqlalchemy|asyncpg/i.test(py);
+  }
+
+  const ids = new Set(['github', 'filesystem']);
+  if (signals.dockerfile) ids.add('docker');
+  if (signals.kubernetes) ids.add('kubernetes');
+  if (signals.playwright || signals.next) ids.add('playwright');
+  if (signals.next || signals.playwright) ids.add('chrome-devtools');
+  if (signals.sentry) ids.add('sentry');
+  if (signals.postgres || signals.prisma) ids.add('postgresql');
+  if (signals.redis) ids.add('redis');
+  if (signals.githubActions) ids.add('github');
+
+  return { signals, recommendedMcpIds: [...ids] };
+}
+
+export function buildRecommendedMcpConfig(ids) {
+  /** @type {Record<string, object>} */
+  const recommended = {};
+  for (const id of ids) {
+    if (MCP_SERVER_STUBS[id]) recommended[id] = MCP_SERVER_STUBS[id];
+  }
+  return recommended;
+}

package/lib/{options.js → kit-core/options.js}

@@ -1,4 +1,4 @@
-export const SITE_URL = 'https://open-ai-engineering-standards.vercel.app';
+export const SITE_URL = 'https://www.ai-standards.dev';
 
 export const GOALS = [
   { id: 'new-product', label: 'Build a new product' },
@@ -37,16 +37,31 @@ export const IDES = [
   { id: 'continue', label: 'Continue' },
 ];
 
+export const MODELS = [
+  { id: 'claude', label: 'Claude (Anthropic)' },
+  { id: 'gpt', label: 'GPT (OpenAI)' },
+  { id: 'gemini', label: 'Gemini (Google)' },
+  { id: 'multi', label: 'Multi-model / gateway' },
+  { id: 'local', label: 'Local / open-weight' },
+  { id: 'undecided', label: 'Undecided' },
+];
+
+export const DATA_CLASSES = [
+  { id: 'public', label: 'Public' },
+  { id: 'internal', label: 'Internal' },
+  { id: 'confidential', label: 'Confidential / regulated' },
+];
+
 export const STACKS = [
-  { id: 'react', label: 'React' },
-  { id: 'nextjs', label: 'Next.js' },
-  { id: 'react-native', label: 'React Native' },
-  { id: 'nodejs', label: 'Node.js' },
-  { id: 'nestjs', label: 'NestJS' },
-  { id: 'python', label: 'Python' },
-  { id: 'fastapi', label: 'FastAPI' },
-  { id: 'java', label: 'Java' },
-  { id: 'dotnet', label: '.NET' },
+  { id: 'react', label: 'React', skillKey: 'skills/react.skill.md', cookbook: 'react' },
+  { id: 'nextjs', label: 'Next.js', skillKey: 'skills/nextjs.skill.md', cookbook: 'nextjs' },
+  { id: 'react-native', label: 'React Native', skillKey: 'skills/react-native.skill.md', cookbook: 'react-native' },
+  { id: 'nodejs', label: 'Node.js', skillKey: 'skills/node.skill.md', cookbook: 'node' },
+  { id: 'nestjs', label: 'NestJS', skillKey: 'skills/node.skill.md', cookbook: 'node' },
+  { id: 'python', label: 'Python', skillKey: 'skills/python.skill.md', cookbook: 'python' },
+  { id: 'fastapi', label: 'FastAPI', skillKey: 'skills/python.skill.md', cookbook: 'python' },
+  { id: 'java', label: 'Java', skillKey: 'skills/java.skill.md', cookbook: 'java' },
+  { id: 'dotnet', label: '.NET', skillKey: 'skills/dotnet.skill.md', cookbook: 'dotnet' },
 ];
 
 export const STACK_LABELS = Object.fromEntries(STACKS.map(s => [s.id, s.label]));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@grvmithas/create-aies-kit",
-  "version": "1.0.0",
-  "description": "Scaffold an AIES (AI Engineering Standard) starter kit into your project — prompts, skills, MCP stubs, and IDE rules.",
+  "version": "1.3.0",
+  "description": "Scaffold a complete AIES (AI Engineering Standard) harness into IDE-native paths — prompts, skills, cookbook, agents, MCP stubs, AGENTS.md.",
   "license": "MIT",
   "type": "module",
   "bin": {
@@ -13,6 +13,11 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "vendor": "node ../kit-core/scripts/embed-corpus.mjs && node ./scripts/vendor-kit-core.mjs",
+    "prepublishOnly": "npm run vendor",
+    "prepack": "npm run vendor"
+  },
   "engines": {
     "node": ">=18"
   },
@@ -25,14 +30,15 @@
     "copilot",
     "mcp",
     "aidlc",
-    "create-aies-kit"
+    "create-aies-kit",
+    "agents.md"
   ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/grvmithas/open-ai-engineering-standards.git",
     "directory": "packages/create-aies-kit"
   },
-  "homepage": "https://open-ai-engineering-standards.vercel.app/quickstart",
+  "homepage": "https://www.ai-standards.dev/quickstart",
   "bugs": {
     "url": "https://github.com/grvmithas/open-ai-engineering-standards/issues"
   },