@antomanc/aginit 0.1.0

package/dist/presets/adr.js

@@ -0,0 +1,33 @@
+import path from 'node:path';
+import { safeWriteFile } from '../utils/fs.js';
+const ADR_0001_CONTENT = `# 1. Record Architecture Decisions
+
+Date: 2026-10-04
+
+## Status
+Accepted
+
+## Context
+We need to record significant architectural, structural, and tooling decisions
+made throughout the lifecycle of this project so humans and AI agents understand
+the rationale behind key choices.
+
+## Decision
+We will use Architecture Decision Records (ADRs) stored in \`docs/adr/\`.
+Each record describes:
+- **Status**: Proposed, Accepted, Rejected, Superseded.
+- **Context**: The problem or requirement prompting the decision.
+- **Decision**: The selected option and why it was chosen.
+- **Consequences**: Positive and negative outcomes or trade-offs.
+
+## Consequences
+- Every major architectural shift is tracked in version control.
+- Agents reading this repository can inspect historical decisions to avoid
+  re-proposing already evaluated or superseded designs.
+`;
+export function setupAdr(targetDir, options = {}) {
+    const { dryRun = false, silent = false } = options;
+    const adrFile = path.join(targetDir, 'docs', 'adr', '0001-record-architecture-decisions.md');
+    safeWriteFile(adrFile, ADR_0001_CONTENT, { dryRun, silent });
+}
+//# sourceMappingURL=adr.js.map

package/dist/presets/adr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr.js","sourceRoot":"","sources":["../../src/presets/adr.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBxB,CAAC;AAEF,MAAM,UAAU,QAAQ,CACtB,SAAiB,EACjB,UAAkD,EAAE;IAEpD,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,uCAAuC,CAAC,CAAC;IAC7F,aAAa,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/dist/presets/cli.d.ts

@@ -0,0 +1,3 @@
+import { PresetHandler } from './types.js';
+export declare const cliPreset: PresetHandler;
+//# sourceMappingURL=cli.d.ts.map

package/dist/presets/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/presets/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AAK1D,eAAO,MAAM,SAAS,EAAE,aAgIvB,CAAC"}

package/dist/presets/cli.js

@@ -0,0 +1,126 @@
+import path from 'node:path';
+import { fileExists, safeWriteFile, writeJsonFile } from '../utils/fs.js';
+import { readPackageManifest } from '../config/validation.js';
+import { addTestingDependencies, setupTesting, VITEST_VERSION } from './testing.js';
+import { setupAdr } from './adr.js';
+export const cliPreset = {
+    name: 'cli',
+    description: 'AI-first TypeScript CLI application with Commander, Picocolors, and Vitest',
+    async scaffold(ctx) {
+        const { targetDir, projectName, dryRun, silent } = ctx;
+        const pm = ctx.config.packageManager || 'pnpm';
+        const existing = readPackageManifest(targetDir);
+        if (existing) {
+            const hadVitestScript = Object.values(existing.scripts || {}).some((script) => typeof script === 'string' && /^vitest(?:\s|$)/.test(script));
+            addTestingDependencies(existing);
+            writeJsonFile(path.join(targetDir, 'package.json'), existing, {
+                overwrite: true,
+                dryRun,
+                silent
+            });
+            setupTesting(ctx, hadVitestScript);
+            if (ctx.config.docs.adr)
+                setupAdr(targetDir, { dryRun, silent });
+            return;
+        }
+        // 1. package.json
+        const pkg = {
+            name: projectName,
+            version: '0.1.0',
+            type: 'module',
+            bin: {
+                [projectName.split('/').pop()]: './bin/cli.js'
+            },
+            scripts: {
+                build: 'tsc',
+                test: 'vitest run',
+                'test:watch': 'vitest',
+                typecheck: 'tsc --noEmit',
+                prepack: 'tsc'
+            },
+            dependencies: {
+                commander: '^12.1.0',
+                picocolors: '^1.1.1'
+            },
+            devDependencies: {
+                '@types/node': '^22.8.0',
+                typescript: '^5.6.3',
+                vitest: VITEST_VERSION
+            }
+        };
+        writeJsonFile(path.join(targetDir, 'package.json'), pkg, { dryRun, silent });
+        // pnpm-workspace.yaml generated ONLY for pnpm!
+        if (pm === 'pnpm') {
+            const workspaceYamlPath = path.join(targetDir, 'pnpm-workspace.yaml');
+            if (!fileExists(workspaceYamlPath)) {
+                const workspaceYaml = `allowBuilds:\n  esbuild: true\n`;
+                safeWriteFile(workspaceYamlPath, workspaceYaml, { dryRun, silent });
+            }
+        }
+        // 2. tsconfig.json
+        const tsconfig = {
+            compilerOptions: {
+                target: 'ES2022',
+                module: 'NodeNext',
+                moduleResolution: 'NodeNext',
+                lib: ['ES2022'],
+                strict: true,
+                skipLibCheck: true,
+                outDir: 'dist',
+                rootDir: 'src',
+                declaration: true
+            },
+            include: ['src/**/*']
+        };
+        writeJsonFile(path.join(targetDir, 'tsconfig.json'), tsconfig, { dryRun, silent });
+        // 3. vitest.config.ts
+        const vitestConfig = `import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    include: ['tests/**/*.test.{js,ts}']
+  }
+});
+`;
+        safeWriteFile(path.join(targetDir, 'vitest.config.ts'), vitestConfig, { dryRun, silent });
+        // 4. Executable CLI entrypoint
+        const binCli = `#!/usr/bin/env node
+import { run } from '../dist/index.js';
+
+run(process.argv.slice(2)).catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
+`;
+        safeWriteFile(path.join(targetDir, 'bin', 'cli.js'), binCli, {
+            dryRun,
+            silent,
+            mode: 0o755
+        });
+        // 5. Source code
+        const srcIndex = `export async function run(args: string[] = []): Promise<void> {\n  console.log(${JSON.stringify(projectName + ' ready. Args:')}, args);\n}\n`;
+        const createdSource = safeWriteFile(path.join(targetDir, 'src', 'index.ts'), srcIndex, {
+            dryRun,
+            silent
+        });
+        // 6. Unit test
+        const unitTest = `import { describe, it, expect } from 'vitest';
+import { run } from '../src/index.js';
+
+describe('run', () => {
+  it('runs with the supplied arguments', async () => {
+    await expect(run(['--help'])).resolves.toBeUndefined();
+  });
+});
+`;
+        if (createdSource)
+            safeWriteFile(path.join(targetDir, 'tests', 'index.test.ts'), unitTest, { dryRun, silent });
+        else
+            setupTesting(ctx);
+        // 7. Docs ADR
+        if (ctx.config.docs.adr) {
+            setupAdr(targetDir, { dryRun, silent });
+        }
+    }
+};
+//# sourceMappingURL=cli.js.map

package/dist/presets/cli.js.map

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

package/dist/presets/generic.d.ts

@@ -0,0 +1,3 @@
+import { PresetHandler } from './types.js';
+export declare const genericPreset: PresetHandler;
+//# sourceMappingURL=generic.d.ts.map

package/dist/presets/generic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../src/presets/generic.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AAI1D,eAAO,MAAM,aAAa,EAAE,aAyB3B,CAAC"}

package/dist/presets/generic.js

@@ -0,0 +1,29 @@
+import path from 'node:path';
+import { fileExists, writeJsonFile } from '../utils/fs.js';
+import { addTestingDependencies, setupTesting } from './testing.js';
+import { setupAdr } from './adr.js';
+export const genericPreset = {
+    name: 'generic',
+    description: 'Minimal, unopinionated project skeleton with AI skills, Git, and ADR structure',
+    async scaffold(ctx) {
+        const { targetDir, projectName, dryRun, silent } = ctx;
+        const pkgPath = path.join(targetDir, 'package.json');
+        if (!fileExists(pkgPath)) {
+            const pkg = {
+                name: projectName,
+                version: '0.1.0',
+                type: 'module',
+                scripts: {
+                    test: 'vitest run'
+                }
+            };
+            addTestingDependencies(pkg);
+            writeJsonFile(pkgPath, pkg, { dryRun, silent });
+            setupTesting(ctx);
+        }
+        if (ctx.config.docs.adr) {
+            setupAdr(targetDir, { dryRun, silent });
+        }
+    }
+};
+//# sourceMappingURL=generic.js.map

package/dist/presets/generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../src/presets/generic.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,gFAAgF;IAC7F,KAAK,CAAC,QAAQ,CAAC,GAAkB;QAC/B,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;QAEvD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG;gBACV,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,OAAO;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE;oBACP,IAAI,EAAE,YAAY;iBACnB;aACF,CAAC;YACF,sBAAsB,CAAC,GAAG,CAAC,CAAC;YAC5B,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAChD,YAAY,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QAED,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;YACxB,QAAQ,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/presets/registry.d.ts

@@ -0,0 +1,6 @@
+import { PresetHandler } from './types.js';
+import { PresetType } from '../config/schema.js';
+export declare const presets: Record<PresetType, PresetHandler>;
+export declare function getPreset(name: string): PresetHandler;
+export declare function listPresets(): PresetHandler[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/presets/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/presets/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI3C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,aAAa,CAIrD,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAOrD;AAED,wBAAgB,WAAW,IAAI,aAAa,EAAE,CAE7C"}

package/dist/presets/registry.js

@@ -0,0 +1,20 @@
+import { webPreset } from './web.js';
+import { cliPreset } from './cli.js';
+import { genericPreset } from './generic.js';
+export const presets = {
+    web: webPreset,
+    cli: cliPreset,
+    generic: genericPreset
+};
+export function getPreset(name) {
+    const handler = presets[name];
+    if (!handler) {
+        const valid = Object.keys(presets).join(', ');
+        throw new Error(`Unknown preset: "${name}". Valid presets are: ${valid}`);
+    }
+    return handler;
+}
+export function listPresets() {
+    return Object.values(presets);
+}
+//# sourceMappingURL=registry.js.map

package/dist/presets/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/presets/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,MAAM,CAAC,MAAM,OAAO,GAAsC;IACxD,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,aAAa;CACvB,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAkB,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,yBAAyB,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/presets/testing.d.ts

@@ -0,0 +1,6 @@
+import { PresetContext } from './types.js';
+export declare const VITEST_VERSION = "^4.1.11";
+export declare function addTestingDependencies(pkg: Record<string, any>, playwright?: boolean): void;
+/** A starter harness checks package metadata without assuming application exports. */
+export declare function setupTesting(ctx: PresetContext, preserveViteTestConfig?: boolean): void;
+//# sourceMappingURL=testing.d.ts.map

package/dist/presets/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/presets/testing.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,cAAc,YAAY,CAAC;AACxC,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,UAAQ,GAAG,IAAI,CAczF;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,sBAAsB,UAAQ,GAAG,IAAI,CAiCrF"}

package/dist/presets/testing.js

@@ -0,0 +1,46 @@
+import path from 'node:path';
+import { safeWriteFile, fileExists } from '../utils/fs.js';
+export const VITEST_VERSION = '^4.1.11';
+export function addTestingDependencies(pkg, playwright = false) {
+    pkg.scripts ??= {};
+    pkg.devDependencies ??= {};
+    if (!pkg.dependencies?.vitest && !pkg.devDependencies.vitest)
+        pkg.devDependencies.vitest = VITEST_VERSION;
+    const customTest = pkg.scripts.test && !/^vitest(?:\s|$)/.test(pkg.scripts.test);
+    const testScript = customTest ? 'test:unit' : 'test';
+    pkg.scripts[testScript] ??= 'vitest run';
+    pkg.scripts[customTest ? 'test:unit:watch' : 'test:watch'] ??= 'vitest';
+    if (playwright) {
+        pkg.scripts['test:e2e'] ??= 'playwright test';
+        if (!pkg.dependencies?.['@playwright/test'] && !pkg.devDependencies['@playwright/test'])
+            pkg.devDependencies['@playwright/test'] = '^1.63.0';
+    }
+}
+/** A starter harness checks package metadata without assuming application exports. */
+export function setupTesting(ctx, preserveViteTestConfig = false) {
+    const { targetDir, dryRun, silent } = ctx;
+    const hasConfig = [
+        'vitest.config.ts',
+        'vitest.config.js',
+        'vitest.config.mts',
+        'vitest.config.mjs',
+        'vitest.config.cts',
+        'vitest.config.cjs',
+        ...(preserveViteTestConfig
+            ? ['vite.config.ts', 'vite.config.js', 'vite.config.mts', 'vite.config.mjs']
+            : [])
+    ].some((name) => fileExists(path.join(targetDir, name)));
+    if (!hasConfig)
+        safeWriteFile(path.join(targetDir, 'vitest.config.mts'), `import { defineConfig } from 'vitest/config';\n\nexport default defineConfig({\n  test: { include: ['tests/**/*.test.{js,ts}'] }\n});\n`, { dryRun, silent });
+    safeWriteFile(path.join(targetDir, 'tests', 'aginit.test.js'), `import { it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+
+// Starter harness: add application behavior tests as the project takes shape.
+it('has a valid project manifest', () => {
+  const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+  expect(typeof pkg.name).toBe('string');
+  expect(pkg.name.length).toBeGreaterThan(0);
+});
+`, { dryRun, silent });
+}
+//# sourceMappingURL=testing.js.map

package/dist/presets/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/presets/testing.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG3D,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AACxC,MAAM,UAAU,sBAAsB,CAAC,GAAwB,EAAE,UAAU,GAAG,KAAK;IACjF,GAAG,CAAC,OAAO,KAAK,EAAE,CAAC;IACnB,GAAG,CAAC,eAAe,KAAK,EAAE,CAAC;IAC3B,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM;QAC1D,GAAG,CAAC,eAAe,CAAC,MAAM,GAAG,cAAc,CAAC;IAC9C,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,YAAY,CAAC;IACzC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC;IACxE,IAAI,UAAU,EAAE,CAAC;QACf,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,iBAAiB,CAAC;QAC9C,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,kBAAkB,CAAC;YACrF,GAAG,CAAC,eAAe,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC;IACxD,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,YAAY,CAAC,GAAkB,EAAE,sBAAsB,GAAG,KAAK;IAC7E,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAC1C,MAAM,SAAS,GAAG;QAChB,kBAAkB;QAClB,kBAAkB;QAClB,mBAAmB;QACnB,mBAAmB;QACnB,mBAAmB;QACnB,mBAAmB;QACnB,GAAG,CAAC,sBAAsB;YACxB,CAAC,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,CAAC;YAC5E,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,SAAS;QACZ,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,EACzC,yIAAyI,EACzI,EAAE,MAAM,EAAE,MAAM,EAAE,CACnB,CAAC;IACJ,aAAa,CACX,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAC/C;;;;;;;;;CASH,EACG,EAAE,MAAM,EAAE,MAAM,EAAE,CACnB,CAAC;AACJ,CAAC"}

package/dist/presets/types.d.ts

@@ -0,0 +1,14 @@
+import { AIProjectConfig, PresetType } from '../config/schema.js';
+export interface PresetContext {
+    targetDir: string;
+    projectName: string;
+    config: AIProjectConfig;
+    dryRun?: boolean;
+    silent?: boolean;
+}
+export interface PresetHandler {
+    name: PresetType;
+    description: string;
+    scaffold: (ctx: PresetContext) => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/presets/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/presets/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD"}

package/dist/presets/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/presets/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/presets/types.ts"],"names":[],"mappings":""}

package/dist/presets/web.d.ts

@@ -0,0 +1,3 @@
+import { PresetHandler } from './types.js';
+export declare const webPreset: PresetHandler;
+//# sourceMappingURL=web.d.ts.map

package/dist/presets/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/presets/web.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AAM1D,eAAO,MAAM,SAAS,EAAE,aAwFvB,CAAC"}

package/dist/presets/web.js

@@ -0,0 +1,84 @@
+import path from 'node:path';
+import { fileExists, safeWriteFile, writeJsonFile } from '../utils/fs.js';
+import { readPackageManifest } from '../config/validation.js';
+import { runExecutable } from '../utils/shell.js';
+import { setupBrowserTesting } from '../adapters/browser.js';
+import { setupAdr } from './adr.js';
+import { scaffoldCommand } from '../adapters/package-manager.js';
+import { addTestingDependencies, setupTesting } from './testing.js';
+export const webPreset = {
+    name: 'web',
+    description: 'Framework-agnostic web project with upstream scaffolding, Vitest and optional Playwright',
+    async scaffold(ctx) {
+        const { targetDir, projectName, dryRun, silent, config } = ctx;
+        const framework = config.framework || 'none';
+        const pkgPath = path.join(targetDir, 'package.json');
+        const pm = config.packageManager || 'pnpm';
+        let pkg = readPackageManifest(targetDir);
+        const fresh = pkg === null;
+        if (fresh && framework === 'existing')
+            throw new Error('An existing framework requires an existing package.json.');
+        if (fresh && (framework === 'vite' || framework === 'next')) {
+            const command = scaffoldCommand(pm, framework);
+            const result = await runExecutable(command.executable, command.args, {
+                cwd: targetDir,
+                dryRun,
+                silent: true
+            });
+            if (!result.ok)
+                throw new Error(`${framework} scaffolding failed: ${result.stderr || result.stdout}`);
+            if (!dryRun) {
+                pkg = readPackageManifest(targetDir);
+                const expected = framework === 'vite' ? 'index.html' : 'src/app/page.tsx';
+                if (!pkg || !fileExists(path.join(targetDir, expected)))
+                    throw new Error(`${framework} scaffolding did not create a complete project; it may have been cancelled.`);
+            }
+        }
+        if (!pkg) {
+            // In a framework dry run the upstream command has only been displayed.
+            if (dryRun && (framework === 'vite' || framework === 'next'))
+                return;
+            pkg = {
+                name: projectName,
+                version: '0.1.0',
+                type: 'module',
+                scripts: { build: 'tsc', typecheck: 'tsc --noEmit' },
+                devDependencies: { '@types/node': '^22.8.0', typescript: '^5.6.3' }
+            };
+        }
+        const hadVitestScript = Object.values(pkg.scripts || {}).some((script) => typeof script === 'string' && /^vitest(?:\s|$)/.test(script));
+        addTestingDependencies(pkg, config.browser.playwright);
+        if (fileExists(path.join(targetDir, 'tsconfig.json'))) {
+            pkg.scripts.typecheck ??=
+                fresh && framework === 'next' ? 'next typegen && tsc --noEmit' : 'tsc --noEmit';
+            if (!pkg.dependencies?.typescript && !pkg.devDependencies.typescript)
+                pkg.devDependencies.typescript = '^5.6.3';
+        }
+        // Only scaffold application source and compiler settings for a fresh agnostic project.
+        if (fresh && framework === 'none') {
+            writeJsonFile(path.join(targetDir, 'tsconfig.json'), {
+                compilerOptions: {
+                    target: 'ES2022',
+                    module: 'NodeNext',
+                    moduleResolution: 'NodeNext',
+                    lib: ['ES2022', 'DOM'],
+                    strict: true,
+                    skipLibCheck: true,
+                    outDir: 'dist',
+                    rootDir: 'src'
+                },
+                include: ['src/**/*']
+            }, { dryRun, silent });
+            safeWriteFile(path.join(targetDir, 'src', 'index.ts'), `export function createApp() {\n  return { name: ${JSON.stringify(projectName)}, status: 'ready' };\n}\n`, { dryRun, silent });
+        }
+        writeJsonFile(pkgPath, pkg, { overwrite: true, dryRun, silent });
+        if (pm === 'pnpm')
+            safeWriteFile(path.join(targetDir, 'pnpm-workspace.yaml'), 'allowBuilds:\n  esbuild: true\n', { dryRun, silent });
+        setupTesting(ctx, hadVitestScript);
+        if (config.browser.playwright)
+            setupBrowserTesting(targetDir, { dryRun, silent });
+        if (config.docs.adr)
+            setupAdr(targetDir, { dryRun, silent });
+    }
+};
+//# sourceMappingURL=web.js.map

package/dist/presets/web.js.map

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

package/dist/utils/fs.d.ts

@@ -0,0 +1,13 @@
+export interface WriteFileOptions {
+    overwrite?: boolean;
+    dryRun?: boolean;
+    silent?: boolean;
+    mode?: number;
+}
+export declare function ensureDir(dirPath: string, dryRun?: boolean): void;
+export declare function fileExists(filePath: string): boolean;
+export declare function safeWriteFile(filePath: string, content: string, options?: WriteFileOptions): boolean;
+export declare function readTextFile(filePath: string): string | null;
+export declare function readJsonFile<T>(filePath: string): T | null;
+export declare function writeJsonFile(filePath: string, data: unknown, options?: WriteFileOptions): boolean;
+//# sourceMappingURL=fs.d.ts.map

package/dist/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,IAAI,CAQ/D;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAyBT;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG5D;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAQ1D;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAGT"}

package/dist/utils/fs.js

@@ -0,0 +1,60 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { logger } from './logger.js';
+export function ensureDir(dirPath, dryRun = false) {
+    if (dryRun) {
+        logger.dim(`[dry-run] Would create directory: ${dirPath}`);
+        return;
+    }
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}
+export function fileExists(filePath) {
+    return fs.existsSync(filePath);
+}
+export function safeWriteFile(filePath, content, options = {}) {
+    const { overwrite = false, dryRun = false, silent = false, mode } = options;
+    if (fileExists(filePath) && !overwrite) {
+        if (!silent) {
+            logger.dim(`Skipping existing file: ${path.basename(filePath)}`);
+        }
+        return false;
+    }
+    if (dryRun) {
+        logger.dim(`[dry-run] Would write file: ${filePath}`);
+        return true;
+    }
+    ensureDir(path.dirname(filePath), false);
+    fs.writeFileSync(filePath, content, { encoding: 'utf-8', mode });
+    if (mode !== undefined && process.platform !== 'win32') {
+        try {
+            fs.chmodSync(filePath, mode);
+        }
+        catch {
+            // ignore in environments that do not permit chmod
+        }
+    }
+    return true;
+}
+export function readTextFile(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    return fs.readFileSync(filePath, 'utf-8');
+}
+export function readJsonFile(filePath) {
+    const text = readTextFile(filePath);
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+export function writeJsonFile(filePath, data, options = {}) {
+    const content = JSON.stringify(data, null, 2) + '\n';
+    return safeWriteFile(filePath, content, options);
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AASrC,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,MAAM,GAAG,KAAK;IACvD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO;IACT,CAAC;IACD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,OAAe,EACf,UAA4B,EAAE;IAE9B,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAE5E,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;IACzC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,QAAgB;IAC9C,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,IAAa,EACb,UAA4B,EAAE;IAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACrD,OAAO,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,10 @@
+export declare const logger: {
+    info: (msg: string) => void;
+    success: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    dim: (msg: string) => void;
+    step: (step: number, total: number, msg: string) => void;
+    banner: (title: string, subtitle?: string) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;gBACL,MAAM;mBACH,MAAM;gBACT,MAAM;iBACL,MAAM;eACR,MAAM;iBACJ,MAAM,SAAS,MAAM,OAAO,MAAM;oBAG/B,MAAM,aAAa,MAAM;CAQ1C,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,20 @@
+import pc from 'picocolors';
+export const logger = {
+    info: (msg) => console.log(pc.cyan('ℹ ') + msg),
+    success: (msg) => console.log(pc.green('✓ ') + msg),
+    warn: (msg) => console.log(pc.yellow('⚠ ') + msg),
+    error: (msg) => console.error(pc.red('✖ ') + msg),
+    dim: (msg) => console.log(pc.dim(msg)),
+    step: (step, total, msg) => {
+        console.log(pc.bold(pc.magenta(`[${step}/${total}] `)) + pc.bold(msg));
+    },
+    banner: (title, subtitle) => {
+        console.log();
+        console.log(pc.bold(pc.cyan(title)));
+        if (subtitle) {
+            console.log(pc.dim(subtitle));
+        }
+        console.log();
+    }
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;IACvD,OAAO,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;IAC3D,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;IACzD,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;IACzD,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,EAAE,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW,EAAE,EAAE;QACjD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,EAAE,CAAC,KAAa,EAAE,QAAiB,EAAE,EAAE;QAC3C,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;CACF,CAAC"}

package/dist/utils/shell.d.ts

@@ -0,0 +1,17 @@
+export interface ShellResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    ok: boolean;
+}
+export interface RunOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    dryRun?: boolean;
+    silent?: boolean;
+    timeout?: number;
+}
+/** Execute a program with literal arguments. No shell expansion or interpolation. */
+export declare function runExecutable(executable: string, args?: string[], options?: RunOptions): Promise<ShellResult>;
+export declare function commandExists(binName: string): Promise<boolean>;
+//# sourceMappingURL=shell.d.ts.map

package/dist/utils/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/utils/shell.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4BD,qFAAqF;AACrF,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,WAAW,CAAC,CAmCtB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBrE"}