@planu/cli 0.43.1 → 0.45.0

package/dist/config/tool-groups.json

@@ -45,7 +45,18 @@
         "reality_check",
         "check_spec_accuracy",
         "paradigm_report",
-        "spec_coverage"
+        "spec_coverage",
+        "validate_annotations",
+        "generate_annotations",
+        "snapshot_spec_hashes",
+        "auto_reconcile",
+        "living_spec_watch",
+        "living_spec_status",
+        "spec_diff",
+        "living_spec_coverage",
+        "sync_spec_to_code",
+        "sync_code_to_spec",
+        "resolve_sync_conflict"
       ],
       "defaultEnabled": false,
       "locked": false,

package/dist/engine/analyzer/analyze-project.d.ts

@@ -0,0 +1,15 @@
+import type { ProjectKnowledge, DatabaseEngine, SupportedLocale, ExperienceLevel, StackSignatures, ArchPatternsFile } from '../../types/index.js';
+/**
+ * Full project analysis: scans filesystem to build ProjectKnowledge.
+ */
+export declare function analyzeProject(projectPath: string, projectId: string, locale?: SupportedLocale, experienceLevel?: ExperienceLevel, stackSignatures?: StackSignatures, archPatterns?: ArchPatternsFile): Promise<ProjectKnowledge>;
+/**
+ * Quick analysis: only detects language, framework, and package manager.
+ */
+export declare function quickAnalyze(projectPath: string): Promise<{
+    language: string;
+    framework: string | null;
+    packageManager: string | null;
+    database: DatabaseEngine;
+}>;
+//# sourceMappingURL=analyze-project.d.ts.map

package/dist/engine/analyzer/analyze-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-project.d.ts","sourceRoot":"","sources":["../../../src/engine/analyzer/analyze-project.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AA6B9B;;GAEG;AAEH,wBAAsB,cAAc,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,eAAsB,EAC9B,eAAe,GAAE,eAAgC,EACjD,eAAe,CAAC,EAAE,eAAe,EACjC,YAAY,CAAC,EAAE,gBAAgB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAmG3B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,cAAc,CAAC;CAC1B,CAAC,CASD"}

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":"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"}

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"}