@lakindu_perera/toren 1.0.7 → 1.0.9

package/dist/detectors/health-detector.js

@@ -0,0 +1,53 @@
+export function detectHealth({ flatFiles, configs, importantFiles, scripts, projectType }) {
+    const health = [];
+    const fileSet = new Set(flatFiles);
+    // README
+    if (fileSet.has('README.md') || fileSet.has('README') || fileSet.has('readme.md')) {
+        health.push({ id: 'readme', status: 'pass', message: 'README found' });
+    }
+    else {
+        health.push({ id: 'readme', status: 'warning', message: 'README not found' });
+    }
+    // LICENSE
+    if (fileSet.has('LICENSE') || fileSet.has('LICENSE.md') || fileSet.has('LICENSE.txt')) {
+        health.push({ id: 'license', status: 'pass', message: 'LICENSE found' });
+    }
+    else {
+        health.push({ id: 'license', status: 'warning', message: 'LICENSE not found' });
+    }
+    // ENVIRONMENT EXAMPLE
+    if (fileSet.has('.env.example') || fileSet.has('.env.sample')) {
+        health.push({ id: 'env-example', status: 'pass', message: 'Environment example found' });
+    }
+    // TESTS
+    const hasTestFiles = flatFiles.some(f => f.startsWith('test/') ||
+        f.startsWith('tests/') ||
+        f.startsWith('__tests__/') ||
+        f.includes('.test.') ||
+        f.includes('.spec.'));
+    const hasTestScripts = (scripts || []).some(s => s.category === 'testing' || s.name === 'test');
+    if (hasTestFiles || hasTestScripts) {
+        health.push({ id: 'tests', status: 'pass', message: 'Tests detected' });
+    }
+    // LINTER
+    const hasLinter = (configs || []).some(c => c.includes('eslint') ||
+        c.includes('biome') ||
+        c.includes('stylelint')) || (scripts || []).some(s => s.category === 'quality' || s.name === 'lint');
+    if (hasLinter) {
+        health.push({ id: 'lint', status: 'pass', message: 'Linter detected' });
+    }
+    // TYPESCRIPT
+    if (fileSet.has('tsconfig.json')) {
+        health.push({ id: 'typescript', status: 'pass', message: 'TypeScript configuration found' });
+    }
+    // GIT
+    if (fileSet.has('.gitignore')) {
+        health.push({ id: 'git', status: 'info', message: '.gitignore found' });
+    }
+    // DOCKER
+    if (fileSet.has('Dockerfile') || fileSet.has('docker-compose.yml') || fileSet.has('compose.yml')) {
+        health.push({ id: 'docker', status: 'info', message: 'Docker configuration found' });
+    }
+    return { health };
+}
+//# sourceMappingURL=health-detector.js.map

package/dist/detectors/health-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-detector.js","sourceRoot":"","sources":["../../src/detectors/health-detector.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,YAAY,CAAC,EAC3B,SAAS,EACT,OAAO,EACP,cAAc,EACd,OAAO,EACP,WAAW,EACS;IACpB,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAEnC,SAAS;IACT,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAClF,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IACzE,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,UAAU;IACV,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QACtF,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;IAC3E,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,sBAAsB;IACtB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,QAAQ;IACR,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACtC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;QACrB,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;QACtB,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC;QAC1B,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CACrB,CAAC;IACF,MAAM,cAAc,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAChG,IAAI,YAAY,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,SAAS;IACT,MAAM,SAAS,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CACzC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACnB,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CACxB,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAC9E,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,aAAa;IACb,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM;IACN,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,SAAS;IACT,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;QACjG,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/detectors/important-files-detector.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Toren — Important File Detector
+ *
+ * Identifies the most strategically significant files in a project, based
+ * on the already-scanned flat file list and detected project context.
+ *
+ * Design contract:
+ *  - Pure function. Uses only the data already produced by scan().
+ *  - No filesystem I/O. No directory traversal.
+ *  - Deterministic: same input always produces the same output.
+ *  - No duplicates: each path appears at most once (highest priority wins).
+ *  - Sorted: highest priority first; ties broken alphabetically by path.
+ *  - Never returns null; importantFiles is always an array.
+ *  - Framework-specific files are only marked important when they exist.
+ *
+ * Priority anchors:
+ *  100 – Project manifest (package.json, pom.xml, Cargo.toml, …)
+ *   95 – Primary documentation (README.md)
+ *   90 – Primary detected entry point
+ *   85 – Framework configuration (next.config.*, vite.config.*, …)
+ *   82 – App-level framework files (root layout, root page, …)
+ *   80 – Environment documentation (.env.example)
+ *   78 – Secondary framework files (middleware, server entry)
+ *   75 – TypeScript / language config
+ *   72 – Project-specific config (routes, config/application)
+ *   70 – Container (Dockerfile)
+ *   68 – Container orchestration (docker-compose)
+ *
+ * @module detectors/important-files-detector
+ */
+/**
+ * Detect strategically important files in a scanned project.
+ *
+ * Uses only data already produced by scan() — no new filesystem operations.
+ *
+ * @param {Object}   params
+ * @param {string[]} params.flatFiles    - All relative POSIX file paths from the scanner
+ * @param {string}   params.projectType  - Detected project type (e.g. 'React', 'Go')
+ * @param {string[]} params.entryPoints  - Detected entry point paths
+ * @param {string[]} params.configs      - Detected configuration file paths
+ * @returns {{ importantFiles: ImportantFile[] }}
+ */
+import type { ImportantFile } from "../types/index.js";
+export declare function detectImportantFiles({ flatFiles, projectType, entryPoints, configs }: {
+    flatFiles: string[];
+    projectType: string;
+    entryPoints: string[];
+    configs: string[];
+}): {
+    importantFiles: ImportantFile[];
+};

package/dist/detectors/important-files-detector.js

@@ -0,0 +1,455 @@
+/**
+ * @fileoverview Toren — Important File Detector
+ *
+ * Identifies the most strategically significant files in a project, based
+ * on the already-scanned flat file list and detected project context.
+ *
+ * Design contract:
+ *  - Pure function. Uses only the data already produced by scan().
+ *  - No filesystem I/O. No directory traversal.
+ *  - Deterministic: same input always produces the same output.
+ *  - No duplicates: each path appears at most once (highest priority wins).
+ *  - Sorted: highest priority first; ties broken alphabetically by path.
+ *  - Never returns null; importantFiles is always an array.
+ *  - Framework-specific files are only marked important when they exist.
+ *
+ * Priority anchors:
+ *  100 – Project manifest (package.json, pom.xml, Cargo.toml, …)
+ *   95 – Primary documentation (README.md)
+ *   90 – Primary detected entry point
+ *   85 – Framework configuration (next.config.*, vite.config.*, …)
+ *   82 – App-level framework files (root layout, root page, …)
+ *   80 – Environment documentation (.env.example)
+ *   78 – Secondary framework files (middleware, server entry)
+ *   75 – TypeScript / language config
+ *   72 – Project-specific config (routes, config/application)
+ *   70 – Container (Dockerfile)
+ *   68 – Container orchestration (docker-compose)
+ *
+ * @module detectors/important-files-detector
+ */
+// ---------------------------------------------------------------------------
+// Types (JSDoc — no TypeScript dependency required)
+// ---------------------------------------------------------------------------
+/**
+ * @typedef {Object} ImportantFile
+ * @property {string} path     - POSIX relative path from the project root
+ * @property {string} type     - Semantic role: 'manifest' | 'documentation' |
+ *                               'entry-point' | 'configuration' | 'environment' |
+ *                               'container' | 'utility'
+ * @property {string} reason   - Human-readable explanation of why this file matters
+ * @property {number} priority - Sort weight; higher = more important
+ */
+// ---------------------------------------------------------------------------
+// Static candidate tables — files important for every project type
+// ---------------------------------------------------------------------------
+/**
+ * Files that are generically important regardless of project type.
+ * Each entry is included only if the file actually exists in flatFiles.
+ *
+ * @type {ImportantFile[]}
+ */
+const GENERIC_CANDIDATES = [
+    // ── Package manager manifests ─────────────────────────────────────────────
+    {
+        path: 'package.json',
+        type: 'manifest',
+        reason: 'Defines dependencies, scripts, and project metadata',
+        priority: 100,
+    },
+    // ── Primary documentation ─────────────────────────────────────────────────
+    {
+        path: 'README.md',
+        type: 'documentation',
+        reason: 'Primary project documentation',
+        priority: 95,
+    },
+    {
+        path: 'README',
+        type: 'documentation',
+        reason: 'Primary project documentation',
+        priority: 95,
+    },
+    // ── Environment documentation ─────────────────────────────────────────────
+    {
+        path: '.env.example',
+        type: 'environment',
+        reason: 'Documents required environment variables',
+        priority: 80,
+    },
+    {
+        path: '.env.sample',
+        type: 'environment',
+        reason: 'Documents required environment variables',
+        priority: 80,
+    },
+    // ── TypeScript ────────────────────────────────────────────────────────────
+    {
+        path: 'tsconfig.json',
+        type: 'configuration',
+        reason: 'TypeScript compiler configuration',
+        priority: 75,
+    },
+    // ── Container ─────────────────────────────────────────────────────────────
+    {
+        path: 'Dockerfile',
+        type: 'container',
+        reason: 'Container build configuration',
+        priority: 70,
+    },
+    {
+        path: 'docker-compose.yml',
+        type: 'container',
+        reason: 'Multi-container Docker configuration',
+        priority: 68,
+    },
+    {
+        path: 'docker-compose.yaml',
+        type: 'container',
+        reason: 'Multi-container Docker configuration',
+        priority: 68,
+    },
+];
+/**
+ * Non-JS project manifests — same role as package.json for their ecosystems.
+ * Checked unconditionally because they might be present in polyglot repos.
+ *
+ * @type {ImportantFile[]}
+ */
+const ECOSYSTEM_MANIFESTS = [
+    {
+        path: 'pom.xml',
+        type: 'manifest',
+        reason: 'Maven project descriptor and dependency manifest',
+        priority: 100,
+    },
+    {
+        path: 'build.gradle',
+        type: 'manifest',
+        reason: 'Gradle build script and dependency manifest',
+        priority: 100,
+    },
+    {
+        path: 'build.gradle.kts',
+        type: 'manifest',
+        reason: 'Gradle Kotlin DSL build script',
+        priority: 100,
+    },
+    {
+        path: 'Cargo.toml',
+        type: 'manifest',
+        reason: 'Rust package manifest and dependency configuration',
+        priority: 100,
+    },
+    {
+        path: 'composer.json',
+        type: 'manifest',
+        reason: 'PHP Composer dependency manifest',
+        priority: 100,
+    },
+    {
+        path: 'Gemfile',
+        type: 'manifest',
+        reason: 'Ruby gem dependency manifest',
+        priority: 100,
+    },
+    {
+        path: 'go.mod',
+        type: 'manifest',
+        reason: 'Go module definition and dependency manifest',
+        priority: 100,
+    },
+    {
+        path: 'pyproject.toml',
+        type: 'manifest',
+        reason: 'Python project configuration and dependency manifest',
+        priority: 100,
+    },
+    {
+        path: 'requirements.txt',
+        type: 'manifest',
+        reason: 'Python runtime dependency list',
+        priority: 95,
+    },
+];
+// ---------------------------------------------------------------------------
+// Pattern-matching helpers (no filesystem access — operate on flatFiles array)
+// ---------------------------------------------------------------------------
+/**
+ * Push a candidate entry if the exact path exists in the file set.
+ *
+ * @param {ImportantFile[]} out
+ * @param {Set<string>}     fileSet
+ * @param {string}          filePath
+ * @param {string}          type
+ * @param {string}          reason
+ * @param {number}          priority
+ */
+function addExact(out, fileSet, filePath, type, reason, priority) {
+    if (fileSet.has(filePath)) {
+        out.push({ path: filePath, type, reason, priority });
+    }
+}
+/**
+ * Push candidates for all files whose path starts with the given prefix.
+ * Used for patterns like 'vite.config.' (matches vite.config.js, .ts, .mjs …).
+ *
+ * @param {ImportantFile[]} out
+ * @param {string[]}        flatFiles
+ * @param {string}          prefix      - e.g. 'vite.config.'
+ * @param {string}          type
+ * @param {string}          reason
+ * @param {number}          priority
+ */
+function addPrefix(out, flatFiles, prefix, type, reason, priority) {
+    for (const f of flatFiles) {
+        if (f.startsWith(prefix)) {
+            out.push({ path: f, type, reason, priority });
+        }
+    }
+}
+/**
+ * Push candidates for all files whose path ends with the given suffix.
+ * Used for patterns like '*Application.java' (matches any depth).
+ *
+ * @param {ImportantFile[]} out
+ * @param {string[]}        flatFiles
+ * @param {string}          suffix      - e.g. 'Application.java'
+ * @param {string}          type
+ * @param {string}          reason
+ * @param {number}          priority
+ */
+function addSuffix(out, flatFiles, suffix, type, reason, priority) {
+    for (const f of flatFiles) {
+        if (f.endsWith(suffix)) {
+            out.push({ path: f, type, reason, priority });
+        }
+    }
+}
+/**
+ * Push candidates for root-level files matching `stem.*`.
+ * "Root-level" means the path contains no '/' after the stem.
+ * Used for patterns like 'server.*', 'app.*' (root only, not src/server.*).
+ *
+ * @param {ImportantFile[]} out
+ * @param {string[]}        flatFiles
+ * @param {string}          stem        - e.g. 'server.' (note trailing dot)
+ * @param {string}          type
+ * @param {string}          reason
+ * @param {number}          priority
+ */
+function addRootPrefix(out, flatFiles, stem, type, reason, priority) {
+    for (const f of flatFiles) {
+        // Must start with stem AND have no directory separator in the remainder
+        if (f.startsWith(stem) && !f.slice(stem.length).includes('/')) {
+            out.push({ path: f, type, reason, priority });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Project-specific candidate builder
+// ---------------------------------------------------------------------------
+/**
+ * Return framework-specific candidates based on detected project type.
+ * Only files that exist in flatFiles are included (checked by callers via
+ * addExact/addPrefix/addSuffix/addRootPrefix).
+ *
+ * @param {string}   projectType  - From ScanResult.projectType
+ * @param {string[]} flatFiles    - All scanned file paths
+ * @param {Set<string>} fileSet   - flatFiles as Set for O(1) lookup
+ * @returns {ImportantFile[]}
+ */
+function getProjectCandidates(projectType, flatFiles, fileSet) {
+    const out = [];
+    const pt = projectType.toLowerCase();
+    // ── Framework build configs (apply to many ecosystems) ───────────────────
+    addPrefix(out, flatFiles, 'vite.config.', 'configuration', 'Vite build and development configuration', 85);
+    addPrefix(out, flatFiles, 'webpack.config.', 'configuration', 'Webpack bundler configuration', 85);
+    // ── Next.js ───────────────────────────────────────────────────────────────
+    if (pt.includes('next')) {
+        // Framework config
+        for (const f of ['next.config.js', 'next.config.mjs', 'next.config.ts']) {
+            addExact(out, fileSet, f, 'configuration', 'Next.js framework configuration', 85);
+        }
+        // App Router
+        for (const ext of ['js', 'jsx', 'ts', 'tsx']) {
+            addExact(out, fileSet, `app/layout.${ext}`, 'entry-point', 'Root layout for the Next.js App Router', 82);
+            addExact(out, fileSet, `app/page.${ext}`, 'entry-point', 'Root page for the Next.js App Router', 81);
+        }
+        // Edge middleware
+        for (const f of ['middleware.js', 'middleware.ts']) {
+            addExact(out, fileSet, f, 'configuration', 'Next.js edge middleware', 78);
+        }
+        // Pages Router
+        addPrefix(out, flatFiles, 'pages/index.', 'entry-point', 'Home page for the Next.js Pages Router', 78);
+    }
+    // ── Nuxt.js ───────────────────────────────────────────────────────────────
+    else if (pt.includes('nuxt')) {
+        for (const f of ['nuxt.config.js', 'nuxt.config.ts', 'nuxt.config.mjs']) {
+            addExact(out, fileSet, f, 'configuration', 'Nuxt.js framework configuration', 85);
+        }
+        for (const ext of ['js', 'vue', 'ts']) {
+            addExact(out, fileSet, `app.${ext}`, 'entry-point', 'Nuxt application root', 82);
+            addExact(out, fileSet, `pages/index.${ext}`, 'entry-point', 'Nuxt home page (Pages Router)', 78);
+        }
+    }
+    // ── React (Vite / CRA) ───────────────────────────────────────────────────
+    else if (pt.includes('react')) {
+        addPrefix(out, flatFiles, 'src/main.', 'entry-point', 'Application entry point', 82);
+        addPrefix(out, flatFiles, 'src/App.', 'entry-point', 'Root application component', 78);
+        // CRA fallback
+        addExact(out, fileSet, 'public/index.html', 'entry-point', 'Application HTML entry point', 76);
+    }
+    // ── Vue.js ────────────────────────────────────────────────────────────────
+    else if (pt.includes('vue')) {
+        for (const f of ['vue.config.js', 'vue.config.ts']) {
+            addExact(out, fileSet, f, 'configuration', 'Vue CLI configuration', 85);
+        }
+        addPrefix(out, flatFiles, 'src/main.', 'entry-point', 'Application entry point', 82);
+        addPrefix(out, flatFiles, 'src/App.', 'entry-point', 'Root application component', 78);
+    }
+    // ── Angular ───────────────────────────────────────────────────────────────
+    else if (pt.includes('angular')) {
+        addExact(out, fileSet, 'angular.json', 'configuration', 'Angular workspace configuration', 85);
+        addPrefix(out, flatFiles, 'src/main.', 'entry-point', 'Angular bootstrap entry point', 82);
+        addExact(out, fileSet, 'src/app/app.module.ts', 'entry-point', 'Angular root module', 80);
+        addExact(out, fileSet, 'src/app/app.component.ts', 'entry-point', 'Angular root component', 78);
+    }
+    // ── Svelte ────────────────────────────────────────────────────────────────
+    else if (pt.includes('svelte')) {
+        for (const f of ['svelte.config.js', 'svelte.config.ts']) {
+            addExact(out, fileSet, f, 'configuration', 'SvelteKit / Svelte configuration', 85);
+        }
+        addPrefix(out, flatFiles, 'src/routes/+page.', 'entry-point', 'SvelteKit home page route', 82);
+        addPrefix(out, flatFiles, 'src/main.', 'entry-point', 'Svelte application entry point', 80);
+        addPrefix(out, flatFiles, 'src/App.', 'entry-point', 'Svelte root component', 78);
+    }
+    // ── Express / Fastify / Koa (Node.js server frameworks) ──────────────────
+    else if (pt.includes('express') || pt.includes('fastify') || pt.includes('koa')) {
+        addRootPrefix(out, flatFiles, 'server.', 'entry-point', 'Server application entry point', 82);
+        addRootPrefix(out, flatFiles, 'app.', 'entry-point', 'Application entry point', 80);
+        addPrefix(out, flatFiles, 'src/server.', 'entry-point', 'Server application entry point', 80);
+        addPrefix(out, flatFiles, 'src/app.', 'entry-point', 'Application entry point', 78);
+        // Common conventions
+        addExact(out, fileSet, 'src/index.js', 'entry-point', 'Application entry point', 76);
+        addExact(out, fileSet, 'src/index.ts', 'entry-point', 'Application entry point', 76);
+    }
+    // ── Python ────────────────────────────────────────────────────────────────
+    if (pt.includes('python')) {
+        addExact(out, fileSet, 'main.py', 'entry-point', 'Main Python application entry point', 82);
+        addExact(out, fileSet, 'manage.py', 'entry-point', 'Django project management CLI', 82);
+        addExact(out, fileSet, 'app.py', 'entry-point', 'Flask / web framework application', 80);
+        addExact(out, fileSet, 'wsgi.py', 'configuration', 'WSGI server entry point', 75);
+        addExact(out, fileSet, 'asgi.py', 'configuration', 'ASGI server entry point', 75);
+    }
+    // ── Java / Spring Boot ────────────────────────────────────────────────────
+    if (pt.includes('java') || pt.includes('spring')) {
+        addExact(out, fileSet, 'pom.xml', 'manifest', 'Maven project descriptor and dependency manifest', 100);
+        addExact(out, fileSet, 'build.gradle', 'manifest', 'Gradle build script and dependency manifest', 100);
+        addExact(out, fileSet, 'build.gradle.kts', 'manifest', 'Gradle Kotlin DSL build script', 100);
+        addSuffix(out, flatFiles, 'Application.java', 'entry-point', 'Spring Boot application entry point', 82);
+        addSuffix(out, flatFiles, 'Application.kt', 'entry-point', 'Spring Boot Kotlin application entry point', 82);
+        // Main application properties
+        addExact(out, fileSet, 'src/main/resources/application.properties', 'configuration', 'Spring Boot application configuration', 78);
+        addExact(out, fileSet, 'src/main/resources/application.yml', 'configuration', 'Spring Boot application configuration', 78);
+    }
+    // ── Go ────────────────────────────────────────────────────────────────────
+    if (pt === 'go') {
+        addExact(out, fileSet, 'go.mod', 'manifest', 'Go module definition and dependency manifest', 100);
+        addExact(out, fileSet, 'go.sum', 'manifest', 'Go module checksums', 92);
+        addExact(out, fileSet, 'main.go', 'entry-point', 'Main Go application entry point', 82);
+        addExact(out, fileSet, 'Makefile', 'utility', 'Build and task automation', 72);
+    }
+    // ── Rust ──────────────────────────────────────────────────────────────────
+    if (pt.includes('rust')) {
+        addExact(out, fileSet, 'Cargo.toml', 'manifest', 'Rust package manifest and dependency configuration', 100);
+        addExact(out, fileSet, 'Cargo.lock', 'manifest', 'Rust dependency lockfile', 92);
+        addExact(out, fileSet, 'src/main.rs', 'entry-point', 'Binary crate entry point', 82);
+        addExact(out, fileSet, 'src/lib.rs', 'entry-point', 'Library crate root', 82);
+    }
+    // ── PHP / Laravel / Composer ──────────────────────────────────────────────
+    if (pt.includes('php') || pt.includes('composer')) {
+        addExact(out, fileSet, 'composer.json', 'manifest', 'PHP Composer dependency manifest', 100);
+        addExact(out, fileSet, 'artisan', 'utility', 'Laravel CLI tool', 82);
+        addExact(out, fileSet, 'routes/web.php', 'configuration', 'Web route definitions', 78);
+        addExact(out, fileSet, 'routes/api.php', 'configuration', 'API route definitions', 78);
+        addExact(out, fileSet, 'public/index.php', 'entry-point', 'HTTP front controller (Laravel / PHP)', 76);
+    }
+    // ── Ruby / Rails ──────────────────────────────────────────────────────────
+    if (pt.includes('ruby') || pt.includes('rails')) {
+        addExact(out, fileSet, 'Gemfile', 'manifest', 'Ruby gem dependency manifest', 100);
+        addExact(out, fileSet, 'config/routes.rb', 'configuration', 'Rails route definitions', 78);
+        addExact(out, fileSet, 'config/application.rb', 'configuration', 'Rails application configuration', 76);
+        addExact(out, fileSet, 'config/environment.rb', 'configuration', 'Rails environment bootstrap', 74);
+        addExact(out, fileSet, 'app/controllers/application_controller.rb', 'entry-point', 'Rails base application controller', 72);
+    }
+    // ── Elixir / Phoenix ─────────────────────────────────────────────────────
+    if (pt.includes('elixir') || pt.includes('phoenix')) {
+        addExact(out, fileSet, 'mix.exs', 'manifest', 'Elixir Mix build and dependency manifest', 100);
+        addExact(out, fileSet, 'mix.lock', 'manifest', 'Elixir Mix dependency lockfile', 92);
+        addPrefix(out, flatFiles, 'lib/', 'entry-point', 'Elixir application module', 75);
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Deduplication and sort
+// ---------------------------------------------------------------------------
+/**
+ * Merge a list of raw candidates into a deduplicated, sorted result.
+ * When the same path appears with different priorities, the highest wins.
+ * Ties in priority are broken by ascending alphabetical path order.
+ *
+ * @param {ImportantFile[]} rawCandidates
+ * @returns {ImportantFile[]}
+ */
+function deduplicateAndSort(rawCandidates) {
+    /** @type {Map<string, ImportantFile>} */
+    const best = new Map();
+    for (const candidate of rawCandidates) {
+        const existing = best.get(candidate.path);
+        if (!existing || candidate.priority > existing.priority) {
+            best.set(candidate.path, candidate);
+        }
+    }
+    return Array.from(best.values()).sort((a, b) => {
+        if (b.priority !== a.priority)
+            return b.priority - a.priority; // higher first
+        return a.path.localeCompare(b.path); // alpha on ties
+    });
+}
+export function detectImportantFiles({ flatFiles, projectType, entryPoints, configs }) {
+    const fileSet = new Set(flatFiles);
+    /** @type {ImportantFile[]} */
+    const raw = [];
+    // ── 1. Generic files (always check, any project type) ────────────────────
+    for (const candidate of GENERIC_CANDIDATES) {
+        if (fileSet.has(candidate.path)) {
+            raw.push({ ...candidate });
+        }
+    }
+    for (const candidate of ECOSYSTEM_MANIFESTS) {
+        if (fileSet.has(candidate.path)) {
+            raw.push({ ...candidate });
+        }
+    }
+    // ── 2. Primary entry point ────────────────────────────────────────────────
+    if (entryPoints.length > 0) {
+        const primary = entryPoints[0];
+        if (fileSet.has(primary)) {
+            raw.push({
+                path: primary,
+                type: 'entry-point',
+                reason: 'Primary application entry point',
+                priority: 90,
+            });
+        }
+    }
+    // ── 3. Project-specific candidates ───────────────────────────────────────
+    const projectCandidates = getProjectCandidates(projectType, flatFiles, fileSet);
+    for (const c of projectCandidates) {
+        raw.push(c);
+    }
+    // ── 4. Deduplicate, resolve priority conflicts, and sort ──────────────────
+    return { importantFiles: deduplicateAndSort(raw) };
+}
+//# sourceMappingURL=important-files-detector.js.map

package/dist/detectors/important-files-detector.js.map

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

package/dist/detectors/package-manager-detector.d.ts

@@ -0,0 +1,7 @@
+import type { PackageManager } from '../types/index.js';
+export interface PackageManagerResult {
+    packageManager: PackageManager | null;
+    packageManagers: PackageManager[];
+    ambiguous: boolean;
+}
+export declare function detectPackageManager(flatFiles: string[]): PackageManagerResult;

package/dist/detectors/package-manager-detector.js

@@ -0,0 +1,35 @@
+const LOCKFILE_MAP = new Map([
+    ['package-lock.json', 'npm'],
+    ['pnpm-lock.yaml', 'pnpm'],
+    ['yarn.lock', 'yarn'],
+    ['bun.lock', 'bun'],
+    ['bun.lockb', 'bun'],
+]);
+export function detectPackageManager(flatFiles) {
+    const detected = new Set();
+    for (const file of flatFiles) {
+        if (file.includes('/'))
+            continue;
+        const pm = LOCKFILE_MAP.get(file);
+        if (pm !== undefined) {
+            detected.add(pm);
+        }
+    }
+    const packageManagers = Array.from(detected).sort();
+    if (packageManagers.length === 0) {
+        return { packageManager: null, packageManagers: [], ambiguous: false };
+    }
+    if (packageManagers.length === 1) {
+        return {
+            packageManager: packageManagers[0],
+            packageManagers: packageManagers,
+            ambiguous: false,
+        };
+    }
+    return {
+        packageManager: null,
+        packageManagers: packageManagers,
+        ambiguous: true,
+    };
+}
+//# sourceMappingURL=package-manager-detector.js.map

package/dist/detectors/package-manager-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager-detector.js","sourceRoot":"","sources":["../../src/detectors/package-manager-detector.ts"],"names":[],"mappings":"AAQA,MAAM,YAAY,GAAgC,IAAI,GAAG,CAAC;IACxD,CAAC,mBAAmB,EAAE,KAAK,CAAC;IAC5B,CAAC,gBAAgB,EAAK,MAAM,CAAC;IAC7B,CAAC,WAAW,EAAU,MAAM,CAAC;IAC7B,CAAC,UAAU,EAAW,KAAK,CAAC;IAC5B,CAAC,WAAW,EAAU,KAAK,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,SAAmB;IACtD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QAEjC,MAAM,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAEpD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACzE,CAAC;IAED,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;YAClC,eAAe,EAAE,eAAe;YAChC,SAAS,EAAE,KAAK;SACjB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,eAAe;QAChC,SAAS,EAAE,IAAI;KAChB,CAAC;AACJ,CAAC"}