@horiastanxd/claude-init 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Horia Stan
+
+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,223 @@
+<div align="center">
+
+# claude-init
+
+**One command generates the AI context files for every coding assistant - from one repo scan.**
+
+`CLAUDE.md` · `AGENTS.md` · Cursor · Windsurf · Cline · Copilot · `GEMINI.md` · Aider · Junie · Warp
+
+```bash
+npx @horiastanxd/claude-init
+```
+
+[![npm version](https://img.shields.io/npm/v/@horiastanxd/claude-init.svg?color=cb3837&logo=npm)](https://www.npmjs.com/package/@horiastanxd/claude-init)
+[![CI](https://github.com/horiastanxd/claude-init/actions/workflows/ci.yml/badge.svg)](https://github.com/horiastanxd/claude-init/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/@horiastanxd/claude-init.svg?color=blue)](./LICENSE)
+[![node](https://img.shields.io/node/v/@horiastanxd/claude-init.svg?color=339933&logo=node.js)](https://nodejs.org)
+
+</div>
+
+<div align="center">
+
+![claude-init demo](./assets/demo.gif)
+
+</div>
+
+---
+
+## Why
+
+Every AI coding tool wants a file describing your project - and they all use a
+different name and format. Keeping ten of them in sync by hand is busywork, and the
+moment your stack changes they go stale.
+
+`claude-init` scans your repo once - stack, scripts, structure, env vars, conventions,
+git - and writes all of them in seconds. **No API key, no network, 100% local.**
+
+```bash
+$ npx @horiastanxd/claude-init
+✔ Analyzed my-app (TypeScript, Next.js)
+  + CLAUDE.md
+  + AGENTS.md
+  + .cursor/rules/project.mdc
+  + .windsurf/rules/project.md
+  + .clinerules/project.md
+  + .github/copilot-instructions.md
+  + GEMINI.md
+  + CONVENTIONS.md
+  + .junie/guidelines.md
+  + WARP.md
+
+Done. 10 file(s) generated.
+```
+
+## Supported tools
+
+| Target (`-t`) | File written | Read by |
+| --- | --- | --- |
+| `claude` | `CLAUDE.md` | Claude Code |
+| `agents` | `AGENTS.md` | OpenAI Codex, Jules, Amp, Zed, Devin, RooCode, Factory, +20 agents |
+| `cursor` | `.cursor/rules/project.mdc` | Cursor (modern `.mdc` rules) |
+| `windsurf` | `.windsurf/rules/project.md` | Windsurf / Codeium |
+| `cline` | `.clinerules/project.md` | Cline, Roo Code |
+| `copilot` | `.github/copilot-instructions.md` | GitHub Copilot |
+| `gemini` | `GEMINI.md` | Gemini CLI |
+| `aider` | `CONVENTIONS.md` | Aider |
+| `junie` | `.junie/guidelines.md` | JetBrains Junie |
+| `warp` | `WARP.md` | Warp terminal |
+
+> [`AGENTS.md`](https://agents.md) is becoming the shared standard - one file read by
+> a growing list of agents. `claude-init` generates it alongside each tool's native
+> format, so you are covered both ways.
+
+## Usage
+
+```bash
+npx @horiastanxd/claude-init                      # generate everything in the current repo
+npx @horiastanxd/claude-init ./path/to/repo       # analyze a different directory
+npx @horiastanxd/claude-init -t claude,cursor     # only specific tools
+npx @horiastanxd/claude-init --overwrite          # refresh files that already exist
+npx @horiastanxd/claude-init --dry-run            # print the analysis as JSON, write nothing
+npx @horiastanxd/claude-init list                 # show all targets and their paths
+```
+
+By default existing files are left untouched - re-run with `--overwrite` to refresh
+them after your stack changes.
+
+```
+claude-init [generate] [dir]   analyze a repo and write context files (default)
+claude-init check [dir]        verify files are up to date (exit 1 on drift)
+claude-init list               list supported targets
+claude-init mcp                run as an MCP server over stdio
+
+Options:
+  -t, --targets <list>   comma-separated target ids, or "all"   (default: all)
+  -o, --output <dir>     output directory                        (default: .)
+  --overwrite            overwrite existing files
+  --dry-run              print the analysis as JSON, write nothing
+```
+
+## Keep context files fresh
+
+`claude-init check` regenerates in memory and compares against disk, exiting non-zero
+on drift. Wire it into CI or a pre-commit hook so your context never rots.
+
+**pre-commit** (`.git/hooks/pre-commit` or [pre-commit](https://pre-commit.com)):
+
+```bash
+npx @horiastanxd/claude-init check || {
+  echo "AI context files are stale - run: npx @horiastanxd/claude-init --overwrite"
+  exit 1
+}
+```
+
+**GitHub Actions:**
+
+```yaml
+- run: npx @horiastanxd/claude-init check
+```
+
+## Example output
+
+<details>
+<summary><code>CLAUDE.md</code> generated for a Next.js + Prisma app</summary>
+
+```markdown
+# my-app
+
+A demo application.
+
+## Stack
+- Language: TypeScript
+- Framework: Next.js
+- Runtime: Node.js
+- Package manager: pnpm
+- Database: Prisma ORM
+- Testing: Vitest
+
+## Commands
+```bash
+pnpm install   # install
+pnpm run dev   # dev
+pnpm run test  # test
+```
+
+## Code conventions
+- TypeScript strict mode is enabled - keep full type safety, avoid `any`.
+- Linter: ESLint. Run it before committing.
+- Formatter: Prettier. Do not hand-format against it.
+
+## Environment variables
+Copy `.env.example` to `.env` and set:
+- `DATABASE_URL` (**required**) - Postgres connection string
+```
+
+</details>
+
+## MCP server
+
+`claude-init` also runs as a [Model Context Protocol](https://modelcontextprotocol.io)
+server, so an agent can analyze a repo and write the context files itself.
+
+```bash
+# Claude Code
+claude mcp add claude-init -- npx @horiastanxd/claude-init --mcp
+```
+
+Tools exposed: `analyze_project`, `generate_context_files`, `check_context_files`.
+
+## What gets detected
+
+- **Stack** - language, framework, runtime, package manager, database, test runner, build tool
+- **Commands** - install / dev / build / test / lint / format, plus other scripts
+- **Structure** - a trimmed file tree, entry points, config files
+- **Conventions** - strict mode, linter, formatter, import style, commit convention
+- **Env vars** - parsed from `.env.example`, with inline comments as descriptions
+- **Git** - default branch, remote, top authors, frequently changed files
+
+Languages: JS/TS (npm, pnpm, yarn, bun), Python (pip, uv, poetry), Rust (cargo),
+Go (modules), plus partial detection for Java, Ruby, and PHP.
+
+## Use as a library
+
+```ts
+import { analyzeProject, generateClaudeMd, buildFiles } from 'claude-init';
+
+const analysis = await analyzeProject(process.cwd());
+const md = generateClaudeMd(analysis);
+
+// or render every target in memory
+for (const file of buildFiles(analysis)) {
+  console.log(file.relPath, file.content.length);
+}
+```
+
+## Development
+
+```bash
+npm install
+npm run dev -- --dry-run   # run from source
+npm test
+npm run build
+```
+
+Contributions welcome - adding a new tool is usually a single entry in
+[`src/generators/registry.ts`](./src/generators/registry.ts). See
+[CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## Roadmap
+
+- More tools (Zed dedicated rules, Continue, Kilo Code, Trae)
+- Monorepo-aware generation (per-package context files)
+- Optional LLM pass to enrich descriptions (opt-in, off by default)
+
+Ideas and PRs welcome.
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=horiastanxd/claude-init&type=Date)](https://star-history.com/#horiastanxd/claude-init&Date)
+
+## License
+
+[MIT](./LICENSE)
+

package/dist/analyzer/code-patterns.d.ts

@@ -0,0 +1,2 @@
+import type { CodePatterns } from '../types.js';
+export declare function detectCodePatterns(projectDir: string): Promise<CodePatterns>;

package/dist/analyzer/code-patterns.js

@@ -0,0 +1,71 @@
+import { join } from 'node:path';
+import { pathExists, readText, readJson } from '../utils.js';
+export async function detectCodePatterns(projectDir) {
+    const [tsconfig, linter, formatter, commitConvention] = await Promise.all([
+        detectStrict(projectDir),
+        detectLinter(projectDir),
+        detectFormatter(projectDir),
+        detectCommitConvention(projectDir),
+    ]);
+    return {
+        strict: tsconfig.strict,
+        linter,
+        formatter,
+        commitConvention,
+        importStyle: tsconfig.importStyle,
+    };
+}
+async function detectStrict(dir) {
+    const raw = await readText(join(dir, 'tsconfig.json'));
+    if (raw === null)
+        return { strict: false, importStyle: null };
+    return {
+        strict: /"strict"\s*:\s*true/.test(raw),
+        importStyle: /"(baseUrl|paths)"\s*:/.test(raw) ? 'absolute (path aliases)' : 'relative',
+    };
+}
+async function detectLinter(dir) {
+    const eslint = [
+        '.eslintrc',
+        '.eslintrc.json',
+        '.eslintrc.js',
+        '.eslintrc.cjs',
+        'eslint.config.js',
+        'eslint.config.mjs',
+    ];
+    for (const f of eslint) {
+        if (await pathExists(join(dir, f)))
+            return 'ESLint';
+    }
+    if (await pathExists(join(dir, 'biome.json')))
+        return 'Biome';
+    if (await pathExists(join(dir, 'ruff.toml')))
+        return 'Ruff';
+    if (await pathExists(join(dir, '.golangci.yml')))
+        return 'golangci-lint';
+    return null;
+}
+async function detectFormatter(dir) {
+    const prettier = ['.prettierrc', '.prettierrc.json', '.prettierrc.js', 'prettier.config.js'];
+    for (const f of prettier) {
+        if (await pathExists(join(dir, f)))
+            return 'Prettier';
+    }
+    if (await pathExists(join(dir, 'biome.json')))
+        return 'Biome';
+    const pkg = await readJson(join(dir, 'package.json'));
+    if (pkg?.prettier)
+        return 'Prettier';
+    if (pkg?.devDependencies?.['prettier'])
+        return 'Prettier';
+    return null;
+}
+async function detectCommitConvention(dir) {
+    const markers = ['commitlint.config.js', '.commitlintrc', '.commitlintrc.json', '.czrc'];
+    for (const f of markers) {
+        if (await pathExists(join(dir, f)))
+            return 'Conventional Commits';
+    }
+    return null;
+}
+//# sourceMappingURL=code-patterns.js.map

package/dist/analyzer/code-patterns.js.map

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

package/dist/analyzer/commands.d.ts

@@ -0,0 +1,2 @@
+import type { ProjectCommands } from '../types.js';
+export declare function detectCommands(projectDir: string): Promise<ProjectCommands>;

package/dist/analyzer/commands.js

@@ -0,0 +1,86 @@
+import { join } from 'node:path';
+import { pathExists, readJson, detectPackageManager } from '../utils.js';
+const EMPTY = {
+    install: null,
+    dev: null,
+    build: null,
+    test: null,
+    lint: null,
+    format: null,
+    extra: {},
+};
+const KNOWN_SCRIPTS = new Set([
+    'dev',
+    'start',
+    'build',
+    'test',
+    'lint',
+    'format',
+    'fmt',
+    'prepare',
+    'postinstall',
+    'prepublishonly',
+]);
+export async function detectCommands(projectDir) {
+    if (await pathExists(join(projectDir, 'package.json'))) {
+        return fromPackageJson(projectDir);
+    }
+    if (await pathExists(join(projectDir, 'Cargo.toml'))) {
+        return {
+            install: null,
+            dev: 'cargo run',
+            build: 'cargo build --release',
+            test: 'cargo test',
+            lint: 'cargo clippy',
+            format: 'cargo fmt',
+            extra: {},
+        };
+    }
+    if (await pathExists(join(projectDir, 'pyproject.toml'))) {
+        const hasUv = await pathExists(join(projectDir, 'uv.lock'));
+        return {
+            install: hasUv ? 'uv sync' : 'pip install -e ".[dev]"',
+            dev: null,
+            build: null,
+            test: 'pytest',
+            lint: 'ruff check .',
+            format: 'ruff format .',
+            extra: {},
+        };
+    }
+    if (await pathExists(join(projectDir, 'go.mod'))) {
+        return {
+            install: 'go mod download',
+            dev: 'go run .',
+            build: 'go build ./...',
+            test: 'go test ./...',
+            lint: 'golangci-lint run',
+            format: 'go fmt ./...',
+            extra: {},
+        };
+    }
+    return { ...EMPTY };
+}
+async function fromPackageJson(dir) {
+    const pkg = await readJson(join(dir, 'package.json'));
+    const scripts = pkg?.scripts ?? {};
+    const pm = await detectPackageManager(dir);
+    const run = (script) => `${pm} run ${script}`;
+    const has = (script) => typeof scripts[script] === 'string';
+    const formatScript = has('format') ? 'format' : has('fmt') ? 'fmt' : null;
+    const extra = {};
+    for (const key of Object.keys(scripts)) {
+        if (!KNOWN_SCRIPTS.has(key.toLowerCase()))
+            extra[key] = run(key);
+    }
+    return {
+        install: pm === 'npm' ? 'npm install' : `${pm} install`,
+        dev: has('dev') ? run('dev') : has('start') ? run('start') : null,
+        build: has('build') ? run('build') : null,
+        test: has('test') ? run('test') : null,
+        lint: has('lint') ? run('lint') : null,
+        format: formatScript ? run(formatScript) : null,
+        extra,
+    };
+}
+//# sourceMappingURL=commands.js.map

package/dist/analyzer/commands.js.map

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

package/dist/analyzer/env-vars.d.ts

@@ -0,0 +1,3 @@
+import type { EnvVar } from '../types.js';
+export declare function detectEnvVars(projectDir: string): Promise<EnvVar[]>;
+export declare function parseEnvFile(content: string): EnvVar[];

package/dist/analyzer/env-vars.js

@@ -0,0 +1,42 @@
+import { join } from 'node:path';
+import { readText } from '../utils.js';
+const CANDIDATES = ['.env.example', '.env.sample', '.env.template', '.env.local.example'];
+export async function detectEnvVars(projectDir) {
+    for (const candidate of CANDIDATES) {
+        const content = await readText(join(projectDir, candidate));
+        if (content !== null)
+            return parseEnvFile(content);
+    }
+    return [];
+}
+export function parseEnvFile(content) {
+    const vars = [];
+    let pendingComment = '';
+    for (const rawLine of content.split('\n')) {
+        const line = rawLine.trim();
+        if (!line) {
+            pendingComment = '';
+            continue;
+        }
+        if (line.startsWith('#')) {
+            pendingComment = line.replace(/^#+\s*/, '');
+            continue;
+        }
+        const eqIdx = line.indexOf('=');
+        if (eqIdx === -1)
+            continue;
+        const name = line.slice(0, eqIdx).trim().replace(/^export\s+/, '');
+        if (!name)
+            continue;
+        const value = line.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, '');
+        vars.push({
+            name,
+            example: value || null,
+            required: value === '',
+            description: pendingComment,
+        });
+        pendingComment = '';
+    }
+    return vars;
+}
+//# sourceMappingURL=env-vars.js.map

package/dist/analyzer/env-vars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-vars.js","sourceRoot":"","sources":["../../src/analyzer/env-vars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,MAAM,UAAU,GAAG,CAAC,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,CAAC,CAAC;AAE1F,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB;IACpD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;QAC5D,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,cAAc,GAAG,EAAE,CAAC;IAExB,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAE5B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,cAAc,GAAG,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC5C,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAS;QAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAEvE,IAAI,CAAC,IAAI,CAAC;YACR,IAAI;YACJ,OAAO,EAAE,KAAK,IAAI,IAAI;YACtB,QAAQ,EAAE,KAAK,KAAK,EAAE;YACtB,WAAW,EAAE,cAAc;SAC5B,CAAC,CAAC;QACH,cAAc,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/analyzer/git-history.d.ts

@@ -0,0 +1,2 @@
+import type { GitInfo } from '../types.js';
+export declare function analyzeGit(projectDir: string): Promise<GitInfo>;

package/dist/analyzer/git-history.js

@@ -0,0 +1,41 @@
+import { simpleGit } from 'simple-git';
+const NONE = {
+    hasGit: false,
+    remoteName: null,
+    defaultBranch: null,
+    topAuthors: [],
+    hotFiles: [],
+};
+export async function analyzeGit(projectDir) {
+    const git = simpleGit(projectDir);
+    const isRepo = await git.checkIsRepo().catch(() => false);
+    if (!isRepo)
+        return { ...NONE };
+    const [remotes, branch, authorLog, fileLog] = await Promise.all([
+        git.getRemotes(true).catch(() => []),
+        git.revparse(['--abbrev-ref', 'HEAD']).catch(() => 'main'),
+        git.raw(['log', '--format=%an', '--no-merges', '-200']).catch(() => ''),
+        git.raw(['log', '--name-only', '--format=', '--no-merges', '-500']).catch(() => ''),
+    ]);
+    return {
+        hasGit: true,
+        remoteName: remotes[0]?.refs?.fetch ?? remotes[0]?.name ?? null,
+        defaultBranch: branch.trim() || 'main',
+        topAuthors: topCounts(authorLog, 3),
+        hotFiles: topCounts(fileLog, 5),
+    };
+}
+function topCounts(log, limit) {
+    const counts = {};
+    for (const line of log.split('\n')) {
+        const key = line.trim();
+        if (!key)
+            continue;
+        counts[key] = (counts[key] ?? 0) + 1;
+    }
+    return Object.entries(counts)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, limit)
+        .map(([k]) => k);
+}
+//# sourceMappingURL=git-history.js.map

package/dist/analyzer/git-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-history.js","sourceRoot":"","sources":["../../src/analyzer/git-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,MAAM,IAAI,GAAY;IACpB,MAAM,EAAE,KAAK;IACb,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE,EAAE;IACd,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB;IACjD,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAElC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IAEhC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9D,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;QAC1D,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;KACpF,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,IAAI;QAC/D,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM;QACtC,UAAU,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;QACnC,QAAQ,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,GAAW,EAAE,KAAa;IAC3C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;SAC7B,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC"}

package/dist/analyzer/index.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectAnalysis } from '../types.js';
+export declare function analyzeProject(projectDir: string): Promise<ProjectAnalysis>;
+export type { ProjectAnalysis } from '../types.js';

package/dist/analyzer/index.js

@@ -0,0 +1,44 @@
+import { basename, join } from 'node:path';
+import { readJson } from '../utils.js';
+import { detectTechStack } from './tech-stack.js';
+import { analyzeGit } from './git-history.js';
+import { analyzeStructure } from './project-structure.js';
+import { detectCommands } from './commands.js';
+import { detectEnvVars } from './env-vars.js';
+import { detectCodePatterns } from './code-patterns.js';
+import { TARGETS } from '../generators/registry.js';
+/**
+ * Top-level path segments of every file we generate. Excluded from the structure
+ * tree so that running `generate` does not make a later `check` report drift.
+ */
+const GENERATED_SEGMENTS = [
+    ...new Set(TARGETS.flatMap((t) => t.files.map((f) => f.path.split(/[\\/]/)[0]))),
+];
+export async function analyzeProject(projectDir) {
+    const [techStack, gitInfo, structure, commands, envVars, codePatterns, pkg] = await Promise.all([
+        detectTechStack(projectDir),
+        analyzeGit(projectDir),
+        analyzeStructure(projectDir, GENERATED_SEGMENTS),
+        detectCommands(projectDir),
+        detectEnvVars(projectDir),
+        detectCodePatterns(projectDir),
+        readJson(join(projectDir, 'package.json')),
+    ]);
+    return {
+        name: pkg?.name || basename(projectDir) || 'project',
+        description: pkg?.description ?? '',
+        techStack,
+        structure,
+        commands,
+        tests: {
+            framework: techStack.testing,
+            command: commands.test,
+            coverage: Boolean(pkg?.scripts && ('coverage' in pkg.scripts || 'test:coverage' in pkg.scripts)),
+            testDir: structure.testDir,
+        },
+        envVars,
+        codePatterns,
+        gitInfo,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/analyzer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analyzer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAGpD;;;GAGG;AACH,MAAM,kBAAkB,GAAa;IACnC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;CAClF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9F,eAAe,CAAC,UAAU,CAAC;QAC3B,UAAU,CAAC,UAAU,CAAC;QACtB,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,CAAC;QAChD,cAAc,CAAC,UAAU,CAAC;QAC1B,aAAa,CAAC,UAAU,CAAC;QACzB,kBAAkB,CAAC,UAAU,CAAC;QAC9B,QAAQ,CACN,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CACjC;KACF,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,SAAS;QACpD,WAAW,EAAE,GAAG,EAAE,WAAW,IAAI,EAAE;QACnC,SAAS;QACT,SAAS;QACT,QAAQ;QACR,KAAK,EAAE;YACL,SAAS,EAAE,SAAS,CAAC,OAAO;YAC5B,OAAO,EAAE,QAAQ,CAAC,IAAI;YACtB,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,OAAO,IAAI,eAAe,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;YAChG,OAAO,EAAE,SAAS,CAAC,OAAO;SAC3B;QACD,OAAO;QACP,YAAY;QACZ,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/analyzer/project-structure.d.ts

@@ -0,0 +1,2 @@
+import type { ProjectStructure } from '../types.js';
+export declare function analyzeStructure(projectDir: string, extraIgnore?: Iterable<string>): Promise<ProjectStructure>;