@promptci/core 0.0.1

package/dist/frameworks/rust.js

@@ -0,0 +1,72 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+export function detectRust(context) {
+    const issues = [];
+    const { repoRoot, files } = context;
+    const hasCargoToml = fs.existsSync(path.join(repoRoot, 'Cargo.toml'));
+    const combinedContent = files.map(f => f.content).join('\n');
+    const hasRustMentions = /\bcargo\.toml\b|\bcargo\s+(build|test|run|clippy|fmt)\b/i.test(combinedContent);
+    if (!hasCargoToml && !hasRustMentions) {
+        return [];
+    }
+    const allFilePaths = files.map(f => f.path);
+    // 1. Missing cargo verification commands
+    const hasCargoCommands = /cargo\s+(test|clippy|fmt)/i.test(combinedContent);
+    if (!hasCargoCommands) {
+        issues.push({
+            id: 'rust-missing-verification-commands',
+            severity: 'warning',
+            category: 'structure',
+            title: 'Missing Rust Verification Commands',
+            summary: 'Rust project detected, but instructions do not mention Cargo verification commands like "cargo test" or "cargo clippy".',
+            filePaths: allFilePaths,
+            locations: [],
+            evidence: ['Rust detected, but no cargo test/clippy/fmt commands found in instructions.'],
+            recommendation: 'Add instructions telling the agent to run cargo test, cargo clippy, and cargo fmt to verify changes.',
+            fixRecipe: 'Before saying work is complete, verify changes by running cargo fmt, cargo clippy, and cargo test.',
+            confidence: 0.85,
+        });
+    }
+    // 2. MSRV check against Cargo.toml
+    let rustVersion;
+    if (hasCargoToml) {
+        try {
+            const cargoContent = fs.readFileSync(path.join(repoRoot, 'Cargo.toml'), 'utf-8');
+            const match = /^rust-version\s*=\s*["'](.*?)["']/m.exec(cargoContent);
+            if (match) {
+                rustVersion = match[1]?.trim();
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    if (rustVersion) {
+        const majorMinor = (version) => {
+            const match = /^(\d+)\.(\d+)/.exec(version);
+            return match ? `${match[1]}.${match[2]}` : undefined;
+        };
+        const rustVersionRe = /\bRust\s+(\d+\.\d+(?:\.\d+)?)\b/i;
+        const match = rustVersionRe.exec(combinedContent);
+        if (match) {
+            const instrVersion = match[1];
+            if (majorMinor(instrVersion) !== majorMinor(rustVersion)) {
+                issues.push({
+                    id: 'rust-version-mismatch',
+                    severity: 'warning',
+                    category: 'stale_instruction',
+                    title: 'Rust Version Mismatch',
+                    summary: `Instructions mention Rust version ${instrVersion}, but Cargo.toml specifies rust-version = "${rustVersion}".`,
+                    filePaths: allFilePaths,
+                    locations: [],
+                    evidence: [`Cargo.toml requires rust-version = ${rustVersion}; instructions mention Rust ${instrVersion}`],
+                    recommendation: `Update instructions to match the Rust version specified in Cargo.toml (${rustVersion}).`,
+                    fixRecipe: `Target Rust ${rustVersion} as the Minimum Supported Rust Version (MSRV) for this project.`,
+                    confidence: 0.8,
+                });
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=rust.js.map

package/dist/frameworks/rust.js.map

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

package/dist/frameworks/unity.d.ts

@@ -0,0 +1,4 @@
+import type { RepoContext } from '../repo-context.js';
+import type { PromptCiIssue } from '../types.js';
+export declare function detectUnity(context: RepoContext): PromptCiIssue[];
+//# sourceMappingURL=unity.d.ts.map

package/dist/frameworks/unity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unity.d.ts","sourceRoot":"","sources":["../../src/frameworks/unity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,EAAE,CA+EjE"}

package/dist/frameworks/unity.js

@@ -0,0 +1,74 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+export function detectUnity(context) {
+    const issues = [];
+    const { repoRoot, files } = context;
+    const hasAssets = fs.existsSync(path.join(repoRoot, 'Assets'));
+    const hasProjectVersion = fs.existsSync(path.join(repoRoot, 'ProjectSettings', 'ProjectVersion.txt'));
+    const combinedContent = files.map(f => f.content).join('\n');
+    const hasUnityMentions = /\bunity\b.*\b(lts|editor|hub|engine)\b|\bmonobehaviour\b|\bunityengine\b|\bgameobject\b|\bprefab\b|\bscriptableobject\b/i.test(combinedContent);
+    if (!(hasAssets && hasProjectVersion) && !hasUnityMentions) {
+        return [];
+    }
+    const allFilePaths = files.map(f => f.path);
+    // 1. MonoBehaviour lifecycle guidance
+    const hasMonoBehaviourGuidance = /monobehaviour\s+(?:lifecycle|guidance|rules?)|\blifecycle\s+(?:method|methods|guidance|rules?)|instantiate\b.*monobehaviour|avoid\b.*update|new\s+monobehaviour|awake\(\)|start\(\)|update\(\)/i.test(combinedContent);
+    if (!hasMonoBehaviourGuidance) {
+        issues.push({
+            id: 'unity-missing-monobehaviour-guidance',
+            severity: 'warning',
+            category: 'structure',
+            title: 'Missing Unity MonoBehaviour Lifecycle Guidance',
+            summary: 'Unity project detected, but instructions lack guidelines on MonoBehaviour lifecycle (e.g. not calling "new" on MonoBehaviours, avoiding empty Update methods).',
+            filePaths: allFilePaths,
+            locations: [],
+            evidence: ['Unity detected, but no MonoBehaviour lifecycle rules found in instructions.'],
+            recommendation: 'Add guidance warning never to use "new" to instantiate MonoBehaviours, and advising on efficient Update() / Awake() / Start() usage.',
+            fixRecipe: 'Do not instantiate MonoBehaviours using the "new" keyword; always use GameObject.AddComponent or Object.Instantiate. Avoid leaving empty Awake, Start, or Update methods in scripts as they still incur Unity lifecycle overhead.',
+            confidence: 0.8,
+        });
+    }
+    // 2. Serialization & Prefab Safety guidance
+    // FW2: bare 'prefab' also satisfies hasUnityMentions above — a file whose
+    // ONLY Unity signal is a passing mention of "prefab" (e.g. "we use prefabs
+    // for reusable components") would enable the pack AND simultaneously
+    // satisfy this guidance check with the exact same word, so the
+    // serialization/prefab-safety warning could never fire for that file. The
+    // bare word is removed here; "prefab" only counts as real GUIDANCE (not
+    // just a mention) when paired with a guidance-indicating term.
+    const hasSerializationGuidance = /\[serializefield\]|serializefield\b|prefab\s+(?:safety|workflow|guidance|rules?)|meta\s+file/i.test(combinedContent);
+    if (!hasSerializationGuidance) {
+        issues.push({
+            id: 'unity-missing-serialization-guidance',
+            severity: 'warning',
+            category: 'structure',
+            title: 'Missing Unity Serialization and Prefab Safety Guidance',
+            summary: 'Unity project detected, but instructions lack safety rules for Prefabs and [SerializeField] parameters.',
+            filePaths: allFilePaths,
+            locations: [],
+            evidence: ['Unity detected, but no SerializeField or prefab rules found in instructions.'],
+            recommendation: 'Add rules for using [SerializeField] for private variables to expose them in the inspector, and avoiding editing .meta files manually.',
+            fixRecipe: 'Use [SerializeField] to expose private fields in the Unity Inspector instead of making them public. Never manually edit or delete .meta files; let the Unity Editor manage them to prevent serialization breakages.',
+            confidence: 0.8,
+        });
+    }
+    // 3. Play Mode & Test Runner verification guidance
+    const hasTestRunnerGuidance = /play\s+mode|test\s+runner|unity\s+test/i.test(combinedContent);
+    if (!hasTestRunnerGuidance) {
+        issues.push({
+            id: 'unity-missing-test-guidance',
+            severity: 'info',
+            category: 'structure',
+            title: 'Missing Unity Play Mode and Test Runner Guidance',
+            summary: 'Unity project detected, but instructions do not guide agents to test changes in Play Mode or Unity Test Runner.',
+            filePaths: allFilePaths,
+            locations: [],
+            evidence: ['Unity detected, but no Play Mode/Test Runner verification found in instructions.'],
+            recommendation: 'Add instructions telling agents to run tests using Unity Test Runner or test changes in Play Mode.',
+            fixRecipe: 'Verify gameplay and UI changes by testing in the Unity Editor Play Mode or running Unity Test Runner (Window > General > Test Runner).',
+            confidence: 0.75,
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=unity.js.map

package/dist/frameworks/unity.js.map

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

package/dist/health-score.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Health score computation and top-fix selection for PromptCI.
+ *
+ * Both functions are pure and deterministic — no randomness, same output
+ * for the same input regardless of call order.
+ */
+import type { PromptCiIssue, TopFix } from './types.js';
+/**
+ * Compute a health score from 0–100 based on issue severity and confidence.
+ *
+ * Starts at 100. Each issue subtracts (severityWeight × confidence), subject to
+ * per-category caps so a single noisy detector cannot drive the score to zero on
+ * its own.
+ *
+ * Result is clamped to [0, 100] and rounded to the nearest integer.
+ */
+export declare function computeHealthScore(issues: PromptCiIssue[]): number;
+/**
+ * Classify the likely blast-radius impact of an issue.
+ */
+export declare function getIssueImpact(issue: PromptCiIssue): 'high' | 'medium' | 'low';
+/**
+ * Select up to 3 top fixes from the issue list.
+ *
+ * Priority order (descending):
+ *   1. Severity weight (critical → high → warning → info)
+ *   2. Confidence (higher first)
+ *   3. Blast-radius impact (high → medium → low)
+ *   4. Number of files affected (more files = higher priority)
+ *   5. Category string (alphabetical, for stable tie-breaking)
+ *   6. Issue id (alphabetical, final stable tie-breaker)
+ *
+ * At most one fix per category is included to keep top-fixes diverse and
+ * actionable — the highest-priority issue per category wins.
+ */
+export declare function selectTopFixes(issues: PromptCiIssue[]): TopFix[];
+//# sourceMappingURL=health-score.d.ts.map

package/dist/health-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-score.d.ts","sourceRoot":"","sources":["../src/health-score.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAwBtF;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAoBlE;AAQD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAiE9E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAuChE"}

package/dist/health-score.js

@@ -0,0 +1,164 @@
+/**
+ * Health score computation and top-fix selection for PromptCI.
+ *
+ * Both functions are pure and deterministic — no randomness, same output
+ * for the same input regardless of call order.
+ */
+const SEVERITY_WEIGHT = {
+    critical: 18,
+    high: 10,
+    warning: 4,
+    info: 1,
+};
+/**
+ * BUG-D1: Per-category maximum deduction caps.
+ *
+ * Without these, a repo with 30+ dead-reference warnings (structure category)
+ * accumulates >100 points of penalty and bottoms out at 0 even when all other
+ * detectors are clean. Caps prevent a single noisy category from dominating the
+ * score while still penalising repos that genuinely have many issues.
+ */
+const CATEGORY_DEDUCTION_CAP = {
+    structure: 30, // dead references
+    stale_instruction: 15,
+    duplicate: 20,
+    vague_guidance: 10,
+};
+/**
+ * Compute a health score from 0–100 based on issue severity and confidence.
+ *
+ * Starts at 100. Each issue subtracts (severityWeight × confidence), subject to
+ * per-category caps so a single noisy detector cannot drive the score to zero on
+ * its own.
+ *
+ * Result is clamped to [0, 100] and rounded to the nearest integer.
+ */
+export function computeHealthScore(issues) {
+    let score = 100;
+    const categoryDeductions = new Map();
+    for (const issue of issues) {
+        const deduction = (SEVERITY_WEIGHT[issue.severity] ?? 0) * issue.confidence;
+        const cap = CATEGORY_DEDUCTION_CAP[issue.category];
+        if (cap !== undefined) {
+            const soFar = categoryDeductions.get(issue.category) ?? 0;
+            const allowed = Math.max(0, cap - soFar);
+            const actual = Math.min(deduction, allowed);
+            categoryDeductions.set(issue.category, soFar + actual);
+            score -= actual;
+        }
+        else {
+            score -= deduction;
+        }
+    }
+    return Math.round(Math.max(0, Math.min(100, score)));
+}
+const IMPACT_WEIGHT = {
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+/**
+ * Classify the likely blast-radius impact of an issue.
+ */
+export function getIssueImpact(issue) {
+    if (issue.impact)
+        return issue.impact;
+    const cat = issue.category;
+    const title = issue.title.toLowerCase();
+    // 1. Security & Privacy -> High
+    if (cat === 'security' ||
+        title.includes('secret') ||
+        title.includes('auth') ||
+        title.includes('supabase') ||
+        title.includes('service role') ||
+        title.includes('upload')) {
+        return 'high';
+    }
+    // 2. Build Validation & Commands -> High
+    if (cat === 'command_validity' ||
+        title.includes('build') ||
+        title.includes('test') ||
+        title.includes('lint') ||
+        title.includes('run script') ||
+        title.includes('package manager') ||
+        title.includes('workflow')) {
+        return 'high';
+    }
+    // 3. Deployment -> High
+    if (title.includes('deploy') || title.includes('vercel') || title.includes('ci/cd') || title.includes('release')) {
+        return 'high';
+    }
+    // 4. Architecture & Framework choices -> High
+    if (title.includes('framework') ||
+        title.includes('router') ||
+        title.includes('database') ||
+        title.includes('version conflict') ||
+        title.includes('package manager mismatch')) {
+        return 'high';
+    }
+    // 5. Tool Behavior / Agent Practices -> High
+    if (cat === 'agent_practices' ||
+        title.includes('verification') ||
+        title.includes('scope') ||
+        title.includes('read-before-edit') ||
+        title.includes('honesty') ||
+        title.includes('plan-first')) {
+        return 'high';
+    }
+    // 6. Style & Low-Risk Duplication -> Low
+    if (cat === 'vague_guidance' || cat === 'duplicate' || title.includes('duplicate') || title.includes('vague')) {
+        return 'low';
+    }
+    return 'medium';
+}
+/**
+ * Select up to 3 top fixes from the issue list.
+ *
+ * Priority order (descending):
+ *   1. Severity weight (critical → high → warning → info)
+ *   2. Confidence (higher first)
+ *   3. Blast-radius impact (high → medium → low)
+ *   4. Number of files affected (more files = higher priority)
+ *   5. Category string (alphabetical, for stable tie-breaking)
+ *   6. Issue id (alphabetical, final stable tie-breaker)
+ *
+ * At most one fix per category is included to keep top-fixes diverse and
+ * actionable — the highest-priority issue per category wins.
+ */
+export function selectTopFixes(issues) {
+    const sorted = [...issues].sort((a, b) => {
+        const weightDiff = (SEVERITY_WEIGHT[b.severity] ?? 0) - (SEVERITY_WEIGHT[a.severity] ?? 0);
+        if (weightDiff !== 0)
+            return weightDiff;
+        const confDiff = b.confidence - a.confidence;
+        if (confDiff !== 0)
+            return confDiff;
+        const impactDiff = IMPACT_WEIGHT[getIssueImpact(b)] - IMPACT_WEIGHT[getIssueImpact(a)];
+        if (impactDiff !== 0)
+            return impactDiff;
+        const filesDiff = b.filePaths.length - a.filePaths.length;
+        if (filesDiff !== 0)
+            return filesDiff;
+        const catDiff = a.category.localeCompare(b.category);
+        if (catDiff !== 0)
+            return catDiff;
+        return a.id.localeCompare(b.id);
+    });
+    const fixes = [];
+    const seenCategories = new Set();
+    for (const issue of sorted) {
+        if (fixes.length >= 3)
+            break;
+        // One fix per category — avoids flooding top-fixes with e.g. 3 duplicate issues
+        if (seenCategories.has(issue.category))
+            continue;
+        seenCategories.add(issue.category);
+        fixes.push({
+            title: issue.title,
+            reason: issue.summary,
+            suggestedAction: issue.recommendation,
+        });
+    }
+    return fixes;
+}
+//# sourceMappingURL=health-score.js.map

package/dist/health-score.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/** Root export for @promptci/core */
+export * from './types.js';
+export { scanFiles } from './scanner.js';
+export { detectProjectType, detectProjectTypeFromContent } from './project-type.js';
+export { detectDuplicates, detectDuplicateHeadings, normalizeSection } from './duplicates.js';
+export { detectConflicts, detectVersionConflicts, detectCompetingTechConflicts } from './conflicts.js';
+export { detectDeadReferences } from './dead-references.js';
+export { detectAgentPractices } from './agent-practices.js';
+export { parseSuppressions, buildValidationIssues, applySuppressions } from './suppression.js';
+export type { SuppressionAnnotation } from './suppression.js';
+export { computeHealthScore, selectTopFixes } from './health-score.js';
+export { generateMarkdownReport, generateJsonReport, writeReport, readHistoryIndex, archiveExistingReport, historyIndexPath } from './report.js';
+export type { WriteReportOptions, HistoryEntry } from './report.js';
+export { detectManifestConsistency } from './manifest-consistency.js';
+export type { ManifestData } from './manifest-consistency.js';
+export { buildRepoContext, parsePackageJsonFacts } from './repo-context.js';
+export type { RepoContext, PackageJsonFacts, WorkflowFacts, WorkflowCommand } from './repo-context.js';
+export { runDetectors } from './detectors.js';
+export type { DetectorDefinition, DetectorGroup } from './detectors.js';
+export { analyzeContext } from './context-analysis.js';
+export type { ContextAnalysis } from './context-analysis.js';
+export { scan } from './scan.js';
+export { computeFingerprint, createBaseline, filterNewIssues, assertValidBaseline } from './baseline.js';
+export { applyFixRecipe, resolveSafePath } from './fix-engine.js';
+export { detectCliOutputFilter } from './cli-output-filter.js';
+export { detectNativeToolPreference } from './native-tool-preference.js';
+export type { FileChange } from './fix-engine.js';
+export { callLlm } from './llm.js';
+export { optimizeContext } from './context-optimizer.js';
+export type { OptimizeOptions, OptimizeResult } from './context-optimizer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjJ,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACvG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/** Root export for @promptci/core */
+export * from './types.js';
+export { scanFiles } from './scanner.js';
+export { detectProjectType, detectProjectTypeFromContent } from './project-type.js';
+export { detectDuplicates, detectDuplicateHeadings, normalizeSection } from './duplicates.js';
+export { detectConflicts, detectVersionConflicts, detectCompetingTechConflicts } from './conflicts.js';
+export { detectDeadReferences } from './dead-references.js';
+export { detectAgentPractices } from './agent-practices.js';
+export { parseSuppressions, buildValidationIssues, applySuppressions } from './suppression.js';
+export { computeHealthScore, selectTopFixes } from './health-score.js';
+export { generateMarkdownReport, generateJsonReport, writeReport, readHistoryIndex, archiveExistingReport, historyIndexPath } from './report.js';
+export { detectManifestConsistency } from './manifest-consistency.js';
+export { buildRepoContext, parsePackageJsonFacts } from './repo-context.js';
+export { runDetectors } from './detectors.js';
+export { analyzeContext } from './context-analysis.js';
+export { scan } from './scan.js';
+export { computeFingerprint, createBaseline, filterNewIssues, assertValidBaseline } from './baseline.js';
+export { applyFixRecipe, resolveSafePath } from './fix-engine.js';
+export { detectCliOutputFilter } from './cli-output-filter.js';
+export { detectNativeToolPreference } from './native-tool-preference.js';
+export { callLlm } from './llm.js';
+export { optimizeContext } from './context-optimizer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE/F,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEjJ,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzG,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAEzE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/llm.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Lightweight LLM Client wrapper using Node's native fetch.
+ * Gated by OPENAI_API_KEY and ANTHROPIC_API_KEY.
+ */
+export declare function callLlm(systemPrompt: string, userPrompt: string, responseFormatJson?: boolean): Promise<string>;
+//# sourceMappingURL=llm.d.ts.map

package/dist/llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAsB,OAAO,CAC3B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,kBAAkB,GAAE,OAAe,GAClC,OAAO,CAAC,MAAM,CAAC,CAgFjB"}

package/dist/llm.js

@@ -0,0 +1,67 @@
+/**
+ * Lightweight LLM Client wrapper using Node's native fetch.
+ * Gated by OPENAI_API_KEY and ANTHROPIC_API_KEY.
+ */
+export async function callLlm(systemPrompt, userPrompt, responseFormatJson = false) {
+    const openaiKey = process.env.OPENAI_API_KEY;
+    const anthropicKey = process.env.ANTHROPIC_API_KEY;
+    if (!openaiKey && !anthropicKey) {
+        throw new Error('Please set OPENAI_API_KEY or ANTHROPIC_API_KEY to use this feature.');
+    }
+    const modelOverride = process.env.PROMPTCI_LLM_MODEL;
+    if (openaiKey) {
+        const model = modelOverride ?? 'gpt-4o';
+        const body = {
+            model,
+            messages: [
+                { role: 'system', content: systemPrompt },
+                { role: 'user', content: userPrompt }
+            ],
+        };
+        if (responseFormatJson) {
+            body.response_format = { type: 'json_object' };
+        }
+        const res = await globalThis.fetch('https://api.openai.com/v1/chat/completions', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${openaiKey}`,
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            throw new Error(`OpenAI API request failed (${res.status}): ${errText}`);
+        }
+        const json = await res.json();
+        return json.choices?.[0]?.message?.content || '';
+    }
+    else {
+        // Anthropic
+        const model = modelOverride ?? 'claude-3-5-sonnet-latest';
+        const body = {
+            model,
+            max_tokens: 4096,
+            system: systemPrompt,
+            messages: [
+                { role: 'user', content: userPrompt }
+            ],
+        };
+        const res = await globalThis.fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': anthropicKey,
+                'anthropic-version': '2023-06-01',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            throw new Error(`Anthropic API request failed (${res.status}): ${errText}`);
+        }
+        const json = await res.json();
+        return json.content?.[0]?.text || '';
+    }
+}
+//# sourceMappingURL=llm.js.map

package/dist/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../src/llm.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,YAAoB,EACpB,UAAkB,EAClB,qBAA8B,KAAK;IAEnC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAEnD,IAAI,CAAC,SAAS,IAAI,CAAC,YAAY,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAErD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,KAAK,GAAG,aAAa,IAAI,QAAQ,CAAC;QACxC,MAAM,IAAI,GAA4B;YACpC,KAAK;YACL,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;gBACzC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;aACtC;SACF,CAAC;QACF,IAAI,kBAAkB,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,4CAA4C,EAAE;YAC/E,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,eAAe,EAAE,UAAU,SAAS,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAM1B,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,YAAY;QACZ,MAAM,KAAK,GAAG,aAAa,IAAI,0BAA0B,CAAC;QAC1D,MAAM,IAAI,GAA4B;YACpC,KAAK;YACL,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,YAAY;YACpB,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;aACtC;SACF,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,uCAAuC,EAAE;YAC1E,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,WAAW,EAAE,YAAa;gBAC1B,mBAAmB,EAAE,YAAY;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,CAAC,MAAM,MAAM,OAAO,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAK1B,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/manifest-consistency.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Manifest-consistency detector for PromptCI.
+ *
+ * Cross-references instruction file content against project manifest files
+ * (pyproject.toml, package.json) and flags mismatches that would cause an
+ * agent to follow an instruction that conflicts with the actual build setup.
+ *
+ * BUG-001: Tooling mismatch — instruction says `pip install -r requirements.txt`
+ *          but pyproject.toml declares Poetry as the build backend and there is
+ *          no requirements.txt in the repo.
+ *
+ * BUG-002: Python version mismatch — instruction file claims an older Python
+ *          version than the one pinned in pyproject.toml's `python` constraint.
+ *
+ * BUG-003: Library version mismatch — instruction file claims compatibility
+ *          with an older major library version than the one pinned in pyproject.toml.
+ *
+ * Findings are heuristic — wording is intentionally cautious.
+ */
+import type { PromptCiIssue } from './types.js';
+import type { RepoContext } from './repo-context.js';
+export type ManifestData = {
+    /** Raw text content of package.json, if present. */
+    packageJson?: string;
+    /** Raw text content of pyproject.toml, if present. */
+    pyproject?: string;
+};
+/**
+ * Cross-reference instruction files against project manifests and flag
+ * inconsistencies that would mislead an agent about the build setup.
+ *
+ * @param files    Scanned instruction files.
+ * @param manifests Raw text of any manifest files that were read by the scanner.
+ * @param repoRoot  Absolute path to the repo root (used for file existence checks).
+ */
+export declare function detectManifestConsistency(context: RepoContext): PromptCiIssue[];
+//# sourceMappingURL=manifest-consistency.d.ts.map

package/dist/manifest-consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-consistency.d.ts","sourceRoot":"","sources":["../src/manifest-consistency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,KAAK,EAAmB,aAAa,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,MAAM,MAAM,YAAY,GAAG;IACzB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAgsBF;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,aAAa,EAAE,CAuB/E"}