@promptci/core 0.0.1

package/dist/context-optimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-optimizer.js","sourceRoot":"","sources":["../src/context-optimizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIrC,MAAM,aAAa,GAAG;IACpB,qGAAqG;IACrG,0CAA0C;IAC1C,mIAAmI;CACpI,CAAC;AAEF,MAAM,oBAAoB,GAAG;IAC3B,2BAA2B;IAC3B,4BAA4B;IAC5B,oBAAoB;IACpB,gCAAgC;IAChC,0BAA0B;IAC1B,iBAAiB;CAClB,CAAC;AAEF,MAAM,oBAAoB,GAAG;IAC3B,6BAA6B;IAC7B,yBAAyB;IACzB,2BAA2B;CAC5B,CAAC;AAEF,MAAM,kBAAkB,GAAG,4GAA4G,CAAC;AAExI,MAAM,iBAAiB,GAAG;IACxB,GAAG,aAAa;IAChB,GAAG,oBAAoB;IACvB,GAAG,oBAAoB;IACvB,kBAAkB;CACnB,CAAC;AAEF,MAAM,qBAAqB,GAAG,yRAAyR,CAAC;AAExT,SAAS,YAAY,CAAC,MAAc;IAClC,OAAO,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,QAAgB;IAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE9C,IAAI,OAAO,GAAG,OAAO,CAAC;IAEtB,iCAAiC;IACjC,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,UAAU,GAAG,oBAAoB,EAAE,IAAI,CAAC,CAAC;IACrE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACpD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvC,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,8BAA8B;IAC9B,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,WAAW,GAAG,oBAAoB,EAAE,IAAI,CAAC,CAAC;IACvE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACrD,MAAM,GAAG,GAAG,MAAM,CAAC;QACnB,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,aAAa,CAAC,OAAe,EAAE,QAAgB;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAE1C,IAAI,cAAc,GAAuB,SAAS,CAAC;IACnD,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,YAAY,GAAa,EAAE,CAAC;IAEhC,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,EAAE,GAAG,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,CAAC;QACpF,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE;YACF,QAAQ;YACR,OAAO,EAAE,cAAc;YACvB,SAAS,EAAE,gBAAgB;YAC3B,OAAO;YACP,IAAI;YACJ,cAAc,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE5B,oFAAoF;QACpF,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,WAAW,GAAG,CAAC,WAAW,CAAC;YAC3B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,CAAC,WAAW,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEnE,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBAC5D,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YACrB,CAAC;YACD,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACxC,gBAAgB,GAAG,OAAO,CAAC;YAC3B,YAAY,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QAC5D,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAYD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAwB,EACxB,OAAwB;IAExB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;IAEtD,oCAAoC;IACpC,IAAI,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IACpC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YAC5C,aAAa,GAAG,MAAM,CAAC;QACzB,CAAC;aAAM,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YACnD,aAAa,GAAG,SAAS,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,aAAa,GAAG,MAAM,CAAC,CAAC,mBAAmB;QAC7C,CAAC;IACH,CAAC;IACD,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAE9D,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC7C,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,kCAAkC;IAClC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACrC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CACnF,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC;QAErC,4CAA4C;QAC5C,IAAI,cAAc,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;QACzD,cAAc,GAAG,kBAAkB,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QAE9D,uCAAuC;QACvC,MAAM,QAAQ,GAAG,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAE1D,MAAM,eAAe,GAIhB,EAAE,CAAC;QAER,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,OAAO;gBAAE,SAAS;YAE3B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC;YACjD,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAEvE,IAAI,OAAO,IAAI,UAAU,EAAE,CAAC;gBAC1B,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAChC,IAAI,CAAC,IAAI;oBAAE,IAAI,GAAG,SAAS,CAAC;gBAE5B,IAAI,iBAAiB,GAAG,GAAG,IAAI,KAAK,CAAC;gBACrC,IAAI,OAAO,GAAG,CAAC,CAAC;gBAEhB,OACE,kBAAkB,CAAC,GAAG,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC;oBACvD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC,EACzD,CAAC;oBACD,OAAO,EAAE,CAAC;oBACV,iBAAiB,GAAG,GAAG,IAAI,IAAI,OAAO,KAAK,CAAC;gBAC9C,CAAC;gBAED,kBAAkB,CAAC,GAAG,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC,CAAC;gBAExD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC;gBAClE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBAExF,eAAe,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,GAAG;oBACZ,UAAU,EAAE,WAAW;oBACvB,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,0DAA0D;YAC1D,IAAI,cAAc,KAAK,eAAe,EAAE,CAAC;gBACvC,OAAO,CAAC,IAAI,CAAC;oBACX,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,eAAe;oBACf,UAAU,EAAE,cAAc;iBAC3B,CAAC,CAAC;YACL,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QAE3C,6DAA6D;QAC7D,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAE1E,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;YACpC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;YAE/C,wCAAwC;YACxC,IAAI,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YAC/B,MAAM,YAAY,GAAG,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC5D,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;gBACpC,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,oBAAoB,EAAE,KAAK,WAAW,EAAE,CAAC,CAAC;YAC9E,CAAC;YAED,mCAAmC;YACnC,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ,EAAE,UAAU;gBACpB,eAAe,EAAE,EAAE;gBACnB,UAAU,EAAE,WAAW,GAAG,UAAU;aACrC,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC;YAEnC,MAAM,mBAAmB,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACnD,MAAM,WAAW,GAAG;gBAClB,mBAAmB;gBACnB,EAAE;gBACF,qBAAqB,aAAa,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,OAAO,IAAI;aAChF,CAAC;YAEF,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEnD,IAAI,YAAY,KAAK,eAAe,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,eAAe;gBACf,UAAU,EAAE,YAAY;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/context-recommender.d.ts

@@ -0,0 +1,3 @@
+import type { ScanReport } from './types.js';
+export declare function generateContextRecommendations(report: ScanReport): string;
+//# sourceMappingURL=context-recommender.d.ts.map

package/dist/context-recommender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-recommender.d.ts","sourceRoot":"","sources":["../src/context-recommender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAuC,MAAM,YAAY,CAAC;AAclF,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAgYzE"}

package/dist/context-recommender.js

@@ -0,0 +1,329 @@
+import * as path from 'node:path';
+import { existsSync } from 'node:fs';
+export function generateContextRecommendations(report) {
+    const { filesScanned, repoPath } = report;
+    const rel = (absPath) => {
+        const r = path.relative(repoPath, absPath);
+        return r && !r.startsWith('..') ? r : absPath;
+    };
+    // If the repository is small and clean, skip recommendations to avoid noise
+    const totalTokens = filesScanned.reduce((sum, f) => sum + f.estimatedTokens, 0);
+    if (totalTokens < 500 && report.issues.length === 0) {
+        return '';
+    }
+    // 1. Classify all sections
+    const classified = [];
+    for (const file of filesScanned) {
+        for (const sec of file.sections) {
+            const heading = (sec.heading || '').toLowerCase();
+            const text = sec.normalizedText;
+            let classification = 'unknown';
+            let suggestedFile = '';
+            let reason = '';
+            // Check Archive/Remove markers first
+            if (heading.includes('changelog') ||
+                heading.includes('history') ||
+                heading.includes('roadmap') ||
+                heading.includes('screenshot') ||
+                heading.includes('mockup') ||
+                heading.includes('past plan') ||
+                heading.includes('yesterday') ||
+                heading.includes('todo') ||
+                heading.includes('status') ||
+                heading.includes('task') ||
+                heading.includes('notes') ||
+                text.includes('todo') && (heading.includes('todo') || heading.includes('done'))) {
+                classification = 'archive';
+                reason = 'Contains historical, stale, or roadmap content that is not relevant to ongoing AI tasks.';
+            }
+            // Check On-demand markers
+            else if (heading.includes('deploy') ||
+                heading.includes('vercel') ||
+                heading.includes('ci/cd') ||
+                heading.includes('release')) {
+                classification = 'on-demand';
+                suggestedFile = 'docs/ai/deployment.md';
+                reason = 'Contains deployment steps, environments, or release workflows which are only needed during releases.';
+            }
+            else if (heading.includes('nextjs') ||
+                heading.includes('next.js') ||
+                heading.includes('react') ||
+                heading.includes('remix') ||
+                heading.includes('frontend') ||
+                heading.includes('dashboard')) {
+                classification = 'on-demand';
+                suggestedFile = 'docs/ai/nextjs.md';
+                reason = 'Contains framework-specific UI/Next.js conventions that are only needed when editing web dashboard code.';
+            }
+            else if (heading.includes('supabase') ||
+                heading.includes('database') ||
+                heading.includes('prisma') ||
+                heading.includes('migration') ||
+                heading.includes('sql') ||
+                heading.includes('schema')) {
+                classification = 'on-demand';
+                suggestedFile = 'docs/ai/supabase.md';
+                reason = 'Contains database setup or migration steps which are only needed when schema or API boundary changes occur.';
+            }
+            else if (heading.includes('architecture') ||
+                heading.includes('design') ||
+                heading.includes('structure') ||
+                heading.includes('components')) {
+                classification = 'on-demand';
+                suggestedFile = 'docs/ai/architecture.md';
+                reason = 'Contains repository structure or module descriptions that are only needed when creating new components.';
+            }
+            else if (heading.includes('troubleshoot') ||
+                heading.includes('debug') ||
+                heading.includes('error') ||
+                heading.includes('issue')) {
+                classification = 'on-demand';
+                suggestedFile = 'docs/ai/troubleshooting.md';
+                reason = 'Contains error codes or troubleshooting procedures only needed when debugging failures.';
+            }
+            else if (sec.text.includes('```') && sec.text.length > 1500) {
+                classification = 'on-demand';
+                suggestedFile = 'docs/ai/examples.md';
+                reason = 'Contains long code snippets or examples that bloat always-loaded context.';
+            }
+            // Check Always-load markers
+            else if (heading.includes('identity') ||
+                heading.includes('about') ||
+                heading.includes('purpose') ||
+                heading.includes('boundary') ||
+                heading.includes('non-goal') ||
+                heading.includes('verification') ||
+                heading.includes('build') ||
+                heading.includes('test') ||
+                heading.includes('lint') ||
+                heading.includes('typecheck') ||
+                heading.includes('safety') ||
+                heading.includes('security') ||
+                heading.includes('secret') ||
+                heading.includes('credential') ||
+                heading.includes('auth') ||
+                heading.includes('read-before-edit') ||
+                heading.includes('scope-control') ||
+                heading.includes('honesty') ||
+                heading.includes('plan-first')) {
+                classification = 'always-load';
+                reason = 'Contains core setup, boundary constraints, verification commands, or critical developer practices.';
+            }
+            if (classification !== 'unknown') {
+                classified.push({
+                    file,
+                    section: sec,
+                    classification,
+                    suggestedFile,
+                    reason,
+                });
+            }
+        }
+    }
+    const lines = [];
+    // ── Cost 2: Context Split & Retrieval Map ────────────────────────────────────
+    lines.push('## Context Architecture & Retrieval Map');
+    lines.push('');
+    lines.push('> [!NOTE]');
+    lines.push('> Split large instruction files to keep canonical instructions under the token budget. Move detailed instructions to on-demand documents and link them.');
+    lines.push('');
+    const onDemand = classified.filter((c) => c.classification === 'on-demand');
+    const archive = classified.filter((c) => c.classification === 'archive');
+    if (onDemand.length > 0 || archive.length > 0) {
+        lines.push('### Suggested Context Splits');
+        lines.push('');
+        lines.push('| Section / File | Current Size | Classification | Recommendation |');
+        lines.push('|---|---|---|---|');
+        for (const c of [...onDemand, ...archive]) {
+            const loc = `\`${rel(c.file.path)}\` (Heading: *${c.section.heading || 'None'}*)`;
+            const size = `~${Math.round(c.section.text.length / 4)} tokens`;
+            const target = c.classification === 'archive' ? 'Archive/Remove' : `On-Demand (\`${c.suggestedFile}\`)`;
+            lines.push(`| ${loc} | ${size} | **${target}** | ${c.reason} |`);
+        }
+        lines.push('');
+    }
+    lines.push('### Suggested Canonical AGENTS.md Layout');
+    lines.push('To minimize token consumption, structure your canonical rules as follows:');
+    lines.push('```markdown');
+    lines.push('# PromptCI - Agent Instructions');
+    lines.push('');
+    lines.push('## Identity & Boundaries');
+    lines.push('- Describe core project limits, tech stack, and non-goals here.');
+    lines.push('');
+    lines.push('## Verification Loop');
+    lines.push('- List exact commands: e.g. `pnpm lint`, `pnpm typecheck`, `pnpm test`.');
+    lines.push('');
+    lines.push('## References (On-Demand)');
+    lines.push('- For deployment details, read [deployment.md](file:///docs/ai/deployment.md).');
+    lines.push('- For DB schema, read [supabase.md](file:///docs/ai/supabase.md).');
+    lines.push('```');
+    lines.push('');
+    // ── Cost 5: Skills Readiness & Skill Extraction Recommendations ──────────────
+    const proceduralSections = classified.filter((c) => {
+        // Check if section is long and contains numbered lists or action bullet points
+        const text = c.section.text;
+        const linesOfText = text.split('\n');
+        const hasNumberedList = linesOfText.some((l) => /^\s*\d+\.\s+[A-Z]/i.test(l));
+        const hasImperativeVerbs = linesOfText.some((l) => /^\s*[-*]\s+(Run|Do|Verify|Build|Compile|Deploy|Release|Upgrade|Test|Check|Commit|Push)\b/i.test(l));
+        return text.length > 1000 && (hasNumberedList || hasImperativeVerbs);
+    });
+    if (proceduralSections.length > 0) {
+        lines.push('## Skills Readiness & Extraction Recommendations');
+        lines.push('');
+        lines.push('The following sections describe multi-step procedural workflows. These are excellent candidates to move out of instruction files into reusable local playbooks or skills to save persistent context tokens:');
+        lines.push('');
+        for (const c of proceduralSections) {
+            const heading = c.section.heading || 'Workflow';
+            let skillName = `custom-playbook-${c.section.id}`;
+            let trigger = `When executing specialized tasks related to ${heading}`;
+            const lowerHeading = heading.toLowerCase();
+            if (lowerHeading.includes('deploy') || lowerHeading.includes('release')) {
+                skillName = 'deployment-runbook';
+                trigger = 'Before running a deployment, release, or publishing builds';
+            }
+            else if (lowerHeading.includes('supabase') || lowerHeading.includes('migration') || lowerHeading.includes('database')) {
+                skillName = 'supabase-migration-workflow';
+                trigger = 'When writing or executing database migrations, DDL, or database client code';
+            }
+            else if (lowerHeading.includes('test') || lowerHeading.includes('ci')) {
+                skillName = 'test-and-ci-checklist';
+                trigger = 'When verifying build health or running the automated test matrix';
+            }
+            lines.push(`### Skill Candidate: \`${skillName}\``);
+            lines.push(`- **Trigger Condition:** ${trigger}`);
+            lines.push(`- **Source Section:** \`${rel(c.file.path)}\` (Section: *${heading}*)`);
+            lines.push(`- **Savings Potential:** ~${Math.round(c.section.text.length / 4)} tokens per session`);
+            lines.push(`- **Action:** Extract the procedural checklist into a file like \`docs/skills/${skillName}.md\` and add a single trigger rule in AGENTS.md.`);
+            lines.push('');
+        }
+    }
+    const roiList = [];
+    for (const c of classified) {
+        const tokens = Math.round(c.section.text.length / 4);
+        if (tokens < 100)
+            continue; // skip small ones
+        let multiplier = 1.0;
+        let action = 'Archive or remove';
+        if (c.classification === 'archive') {
+            multiplier = 2.0;
+            action = 'Remove completely or move to archive/';
+        }
+        else if (c.classification === 'on-demand') {
+            multiplier = 1.5;
+            action = `Extract to on-demand doc (\`${c.suggestedFile}\`)`;
+        }
+        else if (c.classification === 'always-load') {
+            multiplier = 0.5;
+            action = 'Trim details or move examples out';
+        }
+        // Reduce multiplier if it contains highly critical rules (value signals)
+        const textLower = c.section.text.toLowerCase();
+        const hasCriticalGuidance = textLower.includes('verification') ||
+            textLower.includes('honesty') ||
+            textLower.includes('read-before-edit') ||
+            textLower.includes('scope-control') ||
+            textLower.includes('security') ||
+            textLower.includes('safety') ||
+            textLower.includes('plan-first');
+        if (hasCriticalGuidance) {
+            if (c.classification === 'always-load') {
+                // Skip highly critical always-loaded rules from cleanup list entirely
+                continue;
+            }
+            else {
+                multiplier *= 0.5; // Lower cleanup priority for other sections containing critical text
+            }
+        }
+        // Increase multiplier for cost signals (volatile content, long code blocks, duplicates)
+        // Volatile content check (timestamps, dates, active task/branch notes)
+        const hasVolatile = /\b(?:last\s+updated|generated\s+at|timestamp|current\s+branch|active\s+task|health\s+score)\b/i.test(c.section.text) ||
+            /\b(?:202\d-\d{2}-\d{2}|[0-2]?\d:[0-5]\d:[0-5]\d)\b/.test(c.section.text);
+        if (hasVolatile) {
+            multiplier += 0.5;
+        }
+        // Long code blocks / examples check:
+        if (c.section.text.includes('```') && c.section.text.length > 2000) {
+            multiplier += 0.5;
+        }
+        // Duplicated section check:
+        const isDuplicate = report.issues.some((i) => i.category === 'duplicate' && i.filePaths.includes(c.file.path));
+        if (isDuplicate) {
+            multiplier += 0.5;
+        }
+        roiList.push({
+            name: `\`${rel(c.file.path)}\` (Section: *${c.section.heading || 'None'}*)`,
+            tokens,
+            savingsPotential: tokens * multiplier,
+            reason: c.reason,
+            action,
+        });
+    }
+    const sortedRoi = roiList.sort((a, b) => b.savingsPotential - a.savingsPotential).slice(0, 3);
+    if (sortedRoi.length > 0) {
+        lines.push('## Context ROI Ranking (Cleanup Opportunities)');
+        lines.push('');
+        lines.push('Prioritized list of instruction sections to clean up, refactor, or extract to maximize token savings:');
+        lines.push('');
+        lines.push('| Rank | Section / File | Token Size | Savings Potential | Suggested Action | Why? |');
+        lines.push('|---|---|---|---|---|---|');
+        sortedRoi.forEach((item, idx) => {
+            const rank = idx + 1;
+            lines.push(`| ${rank} | ${item.name} | ~${item.tokens} | High | ${item.action} | ${item.reason} |`);
+        });
+        lines.push('');
+    }
+    // ── Cost 11: Task-Specific Context Pack Suggestions ──────────────────────────
+    // Check repo signals
+    const hasSupabase = report.repoPath && (existsSync(path.join(report.repoPath, 'supabase')) ||
+        filesScanned.some((f) => f.path.endsWith('package.json') && f.content.includes('@supabase/supabase-js')));
+    const hasCli = filesScanned.some((f) => f.path.includes('packages/cli') || f.path.includes('apps/cli'));
+    const hasWeb = filesScanned.some((f) => f.path.includes('packages/web') || f.path.includes('apps/web'));
+    const hasNextJs = filesScanned.some((f) => /next/i.test(f.content));
+    const packs = [];
+    if (hasSupabase) {
+        packs.push({
+            name: '`supabase-auth-and-upload`',
+            source: 'Supabase schema and client config rules',
+            whenToLoad: 'When altering database schemas, migrations, security triggers, or upload APIs.',
+            savings: 'Avoids loading database structures for standard frontend/backend edits.',
+        });
+    }
+    if (hasCli) {
+        packs.push({
+            name: '`cli-command-workflow`',
+            source: 'CLI entrypoints and argument parsers instructions',
+            whenToLoad: 'When changing CLI flags, command syntax, or command handlers.',
+            savings: 'Keeps command parsing logic out of web dashboard and core development runs.',
+        });
+    }
+    if (hasWeb || hasNextJs) {
+        packs.push({
+            name: '`web-dashboard-development`',
+            source: 'Next.js components, page routes, and middleware rules',
+            whenToLoad: 'When building UI dashboard layouts, state management, or styling components.',
+            savings: 'Keeps CSS and layout instructions out of core engines and CLI builds.',
+        });
+    }
+    if (classified.some((c) => c.classification === 'on-demand' && c.suggestedFile === 'docs/ai/deployment.md')) {
+        packs.push({
+            name: '`deployment-and-ci`',
+            source: 'Vercel, CI/CD, and release commands checklists',
+            whenToLoad: 'When debugging GitHub Actions workflows or preparing production releases.',
+            savings: 'Keeps long validation check scripts out of the standard iteration loop.',
+        });
+    }
+    if (packs.length > 0) {
+        lines.push('## Suggested Context Packs');
+        lines.push('');
+        lines.push('Consider defining task-specific context bundles so agents only load rules relevant to their active focus area:');
+        lines.push('');
+        lines.push('| Pack Name | Source Sections | When to Load | Token Benefit |');
+        lines.push('|---|---|---|---|');
+        for (const p of packs) {
+            lines.push(`| ${p.name} | ${p.source} | ${p.whenToLoad} | ${p.savings} |`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=context-recommender.js.map

package/dist/context-recommender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-recommender.js","sourceRoot":"","sources":["../src/context-recommender.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAYrC,MAAM,UAAU,8BAA8B,CAAC,MAAkB;IAC/D,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAC1C,MAAM,GAAG,GAAG,CAAC,OAAe,EAAE,EAAE;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChD,CAAC,CAAC;IAEF,4EAA4E;IAC5E,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IAChF,IAAI,WAAW,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,2BAA2B;IAC3B,MAAM,UAAU,GAAwB,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,GAAG,CAAC,cAAc,CAAC;YAEhC,IAAI,cAAc,GAA0B,SAAS,CAAC;YACtD,IAAI,aAAa,GAAG,EAAE,CAAC;YACvB,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,qCAAqC;YACrC,IACE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAC/E,CAAC;gBACD,cAAc,GAAG,SAAS,CAAC;gBAC3B,MAAM,GAAG,0FAA0F,CAAC;YACtG,CAAC;YACD,0BAA0B;iBACrB,IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAC3B,CAAC;gBACD,cAAc,GAAG,WAAW,CAAC;gBAC7B,aAAa,GAAG,uBAAuB,CAAC;gBACxC,MAAM,GAAG,sGAAsG,CAAC;YAClH,CAAC;iBAAM,IACL,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAC7B,CAAC;gBACD,cAAc,GAAG,WAAW,CAAC;gBAC7B,aAAa,GAAG,mBAAmB,CAAC;gBACpC,MAAM,GAAG,0GAA0G,CAAC;YACtH,CAAC;iBAAM,IACL,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAC1B,CAAC;gBACD,cAAc,GAAG,WAAW,CAAC;gBAC7B,aAAa,GAAG,qBAAqB,CAAC;gBACtC,MAAM,GAAG,6GAA6G,CAAC;YACzH,CAAC;iBAAM,IACL,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAC9B,CAAC;gBACD,cAAc,GAAG,WAAW,CAAC;gBAC7B,aAAa,GAAG,yBAAyB,CAAC;gBAC1C,MAAM,GAAG,yGAAyG,CAAC;YACrH,CAAC;iBAAM,IACL,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EACzB,CAAC;gBACD,cAAc,GAAG,WAAW,CAAC;gBAC7B,aAAa,GAAG,4BAA4B,CAAC;gBAC7C,MAAM,GAAG,yFAAyF,CAAC;YACrG,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;gBAC9D,cAAc,GAAG,WAAW,CAAC;gBAC7B,aAAa,GAAG,qBAAqB,CAAC;gBACtC,MAAM,GAAG,2EAA2E,CAAC;YACvF,CAAC;YACD,4BAA4B;iBACvB,IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACxB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;gBACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAC9B,CAAC;gBACD,cAAc,GAAG,aAAa,CAAC;gBAC/B,MAAM,GAAG,oGAAoG,CAAC;YAChH,CAAC;YAED,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBACjC,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI;oBACJ,OAAO,EAAE,GAAG;oBACZ,cAAc;oBACd,aAAa;oBACb,MAAM;iBACP,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,gFAAgF;IAChF,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,yJAAyJ,CAAC,CAAC;IACtK,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,WAAW,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC;IAEzE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAEhC,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,IAAI,CAAC;YAClF,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC;YAChE,MAAM,MAAM,GAAG,CAAC,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,aAAa,KAAK,CAAC;YACxG,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,QAAQ,MAAM,QAAQ,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QACnE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IACxF,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAC;IAC9E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;IACtF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,gFAAgF,CAAC,CAAC;IAC7F,KAAK,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAC;IAChF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,gFAAgF;IAChF,MAAM,kBAAkB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACjD,+EAA+E;QAC/E,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9E,MAAM,kBAAkB,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,2FAA2F,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACxJ,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,IAAI,CAAC,eAAe,IAAI,kBAAkB,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,6MAA6M,CAAC,CAAC;QAC1N,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,MAAM,CAAC,IAAI,kBAAkB,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC;YAChD,IAAI,SAAS,GAAG,mBAAmB,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;YAClD,IAAI,OAAO,GAAG,+CAA+C,OAAO,EAAE,CAAC;YAEvE,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAC3C,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACxE,SAAS,GAAG,oBAAoB,CAAC;gBACjC,OAAO,GAAG,4DAA4D,CAAC;YACzE,CAAC;iBAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxH,SAAS,GAAG,6BAA6B,CAAC;gBAC1C,OAAO,GAAG,6EAA6E,CAAC;YAC1F,CAAC;iBAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxE,SAAS,GAAG,uBAAuB,CAAC;gBACpC,OAAO,GAAG,kEAAkE,CAAC;YAC/E,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,0BAA0B,SAAS,IAAI,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,4BAA4B,OAAO,EAAE,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,2BAA2B,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,OAAO,IAAI,CAAC,CAAC;YACpF,KAAK,CAAC,IAAI,CAAC,6BAA6B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC;YACpG,KAAK,CAAC,IAAI,CAAC,iFAAiF,SAAS,mDAAmD,CAAC,CAAC;YAC1J,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAWD,MAAM,OAAO,GAAc,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrD,IAAI,MAAM,GAAG,GAAG;YAAE,SAAS,CAAC,kBAAkB;QAE9C,IAAI,UAAU,GAAG,GAAG,CAAC;QACrB,IAAI,MAAM,GAAG,mBAAmB,CAAC;QAEjC,IAAI,CAAC,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACnC,UAAU,GAAG,GAAG,CAAC;YACjB,MAAM,GAAG,uCAAuC,CAAC;QACnD,CAAC;aAAM,IAAI,CAAC,CAAC,cAAc,KAAK,WAAW,EAAE,CAAC;YAC5C,UAAU,GAAG,GAAG,CAAC;YACjB,MAAM,GAAG,+BAA+B,CAAC,CAAC,aAAa,KAAK,CAAC;QAC/D,CAAC;aAAM,IAAI,CAAC,CAAC,cAAc,KAAK,aAAa,EAAE,CAAC;YAC9C,UAAU,GAAG,GAAG,CAAC;YACjB,MAAM,GAAG,mCAAmC,CAAC;QAC/C,CAAC;QAED,yEAAyE;QACzE,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,mBAAmB,GACvB,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;YAClC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC7B,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACtC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC;YACnC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC9B,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC5B,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAEnC,IAAI,mBAAmB,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,cAAc,KAAK,aAAa,EAAE,CAAC;gBACvC,sEAAsE;gBACtE,SAAS;YACX,CAAC;iBAAM,CAAC;gBACN,UAAU,IAAI,GAAG,CAAC,CAAC,qEAAqE;YAC1F,CAAC;QACH,CAAC;QAED,wFAAwF;QACxF,uEAAuE;QACvE,MAAM,WAAW,GACf,gGAAgG,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACrH,oDAAoD,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5E,IAAI,WAAW,EAAE,CAAC;YAChB,UAAU,IAAI,GAAG,CAAC;QACpB,CAAC;QAED,qCAAqC;QACrC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YACnE,UAAU,IAAI,GAAG,CAAC;QACpB,CAAC;QAED,4BAA4B;QAC5B,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACvE,CAAC;QACF,IAAI,WAAW,EAAE,CAAC;YAChB,UAAU,IAAI,GAAG,CAAC;QACpB,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,IAAI;YAC3E,MAAM;YACN,gBAAgB,EAAE,MAAM,GAAG,UAAU;YACrC,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9F,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,uGAAuG,CAAC,CAAC;QACpH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,sFAAsF,CAAC,CAAC;QACnG,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAExC,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,aAAa,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACtG,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,gFAAgF;IAChF,qBAAqB;IACrB,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,IAAI,CACrC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAClD,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CACzG,CAAC;IACF,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IACxG,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IACxG,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IASpE,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,4BAA4B;YAClC,MAAM,EAAE,yCAAyC;YACjD,UAAU,EAAE,gFAAgF;YAC5F,OAAO,EAAE,yEAAyE;SACnF,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,wBAAwB;YAC9B,MAAM,EAAE,mDAAmD;YAC3D,UAAU,EAAE,+DAA+D;YAC3E,OAAO,EAAE,6EAA6E;SACvF,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,IAAI,SAAS,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,6BAA6B;YACnC,MAAM,EAAE,uDAAuD;YAC/D,UAAU,EAAE,8EAA8E;YAC1F,OAAO,EAAE,uEAAuE;SACjF,CAAC,CAAC;IACL,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,WAAW,IAAI,CAAC,CAAC,aAAa,KAAK,uBAAuB,CAAC,EAAE,CAAC;QAC5G,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,qBAAqB;YAC3B,MAAM,EAAE,gDAAgD;YACxD,UAAU,EAAE,2EAA2E;YACvF,OAAO,EAAE,yEAAyE;SACnF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,gHAAgH,CAAC,CAAC;QAC7H,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;QAC7E,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAEhC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,UAAU,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;QAC7E,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/dead-references.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Dead-reference detector for PromptCI.
+ *
+ * Scans instruction files for references to other local files and flags
+ * ones that don't exist on disk. Catches:
+ *   - Markdown links:  [text](./path/to/file.md)
+ *   - Reference-style links: [text][ref] with a `[ref]: path` definition
+ *   - @-file refs:     @AGENTS.md  |  @docs/guide.md
+ *
+ * External URLs (http/https), anchor-only links (#section), and mailto:
+ * are always skipped. Only paths with a recognisable file extension are
+ * checked to avoid false-positiving on badge shields, npm package names, etc.
+ *
+ * Findings are heuristic — wording is intentionally cautious.
+ */
+import type { InstructionFile, PromptCiIssue } from './types.js';
+/**
+ * Detect broken file references across all instruction files.
+ *
+ * @param files     Instruction files to scan.
+ * @param repoRoot  Absolute path to repo root — used as a second resolution base.
+ */
+/**
+ * BUG-004 / BUG-005: Group all unresolved references by their normalised path so
+ * that the same dead reference appearing in multiple instruction files produces ONE
+ * consolidated issue (listing all referencing files) instead of N separate issues.
+ *
+ * Previously each (filePath, ref) pair produced its own issue — a single dead path
+ * referenced in both CLAUDE.md and AGENTS.md would fire twice, inflating issue counts
+ * and health-score penalties.
+ */
+export declare function detectDeadReferences(files: InstructionFile[], repoRoot: string): PromptCiIssue[];
+//# sourceMappingURL=dead-references.d.ts.map

package/dist/dead-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-references.d.ts","sourceRoot":"","sources":["../src/dead-references.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA0jBjE;;;;;GAKG;AACH;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,eAAe,EAAE,EACxB,QAAQ,EAAE,MAAM,GACf,aAAa,EAAE,CAgGjB"}