@gobing-ai/ts-rule-engine 0.2.9 → 0.3.1

package/dist/host/bundled-rules.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Resolve the absolute path to the rule presets bundled with
+ * `@gobing-ai/ts-rule-engine`.
+ *
+ * The directory ships portable presets (`recommended`, `spur-dev`) and category
+ * folders (`typescript`, `structure`, `quality`) so a consumer gets a working
+ * default ruleset without authoring any files. Pass the returned path as the
+ * lowest-priority entry to {@link loadPreset}'s `roots`, letting project-local
+ * and user-global roots shadow individual files while inheriting the rest.
+ *
+ * Resolution walks up from this module's compiled location (under `dist/` at
+ * runtime, under `src/` in tests) until it finds the bundled `rules/` directory,
+ * which makes it robust to the build's `src`→`dist` layout shift. Returns `null`
+ * if the directory is absent (e.g. a partial install that excluded the assets).
+ */
+export declare function bundledRulesRoot(): string | null;
+/**
+ * List the relative paths of every bundled rule asset (presets and category rule
+ * files), each as a `/`-joined path relative to {@link bundledRulesRoot}.
+ *
+ * Intended for consumers that copy the bundled rules into a writable location
+ * (e.g. a per-user global rules directory) on first run. Returns an empty array
+ * when no bundled directory is present.
+ */
+export declare function listBundledRuleFiles(): string[];
+//# sourceMappingURL=bundled-rules.d.ts.map

package/dist/host/bundled-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-rules.d.ts","sourceRoot":"","sources":["../../src/host/bundled-rules.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEhD;AAoBD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAI/C"}

package/dist/host/bundled-rules.js

@@ -0,0 +1,76 @@
+import { dirnamePath, joinPath, NodeSyncFileSystem } from '@gobing-ai/ts-runtime';
+/**
+ * Directory name holding the rule presets and category folders bundled with this
+ * package. Lives at the package root (sibling to `dist/`), shipped via the
+ * package `files` allowlist.
+ */
+const BUNDLED_RULES_DIR = 'rules';
+/** Memoized result so the upward filesystem walk runs at most once per process. */
+let cachedRoot;
+const defaultFs = new NodeSyncFileSystem();
+/**
+ * Resolve the absolute path to the rule presets bundled with
+ * `@gobing-ai/ts-rule-engine`.
+ *
+ * The directory ships portable presets (`recommended`, `spur-dev`) and category
+ * folders (`typescript`, `structure`, `quality`) so a consumer gets a working
+ * default ruleset without authoring any files. Pass the returned path as the
+ * lowest-priority entry to {@link loadPreset}'s `roots`, letting project-local
+ * and user-global roots shadow individual files while inheriting the rest.
+ *
+ * Resolution walks up from this module's compiled location (under `dist/` at
+ * runtime, under `src/` in tests) until it finds the bundled `rules/` directory,
+ * which makes it robust to the build's `src`→`dist` layout shift. Returns `null`
+ * if the directory is absent (e.g. a partial install that excluded the assets).
+ */
+export function bundledRulesRoot() {
+    return bundledRulesRootWithFs(defaultFs);
+}
+function bundledRulesRootWithFs(fs) {
+    if (cachedRoot !== undefined)
+        return cachedRoot;
+    let dir = import.meta.dirname;
+    // Walk to filesystem root at most; the package root is only a few levels up.
+    while (true) {
+        const candidate = joinPath(dir, BUNDLED_RULES_DIR);
+        if (fs.stat(candidate)?.isDirectory() === true) {
+            cachedRoot = candidate;
+            return cachedRoot;
+        }
+        const parent = dirnamePath(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    cachedRoot = null;
+    return cachedRoot;
+}
+/**
+ * List the relative paths of every bundled rule asset (presets and category rule
+ * files), each as a `/`-joined path relative to {@link bundledRulesRoot}.
+ *
+ * Intended for consumers that copy the bundled rules into a writable location
+ * (e.g. a per-user global rules directory) on first run. Returns an empty array
+ * when no bundled directory is present.
+ */
+export function listBundledRuleFiles() {
+    const root = bundledRulesRoot();
+    if (root === null)
+        return [];
+    return walk(defaultFs, root, '').sort();
+}
+/** Recursively collect YAML/JSON files under `dir`, returning paths relative to the walk origin. */
+function walk(fs, dir, relPrefix) {
+    const acc = [];
+    for (const entry of fs.readDir(dir)) {
+        const abs = joinPath(dir, entry);
+        const rel = relPrefix.length > 0 ? `${relPrefix}/${entry}` : entry;
+        if (fs.stat(abs)?.isDirectory() === true) {
+            acc.push(...walk(fs, abs, rel));
+        }
+        else if (/\.(ya?ml|json)$/i.test(entry)) {
+            acc.push(rel);
+        }
+    }
+    return acc;
+}

package/dist/host/capability-registry.d.ts

@@ -1,24 +1,10 @@
-/** Registry origin for a host capability. */
-export type CapabilityOrigin = 'builtin' | 'extension';
-/** Registry entry metadata. */
-export interface CapabilityEntry<TCapability> {
-    /** Capability implementation. */
-    capability: TCapability;
-    /** Registration origin. */
-    origin: CapabilityOrigin;
-}
-/** Typed registry used by the rule engine host. */
-export declare class CapabilityRegistry<TCapability> {
-    private readonly kind;
-    private readonly capabilities;
-    constructor(kind: string);
-    /** Register or replace a capability. */
-    register(name: string, capability: TCapability, origin?: CapabilityOrigin): void;
-    /** Return true when a capability exists. */
-    has(name: string): boolean;
-    /** Get a registered capability or throw a clear error. */
-    get(name: string): TCapability;
-    /** List registered capability names. */
-    list(): string[];
-}
+/**
+ * Compatibility re-export (ADR-010 / task 0008).
+ *
+ * The capability registry now lives in the shared plugin core
+ * (`@gobing-ai/ts-runtime/plugin`). This module re-exports it from the original
+ * path so the public barrel and existing importers keep working unchanged. New
+ * code should import from `@gobing-ai/ts-runtime/plugin` directly.
+ */
+export { type CapabilityEntry, type CapabilityOrigin, CapabilityRegistry } from '@gobing-ai/ts-runtime/plugin';
 //# sourceMappingURL=capability-registry.d.ts.map

package/dist/host/capability-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability-registry.d.ts","sourceRoot":"","sources":["../../src/host/capability-registry.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,WAAW,CAAC;AAEvD,+BAA+B;AAC/B,MAAM,WAAW,eAAe,CAAC,WAAW;IACxC,iCAAiC;IACjC,UAAU,EAAE,WAAW,CAAC;IACxB,2BAA2B;IAC3B,MAAM,EAAE,gBAAgB,CAAC;CAC5B;AAED,mDAAmD;AACnD,qBAAa,kBAAkB,CAAC,WAAW;IAG3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmD;gBAEnD,IAAI,EAAE,MAAM;IAEzC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAE,gBAA8B,GAAG,IAAI;IAI7F,4CAA4C;IAC5C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,0DAA0D;IAC1D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW;IAQ9B,wCAAwC;IACxC,IAAI,IAAI,MAAM,EAAE;CAGnB"}
+{"version":3,"file":"capability-registry.d.ts","sourceRoot":"","sources":["../../src/host/capability-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/host/capability-registry.js

@@ -1,28 +1,9 @@
-/** Typed registry used by the rule engine host. */
-export class CapabilityRegistry {
-    kind;
-    capabilities = new Map();
-    constructor(kind) {
-        this.kind = kind;
-    }
-    /** Register or replace a capability. */
-    register(name, capability, origin = 'extension') {
-        this.capabilities.set(name, { capability, origin });
-    }
-    /** Return true when a capability exists. */
-    has(name) {
-        return this.capabilities.has(name);
-    }
-    /** Get a registered capability or throw a clear error. */
-    get(name) {
-        const entry = this.capabilities.get(name);
-        if (entry === undefined) {
-            throw new Error(`Unknown ${this.kind}: ${name}`);
-        }
-        return entry.capability;
-    }
-    /** List registered capability names. */
-    list() {
-        return [...this.capabilities.keys()];
-    }
-}
+/**
+ * Compatibility re-export (ADR-010 / task 0008).
+ *
+ * The capability registry now lives in the shared plugin core
+ * (`@gobing-ai/ts-runtime/plugin`). This module re-exports it from the original
+ * path so the public barrel and existing importers keep working unchanged. New
+ * code should import from `@gobing-ai/ts-runtime/plugin` directly.
+ */
+export { CapabilityRegistry } from '@gobing-ai/ts-runtime/plugin';

package/dist/index.d.ts

@@ -5,6 +5,7 @@ export * from './fixers/fixers';
 export * from './fixers/test-stub-fixer';
 export * from './formatters/json';
 export * from './formatters/text';
+export * from './host/bundled-rules';
 export * from './host/capability-registry';
 export * from './host/rule-engine-host';
 export * from './resolvers/test-path-resolver';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -5,6 +5,7 @@ export * from './fixers/fixers.js';
 export * from './fixers/test-stub-fixer.js';
 export * from './formatters/json.js';
 export * from './formatters/text.js';
+export * from './host/bundled-rules.js';
 export * from './host/capability-registry.js';
 export * from './host/rule-engine-host.js';
 export * from './resolvers/test-path-resolver.js';

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,3 +1,4 @@
+import { assertRelativeExtensionPath } from '@gobing-ai/ts-runtime/plugin';
 import { z } from 'zod';
 /** Create a finding with inherited rule severity. */
 export function createFinding(rule, message, filePath, extras = {}) {
@@ -39,16 +40,23 @@ export const ConstraintRuleSchema = z.object({
  *
  * Rejects absolute paths and `..` traversal: extension declarations are data, and a
  * path that escapes the declaring file's directory is a trust-boundary violation even
- * when extension loading is explicitly allowed.
+ * when extension loading is explicitly allowed. The actual guard is the shared
+ * `assertRelativeExtensionPath` (ADR-010) so schema-time validation here and load-time
+ * validation in the shared loader use one source of truth.
  */
 const relativeExtensionPath = z
     .string()
     .min(1)
-    .refine((value) => !/^([/\\]|[A-Za-z]:[/\\])/.test(value), {
-    message: 'extension path must be relative (no absolute paths)',
-})
-    .refine((value) => !value.split(/[/\\]/).includes('..'), {
-    message: 'extension path must not contain ".." traversal',
+    .superRefine((value, ctx) => {
+    try {
+        assertRelativeExtensionPath(value);
+    }
+    catch (error) {
+        ctx.addIssue({
+            code: 'custom',
+            message: error instanceof Error ? error.message : 'invalid extension path',
+        });
+    }
 });
 /**
  * Shared zod schema for an `extensions` block, used by both preset and rule-file

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-rule-engine",
-    "version": "0.2.9",
+    "version": "0.3.1",
     "description": "@gobing-ai/ts-rule-engine — Constraint rule schemas, loading, evaluation, and result formatting.",
     "keywords": [
         "typescript",
@@ -32,6 +32,7 @@
     },
     "files": [
         "dist",
+        "rules",
         "schemas",
         "src",
         "README.md"
@@ -48,10 +49,10 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-rule-engine-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-ai-runner": "^0.2.9",
-        "@gobing-ai/ts-db": "^0.2.9",
-        "@gobing-ai/ts-runtime": "^0.2.9",
-        "@gobing-ai/ts-utils": "^0.2.9",
+        "@gobing-ai/ts-ai-runner": "^0.3.1",
+        "@gobing-ai/ts-db": "^0.3.1",
+        "@gobing-ai/ts-runtime": "^0.3.1",
+        "@gobing-ai/ts-utils": "^0.3.1",
         "yaml": "^2.7.0",
         "zod": "^4.1.0"
     },

package/rules/quality/coverage-gate.yaml

@@ -0,0 +1,21 @@
+# Coverage gate — per-file line coverage must meet threshold.
+rules:
+  - id: coverage-gate
+    description: "Per-file line coverage meets threshold (read from lcov)"
+    severity: error
+    evaluator:
+      type: coverage-gate
+      config:
+        lcovPath: coverage/lcov.info
+        threshold: 90
+        include:
+          - "apps/**"
+          - "packages/**"
+        exclude:
+          - "**/*.test.ts"
+          - "**/*.test.tsx"
+          - "**/*.spec.ts"
+          - "**/*.spec.tsx"
+          - "**/node_modules/**"
+          - "**/drizzle/**"
+          - "scripts/**"

package/rules/quality/tsdoc-exports.yaml

@@ -0,0 +1,24 @@
+# TSDoc export rules — every public export must carry a JSDoc comment.
+rules:
+  - id: every-export-has-tsdoc
+    description: "Every export (function, class, interface, type, const, enum) must have a /** ... */ JSDoc comment describing what it is and why."
+    severity: error
+    evaluator:
+      type: tsdoc-export
+      config:
+        kinds:
+          - function
+          - class
+          - interface
+          - type
+          - const
+          - enum
+    include:
+      - "packages/**/src/**/*.ts"
+      - "apps/**/src/**/*.ts"
+    exclude:
+      - "**/index.ts"
+      - "**/node_modules/**"
+      - "**/tests/**"
+      - "**/*.test.ts"
+      - "**/*.test.tsx"

package/rules/recommended.yaml

@@ -0,0 +1,10 @@
+# Recommended preset — portable rule categories for TypeScript projects.
+# Use with: spur rule run --preset recommended
+#
+# Bundled with @gobing-ai/ts-rule-engine. A project may override individual rule
+# files by placing same-named files under its local .spur/rules/ root.
+name: recommended
+extends:
+  - typescript
+  - structure
+  - quality

package/rules/spur-dev.yaml

@@ -0,0 +1,6 @@
+# Development preset — stricter rules for development workflow.
+# Use with: spur rule run --preset spur-dev --rule coverage-gate --fail-on warning
+name: spur-dev
+extends:
+  - typescript
+  - quality

package/rules/structure/test-location.yaml

@@ -0,0 +1,38 @@
+# Test location rules — tests must live in tests/ directories mirroring src/.
+# No __tests__ directories, no .test.ts files under src/.
+rules:
+  - id: no-tests-dir
+    description: "Tests must live in tests/ directories at the same level as src/, not in __tests__."
+    severity: error
+    evaluator:
+      type: test-location
+      config:
+        expected: "**/*.test.*"
+        forbid:
+          - "**/__tests__/**"
+          - "**/src/**/*.test.ts"
+          - "**/src/**/*.test.tsx"
+        requireCorrespondingTest: false
+    include:
+      - "packages/**/tests/**/*.test.ts"
+      - "apps/**/tests/**/*.test.ts"
+      - "packages/**/tests/**/*.test.tsx"
+      - "apps/**/tests/**/*.test.tsx"
+
+  - id: require-corresponding-test
+    description: "Every source file must have a corresponding test file in tests/."
+    severity: warning
+    evaluator:
+      type: test-location
+      config:
+        expected: "**/*.test.*"
+        requireCorrespondingTest: true
+    include:
+      - "packages/**/src/**/*.ts"
+      - "apps/**/src/**/*.ts"
+    exclude:
+      - "**/index.ts"
+      - "**/*.d.ts"
+      - "**/types.ts"
+      - "**/node_modules/**"
+      - "**/tests/**"

package/rules/typescript/no-biome-suppressions.yaml

@@ -0,0 +1,23 @@
+# No Biome suppression comments — disallow biome-ignore comments.
+# Lint issues must be fixed at the source, not silenced.
+include:
+  - "packages/**/src/**/*.ts"
+  - "packages/**/src/**/*.tsx"
+  - "apps/**/src/**/*.ts"
+  - "apps/**/src/**/*.tsx"
+  - "packages/**/tests/**/*.ts"
+  - "packages/**/tests/**/*.tsx"
+  - "apps/**/tests/**/*.ts"
+  - "apps/**/tests/**/*.tsx"
+exclude:
+  - "**/node_modules/**"
+rules:
+  - id: no-biome-suppressions
+    description: >
+      Do not use biome-ignore or biome-ignore-all comments to suppress lint
+      rules.  Fix the underlying issue instead.
+    severity: error
+    evaluator:
+      type: regex
+      config:
+        pattern: "biome-ignore"

package/src/host/bundled-rules.ts

@@ -0,0 +1,78 @@
+import { dirnamePath, joinPath, NodeSyncFileSystem, type SyncFileSystem } from '@gobing-ai/ts-runtime';
+
+/**
+ * Directory name holding the rule presets and category folders bundled with this
+ * package. Lives at the package root (sibling to `dist/`), shipped via the
+ * package `files` allowlist.
+ */
+const BUNDLED_RULES_DIR = 'rules';
+
+/** Memoized result so the upward filesystem walk runs at most once per process. */
+let cachedRoot: string | null | undefined;
+const defaultFs = new NodeSyncFileSystem();
+
+/**
+ * Resolve the absolute path to the rule presets bundled with
+ * `@gobing-ai/ts-rule-engine`.
+ *
+ * The directory ships portable presets (`recommended`, `spur-dev`) and category
+ * folders (`typescript`, `structure`, `quality`) so a consumer gets a working
+ * default ruleset without authoring any files. Pass the returned path as the
+ * lowest-priority entry to {@link loadPreset}'s `roots`, letting project-local
+ * and user-global roots shadow individual files while inheriting the rest.
+ *
+ * Resolution walks up from this module's compiled location (under `dist/` at
+ * runtime, under `src/` in tests) until it finds the bundled `rules/` directory,
+ * which makes it robust to the build's `src`→`dist` layout shift. Returns `null`
+ * if the directory is absent (e.g. a partial install that excluded the assets).
+ */
+export function bundledRulesRoot(): string | null {
+    return bundledRulesRootWithFs(defaultFs);
+}
+
+function bundledRulesRootWithFs(fs: SyncFileSystem): string | null {
+    if (cachedRoot !== undefined) return cachedRoot;
+    let dir = import.meta.dirname;
+    // Walk to filesystem root at most; the package root is only a few levels up.
+    while (true) {
+        const candidate = joinPath(dir, BUNDLED_RULES_DIR);
+        if (fs.stat(candidate)?.isDirectory() === true) {
+            cachedRoot = candidate;
+            return cachedRoot;
+        }
+        const parent = dirnamePath(dir);
+        if (parent === dir) break;
+        dir = parent;
+    }
+    cachedRoot = null;
+    return cachedRoot;
+}
+
+/**
+ * List the relative paths of every bundled rule asset (presets and category rule
+ * files), each as a `/`-joined path relative to {@link bundledRulesRoot}.
+ *
+ * Intended for consumers that copy the bundled rules into a writable location
+ * (e.g. a per-user global rules directory) on first run. Returns an empty array
+ * when no bundled directory is present.
+ */
+export function listBundledRuleFiles(): string[] {
+    const root = bundledRulesRoot();
+    if (root === null) return [];
+    return walk(defaultFs, root, '').sort();
+}
+
+/** Recursively collect YAML/JSON files under `dir`, returning paths relative to the walk origin. */
+function walk(fs: SyncFileSystem, dir: string, relPrefix: string): string[] {
+    const acc: string[] = [];
+    for (const entry of fs.readDir(dir)) {
+        const abs = joinPath(dir, entry);
+        const rel = relPrefix.length > 0 ? `${relPrefix}/${entry}` : entry;
+        if (fs.stat(abs)?.isDirectory() === true) {
+            acc.push(...walk(fs, abs, rel));
+        } else if (/\.(ya?ml|json)$/i.test(entry)) {
+            acc.push(rel);
+        }
+    }
+    return acc;
+}

package/src/host/capability-registry.ts

@@ -1,41 +1,9 @@
-/** Registry origin for a host capability. */
-export type CapabilityOrigin = 'builtin' | 'extension';
-
-/** Registry entry metadata. */
-export interface CapabilityEntry<TCapability> {
-    /** Capability implementation. */
-    capability: TCapability;
-    /** Registration origin. */
-    origin: CapabilityOrigin;
-}
-
-/** Typed registry used by the rule engine host. */
-export class CapabilityRegistry<TCapability> {
-    private readonly capabilities = new Map<string, CapabilityEntry<TCapability>>();
-
-    constructor(private readonly kind: string) {}
-
-    /** Register or replace a capability. */
-    register(name: string, capability: TCapability, origin: CapabilityOrigin = 'extension'): void {
-        this.capabilities.set(name, { capability, origin });
-    }
-
-    /** Return true when a capability exists. */
-    has(name: string): boolean {
-        return this.capabilities.has(name);
-    }
-
-    /** Get a registered capability or throw a clear error. */
-    get(name: string): TCapability {
-        const entry = this.capabilities.get(name);
-        if (entry === undefined) {
-            throw new Error(`Unknown ${this.kind}: ${name}`);
-        }
-        return entry.capability;
-    }
-
-    /** List registered capability names. */
-    list(): string[] {
-        return [...this.capabilities.keys()];
-    }
-}
+/**
+ * Compatibility re-export (ADR-010 / task 0008).
+ *
+ * The capability registry now lives in the shared plugin core
+ * (`@gobing-ai/ts-runtime/plugin`). This module re-exports it from the original
+ * path so the public barrel and existing importers keep working unchanged. New
+ * code should import from `@gobing-ai/ts-runtime/plugin` directly.
+ */
+export { type CapabilityEntry, type CapabilityOrigin, CapabilityRegistry } from '@gobing-ai/ts-runtime/plugin';

package/src/index.ts

@@ -5,6 +5,7 @@ export * from './fixers/fixers';
 export * from './fixers/test-stub-fixer';
 export * from './formatters/json';
 export * from './formatters/text';
+export * from './host/bundled-rules';
 export * from './host/capability-registry';
 export * from './host/rule-engine-host';
 export * from './resolvers/test-path-resolver';

package/src/types.ts

@@ -1,3 +1,4 @@
+import { assertRelativeExtensionPath } from '@gobing-ai/ts-runtime/plugin';
 import { z } from 'zod';
 
 /** Finding severity emitted by the rule engine. */
@@ -218,16 +219,22 @@ export const ConstraintRuleSchema = z.object({
  *
  * Rejects absolute paths and `..` traversal: extension declarations are data, and a
  * path that escapes the declaring file's directory is a trust-boundary violation even
- * when extension loading is explicitly allowed.
+ * when extension loading is explicitly allowed. The actual guard is the shared
+ * `assertRelativeExtensionPath` (ADR-010) so schema-time validation here and load-time
+ * validation in the shared loader use one source of truth.
  */
 const relativeExtensionPath = z
     .string()
     .min(1)
-    .refine((value) => !/^([/\\]|[A-Za-z]:[/\\])/.test(value), {
-        message: 'extension path must be relative (no absolute paths)',
-    })
-    .refine((value) => !value.split(/[/\\]/).includes('..'), {
-        message: 'extension path must not contain ".." traversal',
+    .superRefine((value, ctx) => {
+        try {
+            assertRelativeExtensionPath(value);
+        } catch (error) {
+            ctx.addIssue({
+                code: 'custom',
+                message: error instanceof Error ? error.message : 'invalid extension path',
+            });
+        }
     });
 
 /**