@hongmaple0820/dsh-scale 0.0.0-stage → 0.1.0

package/lib/evidenceBridge.js

@@ -0,0 +1,92 @@
+// dsh-scale: Evidence Bridge — post-execute evidence recording
+// Hooks into tools/post-execute and records into SCALE's RuntimeEvidenceLedger.
+//
+// Plan §6 T1.3: the ledger's sync record() is writeFileSync — running that on
+// every tool call would block the DSH Electron host's event loop. So:
+//   - writes go through recordAsync() (fs/promises, added for this bridge)
+//   - writes are serialized through a promise chain (order preserved,
+//     unbounded concurrency impossible)
+//   - default mode 'failures-only': successful tool calls are not persisted
+//     until the write-volume impact is measured (plan U8); 'all' records both
+import { RuntimeEvidenceLedger } from '@hongmaple0820/scale-engine';
+// Per-projectDir ledgers — a DSH session may serve multiple workspaces
+const ledgers = new Map();
+const ledgerErrors = new Map();
+let writeQueue = Promise.resolve();
+/** Await all in-flight evidence writes (tests, graceful shutdown). */
+export function pendingEvidenceWrites() {
+    return writeQueue;
+}
+/** Reset module state — plugin unload (ctx.effect disposer) and tests. */
+export function resetEvidenceBridge() {
+    ledgers.clear();
+    ledgerErrors.clear();
+    writeQueue = Promise.resolve();
+}
+function getLedger(projectDir) {
+    if (ledgers.has(projectDir))
+        return ledgers.get(projectDir) ?? null;
+    if (ledgerErrors.has(projectDir))
+        return null;
+    let ledger;
+    try {
+        ledger = new RuntimeEvidenceLedger({ projectDir, createDirs: true });
+    }
+    catch (err) {
+        ledgerErrors.set(projectDir, err instanceof Error ? err : new Error(String(err)));
+        ledger = null;
+    }
+    ledgers.set(projectDir, ledger);
+    return ledger;
+}
+/**
+ * Record a tool execution. Fire-and-forget: enqueues an async write and
+ * returns immediately — evidence must never block or fail the tool result.
+ */
+export function recordToolEvidence(params) {
+    const mode = params.mode ?? 'failures-only';
+    if (mode === 'failures-only' && !params.error)
+        return;
+    const ledger = getLedger(params.projectDir);
+    if (!ledger)
+        return;
+    const filePath = typeof params.args?.file_path === 'string' ? params.args.file_path : undefined;
+    const summary = params.error
+        ? `Failed or blocked tool call: ${params.toolName}`
+        : `Executed: ${params.toolName}`;
+    const resultPreview = (() => {
+        if (params.result === null || params.result === undefined)
+            return '';
+        if (typeof params.result === 'object') {
+            try {
+                return JSON.stringify(params.result).slice(0, 500);
+            }
+            catch {
+                return '[unserializable]';
+            }
+        }
+        return String(params.result).slice(0, 500);
+    })();
+    writeQueue = writeQueue
+        .then(() => ledger.recordAsync({
+        sessionId: params.sessionId,
+        kind: 'tool',
+        title: `DSH: ${params.toolName}`,
+        status: params.error ? 'failed' : 'passed',
+        command: params.toolName,
+        exitCode: params.error ? 2 : 0,
+        summary,
+        artifacts: filePath ? [filePath] : undefined,
+        metadata: {
+            args: params.args,
+            result: resultPreview,
+            source: 'dsh-scale',
+            mode,
+        },
+    }))
+        .then(() => undefined)
+        .catch(() => {
+        // Evidence recording is best-effort; never surface into the tool pipeline
+    });
+}
+//# sourceMappingURL=evidenceBridge.js.map

package/lib/evidenceBridge.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,33 @@
+import Schema from 'schemastery';
+import type { CordisContext } from './dshTypes.js';
+import { type EvidenceMode } from './evidenceBridge.js';
+export interface ScalePluginConfig {
+    projectDir?: string;
+    enableShield?: boolean;
+    enableCortex?: boolean;
+    enableEvidence?: boolean;
+    enableCommands?: boolean;
+    enableSkills?: boolean;
+    /** 'failures-only' (default): record failed/blocked calls only (plan U8); 'all': record every call. */
+    evidenceMode?: EvidenceMode;
+}
+export declare const Config: Schema<Schemastery.ObjectS<{
+    projectDir: Schema<string, string>;
+    enableShield: Schema<boolean, boolean>;
+    enableCortex: Schema<boolean, boolean>;
+    enableEvidence: Schema<boolean, boolean>;
+    enableCommands: Schema<boolean, boolean>;
+    enableSkills: Schema<boolean, boolean>;
+    evidenceMode: Schema<"failures-only" | "all", "failures-only" | "all">;
+}>, Schemastery.ObjectT<{
+    projectDir: Schema<string, string>;
+    enableShield: Schema<boolean, boolean>;
+    enableCortex: Schema<boolean, boolean>;
+    enableEvidence: Schema<boolean, boolean>;
+    enableCommands: Schema<boolean, boolean>;
+    enableSkills: Schema<boolean, boolean>;
+    evidenceMode: Schema<"failures-only" | "all", "failures-only" | "all">;
+}>>;
+export declare const name = "dsh-scale";
+export declare const inject: string[];
+export declare function apply(ctx: CordisContext, config?: Partial<ScalePluginConfig>): void;

package/lib/index.js

@@ -0,0 +1,195 @@
+// dsh-scale: SCALE Engine governance plugin for DSH
+// -------------------------------------------
+// Components:
+//   shieldBridge   — tools/pre-execute waterfall (block→deny, warn→ask)
+//   cortexBridge   — systemPrompt.context instinct injection
+//   evidenceBridge — tools/post-execute evidence recording (async, failures-first)
+//
+// Plan §6 T1: "all three bridges in one apply() with ctx.effect cleanup"
+import Schema from 'schemastery';
+import { resolveProjectDir, toShieldInput, evaluateShield } from './shieldBridge.js';
+import { buildCortexContext } from './cortexBridge.js';
+import { recordToolEvidence, resetEvidenceBridge, pendingEvidenceWrites, } from './evidenceBridge.js';
+import { registerScaleCommands } from './commandsBridge.js';
+import { createScaleSkillProvider } from './skillsBridge.js';
+// Cordis validates this export during plugin load (schemastery Schema — a
+// plain object fails with "Cannot read properties of undefined (reading 'validate')")
+export const Config = Schema.object({
+    projectDir: Schema.string().default(''),
+    enableShield: Schema.boolean().default(true),
+    enableCortex: Schema.boolean().default(true),
+    enableEvidence: Schema.boolean().default(true),
+    enableCommands: Schema.boolean().default(true),
+    enableSkills: Schema.boolean().default(true),
+    evidenceMode: Schema.union(['failures-only', 'all']).default('failures-only'),
+});
+export const name = 'dsh-scale';
+// Required services (plan §2.3 / tutorial pitfall 2): accessing a ctx service
+// without declaring it here throws at apply() time.
+export const inject = ['tools', 'systemPrompt', 'commands', 'skills'];
+/**
+ * tools/post-execute argument normalizer. The exact event arity was only
+ * runtime-verified for pre-execute (plan §5.6); handle both the documented
+ * (exec, result, next) shape and the single wrapped-object shape.
+ */
+function normalizePostExecute(args) {
+    const first = args[0];
+    if (args.length >= 2 && first !== null && typeof first === 'object' && 'name' in first) {
+        const result = args[1];
+        return {
+            exec: first,
+            isError: Boolean(result && typeof result === 'object' && 'isError' in result && result.isError),
+            result,
+        };
+    }
+    if (first !== null && typeof first === 'object' && 'execution' in first) {
+        const wrapped = first;
+        return { exec: wrapped.execution ?? {}, isError: Boolean(wrapped.error), result: wrapped.result };
+    }
+    return null;
+}
+// Required by Cordis: the one hook DSH calls for every plugin
+export function apply(ctx, config = {}) {
+    const effective = {
+        enableShield: true,
+        enableCortex: true,
+        enableEvidence: true,
+        enableCommands: true,
+        enableSkills: true,
+        evidenceMode: 'failures-only',
+        ...config,
+    };
+    // =========================================================
+    // Shield: tools/pre-execute waterfall (T1.1)
+    // =========================================================
+    if (effective.enableShield) {
+        ctx.on('tools/pre-execute', async (...args) => {
+            const exec = args[0];
+            const next = args[args.length - 1];
+            // MUST call next() — waterfall: if a prior hook already denied, skip
+            const decision = await next();
+            if (decision && decision.kind !== 'allow')
+                return decision;
+            const projectDir = resolveProjectDir(effective, exec);
+            const input = toShieldInput({ name: exec.name ?? 'unknown', arguments: exec.arguments, agent: exec.agent }, projectDir);
+            return evaluateShield(input);
+        });
+    }
+    // =========================================================
+    // Cortex: system prompt instinct injection (T1.2)
+    // =========================================================
+    if (effective.enableCortex) {
+        const projectDir = effective.projectDir || process.cwd();
+        const entry = buildCortexContext(projectDir);
+        // Single registration; DSH assembles the context into every model turn
+        if (entry && ctx.systemPrompt?.context) {
+            try {
+                ctx.systemPrompt.context(entry.id, entry.content, { order: entry.order });
+            }
+            catch {
+                // context registration is best-effort; Shield/Evidence stay up
+            }
+        }
+    }
+    // =========================================================
+    // Evidence: tools/post-execute recording (T1.3)
+    // =========================================================
+    if (effective.enableEvidence) {
+        const fallbackProjectDir = effective.projectDir || process.cwd();
+        ctx.on('tools/post-execute', async (...args) => {
+            // waterfall: forward first (must not short-circuit the chain), then observe
+            const next = args[args.length - 1];
+            const decision = typeof next === 'function' ? await next() : undefined;
+            const normalized = normalizePostExecute(args);
+            if (normalized) {
+                const projectDir = resolveProjectDir(effective, normalized.exec) || fallbackProjectDir;
+                recordToolEvidence({
+                    toolName: normalized.exec.name ?? 'unknown',
+                    args: normalized.exec.arguments ?? {},
+                    result: normalized.result,
+                    error: normalized.isError,
+                    projectDir,
+                    sessionId: normalized.exec.agent?.id,
+                    mode: effective.evidenceMode,
+                });
+            }
+            return decision;
+        });
+    }
+    // =========================================================
+    // Commands: governance gates as slash commands (T2.1)
+    // =========================================================
+    if (effective.enableCommands) {
+        const registered = registerScaleCommands(ctx, effective);
+        if (registered > 0) {
+            process.stderr.write(`[dsh-scale] registered ${registered} slash commands (scale-*)\n`);
+        }
+    }
+    // =========================================================
+    // Skills: .scale/skills phase workflows into the DSH registry (T2.2)
+    // =========================================================
+    if (effective.enableSkills) {
+        const projectDirFor = () => effective.projectDir || process.cwd();
+        try {
+            ctx.skills?.registerProvider?.(() => createScaleSkillProvider(projectDirFor));
+        }
+        catch {
+            // duplicate provider name (reload) — keep the first registration
+        }
+    }
+    // =========================================================
+    // Cleanup (plan §2.3 — dispose everything explicitly registered here;
+    // ctx.on listeners are tracked by Cordis itself)
+    // =========================================================
+    ctx.effect(() => {
+        return () => {
+            // Drain in-flight evidence writes, then reset bridge state so a later
+            // reload starts clean. Multiple async disposers have no ordering
+            // guarantee (plan §2.3) — this plugin has exactly one.
+            void pendingEvidenceWrites().finally(() => resetEvidenceBridge());
+        };
+    });
+    // =========================================================
+    // Self-test driver (§5.6 pattern — zero API cost, verifiable).
+    // OPT-IN: SCALE_DSH_SELFTEST=1 — never drive probe tool calls in
+    // production sessions.
+    // =========================================================
+    if (process.env.SCALE_DSH_SELFTEST === '1') {
+        // §2.12 fatal rule: any throw from a timer callback disposes the whole
+        // DSH app — the self-test driver must be exception-safe by contract.
+        setTimeout(async () => {
+            try {
+                const tools = ctx.tools;
+                if (!tools?.execute) {
+                    process.stderr.write('[dsh-scale selftest] ctx.tools.execute unavailable; skipping\n');
+                    return;
+                }
+                process.stderr.write('[dsh-scale selftest] apply() running; shieldBridge loaded\n\n');
+                // --- BLOCK: pwsh with recursive force delete (POSIX form — `rm` is a
+                // pwsh alias for Remove-Item; the blocklist matches /\brm\s+-rf\b/) ---
+                process.stderr.write('[selftest] driving BLOCK\n');
+                const blockRes = await tools.execute({ name: 'pwsh', arguments: { command: 'rm -rf /tmp/x' }, signal: new AbortController().signal });
+                process.stderr.write(`[selftest]      RESULT isError=${blockRes.isError}\n`);
+                process.stderr.write(`[selftest]      CONTENT ${JSON.stringify(blockRes.content)}\n`);
+                // --- BLOCK PROTECTED PATH: write to .scale/policy.yaml ---
+                process.stderr.write('[selftest] driving PROTECT\n');
+                const protRes = await tools.execute({ name: 'write', arguments: { file_path: '.scale/policy.yaml', content: 'test' }, signal: new AbortController().signal });
+                process.stderr.write(`[selftest]      RESULT isError=${protRes.isError}\n`);
+                process.stderr.write(`[selftest]      CONTENT ${JSON.stringify(protRes.content)}\n`);
+                // --- ALLOW: harmless pwsh call (no false positives) ---
+                // `read` is agent-scoped in dsh-base and invisible to a contextless
+                // boot-time probe ("unknown tool"); pwsh is globally registered.
+                process.stderr.write('[selftest] driving ALLOW (pwsh Get-Location)\n');
+                const allowRes = await tools.execute({ name: 'pwsh', arguments: { command: 'Get-Location' }, signal: new AbortController().signal });
+                process.stderr.write(`[selftest]      RESULT isError=${allowRes.isError}\n`);
+                process.stderr.write(`[selftest]      CONTENT ${JSON.stringify(allowRes.content).slice(0, 300)}\n`);
+                // Drain evidence writes so blocked calls land before process exit
+                await pendingEvidenceWrites();
+            }
+            catch (err) {
+                process.stderr.write(`[dsh-scale selftest] FAILED: ${err instanceof Error ? err.stack ?? err.message : String(err)}\n`);
+            }
+        }, 500);
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/shieldBridge.d.ts

@@ -0,0 +1,28 @@
+import type { ShieldInput } from '@hongmaple0820/scale-engine';
+export declare function resolveProjectDir(config: {
+    projectDir?: string;
+}, exec: {
+    agent?: {
+        session?: {
+            header?: {
+                cwd?: string;
+            };
+        };
+    };
+}): string;
+export declare function toShieldInput(exec: {
+    name: string;
+    arguments?: Record<string, unknown>;
+    agent?: {
+        id?: string;
+    };
+}, projectDir: string): ShieldInput;
+export interface PreToolDecision {
+    kind: 'allow' | 'deny' | 'cancel' | 'ask';
+    reason?: string;
+    displayReason?: {
+        en: string;
+        [loc: string]: string;
+    };
+}
+export declare function evaluateShield(input: ShieldInput): PreToolDecision;

package/lib/shieldBridge.js

@@ -0,0 +1,74 @@
+// dsh-scale: Shield Bridge — tool interception adapter
+// Maps DSH tool names → SCALE ShieldInput, calls checkToolInput,
+// and maps block/warn → deny/ask.
+//
+// Key properties (plan §6 T1.1):
+// - MUST call next() in waterfall; skip when decision != allow
+// - block → { kind: 'deny' }
+// - warn → { kind: 'ask' } (not silently dropped as in bare hook mode)
+// - mcp__scale__ prefix unpacking (shell_run → Bash semantic)
+// - projectDir per-execution, not fixed at apply time
+import { checkToolInput, checkWarnHits, } from '@hongmaple0820/scale-engine';
+// ---------------------------------------------------------------------------
+// Tool name mapping (plan §6 — empirically verified against DSH's 107 tools)
+// ---------------------------------------------------------------------------
+const TOOL_NAME_MAP = {
+    pwsh: 'Bash',
+    write: 'Write',
+    edit: 'Edit',
+    read: 'Read',
+};
+const MCP_PREFIX = 'mcp__scale__';
+// ---------------------------------------------------------------------------
+// projectDir resolution — per-execution, not at apply time
+// ---------------------------------------------------------------------------
+export function resolveProjectDir(config, exec) {
+    if (config.projectDir)
+        return config.projectDir;
+    if (exec.agent?.session?.header?.cwd)
+        return exec.agent.session.header.cwd;
+    return process.cwd();
+}
+// ---------------------------------------------------------------------------
+// Shield input adapter
+// ---------------------------------------------------------------------------
+export function toShieldInput(exec, projectDir) {
+    let toolName = exec.name;
+    // Unpack mcp__scale__<tool> prefix (plan §6 T1.1)
+    if (toolName.startsWith(MCP_PREFIX)) {
+        const raw = toolName.slice(MCP_PREFIX.length);
+        // shell_run has pwsh semantics for command blocklist matching
+        toolName = raw === 'shell_run' ? 'Bash' : raw;
+    }
+    else {
+        toolName = TOOL_NAME_MAP[toolName] ?? toolName;
+    }
+    return {
+        session_id: exec.agent?.id ?? 'unknown',
+        cwd: projectDir,
+        tool_name: toolName,
+        tool_input: exec.arguments ?? {},
+    };
+}
+export function evaluateShield(input) {
+    const result = checkToolInput(input);
+    if (result.decision === 'block') {
+        return { kind: 'deny', reason: result.reason };
+    }
+    // warn → ask (not silently dropped — plan §6 audit gap fix)
+    if (input.tool_name === 'Bash') {
+        const command = String(input.tool_input?.command ?? '');
+        const warnHits = checkWarnHits(command);
+        if (warnHits.length > 0) {
+            return {
+                kind: 'ask',
+                displayReason: {
+                    en: `[SCALE SHIELD WARN] ${warnHits[0].reason} — ${warnHits[0].category}`,
+                    zh: `【SCALE 盾警告】${warnHits[0].reason} — ${warnHits[0].category}`,
+                },
+            };
+        }
+    }
+    return { kind: 'allow' };
+}
+//# sourceMappingURL=shieldBridge.js.map

package/lib/shieldBridge.js.map

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

package/lib/skillsBridge.d.ts

@@ -0,0 +1,18 @@
+import type { SkillProvider } from './dshTypes.js';
+export declare const SCALE_SKILL_PROVIDER = "scale-engine";
+export interface ScaleSkillEntry {
+    /** kebab-case skill name (from the `# skill:` header, falling back to filename) */
+    name: string;
+    /** phase directory (DEFINE/BUILD/VERIFY/…) */
+    phase: string;
+    description: string;
+    whenToUse?: string;
+    path: string;
+}
+/** Scan .scale/skills/ phase directories for skill markdown files (sync — called once per list()). */
+export declare function scanScaleSkills(projectDir: string): ScaleSkillEntry[];
+/**
+ * Build the DSH skill provider for a project. create() itself is synchronous
+ * (contract); the disk scan runs inside list().
+ */
+export declare function createScaleSkillProvider(projectDir: () => string): SkillProvider;

package/lib/skillsBridge.js

@@ -0,0 +1,123 @@
+// dsh-scale: Skills Bridge (T2.2) — exposes SCALE's phase-workflow skills
+// (.scale/skills/<PHASE>/<name>.md) to DSH's skills registry through a
+// provider. Registration is synchronous (plan §6 T2.2 / dsh-skill contract);
+// body loading happens lazily in get().
+//
+// Deliberately NOT registered: skills.json domain routing metadata — those
+// entries reference external skills from global roots (~/.agents/skills …)
+// that DSH's own skill-filesystem discovery owns; duplicating them here
+// would shadow or double-list third-party skills.
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+export const SCALE_SKILL_PROVIDER = 'scale-engine';
+/** Mid-range: project entries outrank runtime, which outrank user entries (dsh-skill ranks). */
+const SCALE_SKILL_RANK = 100;
+function parseSkillMarkdown(text, fallbackName) {
+    const nameMatch = text.match(/^#\s+skill:\s*(.+)$/m);
+    const purposeMatch = text.match(/^##\s+Purpose\s*$/m);
+    const description = purposeMatch
+        ? (() => {
+            const after = text.slice((purposeMatch.index ?? 0) + purposeMatch[0].length);
+            const nextSection = after.match(/^##\s/m);
+            return (nextSection ? after.slice(0, nextSection.index) : after).trim().split('\n')[0] ?? '';
+        })()
+        : '';
+    const triggerMatch = text.match(/^##\s+Triggers\s*$/m);
+    let whenToUse;
+    if (triggerMatch) {
+        const after = text.slice((triggerMatch.index ?? 0) + triggerMatch[0].length);
+        const nextSection = after.match(/^##\s/m);
+        const triggers = (nextSection ? after.slice(0, nextSection.index) : after)
+            .split('\n').map(l => l.replace(/^[-*]\s*/, '').trim()).filter(Boolean);
+        if (triggers.length > 0)
+            whenToUse = triggers.join('; ').slice(0, 200);
+    }
+    return {
+        name: (nameMatch?.[1] ?? fallbackName).trim().toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, ''),
+        description: description || `SCALE ${fallbackName} phase workflow skill`,
+        whenToUse,
+    };
+}
+const KEBAB = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** Scan .scale/skills/ phase directories for skill markdown files (sync — called once per list()). */
+export function scanScaleSkills(projectDir) {
+    const root = join(projectDir, '.scale', 'skills');
+    let phases;
+    try {
+        phases = readdirSync(root, { withFileTypes: true }).filter(d => d.isDirectory()).map(d => d.name);
+    }
+    catch {
+        return [];
+    }
+    const entries = [];
+    for (const phase of phases) {
+        let files;
+        try {
+            files = readdirSync(join(root, phase)).filter(f => f.endsWith('.md') && f !== '_INDEX.md');
+        }
+        catch {
+            continue;
+        }
+        for (const file of files) {
+            const relPath = `.scale/skills/${phase}/${file}`;
+            let text = '';
+            try {
+                text = readFileSync(join(root, phase, file), 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            const fallback = file.replace(/\.md$/, '');
+            const parsed = parseSkillMarkdown(text, fallback);
+            if (!KEBAB.test(parsed.name))
+                continue;
+            entries.push({
+                name: parsed.name,
+                phase,
+                description: parsed.description,
+                whenToUse: parsed.whenToUse,
+                path: relPath,
+            });
+        }
+    }
+    return entries;
+}
+function toCandidate(entry) {
+    return {
+        name: entry.name,
+        description: entry.description,
+        invocation: { modelInvocable: true, userInvocable: true },
+        source: entry.path,
+        provider: SCALE_SKILL_PROVIDER,
+        rank: SCALE_SKILL_RANK,
+        ...(entry.whenToUse ? { whenToUse: entry.whenToUse } : {}),
+        path: entry.path,
+        locator: entry,
+    };
+}
+/**
+ * Build the DSH skill provider for a project. create() itself is synchronous
+ * (contract); the disk scan runs inside list().
+ */
+export function createScaleSkillProvider(projectDir) {
+    return {
+        name: SCALE_SKILL_PROVIDER,
+        async list() {
+            return scanScaleSkills(projectDir()).map(toCandidate);
+        },
+        async get(candidate) {
+            const entry = candidate.locator;
+            const relPath = entry?.path ?? (typeof candidate.path === 'string' ? candidate.path : null);
+            if (!relPath)
+                return undefined;
+            try {
+                const content = readFileSync(join(projectDir(), relPath), 'utf-8');
+                return { ...candidate, content };
+            }
+            catch {
+                return undefined;
+            }
+        },
+    };
+}
+//# sourceMappingURL=skillsBridge.js.map

package/lib/skillsBridge.js.map

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