@planu/cli 0.15.2

package/dist/engine/detectors/template-engine-detector.js

@@ -0,0 +1,172 @@
+// engine/detectors/template-engine-detector.ts — SPEC-043
+// Detects server-side template engines by ecosystem.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { glob } from 'glob';
+// === Detector registry ===
+const TEMPLATE_ENGINE_SIGNALS = [
+    // Python
+    {
+        name: 'jinja2',
+        extensions: ['jinja2', 'j2'],
+        depFiles: [{ file: 'requirements.txt', contains: 'Jinja2' }],
+    },
+    {
+        name: 'django-templates',
+        extensions: ['html'],
+        depFiles: [{ file: 'requirements.txt', contains: 'Django' }],
+    },
+    // Ruby
+    {
+        name: 'erb',
+        extensions: ['erb'],
+        depFiles: [{ file: 'Gemfile', contains: 'rails' }],
+    },
+    // PHP
+    {
+        name: 'blade',
+        extensions: ['blade.php'],
+        depFiles: [{ file: 'composer.json', contains: 'laravel/framework' }],
+    },
+    {
+        name: 'twig',
+        extensions: ['twig'],
+        depFiles: [{ file: 'composer.json', contains: 'twig/twig' }],
+    },
+    // Go
+    {
+        name: 'go-templates',
+        extensions: ['templ'],
+    },
+    // Java/Spring — detected via pom.xml only (html extension is too generic)
+    {
+        name: 'thymeleaf',
+        depFiles: [{ file: 'pom.xml', contains: 'thymeleaf' }],
+        xmlTags: ['th:text', 'th:each', 'th:if'],
+    },
+    // JavaScript/Node
+    {
+        name: 'handlebars',
+        extensions: ['hbs', 'handlebars'],
+        depPackages: ['handlebars', 'express-handlebars'],
+    },
+    {
+        name: 'nunjucks',
+        extensions: ['njk', 'nunjucks'],
+        depPackages: ['nunjucks'],
+    },
+    {
+        name: 'pug',
+        extensions: ['pug', 'jade'],
+        depPackages: ['pug'],
+    },
+    {
+        name: 'ejs',
+        extensions: ['ejs'],
+        depPackages: ['ejs'],
+    },
+];
+// === File helpers ===
+async function readText(filePath) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+async function hasFilesWithExtension(projectPath, ext) {
+    try {
+        const matches = await glob(`**/*.${ext}`, {
+            cwd: projectPath,
+            nodir: true,
+            maxDepth: 4,
+            ignore: ['node_modules/**', 'dist/**', 'build/**', '.git/**', 'vendor/**'],
+        });
+        return matches.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function readPackageJsonDeps(projectPath) {
+    const deps = new Set();
+    const content = await readText(join(projectPath, 'package.json'));
+    if (!content) {
+        return deps;
+    }
+    try {
+        const pkg = JSON.parse(content);
+        for (const dep of Object.keys(pkg.dependencies ?? {})) {
+            deps.add(dep);
+        }
+        for (const dep of Object.keys(pkg.devDependencies ?? {})) {
+            deps.add(dep);
+        }
+    }
+    catch {
+        // Unparseable — skip
+    }
+    return deps;
+}
+/**
+ * Detect Go templates specifically via {{ }} syntax in HTML files.
+ */
+async function detectGoTemplates(projectPath) {
+    try {
+        const matches = await glob('**/*.html', {
+            cwd: projectPath,
+            nodir: true,
+            maxDepth: 4,
+            ignore: ['node_modules/**', 'dist/**', 'build/**', 'vendor/**'],
+        });
+        for (const file of matches) {
+            const content = await readText(join(projectPath, file));
+            if (content && /\{\{[\s-]*\.?\w+/.test(content)) {
+                // Go template syntax: {{ .Field }} or {{- .Field -}}
+                return true;
+            }
+        }
+    }
+    catch {
+        // Skip
+    }
+    return false;
+}
+/**
+ * Detect the primary template engine used in a project.
+ * Returns the engine name (e.g. 'jinja2', 'erb', 'blade') or null if none found.
+ */
+export async function detectTemplateEngine(projectPath) {
+    const nodeDeps = await readPackageJsonDeps(projectPath);
+    for (const signal of TEMPLATE_ENGINE_SIGNALS) {
+        // Check npm deps (Node.js engines)
+        if (signal.depPackages?.some((pkg) => nodeDeps.has(pkg))) {
+            return signal.name;
+        }
+        // Check dep files (requirements.txt, Gemfile, composer.json, pom.xml)
+        if (signal.depFiles) {
+            for (const { file, contains } of signal.depFiles) {
+                const content = await readText(join(projectPath, file));
+                if (content?.includes(contains)) {
+                    return signal.name;
+                }
+            }
+        }
+        // Check file extensions (skip Go — handled separately below)
+        if (signal.extensions && signal.name !== 'go-templates' && signal.name !== 'django-templates') {
+            for (const ext of signal.extensions) {
+                if (await hasFilesWithExtension(projectPath, ext)) {
+                    return signal.name;
+                }
+            }
+        }
+    }
+    // Go templates: check for .templ files (typed Go templates) or {{ }} syntax in HTML
+    if ((await hasFilesWithExtension(projectPath, 'templ')) ||
+        (await detectGoTemplates(projectPath))) {
+        return 'go-templates';
+    }
+    return null;
+}
+//# sourceMappingURL=template-engine-detector.js.map

package/dist/engine/detectors/template-engine-detector.js.map

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

package/dist/engine/detectors/timeseries-db-detector.d.ts

@@ -0,0 +1,3 @@
+import type { TimeseriesDb } from '../../types/index.js';
+export declare function detectTimeseriesDb(projectPath: string): Promise<TimeseriesDb | null>;
+//# sourceMappingURL=timeseries-db-detector.d.ts.map

package/dist/engine/detectors/timeseries-db-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeseries-db-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/detectors/timeseries-db-detector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAczD,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAsB1F"}

package/dist/engine/detectors/timeseries-db-detector.js

@@ -0,0 +1,31 @@
+import { collectDependencies, hasAnyFile } from '../detection-utils.js';
+const TIMESCALE_DEPS = ['timescaledb', 'timescale', 'tsdb'];
+const INFLUX_DEPS = [
+    '@influxdata/influxdb-client',
+    'influxdb-client',
+    'influxdb-client-python',
+    'influxdb',
+    'influxdb2',
+    'influxdb-v2',
+];
+const QUESTDB_DEPS = ['@questdb/nodejs-client', 'questdb', 'questdb-rs'];
+export async function detectTimeseriesDb(projectPath) {
+    const deps = await collectDependencies(projectPath);
+    // TimescaleDB (PostgreSQL extension — check specific deps first)
+    if (TIMESCALE_DEPS.some((d) => deps.has(d))) {
+        return 'timescaledb';
+    }
+    if (await hasAnyFile(projectPath, ['timescaledb.conf'])) {
+        return 'timescaledb';
+    }
+    // InfluxDB
+    if (INFLUX_DEPS.some((d) => deps.has(d))) {
+        return 'influxdb';
+    }
+    // QuestDB
+    if (QUESTDB_DEPS.some((d) => deps.has(d))) {
+        return 'questdb';
+    }
+    return null;
+}
+//# sourceMappingURL=timeseries-db-detector.js.map

package/dist/engine/detectors/timeseries-db-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeseries-db-detector.js","sourceRoot":"","sources":["../../../src/engine/detectors/timeseries-db-detector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExE,MAAM,cAAc,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AAC5D,MAAM,WAAW,GAAG;IAClB,6BAA6B;IAC7B,iBAAiB;IACjB,wBAAwB;IACxB,UAAU;IACV,WAAW;IACX,aAAa;CACd,CAAC;AACF,MAAM,YAAY,GAAG,CAAC,wBAAwB,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AAEzE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAC1D,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEpD,iEAAiE;IACjE,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,MAAM,UAAU,CAAC,WAAW,EAAE,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC;QACxD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,WAAW;IACX,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,UAAU;IACV,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/engine/detectors/vector-db-detector.d.ts

@@ -0,0 +1,5 @@
+import type { VectorDb } from '../../types/index.js';
+export declare function detectVectorDb(projectPath: string): Promise<VectorDb | null>;
+/** Check if pgvector is an extension of existing PostgreSQL (not standalone) */
+export declare function isPgVectorExtension(vectorDb: VectorDb | null): boolean;
+//# sourceMappingURL=vector-db-detector.d.ts.map

package/dist/engine/detectors/vector-db-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-db-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/detectors/vector-db-detector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAUrD,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAuBlF;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAEtE"}

package/dist/engine/detectors/vector-db-detector.js

@@ -0,0 +1,34 @@
+import { collectDependencies } from '../detection-utils.js';
+const PINECONE_DEPS = ['@pinecone-database/pinecone', 'pinecone-client', 'pinecone'];
+const WEAVIATE_DEPS = ['weaviate-client', 'weaviate-ts-client', 'weaviate'];
+const QDRANT_DEPS = ['@qdrant/js-client-rest', 'qdrant-client', 'qdrant_client'];
+const MILVUS_DEPS = ['@zilliz/milvus2-sdk-node', 'pymilvus', 'milvus'];
+const CHROMA_DEPS = ['chromadb', 'chromadb-client'];
+const PGVECTOR_DEPS = ['pgvector', 'pgvector-node', 'pgvector-python'];
+export async function detectVectorDb(projectPath) {
+    const deps = await collectDependencies(projectPath);
+    if (PINECONE_DEPS.some((d) => deps.has(d))) {
+        return 'pinecone';
+    }
+    if (WEAVIATE_DEPS.some((d) => deps.has(d))) {
+        return 'weaviate';
+    }
+    if (QDRANT_DEPS.some((d) => deps.has(d))) {
+        return 'qdrant';
+    }
+    if (MILVUS_DEPS.some((d) => deps.has(d))) {
+        return 'milvus';
+    }
+    if (CHROMA_DEPS.some((d) => deps.has(d))) {
+        return 'chromadb';
+    }
+    if (PGVECTOR_DEPS.some((d) => deps.has(d))) {
+        return 'pgvector';
+    }
+    return null;
+}
+/** Check if pgvector is an extension of existing PostgreSQL (not standalone) */
+export function isPgVectorExtension(vectorDb) {
+    return vectorDb === 'pgvector';
+}
+//# sourceMappingURL=vector-db-detector.js.map

package/dist/engine/detectors/vector-db-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-db-detector.js","sourceRoot":"","sources":["../../../src/engine/detectors/vector-db-detector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,aAAa,GAAG,CAAC,6BAA6B,EAAE,iBAAiB,EAAE,UAAU,CAAC,CAAC;AACrF,MAAM,aAAa,GAAG,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,UAAU,CAAC,CAAC;AAC5E,MAAM,WAAW,GAAG,CAAC,wBAAwB,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;AACjF,MAAM,WAAW,GAAG,CAAC,0BAA0B,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AACvE,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;AACpD,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,iBAAiB,CAAC,CAAC;AAEvE,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEpD,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CAAC,QAAyB;IAC3D,OAAO,QAAQ,KAAK,UAAU,CAAC;AACjC,CAAC"}

package/dist/engine/detectors/wasm-detector.d.ts

@@ -0,0 +1,26 @@
+import type { WasmDetectionResult, WasmPackageJson, WasmTarget } from '../../types/index.js';
+/**
+ * Check package.json for WASM-related dependencies and scripts.
+ * Returns tools and targets detectable from Node/browser context.
+ */
+export declare function detectWasmFromPackageJson(pkg: WasmPackageJson): {
+    tools: string[];
+    targets: WasmTarget[];
+};
+/**
+ * Check Cargo.toml for wasm-bindgen dependency.
+ * Indicates Rust WASM compilation.
+ */
+export declare function detectWasmFromCargoToml(content: string): {
+    tools: string[];
+    targets: WasmTarget[];
+};
+/**
+ * Detect WebAssembly compilation targets and toolchain in a project.
+ *
+ * Checks:
+ * - package.json: @assemblyscript/loader, assemblyscript, wasm-pack, emscripten in scripts
+ * - Cargo.toml: wasm-bindgen, wasm-pack, wasi targets
+ */
+export declare function detectWasm(projectPath: string): Promise<WasmDetectionResult>;
+//# sourceMappingURL=wasm-detector.d.ts.map

package/dist/engine/detectors/wasm-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/detectors/wasm-detector.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAW7F;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,eAAe,GAAG;IAC/D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAmCA;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAwBA;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoClF"}

package/dist/engine/detectors/wasm-detector.js

@@ -0,0 +1,114 @@
+// engine/detectors/wasm-detector.ts — WebAssembly toolchain detection
+// SPEC-004 tech-debt S4: Detect WASM targets and build tools
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// === Helpers ===
+async function readJsonFile(filePath) {
+    const content = await readFile(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+// === Detection logic ===
+/**
+ * Check package.json for WASM-related dependencies and scripts.
+ * Returns tools and targets detectable from Node/browser context.
+ */
+export function detectWasmFromPackageJson(pkg) {
+    const tools = [];
+    const targets = new Set();
+    const allDeps = {
+        ...pkg.dependencies,
+        ...pkg.devDependencies,
+    };
+    if ('@assemblyscript/loader' in allDeps || 'assemblyscript' in allDeps) {
+        tools.push('assemblyscript');
+        targets.add('browser');
+        targets.add('node');
+    }
+    if ('wasm-pack' in allDeps) {
+        tools.push('wasm-pack');
+        targets.add('browser');
+    }
+    // Check scripts for emcc / emscripten references
+    for (const scriptCmd of Object.values(pkg.scripts ?? {})) {
+        if (/emcc|emscripten/i.test(scriptCmd)) {
+            /* v8 ignore start */
+            if (!tools.includes('emscripten')) {
+                /* v8 ignore stop */
+                tools.push('emscripten');
+            }
+            targets.add('browser');
+            targets.add('node');
+            break;
+        }
+    }
+    return { tools, targets: [...targets] };
+}
+/**
+ * Check Cargo.toml for wasm-bindgen dependency.
+ * Indicates Rust WASM compilation.
+ */
+export function detectWasmFromCargoToml(content) {
+    const tools = [];
+    const targets = new Set();
+    if (content.includes('wasm-bindgen')) {
+        tools.push('wasm-bindgen');
+        targets.add('browser');
+    }
+    if (content.includes('wasm-pack')) {
+        /* v8 ignore start */
+        if (!tools.includes('wasm-pack')) {
+            /* v8 ignore stop */
+            tools.push('wasm-pack');
+        }
+        targets.add('browser');
+    }
+    // WASI target hint
+    if (content.includes('wasi')) {
+        targets.add('wasi');
+    }
+    return { tools, targets: [...targets] };
+}
+/**
+ * Detect WebAssembly compilation targets and toolchain in a project.
+ *
+ * Checks:
+ * - package.json: @assemblyscript/loader, assemblyscript, wasm-pack, emscripten in scripts
+ * - Cargo.toml: wasm-bindgen, wasm-pack, wasi targets
+ */
+export async function detectWasm(projectPath) {
+    const allTools = [];
+    const allTargets = new Set();
+    // Check package.json
+    try {
+        const pkg = (await readJsonFile(join(projectPath, 'package.json')));
+        const { tools, targets } = detectWasmFromPackageJson(pkg);
+        for (const t of tools) {
+            allTools.push(t);
+        }
+        for (const t of targets) {
+            allTargets.add(t);
+        }
+    }
+    catch {
+        // no package.json — skip
+    }
+    // Check Cargo.toml
+    try {
+        const content = await readFile(join(projectPath, 'Cargo.toml'), 'utf-8');
+        const { tools, targets } = detectWasmFromCargoToml(content);
+        for (const t of tools) {
+            if (!allTools.includes(t)) {
+                allTools.push(t);
+            }
+        }
+        for (const t of targets) {
+            allTargets.add(t);
+        }
+    }
+    catch {
+        // no Cargo.toml — skip
+    }
+    const isWasm = allTools.length > 0;
+    return { isWasm, targets: [...allTargets], tools: allTools };
+}
+//# sourceMappingURL=wasm-detector.js.map

package/dist/engine/detectors/wasm-detector.js.map

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

package/dist/engine/detectors/widecolumn-db-detector.d.ts

@@ -0,0 +1,3 @@
+import type { WideColumnDb } from '../../types/index.js';
+export declare function detectWideColumnDb(projectPath: string): Promise<WideColumnDb | null>;
+//# sourceMappingURL=widecolumn-db-detector.d.ts.map

package/dist/engine/detectors/widecolumn-db-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widecolumn-db-detector.d.ts","sourceRoot":"","sources":["../../../src/engine/detectors/widecolumn-db-detector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAoBzD,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAwB1F"}

package/dist/engine/detectors/widecolumn-db-detector.js

@@ -0,0 +1,38 @@
+import { collectDependencies } from '../detection-utils.js';
+const SCYLLA_DEPS = ['scylladb', '@scylladb/driver', 'scylla-driver'];
+const CASSANDRA_DEPS = [
+    'cassandra-driver',
+    'datastax-driver-core',
+    'cassandra',
+    'datastax',
+    'gocql',
+];
+const CLICKHOUSE_DEPS = [
+    '@clickhouse/client',
+    'clickhouse-connect',
+    'clickhouse',
+    'clickhouse-driver',
+    'clickhouse-rs',
+];
+const HBASE_DEPS = ['hbase', 'hbase-client', 'happybase', 'hbase-rpc-client'];
+export async function detectWideColumnDb(projectPath) {
+    const deps = await collectDependencies(projectPath);
+    // ScyllaDB (Cassandra-compatible but more specific)
+    if (SCYLLA_DEPS.some((d) => deps.has(d))) {
+        return 'scylladb';
+    }
+    // Cassandra
+    if (CASSANDRA_DEPS.some((d) => deps.has(d))) {
+        return 'cassandra';
+    }
+    // ClickHouse
+    if (CLICKHOUSE_DEPS.some((d) => deps.has(d))) {
+        return 'clickhouse';
+    }
+    // HBase
+    if (HBASE_DEPS.some((d) => deps.has(d))) {
+        return 'hbase';
+    }
+    return null;
+}
+//# sourceMappingURL=widecolumn-db-detector.js.map

package/dist/engine/detectors/widecolumn-db-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widecolumn-db-detector.js","sourceRoot":"","sources":["../../../src/engine/detectors/widecolumn-db-detector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,kBAAkB,EAAE,eAAe,CAAC,CAAC;AACtE,MAAM,cAAc,GAAG;IACrB,kBAAkB;IAClB,sBAAsB;IACtB,WAAW;IACX,UAAU;IACV,OAAO;CACR,CAAC;AACF,MAAM,eAAe,GAAG;IACtB,oBAAoB;IACpB,oBAAoB;IACpB,YAAY;IACZ,mBAAmB;IACnB,eAAe;CAChB,CAAC;AACF,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;AAE9E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAC1D,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEpD,oDAAoD;IACpD,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,YAAY;IACZ,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,aAAa;IACb,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,QAAQ;IACR,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/engine/doc-generator/arch-api-user-generators.d.ts

@@ -0,0 +1,5 @@
+import type { GeneratedDocument, ProjectKnowledge, Spec } from '../../types/index.js';
+export declare function generateArchitectureDoc(knowledge: ProjectKnowledge, _language: string): GeneratedDocument;
+export declare function generateApiReference(knowledge: ProjectKnowledge, specs: Spec[], _language: string): GeneratedDocument;
+export declare function generateUserGuide(knowledge: ProjectKnowledge, specs: Spec[], _language: string): GeneratedDocument;
+//# sourceMappingURL=arch-api-user-generators.d.ts.map

package/dist/engine/doc-generator/arch-api-user-generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-api-user-generators.d.ts","sourceRoot":"","sources":["../../../src/engine/doc-generator/arch-api-user-generators.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iBAAiB,EAGjB,gBAAgB,EAChB,IAAI,EACL,MAAM,sBAAsB,CAAC;AAiD9B,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,gBAAgB,EAC3B,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAqDnB;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAyEnB;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,IAAI,EAAE,EACb,SAAS,EAAE,MAAM,GAChB,iBAAiB,CA4CnB"}