@planu/cli 1.12.0 → 1.13.0

package/dist/engine/hook-generator/stack-hook-templates.js

@@ -0,0 +1,105 @@
+// engine/hook-generator/stack-hook-templates.ts — Git hook templates per stack (SPEC-416)
+// ---------------------------------------------------------------------------
+// Marker helpers — used by hook-merger for idempotent injection
+// ---------------------------------------------------------------------------
+export function markerStart(id) {
+    return `# <!-- planu:generated:${id} -->`;
+}
+export function markerEnd(id) {
+    return `# <!-- /planu:generated:${id} -->`;
+}
+// ---------------------------------------------------------------------------
+// Templates
+// ---------------------------------------------------------------------------
+export const STACK_HOOK_TEMPLATES = {
+    typescript: [
+        {
+            id: 'typescript-typecheck',
+            phase: 'pre-commit',
+            stack: 'typescript',
+            content: 'pnpm typecheck || exit 1',
+            description: 'TypeScript type checking',
+        },
+    ],
+    eslint: [
+        {
+            id: 'eslint-fix',
+            phase: 'pre-commit',
+            stack: 'eslint',
+            content: 'pnpm lint --fix || exit 1',
+            description: 'ESLint auto-fix',
+        },
+    ],
+    prettier: [
+        {
+            id: 'prettier-format',
+            phase: 'pre-commit',
+            stack: 'prettier',
+            content: 'pnpm format || exit 1',
+            description: 'Prettier formatting',
+        },
+    ],
+    vitest: [
+        {
+            id: 'vitest-coverage',
+            phase: 'pre-push',
+            stack: 'vitest',
+            content: 'pnpm test:coverage || exit 1',
+            description: 'Vitest coverage threshold check',
+        },
+    ],
+    jest: [
+        {
+            id: 'jest-coverage',
+            phase: 'pre-push',
+            stack: 'jest',
+            content: 'pnpm test --coverage || exit 1',
+            description: 'Jest coverage check',
+        },
+    ],
+    python: [
+        {
+            id: 'python-ruff',
+            phase: 'pre-commit',
+            stack: 'python',
+            content: 'ruff check --fix . || exit 1',
+            description: 'Python ruff linting',
+        },
+    ],
+    go: [
+        {
+            id: 'go-vet',
+            phase: 'pre-commit',
+            stack: 'go',
+            content: 'go vet ./... || exit 1',
+            description: 'Go vet check',
+        },
+    ],
+    commitlint: [
+        {
+            id: 'commitlint',
+            phase: 'commit-msg',
+            stack: 'commitlint',
+            content: 'npx --no -- commitlint --edit "$1" || exit 1',
+            description: 'Conventional commits validation',
+        },
+    ],
+};
+// ---------------------------------------------------------------------------
+// Public helper
+// ---------------------------------------------------------------------------
+/**
+ * Returns all HookSection entries matching the requested stack tokens.
+ * Unknown tokens are silently skipped.
+ */
+export function getHookSectionsForStack(stack) {
+    const sections = [];
+    for (const token of stack) {
+        const templates = STACK_HOOK_TEMPLATES[token];
+        if (templates !== undefined) {
+            sections.push(...templates);
+        }
+    }
+    return sections;
+}
+//# sourceMappingURL=stack-hook-templates.js.map

package/dist/engine/hook-generator/stack-hook-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-hook-templates.js","sourceRoot":"","sources":["../../../src/engine/hook-generator/stack-hook-templates.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAI1F,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAE9E,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,OAAO,0BAA0B,EAAE,MAAM,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,2BAA2B,EAAE,MAAM,CAAC;AAC7C,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAAkC;IACjE,UAAU,EAAE;QACV;YACE,EAAE,EAAE,sBAAsB;YAC1B,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,0BAA0B;YACnC,WAAW,EAAE,0BAA0B;SACxC;KACF;IACD,MAAM,EAAE;QACN;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,2BAA2B;YACpC,WAAW,EAAE,iBAAiB;SAC/B;KACF;IACD,QAAQ,EAAE;QACR;YACE,EAAE,EAAE,iBAAiB;YACrB,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,uBAAuB;YAChC,WAAW,EAAE,qBAAqB;SACnC;KACF;IACD,MAAM,EAAE;QACN;YACE,EAAE,EAAE,iBAAiB;YACrB,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,8BAA8B;YACvC,WAAW,EAAE,iCAAiC;SAC/C;KACF;IACD,IAAI,EAAE;QACJ;YACE,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,UAAU;YACjB,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,gCAAgC;YACzC,WAAW,EAAE,qBAAqB;SACnC;KACF;IACD,MAAM,EAAE;QACN;YACE,EAAE,EAAE,aAAa;YACjB,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,8BAA8B;YACvC,WAAW,EAAE,qBAAqB;SACnC;KACF;IACD,EAAE,EAAE;QACF;YACE,EAAE,EAAE,QAAQ;YACZ,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,wBAAwB;YACjC,WAAW,EAAE,cAAc;SAC5B;KACF;IACD,UAAU,EAAE;QACV;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,8CAA8C;YACvD,WAAW,EAAE,iCAAiC;SAC/C;KACF;CACF,CAAC;AAEF,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAe;IACrD,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/engine/project-dna/ai-tool-detector.d.ts

@@ -0,0 +1,12 @@
+import type { AIToolId, AIToolProfile } from '../../types/index.js';
+/**
+ * Detects which AI tool is active by checking detection files in priority order.
+ * Returns 'unknown' if no known AI tool is detected.
+ */
+export declare function detectAITool(projectPath: string): Promise<AIToolId>;
+/**
+ * Loads the full AI tool profile from the registry for a given tool ID.
+ * Returns an 'unknown' profile if the tool ID is not found.
+ */
+export declare function loadAIToolProfile(toolId: AIToolId): Promise<AIToolProfile>;
+//# sourceMappingURL=ai-tool-detector.d.ts.map

package/dist/engine/project-dna/ai-tool-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tool-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/project-dna/ai-tool-detector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAqFpE;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAazE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,CAoBhF"}

package/dist/engine/project-dna/ai-tool-detector.js

@@ -0,0 +1,103 @@
+// Planu — project-dna/ai-tool-detector.ts
+// Detects which AI tool is active in a project by checking detection files.
+import { access, readFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const REGISTRY_PATH = join(dirname(fileURLToPath(import.meta.url)), '../../config/ai-tool-registry.json');
+let cachedRegistry = null;
+async function loadRegistry() {
+    if (cachedRegistry !== null) {
+        return cachedRegistry;
+    }
+    const raw = await readFile(REGISTRY_PATH, 'utf-8');
+    cachedRegistry = JSON.parse(raw);
+    return cachedRegistry;
+}
+// ---------------------------------------------------------------------------
+// Detection order (priority: highest first)
+// ---------------------------------------------------------------------------
+const DETECTION_ORDER = [
+    'claude',
+    'cursor',
+    'windsurf',
+    'gemini',
+    'kiro',
+    'cline',
+    'copilot',
+    'aider',
+];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function pathExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function anyDetectionFileExists(projectPath, detectionFiles) {
+    for (const f of detectionFiles) {
+        if (await pathExists(join(projectPath, f))) {
+            return true;
+        }
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Detects which AI tool is active by checking detection files in priority order.
+ * Returns 'unknown' if no known AI tool is detected.
+ */
+export async function detectAITool(projectPath) {
+    const registry = await loadRegistry();
+    for (const toolId of DETECTION_ORDER) {
+        const entry = registry.tools[toolId];
+        if (entry === undefined) {
+            continue;
+        }
+        if (await anyDetectionFileExists(projectPath, entry.detectionFiles)) {
+            return toolId;
+        }
+    }
+    return 'unknown';
+}
+/**
+ * Loads the full AI tool profile from the registry for a given tool ID.
+ * Returns an 'unknown' profile if the tool ID is not found.
+ */
+export async function loadAIToolProfile(toolId) {
+    if (toolId === 'unknown') {
+        return buildUnknownProfile();
+    }
+    const registry = await loadRegistry();
+    const entry = registry.tools[toolId];
+    if (entry === undefined) {
+        return buildUnknownProfile();
+    }
+    return {
+        id: toolId,
+        name: entry.name,
+        detectionFiles: entry.detectionFiles,
+        rulesDir: entry.rulesDir,
+        rulesFile: entry.rulesFile,
+        rulesFormat: entry.rulesFormat,
+        docsUrl: entry.docsUrl,
+        configFile: entry.configFile,
+        frontmatterRequired: entry.frontmatterRequired,
+    };
+}
+function buildUnknownProfile() {
+    return {
+        id: 'unknown',
+        name: 'Unknown AI Tool',
+        detectionFiles: [],
+        rulesFormat: 'markdown',
+        docsUrl: '',
+    };
+}
+//# sourceMappingURL=ai-tool-detector.js.map

package/dist/engine/project-dna/ai-tool-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tool-detector.js","sourceRoot":"","sources":["../../../src/engine/project-dna/ai-tool-detector.ts"],"names":[],"mappings":"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"}

package/dist/engine/project-dna/rules-generator.d.ts

@@ -0,0 +1,18 @@
+import type { ProjectDNA, AIToolProfile } from '../../types/index.js';
+/**
+ * Generates a rules file for a given stack token formatted for the AI tool.
+ * Returns null if no rule template exists for the given stack token.
+ */
+export declare function generateRulesForStack(dna: ProjectDNA, stackToken: string): Promise<{
+    filePath: string;
+    content: string;
+} | null>;
+/**
+ * Formats rule content according to the AI tool's expected format.
+ */
+export declare function formatRuleForAI(ruleContent: string, profile: AIToolProfile, stackToken: string): Promise<string>;
+/**
+ * Returns the list of stack tokens that have rule templates available.
+ */
+export declare function getSupportedStackTokens(): string[];
+//# sourceMappingURL=rules-generator.d.ts.map

package/dist/engine/project-dna/rules-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/project-dna/rules-generator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAoJtE;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,UAAU,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAevD;AAED;;GAEG;AAEH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAwBD;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAElD"}

package/dist/engine/project-dna/rules-generator.js

@@ -0,0 +1,193 @@
+// ---------------------------------------------------------------------------
+// Rule templates (hardcoded — project conventions, not fetched)
+// ---------------------------------------------------------------------------
+const RULE_TEMPLATES = {
+    supabase: `# Supabase Patterns
+- Always use { data, error } destructuring — never .then()
+- Check error before using data: if (error) throw error
+- Never expose service role key in client code
+- Use RLS policies as primary auth layer
+- Prefer supabase.auth.getUser() over getSession() for server-side`,
+    typescript: `# TypeScript Strict Patterns
+- Use import type for type-only imports
+- Prefer unknown over any
+- Always declare return types explicitly
+- Use noUncheckedIndexedAccess — array[i] is T | undefined`,
+    nextjs: `# Next.js App Router Patterns
+- Prefer Server Components by default, Client Components only when needed
+- Use server actions for mutations (not API routes)
+- Call revalidatePath() after mutations
+- Never use useEffect for data fetching — use async Server Components`,
+    vitest: `# Vitest Testing Patterns
+- Use vi.mock() at module level, not inside tests
+- Use vi.clearAllMocks() in beforeEach
+- Prefer mockReturnValue for sync, mockResolvedValue for async
+- Group with describe, test cases with it()`,
+    react: `# React Patterns
+- Prefer functional components with hooks over class components
+- Use React.memo() for expensive pure components
+- Avoid prop drilling — use Context or state management
+- Keep components small and single-responsibility`,
+    prisma: `# Prisma Patterns
+- Always handle Prisma errors — catch PrismaClientKnownRequestError
+- Use transactions for multi-step writes
+- Never expose raw database IDs — use UUIDs or slugs
+- Run prisma generate after schema changes`,
+    zod: `# Zod Validation Patterns
+- Parse at boundaries — never trust external input without validation
+- Use z.infer<typeof schema> for derived types
+- Prefer .safeParse() over .parse() for user input
+- Add .describe() on all fields used in LLM/MCP contexts`,
+    stripe: `# Stripe Patterns
+- Never trust client-side amount — always verify on server
+- Use webhook events for fulfillment — not redirect callbacks
+- Store Stripe customer IDs, never raw card data
+- Test with test mode keys, never live keys in development`,
+    jest: `# Jest Testing Patterns
+- Use jest.mock() at module level
+- Use beforeEach/afterEach for setup and cleanup
+- Prefer mockResolvedValue for async mocks
+- Use describe blocks to group related tests`,
+    fastapi: `# FastAPI Patterns
+- Use Pydantic models for request/response validation
+- Prefer async endpoints for I/O bound operations
+- Use dependency injection for database sessions
+- Add response_model to all endpoints`,
+    django: `# Django Patterns
+- Use select_related/prefetch_related to avoid N+1 queries
+- Keep views thin — move logic to services or managers
+- Use Django forms or serializers for input validation
+- Always use CSRF protection for state-changing endpoints`,
+    flask: `# Flask Patterns
+- Use application factory pattern for testability
+- Use blueprints to organize routes by domain
+- Validate all input with marshmallow or wtforms
+- Use Flask-SQLAlchemy for ORM integration`,
+    gin: `# Gin (Go) Patterns
+- Use context cancellation — respect ctx.Done()
+- Bind request data with ShouldBind — check errors
+- Use middleware for cross-cutting concerns (auth, logging)
+- Return consistent error responses with gin.H{}`,
+    axum: `# Axum (Rust) Patterns
+- Use extractors for request parsing — never raw body
+- Return impl IntoResponse for handler flexibility
+- Use AppState for shared dependencies
+- Propagate errors with ? and map_err`,
+    tailwind: `# Tailwind CSS Patterns
+- Use semantic class groupings — layout, spacing, typography
+- Extract repeated patterns to components, not @apply
+- Use responsive prefixes consistently (sm/md/lg/xl)
+- Avoid arbitrary values — prefer design tokens`,
+};
+// ---------------------------------------------------------------------------
+// Glob patterns by stack token
+// ---------------------------------------------------------------------------
+const GLOB_PATTERNS = {
+    supabase: ['**/*.ts', '**/*.tsx'],
+    typescript: ['**/*.ts', '**/*.tsx'],
+    nextjs: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
+    vitest: ['**/*.test.ts', '**/*.spec.ts', '**/*.test.tsx'],
+    react: ['**/*.tsx', '**/*.jsx'],
+    prisma: ['prisma/**', '**/*.ts'],
+    zod: ['**/*.ts', '**/*.tsx'],
+    stripe: ['**/*.ts', '**/*.tsx'],
+    jest: ['**/*.test.ts', '**/*.test.js', '**/*.spec.ts'],
+    fastapi: ['**/*.py'],
+    django: ['**/*.py'],
+    flask: ['**/*.py'],
+    gin: ['**/*.go'],
+    axum: ['**/*.rs'],
+    tailwind: ['**/*.tsx', '**/*.jsx', '**/*.html'],
+};
+// ---------------------------------------------------------------------------
+// Format helpers
+// ---------------------------------------------------------------------------
+function buildMdcFrontmatter(stackToken, globs) {
+    const globsJson = JSON.stringify(globs);
+    const description = `${capitalize(stackToken)} patterns for this project`;
+    return `---\ndescription: ${description}\nalwaysApply: false\nglobs: ${globsJson}\n---\n\n`;
+}
+function capitalize(s) {
+    if (s.length === 0) {
+        return s;
+    }
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function buildAppendMarkers(stackToken, content) {
+    const marker = `<!-- planu:${stackToken} -->`;
+    const endMarker = `<!-- /planu:${stackToken} -->`;
+    return `\n${marker}\n${content}\n${endMarker}\n`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Generates a rules file for a given stack token formatted for the AI tool.
+ * Returns null if no rule template exists for the given stack token.
+ */
+export async function generateRulesForStack(dna, stackToken) {
+    const template = RULE_TEMPLATES[stackToken];
+    if (template === undefined) {
+        return null;
+    }
+    const { aiToolProfile } = dna;
+    const content = await formatRuleForAI(template, aiToolProfile, stackToken);
+    const filePath = resolveFilePath(aiToolProfile, stackToken);
+    if (filePath === null) {
+        return null;
+    }
+    return { filePath, content };
+}
+/**
+ * Formats rule content according to the AI tool's expected format.
+ */
+// eslint-disable-next-line @typescript-eslint/require-await
+export async function formatRuleForAI(ruleContent, profile, stackToken) {
+    switch (profile.rulesFormat) {
+        case 'mdc': {
+            const globs = GLOB_PATTERNS[stackToken] ?? ['**/*.ts'];
+            return buildMdcFrontmatter(stackToken, globs) + ruleContent;
+        }
+        case 'markdown-append': {
+            return buildAppendMarkers(stackToken, ruleContent);
+        }
+        case 'yaml': {
+            // For aider: wrap content as a YAML comment block
+            const lines = ruleContent
+                .split('\n')
+                .map((l) => `# ${l}`)
+                .join('\n');
+            return `\n# === Planu: ${capitalize(stackToken)} Patterns ===\n${lines}\n`;
+        }
+        case 'markdown':
+        default: {
+            return ruleContent + '\n';
+        }
+    }
+}
+/**
+ * Resolves the file path where the rule should be written for a given AI tool.
+ */
+function resolveFilePath(profile, stackToken) {
+    if (profile.rulesFormat === 'mdc' && profile.rulesDir !== undefined) {
+        return `${profile.rulesDir}${stackToken}.mdc`;
+    }
+    if (profile.rulesFormat === 'markdown' && profile.rulesDir !== undefined) {
+        return `${profile.rulesDir}${stackToken}.md`;
+    }
+    if ((profile.rulesFormat === 'markdown-append' || profile.rulesFormat === 'yaml') &&
+        profile.rulesFile !== undefined) {
+        return profile.rulesFile;
+    }
+    if (profile.rulesFormat === 'markdown' && profile.configFile !== undefined) {
+        return profile.configFile;
+    }
+    return null;
+}
+/**
+ * Returns the list of stack tokens that have rule templates available.
+ */
+export function getSupportedStackTokens() {
+    return Object.keys(RULE_TEMPLATES);
+}
+//# sourceMappingURL=rules-generator.js.map

package/dist/engine/project-dna/rules-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-generator.js","sourceRoot":"","sources":["../../../src/engine/project-dna/rules-generator.ts"],"names":[],"mappings":"AAIA,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAE9E,MAAM,cAAc,GAA2B;IAC7C,QAAQ,EAAE;;;;;mEAKuD;IAEjE,UAAU,EAAE;;;;2DAI6C;IAEzD,MAAM,EAAE;;;;sEAI4D;IAEpE,MAAM,EAAE;;;;4CAIkC;IAE1C,KAAK,EAAE;;;;kDAIyC;IAEhD,MAAM,EAAE;;;;2CAIiC;IAEzC,GAAG,EAAE;;;;yDAIkD;IAEvD,MAAM,EAAE;;;;2DAIiD;IAEzD,IAAI,EAAE;;;;6CAIqC;IAE3C,OAAO,EAAE;;;;sCAI2B;IAEpC,MAAM,EAAE;;;;0DAIgD;IAExD,KAAK,EAAE;;;;2CAIkC;IAEzC,GAAG,EAAE;;;;iDAI0C;IAE/C,IAAI,EAAE;;;;sCAI8B;IAEpC,QAAQ,EAAE;;;;gDAIoC;CAC/C,CAAC;AAEF,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,MAAM,aAAa,GAA6B;IAC9C,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;IACjC,UAAU,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;IACnC,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC;IACtD,MAAM,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,eAAe,CAAC;IACzD,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;IAC/B,MAAM,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;IAChC,GAAG,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;IAC5B,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,IAAI,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,cAAc,CAAC;IACtD,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,KAAK,EAAE,CAAC,SAAS,CAAC;IAClB,GAAG,EAAE,CAAC,SAAS,CAAC;IAChB,IAAI,EAAE,CAAC,SAAS,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC;CAChD,CAAC;AAEF,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,SAAS,mBAAmB,CAAC,UAAkB,EAAE,KAAe;IAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,GAAG,UAAU,CAAC,UAAU,CAAC,4BAA4B,CAAC;IAC1E,OAAO,qBAAqB,WAAW,gCAAgC,SAAS,WAAW,CAAC;AAC9F,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,kBAAkB,CAAC,UAAkB,EAAE,OAAe;IAC7D,MAAM,MAAM,GAAG,cAAc,UAAU,MAAM,CAAC;IAC9C,MAAM,SAAS,GAAG,eAAe,UAAU,MAAM,CAAC;IAClD,OAAO,KAAK,MAAM,KAAK,OAAO,KAAK,SAAS,IAAI,CAAC;AACnD,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAe,EACf,UAAkB;IAElB,MAAM,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC;IAC9B,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;IAE3E,MAAM,QAAQ,GAAG,eAAe,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAC5D,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,OAAsB,EACtB,UAAkB;IAElB,QAAQ,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5B,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvD,OAAO,mBAAmB,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,WAAW,CAAC;QAC9D,CAAC;QACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,OAAO,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACrD,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,kDAAkD;YAClD,MAAM,KAAK,GAAG,WAAW;iBACtB,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;iBACpB,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,OAAO,kBAAkB,UAAU,CAAC,UAAU,CAAC,kBAAkB,KAAK,IAAI,CAAC;QAC7E,CAAC;QACD,KAAK,UAAU,CAAC;QAChB,OAAO,CAAC,CAAC,CAAC;YACR,OAAO,WAAW,GAAG,IAAI,CAAC;QAC5B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,OAAsB,EAAE,UAAkB;IACjE,IAAI,OAAO,CAAC,WAAW,KAAK,KAAK,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACpE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,UAAU,MAAM,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,KAAK,UAAU,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,UAAU,KAAK,CAAC;IAC/C,CAAC;IACD,IACE,CAAC,OAAO,CAAC,WAAW,KAAK,iBAAiB,IAAI,OAAO,CAAC,WAAW,KAAK,MAAM,CAAC;QAC7E,OAAO,CAAC,SAAS,KAAK,SAAS,EAC/B,CAAC;QACD,OAAO,OAAO,CAAC,SAAS,CAAC;IAC3B,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,KAAK,UAAU,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3E,OAAO,OAAO,CAAC,UAAU,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACrC,CAAC"}

package/dist/engine/project-dna/stack-detector.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Detects the technology stack by reading common manifest files.
+ * Returns normalized stack tokens (e.g. 'nextjs', 'supabase', 'vitest').
+ */
+export declare function detectStack(projectPath: string): Promise<string[]>;
+type PackageManager = 'npm' | 'pnpm' | 'yarn' | 'bun' | 'pip' | 'cargo' | 'go' | 'unknown';
+/**
+ * Detects the package manager by checking lock files and manifests.
+ */
+export declare function detectPackageManager(projectPath: string): Promise<PackageManager>;
+/**
+ * Detects the primary testing framework based on stack tokens and config files.
+ */
+export declare function detectTestingFramework(projectPath: string, stack: string[]): Promise<string | undefined>;
+/**
+ * Detects the primary linter based on config files and stack tokens.
+ */
+export declare function detectLinter(projectPath: string, stack: string[]): Promise<string | undefined>;
+/**
+ * Detects the primary code formatter based on config files and stack tokens.
+ */
+export declare function detectFormatter(projectPath: string, stack: string[]): Promise<string | undefined>;
+export {};
+//# sourceMappingURL=stack-detector.d.ts.map

package/dist/engine/project-dna/stack-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/project-dna/stack-detector.ts"],"names":[],"mappings":"AA8BA;;;GAGG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWxE;AAmKD,KAAK,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAE3F;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAsBvF;AAMD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B;AAMD;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA+B7B;AAMD;;GAEG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwB7B"}