@codeledger/selector 0.1.1 → 0.2.0

package/dist/validation.js

@@ -0,0 +1,108 @@
+/**
+ * Bundle Validation — Pre-flight Warnings
+ *
+ * Catches obviously-bad bundles before the agent wastes turns. Validates
+ * bundle quality against the task description and raises warnings for
+ * common failure modes.
+ */
+/** Keywords that suggest the task involves testing */
+const TEST_KEYWORDS = ['test', 'tests', 'testing', 'spec', 'specs', 'jest', 'vitest', 'mocha'];
+/** Keywords that suggest the task involves configuration */
+const CONFIG_KEYWORDS = ['config', 'configuration', 'settings', 'setup', 'env', 'environment'];
+/** Keywords that suggest the task involves database operations */
+const DB_KEYWORDS = ['database', 'migration', 'schema', 'sql', 'query', 'model', 'table'];
+/**
+ * Validate a generated bundle and produce diagnostic warnings.
+ * Called after the bundle is fully assembled.
+ */
+export function validateBundle(files, taskKeywords, allScored, taskText) {
+    const warnings = [];
+    const taskLower = taskText.toLowerCase();
+    // Warning 1: No keyword matches at all
+    const hasKeywordMatch = files.some((f) => !f.is_stub && !f.is_exemplar && f.reasons.includes('keyword_match'));
+    if (!hasKeywordMatch && files.length > 0) {
+        warnings.push({
+            level: 'warning',
+            code: 'no_keyword_match',
+            message: 'No files matched task keywords. Bundle is based on churn/centrality signals only — consider rephrasing the task.',
+        });
+    }
+    // Warning 2: Task mentions tests but no test files in bundle
+    const mentionsTests = taskKeywords.some((kw) => TEST_KEYWORDS.includes(kw)) ||
+        TEST_KEYWORDS.some((kw) => taskLower.includes(kw));
+    const hasTestFile = files.some((f) => f.path.includes('.test.') || f.path.includes('.spec.') || f.path.includes('__tests__'));
+    if (mentionsTests && !hasTestFile) {
+        warnings.push({
+            level: 'warning',
+            code: 'missing_test_files',
+            message: 'Task mentions testing but no test files are in the bundle. Test files may have been filtered or out of budget.',
+        });
+    }
+    // Warning 3: Task mentions config but no config-like files
+    const mentionsConfig = taskKeywords.some((kw) => CONFIG_KEYWORDS.includes(kw));
+    const hasConfigFile = files.some((f) => {
+        const lower = f.path.toLowerCase();
+        return lower.includes('config') || lower.includes('.env') ||
+            lower.includes('tsconfig') || lower.includes('package.json');
+    });
+    if (mentionsConfig && !hasConfigFile) {
+        warnings.push({
+            level: 'info',
+            code: 'missing_config_files',
+            message: 'Task mentions configuration but no config files are in the bundle.',
+        });
+    }
+    // Warning 4: Task mentions DB/schema but no DB files
+    const mentionsDb = taskKeywords.some((kw) => DB_KEYWORDS.includes(kw));
+    const hasDbFile = files.some((f) => {
+        const lower = f.path.toLowerCase();
+        return lower.includes('model') || lower.includes('migration') ||
+            lower.includes('schema') || lower.includes('.sql') ||
+            lower.includes('db/') || lower.includes('database');
+    });
+    if (mentionsDb && !hasDbFile) {
+        warnings.push({
+            level: 'info',
+            code: 'missing_db_files',
+            message: 'Task mentions database/schema but no database files are in the bundle.',
+        });
+    }
+    // Warning 5: Very low score concentration — bundle is diluted
+    const nonStubFiles = files.filter((f) => !f.is_stub && !f.is_exemplar);
+    if (nonStubFiles.length >= 5) {
+        const topScore = nonStubFiles[0]?.score ?? 0;
+        const bottomScore = nonStubFiles[nonStubFiles.length - 1]?.score ?? 0;
+        if (topScore > 0 && bottomScore > 0) {
+            const ratio = bottomScore / topScore;
+            if (ratio > 0.85) {
+                warnings.push({
+                    level: 'info',
+                    code: 'score_plateau',
+                    message: 'File scores are very close together — no strong signal file. The task may be too broad or generic.',
+                });
+            }
+        }
+    }
+    // Warning 6: Bundle is empty
+    if (nonStubFiles.length === 0) {
+        warnings.push({
+            level: 'warning',
+            code: 'empty_bundle',
+            message: 'Bundle contains no source files. The task may not match any files in the repository.',
+        });
+    }
+    // Warning 7: High-scoring files were excluded (budget too tight)
+    if (allScored.length > 0 && nonStubFiles.length > 0) {
+        const lastIncludedScore = nonStubFiles[nonStubFiles.length - 1].score;
+        const excludedHighScorers = allScored.filter((s) => s.score > lastIncludedScore && !files.some((f) => f.path === s.path));
+        if (excludedHighScorers.length > 3) {
+            warnings.push({
+                level: 'info',
+                code: 'budget_squeeze',
+                message: `${excludedHighScorers.length} files with strong scores were excluded by budget constraints. Consider increasing --budget or --max-files.`,
+            });
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,sDAAsD;AACtD,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAE/F,4DAA4D;AAC5D,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;AAE/F,kEAAkE;AAClE,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAE1F;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAmB,EACnB,YAAsB,EACtB,SAAuB,EACvB,QAAgB;IAEhB,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEzC,uCAAuC;IACvC,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAC3E,CAAC;IACF,IAAI,CAAC,eAAe,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,kHAAkH;SAC5H,CAAC,CAAC;IACL,CAAC;IAED,6DAA6D;IAC7D,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzE,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACnC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CACvF,CAAC;IACF,IAAI,aAAa,IAAI,CAAC,WAAW,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,gHAAgH;SAC1H,CAAC,CAAC;IACL,CAAC;IAED,2DAA2D;IAC3D,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YACvD,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IACH,IAAI,cAAc,IAAI,CAAC,aAAa,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,oEAAoE;SAC9E,CAAC,CAAC;IACL,CAAC;IAED,qDAAqD;IACrD,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC3D,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAClD,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IACH,IAAI,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,wEAAwE;SAClF,CAAC,CAAC;IACL,CAAC;IAED,8DAA8D;IAC9D,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACvE,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;QACtE,IAAI,QAAQ,GAAG,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,WAAW,GAAG,QAAQ,CAAC;YACrC,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;gBACjB,QAAQ,CAAC,IAAI,CAAC;oBACZ,KAAK,EAAE,MAAM;oBACb,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,oGAAoG;iBAC9G,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,sFAAsF;SAChG,CAAC,CAAC;IACL,CAAC;IAED,iEAAiE;IACjE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,iBAAiB,GAAG,YAAY,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,KAAK,CAAC;QACvE,MAAM,mBAAmB,GAAG,SAAS,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,iBAAiB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAC5E,CAAC;QACF,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,GAAG,mBAAmB,CAAC,MAAM,6GAA6G;aACpJ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codeledger/selector",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "type": "module",
   "description": "Deterministic context selection algorithm for CodeLedger",
   "license": "Apache-2.0",
@@ -24,7 +24,7 @@
     }
   },
   "dependencies": {
-    "@codeledger/types": "0.1.1"
+    "@codeledger/types": "0.2.0"
   },
   "devDependencies": {
     "typescript": "^5.4.0"