@planu/cli 0.43.1 → 0.44.0

package/dist/engine/analyzer/analyze-project.js

@@ -0,0 +1,101 @@
+// Planu — Code Analysis Engine
+// Orchestrates project analysis by delegating to specialized detectors
+import { loadStackSignatures, loadArchPatterns } from '../detection-utils.js';
+import { detectLanguage, detectLanguageVersion } from '../language-detector.js';
+import { detectFramework, detectFrameworkVersion, detectDatabase, detectOrm, detectPackageManager, detectBuildCommand, detectTestCommand, detectLintCommand, } from '../framework-detector.js';
+import { detectArchitecture } from '../architecture-detector.js';
+import { detectApps, isMonorepoProject, detectApiContracts } from '../multi-app-detector.js';
+import { analyzeEnvSetup, discoverMcps, buildStackList, buildQualityProfile } from './env-setup.js';
+import { detectAgentProjectKnowledge } from '../detectors/agent-framework-detector.js';
+import { analyzeLinting, detectConventions, detectEnvironments, detectExternalServices, detectTooling, } from './detectors.js';
+import { checkProjectCompleteness } from './completeness-checker.js';
+import { detectProjectCategory } from '../platform-detector.js';
+// === Public API ===
+/**
+ * Full project analysis: scans filesystem to build ProjectKnowledge.
+ */
+// eslint-disable-next-line max-lines-per-function -- orchestrator delegates to detectors, not decomposable
+export async function analyzeProject(projectPath, projectId, locale = 'en', experienceLevel = 'intermediate', stackSignatures, archPatterns) {
+    const signatures = stackSignatures ?? (await loadStackSignatures());
+    const archConfig = archPatterns ?? (await loadArchPatterns());
+    const [language, framework, packageManager, database, orm, apps, architecture, linting, envSetup, apiContracts, mcps, conventions, monorepo, _completeness,] = await Promise.all([
+        detectLanguage(projectPath, signatures),
+        detectFramework(projectPath, signatures),
+        detectPackageManager(projectPath, signatures),
+        detectDatabase(projectPath, signatures),
+        detectOrm(projectPath),
+        detectApps(projectPath, signatures, archConfig),
+        detectArchitecture(projectPath, archConfig),
+        analyzeLinting(projectPath),
+        analyzeEnvSetup(projectPath, projectId),
+        detectApiContracts(projectPath),
+        discoverMcps(projectPath),
+        detectConventions(projectPath),
+        isMonorepoProject(projectPath),
+        checkProjectCompleteness(projectPath),
+    ]);
+    const [languageVersion, frameworkVersion, buildCommand, testCommand, lintCommand, externalServices, tooling, environments, projectCategory, agentKnowledge,] = await Promise.all([
+        detectLanguageVersion(projectPath, language),
+        detectFrameworkVersion(projectPath, framework, signatures),
+        detectBuildCommand(projectPath, packageManager),
+        detectTestCommand(projectPath, packageManager),
+        detectLintCommand(projectPath, packageManager),
+        detectExternalServices(projectPath),
+        detectTooling(projectPath),
+        detectEnvironments(projectPath),
+        detectProjectCategory(projectPath, framework),
+        detectAgentProjectKnowledge(projectPath),
+    ]);
+    const stack = buildStackList(language, framework, database, packageManager);
+    const layers = architecture.layers.map((l) => l.name);
+    const qualityProfile = buildQualityProfile(linting, conventions);
+    return {
+        projectId,
+        projectPath,
+        locale,
+        experienceLevel,
+        language,
+        languageVersion,
+        framework,
+        frameworkVersion,
+        packageManager,
+        buildCommand,
+        testCommand,
+        lintCommand,
+        stack,
+        database,
+        orm,
+        architecture,
+        apps,
+        conventions,
+        layers,
+        environments,
+        apiContracts,
+        monorepo,
+        externalServices,
+        tooling,
+        specLocation: 'planu/specs',
+        envSetup,
+        linting,
+        availableMcps: mcps,
+        docsRegistry: {},
+        qualityProfile,
+        lastAnalyzed: new Date().toISOString(),
+        projectCategory,
+        agentKnowledge: agentKnowledge.framework !== null ? agentKnowledge : undefined,
+    };
+}
+/**
+ * Quick analysis: only detects language, framework, and package manager.
+ */
+export async function quickAnalyze(projectPath) {
+    const signatures = await loadStackSignatures();
+    const [language, framework, packageManager, database] = await Promise.all([
+        detectLanguage(projectPath, signatures),
+        detectFramework(projectPath, signatures),
+        detectPackageManager(projectPath, signatures),
+        detectDatabase(projectPath, signatures),
+    ]);
+    return { language, framework, packageManager, database };
+}
+//# sourceMappingURL=analyze-project.js.map

package/dist/engine/analyzer/analyze-project.js.map

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

package/dist/engine/analyzer/completeness-checker.d.ts

@@ -0,0 +1,6 @@
+import type { ProjectCompleteness } from '../../types/index.js';
+/**
+ * Check project completeness (has readme, gitignore, tests, ci, etc.)
+ */
+export declare function checkProjectCompleteness(projectPath: string): Promise<ProjectCompleteness>;
+//# sourceMappingURL=completeness-checker.d.ts.map

package/dist/engine/analyzer/completeness-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completeness-checker.d.ts","sourceRoot":"","sources":["../../../src/engine/analyzer/completeness-checker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE;;GAEG;AAEH,wBAAsB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgGhG"}

package/dist/engine/analyzer/completeness-checker.js

@@ -0,0 +1,79 @@
+// Planu — Project Completeness Checker
+// Checks for presence of standard project files (readme, gitignore, tests, ci, etc.)
+import { fileExists, hasAnyFile } from '../detection-utils.js';
+/**
+ * Check project completeness (has readme, gitignore, tests, ci, etc.)
+ */
+// eslint-disable-next-line max-lines-per-function -- checklist pattern, each line is a single check
+export async function checkProjectCompleteness(projectPath) {
+    const checks = await Promise.all([
+        fileExists(projectPath, 'README.md'),
+        fileExists(projectPath, '.gitignore'),
+        fileExists(projectPath, '.env.example').then((r) => r || fileExists(projectPath, '.env.local.example')),
+        fileExists(projectPath, 'LICENSE'),
+        fileExists(projectPath, '.editorconfig'),
+        hasAnyFile(projectPath, [
+            '.eslintrc*',
+            'eslint.config.*',
+            'biome.json',
+            '.pylintrc',
+            'ruff.toml',
+            '.golangci.yml',
+            'Cargo.toml',
+        ]),
+        hasAnyFile(projectPath, ['.prettierrc*', 'biome.json', '.editorconfig']),
+        hasAnyFile(projectPath, [
+            'jest.config.*',
+            'vitest.config.*',
+            'pytest.ini',
+            'pyproject.toml',
+            'Cargo.toml',
+            '*.test.*',
+            '*.spec.*',
+        ]),
+        hasAnyFile(projectPath, [
+            '.github/workflows/*',
+            '.gitlab-ci.yml',
+            'Jenkinsfile',
+            '.circleci/config.yml',
+        ]),
+        hasAnyFile(projectPath, ['sentry.*.config.*', '.sentryclirc', 'bugsnag.*']),
+        hasAnyFile(projectPath, ['tsconfig.json', 'mypy.ini', 'pyrightconfig.json', '.flowconfig']),
+        hasAnyFile(projectPath, ['.snyk', '.trivyignore', 'security.md', 'SECURITY.md']),
+        hasAnyFile(projectPath, ['docs/**/*.md', 'doc/**/*', 'documentation/**/*']),
+        fileExists(projectPath, 'CONTRIBUTING.md'),
+        hasAnyFile(projectPath, ['CHANGELOG.md', '.changeset/*', '.releaserc*']),
+        hasAnyFile(projectPath, ['backup*', 'docker-compose.yml']),
+        hasAnyFile(projectPath, ['*.a11y.*', 'axe*', 'pa11y*']),
+        hasAnyFile(projectPath, ['robots.txt', 'sitemap.xml', 'next-sitemap.config.*']),
+        hasAnyFile(projectPath, ['lighthouse*', 'bundle-analyzer*', 'webpack-bundle*']),
+        hasAnyFile(projectPath, ['seed.*', 'seeds/*', 'fixtures/*', 'prisma/seed.*']),
+    ]);
+    const [hasReadme, hasGitignore, hasEnvExample, hasLicense, hasEditorConfig, hasLinting, hasFormatting, hasTesting, hasCiCd, hasErrorTracking, hasTypeChecking, hasSecurityScanning, hasDocumentation, hasContributing, hasChangelogStrategy, hasBackupStrategy, hasAccessibility, hasSeo, hasPerformanceBudget, hasSeedData,] = checks;
+    const trueCount = checks.filter(Boolean).length;
+    const completenessScore = Math.round((trueCount / checks.length) * 100);
+    return {
+        hasReadme,
+        hasGitignore,
+        hasEnvExample,
+        hasLicense,
+        hasEditorConfig,
+        hasLinting,
+        hasFormatting,
+        hasTesting,
+        hasCiCd,
+        hasErrorTracking,
+        hasTypeChecking,
+        hasSecurityScanning,
+        hasDocumentation,
+        hasContributing,
+        hasChangelogStrategy,
+        hasBackupStrategy,
+        hasAccessibility,
+        hasSeo,
+        hasPerformanceBudget,
+        hasSeedData,
+        completenessScore,
+    };
+}
+//# sourceMappingURL=completeness-checker.js.map

package/dist/engine/analyzer/completeness-checker.js.map

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

package/dist/engine/analyzer/db-engine.d.ts

@@ -0,0 +1,9 @@
+import type { DBEngine, DBEngineConfig, SQLSyntaxConfig } from '../../types/tooling.js';
+/** Resets the in-memory cache — used in tests to force reload */
+export declare function resetDbRegistryCache(): void;
+export declare function detectDBEngine(projectPath: string): Promise<DBEngineConfig | null>;
+export declare function getSQLSyntaxForEngine(engine: DBEngine): SQLSyntaxConfig;
+export declare function generateFirestoreRules(collections: string[]): string;
+export declare function generateMongoSchema(collections: string[]): string;
+export declare function generateSupabaseRLS(tables: string[]): string;
+//# sourceMappingURL=db-engine.d.ts.map

package/dist/engine/analyzer/db-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-engine.d.ts","sourceRoot":"","sources":["../../../src/engine/analyzer/db-engine.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EAEd,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAOhC,iEAAiE;AACjE,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAqBD,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAmBxF;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,eAAe,CA4DvE;AAID,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAkBpE;AAID,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CA0BjE;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAuB5D"}

package/dist/engine/analyzer/db-engine.js

@@ -0,0 +1,137 @@
+// Planu — DB Engine Detection (SPEC-025)
+// Detects database engine from project dependencies and generates adapted SQL syntax
+import { readFile } from 'node:fs/promises';
+import { collectDependencies } from '../detection-utils.js';
+// === Registry loading ===
+let registryCache = null;
+/** Resets the in-memory cache — used in tests to force reload */
+export function resetDbRegistryCache() {
+    registryCache = null;
+}
+async function loadDbRegistry() {
+    if (registryCache) {
+        return registryCache;
+    }
+    try {
+        const configPath = new URL('../../config/db-engines.json', import.meta.url);
+        const content = await readFile(configPath, 'utf-8');
+        registryCache = JSON.parse(content);
+        return registryCache;
+    }
+    catch {
+        return {
+            engines: {},
+            sqlSyntax: { createTable: {}, primaryKeyConstraint: {}, autoTimestamps: {} },
+        };
+    }
+}
+// === DB Engine detection ===
+export async function detectDBEngine(projectPath) {
+    const registry = await loadDbRegistry();
+    const deps = await collectDependencies(projectPath);
+    for (const [engineKey, engine] of Object.entries(registry.engines)) {
+        const allDeps = [...engine.detectionDeps, ...(engine.prismaDeps ?? [])];
+        for (const dep of allDeps) {
+            if (deps.has(dep)) {
+                return {
+                    engine: engineKey,
+                    detectedFrom: dep,
+                    features: engine.features,
+                    securityRules: engine.securityRules,
+                };
+            }
+        }
+    }
+    return null;
+}
+// === SQL syntax adapters ===
+export function getSQLSyntaxForEngine(engine) {
+    const defaults = {
+        createTable: 'CREATE TABLE IF NOT EXISTS',
+        primaryKey: 'PRIMARY KEY',
+        autoTimestamp: 'DEFAULT now()',
+        idType: 'uuid DEFAULT gen_random_uuid()',
+        jsonType: 'jsonb',
+        autoIncrement: 'GENERATED ALWAYS AS IDENTITY',
+    };
+    switch (engine) {
+        case 'supabase':
+        case 'postgresql':
+            return {
+                createTable: 'CREATE TABLE IF NOT EXISTS',
+                primaryKey: 'PRIMARY KEY',
+                autoTimestamp: 'DEFAULT now()',
+                idType: 'uuid DEFAULT gen_random_uuid()',
+                jsonType: 'jsonb',
+                autoIncrement: 'GENERATED ALWAYS AS IDENTITY',
+            };
+        case 'mysql':
+            return {
+                createTable: 'CREATE TABLE IF NOT EXISTS',
+                primaryKey: 'PRIMARY KEY',
+                autoTimestamp: 'DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP',
+                idType: 'CHAR(36) DEFAULT (UUID())',
+                jsonType: 'JSON',
+                autoIncrement: 'AUTO_INCREMENT',
+            };
+        case 'sqlite':
+            return {
+                createTable: 'CREATE TABLE IF NOT EXISTS',
+                primaryKey: 'PRIMARY KEY',
+                autoTimestamp: "DEFAULT (datetime('now'))",
+                idType: 'TEXT DEFAULT (lower(hex(randomblob(16))))',
+                jsonType: 'TEXT',
+                autoIncrement: 'AUTOINCREMENT',
+            };
+        case 'mongodb':
+            return {
+                createTable: 'db.createCollection',
+                primaryKey: '_id',
+                autoTimestamp: 'ISODate()',
+                idType: 'ObjectId',
+                jsonType: 'BSON',
+                autoIncrement: 'ObjectId()',
+            };
+        case 'firebase':
+            return {
+                createTable: '// Firestore collection (no DDL)',
+                primaryKey: 'document.id',
+                autoTimestamp: 'FieldValue.serverTimestamp()',
+                idType: 'string (auto-generated)',
+                jsonType: 'Map<string, any>',
+                autoIncrement: 'Firestore auto-ID',
+            };
+        default:
+            return defaults;
+    }
+}
+// === Firestore security rules generation ===
+export function generateFirestoreRules(collections) {
+    const rules = [
+        "rules_version = '2';",
+        'service cloud.firestore {',
+        '  match /databases/{database}/documents {',
+    ];
+    for (const collection of collections) {
+        rules.push(`    match /${collection}/{document=**} {`, `      allow read: if request.auth != null;`, `      allow write: if request.auth != null && request.auth.uid == resource.data.userId;`, `    }`);
+    }
+    rules.push('  }', '}');
+    return rules.join('\n');
+}
+// === MongoDB schema generation ===
+export function generateMongoSchema(collections) {
+    const lines = ['// MongoDB Collection Schemas', ''];
+    for (const collection of collections) {
+        lines.push(`// ${collection} collection`, `db.createCollection("${collection}", {`, `  validator: {`, `    $jsonSchema: {`, `      bsonType: "object",`, `      required: ["_id", "createdAt", "updatedAt"],`, `      properties: {`, `        _id: { bsonType: "objectId", description: "Primary key" },`, `        createdAt: { bsonType: "date", description: "Creation timestamp" },`, `        updatedAt: { bsonType: "date", description: "Last update timestamp" }`, `      }`, `    }`, `  }`, `});`, ``, `db.${collection}.createIndex({ createdAt: -1 });`, ``);
+    }
+    return lines.join('\n');
+}
+// === Supabase RLS helper ===
+export function generateSupabaseRLS(tables) {
+    const lines = ['-- Supabase RLS Policies', ''];
+    for (const table of tables) {
+        lines.push(`-- Enable RLS on ${table}`, `ALTER TABLE ${table} ENABLE ROW LEVEL SECURITY;`, ``, `-- Allow authenticated users to read`, `CREATE POLICY "${table}_select_authenticated"`, `  ON ${table} FOR SELECT`, `  USING (auth.role() = 'authenticated');`, ``, `-- Allow users to manage their own records`, `CREATE POLICY "${table}_all_owner"`, `  ON ${table} FOR ALL`, `  USING (auth.uid() = user_id)`, `  WITH CHECK (auth.uid() = user_id);`, ``);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=db-engine.js.map

package/dist/engine/analyzer/db-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-engine.js","sourceRoot":"","sources":["../../../src/engine/analyzer/db-engine.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,qFAAqF;AAErF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAO5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,2BAA2B;AAE3B,IAAI,aAAa,GAA4B,IAAI,CAAC;AAElD,iEAAiE;AACjE,MAAM,UAAU,oBAAoB;IAClC,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC;AAED,KAAK,UAAU,cAAc;IAC3B,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,8BAA8B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACpD,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAqB,CAAC;QACxD,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,oBAAoB,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE;SAC7E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8BAA8B;AAE9B,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,MAAM,QAAQ,GAAG,MAAM,cAAc,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEpD,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACnE,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC;QACxE,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClB,OAAO;oBACL,MAAM,EAAE,SAAqB;oBAC7B,YAAY,EAAE,GAAG;oBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,aAAa,EAAE,MAAM,CAAC,aAAa;iBACpC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8BAA8B;AAE9B,MAAM,UAAU,qBAAqB,CAAC,MAAgB;IACpD,MAAM,QAAQ,GAAoB;QAChC,WAAW,EAAE,4BAA4B;QACzC,UAAU,EAAE,aAAa;QACzB,aAAa,EAAE,eAAe;QAC9B,MAAM,EAAE,gCAAgC;QACxC,QAAQ,EAAE,OAAO;QACjB,aAAa,EAAE,8BAA8B;KAC9C,CAAC;IAEF,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU,CAAC;QAChB,KAAK,YAAY;YACf,OAAO;gBACL,WAAW,EAAE,4BAA4B;gBACzC,UAAU,EAAE,aAAa;gBACzB,aAAa,EAAE,eAAe;gBAC9B,MAAM,EAAE,gCAAgC;gBACxC,QAAQ,EAAE,OAAO;gBACjB,aAAa,EAAE,8BAA8B;aAC9C,CAAC;QACJ,KAAK,OAAO;YACV,OAAO;gBACL,WAAW,EAAE,4BAA4B;gBACzC,UAAU,EAAE,aAAa;gBACzB,aAAa,EAAE,uDAAuD;gBACtE,MAAM,EAAE,2BAA2B;gBACnC,QAAQ,EAAE,MAAM;gBAChB,aAAa,EAAE,gBAAgB;aAChC,CAAC;QACJ,KAAK,QAAQ;YACX,OAAO;gBACL,WAAW,EAAE,4BAA4B;gBACzC,UAAU,EAAE,aAAa;gBACzB,aAAa,EAAE,2BAA2B;gBAC1C,MAAM,EAAE,2CAA2C;gBACnD,QAAQ,EAAE,MAAM;gBAChB,aAAa,EAAE,eAAe;aAC/B,CAAC;QACJ,KAAK,SAAS;YACZ,OAAO;gBACL,WAAW,EAAE,qBAAqB;gBAClC,UAAU,EAAE,KAAK;gBACjB,aAAa,EAAE,WAAW;gBAC1B,MAAM,EAAE,UAAU;gBAClB,QAAQ,EAAE,MAAM;gBAChB,aAAa,EAAE,YAAY;aAC5B,CAAC;QACJ,KAAK,UAAU;YACb,OAAO;gBACL,WAAW,EAAE,kCAAkC;gBAC/C,UAAU,EAAE,aAAa;gBACzB,aAAa,EAAE,8BAA8B;gBAC7C,MAAM,EAAE,yBAAyB;gBACjC,QAAQ,EAAE,kBAAkB;gBAC5B,aAAa,EAAE,mBAAmB;aACnC,CAAC;QACJ;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED,8CAA8C;AAE9C,MAAM,UAAU,sBAAsB,CAAC,WAAqB;IAC1D,MAAM,KAAK,GAAa;QACtB,sBAAsB;QACtB,2BAA2B;QAC3B,2CAA2C;KAC5C,CAAC;IAEF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CACR,cAAc,UAAU,kBAAkB,EAC1C,4CAA4C,EAC5C,yFAAyF,EACzF,OAAO,CACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,oCAAoC;AAEpC,MAAM,UAAU,mBAAmB,CAAC,WAAqB;IACvD,MAAM,KAAK,GAAa,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;IAE9D,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CACR,MAAM,UAAU,aAAa,EAC7B,wBAAwB,UAAU,MAAM,EACxC,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,oDAAoD,EACpD,qBAAqB,EACrB,oEAAoE,EACpE,6EAA6E,EAC7E,+EAA+E,EAC/E,SAAS,EACT,OAAO,EACP,KAAK,EACL,KAAK,EACL,EAAE,EACF,MAAM,UAAU,kCAAkC,EAClD,EAAE,CACH,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,8BAA8B;AAE9B,MAAM,UAAU,mBAAmB,CAAC,MAAgB;IAClD,MAAM,KAAK,GAAa,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;IAEzD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CACR,oBAAoB,KAAK,EAAE,EAC3B,eAAe,KAAK,6BAA6B,EACjD,EAAE,EACF,sCAAsC,EACtC,kBAAkB,KAAK,wBAAwB,EAC/C,QAAQ,KAAK,aAAa,EAC1B,0CAA0C,EAC1C,EAAE,EACF,4CAA4C,EAC5C,kBAAkB,KAAK,aAAa,EACpC,QAAQ,KAAK,UAAU,EACvB,gCAAgC,EAChC,sCAAsC,EACtC,EAAE,CACH,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/engine/analyzer/detectors.d.ts

@@ -0,0 +1,7 @@
+import type { LintingAnalysis } from '../../types/index.js';
+export declare function analyzeLinting(projectPath: string): Promise<LintingAnalysis>;
+export declare function detectConventions(projectPath: string): Promise<Record<string, string>>;
+export declare function detectEnvironments(projectPath: string): Promise<string[]>;
+export declare function detectExternalServices(projectPath: string): Promise<string[]>;
+export declare function detectTooling(projectPath: string): Promise<Record<string, string>>;
+//# sourceMappingURL=detectors.d.ts.map

package/dist/engine/analyzer/detectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detectors.d.ts","sourceRoot":"","sources":["../../../src/engine/analyzer/detectors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAM5D,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAElF;AAKD,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAiG5F;AAID,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkB/E;AAID,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsCnF;AAKD,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgExF"}

package/dist/engine/analyzer/detectors.js

@@ -0,0 +1,234 @@
+// Planu — Analyzer: Linting, Conventions, Environments, Tooling, External Services
+// Internal helpers extracted from analyzer.ts to keep file sizes manageable.
+import { fileExists, hasAnyFile, collectDependencies } from '../detection-utils.js';
+import { analyzeLintingEnhanced } from '../analyzer-linting.js';
+// === Linting Analysis — delegates to enhanced module (SPEC-025) ===
+export async function analyzeLinting(projectPath) {
+    return analyzeLintingEnhanced(projectPath);
+}
+// === Convention Detection ===
+// eslint-disable-next-line max-lines-per-function, complexity -- checklist pattern for AI agent configs
+export async function detectConventions(projectPath) {
+    const conventions = {};
+    // AI agent configs — detect all major AI coding platforms
+    if (await fileExists(projectPath, 'CLAUDE.md')) {
+        conventions['ai-rules'] = 'CLAUDE.md';
+    }
+    if (await fileExists(projectPath, '.cursorrules')) {
+        conventions['cursor-rules'] = '.cursorrules';
+    }
+    if (await fileExists(projectPath, '.windsurfrules')) {
+        conventions['windsurf-rules'] = '.windsurfrules';
+    }
+    if (await fileExists(projectPath, '.clinerules')) {
+        conventions['cline-rules'] = '.clinerules';
+    }
+    if (await fileExists(projectPath, '.github/copilot-instructions.md')) {
+        conventions['copilot-rules'] = '.github/copilot-instructions.md';
+    }
+    if (await fileExists(projectPath, 'AGENTS.md')) {
+        conventions['codex-rules'] = 'AGENTS.md';
+    }
+    if (await fileExists(projectPath, 'devin.md')) {
+        conventions['devin-rules'] = 'devin.md';
+    }
+    if (await hasAnyFile(projectPath, ['.continue/config.json', '.continuerc.json'])) {
+        conventions['continue-rules'] = '.continue/config.json';
+    }
+    if (await hasAnyFile(projectPath, ['.aider.conf.yml'])) {
+        conventions['aider-rules'] = '.aider.conf.yml';
+    }
+    if (await hasAnyFile(projectPath, ['.gemini/settings.json', '.idx/dev.nix'])) {
+        conventions['gemini-rules'] = '.gemini/settings.json';
+    }
+    if (await hasAnyFile(projectPath, ['.amazonq/rules.md', '.amazonq/settings.json'])) {
+        conventions['amazon-q-rules'] = '.amazonq/rules.md';
+    }
+    if (await fileExists(projectPath, '.junie/guidelines.md')) {
+        conventions['junie-rules'] = '.junie/guidelines.md';
+    }
+    if (await fileExists(projectPath, '.sourcegraph/cody.json')) {
+        conventions['cody-rules'] = '.sourcegraph/cody.json';
+    }
+    if (await fileExists(projectPath, '.replit')) {
+        conventions['replit-rules'] = '.replit';
+    }
+    if (await hasAnyFile(projectPath, ['.zed/settings.json'])) {
+        conventions['zed-rules'] = '.zed/settings.json';
+    }
+    if (await hasAnyFile(projectPath, ['.augment/config.json', '.augmentignore'])) {
+        conventions['augment-rules'] = '.augment/config.json';
+    }
+    if (await fileExists(projectPath, '.qodo/config.json')) {
+        conventions['qodo-rules'] = '.qodo/config.json';
+    }
+    if (await fileExists(projectPath, '.kilocode/rules')) {
+        conventions['kilo-code-rules'] = '.kilocode/rules';
+    }
+    if (await fileExists(projectPath, '.tabnine/config.json')) {
+        conventions['tabnine-rules'] = '.tabnine/config.json';
+    }
+    if (await hasAnyFile(projectPath, ['.agent/rules/*', '.agent/workflows/*'])) {
+        conventions['antigravity-rules'] = '.agent/rules/';
+    }
+    if (await fileExists(projectPath, 'GEMINI.md')) {
+        // GEMINI.md is used by both Antigravity and Gemini CLI
+        conventions['antigravity-rules'] ??= 'GEMINI.md';
+        conventions['gemini-rules'] = 'GEMINI.md';
+    }
+    // Editor config
+    if (await fileExists(projectPath, '.editorconfig')) {
+        conventions['editor-config'] = '.editorconfig';
+    }
+    // Commit conventions
+    if (await hasAnyFile(projectPath, ['commitlint.config.*', '.commitlintrc*'])) {
+        conventions['commit-convention'] = 'conventional-commits';
+    }
+    // Git hooks
+    if (await fileExists(projectPath, '.husky')) {
+        conventions['git-hooks'] = 'husky';
+    }
+    if (await hasAnyFile(projectPath, ['.lefthook.yml', 'lefthook.yml'])) {
+        conventions['git-hooks'] = 'lefthook';
+    }
+    if (await hasAnyFile(projectPath, ['.pre-commit-config.yaml'])) {
+        conventions['git-hooks'] = 'pre-commit';
+    }
+    // Lint-staged
+    if (await hasAnyFile(projectPath, ['.lintstagedrc*', 'lint-staged.config.*'])) {
+        conventions['lint-staged'] = 'lint-staged';
+    }
+    return conventions;
+}
+// === Environment Detection ===
+export async function detectEnvironments(projectPath) {
+    const environments = ['development'];
+    if (await hasAnyFile(projectPath, ['.env.staging', '.env.test', '.env.production'])) {
+        if (await fileExists(projectPath, '.env.staging')) {
+            environments.push('staging');
+        }
+        if (await fileExists(projectPath, '.env.test')) {
+            environments.push('test');
+        }
+        if (await fileExists(projectPath, '.env.production')) {
+            environments.push('production');
+        }
+    }
+    else {
+        environments.push('staging', 'production');
+    }
+    return environments;
+}
+// === External Services Detection ===
+export async function detectExternalServices(projectPath) {
+    const services = new Set();
+    const deps = await collectDependencies(projectPath);
+    const serviceMap = {
+        stripe: ['stripe', '@stripe/stripe-js'],
+        aws: ['aws-sdk', '@aws-sdk/client-s3', '@aws-sdk/client-ses'],
+        'google-cloud': ['@google-cloud/storage', '@google-cloud/pubsub', '@google-cloud/firestore'],
+        azure: ['@azure/storage-blob', '@azure/cosmos'],
+        supabase: ['@supabase/supabase-js', '@supabase/ssr'],
+        firebase: ['firebase', 'firebase-admin'],
+        twilio: ['twilio'],
+        sendgrid: ['@sendgrid/mail'],
+        resend: ['resend'],
+        cloudflare: ['@cloudflare/workers-types', 'wrangler'],
+        vercel: ['@vercel/analytics', '@vercel/og'],
+        sentry: ['@sentry/node', '@sentry/nextjs', '@sentry/react'],
+        datadog: ['dd-trace'],
+        'new-relic': ['newrelic'],
+        redis: ['redis', 'ioredis'],
+        elasticsearch: ['@elastic/elasticsearch'],
+        algolia: ['algoliasearch'],
+        openai: ['openai'],
+        anthropic: ['@anthropic-ai/sdk'],
+        auth0: ['@auth0/nextjs-auth0', 'auth0'],
+        clerk: ['@clerk/nextjs', '@clerk/clerk-sdk-node'],
+    };
+    for (const [service, packages] of Object.entries(serviceMap)) {
+        for (const pkg of packages) {
+            if (deps.has(pkg)) {
+                services.add(service);
+                break;
+            }
+        }
+    }
+    return [...services];
+}
+// === Tooling Detection ===
+// eslint-disable-next-line complexity -- checklist pattern for tooling detection
+export async function detectTooling(projectPath) {
+    const tooling = {};
+    // CI/CD
+    if (await hasAnyFile(projectPath, ['.github/workflows/*'])) {
+        tooling.ci = 'github-actions';
+    }
+    else if (await fileExists(projectPath, '.gitlab-ci.yml')) {
+        tooling.ci = 'gitlab-ci';
+    }
+    else if (await fileExists(projectPath, 'Jenkinsfile')) {
+        tooling.ci = 'jenkins';
+    }
+    else if (await hasAnyFile(projectPath, ['.circleci/config.yml'])) {
+        tooling.ci = 'circleci';
+    }
+    // Containers
+    if (await fileExists(projectPath, 'Dockerfile')) {
+        tooling.container = 'docker';
+    }
+    if (await hasAnyFile(projectPath, ['docker-compose.yml', 'docker-compose.yaml'])) {
+        tooling.orchestration = 'docker-compose';
+    }
+    if (await hasAnyFile(projectPath, ['k8s/**/*', 'kubernetes/**/*'])) {
+        tooling.orchestration = 'kubernetes';
+    }
+    // Build tools / task runners
+    if (await fileExists(projectPath, 'turbo.json')) {
+        tooling.monorepo = 'turborepo';
+    }
+    else if (await fileExists(projectPath, 'nx.json')) {
+        tooling.monorepo = 'nx';
+    }
+    else if (await fileExists(projectPath, 'lerna.json')) {
+        tooling.monorepo = 'lerna';
+    }
+    // Bundlers
+    const deps = await collectDependencies(projectPath);
+    if (deps.has('vite')) {
+        tooling.bundler = 'vite';
+    }
+    else if (deps.has('webpack')) {
+        tooling.bundler = 'webpack';
+    }
+    else if (deps.has('esbuild')) {
+        tooling.bundler = 'esbuild';
+    }
+    else if (deps.has('rollup')) {
+        tooling.bundler = 'rollup';
+    }
+    else if (deps.has('tsup')) {
+        tooling.bundler = 'tsup';
+    }
+    else if (deps.has('turbopack')) {
+        tooling.bundler = 'turbopack';
+    }
+    // Testing
+    if (deps.has('vitest')) {
+        tooling.testing = 'vitest';
+    }
+    else if (deps.has('jest')) {
+        tooling.testing = 'jest';
+    }
+    else if (deps.has('mocha')) {
+        tooling.testing = 'mocha';
+    }
+    else if (await fileExists(projectPath, 'pytest.ini')) {
+        tooling.testing = 'pytest';
+    }
+    else if (await fileExists(projectPath, 'Cargo.toml')) {
+        tooling.testing = 'cargo-test';
+    }
+    return tooling;
+}
+//# sourceMappingURL=detectors.js.map

package/dist/engine/analyzer/detectors.js.map

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

package/dist/engine/analyzer/env-setup.d.ts

@@ -0,0 +1,6 @@
+import type { EnvSetupGuide, McpServerInfo, QualityProfile, LintingAnalysis, DatabaseEngine } from '../../types/index.js';
+export declare function analyzeEnvSetup(projectPath: string, projectId: string): Promise<EnvSetupGuide>;
+export declare function discoverMcps(projectPath: string): Promise<McpServerInfo[]>;
+export declare function buildStackList(language: string, framework: string | null, database: DatabaseEngine, packageManager: string | null): string[];
+export declare function buildQualityProfile(linting: LintingAnalysis, conventions: Record<string, string>): QualityProfile;
+//# sourceMappingURL=env-setup.d.ts.map

package/dist/engine/analyzer/env-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-setup.d.ts","sourceRoot":"","sources":["../../../src/engine/analyzer/env-setup.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,aAAa,EAIb,aAAa,EACb,cAAc,EAEd,eAAe,EACf,cAAc,EACf,MAAM,sBAAsB,CAAC;AAK9B,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAsCxB;AA4ED,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA8BhF;AAID,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,cAAc,EACxB,cAAc,EAAE,MAAM,GAAG,IAAI,GAC5B,MAAM,EAAE,CAYV;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,cAAc,CA4BhB"}