@shrkcrft/context 0.1.0-alpha.18 → 0.1.0-alpha.19

package/dist/derive-applies-when.d.ts

@@ -0,0 +1,2 @@
+export declare function deriveAppliesWhen(task: string): string[];
+//# sourceMappingURL=derive-applies-when.d.ts.map

package/dist/derive-applies-when.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-applies-when.d.ts","sourceRoot":"","sources":["../src/derive-applies-when.ts"],"names":[],"mappings":"AAqCA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAWxD"}

package/dist/derive-applies-when.js

@@ -0,0 +1,51 @@
+/**
+ * Derive `appliesWhen` tokens from a free-text task string.
+ *
+ * `shrk context` ranks knowledge entries via a lexical scorer. Foundational
+ * rules (e.g. `architecture.layer-order`) declare an `appliesWhen` like
+ * `generate-code` but share no surface tokens with a task such as "add a new
+ * plugin command" — so without a derived `appliesWhen` signal they earn no
+ * match reason and are dropped before priority is even considered.
+ *
+ * This maps task verbs/domains to the same canonical `appliesWhen` vocabulary
+ * the inspector task-ranker uses, so the rule that *governs* the work surfaces
+ * even when the wording doesn't overlap. Deterministic; no model in the loop.
+ *
+ * NOTE: the verb/domain vocabulary mirrors
+ * `packages/inspector/src/task-ranker.ts`. The context layer cannot import the
+ * higher inspector layer, so the small map is duplicated here on purpose — keep
+ * the two in sync if either grows.
+ */
+const VERB_APPLIES_WHEN = [
+    {
+        regex: /\b(create|add|implement|generate|new|build|introduce|provide)\b/,
+        appliesWhen: ['generate-code', 'generate-service', 'generate-utility', 'generate-template', 'create-feature'],
+    },
+    { regex: /\b(refactor|rewrite|migrate|extract|rename)\b/, appliesWhen: ['refactor'] },
+    { regex: /\b(test|spec|coverage)\b/, appliesWhen: ['generate-test'] },
+    { regex: /\b(fix|bug|broken|crash)\b/, appliesWhen: ['fix-bug'] },
+    { regex: /\b(review|audit|inspect)\b/, appliesWhen: ['review-pr', 'review-code', 'check-boundaries'] },
+];
+const DOMAIN_APPLIES_WHEN = [
+    { token: 'service', appliesWhen: ['generate-service'] },
+    { token: 'utility', appliesWhen: ['generate-utility'] },
+    { token: 'utilities', appliesWhen: ['generate-utility'] },
+    { token: 'pipeline', appliesWhen: ['create-pipeline'] },
+    { token: 'route', appliesWhen: ['generate-route'] },
+];
+export function deriveAppliesWhen(task) {
+    const text = task.toLowerCase();
+    const out = new Set();
+    for (const v of VERB_APPLIES_WHEN) {
+        if (v.regex.test(text))
+            for (const a of v.appliesWhen)
+                out.add(a);
+    }
+    const tokens = new Set(text.split(/[^a-z0-9]+/).filter((t) => t.length >= 3));
+    for (const d of DOMAIN_APPLIES_WHEN) {
+        if (tokens.has(d.token))
+            for (const a of d.appliesWhen)
+                out.add(a);
+    }
+    return [...out].sort();
+}

package/dist/index.d.ts

@@ -4,5 +4,6 @@ export * from './context-section.js';
 export * from './context-builder.js';
 export * from './token-estimator.js';
 export * from './relevance-selector.js';
+export * from './derive-applies-when.js';
 export * from './ai-context-formatter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -4,4 +4,5 @@ export * from "./context-section.js";
 export * from "./context-builder.js";
 export * from "./token-estimator.js";
 export * from "./relevance-selector.js";
+export * from "./derive-applies-when.js";
 export * from "./ai-context-formatter.js";

package/dist/relevance-selector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relevance-selector.d.ts","sourceRoot":"","sources":["../src/relevance-selector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAeD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,eAAe,EAAE,EACtC,OAAO,EAAE,eAAe,EACxB,eAAe,SAAI,GAClB,eAAe,CAuCjB"}
+{"version":3,"file":"relevance-selector.d.ts","sourceRoot":"","sources":["../src/relevance-selector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAeD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,SAAS,eAAe,EAAE,EACtC,OAAO,EAAE,eAAe,EACxB,eAAe,SAAI,GAClB,eAAe,CAgDjB"}

package/dist/relevance-selector.js

@@ -1,4 +1,5 @@
 import { KnowledgeIndex } from '@shrkcrft/knowledge';
+import { deriveAppliesWhen } from "./derive-applies-when.js";
 const TYPE_BUCKETS = {
     rule: 'rules',
     path: 'paths',
@@ -19,11 +20,19 @@ export function selectRelevantEntries(allEntries, request, limitPerSection = 5)
         scope.push(request.framework);
     if (request.area)
         scope.push(request.area);
+    // Merge any explicit appliesWhen with tokens derived from the task verbs /
+    // domain so foundational rules that key on `appliesWhen` (e.g.
+    // architecture.layer-order on 'generate-code') earn a match reason for a task
+    // whose wording doesn't overlap the rule. Without this they score 0 reasons
+    // and are dropped before priority matters.
+    const appliesWhen = [
+        ...new Set([...(request.appliesWhen ?? []), ...deriveAppliesWhen(request.task)]),
+    ];
     const searchAll = index.search({
         query: request.task,
         scope,
         tags,
-        appliesWhen: request.appliesWhen,
+        appliesWhen,
     });
     const buckets = {
         rules: [],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/context",
-  "version": "0.1.0-alpha.18",
+  "version": "0.1.0-alpha.19",
   "description": "SharkCraft AI context builder: token-budgeted relevance retrieval for tasks.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -44,11 +44,11 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.18",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.18",
-    "@shrkcrft/rules": "^0.1.0-alpha.18",
-    "@shrkcrft/paths": "^0.1.0-alpha.18",
-    "@shrkcrft/templates": "^0.1.0-alpha.18"
+    "@shrkcrft/core": "^0.1.0-alpha.19",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.19",
+    "@shrkcrft/rules": "^0.1.0-alpha.19",
+    "@shrkcrft/paths": "^0.1.0-alpha.19",
+    "@shrkcrft/templates": "^0.1.0-alpha.19"
   },
   "publishConfig": {
     "access": "public"