@dewtech/dare-cli 3.5.0 → 3.6.0

package/dist/hooks/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/hooks/dispatcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,qBAAqB,EAEtB,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAsB,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE9E,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAa,MAAM,YAAY,CAAC;AAWtF,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;gBAC9B,OAAO,SAAyC;CAI7D;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAU;gBAClC,KAAK,EAAE,MAAM;CAI1B;AAyDD,wBAAsB,YAAY,CAChC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACpD,OAAO,CAAC,UAAU,EAAE,CAAC,CAuGvB;AAED,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,CAAC"}

package/dist/hooks/dispatcher.js

@@ -0,0 +1,157 @@
+import pino from 'pino';
+import { safeSpawn } from '../exec/safe-spawn.js';
+import { resolveAction, ActionNotAllowedError, INTERNAL_ACTIONS, } from './allowlist.js';
+import { shouldSkip, markSeen } from './idempotency.js';
+import { recordHookTrigger } from './telemetry.js';
+import { assertRelativeSafe, PathEscapeError } from '../utils/path-safety.js';
+import { HOOK_EVENTS } from './types.js';
+import { gatesFor, resolveStackFromConfig, formatGateCommand, } from '../dag-runner/ralph-loop.js';
+import { createGraph, loadGraphConfig } from '../graphrag/index.js';
+const logger = pino({ level: process.env.DARE_HOOKS_LOG_LEVEL ?? 'info' });
+export class TrustRequiredError extends Error {
+    constructor(message = 'hooks are untrusted for this project') {
+        super(message);
+        this.code = 'TRUST_REQUIRED';
+        this.name = 'TrustRequiredError';
+    }
+}
+export class InvalidHookEventError extends Error {
+    constructor(event) {
+        super(`Invalid hook event: ${event}`);
+        this.code = 'INVALID_HOOK_EVENT';
+        this.name = 'InvalidHookEventError';
+    }
+}
+const TASK_ID_RE = /^task-[0-9a-z-]+$/;
+const VERDICT_ACTIONS = new Set([
+    'dare-validate',
+    'dare-review',
+    'lint',
+    'test',
+]);
+function isHookEvent(value) {
+    return HOOK_EVENTS.includes(value);
+}
+async function resolveHookStack(projectRoot) {
+    try {
+        const stack = await resolveStackFromConfig(projectRoot);
+        const gates = gatesFor(stack, projectRoot);
+        const lintGate = gates.find((g) => g.name === 'lint');
+        const testGate = gates.find((g) => g.name === 'test');
+        return {
+            lint: lintGate ? formatGateCommand(lintGate) : undefined,
+            test: testGate ? formatGateCommand(testGate) : undefined,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+async function withProjectGraph(projectRoot, fn) {
+    const config = await loadGraphConfig({ cwd: projectRoot });
+    const graph = await createGraph(config, { cwd: projectRoot });
+    try {
+        return await fn(graph);
+    }
+    finally {
+        await Promise.resolve(graph.close());
+    }
+}
+function verdictFor(action, exitCode) {
+    if (!VERDICT_ACTIONS.has(action))
+        return undefined;
+    return exitCode === 0 ? 'pass' : 'fail';
+}
+function isInternalAction(action) {
+    return INTERNAL_ACTIONS.includes(action);
+}
+export async function dispatchHook(config, payload, ctx) {
+    if (config.trusted !== true && ctx.trustOverride !== true) {
+        throw new TrustRequiredError();
+    }
+    if (!isHookEvent(payload.event)) {
+        throw new InvalidHookEventError(String(payload.event));
+    }
+    if (payload.file) {
+        try {
+            assertRelativeSafe(payload.file);
+        }
+        catch {
+            throw new PathEscapeError();
+        }
+    }
+    if (payload.taskId && !TASK_ID_RE.test(payload.taskId)) {
+        throw new Error(`Invalid taskId: ${payload.taskId}`);
+    }
+    const actions = config.on[payload.event] ?? [];
+    if (actions.length === 0) {
+        return [];
+    }
+    const stack = await resolveHookStack(ctx.projectRoot);
+    const results = [];
+    await withProjectGraph(ctx.projectRoot, async (graph) => {
+        for (const hookAction of actions) {
+            const action = hookAction.action;
+            const start = performance.now();
+            if (await shouldSkip(payload.event, action, payload, {
+                projectRoot: ctx.projectRoot,
+            })) {
+                const durationMs = Math.round(performance.now() - start);
+                results.push({
+                    event: payload.event,
+                    action,
+                    exitCode: 0,
+                    skipped: true,
+                    durationMs,
+                });
+                continue;
+            }
+            const { cmd, argv } = resolveAction(action, payload, stack);
+            const triggeredAt = new Date().toISOString();
+            let exitCode = 0;
+            let skipped = false;
+            if (isInternalAction(action)) {
+                recordHookTrigger(graph, {
+                    event: payload.event,
+                    action,
+                    exitCode: 0,
+                    skipped: false,
+                    triggeredAt,
+                });
+            }
+            else {
+                const res = await safeSpawn(cmd, [...argv, ...(hookAction.args ?? [])], {
+                    cwd: ctx.projectRoot,
+                    timeoutSeconds: 600,
+                });
+                exitCode = res.code;
+                const verdict = verdictFor(action, exitCode);
+                recordHookTrigger(graph, {
+                    event: payload.event,
+                    action,
+                    exitCode,
+                    skipped: false,
+                    verdict,
+                    triggeredAt,
+                });
+            }
+            await markSeen(payload.event, action, payload, {
+                projectRoot: ctx.projectRoot,
+            });
+            const durationMs = Math.round(performance.now() - start);
+            const verdict = verdictFor(action, exitCode);
+            logger.info({ event: payload.event, action, exitCode, durationMs, skipped }, 'hook dispatched');
+            results.push({
+                event: payload.event,
+                action,
+                exitCode,
+                skipped,
+                verdict,
+                durationMs,
+            });
+        }
+    });
+    return results;
+}
+export { ActionNotAllowedError, PathEscapeError };
+//# sourceMappingURL=dispatcher.js.map

package/dist/hooks/dispatcher.js.map

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

package/dist/hooks/idempotency.d.ts

@@ -0,0 +1,14 @@
+import type { HookEvent, HookEventPayload } from './types.js';
+import type { AllowedActionKey } from './allowlist.js';
+export interface IdempotencyContext {
+    readonly projectRoot: string;
+    readonly statePath?: string;
+    /** For on-task-complete: touched files (sorted internally for hashing). */
+    readonly touchedFiles?: readonly string[];
+}
+export declare function stateKey(event: HookEvent, action: AllowedActionKey, payload: HookEventPayload, opts?: {
+    touchedFiles?: readonly string[];
+}): string;
+export declare function shouldSkip(event: HookEvent, action: AllowedActionKey, payload: HookEventPayload, ctx: IdempotencyContext): Promise<boolean>;
+export declare function markSeen(event: HookEvent, action: AllowedActionKey, payload: HookEventPayload, ctx: IdempotencyContext): Promise<void>;
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/hooks/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../src/hooks/idempotency.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAyCD,wBAAgB,QAAQ,CACtB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,gBAAgB,EACzB,IAAI,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC1C,MAAM,CAGR;AAiBD,wBAAsB,UAAU,CAC9B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,gBAAgB,EACzB,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/hooks/idempotency.js

@@ -0,0 +1,64 @@
+import crypto from 'node:crypto';
+import fs from 'fs-extra';
+import path from 'node:path';
+import { assertRelativeSafe, resolveSafePath } from '../utils/path-safety.js';
+function normalizeFile(file) {
+    assertRelativeSafe(file);
+    return file.replace(/\\/g, '/');
+}
+function hashMaterial(material) {
+    return crypto.createHash('sha256').update(material).digest('hex');
+}
+function materialForPayload(event, payload, touchedFiles) {
+    switch (event) {
+        case 'on-file-create':
+        case 'on-save': {
+            if (!payload.file)
+                return '';
+            return normalizeFile(payload.file);
+        }
+        case 'on-task-complete': {
+            const taskId = payload.taskId ?? '';
+            const files = (touchedFiles ?? [])
+                .map((f) => normalizeFile(f))
+                .sort();
+            const filesHash = hashMaterial(files.join('\n'));
+            return `${taskId}|${filesHash}`;
+        }
+        case 'pre-commit':
+            return payload.taskId ?? '';
+        default:
+            return '';
+    }
+}
+export function stateKey(event, action, payload, opts) {
+    const material = materialForPayload(event, payload, opts?.touchedFiles);
+    return hashMaterial(`${event}|${action}|${material}`);
+}
+async function readState(ctx) {
+    const stateFile = resolveSafePath(ctx.projectRoot, ctx.statePath ?? '.dare/hooks-state.json');
+    await fs.ensureDir(path.dirname(stateFile));
+    if (!(await fs.pathExists(stateFile))) {
+        return { seen: {} };
+    }
+    const data = (await fs.readJson(stateFile));
+    return { seen: data.seen ?? {} };
+}
+async function writeState(ctx, state) {
+    const stateFile = resolveSafePath(ctx.projectRoot, ctx.statePath ?? '.dare/hooks-state.json');
+    await fs.writeJson(stateFile, state, { spaces: 2 });
+}
+export async function shouldSkip(event, action, payload, ctx) {
+    const key = stateKey(event, action, payload, { touchedFiles: ctx.touchedFiles });
+    const state = await readState(ctx);
+    return key in state.seen;
+}
+export async function markSeen(event, action, payload, ctx) {
+    const key = stateKey(event, action, payload, { touchedFiles: ctx.touchedFiles });
+    const state = await readState(ctx);
+    if (state.seen[key])
+        return;
+    state.seen[key] = new Date().toISOString();
+    await writeState(ctx, state);
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/hooks/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../src/hooks/idempotency.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAe9E,SAAS,aAAa,CAAC,IAAY;IACjC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAgB,EAChB,OAAyB,EACzB,YAAgC;IAEhC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,gBAAgB,CAAC;QACtB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,IAAI;gBAAE,OAAO,EAAE,CAAC;YAC7B,OAAO,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,kBAAkB,CAAC,CAAC,CAAC;YACxB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;iBAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;iBAC5B,IAAI,EAAE,CAAC;YACV,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACjD,OAAO,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;QAClC,CAAC;QACD,KAAK,YAAY;YACf,OAAO,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;QAC9B;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,KAAgB,EAChB,MAAwB,EACxB,OAAyB,EACzB,IAA2C;IAE3C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IACxE,OAAO,YAAY,CAAC,GAAG,KAAK,IAAI,MAAM,IAAI,QAAQ,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAuB;IAC9C,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,SAAS,IAAI,wBAAwB,CAAC,CAAC;IAC9F,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACtC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACtB,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAmB,CAAC;IAC9D,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,GAAuB,EAAE,KAAqB;IACtE,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,SAAS,IAAI,wBAAwB,CAAC,CAAC;IAC9F,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAgB,EAChB,MAAwB,EACxB,OAAyB,EACzB,GAAuB;IAEvB,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAgB,EAChB,MAAwB,EACxB,OAAyB,EACzB,GAAuB;IAEvB,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO;IAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/hooks/telemetry.d.ts

@@ -0,0 +1,12 @@
+import type { KnowledgeGraph } from '../graphrag/knowledge-graph.js';
+import type { HookResult } from './types.js';
+export interface HookTelemetryRecord {
+    readonly event: HookResult['event'];
+    readonly action: HookResult['action'];
+    readonly exitCode: number;
+    readonly skipped: boolean;
+    readonly verdict?: 'pass' | 'fail';
+    readonly triggeredAt: string;
+}
+export declare function recordHookTrigger(graph: KnowledgeGraph, record: HookTelemetryRecord): void;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/hooks/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/hooks/telemetry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAcD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CA6D1F"}

package/dist/hooks/telemetry.js

@@ -0,0 +1,66 @@
+import pino from 'pino';
+const logger = pino({ level: process.env.DARE_HOOKS_LOG_LEVEL ?? 'info' });
+function hookNodeId(event, action, triggeredAt) {
+    return `concept:hook:${event}:${action}:${triggeredAt}`;
+}
+function eventNodeId(event) {
+    return `concept:event:${event}`;
+}
+function verdictNodeId(verdict) {
+    return `concept:verdict:${verdict}`;
+}
+export function recordHookTrigger(graph, record) {
+    const hookId = hookNodeId(record.event, record.action, record.triggeredAt);
+    const eventId = eventNodeId(record.event);
+    graph.addNode({
+        id: hookId,
+        type: 'concept',
+        label: `hook:${record.event}:${record.action}`,
+        metadata: {
+            kind: 'hook',
+            event: record.event,
+            action: record.action,
+            verdict: record.verdict,
+            exitCode: record.exitCode,
+            skipped: record.skipped,
+            triggeredAt: record.triggeredAt,
+        },
+    });
+    graph.addNode({
+        id: eventId,
+        type: 'concept',
+        label: record.event,
+        metadata: { kind: 'hook_event', event: record.event },
+    });
+    graph.addEdge({
+        id: `references:${hookId}->${eventId}`,
+        sourceId: hookId,
+        targetId: eventId,
+        type: 'references',
+        metadata: { relation: 'triggered_by' },
+    });
+    if (record.verdict) {
+        const verdictId = verdictNodeId(record.verdict);
+        graph.addNode({
+            id: verdictId,
+            type: 'concept',
+            label: record.verdict,
+            metadata: { kind: 'hook_verdict', verdict: record.verdict },
+        });
+        graph.addEdge({
+            id: `related_to:${hookId}->${verdictId}`,
+            sourceId: hookId,
+            targetId: verdictId,
+            type: 'related_to',
+            metadata: { relation: 'produced' },
+        });
+    }
+    logger.info({
+        event: record.event,
+        action: record.action,
+        exitCode: record.exitCode,
+        skipped: record.skipped,
+        verdict: record.verdict,
+    }, 'hook telemetry recorded');
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/hooks/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/hooks/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAIxB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,MAAM,EAAE,CAAC,CAAC;AAW3E,SAAS,UAAU,CAAC,KAAa,EAAE,MAAc,EAAE,WAAmB;IACpE,OAAO,gBAAgB,KAAK,IAAI,MAAM,IAAI,WAAW,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,iBAAiB,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,aAAa,CAAC,OAAwB;IAC7C,OAAO,mBAAmB,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAqB,EAAE,MAA2B;IAClF,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE1C,KAAK,CAAC,OAAO,CAAC;QACZ,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,QAAQ,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE;QAC9C,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC;KACF,CAAC,CAAC;IAEH,KAAK,CAAC,OAAO,CAAC;QACZ,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;KACtD,CAAC,CAAC;IAEH,KAAK,CAAC,OAAO,CAAC;QACZ,EAAE,EAAE,cAAc,MAAM,KAAK,OAAO,EAAE;QACtC,QAAQ,EAAE,MAAM;QAChB,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,YAAY;QAClB,QAAQ,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE;KACvC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChD,KAAK,CAAC,OAAO,CAAC;YACZ,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,MAAM,CAAC,OAAO;YACrB,QAAQ,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;SAC5D,CAAC,CAAC;QACH,KAAK,CAAC,OAAO,CAAC;YACZ,EAAE,EAAE,cAAc,MAAM,KAAK,SAAS,EAAE;YACxC,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,YAAY;YAClB,QAAQ,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE;SACnC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,IAAI,CACT;QACE,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,EACD,yBAAyB,CAC1B,CAAC;AACJ,CAAC"}

package/dist/hooks/types.d.ts

@@ -0,0 +1,36 @@
+import type { AllowedActionKey } from './allowlist.js';
+/** Conjunto FECHADO de eventos na v1 (A-2 / RF-02). Eventos fora disto são rejeitados. */
+export type HookEvent = 'on-save' | 'on-file-create' | 'on-task-complete' | 'pre-commit';
+export declare const HOOK_EVENTS: readonly HookEvent[];
+/** Ação resolvida — sempre um item da allowlist canônica (RS-01). Nunca string de shell. */
+export interface HookAction {
+    readonly action: AllowedActionKey;
+    /** Args adicionais; concatenados como argv, NUNCA interpolados em shell (RS-02). */
+    readonly args?: readonly string[];
+}
+export interface HookConfig {
+    /** Eventos → lista de ações. Ausente ⇒ zero hooks (RNF-03 / opt-in). */
+    readonly on: Partial<Record<HookEvent, readonly HookAction[]>>;
+    /**
+     * Confiança explícita (RS-05). false (default) ⇒ hooks NÃO auto-executam;
+     * `dare hooks run` falha com TRUST_REQUIRED até trusted:true ou --trust.
+     */
+    readonly trusted: boolean;
+}
+/** Payload passado ao dispatcher por evento. Validado antes do spawn. */
+export interface HookEventPayload {
+    readonly event: HookEvent;
+    /** Arquivo relativo (on-save/on-file-create); validado com assertRelativeSafe. */
+    readonly file?: string;
+    /** Task id (on-task-complete); valida contra /^task-[0-9a-z-]+$/. */
+    readonly taskId?: string;
+}
+export interface HookResult {
+    readonly event: HookEvent;
+    readonly action: AllowedActionKey;
+    readonly exitCode: number;
+    readonly skipped: boolean;
+    readonly verdict?: 'pass' | 'fail';
+    readonly durationMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,0FAA0F;AAC1F,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,gBAAgB,GAChB,kBAAkB,GAClB,YAAY,CAAC;AAEjB,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAKlC,CAAC;AAEX,4FAA4F;AAC5F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,oFAAoF;IACpF,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC,CAAC,CAAC;IAC/D;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B"}

package/dist/hooks/types.js

@@ -0,0 +1,7 @@
+export const HOOK_EVENTS = [
+    'on-save',
+    'on-file-create',
+    'on-task-complete',
+    'pre-commit',
+];
+//# sourceMappingURL=types.js.map

package/dist/hooks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,WAAW,GAAyB;IAC/C,SAAS;IACT,gBAAgB;IAChB,kBAAkB;IAClB,YAAY;CACJ,CAAC"}

package/dist/index.d.ts

@@ -15,6 +15,8 @@ export { designCommand } from './commands/design.js';
 export { blueprintCommand } from './commands/blueprint.js';
 export { executeCommand } from './commands/execute.js';
 export { graphCommand } from './commands/graph.js';
+export { steeringCommand } from './commands/steering.js';
+export { hooksCommand } from './commands/hooks.js';
 export { dagCommand, renderDagMermaid, renderDagDot } from './commands/dag.js';
 export { validateCommand } from './commands/validate.js';
 export { infoCommand } from './commands/info.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,QAAQ,EACR,sBAAsB,EACtB,YAAY,GACb,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,QAAQ,EACR,aAAa,EACb,eAAe,EACf,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,GAAG,EACH,OAAO,EACP,SAAS,EACT,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,IAAI,aAAa,EAC3B,WAAW,GACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACxF,YAAY,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,QAAQ,EACR,sBAAsB,EACtB,YAAY,GACb,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,QAAQ,EACR,aAAa,EACb,eAAe,EACf,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,GAAG,EACH,OAAO,EACP,SAAS,EACT,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,IAAI,aAAa,EAC3B,WAAW,GACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACxF,YAAY,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -16,6 +16,8 @@ export { designCommand } from './commands/design.js';
 export { blueprintCommand } from './commands/blueprint.js';
 export { executeCommand } from './commands/execute.js';
 export { graphCommand } from './commands/graph.js';
+export { steeringCommand } from './commands/steering.js';
+export { hooksCommand } from './commands/hooks.js';
 export { dagCommand, renderDagMermaid, renderDagDot } from './commands/dag.js';
 export { validateCommand } from './commands/validate.js';
 export { infoCommand } from './commands/info.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,+BAA+B;AAC/B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EACL,QAAQ,EACR,sBAAsB,EACtB,YAAY,GACb,MAAM,4BAA4B,CAAC;AAQpC,6BAA6B;AAC7B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAYjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE9E,qBAAqB;AACrB,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAGxE,yBAAyB;AACzB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAkBxF,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,WAAW;AACX,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,+BAA+B;AAC/B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EACL,QAAQ,EACR,sBAAsB,EACtB,YAAY,GACb,MAAM,4BAA4B,CAAC;AAQpC,6BAA6B;AAC7B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAYjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE9E,qBAAqB;AACrB,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAGxE,yBAAyB;AACzB,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAkBxF,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/mcp-server/__tests__/mcp-steering.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-steering.test.d.ts.map

package/dist/mcp-server/__tests__/mcp-steering.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-steering.test.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/__tests__/mcp-steering.test.ts"],"names":[],"mappings":""}

package/dist/mcp-server/__tests__/mcp-steering.test.js

@@ -0,0 +1,90 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import express from 'express';
+import fs from 'fs-extra';
+import os from 'node:os';
+import path from 'node:path';
+import request from 'supertest';
+import { createMcpServer } from '../server.js';
+import { createAuthMiddleware } from '../middleware/auth.js';
+const TOKEN = 'steering-test-token';
+describe('MCP GET /steering', () => {
+    let projectRoot;
+    beforeEach(async () => {
+        projectRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'mcp-steering-'));
+        await fs.ensureDir(path.join(projectRoot, 'DARE'));
+        await fs.writeFile(path.join(projectRoot, 'DARE', 'PROJECT-DNA.md'), '# DNA\nBase steering.');
+        await fs.writeJson(path.join(projectRoot, 'dare.config.json'), { name: 'steering-mcp' });
+        const dir = path.join(projectRoot, '.dare', 'steering');
+        await fs.ensureDir(dir);
+        await fs.writeFile(path.join(dir, 'auth.md'), `---
+scope: glob
+glob: src/auth/**
+priority: 5
+---
+# Auth
+`);
+    });
+    afterEach(async () => {
+        await fs.remove(projectRoot).catch(() => undefined);
+    });
+    function app() {
+        return createMcpServer(projectRoot, {
+            authToken: TOKEN,
+            allowLoopbackWithoutToken: true,
+        });
+    }
+    it('lists get_steering in GET /tools', async () => {
+        const res = await request(app()).get('/tools');
+        const names = res.body.tools.map((t) => t.name);
+        expect(names).toContain('get_steering');
+    });
+    it('returns resolved blocks for matching file', async () => {
+        const res = await request(app())
+            .get('/steering')
+            .query({ file: 'src/auth/login.ts' });
+        expect(res.status).toBe(200);
+        expect(res.body.success).toBe(true);
+        expect(res.body.file).toBe('src/auth/login.ts');
+        expect(res.body.blocks[0]?.isBase).toBe(true);
+        expect(res.body.blocks.some((b) => b.source.includes('auth.md'))).toBe(true);
+    });
+    it('rejects missing file param', async () => {
+        const res = await request(app()).get('/steering');
+        expect(res.status).toBe(400);
+        expect(res.body.error).toBe('file is required');
+    });
+    it('rejects file param over 200 chars', async () => {
+        const res = await request(app())
+            .get('/steering')
+            .query({ file: 'a'.repeat(201) });
+        expect(res.status).toBe(400);
+        expect(res.body.error).toBe('file too long');
+    });
+    it('rejects path escape with 403', async () => {
+        const res = await request(app())
+            .get('/steering')
+            .query({ file: '../etc/passwd' });
+        expect(res.status).toBe(403);
+        expect(res.body.error).toBe('Forbidden');
+    });
+    it('regression: non-loopback without token is unauthorized', async () => {
+        const base = express();
+        base.set('trust proxy', true);
+        base.use((req, _res, next) => {
+            Object.defineProperty(req, 'ip', { value: '203.0.113.1', configurable: true });
+            Object.defineProperty(req.socket, 'remoteAddress', {
+                value: '203.0.113.1',
+                configurable: true,
+            });
+            next();
+        });
+        base.use(createAuthMiddleware({ token: TOKEN, allowLoopbackWithoutToken: true }));
+        base.use(createMcpServer(projectRoot, { authToken: TOKEN, allowLoopbackWithoutToken: true }));
+        const res = await request(base)
+            .get('/steering')
+            .query({ file: 'src/foo.ts' });
+        expect(res.status).toBe(401);
+        expect(res.body.error).toBe('Unauthorized');
+    });
+});
+//# sourceMappingURL=mcp-steering.test.js.map

package/dist/mcp-server/__tests__/mcp-steering.test.js.map

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

package/dist/mcp-server/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAEA,OAAgB,EAAE,KAAK,OAAO,EAAkD,MAAM,SAAS,CAAC;AAiBhG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB;AAuBD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AA0DD,wBAAgB,eAAe,CAC7B,WAAW,GAAE,MAAuD,EACpE,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAkWT"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"AAEA,OAAgB,EAAE,KAAK,OAAO,EAAkD,MAAM,SAAS,CAAC;AAmBhG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB;AAuBD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AA0DD,wBAAgB,eAAe,CAC7B,WAAW,GAAE,MAAuD,EACpE,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAgYT"}

package/dist/mcp-server/server.js

@@ -9,6 +9,8 @@ import { createGraph, loadGraphConfig } from '../graphrag/index.js';
 import { createAuthMiddleware } from './middleware/auth.js';
 import { createCorsMiddleware } from './middleware/cors.js';
 import { createErrorHandler } from './middleware/error-handler.js';
+import { loadSteeringFiles } from '../steering/loader.js';
+import { resolveSteeringForFile } from '../steering/resolver.js';
 const require = createRequire(import.meta.url);
 const { version: pkgVersion } = require('../../package.json');
 const logger = pino({ transport: { target: 'pino-pretty' } });
@@ -118,6 +120,7 @@ export function createMcpServer(projectRoot = process.env.DARE_PROJECT_PATH || p
                 { name: 'graph_locate', description: 'Locate code symbols from a seed query' },
                 { name: 'graph_map_requirement', description: 'Map a requirement/task to symbols and tasks' },
                 { name: 'graph_traverse', description: 'Traverse the knowledge graph from seed nodes' },
+                { name: 'get_steering', description: 'Get resolved steering for a file' },
             ],
         });
     });
@@ -377,6 +380,33 @@ export function createMcpServer(projectRoot = process.env.DARE_PROJECT_PATH || p
             res.json(config);
         });
     });
+    app.get('/steering', (req, res, next) => {
+        runSafe(res, next, async () => {
+            const file = typeof req.query.file === 'string' ? req.query.file : '';
+            if (!file || file.trim() === '') {
+                res.status(400).json({ error: 'file is required' });
+                return;
+            }
+            if (file.length > 200) {
+                res.status(400).json({ error: 'file too long' });
+                return;
+            }
+            const files = loadSteeringFiles(projectRoot);
+            const resolution = resolveSteeringForFile(files, file);
+            res.json({
+                success: true,
+                file: resolution.file,
+                blocks: resolution.blocks.map((b) => ({
+                    source: b.path,
+                    scope: b.frontMatter.scope,
+                    priority: b.frontMatter.priority ?? 0,
+                    isBase: b.isBase,
+                    ...(b.frontMatter.glob ? { glob: b.frontMatter.glob } : {}),
+                    body: b.body,
+                })),
+            });
+        });
+    });
     app.use(createErrorHandler(logger));
     return app;
 }