maskweaver 0.8.3 → 0.8.4

package/dist/weave/gdc.d.ts

@@ -0,0 +1,59 @@
+export type GdcEnabledMode = boolean | 'auto';
+export interface EffectiveGdcConfig {
+    enabled: boolean;
+    mode: GdcEnabledMode;
+    detected: boolean;
+    strictVerify: boolean;
+    binPath: string;
+    autoSyncOnPrepare: boolean;
+}
+export interface GdcMachineEnvelope {
+    ok?: boolean;
+    contractVersion?: string;
+    command?: string;
+    timestamp?: string;
+    data?: unknown;
+    warnings?: unknown[];
+    errors?: unknown[];
+    meta?: Record<string, unknown>;
+}
+export interface GdcMachineCommandResult {
+    command: string;
+    args: string[];
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+    timedOut: boolean;
+    transportError?: string;
+    parseError?: string;
+    envelope?: GdcMachineEnvelope;
+    data?: unknown;
+}
+export declare function detectGdcWorkspace(basePath: string): boolean;
+export declare function getEffectiveGdcConfig(basePath: string): EffectiveGdcConfig;
+export declare function runGdcMachineCommand(options: {
+    basePath: string;
+    command: string;
+    args?: string[];
+    timeoutMs?: number;
+    maxOutputChars?: number;
+    config?: EffectiveGdcConfig;
+}): Promise<GdcMachineCommandResult>;
+export declare function countGdcCheckIssues(data: unknown): {
+    errors: number;
+    warnings: number;
+    infos: number;
+    issueCount: number;
+};
+export declare function getGraphNodeIds(data: unknown): string[];
+export declare function getGraphEdges(data: unknown): Array<{
+    from: string;
+    to: string;
+}>;
+export declare function getStatsNodeSummary(data: unknown): {
+    total?: number;
+    implemented?: number;
+    tested?: number;
+};
+//# sourceMappingURL=gdc.d.ts.map

package/dist/weave/gdc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gdc.d.ts","sourceRoot":"","sources":["../../src/weave/gdc.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IAC/B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB;AAgCD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAO5D;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAc1E;AA8CD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC/B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAsEnC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB,CA0BA;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAYvD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CAahF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CASA"}

package/dist/weave/gdc.js

@@ -0,0 +1,221 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { getGdcConfig } from '../shared/config.js';
+const execFileAsync = promisify(execFile);
+function asObject(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    return value;
+}
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+function asNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.trim().length > 0) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed))
+            return parsed;
+    }
+    return undefined;
+}
+function isMachineEnvelope(value) {
+    const obj = asObject(value);
+    if (!obj)
+        return false;
+    return (Object.prototype.hasOwnProperty.call(obj, 'data')
+        || Object.prototype.hasOwnProperty.call(obj, 'ok')
+        || Object.prototype.hasOwnProperty.call(obj, 'contractVersion')
+        || Object.prototype.hasOwnProperty.call(obj, 'warnings')
+        || Object.prototype.hasOwnProperty.call(obj, 'errors'));
+}
+export function detectGdcWorkspace(basePath) {
+    const gdcDir = path.join(basePath, '.gdc');
+    return (fs.existsSync(gdcDir)
+        || fs.existsSync(path.join(gdcDir, 'config.yaml'))
+        || fs.existsSync(path.join(gdcDir, 'nodes')));
+}
+export function getEffectiveGdcConfig(basePath) {
+    const config = getGdcConfig(basePath);
+    const mode = (config?.enabled ?? 'auto');
+    const detected = detectGdcWorkspace(basePath);
+    const enabled = mode === true || (mode !== false && detected);
+    return {
+        enabled,
+        mode,
+        detected,
+        strictVerify: config?.strictVerify ?? false,
+        binPath: config?.binPath?.trim() || 'gdc',
+        autoSyncOnPrepare: config?.autoSyncOnPrepare ?? true,
+    };
+}
+function parseMachineOutput(stdout) {
+    const text = stdout.trim();
+    if (!text) {
+        return { parseError: 'empty stdout' };
+    }
+    try {
+        const parsed = JSON.parse(text);
+        if (isMachineEnvelope(parsed)) {
+            const envelope = parsed;
+            return { envelope, data: envelope.data };
+        }
+        return { data: parsed };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { parseError: message };
+    }
+}
+function splitCommand(commandText) {
+    const trimmed = commandText.trim();
+    if (!trimmed)
+        return [];
+    const tokens = trimmed.match(/"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|[^\s]+/g) || [];
+    return tokens
+        .map(token => token.trim())
+        .filter(Boolean)
+        .map(token => {
+        if ((token.startsWith('"') && token.endsWith('"')) || (token.startsWith("'") && token.endsWith("'"))) {
+            return token.slice(1, -1);
+        }
+        return token;
+    });
+}
+function toTail(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(text.length - maxChars);
+}
+export async function runGdcMachineCommand(options) {
+    const cfg = options.config || getEffectiveGdcConfig(options.basePath);
+    const timeoutMs = options.timeoutMs ?? 90_000;
+    const maxOutputChars = options.maxOutputChars ?? 200_000;
+    const requestedArgs = options.args ? [...options.args] : [];
+    if (!requestedArgs.includes('--machine')) {
+        requestedArgs.push('--machine');
+    }
+    const commandParts = splitCommand(cfg.binPath);
+    const binary = commandParts[0] || 'gdc';
+    const binaryArgs = commandParts.slice(1);
+    const fullArgs = [...binaryArgs, options.command, ...requestedArgs];
+    const start = Date.now();
+    try {
+        const { stdout, stderr } = await execFileAsync(binary, fullArgs, {
+            cwd: options.basePath,
+            timeout: timeoutMs,
+            maxBuffer: 2 * 1024 * 1024,
+            windowsHide: true,
+        });
+        const stdoutText = toTail(String(stdout || '').trim(), maxOutputChars);
+        const stderrText = toTail(String(stderr || '').trim(), maxOutputChars);
+        const parsed = parseMachineOutput(stdoutText);
+        return {
+            command: options.command,
+            args: requestedArgs,
+            exitCode: 0,
+            stdout: stdoutText,
+            stderr: stderrText,
+            durationMs: Date.now() - start,
+            timedOut: false,
+            envelope: parsed.envelope,
+            data: parsed.data,
+            parseError: parsed.parseError,
+        };
+    }
+    catch (error) {
+        const rawCode = error?.code;
+        const exitCode = typeof rawCode === 'number'
+            ? rawCode
+            : rawCode === 'ENOENT'
+                ? 127
+                : 1;
+        const stdoutText = toTail(String(error?.stdout || '').trim(), maxOutputChars);
+        const stderrText = toTail(String(error?.stderr || '').trim(), maxOutputChars);
+        const timedOut = Boolean(error?.killed)
+            || /timed?\s*out/i.test(String(error?.message || ''));
+        const parsed = parseMachineOutput(stdoutText);
+        const transportError = rawCode === 'ENOENT'
+            ? `GDC binary not found: ${cfg.binPath}`
+            : (error instanceof Error ? error.message : String(error));
+        return {
+            command: options.command,
+            args: requestedArgs,
+            exitCode,
+            stdout: stdoutText,
+            stderr: stderrText,
+            durationMs: Date.now() - start,
+            timedOut,
+            transportError,
+            envelope: parsed.envelope,
+            data: parsed.data,
+            parseError: parsed.parseError,
+        };
+    }
+}
+export function countGdcCheckIssues(data) {
+    const payload = asObject(data) || {};
+    const summary = asObject(payload.summary) || {};
+    const summaryErrors = asNumber(summary.error) ?? 0;
+    const summaryWarnings = asNumber(summary.warning) ?? 0;
+    const summaryInfos = asNumber(summary.info) ?? 0;
+    const issues = asArray(payload.issues);
+    let issueErrors = 0;
+    let issueWarnings = 0;
+    let issueInfos = 0;
+    for (const issue of issues) {
+        const item = asObject(issue);
+        const severity = String(item?.severity || '').toLowerCase();
+        if (severity === 'error')
+            issueErrors += 1;
+        else if (severity === 'warning' || severity === 'warn')
+            issueWarnings += 1;
+        else if (severity === 'info')
+            issueInfos += 1;
+    }
+    return {
+        errors: Math.max(summaryErrors, issueErrors),
+        warnings: Math.max(summaryWarnings, issueWarnings),
+        infos: Math.max(summaryInfos, issueInfos),
+        issueCount: issues.length,
+    };
+}
+export function getGraphNodeIds(data) {
+    const payload = asObject(data);
+    const nodes = asArray(payload?.nodes);
+    const ids = new Set();
+    for (const node of nodes) {
+        const item = asObject(node);
+        const id = typeof item?.id === 'string' ? item.id : '';
+        if (id)
+            ids.add(id);
+    }
+    return Array.from(ids);
+}
+export function getGraphEdges(data) {
+    const payload = asObject(data);
+    const edges = asArray(payload?.edges);
+    const result = [];
+    for (const edge of edges) {
+        const item = asObject(edge);
+        const from = typeof item?.from === 'string' ? item.from : '';
+        const to = typeof item?.to === 'string' ? item.to : '';
+        if (from && to)
+            result.push({ from, to });
+    }
+    return result;
+}
+export function getStatsNodeSummary(data) {
+    const payload = asObject(data);
+    const nodes = asObject(payload?.nodes);
+    const byStatus = asObject(nodes?.byStatus);
+    return {
+        total: asNumber(nodes?.total),
+        implemented: asNumber(byStatus?.implemented),
+        tested: asNumber(byStatus?.tested),
+    };
+}
+//# sourceMappingURL=gdc.js.map

package/dist/weave/gdc.js.map

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

package/dist/weave/stages/research.d.ts

@@ -17,6 +17,6 @@ export interface ResearchResult {
     summary: string;
     report: string;
 }
-export declare function buildResearchReport(options: ResearchOptions): string;
+export declare function buildResearchReport(options: ResearchOptions): Promise<string>;
 export declare function writeResearchReport(options: ResearchOptions): Promise<ResearchResult>;
 //# sourceMappingURL=research.d.ts.map

package/dist/weave/stages/research.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../src/weave/stages/research.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAClB;AAqfD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CA0FpE;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA2B3F"}
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../../src/weave/stages/research.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAUhD,MAAM,WAAW,eAAe;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAClB;AA8tBD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAgHnF;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA2B3F"}

package/dist/weave/stages/research.js

@@ -6,6 +6,7 @@
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import { getEffectiveGdcConfig, runGdcMachineCommand, countGdcCheckIssues, getGraphNodeIds, getGraphEdges, getStatsNodeSummary, } from '../gdc.js';
 const WORKSPACE_IGNORED_DIRS = new Set([
     '.git',
     '.idea',
@@ -26,6 +27,10 @@ const WORKSPACE_IGNORED_DIRS = new Set([
     'target',
     'out',
 ]);
+const WORKSPACE_ALLOWED_DOT_DIRS = new Set([
+    '.github',
+    '.gdc',
+]);
 const TEXT_EXTENSIONS = new Set([
     '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
     '.json', '.yaml', '.yml', '.md', '.txt',
@@ -147,7 +152,7 @@ function collectWorkspaceFiles(basePath, maxFiles = MAX_WORKSPACE_FILES) {
             if (entry.isDirectory()) {
                 if (WORKSPACE_IGNORED_DIRS.has(entry.name))
                     continue;
-                if (entry.name.startsWith('.') && entry.name !== '.github')
+                if (entry.name.startsWith('.') && !WORKSPACE_ALLOWED_DOT_DIRS.has(entry.name))
                     continue;
                 stack.push(fullPath);
                 continue;
@@ -297,7 +302,199 @@ function findRelatedTests(testFiles, featureNeedles) {
     }
     return uniq(related).slice(0, 10);
 }
-function analyzeWorkspaceContext(basePath, intake) {
+function listFilesRecursive(rootDir, exts) {
+    const files = [];
+    const stack = [rootDir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        let entries = [];
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const fullPath = path.join(current, entry.name);
+            if (entry.isSymbolicLink())
+                continue;
+            if (entry.isDirectory()) {
+                stack.push(fullPath);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            if (exts) {
+                const ext = path.extname(entry.name).toLowerCase();
+                if (!exts.has(ext))
+                    continue;
+            }
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+function containsNeedle(target, needles) {
+    const lower = target.toLowerCase();
+    return needles.some(needle => lower.includes(needle));
+}
+async function analyzeGdcContext(basePath, intake) {
+    const gdcDir = path.join(basePath, '.gdc');
+    const configPath = path.join(gdcDir, 'config.yaml');
+    const graphDbPath = path.join(gdcDir, 'graph.db');
+    const nodesDir = path.join(gdcDir, 'nodes');
+    const hasGdcDir = fs.existsSync(gdcDir);
+    const hasConfig = fs.existsSync(configPath);
+    const hasNodes = fs.existsSync(nodesDir);
+    const hasGraphDb = fs.existsSync(graphDbPath);
+    const detected = hasGdcDir || hasConfig || hasNodes;
+    const gdcRuntime = getEffectiveGdcConfig(basePath);
+    if (!detected) {
+        return {
+            detected: false,
+            gateEnabled: gdcRuntime.enabled,
+            nodeSpecFiles: 0,
+            hasGraphDb: false,
+            sampleNodes: [],
+            machineSignals: [],
+            candidateReuseNodes: [],
+            dependencyBlastRadius: ['GDC metadata not detected in this workspace.'],
+            driftSignals: ['No GDC spec/graph available. Drift analysis skipped.'],
+        };
+    }
+    const nodeSpecFiles = hasNodes
+        ? listFilesRecursive(nodesDir, new Set(['.yaml', '.yml']))
+        : [];
+    const featureNeedles = buildFeatureNeedles(intake);
+    const sampleNodes = nodeSpecFiles
+        .map(file => toRelativePath(basePath, file))
+        .sort((a, b) => a.localeCompare(b))
+        .slice(0, 12);
+    let candidateReuseNodes = nodeSpecFiles
+        .filter(file => {
+        const normalized = file.replace(/\\/g, '/').toLowerCase();
+        return featureNeedles.some(needle => normalized.includes(needle));
+    })
+        .map(file => `\`${toRelativePath(basePath, file)}\``)
+        .slice(0, 12);
+    const machineSignals = [];
+    let statsResult = null;
+    let graphResult = null;
+    let checkResult = null;
+    if (gdcRuntime.enabled) {
+        [statsResult, graphResult, checkResult] = await Promise.all([
+            runGdcMachineCommand({
+                basePath,
+                command: 'stats',
+                config: gdcRuntime,
+                timeoutMs: 30_000,
+            }),
+            runGdcMachineCommand({
+                basePath,
+                command: 'graph',
+                args: ['--format', 'json'],
+                config: gdcRuntime,
+                timeoutMs: 45_000,
+            }),
+            runGdcMachineCommand({
+                basePath,
+                command: 'check',
+                config: gdcRuntime,
+                timeoutMs: 45_000,
+            }),
+        ]);
+        machineSignals.push(`stats exit=${statsResult.exitCode}`);
+        machineSignals.push(`graph exit=${graphResult.exitCode}`);
+        machineSignals.push(`check exit=${checkResult.exitCode}`);
+        const statsSummary = getStatsNodeSummary(statsResult.data);
+        if (typeof statsSummary.total === 'number') {
+            machineSignals.push(`stats nodes.total=${statsSummary.total}`);
+        }
+        const graphNodeIds = getGraphNodeIds(graphResult.data);
+        if (graphNodeIds.length > 0) {
+            machineSignals.push(`graph nodes=${graphNodeIds.length}`);
+        }
+        const graphMatchedNodes = graphNodeIds
+            .filter(nodeId => containsNeedle(nodeId, featureNeedles))
+            .slice(0, 12)
+            .map(nodeId => `\`${nodeId}\``);
+        if (graphMatchedNodes.length > 0) {
+            candidateReuseNodes = uniq([...graphMatchedNodes, ...candidateReuseNodes]).slice(0, 12);
+        }
+        const checkCounts = countGdcCheckIssues(checkResult.data);
+        if (checkCounts.issueCount > 0 || checkResult.exitCode === 2) {
+            machineSignals.push(`check issues=${checkCounts.issueCount}`);
+        }
+    }
+    let dependencyBlastRadius = candidateReuseNodes.length > 0
+        ? [
+            `Candidate node specs touching requested features: ${candidateReuseNodes.slice(0, 5).join(', ')}`,
+            'Run `gdc trace <node> --direction both --machine` to measure full dependency impact.',
+        ]
+        : [
+            'No direct node filename matches found for requested features.',
+            'Run `gdc query <feature>` then `gdc trace <node> --direction both --machine` for graph-level impact.',
+        ];
+    if (graphResult) {
+        const edges = getGraphEdges(graphResult.data);
+        if (edges.length > 0 && candidateReuseNodes.length > 0) {
+            const degree = new Map();
+            for (const edge of edges) {
+                degree.set(edge.from, (degree.get(edge.from) || 0) + 1);
+                degree.set(edge.to, (degree.get(edge.to) || 0) + 1);
+            }
+            const ranked = candidateReuseNodes
+                .map(token => token.replace(/`/g, ''))
+                .map(nodeId => ({ nodeId, score: degree.get(nodeId) || 0 }))
+                .sort((a, b) => b.score - a.score || a.nodeId.localeCompare(b.nodeId))
+                .slice(0, 5);
+            if (ranked.length > 0) {
+                dependencyBlastRadius = [
+                    `Graph neighbors for candidate nodes: ${ranked.map(item => `\`${item.nodeId}\`(${item.score})`).join(', ')}`,
+                    'Higher degree nodes usually imply broader dependency impact.',
+                ];
+            }
+        }
+    }
+    const driftSignals = [];
+    if (!hasConfig)
+        driftSignals.push('`.gdc/config.yaml` missing: spec/runtime alignment checks may be incomplete.');
+    if (!hasGraphDb)
+        driftSignals.push('`.gdc/graph.db` missing: run `gdc sync` before `gdc check`.');
+    if (nodeSpecFiles.length === 0)
+        driftSignals.push('No `.gdc/nodes/*.yaml` specs found.');
+    if (checkResult) {
+        const checkCounts = countGdcCheckIssues(checkResult.data);
+        if (checkResult.exitCode === 2 || checkCounts.errors > 0) {
+            driftSignals.push(`GDC check reports blocking issues (errors=${checkCounts.errors}, warnings=${checkCounts.warnings}).`);
+        }
+        else if (checkResult.exitCode === 0) {
+            driftSignals.push(`GDC check clean (errors=${checkCounts.errors}, warnings=${checkCounts.warnings}, info=${checkCounts.infos}).`);
+        }
+        else {
+            driftSignals.push(`GDC check command failed (exit=${checkResult.exitCode}).`);
+        }
+        if (checkResult.parseError) {
+            driftSignals.push(`Machine output parse warning: ${normalizeLine(checkResult.parseError, 120)}`);
+        }
+    }
+    if (driftSignals.length === 0) {
+        driftSignals.push('GDC metadata detected. Run `gdc check --machine` to confirm spec/implementation drift.');
+    }
+    return {
+        detected: true,
+        gateEnabled: gdcRuntime.enabled,
+        configPath: hasConfig ? toRelativePath(basePath, configPath) : undefined,
+        nodeSpecFiles: nodeSpecFiles.length,
+        hasGraphDb,
+        sampleNodes,
+        machineSignals,
+        candidateReuseNodes,
+        dependencyBlastRadius,
+        driftSignals,
+    };
+}
+async function analyzeWorkspaceContext(basePath, intake) {
     const workspaceFiles = collectWorkspaceFiles(basePath);
     const codeFiles = workspaceFiles.filter(isCodeFile);
     const testFiles = workspaceFiles.filter(isTestFile);
@@ -416,7 +613,9 @@ function analyzeWorkspaceContext(basePath, intake) {
         'next.config.js',
         'docker-compose.yml',
         '.github/workflows',
+        '.gdc/config.yaml',
     ].filter(rel => fs.existsSync(path.join(basePath, rel)));
+    const gdc = await analyzeGdcContext(basePath, intake);
     return {
         scannedFiles: workspaceFiles.length,
         codeFiles: codeFiles.length,
@@ -429,9 +628,10 @@ function analyzeWorkspaceContext(basePath, intake) {
         reproductionFlow,
         beforeContext,
         afterContext,
+        gdc,
     };
 }
-export function buildResearchReport(options) {
+export async function buildResearchReport(options) {
     const basePath = options.basePath || process.cwd();
     const now = new Date().toISOString();
     const featureLines = uniq(top(options.intake.features, 12));
@@ -456,7 +656,7 @@ export function buildResearchReport(options) {
     const envIssues = top(options.intake.environment?.issues || [], 10).map(issue => {
         return `${issue.severity.toUpperCase()} - ${issue.title}: ${issue.prevention}`;
     });
-    const workspace = analyzeWorkspaceContext(basePath, options.intake);
+    const workspace = await analyzeWorkspaceContext(basePath, options.intake);
     const workspaceScope = [
         `Scanned files: ${workspace.scannedFiles} (code: ${workspace.codeFiles}, tests: ${workspace.testFiles})`,
         `Research scope: current workspace only (\`${toRelativePath(basePath, basePath)}\`)`,
@@ -472,6 +672,21 @@ export function buildResearchReport(options) {
         const snippet = candidate.snippet ? ` | ${candidate.snippet}` : '';
         return `\`${rel}\` (${featurePart})${snippet}`;
     });
+    const gdcNodeCoverage = workspace.gdc.detected
+        ? [
+            `Detected: yes`,
+            `Gate enabled: ${workspace.gdc.gateEnabled ? 'yes' : 'no'}`,
+            `Node specs: ${workspace.gdc.nodeSpecFiles}`,
+            `Graph DB present: ${workspace.gdc.hasGraphDb ? 'yes' : 'no'}`,
+            ...(workspace.gdc.configPath ? [`Config: \`${workspace.gdc.configPath}\``] : ['Config: (missing)']),
+            ...(workspace.gdc.sampleNodes.length > 0
+                ? [`Sample nodes: ${workspace.gdc.sampleNodes.map(node => `\`${node}\``).join(', ')}`]
+                : ['Sample nodes: (none)']),
+        ]
+        : ['Detected: no', 'No `.gdc` metadata found in workspace.'];
+    const gdcMachineSignals = workspace.gdc.machineSignals.length > 0
+        ? workspace.gdc.machineSignals
+        : ['No GDC machine-command data collected.'];
     const lines = [];
     lines.push('# Weave Research Report');
     lines.push('');
@@ -500,6 +715,11 @@ export function buildResearchReport(options) {
     formatList(lines, 'Problem Reproduction Flow', workspace.reproductionFlow);
     formatList(lines, 'Before Context (Current State)', workspace.beforeContext);
     formatList(lines, 'After Context (Target Intent)', workspace.afterContext);
+    formatList(lines, 'GDC Node Coverage', gdcNodeCoverage);
+    formatList(lines, 'GDC Machine Signals', gdcMachineSignals);
+    formatList(lines, 'Dependency Blast Radius', workspace.gdc.dependencyBlastRadius);
+    formatList(lines, 'Existing Spec vs Implementation Drift', workspace.gdc.driftSignals);
+    formatList(lines, 'Candidate Reuse Nodes', workspace.gdc.candidateReuseNodes);
     lines.push('## Suggested Next Steps');
     lines.push('');
     lines.push('1. Preserve reuse candidates first; avoid implementing duplicates unless behavior diverges.');
@@ -515,7 +735,7 @@ export async function writeResearchReport(options) {
     const outputPath = options.outputPath
         ? (path.isAbsolute(options.outputPath) ? options.outputPath : path.join(basePath, options.outputPath))
         : path.join(tasksDir, 'research.md');
-    const report = buildResearchReport(options);
+    const report = await buildResearchReport(options);
     fs.writeFileSync(outputPath, `${report}\n`, 'utf-8');
     const rel = toRelativePath(basePath, outputPath);
     const summary = [