@promptci/core 0.0.1

package/dist/native-tool-preference.js.map

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

package/dist/output-verbosity.d.ts

@@ -0,0 +1,3 @@
+import type { InstructionFile, PromptCiIssue } from './types.js';
+export declare function detectOutputVerbosity(files: InstructionFile[]): PromptCiIssue[];
+//# sourceMappingURL=output-verbosity.d.ts.map

package/dist/output-verbosity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-verbosity.d.ts","sourceRoot":"","sources":["../src/output-verbosity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAiCjE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CA8D/E"}

package/dist/output-verbosity.js

@@ -0,0 +1,83 @@
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+/**
+ * B4: id was keyed by `${file.fileType}` — two files sharing a fileType (e.g.
+ * CLAUDE.md and .claude/notes.md, both 'claude') collided on the same id.
+ */
+function verbosityEncouragedIssueId(filePath) {
+    const hash = crypto.createHash('sha1').update(`cost-verbosity-encouraged:${filePath}`).digest('hex').slice(0, 12);
+    return `cost-verbosity-encouraged-${hash}`;
+}
+const VERBOSITY_ENCOURAGED_PATTERNS = [
+    /explain\s+everything\s+in\s+detail/i,
+    /explain\s+in\s+detail/i,
+    /always\s+include\s+full\s+command\s+output/i,
+    /provide\s+exhaustive\s+summaries/i,
+    /print\s+the\s+entire\s+report/i,
+    /include\s+all\s+logs/i,
+    /\b(?:provide|include|write|give)\s+(?:a\s+)?detailed\s+explanation\b/i,
+];
+const CONCISENESS_PATTERNS = [
+    /summarize\s+command/i,
+    /do\s+not\s+paste\s+(?:full\s+)?logs/i,
+    /keep\s+final\s+answers\s+concise/i,
+    /be\s+concise/i,
+    /brief\s+summary/i,
+    /only\s+key\s+failures/i,
+    /use\s+links\s+to\s+generated\s+artifacts/i,
+];
+export function detectOutputVerbosity(files) {
+    const issues = [];
+    const targetFiles = files.filter((f) => ['claude', 'agents', 'cursor', 'copilot', 'prompt'].includes(f.fileType));
+    if (targetFiles.length === 0) {
+        return [];
+    }
+    const combinedContent = targetFiles.map((f) => f.content).join('\n');
+    // 1. Check for verbosity encouraged (e.g. demanding full logs, verbose explanations)
+    for (const file of targetFiles) {
+        const fileName = path.basename(file.path);
+        const lines = file.content.split(/\r?\n/);
+        for (const line of lines) {
+            const matchesVerbosity = VERBOSITY_ENCOURAGED_PATTERNS.some((pat) => pat.test(line));
+            if (matchesVerbosity) {
+                // Exclude conditional debugging rules (e.g., "include logs when failing")
+                const isConditional = /fail|error|debug|crash|when\s+failing/i.test(line);
+                if (!isConditional) {
+                    issues.push({
+                        id: verbosityEncouragedIssueId(file.path),
+                        severity: 'warning',
+                        category: 'agent_practices',
+                        title: 'Verbose output behavior encouraged',
+                        summary: `The instruction file "${fileName}" encourages the agent to produce overly verbose outputs or print excessive logs, increasing output-token costs.`,
+                        filePaths: [file.path],
+                        locations: [],
+                        evidence: [`Matched verbose instruction line: "${line.trim()}"`],
+                        recommendation: 'Encourage concise status updates and final answers to reduce output token cost. Summarize logs and command results instead of pasting them in full.',
+                        fixRecipe: 'Replace verbosity demands with instructions like: "Be concise and summarize results, linking to files instead of printing them in full."',
+                        confidence: 0.85,
+                    });
+                    break; // one issue per file is enough
+                }
+            }
+        }
+    }
+    // 2. Check for missing conciseness guidelines
+    const hasConcisenessGuidelines = CONCISENESS_PATTERNS.some((pat) => pat.test(combinedContent));
+    if (!hasConcisenessGuidelines) {
+        issues.push({
+            id: 'cost-missing-verbosity-discipline',
+            severity: 'info',
+            category: 'agent_practices',
+            title: 'Missing output verbosity discipline',
+            summary: 'No conciseness or verbosity discipline guidelines found in instruction files. Verbose agents write redundant code dumps and explanations, bloating output tokens.',
+            filePaths: targetFiles.map((f) => f.path),
+            locations: [],
+            evidence: ['No guidelines found encouraging conciseness, log summarization, or artifact linking.'],
+            recommendation: 'Add guidance to keep answers concise, summarize command output, and link to files instead of pasting large content.',
+            fixRecipe: 'Add a section: "Summarize command results. Do not paste full logs unless requested. Keep final answers concise."',
+            confidence: 0.8,
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=output-verbosity.js.map

package/dist/output-verbosity.js.map

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

package/dist/product-boundary.d.ts

@@ -0,0 +1,11 @@
+import type { RepoContext } from './repo-context.js';
+import type { PromptCiIssue } from './types.js';
+/**
+ * Detects stale product-boundary instructions that contradict filesystem
+ * evidence of a feature already existing in the repo.
+ *
+ * One finding is emitted per (capability × file) regardless of how many
+ * contradictory patterns match in that file, to keep the report actionable.
+ */
+export declare function detectProductBoundary(context: RepoContext): PromptCiIssue[];
+//# sourceMappingURL=product-boundary.d.ts.map

package/dist/product-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"product-boundary.d.ts","sourceRoot":"","sources":["../src/product-boundary.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAmUhD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,EAAE,CAqC3E"}

package/dist/product-boundary.js

@@ -0,0 +1,301 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+/**
+ * Product-Boundary Drift Detector
+ *
+ * Detects when instruction files contain stale "X does not exist" or
+ * "do not build X" guidance that contradicts clear filesystem evidence of X
+ * already existing in the repo.
+ *
+ * Philosophy:
+ *  - Require STRONG filesystem evidence before flagging (multiple corroborating
+ *    signals where possible).
+ *  - Matched text from the instruction file is shown in evidence — the raw
+ *    regex source is never exposed to users.
+ *  - One finding per (capability × file), regardless of how many patterns match.
+ *  - Wording is cautious throughout ("appears to", "may be stale").
+ *
+ * Findings are heuristic — cautious wording is intentional.
+ */
+function issueId(key) {
+    const hash = crypto.createHash('sha1').update(key).digest('hex').slice(0, 12);
+    return `prod-bound-${hash}`;
+}
+// ── Filesystem helpers ────────────────────────────────────────────────────────
+/** Returns true when at least one of the repo-relative paths exists on disk. */
+function anyPathExists(repoRoot, relativePaths) {
+    return relativePaths.some((p) => fs.existsSync(path.join(repoRoot, p)));
+}
+const CAPABILITIES = [
+    // ── Web App ───────────────────────────────────────────────────────────────
+    {
+        name: 'Web App',
+        fsPaths: [
+            'apps/web',
+            'next.config.ts',
+            'next.config.js',
+            'next.config.mjs',
+            'next.config.cjs',
+        ],
+        depPrefixes: ['next'],
+        contradictoryPatterns: [
+            // "do not add web app" / "don't add web app"
+            /\b(?:do\s+not|don'?t)\s+add\s+(?:a\s+)?web\s+app\b/i,
+            // "no web app exists yet" / "no web app yet"
+            /\bno\s+web\s+app\s+(?:exists?\s+)?yet\b/i,
+            // "no web app" as a standalone factual claim (not "no web app logic" etc.)
+            /\bno\s+web\s+app\b(?!\s+(?:logic|code|component|route|page|specific))/i,
+            // "web app pending" / "web app not yet built"
+            /\bweb\s+app\s+(?:pending|not\s+(?:yet\s+)?(?:built|implemented|created))\b/i,
+        ],
+        severity: 'high',
+        title: 'Possible stale boundary: instruction appears to deny a web app that exists',
+        evidenceLabel: 'web app (apps/web or next.config.*)',
+        recommendation: 'Update the instruction file to reflect that the web app is now present. ' +
+            'Replace the stale non-goal statement with current guidance about the web app.',
+    },
+    // ── Supabase ──────────────────────────────────────────────────────────────
+    {
+        name: 'Supabase',
+        fsPaths: ['supabase/migrations', 'supabase'],
+        depPrefixes: ['@supabase/'],
+        contradictoryPatterns: [
+            /\bno\s+supabase\b/i,
+            /\bsupabase\s+(?:pending|not\s+(?:yet\s+)?(?:set\s+up|configured|added|integrated))\b/i,
+            /\bno\s+(?:supabase\s+)?(?:database|db)\s+yet\b/i,
+        ],
+        severity: 'high',
+        title: 'Possible stale boundary: instruction appears to deny Supabase that is configured',
+        evidenceLabel: 'Supabase (supabase/ directory or @supabase/* dependency)',
+        recommendation: 'Update the instruction file to reflect that Supabase is now configured. ' +
+            'Replace the stale non-goal statement with current guidance about the database.',
+    },
+    // ── Database ──────────────────────────────────────────────────────────────
+    {
+        name: 'Database',
+        fsPaths: ['supabase/migrations', 'drizzle', 'prisma', 'prisma/schema.prisma'],
+        depPrefixes: ['drizzle-orm', 'prisma', '@prisma/'],
+        contradictoryPatterns: [
+            /\bno\s+database\b/i,
+            /\bdatabase\s+pending\b/i,
+            /\bno\s+db\b/i,
+            /\bwithout\s+a\s+database\b/i,
+        ],
+        severity: 'high',
+        title: 'Possible stale boundary: instruction appears to deny a database that exists',
+        evidenceLabel: 'database schema/migrations (supabase/migrations, drizzle, or prisma)',
+        recommendation: 'Update the instruction file to reflect the current database setup. ' +
+            'Replace the stale non-goal statement with current guidance about data access.',
+    },
+    // ── Dashboard ─────────────────────────────────────────────────────────────
+    {
+        name: 'Dashboard',
+        fsPaths: [
+            'apps/web/src/app/dashboard',
+            'apps/web/src/app/(dashboard)',
+            'apps/web/src/app/api/upload/route.ts',
+            'src/app/dashboard',
+            'src/app/(dashboard)',
+            'app/dashboard',
+            'app/(dashboard)',
+            'src/pages/dashboard',
+            'pages/dashboard',
+        ],
+        contradictoryPatterns: [
+            /\bdashboard\s+(?:pending|not\s+(?:yet\s+)?(?:built|implemented|created|started))\b/i,
+            /\bno\s+dashboard\b/i,
+            /\bdashboard\s+does\s+not\s+exist\b/i,
+        ],
+        severity: 'warning',
+        title: 'Possible stale boundary: instruction appears to deny a dashboard that exists',
+        evidenceLabel: 'dashboard routes (apps/web/src/app/dashboard or upload API route)',
+        recommendation: 'Update the instruction file to reflect that the dashboard is now implemented.',
+    },
+    // ── Upload API ────────────────────────────────────────────────────────────
+    {
+        name: 'Upload API',
+        fsPaths: [
+            'apps/web/src/app/api/upload/route.ts',
+            'apps/web/src/app/api/upload',
+            'src/app/api/upload/route.ts',
+            'src/app/api/upload',
+            'app/api/upload/route.ts',
+            'app/api/upload',
+            'pages/api/upload.ts',
+        ],
+        contradictoryPatterns: [
+            /\bupload\s+not\s+(?:yet\s+)?implemented\b/i,
+            /\bno\s+upload\s+(?:route|api|endpoint)\b/i,
+            /\bupload\s+(?:api|route|endpoint)\s+(?:pending|does\s+not\s+exist)\b/i,
+        ],
+        severity: 'warning',
+        title: 'Possible stale boundary: instruction appears to deny an upload API that exists',
+        evidenceLabel: 'upload API route (apps/web/src/app/api/upload/route.ts)',
+        recommendation: 'Update the instruction file to reflect that the upload API is implemented. ' +
+            'Document what data is uploaded and any relevant security guidance.',
+    },
+    // ── Playwright / E2E ──────────────────────────────────────────────────────
+    {
+        name: 'Playwright/E2E',
+        fsPaths: [
+            'playwright.config.ts',
+            'playwright.config.js',
+            'playwright.config.mjs',
+            'playwright.config.cjs',
+        ],
+        depPrefixes: ['@playwright/test'],
+        contradictoryPatterns: [
+            /\bno\s+(?:e2e|end.to.end)\s+tests?\b/i,
+            /\bno\s+playwright\b/i,
+            /\bplaywright\s+(?:pending|not\s+(?:yet\s+)?(?:set\s+up|configured|added))\b/i,
+        ],
+        severity: 'warning',
+        title: 'Possible stale boundary: instruction appears to deny E2E tests that are configured',
+        evidenceLabel: 'Playwright config (playwright.config.*)',
+        recommendation: 'Update the instruction file to include E2E testing guidance. ' +
+            'Document how to run Playwright tests and any relevant setup steps.',
+    },
+    // ── GitHub OAuth ──────────────────────────────────────────────────────────
+    {
+        name: 'GitHub OAuth',
+        fsPaths: [
+            'apps/web/src/app/auth',
+            'apps/web/src/app/api/auth',
+            'apps/web/src/app/(auth)',
+            'src/app/auth',
+            'src/app/api/auth',
+            'src/app/(auth)',
+            'app/auth',
+            'app/api/auth',
+            'app/(auth)',
+            'pages/api/auth',
+        ],
+        contradictoryPatterns: [
+            // PB1: exclude scoped prose like "no auth required for public
+            // endpoints" — that's a SCOPING statement about a specific route, not
+            // a claim that auth doesn't exist anywhere in the project. Without
+            // this exclusion, any repo with auth routes AND a scoped "no auth
+            // required" note anywhere would always get flagged.
+            /\bno\s+(?:github\s+)?(?:oauth|auth(?:entication)?)\b(?!\s+(?:is\s+)?(?:required|needed|necessary)\b)/i,
+            /\bauth(?:entication)?\s+(?:pending|not\s+(?:yet\s+)?(?:built|implemented|added))\b/i,
+            /\bno\s+login\b(?!\s+(?:is\s+)?(?:required|needed|necessary)\b)/i,
+        ],
+        severity: 'warning',
+        title: 'Possible stale boundary: instruction appears to deny auth that is implemented',
+        evidenceLabel: 'auth routes (apps/web/src/app/auth or apps/web/src/app/api/auth)',
+        recommendation: 'Update the instruction file to reflect that authentication is now implemented.',
+    },
+];
+// ── Capability presence check ─────────────────────────────────────────────────
+/**
+ * Returns true when the repo shows strong evidence of the capability, either
+ * via filesystem paths or via package.json dependencies.
+ */
+function capabilityIsPresent(cap, context) {
+    if (anyPathExists(context.repoRoot, cap.fsPaths))
+        return true;
+    if (cap.depPrefixes && cap.depPrefixes.length > 0) {
+        const allDeps = {
+            ...context.packageJson.dependencies,
+            ...context.packageJson.devDependencies,
+        };
+        return cap.depPrefixes.some((prefix) => Object.keys(allDeps).some((dep) => dep === prefix || dep.startsWith(prefix)));
+    }
+    return false;
+}
+// ── First-match evidence extraction ──────────────────────────────────────────
+/**
+ * PB2: strips fenced code blocks (``` or ~~~, matching fence char/length per
+ * CommonMark) and inline `code spans` before contradiction matching. Without
+ * this, a fenced example that QUOTES a contradictory phrase (e.g.
+ * documenting the OLD wording of a non-goal statement as a "before" example)
+ * was read as a live claim and flagged — the same class of bug fixed for
+ * vague-guidance.ts, stale-instructions.ts, and conflicts.ts.
+ */
+function stripCodeBlocks(text) {
+    const lines = text.split('\n');
+    const kept = [];
+    let inBlock = false;
+    let fenceChar = null;
+    let fenceLen = 0;
+    for (const line of lines) {
+        if (!inBlock) {
+            const openMatch = /^ {0,3}([`~]{3,})/.exec(line);
+            if (openMatch) {
+                inBlock = true;
+                fenceChar = openMatch[1][0] ?? null;
+                fenceLen = openMatch[1].length;
+                continue;
+            }
+            kept.push(line);
+        }
+        else {
+            const closeMatch = /^ {0,3}([`~]{3,})\s*$/.exec(line);
+            if (closeMatch && closeMatch[1][0] === fenceChar && closeMatch[1].length >= fenceLen) {
+                inBlock = false;
+                fenceChar = null;
+                fenceLen = 0;
+            }
+            // else: still inside the fence — drop the line
+        }
+    }
+    return kept.join('\n').replace(/`[^`\n]+`/g, '');
+}
+/**
+ * Finds the first contradictory phrase in `content` and returns the matched
+ * text (the actual instruction wording), or undefined if none match.
+ */
+function findFirstContradiction(content, patterns) {
+    for (const pattern of patterns) {
+        // Use a fresh non-global copy to find the first match position
+        const re = new RegExp(pattern.source, pattern.flags.replace('g', ''));
+        const m = re.exec(content);
+        if (m)
+            return { pattern, matched: m[0] };
+    }
+    return undefined;
+}
+// ── Public detector ───────────────────────────────────────────────────────────
+/**
+ * Detects stale product-boundary instructions that contradict filesystem
+ * evidence of a feature already existing in the repo.
+ *
+ * One finding is emitted per (capability × file) regardless of how many
+ * contradictory patterns match in that file, to keep the report actionable.
+ */
+export function detectProductBoundary(context) {
+    const issues = [];
+    const { repoRoot, files } = context;
+    for (const cap of CAPABILITIES) {
+        if (!capabilityIsPresent(cap, context))
+            continue;
+        // Collect all existing evidence paths for the finding
+        const existingPaths = cap.fsPaths.filter((p) => fs.existsSync(path.join(repoRoot, p)));
+        const evidencePaths = existingPaths.length > 0 ? existingPaths : [cap.evidenceLabel];
+        for (const file of files) {
+            const contradiction = findFirstContradiction(stripCodeBlocks(file.content), cap.contradictoryPatterns);
+            if (!contradiction)
+                continue;
+            issues.push({
+                id: issueId(`${cap.name}:${file.path}`),
+                severity: cap.severity,
+                category: 'stale_instruction',
+                title: cap.title,
+                summary: `The instruction file appears to contain a stale product-boundary statement ` +
+                    `that contradicts ${cap.evidenceLabel} found in the repository. ` +
+                    `The phrase "${contradiction.matched}" may no longer reflect the current state of the project.`,
+                filePaths: [file.path],
+                locations: [{ filePath: file.path }],
+                evidence: [
+                    `Contradictory phrase found: "${contradiction.matched}"`,
+                    `Repository evidence: ${evidencePaths.join(', ')}`,
+                ],
+                recommendation: cap.recommendation,
+                confidence: 0.85,
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=product-boundary.js.map

package/dist/product-boundary.js.map

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

package/dist/project-type.d.ts

@@ -0,0 +1,15 @@
+import type { InstructionFile, ProjectType } from './types.js';
+/**
+ * Detect the primary project type for a repo at repoRoot.
+ * Detection order: nextjs → typescript → unity → dotnet → unknown
+ */
+export declare function detectProjectType(repoRoot: string): Promise<ProjectType>;
+/**
+ * Content-based project type detection — used as a fallback when the file-system
+ * scan returns 'unknown' (e.g. repos that only contain instruction files, no source).
+ * Checks the combined content of all scanned instruction files for strong signals.
+ *
+ * Detection order: nextjs → unity → typescript → dotnet → python → go → rust → unknown
+ */
+export declare function detectProjectTypeFromContent(files: InstructionFile[]): ProjectType;
+//# sourceMappingURL=project-type.d.ts.map

package/dist/project-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-type.d.ts","sourceRoot":"","sources":["../src/project-type.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAoB/D;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA4D9E;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,WAAW,CA0BlF"}

package/dist/project-type.js

@@ -0,0 +1,116 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import fg from 'fast-glob';
+async function exists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function dirExists(p) {
+    try {
+        const stat = await fs.stat(p);
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect the primary project type for a repo at repoRoot.
+ * Detection order: nextjs → typescript → unity → dotnet → unknown
+ */
+export async function detectProjectType(repoRoot) {
+    const root = path.resolve(repoRoot);
+    // ── Next.js ──────────────────────────────────────────────────────────────
+    // next.config.* exists OR (app/ or pages/ alongside package.json)
+    const nextConfigGlob = await fg('next.config.*', {
+        cwd: root,
+        dot: false,
+        followSymbolicLinks: false,
+        deep: 1,
+    });
+    if (nextConfigGlob.length > 0)
+        return 'nextjs';
+    const hasPkgJson = await exists(path.join(root, 'package.json'));
+    if (hasPkgJson) {
+        const hasApp = await dirExists(path.join(root, 'app'));
+        const hasPages = await dirExists(path.join(root, 'pages'));
+        if (hasApp || hasPages)
+            return 'nextjs';
+    }
+    // ── TypeScript ───────────────────────────────────────────────────────────
+    // package.json or tsconfig.json present
+    const hasTsConfig = await exists(path.join(root, 'tsconfig.json'));
+    if (hasPkgJson || hasTsConfig)
+        return 'typescript';
+    // ── Unity ────────────────────────────────────────────────────────────────
+    // Assets/ directory AND ProjectSettings/ProjectVersion.txt both exist
+    const hasAssets = await dirExists(path.join(root, 'Assets'));
+    const hasProjectVersion = await exists(path.join(root, 'ProjectSettings', 'ProjectVersion.txt'));
+    if (hasAssets && hasProjectVersion)
+        return 'unity';
+    // ── .NET ─────────────────────────────────────────────────────────────────
+    // any .sln or .csproj file at repo root level
+    const dotnetFiles = await fg(['*.sln', '*.csproj'], {
+        cwd: root,
+        dot: false,
+        followSymbolicLinks: false,
+        deep: 1,
+    });
+    if (dotnetFiles.length > 0)
+        return 'dotnet';
+    // ── Python ───────────────────────────────────────────────────────────────
+    const hasPyProject = await exists(path.join(root, 'pyproject.toml'));
+    const hasRequirements = await exists(path.join(root, 'requirements.txt'));
+    const hasPipfile = await exists(path.join(root, 'Pipfile'));
+    const hasConda = await exists(path.join(root, 'environment.yml'));
+    const hasSetupPy = await exists(path.join(root, 'setup.py'));
+    if (hasPyProject || hasRequirements || hasPipfile || hasConda || hasSetupPy)
+        return 'python';
+    // ── Go ───────────────────────────────────────────────────────────────────
+    const hasGoMod = await exists(path.join(root, 'go.mod'));
+    if (hasGoMod)
+        return 'go';
+    // ── Rust ─────────────────────────────────────────────────────────────────
+    const hasCargoToml = await exists(path.join(root, 'Cargo.toml'));
+    if (hasCargoToml)
+        return 'rust';
+    return 'unknown';
+}
+/**
+ * Content-based project type detection — used as a fallback when the file-system
+ * scan returns 'unknown' (e.g. repos that only contain instruction files, no source).
+ * Checks the combined content of all scanned instruction files for strong signals.
+ *
+ * Detection order: nextjs → unity → typescript → dotnet → python → go → rust → unknown
+ */
+export function detectProjectTypeFromContent(files) {
+    const combined = files.map((f) => f.content).join('\n');
+    if (/\bnext\.?js\b|\bapp\s+router\b|\bpages?\s+router\b|\bnext\s+build\b|\bnext\s+dev\b/i.test(combined)) {
+        return 'nextjs';
+    }
+    if ((/\bunity\b/i.test(combined) && /\b(lts|editor|hub|engine)\b/i.test(combined)) || /\bmonobehaviour\b|\bunityengine\b|\bgameobject\b|\bprefab\b|\bscriptableobject\b/i.test(combined)) {
+        return 'unity';
+    }
+    if (/\btypescript\b|\btsconfig\b|\btsc\s|\bpnpm\b|\bnpm\s+run\b|\bvitest\b|\bjest\b/i.test(combined)) {
+        return 'typescript';
+    }
+    if (/\bdotnet\b|\.sln\b|\.csproj\b|\bxunit\b|\bnunit\b|\bmstest\b/i.test(combined)) {
+        return 'dotnet';
+    }
+    if (/\bpython\b|\bpip\b|\bpoetry\b|\bvenv\b|\bpytest\b|\bpyproject\.toml\b/i.test(combined)) {
+        return 'python';
+    }
+    if (/\bgo\.mod\b|\bgo\s+(build|test|run|get|mod)\b|\bgolang\b/i.test(combined)) {
+        return 'go';
+    }
+    if (/\bcargo\.toml\b|\bcargo\s+(build|test|run|clippy|fmt)\b|\brustc\b/i.test(combined)) {
+        return 'rust';
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=project-type.js.map

package/dist/project-type.js.map

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

package/dist/prompt-cache.d.ts

@@ -0,0 +1,3 @@
+import type { InstructionFile, PromptCiIssue } from './types.js';
+export declare function detectPromptCacheFriendliness(files: InstructionFile[]): PromptCiIssue[];
+//# sourceMappingURL=prompt-cache.d.ts.map

package/dist/prompt-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cache.d.ts","sourceRoot":"","sources":["../src/prompt-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAqCjE,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CAiIvF"}