@shrkcrft/rule-graph 0.1.0-alpha.20 → 0.1.0-alpha.22

package/dist/bridge/knowledge-rule-matching.d.ts

@@ -1,33 +1,11 @@
 /**
- * Heuristic file matchers for IKnowledgeEntry-style rules.
+ * Heuristic file matchers for knowledge-model rules.
  *
- * Rules in the knowledge model don't carry path patterns directly the
- * way boundary rules do. The bridge needs to know "which files does
- * this rule apply to?" — we derive that from two sources, in order:
- *
- *   1. **Explicit**: `rule.metadata.appliesTo` — an array of glob
- *      patterns. Authoritative when present.
- *   2. **Tag-based heuristics**: well-known tags map to file
- *      patterns. For example a rule tagged `mcp` likely applies to
- *      files under `packages/mcp-server/**`. The map is intentionally
- *      conservative — when no tag matches, the rule is *not* bridged
- *      (better silent than noisy).
- *
- * Authors who want predictable bridging set `metadata.appliesTo`.
+ * The implementation moved DOWN to `@shrkcrft/rules` (`rule-applicability.ts`)
+ * so the inspector's `shrk why <file>` can share the exact same per-file rule
+ * applicability the bridge uses here — otherwise the two surfaces drift on which
+ * rules apply to a file. This module re-exports it for backward compatibility
+ * (the bridge builder + the package barrel still import from here).
  */
-export interface IRuleApplicability {
-    /** Glob patterns to match against file paths. */
-    patterns: readonly string[];
-    /**
-     * When non-empty, the rule applies to every file whose `tags` array
-     * intersects this set. Currently used by `testing`-tagged rules.
-     */
-    fileTags: readonly string[];
-    /** How we derived the applicability — useful for diagnostics. */
-    source: 'metadata' | 'tags' | 'none';
-}
-export declare function deriveApplicability(rule: {
-    tags?: readonly string[];
-    metadata?: Readonly<Record<string, unknown>>;
-}): IRuleApplicability;
+export { deriveApplicability, type IRuleApplicability } from '@shrkcrft/rules';
 //# sourceMappingURL=knowledge-rule-matching.d.ts.map

package/dist/bridge/knowledge-rule-matching.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-rule-matching.d.ts","sourceRoot":"","sources":["../../src/bridge/knowledge-rule-matching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAyBH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B;;;OAGG;IACH,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,iEAAiE;IACjE,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;CACtC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC9C,GAAG,kBAAkB,CAwBrB"}
+{"version":3,"file":"knowledge-rule-matching.d.ts","sourceRoot":"","sources":["../../src/bridge/knowledge-rule-matching.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/bridge/knowledge-rule-matching.js

@@ -1,65 +1,10 @@
 /**
- * Heuristic file matchers for IKnowledgeEntry-style rules.
+ * Heuristic file matchers for knowledge-model rules.
  *
- * Rules in the knowledge model don't carry path patterns directly the
- * way boundary rules do. The bridge needs to know "which files does
- * this rule apply to?" — we derive that from two sources, in order:
- *
- *   1. **Explicit**: `rule.metadata.appliesTo` — an array of glob
- *      patterns. Authoritative when present.
- *   2. **Tag-based heuristics**: well-known tags map to file
- *      patterns. For example a rule tagged `mcp` likely applies to
- *      files under `packages/mcp-server/**`. The map is intentionally
- *      conservative — when no tag matches, the rule is *not* bridged
- *      (better silent than noisy).
- *
- * Authors who want predictable bridging set `metadata.appliesTo`.
+ * The implementation moved DOWN to `@shrkcrft/rules` (`rule-applicability.ts`)
+ * so the inspector's `shrk why <file>` can share the exact same per-file rule
+ * applicability the bridge uses here — otherwise the two surfaces drift on which
+ * rules apply to a file. This module re-exports it for backward compatibility
+ * (the bridge builder + the package barrel still import from here).
  */
-const TAG_PATTERNS = new Map([
-    // Engine packages.
-    ['mcp', ['packages/mcp-server/**']],
-    ['cli', ['packages/cli/**']],
-    ['dashboard', ['packages/dashboard/**', 'packages/dashboard-api/**']],
-    ['generator', ['packages/generator/**']],
-    ['importer', ['packages/importer/**']],
-    ['inspector', ['packages/inspector/**']],
-    ['packs', ['packages/packs/**']],
-    ['core', ['packages/core/**']],
-    // Asset categories.
-    ['boundaries', ['sharkcraft/boundaries.ts', 'packages/boundaries/**']],
-    ['rules', ['sharkcraft/rules.ts', 'packages/rules/**']],
-    ['paths', ['sharkcraft/paths.ts', 'packages/paths/**']],
-    ['templates', ['sharkcraft/templates.ts', 'packages/templates/**']],
-    ['pipelines', ['sharkcraft/pipelines.ts', 'packages/pipelines/**']],
-    ['presets', ['sharkcraft/presets.ts', 'packages/presets/**']],
-    // Cross-cutting concerns.
-    ['imports', ['packages/**/*.ts']],
-    ['testing', []], // signal-only; the bridge attaches via the file's `tags: test` separately
-    ['tests', []],
-]);
-export function deriveApplicability(rule) {
-    const explicit = rule.metadata?.['appliesTo'];
-    if (Array.isArray(explicit) && explicit.every((p) => typeof p === 'string')) {
-        return { patterns: explicit, fileTags: [], source: 'metadata' };
-    }
-    const tags = rule.tags ?? [];
-    const patterns = [];
-    const fileTags = [];
-    for (const tag of tags) {
-        if (tag === 'testing' || tag === 'tests') {
-            fileTags.push('test');
-            continue;
-        }
-        const mapped = TAG_PATTERNS.get(tag);
-        if (mapped) {
-            for (const p of mapped) {
-                if (!patterns.includes(p))
-                    patterns.push(p);
-            }
-        }
-    }
-    if (patterns.length === 0 && fileTags.length === 0) {
-        return { patterns: [], fileTags: [], source: 'none' };
-    }
-    return { patterns, fileTags, source: 'tags' };
-}
+export { deriveApplicability } from '@shrkcrft/rules';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/rule-graph",
-  "version": "0.1.0-alpha.20",
+  "version": "0.1.0-alpha.22",
   "description": "SharkCraft rule-graph: bridges code-graph file nodes to rules / paths / templates / boundaries so 'which assets apply to this file?' is a 1-hop query.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -43,10 +43,11 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.20",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.20",
-    "@shrkcrft/graph": "^0.1.0-alpha.20",
-    "@shrkcrft/inspector": "^0.1.0-alpha.20"
+    "@shrkcrft/core": "^0.1.0-alpha.22",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.22",
+    "@shrkcrft/rules": "^0.1.0-alpha.22",
+    "@shrkcrft/graph": "^0.1.0-alpha.22",
+    "@shrkcrft/inspector": "^0.1.0-alpha.22"
   },
   "publishConfig": {
     "access": "public"