@antomanc/aginit 0.1.0

package/dist/utils/shell.js

@@ -0,0 +1,87 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import path from 'node:path';
+import fs from 'node:fs';
+import { logger } from './logger.js';
+const execFileAsync = promisify(execFile);
+function resolveExecutable(binName) {
+    if (process.platform !== 'win32') {
+        return { executable: binName, isBatch: false };
+    }
+    const isBatch = (file) => /\.(cmd|bat)$/i.test(file);
+    if (path.extname(binName)) {
+        return { executable: binName, isBatch: isBatch(binName) };
+    }
+    const pathExts = (process.env.PATHEXT || '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean);
+    const dirs = (process.env.PATH || '').split(path.delimiter).filter(Boolean);
+    for (const dir of dirs) {
+        const cleanDir = dir.replace(/^"|"$/g, '');
+        for (const ext of pathExts) {
+            const candidate = path.join(cleanDir, `${binName}${ext}`);
+            try {
+                if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
+                    return { executable: candidate, isBatch: isBatch(candidate) };
+                }
+            }
+            catch {
+                // continue
+            }
+        }
+    }
+    return { executable: binName, isBatch: false };
+}
+/** Execute a program with literal arguments. No shell expansion or interpolation. */
+export async function runExecutable(executable, args = [], options = {}) {
+    const { cwd = process.cwd(), env = process.env, dryRun = false, silent = false, timeout = 300_000 } = options;
+    if (dryRun) {
+        logger.dim(`[dry-run] Would execute: ${[executable, ...args].map((a) => JSON.stringify(a)).join(' ')} (in ${cwd})`);
+        return { stdout: '', stderr: '', exitCode: 0, ok: true };
+    }
+    try {
+        const { executable: targetExe, isBatch } = resolveExecutable(executable);
+        const { stdout, stderr } = await execFileAsync(targetExe, args, {
+            cwd,
+            env: { ...process.env, ...env },
+            maxBuffer: 10 * 1024 * 1024,
+            timeout,
+            shell: isBatch
+        });
+        if (!silent && stdout.trim())
+            logger.dim(stdout.trim());
+        return { stdout: stdout.trim(), stderr: stderr.trim(), exitCode: 0, ok: true };
+    }
+    catch (error) {
+        return {
+            stdout: String(error.stdout || '').trim(),
+            stderr: String(error.stderr || error.message || '').trim(),
+            exitCode: typeof error.code === 'number' ? error.code : 1,
+            ok: false
+        };
+    }
+}
+export async function commandExists(binName) {
+    if (!/^[a-zA-Z0-9._-]+$/.test(binName))
+        return false;
+    const isWindows = process.platform === 'win32';
+    const pathExts = isWindows
+        ? (process.env.PATHEXT || '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean)
+        : [''];
+    return (process.env.PATH || '').split(path.delimiter).some((dir) => {
+        if (!dir)
+            return false;
+        const cleanDir = dir.replace(/^"|"$/g, '');
+        for (const ext of pathExts) {
+            try {
+                const file = path.join(cleanDir, isWindows && !path.extname(binName) ? `${binName}${ext}` : binName);
+                fs.accessSync(file, isWindows ? fs.constants.F_OK : fs.constants.X_OK);
+                if (fs.statSync(file).isFile())
+                    return true;
+            }
+            catch {
+                // continue
+            }
+        }
+        return false;
+    });
+}
+//# sourceMappingURL=shell.js.map

package/dist/utils/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/utils/shell.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@antomanc/aginit",
+  "version": "0.1.0",
+  "description": "Minimal, modular AI-first project bootstrapper for T3 Code, Antigravity, and Codex",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "aginit": "./bin/aginit.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "bin",
+    "README.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "author": "Antonio Mancuso <an.manc25@gmail.com>",
+  "homepage": "https://github.com/antomanc/aginit#readme",
+  "bugs": {
+    "url": "https://github.com/antomanc/aginit/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/antomanc/aginit.git"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "antigravity",
+    "codex",
+    "t3-code",
+    "skills",
+    "graft",
+    "bootstrap",
+    "scaffolder"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^1.8.1",
+    "commander": "^12.1.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.8.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.6.3",
+    "vitest": "^4.1.11"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "check": "pnpm typecheck && pnpm test && pnpm build && pnpm audit",
+    "smoke": "node scripts/smoke-test.mjs"
+  }
+}

package/src/adapters/agents-md.ts

@@ -0,0 +1,143 @@
+import path from 'node:path';
+import { fileExists, readTextFile, safeWriteFile } from '../utils/fs.js';
+import { AginitConfig } from '../config/schema.js';
+import { readPackageManifest } from '../config/validation.js';
+import { logger } from '../utils/logger.js';
+import { getPackageManagerAdapter } from './package-manager.js';
+
+export function generateAgentsMarkdown(
+  config: AginitConfig,
+  scripts?: Record<string, string>
+): string {
+  const commands =
+    scripts ??
+    (config.preset === 'generic'
+      ? { test: 'vitest run' }
+      : { build: '', typecheck: '', test: '', dev: '', 'test:e2e': '' });
+  const hasCommand = (name: string) => Object.hasOwn(commands, name);
+  const isWeb = config.preset === 'web';
+  const hasBrowser = isWeb && config.browser.playwright;
+  const hasVisualAgent = isWeb && config.browser.visualAgent;
+  const pm = config.packageManager || 'pnpm';
+  const pmAdapter = getPackageManagerAdapter(pm);
+
+  let devCommand = '';
+  if (hasCommand('dev') && isWeb && config.framework && config.framework !== 'none') {
+    devCommand = `- Dev Server: \`${pmAdapter.runCmd('dev')}\``;
+  }
+
+  let testE2E = '';
+  if (hasBrowser && hasCommand('test:e2e')) {
+    testE2E = `- Test (E2E / Browser): \`${pmAdapter.runCmd('test:e2e')}\``;
+  }
+
+  const selectedSkills = config.skills.sources.flatMap((source) => source.skills);
+  const engineering = selectedSkills.filter((skill) =>
+    ['tdd', 'code-review', 'diagnosing-bugs'].includes(skill)
+  );
+  let uiCapability = '';
+  if (isWeb && selectedSkills.includes('impeccable')) {
+    uiCapability =
+      '- **UI & Design**: Use `impeccable` skill for frontend polish, design critique, and token craft.';
+  }
+
+  let browserCapability = '';
+  if (hasVisualAgent && selectedSkills.includes('agent-browser')) {
+    browserCapability =
+      '- **Browser Verification**: Use `agent-browser` skill for interactive inspection and visual QA.';
+  }
+
+  let graftCapability = '';
+  if (config.codebase.graft) {
+    graftCapability =
+      '- **Codebase Graph**: Use `graft ask "<query>" --source` or `graft map` for orientation before raw grep.';
+  }
+
+  let specWorkflow = '';
+  if (config.skills.workflow === 'spec' && selectedSkills.includes('to-spec')) {
+    specWorkflow = '- **Spec & Tickets Workflow**: `to-spec`, `to-tickets`, `implement-spec`';
+  }
+
+  const sections = [
+    `# ${config.name}`,
+    '',
+    `AI-first ${config.preset} project configured with \`aginit\`.`,
+    '',
+    '## Core Invariants',
+    '- Keep changes small, focused, and test-verified.',
+    '- Prefer native language & platform capabilities over heavy external frameworks.',
+    '- Never commit broken builds, failed typechecks, or unverified changes.',
+    '',
+    '## Essential Commands',
+    `- Package Manager: \`${pm}\``,
+    devCommand,
+    hasCommand('build') ? `- Build: \`${pmAdapter.runCmd('build')}\`` : '',
+    hasCommand('typecheck') ? `- Typecheck: \`${pmAdapter.runCmd('typecheck')}\`` : '',
+    hasCommand('test') ? `- Test: \`${pmAdapter.runCmd('test')}\`` : '',
+    hasCommand('test:unit') ? `- Unit Test: \`${pmAdapter.runCmd('test:unit')}\`` : '',
+    testE2E,
+    '',
+    '## AI Capabilities & Skills',
+    selectedSkills.length
+      ? 'Configured skills install into `.agents/skills/` (shared by Antigravity and Codex):'
+      : 'Skills installation is disabled in this configuration.',
+    engineering.length
+      ? `- **Engineering**: ${engineering.map((skill) => '\`' + skill + '\`').join(', ')}`
+      : '',
+    specWorkflow,
+    uiCapability,
+    browserCapability,
+    graftCapability,
+    '',
+    '## Bootstrap & First Session',
+    'When the user asks to "bootstrap this project" or kicks off a new initiative:',
+    '1. Understand product intent and ask 2-3 essential questions to resolve ambiguity.',
+    '2. Draft or refine canonical context in `PRODUCT.md` and `DESIGN.md` (or `docs/adr/`).',
+    '3. Plan in small verifiable increments and implement test-first using installed skills.',
+    ''
+  ];
+
+  return (
+    sections
+      .filter((s) => s !== '')
+      .join('\n')
+      .trim() + '\n'
+  );
+}
+
+export function setupAgentsMarkdown(
+  targetDir: string,
+  config: AginitConfig,
+  options: { overwrite?: boolean; dryRun?: boolean; silent?: boolean } = {}
+): boolean {
+  const { overwrite = false, dryRun = false, silent = false } = options;
+  const filePath = path.join(targetDir, 'AGENTS.md');
+
+  if (fileExists(filePath) && !overwrite) {
+    // File exists; check if it has the bootstrap guidance. If not, append it conservatively.
+    const existing = readTextFile(filePath) || '';
+    if (!existing.includes('## Bootstrap & First Session')) {
+      const addition = [
+        '',
+        '## Bootstrap & First Session',
+        'When the user asks to "bootstrap this project" or kicks off a new initiative:',
+        '1. Understand product intent and ask 2-3 essential questions to resolve ambiguity.',
+        '2. Draft or refine canonical context in `PRODUCT.md` and `DESIGN.md` (or `docs/adr/`).',
+        '3. Plan in small verifiable increments and implement test-first using installed skills.',
+        ''
+      ].join('\n');
+      safeWriteFile(filePath, existing.trimEnd() + '\n' + addition, {
+        overwrite: true,
+        dryRun,
+        silent
+      });
+      if (!silent) logger.dim('Appended Bootstrap section to existing AGENTS.md');
+      return true;
+    }
+    if (!silent) logger.dim('AGENTS.md already exists, preserving content.');
+    return true;
+  }
+
+  const content = generateAgentsMarkdown(config, readPackageManifest(targetDir)?.scripts);
+  return safeWriteFile(filePath, content, { overwrite: true, dryRun, silent });
+}

package/src/adapters/browser.ts

@@ -0,0 +1,49 @@
+import path from 'node:path';
+import { safeWriteFile } from '../utils/fs.js';
+
+const PLAYWRIGHT_CONFIG = `import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './e2e',
+  fullyParallel: true,
+  forbidOnly: !!process.env.CI,
+  retries: process.env.CI ? 2 : 0,
+  workers: process.env.CI ? 1 : undefined,
+  reporter: 'html',
+  use: {
+    trace: 'on-first-retry',
+    screenshot: 'only-on-failure'
+  },
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] }
+    }
+  ]
+});
+`;
+
+const SMOKE_TEST = `import { test, expect } from '@playwright/test';
+
+test.skip('TODO: verify the application in a browser', async ({ page }) => {
+  // Replace with local dev server or preview URL during development
+  // Example: await page.goto('/'); await expect(page).toHaveTitle(/Your app/);
+});
+`;
+
+export function setupBrowserTesting(
+  targetDir: string,
+  options: { dryRun?: boolean; silent?: boolean } = {}
+): void {
+  const { dryRun = false, silent = false } = options;
+
+  safeWriteFile(path.join(targetDir, 'playwright.config.ts'), PLAYWRIGHT_CONFIG, {
+    dryRun,
+    silent
+  });
+
+  safeWriteFile(path.join(targetDir, 'e2e', 'smoke.spec.ts'), SMOKE_TEST, {
+    dryRun,
+    silent
+  });
+}

package/src/adapters/git.ts

@@ -0,0 +1,100 @@
+import path from 'node:path';
+import { fileExists, readTextFile, safeWriteFile } from '../utils/fs.js';
+import { runExecutable } from '../utils/shell.js';
+import { logger } from '../utils/logger.js';
+
+const DEFAULT_GITIGNORE = `# Dependencies
+node_modules/
+.pnpm-store/
+
+# Build artifacts
+dist/
+build/
+.next/
+out/
+
+# Environment
+.env
+.env.*
+!.env.example
+!.env.*.example
+*.local
+
+# Logs & temp
+*.log
+.DS_Store
+*.tsbuildinfo
+
+# Testing & Coverage
+coverage/
+test-results/
+playwright-report/
+blob-report/
+
+# Codebase intelligence cache (graft builds locally, git-ignored)
+/graft/
+`;
+
+export async function setupGit(
+  targetDir: string,
+  options: { dryRun?: boolean; silent?: boolean } = {}
+): Promise<boolean> {
+  const { dryRun = false, silent = false } = options;
+  const gitDir = path.join(targetDir, '.git');
+  const gitignorePath = path.join(targetDir, '.gitignore');
+
+  let gitOk = true;
+
+  // Check if directory is already a git repo or inside an existing git work tree (e.g. monorepo package)
+  let isRepo = fileExists(gitDir);
+  if (!isRepo && !dryRun) {
+    const check = await runExecutable('git', ['rev-parse', '--is-inside-work-tree'], {
+      cwd: targetDir,
+      silent: true
+    });
+    if (check.ok && check.stdout === 'true') {
+      isRepo = true;
+    }
+  }
+
+  if (!isRepo) {
+    if (!silent) logger.dim('Initializing git repository...');
+    const res = await runExecutable('git', ['init'], { cwd: targetDir, dryRun, silent: true });
+    if (!res.ok) {
+      logger.warn(`Failed to initialize git repository: ${res.stderr}`);
+      gitOk = false;
+    }
+  }
+
+  // Ensure .gitignore exists or append essential rules regardless of git init status
+  if (!fileExists(gitignorePath)) {
+    safeWriteFile(gitignorePath, DEFAULT_GITIGNORE, { dryRun, silent });
+  } else {
+    const existing = readTextFile(gitignorePath) || '';
+    const toAppend: string[] = [];
+
+    const essentialRules = [
+      'node_modules/',
+      '/graft/',
+      '.DS_Store',
+      'dist/',
+      '.env',
+      '.env.*',
+      '!.env.example',
+      '!.env.*.example'
+    ];
+    for (const rule of essentialRules) {
+      if (!existing.split(/\r?\n/).includes(rule)) {
+        toAppend.push(rule);
+      }
+    }
+
+    if (toAppend.length > 0) {
+      const updated =
+        existing.trimEnd() + '\n\n# AI & Project rules\n' + toAppend.join('\n') + '\n';
+      safeWriteFile(gitignorePath, updated, { overwrite: true, dryRun, silent });
+    }
+  }
+
+  return gitOk;
+}

package/src/adapters/graft.ts

@@ -0,0 +1,80 @@
+import path from 'node:path';
+import { fileExists, readTextFile, safeWriteFile } from '../utils/fs.js';
+import { commandExists, runExecutable } from '../utils/shell.js';
+import { logger } from '../utils/logger.js';
+
+export async function isGraftInstalled(): Promise<boolean> {
+  return await commandExists('graft');
+}
+
+export async function initGraft(
+  targetDir: string,
+  options: { dryRun?: boolean; silent?: boolean } = {}
+): Promise<boolean> {
+  const { dryRun = false, silent = false } = options;
+
+  const installed = dryRun || (await isGraftInstalled());
+  if (!installed) {
+    if (!silent) {
+      logger.warn(
+        'Graft CLI is not installed. Install it with `npm install -g @nanonets/graft`, then rerun aginit init.'
+      );
+    }
+    return false;
+  }
+
+  if (!silent) logger.dim('Initializing Graft context graph...');
+
+  // Run graft init with antigravity and agents, without touching global system files (--no-global)
+  const res = await runExecutable(
+    'graft',
+    ['init', '--no-global', '--agents', 'antigravity', 'agents', '-y'],
+    {
+      cwd: targetDir,
+      dryRun,
+      silent: true
+    }
+  );
+
+  if (!res.ok) {
+    logger.warn(`Graft initialization warning: ${res.stderr || res.stdout}`);
+    return false;
+  }
+
+  return true;
+}
+
+export async function buildGraft(
+  targetDir: string,
+  options: { dryRun?: boolean; silent?: boolean } = {}
+): Promise<boolean> {
+  const { dryRun = false } = options;
+  const installed = dryRun || (await isGraftInstalled());
+  if (!installed) return false;
+
+  const res = await runExecutable('graft', ['build'], { cwd: targetDir, dryRun, silent: true });
+  return res.ok;
+}
+
+export async function uninstallGraft(
+  targetDir: string,
+  options: { dryRun?: boolean; silent?: boolean } = {}
+): Promise<boolean> {
+  const { dryRun = false } = options;
+  const installed = dryRun || (await isGraftInstalled());
+  if (installed) {
+    await runExecutable('graft', ['uninstall'], { cwd: targetDir, dryRun, silent: true });
+  }
+
+  // Also clean up AGENTS.md fenced section if any remain
+  const agentsPath = path.join(targetDir, 'AGENTS.md');
+  if (fileExists(agentsPath)) {
+    const content = readTextFile(agentsPath) || '';
+    const cleaned = content
+      .replace(/<!-- graft:start -->[\s\S]*?<!-- graft:end -->\n?/g, '')
+      .trim();
+    safeWriteFile(agentsPath, cleaned + '\n', { overwrite: true, dryRun });
+  }
+
+  return true;
+}

package/src/adapters/package-manager.ts

@@ -0,0 +1,116 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { PackageManager } from '../config/schema.js';
+
+export interface PackageManagerAdapter {
+  name: PackageManager;
+  installCmd: string;
+  runCmd: (script: string) => string;
+  execCmd: (pkg: string, args?: string[]) => string;
+  lockfile: string;
+  scaffoldViteCmd: (template?: string) => string;
+  scaffoldNextCmd: () => string;
+}
+
+export const PACKAGE_MANAGERS: Record<PackageManager, PackageManagerAdapter> = {
+  pnpm: {
+    name: 'pnpm',
+    installCmd: 'pnpm install',
+    runCmd: (script: string) => `pnpm ${script}`,
+    execCmd: (pkg: string, args: string[] = []) =>
+      `pnpm dlx ${pkg}${args.length ? ' ' + args.join(' ') : ''}`,
+    lockfile: 'pnpm-lock.yaml',
+    scaffoldViteCmd: (template = 'react-ts') => `pnpm create vite . --template ${template}`,
+    scaffoldNextCmd: () =>
+      `pnpm create next-app . --typescript --tailwind --eslint --app --src-dir --import-alias "@/*" --use-pnpm`
+  },
+  npm: {
+    name: 'npm',
+    installCmd: 'npm install',
+    runCmd: (script: string) => `npm run ${script}`,
+    execCmd: (pkg: string, args: string[] = []) =>
+      `npx -y ${pkg}${args.length ? ' ' + args.join(' ') : ''}`,
+    lockfile: 'package-lock.json',
+    scaffoldViteCmd: (template = 'react-ts') =>
+      `npm create vite@latest . -- --template ${template}`,
+    scaffoldNextCmd: () =>
+      `npx -y create-next-app@latest . --typescript --tailwind --eslint --app --src-dir --import-alias "@/*" --use-npm`
+  },
+  yarn: {
+    name: 'yarn',
+    installCmd: 'yarn install',
+    runCmd: (script: string) => `yarn ${script}`,
+    execCmd: (pkg: string, args: string[] = []) =>
+      `yarn dlx ${pkg}${args.length ? ' ' + args.join(' ') : ''}`,
+    lockfile: 'yarn.lock',
+    scaffoldViteCmd: (template = 'react-ts') => `yarn create vite . --template ${template}`,
+    scaffoldNextCmd: () =>
+      `yarn create next-app . --typescript --tailwind --eslint --app --src-dir --import-alias "@/*" --use-yarn`
+  },
+  bun: {
+    name: 'bun',
+    installCmd: 'bun install',
+    runCmd: (script: string) => `bun run ${script}`,
+    execCmd: (pkg: string, args: string[] = []) =>
+      `bunx ${pkg}${args.length ? ' ' + args.join(' ') : ''}`,
+    lockfile: 'bun.lockb',
+    scaffoldViteCmd: (template = 'react-ts') => `bun create vite . --template ${template}`,
+    scaffoldNextCmd: () =>
+      `bun create next-app . --typescript --tailwind --eslint --app --src-dir --import-alias "@/*" --use-bun`
+  }
+};
+
+export function getPackageManagerAdapter(pm: PackageManager = 'pnpm'): PackageManagerAdapter {
+  return PACKAGE_MANAGERS[pm] || PACKAGE_MANAGERS.pnpm;
+}
+
+export function detectPackageManager(dir: string): PackageManager | null {
+  if (fs.existsSync(path.join(dir, 'pnpm-lock.yaml'))) {
+    return 'pnpm';
+  }
+  if (fs.existsSync(path.join(dir, 'bun.lockb')) || fs.existsSync(path.join(dir, 'bun.lock'))) {
+    return 'bun';
+  }
+  if (fs.existsSync(path.join(dir, 'yarn.lock'))) {
+    return 'yarn';
+  }
+  if (fs.existsSync(path.join(dir, 'package-lock.json'))) {
+    return 'npm';
+  }
+  return null;
+}
+
+/** Yarn Classic lacks dlx; npx fetches tools while --use-yarn selects the app manager.
+ * Commands used for execution; string helpers above are for displaying commands only. */
+export function scaffoldCommand(
+  pm: PackageManager,
+  framework: 'vite' | 'next'
+): { executable: string; args: string[] } {
+  const runners: Record<PackageManager, [string, ...string[]]> = {
+    pnpm: ['pnpm', 'dlx'],
+    npm: ['npx', '-y'],
+    yarn: ['npx', '-y'],
+    bun: ['bunx']
+  };
+  const [executable, ...prefix] = runners[pm];
+  const args =
+    framework === 'vite'
+      ? ['create-vite@latest', '.', '--template', 'react-ts', '--no-interactive', '--no-immediate']
+      : [
+          'create-next-app@latest',
+          '.',
+          '--typescript',
+          '--tailwind',
+          '--eslint',
+          '--app',
+          '--src-dir',
+          '--import-alias',
+          '@/*',
+          `--use-${pm}`,
+          '--yes',
+          '--skip-install',
+          '--disable-git',
+          '--no-agents-md'
+        ];
+  return { executable, args: [...prefix, ...args] };
+}