@opensip-cli/yagni 0.1.11

package/dist/detectors/duplicate-body-candidate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-body-candidate.d.ts","sourceRoot":"","sources":["../../src/detectors/duplicate-body-candidate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,aAAa,EAA6C,MAAM,YAAY,CAAC;AAuI3F,eAAO,MAAM,8BAA8B,EAAE,aAM5C,CAAC"}

package/dist/detectors/duplicate-body-candidate.js

@@ -0,0 +1,137 @@
+/**
+ * duplicate-body-candidate — surfaces cross-occurrence duplicate function bodies
+ * from a graph catalog bodyHash grouping as consolidation candidates.
+ */
+import { relative } from 'node:path';
+import { severityForConfidence } from '../scoring/confidence.js';
+import { createYagniSignal } from './create-yagni-signal.js';
+const DETECTOR_ID = 'duplicate-body-candidate';
+const SLUG = 'yagni:duplicate-body-candidate';
+const DEFAULT_MIN_OCCURRENCES = 2;
+const DEFAULT_MIN_BODY_LINES = 5;
+function groupByBodyHash(catalog) {
+    const buckets = new Map();
+    for (const occurrences of Object.values(catalog.functions)) {
+        for (const occ of occurrences) {
+            const bucket = buckets.get(occ.bodyHash);
+            if (bucket)
+                bucket.push(occ);
+            else
+                buckets.set(occ.bodyHash, [occ]);
+        }
+    }
+    return buckets;
+}
+function primaryOccurrence(occs) {
+    return [...occs].sort((a, b) => a.qualifiedName.localeCompare(b.qualifiedName))[0];
+}
+function relPath(cwd, filePath) {
+    return relative(cwd, filePath).split('\\').join('/');
+}
+function displayFunctionName(occ) {
+    const simple = occ.simpleName.trim();
+    if (simple.startsWith('<arrow:'))
+        return 'arrow function';
+    if (simple !== '' && !simple.includes('/') && simple.length <= 60)
+        return simple;
+    if (occ.qualifiedName.includes('<arrow:'))
+        return 'arrow function';
+    if (occ.qualifiedName.includes('/'))
+        return 'function';
+    const qualifiedTail = occ.qualifiedName.split('.').at(-1)?.trim() ?? '';
+    if (qualifiedTail !== '' && !qualifiedTail.includes('/') && qualifiedTail.length <= 60) {
+        return qualifiedTail;
+    }
+    return 'function';
+}
+function displayOccurrence(cwd, occ) {
+    return `${relPath(cwd, occ.filePath)}:${String(occ.line)} (${displayFunctionName(occ)})`;
+}
+function runDuplicateBodyCandidate(ctx) {
+    const started = Date.now();
+    const settings = ctx.config.detectorSettings?.[DETECTOR_ID] ?? {};
+    const minOccurrences = typeof settings.minOccurrences === 'number' ? settings.minOccurrences : DEFAULT_MIN_OCCURRENCES;
+    const minBodyLines = typeof settings.minBodyLines === 'number' ? settings.minBodyLines : DEFAULT_MIN_BODY_LINES;
+    if (ctx.graphCatalog === null) {
+        return Promise.resolve({ signals: [], durationMs: Date.now() - started });
+    }
+    const signals = [];
+    for (const [bodyHash, occs] of groupByBodyHash(ctx.graphCatalog)) {
+        if (occs.length < minOccurrences)
+            continue;
+        const anchor = primaryOccurrence(occs);
+        const bodyLines = anchor.endLine - anchor.line + 1;
+        if (bodyLines < minBodyLines)
+            continue;
+        const packages = [
+            ...new Set(occs.map((o) => o.package ?? o.filePath.split('/')[0] ?? 'unknown')),
+        ].sort();
+        const confidence = 'medium';
+        const netEstimate = bodyLines * (occs.length - 1);
+        const anchorRel = relPath(ctx.cwd, anchor.filePath);
+        const peer = occs.find((o) => o.qualifiedName !== anchor.qualifiedName) ?? anchor;
+        const peerDisplay = displayOccurrence(ctx.cwd, peer);
+        signals.push(createYagniSignal({
+            source: SLUG,
+            ruleId: SLUG,
+            severity: severityForConfidence(confidence),
+            category: 'architecture',
+            message: `Duplicate body candidate (${String(occs.length)} occurrences) — consolidate shared logic (${confidence} confidence)`,
+            suggestion: 'Extract the shared body into one module and import it from each copy site.',
+            code: {
+                file: anchor.filePath,
+                line: anchor.line,
+                column: anchor.column,
+            },
+            yagni: {
+                detector: DETECTOR_ID,
+                reductionCategory: 'dedupe',
+                confidence,
+                locDelta: {
+                    remove: netEstimate,
+                    add: Math.max(1, Math.floor(bodyLines / 2)),
+                    netEstimate,
+                    estimateKind: 'heuristic',
+                },
+                preservationArgument: 'Occurrences share an identical bodyHash from the graph catalog; behavior should match after hoisting.',
+                suggestedAction: `Consolidate with ${peerDisplay}.`,
+                validationRequired: [
+                    'Confirm neither occurrence is published public API.',
+                    'Run tests covering each duplicate site after extraction.',
+                ],
+                riskTags: ['cross-package', 'behavior-preservation'],
+                evidence: [
+                    {
+                        id: `body-hash:${bodyHash}`,
+                        kind: 'body-hash-group',
+                        summary: `${String(occs.length)} functions share bodyHash ${bodyHash.slice(0, 8)}.`,
+                        data: {
+                            bodyHash,
+                            occurrenceCount: occs.length,
+                            packages,
+                            anchor: {
+                                qualifiedName: anchor.qualifiedName,
+                                filePath: anchorRel,
+                                line: anchor.line,
+                            },
+                            peer: {
+                                qualifiedName: peer.qualifiedName,
+                                filePath: relPath(ctx.cwd, peer.filePath),
+                                line: peer.line,
+                            },
+                        },
+                    },
+                ],
+            },
+        }));
+    }
+    return Promise.resolve({ signals, durationMs: Date.now() - started });
+}
+export const duplicateBodyCandidateDetector = {
+    id: DETECTOR_ID,
+    slug: SLUG,
+    description: 'Duplicate function-body candidates from graph bodyHash groups',
+    requiresGraph: true,
+    run: runDuplicateBodyCandidate,
+};
+//# sourceMappingURL=duplicate-body-candidate.js.map

package/dist/detectors/duplicate-body-candidate.js.map

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

package/dist/detectors/registry.d.ts

@@ -0,0 +1,4 @@
+import type { YagniDetector } from './types.js';
+/** Built-in detector registry in stable registration order. */
+export declare const YAGNI_DETECTORS: readonly YagniDetector[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/detectors/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/detectors/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,+DAA+D;AAC/D,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAGnD,CAAC"}

package/dist/detectors/registry.js

@@ -0,0 +1,8 @@
+import { duplicateBodyCandidateDetector } from './duplicate-body-candidate.js';
+import { unusedConfigSurfaceDetector } from './unused-config-surface.js';
+/** Built-in detector registry in stable registration order. */
+export const YAGNI_DETECTORS = [
+    unusedConfigSurfaceDetector,
+    duplicateBodyCandidateDetector,
+];
+//# sourceMappingURL=registry.js.map

package/dist/detectors/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/detectors/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAIzE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,2BAA2B;IAC3B,8BAA8B;CAC/B,CAAC"}

package/dist/detectors/types.d.ts

@@ -0,0 +1,28 @@
+import type { YagniConfig } from '../types/yagni-config.js';
+import type { GraphCatalog } from '@opensip-cli/contracts';
+import type { Signal } from '@opensip-cli/core';
+export interface YagniDetectorContext {
+    readonly cwd: string;
+    readonly config: YagniConfig;
+    readonly graphCatalog: GraphCatalog | null;
+    readonly includeTests: boolean;
+    readonly pathRoots?: readonly string[];
+}
+export interface YagniDetectorResult {
+    readonly signals: readonly Signal[];
+    readonly durationMs: number;
+}
+export interface YagniDetector {
+    readonly id: string;
+    readonly slug: string;
+    readonly description: string;
+    readonly requiresGraph: boolean;
+    run(ctx: YagniDetectorContext): Promise<YagniDetectorResult>;
+}
+export interface SkippedDetector {
+    readonly id: string;
+    readonly slug: string;
+    readonly reason: 'disabled' | 'graph-required' | 'graph-unavailable';
+    readonly detail?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/detectors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,GAAG,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/detectors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/detectors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/detectors/types.ts"],"names":[],"mappings":""}

package/dist/detectors/unused-config-surface.d.ts

@@ -0,0 +1,10 @@
+/**
+ * unused-config-surface — flags required config properties on the public API
+ * surface that are never read anywhere in the project.
+ *
+ * Subsumes the fitness `unused-config-options` check by scoping definitions to
+ * files reachable from `package.json#exports` via re-export chains.
+ */
+import type { YagniDetector } from './types.js';
+export declare const unusedConfigSurfaceDetector: YagniDetector;
+//# sourceMappingURL=unused-config-surface.d.ts.map

package/dist/detectors/unused-config-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-config-surface.d.ts","sourceRoot":"","sources":["../../src/detectors/unused-config-surface.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAcH,OAAO,KAAK,EAAE,aAAa,EAA6C,MAAM,YAAY,CAAC;AA2M3F,eAAO,MAAM,2BAA2B,EAAE,aAMzC,CAAC"}

package/dist/detectors/unused-config-surface.js

@@ -0,0 +1,199 @@
+// @fitness-ignore-file batch-operation-limits -- walks a bounded, already-discovered source file list synchronously; no DB, network, async fanout, or unbounded external batch.
+/**
+ * unused-config-surface — flags required config properties on the public API
+ * surface that are never read anywhere in the project.
+ *
+ * Subsumes the fitness `unused-config-options` check by scoping definitions to
+ * files reachable from `package.json#exports` via re-export chains.
+ */
+import { readFileSync, statSync } from 'node:fs';
+import { relative } from 'node:path';
+import { isInPublicApiSurface, withSpan } from '@opensip-cli/core';
+import { getSharedSourceFile } from '@opensip-cli/lang-typescript';
+import * as ts from 'typescript';
+import { walkTypeScriptFiles } from '../lib/walk-typescript-files.js';
+import { severityForConfidence } from '../scoring/confidence.js';
+import { createYagniSignal } from './create-yagni-signal.js';
+const DETECTOR_ID = 'unused-config-surface';
+const SLUG = 'yagni:unused-config-surface';
+const MAX_SOURCE_FILE_BYTES = 1_000_000;
+const COMMON_PROPERTY_NAMES = new Set([
+    'enabled',
+    'disabled',
+    'timeout',
+    'retries',
+    'debug',
+    'verbose',
+    'name',
+    'type',
+    'id',
+    'key',
+    'value',
+    'data',
+    'options',
+    'config',
+    'settings',
+    'port',
+    'host',
+    'url',
+    'path',
+    'level',
+    'mode',
+]);
+function isPublicConfigSurfaceInterface(interfaceName) {
+    return /\b(?:\w*Config|\w*Options)\b/.test(interfaceName);
+}
+function mayContainConfigSurface(filePath) {
+    return filePath.toLowerCase().includes('config');
+}
+function readBoundedSourceFile(filePath) {
+    try {
+        const stats = statSync(filePath);
+        if (!stats.isFile() || stats.size > MAX_SOURCE_FILE_BYTES)
+            return undefined;
+        return readFileSync(filePath, 'utf8');
+    }
+    catch {
+        // @swallow-ok unreadable files are skipped; callers treat undefined as "no source available".
+        return undefined;
+    }
+}
+function extractPropertyFromMember(member, sourceFile, interfaceName, filePath) {
+    if (!ts.isPropertySignature(member) || !ts.isIdentifier(member.name))
+        return null;
+    const propName = member.name.text;
+    if (COMMON_PROPERTY_NAMES.has(propName))
+        return null;
+    const { line } = sourceFile.getLineAndCharacterOfPosition(member.getStart());
+    return {
+        name: propName,
+        interfaceName,
+        filePath,
+        line: line + 1,
+        isOptional: member.questionToken !== undefined,
+    };
+}
+function extractInterfaceProperties(node, sourceFile, filePath) {
+    const properties = [];
+    for (const member of node.members) {
+        const prop = extractPropertyFromMember(member, sourceFile, node.name.text, filePath);
+        if (prop)
+            properties.push(prop);
+    }
+    return properties;
+}
+function collectConfigProperties(filePaths) {
+    const properties = [];
+    for (const filePath of filePaths) {
+        if (!mayContainConfigSurface(filePath) || !isInPublicApiSurface(filePath))
+            continue;
+        const content = readBoundedSourceFile(filePath);
+        if (content === undefined)
+            continue;
+        const sourceFile = getSharedSourceFile(filePath, content);
+        if (!sourceFile)
+            continue;
+        const visit = (node) => {
+            ts.forEachChild(node, visit);
+            if (!ts.isInterfaceDeclaration(node) || !isPublicConfigSurfaceInterface(node.name.text))
+                return;
+            properties.push(...extractInterfaceProperties(node, sourceFile, filePath));
+        };
+        visit(sourceFile);
+    }
+    return properties;
+}
+function countPropertyAccesses(filePaths) {
+    const accessCounts = new Map();
+    for (const filePath of filePaths) {
+        const content = readBoundedSourceFile(filePath);
+        if (content === undefined)
+            continue;
+        const sourceFile = getSharedSourceFile(filePath, content);
+        if (!sourceFile)
+            continue;
+        // eslint-disable-next-line unicorn/consistent-function-scoping -- closes over per-file sourceFile; hoisting would thread extra params through every callsite
+        const visit = (node) => {
+            if (ts.isPropertyAccessExpression(node)) {
+                const propertyName = node.name.text;
+                accessCounts.set(propertyName, (accessCounts.get(propertyName) ?? 0) + 1);
+            }
+            if (ts.isBindingElement(node) && ts.isIdentifier(node.name)) {
+                const propertyName = node.name.text;
+                accessCounts.set(propertyName, (accessCounts.get(propertyName) ?? 0) + 1);
+            }
+            ts.forEachChild(node, visit);
+        };
+        visit(sourceFile);
+    }
+    return accessCounts;
+}
+function runUnusedConfigSurface(ctx) {
+    const result = withSpan('opensip-cli-yagni', 'yagni.unused_config_surface', () => {
+        const started = Date.now();
+        const filePaths = walkTypeScriptFiles(ctx.cwd, ctx.includeTests, ctx.pathRoots);
+        const configProperties = collectConfigProperties(filePaths);
+        const accessCounts = countPropertyAccesses(filePaths);
+        const signals = [];
+        for (const prop of configProperties) {
+            if (prop.isOptional)
+                continue;
+            if ((accessCounts.get(prop.name) ?? 0) > 0)
+                continue;
+            const relPath = relative(ctx.cwd, prop.filePath).split('\\').join('/');
+            const confidence = 'high';
+            const evidenceId = `unused-config:${relPath}:${String(prop.line)}:${prop.name}`;
+            signals.push(createYagniSignal({
+                source: SLUG,
+                ruleId: SLUG,
+                severity: severityForConfidence(confidence),
+                category: 'quality',
+                message: `Unused public config key '${prop.name}' in ${prop.interfaceName} (${confidence} confidence)`,
+                suggestion: `Remove '${prop.name}' from ${prop.interfaceName} or wire it into runtime behavior`,
+                code: { file: prop.filePath, line: prop.line, column: 0 },
+                yagni: {
+                    detector: DETECTOR_ID,
+                    reductionCategory: 'config',
+                    confidence,
+                    locDelta: {
+                        remove: 1,
+                        add: 0,
+                        netEstimate: 1,
+                        estimateKind: 'exact',
+                    },
+                    preservationArgument: 'The property is declared on a public config interface but has zero read sites in the project.',
+                    suggestedAction: `Remove unused key \`${prop.name}\` from ${prop.interfaceName}.`,
+                    validationRequired: [
+                        'Confirm no dynamic property access reads this key.',
+                        'Run the package test suite after removal.',
+                    ],
+                    riskTags: ['public-api-surface'],
+                    evidence: [
+                        {
+                            id: evidenceId,
+                            kind: 'unused-config-property',
+                            summary: `Required property '${prop.name}' on ${prop.interfaceName} has no read sites.`,
+                            data: {
+                                property: prop.name,
+                                interfaceName: prop.interfaceName,
+                                filePath: relPath,
+                                line: prop.line,
+                                publicApiSurface: true,
+                            },
+                        },
+                    ],
+                },
+            }));
+        }
+        return { signals, durationMs: Date.now() - started };
+    }, { 'yagni.detector': DETECTOR_ID });
+    return Promise.resolve(result);
+}
+export const unusedConfigSurfaceDetector = {
+    id: DETECTOR_ID,
+    slug: SLUG,
+    description: 'Unused required config properties on the public API surface',
+    requiresGraph: false,
+    run: runUnusedConfigSurface,
+};
+//# sourceMappingURL=unused-config-surface.js.map

package/dist/detectors/unused-config-surface.js.map

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

package/dist/evidence/graph-evidence.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Graph evidence seam — the ONLY production module that may import
+ * `@opensip-cli/graph/internal` (dependency-cruiser carve-out).
+ */
+import type { YagniGraphMode } from '../types/yagni-config.js';
+import type { GraphCatalog } from '@opensip-cli/contracts';
+import type { ToolCliContext } from '@opensip-cli/core';
+export interface GraphEvidenceResult {
+    readonly catalog: GraphCatalog | null;
+    readonly mode: YagniGraphMode;
+    readonly built: boolean;
+    readonly detail?: string;
+}
+export declare function resolveGraphEvidence(cwd: string, mode: YagniGraphMode, cli: ToolCliContext): Promise<GraphEvidenceResult>;
+//# sourceMappingURL=graph-evidence.d.ts.map

package/dist/evidence/graph-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-evidence.d.ts","sourceRoot":"","sources":["../../src/evidence/graph-evidence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,mBAAmB,CAAC,CA8D9B"}

package/dist/evidence/graph-evidence.js

@@ -0,0 +1,89 @@
+/**
+ * Graph evidence seam — the ONLY production module that may import
+ * `@opensip-cli/graph/internal` (dependency-cruiser carve-out).
+ */
+import { CatalogRepo, runGraph } from '@opensip-cli/graph/internal';
+import { withPreservedExitCode } from '../lib/isolate-exit-code.js';
+import { ensureGraphAdaptersLoaded } from './load-graph-adapters.js';
+export async function resolveGraphEvidence(cwd, mode, cli) {
+    if (mode === 'off') {
+        return { catalog: null, mode, built: false, detail: 'graph disabled' };
+    }
+    const datastore = cli.scope.datastore();
+    if (datastore === undefined) {
+        return {
+            catalog: null,
+            mode,
+            built: false,
+            detail: 'datastore unavailable',
+        };
+    }
+    if (mode === 'reuse') {
+        const repo = new CatalogRepo(datastore);
+        const catalog = repo.loadCatalogContract();
+        return {
+            catalog,
+            mode,
+            built: false,
+            detail: catalog === null ? 'no cached catalog' : 'reused cached catalog',
+        };
+    }
+    if (mode === 'build') {
+        await ensureGraphAdaptersLoaded(cwd);
+        const built = await buildGraphCatalog(cwd, cli, { force: true });
+        return {
+            catalog: built,
+            mode,
+            built: built !== null,
+            detail: built === null ? 'graph build produced no catalog' : 'built fresh catalog',
+        };
+    }
+    // auto: best-effort enrichment — load graph adapters (yagni owns the command,
+    // so the host did not), then delegate to graph's cache-invalidation path.
+    // When adapters still cannot be resolved, degrade to a cached catalog only.
+    await ensureGraphAdaptersLoaded(cwd);
+    const graphScope = cli.scope;
+    if ((graphScope.graph?.adapters?.size ?? 0) === 0) {
+        const catalog = new CatalogRepo(datastore).loadCatalogContract();
+        return {
+            catalog,
+            mode,
+            built: false,
+            detail: catalog === null
+                ? 'no graph adapter; no cached catalog'
+                : 'reused cached catalog (no adapter to rebuild)',
+        };
+    }
+    const catalog = await buildGraphCatalog(cwd, cli, { force: false });
+    return {
+        catalog,
+        mode,
+        built: false,
+        detail: catalog === null ? 'auto build produced no catalog' : 'auto resolved graph catalog',
+    };
+}
+async function buildGraphCatalog(cwd, cli, opts) {
+    const graphScope = cli.scope;
+    if ((graphScope.graph?.adapters?.size ?? 0) === 0)
+        return null;
+    const datastore = cli.scope.datastore();
+    if (datastore === undefined)
+        return null;
+    // Evidence-only in-process build: `executeGraph` fans out sharded workers that
+    // re-bootstrap under yagni (no graph-adapter domain), so fragments never land.
+    // `runGraph` reuses the adapters yagni loaded above without emitting a graph
+    // CLI envelope onto stdout. Persist explicitly afterward: the orchestrator
+    // skips `replaceAll` when `noCache: true` (build mode), but yagni needs the
+    // catalog row for duplicate-body-candidate regardless.
+    const result = await withPreservedExitCode(cli, () => runGraph({
+        cwd,
+        noCache: opts.force,
+        rules: [],
+        datastore,
+    }));
+    if (result.catalog !== undefined && result.catalog !== null) {
+        new CatalogRepo(datastore).replaceAll(result.catalog);
+    }
+    return new CatalogRepo(datastore).loadCatalogContract();
+}
+//# sourceMappingURL=graph-evidence.js.map

package/dist/evidence/graph-evidence.js.map

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

package/dist/evidence/load-graph-adapters.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Lazy-load graph language adapters for YAGNI graph evidence.
+ *
+ * The CLI host only drives capability discovery for the *owning* tool's domains
+ * (`loadOwningToolCapabilities`). A plain `opensip yagni` run therefore does not
+ * register graph adapters even though `scope.graph` exists (graph's
+ * `contributeScope` runs for every bundled tool). Before building or refreshing
+ * graph evidence, YAGNI must drive the `graph-adapter` domain itself — the same
+ * pattern simulation uses for `sim-pack` in `ensureScenariosLoaded`.
+ */
+/** Register graph language adapters when this yagni run needs graph evidence. */
+export declare function ensureGraphAdaptersLoaded(projectDir: string): Promise<void>;
+//# sourceMappingURL=load-graph-adapters.d.ts.map

package/dist/evidence/load-graph-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-graph-adapters.d.ts","sourceRoot":"","sources":["../../src/evidence/load-graph-adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+CH,iFAAiF;AACjF,wBAAsB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBjF"}

package/dist/evidence/load-graph-adapters.js

@@ -0,0 +1,67 @@
+/**
+ * Lazy-load graph language adapters for YAGNI graph evidence.
+ *
+ * The CLI host only drives capability discovery for the *owning* tool's domains
+ * (`loadOwningToolCapabilities`). A plain `opensip yagni` run therefore does not
+ * register graph adapters even though `scope.graph` exists (graph's
+ * `contributeScope` runs for every bundled tool). Before building or refreshing
+ * graph evidence, YAGNI must drive the `graph-adapter` domain itself — the same
+ * pattern simulation uses for `sim-pack` in `ensureScenariosLoaded`.
+ */
+import { dirname } from 'node:path';
+import { resolveCapabilityPreferences } from '@opensip-cli/config';
+import { currentScope, loadCapabilityDomain, } from '@opensip-cli/core';
+/** Built-in graph adapters bundled with the CLI (mirrors bundled-tools.manifest.json). */
+const BUNDLED_GRAPH_ADAPTERS = [
+    '@opensip-cli/graph-typescript',
+    '@opensip-cli/graph-python',
+    '@opensip-cli/graph-rust',
+    '@opensip-cli/graph-go',
+    '@opensip-cli/graph-java',
+];
+function graphAdapterCount() {
+    const scope = currentScope();
+    return scope?.graph?.adapters?.size ?? 0;
+}
+/**
+ * Resolve the CLI package install root from the process entry script
+ * (`.../dist/index.js` → two levels up). Used so built-in `@opensip-cli/graph-*`
+ * adapters resolve from the CLI's own dependency tree when the consumer project
+ * does not carry them.
+ */
+function resolveCliInstallDir() {
+    const entry = process.argv[1];
+    if (entry === undefined || entry.length === 0)
+        return undefined;
+    return dirname(dirname(entry));
+}
+function augmentBundledGraphAdapterPreferences(descriptor, preferences) {
+    if (preferences.packages !== undefined)
+        return preferences;
+    if (descriptor?.discovery.mode !== 'marker')
+        return preferences;
+    return { ...preferences, packages: [...BUNDLED_GRAPH_ADAPTERS] };
+}
+/** Register graph language adapters when this yagni run needs graph evidence. */
+export async function ensureGraphAdaptersLoaded(projectDir) {
+    if (graphAdapterCount() > 0)
+        return;
+    const scope = currentScope();
+    const registry = scope?.capabilities;
+    if (!registry?.hasDomain('graph-adapter'))
+        return;
+    if (registry.isDomainLoaded('graph-adapter', projectDir))
+        return;
+    const descriptor = registry.getDomain('graph-adapter')?.discovery;
+    const preferences = augmentBundledGraphAdapterPreferences(descriptor, descriptor === undefined
+        ? {}
+        : resolveCapabilityPreferences(descriptor, scope?.configDocument?.plugins ?? {}));
+    await loadCapabilityDomain({
+        registry,
+        domainId: 'graph-adapter',
+        projectDir,
+        cliDir: resolveCliInstallDir(),
+        preferences,
+    });
+}
+//# sourceMappingURL=load-graph-adapters.js.map