@antomanc/aginit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Antonio Mancuso
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,245 @@
+# Aginit
+
+> **Public Beta (v0.1.0)** — Minimal, modular AI-first project bootstrapper for T3 Code, Antigravity, and Codex.
+
+[![CI](https://github.com/antomanc/aginit/actions/workflows/ci.yml/badge.svg)](https://github.com/antomanc/aginit/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![npm version](https://img.shields.io/npm/v/@antomanc/aginit)](https://www.npmjs.com/package/@antomanc/aginit)
+
+---
+
+## Philosophy
+
+> **“We orchestrate the tools. We don’t replace them.”**
+
+Aginit initializes software projects ready for AI-assisted development in seconds. Instead of reinventing custom agent frameworks or vendoring brittle skills, Aginit ties together best-in-class upstream capabilities into a coherent, idempotent developer workflow.
+
+- **Zero vendoring**: Skills and codebase graphs are fetched and configured directly from upstream maintainers via standard package ecosystems (`skills.sh`, `graft`).
+- **Dual-agent parity**: Antigravity and Codex share the exact same `.agents/skills` and `AGENTS.md` conventions without conflicting configurations.
+- **Conservative & idempotent**: Never overwrites existing code destructively; respects your choice of framework, toolchain, and package manager.
+
+---
+
+## What Aginit Configures
+
+Every project bootstrapped with Aginit receives:
+
+1. **Upstream Skills Engine (`skills.sh`)**:
+   - Universal engineering trio: `tdd`, `code-review`, `diagnosing-bugs` (by Matt Pocock).
+   - *Optional* spec workflow: `to-spec`, `to-tickets`, `implement-spec` (`--spec-workflow`).
+   - Frontend craft & UI polish: `impeccable` (by Peter Bak-Hansen) for web presets.
+   - Interactive visual inspection: `agent-browser` (by Vercel Labs) for web presets.
+2. **Codebase Understanding (`graft`)**:
+   - Deterministic structural code graph and fast token-efficient semantic map (`graft map`, `graft ask`).
+3. **Agent Invariants (`AGENTS.md`)**:
+   - A short, non-invasive intake contract and invariant guide that agents parse immediately upon opening the repository in T3 Code.
+4. **Deterministic Testing Harness**:
+   - Vitest for instant unit testing.
+   - Playwright for browser testing when a web framework is selected. Its starter test is explicitly skipped until you supply an application URL and real assertions.
+5. **Declarative State (`aginit.config.json`)**:
+   - Versioned project manifest (`schemaVersion: "1.0.0"`) tracking active agents, skills, preset, and package manager.
+
+---
+
+## Quickstart
+
+### Prerequisites
+
+- Node.js **22.12 or newer** (use a supported Node LTS release).
+- Git and npm/npx in `PATH`; install your selected package manager before using it.
+- Internet access for official framework scaffolders and upstream skills.
+- Optional Graft CLI: `npm install -g @nanonets/graft`. Use `--no-graft` to omit it.
+
+### Interactive Wizard (Recommended)
+
+Simply run `aginit` or `npx @antomanc/aginit` with no arguments in your terminal to launch the interactive prompt:
+
+```bash
+# Run directly without installation
+npx @antomanc/aginit
+
+# Or with pnpm dlx
+pnpm dlx @antomanc/aginit
+
+# Or install globally
+npm install -g @antomanc/aginit
+aginit
+```
+
+The wizard prompts only for meaningful choices:
+1. Action: *Create brand new project* vs *Initialize in current directory*
+2. Project name (when creating a new project)
+3. Preset (`web` | `cli` | `generic`)
+4. Framework (for `web`: `none` | `vite` | `next` | `existing`)
+5. Workflow (`minimal` | `spec`)
+6. Package Manager (`pnpm (Recommended)` | `npm` | `yarn` | `bun`) — *auto-detected and preserved when initializing existing projects*
+
+### Non-Interactive / Scriptable CLI
+
+All commands accept explicit flags for automated environments and CI:
+
+```bash
+# Create a new web project directly with pnpm
+aginit new my-web-app --preset web --framework vite --package-manager pnpm
+
+# Or with npm, yarn, or bun
+aginit new my-app --preset web --package-manager bun
+
+# Or via npx
+npx @antomanc/aginit new my-web-app --preset web
+```
+
+Then open the project in **T3 Code**, and tell Antigravity:
+> *"bootstrap this project"*
+
+---
+
+## Package Managers
+
+Aginit provides centralized package manager orchestration:
+- **Supported Managers**: `pnpm` (recommended/default), `npm`, `yarn` (Classic or modern), `bun`.
+- **New Projects**: Prompted as the final wizard step, or configured via `--package-manager <pm>`. Stored in `aginit.config.json`.
+- **Existing Projects**: Automatically detects existing lockfiles (`pnpm-lock.yaml`, `bun.lockb`, `yarn.lock`, `package-lock.json`) and preserves your manager without prompting.
+- **Official Scaffolding**: Passes the selected package manager to upstream toolchains (e.g. `--use-pnpm`, `--use-npm`, `--use-yarn`, `--use-bun` for Next.js, and package manager specific create commands for Vite).
+- **Clean Toolchains**: `pnpm-workspace.yaml` and pnpm-specific lifecycle configs are only generated when `pnpm` is the active manager.
+
+---
+
+## Presets & Frameworks
+
+### 1. `web` Preset
+
+Framework-agnostic by default:
+
+```bash
+# Agnostic baseline: clean TypeScript + Vitest, zero bundler lock-in
+aginit new my-app --preset web --framework none
+
+# Official Vite scaffolding
+aginit new my-vite-app --preset web --framework vite
+
+# Official Next.js scaffolding
+aginit new my-next-app --preset web --framework next
+```
+
+*Note: With `--framework none`, Aginit does not generate dummy or failing E2E configs until an actual web target is introduced.*
+
+### 2. `cli` Preset
+
+```bash
+aginit new my-cli --preset cli
+```
+Configures an executable Node.js/TypeScript CLI with Commander, Picocolors, and Vitest.
+
+### 3. `generic` Preset
+
+```bash
+aginit new my-repo --preset generic
+```
+Minimal AI readiness for any codebase: Git, `.agents/skills`, Graft context graph, and `AGENTS.md`.
+
+---
+
+## Adding Aginit to an Existing Project
+
+Run `aginit init` inside an existing repository:
+
+```bash
+cd my-existing-project
+aginit init --preset web
+```
+
+Aginit preserves application source, custom scripts, dependency versions, and existing test configurations. The web and CLI presets add missing test tooling to `package.json`; custom test runners get a separate `test:unit` script. The generic preset leaves an existing project manifest untouched.
+
+Repeat `aginit init` preserves the saved preset, framework, agents, workflow, skill sources, and extension fields. Explicit options override the requested setting. Invalid JSON or configuration is reported before initialization changes files. `--no-skills` skips installation without erasing an existing configuration's sources.
+
+---
+
+## Diagnostics (`aginit doctor`)
+
+Run the health check at any time to inspect system tooling and repository agent readiness (it may download the upstream Skills CLI through npx):
+
+```bash
+aginit doctor
+```
+
+Checks:
+- Node.js runtime and active project package manager (`pnpm`, `npm`, `yarn`, or `bun`)
+- Git repository state
+- Global Graft CLI availability
+- Codex CLI availability (secondary reviewer)
+- Skills CLI engine functionality
+- `aginit.config.json` schema validation and package manager setting
+- `AGENTS.md` context and intake section
+- Installed `.agents/skills/` health
+
+---
+
+## Updating Upstream Capabilities (`aginit update`)
+
+Keep your project's skills and codebase graph up to date:
+
+```bash
+aginit update
+```
+
+This runs the upstream project-scoped `skills update` and refreshes the Graft graph index. Disabled integrations are skipped; failed updates return a nonzero exit status.
+
+---
+
+## Safety & Dry Run
+
+Preview changes without touching the disk:
+
+```bash
+aginit new test-project --preset web --dry-run
+aginit init --dry-run
+```
+
+Existing application files are preserved. Manifest additions and explicit configuration changes are intentional; rerunning the same initialization is idempotent. Framework scaffold failures stop the command instead of generating a substitute app.
+
+Missing Graft or failed skill installation produces an actionable warning and a nonzero exit status. The scaffold is retained so you can resolve the prerequisite and rerun `aginit init`.
+
+`--dry-run` prints planned operations without creating files or downloading framework tools. Upstream-generated files cannot be enumerated until the real scaffolder runs.
+
+---
+
+## Development & Release Verification
+
+```bash
+pnpm install --frozen-lockfile
+pnpm check                 # typecheck, tests, build, dependency audit
+pnpm smoke                 # install the tarball and verify generated consumer projects
+pnpm smoke --frameworks    # additionally scaffold, test, build, and serve Vite and Next.js
+pnpm smoke --package-managers # verify native pnpm, Yarn, and Bun consumer commands
+npm pack --dry-run
+```
+
+The framework smoke test downloads upstream tools and dependencies. The generated generic project has a working Vitest starter harness; application-specific assertions remain yours to write. `npm publish` runs the checks and base consumer smoke test before publication.
+
+---
+
+## Upstream Licenses Notice
+
+Aginit integrates and configures independent open-source software and skills:
+- **Graft**: Copyright © NanoNets / Graft contributors
+- **skills.sh**: Copyright © Vercel Inc. and contributors
+- **Matt Pocock Skills**: Copyright © Matt Pocock
+- **Impeccable**: Copyright © Peter Bak-Hansen
+- **agent-browser**: Copyright © Vercel Labs
+- **Playwright**: Copyright © Microsoft Corporation
+
+Each upstream tool is governed by its own independent license. Aginit does not vendor, alter, or relicense upstream software. For details, see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+
+---
+
+## Contributing & Security
+
+- **Contributing**: Please read [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on development and submitting pull requests.
+- **Security**: See [SECURITY.md](SECURITY.md) for our vulnerability reporting policy.
+
+---
+
+## License
+
+[MIT](LICENSE) © 2026 Antonio Mancuso

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,36 @@
+# Third-Party Notices & Upstream Capabilities
+
+Aginit is an orchestrator and bootstrapper that configures and integrates independent open-source tools and skills. Aginit does not vendor, fork, claim ownership of, or relicense upstream software.
+
+Each integrated upstream tool is governed by its respective authors and licenses:
+
+- **Graft**
+  - Project: Codebase understanding & context graph CLI
+  - Author: NanoNets / Graft contributors
+  - Repository: https://github.com/NanoNets/context-graph-engine
+
+- **Skills CLI / skills.sh**
+  - Project: Decentralized agent skill package installer
+  - Author: Vercel Inc. and contributors
+  - Website: https://skills.sh
+
+- **Matt Pocock Skills**
+  - Project: Workflow skills (`tdd`, `code-review`, `diagnosing-bugs`, `to-spec`, `to-tickets`, `implement-spec`)
+  - Author: Matt Pocock
+  - Repository: https://github.com/mattpocock/skills
+
+- **Impeccable**
+  - Project: Frontend craft & design system review skill
+  - Author: Peter Bak-Hansen
+  - Repository: https://github.com/pbakaus/impeccable
+
+- **agent-browser**
+  - Project: Fast headless/CDP browser automation CLI for AI agents
+  - Author: Vercel Labs
+  - Repository: https://github.com/vercel-labs/agent-browser
+
+- **Playwright**
+  - Project: End-to-end testing framework
+  - Author: Microsoft Corporation
+  - License: Apache-2.0
+  - Website: https://playwright.dev

package/bin/aginit.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { createCliProgram } from '../dist/cli/main.js';
+
+const program = createCliProgram();
+program.parseAsync(process.argv).catch((err) => {
+  console.error(err.message || err);
+  process.exit(1);
+});

package/dist/adapters/agents-md.d.ts

@@ -0,0 +1,8 @@
+import { AginitConfig } from '../config/schema.js';
+export declare function generateAgentsMarkdown(config: AginitConfig, scripts?: Record<string, string>): string;
+export declare function setupAgentsMarkdown(targetDir: string, config: AginitConfig, options?: {
+    overwrite?: boolean;
+    dryRun?: boolean;
+    silent?: boolean;
+}): boolean;
+//# sourceMappingURL=agents-md.d.ts.map

package/dist/adapters/agents-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../src/adapters/agents-md.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CA+FR;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACxE,OAAO,CA+BT"}

package/dist/adapters/agents-md.js

@@ -0,0 +1,121 @@
+import path from 'node:path';
+import { fileExists, readTextFile, safeWriteFile } from '../utils/fs.js';
+import { readPackageManifest } from '../config/validation.js';
+import { logger } from '../utils/logger.js';
+import { getPackageManagerAdapter } from './package-manager.js';
+export function generateAgentsMarkdown(config, scripts) {
+    const commands = scripts ??
+        (config.preset === 'generic'
+            ? { test: 'vitest run' }
+            : { build: '', typecheck: '', test: '', dev: '', 'test:e2e': '' });
+    const hasCommand = (name) => 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, config, options = {}) {
+    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 });
+}
+//# sourceMappingURL=agents-md.js.map

package/dist/adapters/agents-md.js.map

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

package/dist/adapters/browser.d.ts

@@ -0,0 +1,5 @@
+export declare function setupBrowserTesting(targetDir: string, options?: {
+    dryRun?: boolean;
+    silent?: boolean;
+}): void;
+//# sourceMappingURL=browser.d.ts.map

package/dist/adapters/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/adapters/browser.ts"],"names":[],"mappings":"AAiCA,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,IAAI,CAYN"}

package/dist/adapters/browser.js

@@ -0,0 +1,42 @@
+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, options = {}) {
+    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
+    });
+}
+//# sourceMappingURL=browser.js.map

package/dist/adapters/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/adapters/browser.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBzB,CAAC;AAEF,MAAM,UAAU,GAAG;;;;;;CAMlB,CAAC;AAEF,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,UAAkD,EAAE;IAEpD,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEnD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,EAAE,iBAAiB,EAAE;QAC7E,MAAM;QACN,MAAM;KACP,CAAC,CAAC;IAEH,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE,UAAU,EAAE;QACtE,MAAM;QACN,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/dist/adapters/git.d.ts

@@ -0,0 +1,5 @@
+export declare function setupGit(targetDir: string, options?: {
+    dryRun?: boolean;
+    silent?: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=git.d.ts.map

package/dist/adapters/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/adapters/git.ts"],"names":[],"mappings":"AAqCA,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,OAAO,CAAC,OAAO,CAAC,CA2DlB"}

package/dist/adapters/git.js

@@ -0,0 +1,90 @@
+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, options = {}) {
+    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 = [];
+        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;
+}
+//# sourceMappingURL=git.js.map

package/dist/adapters/git.js.map

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

package/dist/adapters/graft.d.ts

@@ -0,0 +1,14 @@
+export declare function isGraftInstalled(): Promise<boolean>;
+export declare function initGraft(targetDir: string, options?: {
+    dryRun?: boolean;
+    silent?: boolean;
+}): Promise<boolean>;
+export declare function buildGraft(targetDir: string, options?: {
+    dryRun?: boolean;
+    silent?: boolean;
+}): Promise<boolean>;
+export declare function uninstallGraft(targetDir: string, options?: {
+    dryRun?: boolean;
+    silent?: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=graft.d.ts.map

package/dist/adapters/graft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graft.d.ts","sourceRoot":"","sources":["../../src/adapters/graft.ts"],"names":[],"mappings":"AAKA,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAEzD;AAED,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,OAAO,CAAC,OAAO,CAAC,CAgClB;AAED,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACnD,OAAO,CAAC,OAAO,CAAC,CAkBlB"}