@ai-agent-context/core 0.1.0

package/dist/core/architecture/role-detector.js

@@ -0,0 +1,240 @@
+import { SIGNALS } from "../../adapters/language/types.js";
+import { clampConfidence, compareStrings, uniqueSorted } from "../../model/canonical.js";
+import { truncate } from "../../util/text.js";
+/** Signals emitted by language adapters → architectural roles. */
+const SIGNAL_RULES = [
+    { role: 'repository', signals: [SIGNALS.dbAccess], weight: 0.62, label: 'contains database access' },
+    { role: 'adapter', signals: [SIGNALS.externalSdk], weight: 0.55, label: 'integrates with an external SDK' },
+    { role: 'adapter', signals: [SIGNALS.httpClient], weight: 0.5, label: 'performs HTTP calls to other services' },
+    { role: 'controller', signals: [SIGNALS.httpRoute], weight: 0.6, label: 'registers HTTP route handlers' },
+    {
+        role: 'controller',
+        signals: [SIGNALS.httpFramework],
+        weight: 0.45,
+        label: 'imports an HTTP framework or binds a network listener',
+    },
+    { role: 'api-routes', signals: [SIGNALS.graphql], weight: 0.55, label: 'uses a GraphQL server library' },
+    { role: 'eventing', signals: [SIGNALS.queue], weight: 0.55, label: 'publishes or consumes queued messages' },
+    { role: 'eventing', signals: [SIGNALS.eventEmitter], weight: 0.45, label: 'emits or subscribes to events' },
+    { role: 'worker', signals: [SIGNALS.worker], weight: 0.55, label: 'uses worker threads' },
+    { role: 'worker', signals: [SIGNALS.schedule], weight: 0.45, label: 'schedules recurring work' },
+    { role: 'ui', signals: [SIGNALS.uiFramework], weight: 0.55, label: 'imports a UI framework' },
+    { role: 'ui', signals: [SIGNALS.jsx], weight: 0.4, label: 'contains JSX' },
+    { role: 'ui', signals: [SIGNALS.browserApi], weight: 0.35, label: 'uses browser APIs' },
+    { role: 'cli', signals: [SIGNALS.cliFramework], weight: 0.6, label: 'uses a CLI argument parsing library' },
+    {
+        role: 'configuration',
+        signals: [SIGNALS.configLibrary],
+        weight: 0.5,
+        label: 'loads configuration through a config library',
+    },
+    { role: 'configuration', signals: [SIGNALS.envAccess], weight: 0.35, label: 'reads environment variables' },
+    { role: 'infrastructure', signals: [SIGNALS.loggingLibrary], weight: 0.45, label: 'configures logging' },
+    { role: 'domain', signals: [SIGNALS.customErrorClass], weight: 0.35, label: 'declares domain specific error classes' },
+    { role: 'test-support', signals: [SIGNALS.testFramework], weight: 0.5, label: 'imports a test framework' },
+    { role: 'shared', signals: [SIGNALS.validation], weight: 0.35, label: 'declares validation schemas' },
+];
+/** Directory / file naming signals → architectural roles. */
+const NAME_RULES = [
+    {
+        role: 'repository',
+        pattern: /(^|[/_.-])(repository|repositories|dao)([/_.-]|$)/i,
+        weight: 0.5,
+        label: 'name matches *Repository*',
+    },
+    {
+        role: 'adapter',
+        pattern: /(^|[/_.-])(adapters?|clients?|gateways?|providers?|integrations?)([/_.-]|$)/i,
+        weight: 0.5,
+        label: 'name matches *Adapter* / *Client* / *Provider*',
+    },
+    { role: 'controller', pattern: /(^|[/_.-])(controllers?|handlers?)([/_.-]|$)/i, weight: 0.5, label: 'name matches *Controller*' },
+    {
+        role: 'api-routes',
+        pattern: /(^|[/_.-])(routes?|api|endpoints?|resolvers?)([/_.-]|$)/i,
+        weight: 0.45,
+        label: 'name matches *route* / *api*',
+    },
+    {
+        role: 'service',
+        pattern: /(^|[/_.-])(services?|usecases?|use-cases?|application)([/_.-]|$)/i,
+        weight: 0.45,
+        label: 'name matches *Service*',
+    },
+    {
+        role: 'domain',
+        pattern: /(^|[/_.-])(domain|entities|entity|models?)([/_.-]|$)/i,
+        weight: 0.4,
+        label: 'name matches *domain* / *entity* / *model*',
+    },
+    {
+        role: 'infrastructure',
+        pattern: /(^|[/_.-])(infra|infrastructure|db|database|persistence|migrations?|storage)([/_.-]|$)/i,
+        weight: 0.45,
+        label: 'name matches infrastructure vocabulary',
+    },
+    {
+        role: 'eventing',
+        pattern: /(^|[/_.-])(events?|messaging|pubsub|broker)([/_.-]|$)/i,
+        weight: 0.45,
+        label: 'name matches *event* / *messaging*',
+    },
+    {
+        role: 'worker',
+        pattern: /(^|[/_.-])(jobs?|workers?|queues?|schedulers?)([/_.-]|$)/i,
+        weight: 0.45,
+        label: 'name matches *job* / *worker* / *queue*',
+    },
+    {
+        role: 'ui',
+        pattern: /(^|[/_.-])(components?|ui|views|pages|screens|widgets?)([/_.-]|$)/i,
+        weight: 0.4,
+        label: 'name matches UI vocabulary',
+    },
+    { role: 'cli', pattern: /(^|[/_.-])(cli|commands?|bin)([/_.-]|$)/i, weight: 0.5, label: 'name matches *cli* / *command*' },
+    {
+        role: 'configuration',
+        pattern: /(^|[/_.-])(config|configuration|settings|env)([/_.-]|$)/i,
+        weight: 0.4,
+        label: 'name matches *config*',
+    },
+    {
+        role: 'shared',
+        pattern: /(^|[/_.-])(utils?|helpers?|shared|common|lib|types)([/_.-]|$)/i,
+        weight: 0.35,
+        label: 'name matches *utils* / *shared*',
+    },
+    {
+        role: 'test-support',
+        pattern: /(^|[/_.-])(tests?|specs?|testing|fixtures|mocks)([/_.-]|$)/i,
+        weight: 0.5,
+        label: 'name matches test vocabulary',
+    },
+];
+function probabilistic(weights) {
+    if (weights.length === 0)
+        return 0;
+    const inverse = weights.reduce((accumulator, weight) => accumulator * (1 - Math.min(0.75, weight)), 1);
+    return clampConfidence(1 - inverse);
+}
+/** Detects architectural roles of a module, with confidence and evidence. */
+export function detectModuleRoles(input) {
+    const { module } = input;
+    const candidates = new Map();
+    const moduleFiles = input.files.filter((file) => module.files.includes(file.path));
+    const add = (role, weight, evidence) => {
+        const candidate = candidates.get(role) ?? { role, weights: [], evidence: [] };
+        candidate.weights.push(weight);
+        if (candidate.evidence.length < 5)
+            candidate.evidence.push(evidence);
+        candidates.set(role, candidate);
+    };
+    const moduleSignals = new Set(module.signals);
+    for (const rule of SIGNAL_RULES) {
+        for (const signal of rule.signals) {
+            if (!moduleSignals.has(signal))
+                continue;
+            const example = moduleFiles.find((file) => file.signals.includes(signal));
+            add(rule.role, rule.weight, {
+                source: example?.path ?? module.path,
+                detail: `${rule.label} (signal: ${signal})`,
+            });
+        }
+    }
+    const nameCorpus = [module.id, module.path, module.name].filter((entry) => entry.length > 0).join('/');
+    for (const rule of NAME_RULES) {
+        const match = rule.pattern.exec(nameCorpus);
+        if (match !== null) {
+            add(rule.role, rule.weight, { source: module.path || module.id, detail: `${rule.label} ("${match[0]}")` });
+        }
+    }
+    if (module.isWorkspacePackage) {
+        add('workspace-package', 0.99, { source: 'package.json', detail: 'module is a workspace package' });
+    }
+    const externalNames = new Set(input.externalDependencies.map((entry) => entry.name));
+    const applicationEntry = module.entryPoints.find((entry) => entry.type === 'application');
+    if (applicationEntry !== undefined) {
+        add('application', 0.6, { source: applicationEntry.path, detail: 'module exposes an application entry point' });
+    }
+    const cliEntry = module.entryPoints.find((entry) => entry.type === 'cli' || entry.type === 'package-bin');
+    if (cliEntry !== undefined) {
+        add('cli', 0.62, { source: cliEntry.path, detail: 'module exposes a command line entry point' });
+    }
+    if ([...externalNames].some((name) => name === '@nestjs/core' || name === 'express' || name === 'fastify')) {
+        add('controller', 0.4, { source: 'package.json', detail: 'declares an HTTP framework dependency' });
+    }
+    if (module.files.length === 0) {
+        add('configuration', 0.2, { source: module.path, detail: 'module contains no analyzed source files' });
+    }
+    return [...candidates.values()]
+        .map((candidate) => ({
+        value: candidate.role,
+        confidence: candidate.role === 'workspace-package' ? 0.99 : probabilistic(candidate.weights),
+        evidence: candidate.evidence,
+    }))
+        .filter((detection) => detection.confidence >= 0.3)
+        .sort((a, b) => (a.confidence === b.confidence ? compareStrings(a.value, b.value) : b.confidence - a.confidence))
+        .slice(0, 4);
+}
+/**
+ * Responsibilities of a module.
+ *
+ * Assembled from verifiable material only: detected roles (explicitly labelled
+ * `heuristic`), the public API surface, signals observed in the files and
+ * documentation committed inside the module.
+ */
+export function detectResponsibilities(module, parsed) {
+    const responsibilities = [];
+    for (const role of module.roles) {
+        responsibilities.push({
+            value: `role: ${role.value} (heuristic)`,
+            confidence: role.confidence,
+            evidence: role.evidence,
+        });
+    }
+    const publicNames = module.publicExports.slice(0, 8).map((entry) => entry.name);
+    if (publicNames.length > 0) {
+        responsibilities.push({
+            value: `public API: ${publicNames.join(', ')}`,
+            confidence: 0.9,
+            evidence: module.publicExports.slice(0, 3).map((entry) => ({
+                source: entry.file,
+                detail: `exports ${entry.name} (${entry.kind})`,
+            })),
+        });
+    }
+    const documentation = module.files.filter((path) => path.toLowerCase().endsWith('.md')).sort(compareStrings);
+    for (const file of documentation) {
+        const paragraph = parsed.get(file)?.metadata['markdown.firstParagraph'];
+        if (typeof paragraph !== 'string' || paragraph.trim().length === 0)
+            continue;
+        responsibilities.push({
+            value: `documented: ${truncate(paragraph, 220)}`,
+            confidence: 0.8,
+            evidence: [{ source: file, detail: 'module documentation' }],
+        });
+        break;
+    }
+    const signalStatements = [
+        { signal: SIGNALS.dbAccess, statement: 'accesses the database' },
+        { signal: SIGNALS.httpRoute, statement: 'exposes HTTP routes' },
+        { signal: SIGNALS.externalSdk, statement: 'talks to an external service SDK' },
+        { signal: SIGNALS.queue, statement: 'interacts with a message queue' },
+        { signal: SIGNALS.worker, statement: 'runs background work' },
+    ];
+    for (const entry of signalStatements) {
+        if (!module.signals.includes(entry.signal))
+            continue;
+        responsibilities.push({
+            value: `observed: ${entry.statement}`,
+            confidence: 0.75,
+            evidence: [{ source: module.files[0] ?? module.path, detail: `signal ${entry.signal}` }],
+        });
+    }
+    return responsibilities.slice(0, 8);
+}
+/** Sorted, unique list of detected role values (used by `diff`). */
+export function roleValues(roles) {
+    return uniqueSorted(roles.map((role) => role.value));
+}
+//# sourceMappingURL=role-detector.js.map

package/dist/core/architecture/role-detector.js.map

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

package/dist/core/context/explain.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Context projection (`agent-context explain`).
+ *
+ * Goal: *maximum useful context with minimum irrelevant context*. For a target
+ * path the projection returns the module's subgraph — entry points, dependencies,
+ * dependents, external packages, public API, relevant conventions and decisions,
+ * tests, git activity and the transitive impact set — instead of dumping the whole
+ * repository.
+ */
+import type { ModuleExplanation, Relationship } from '../../model/types.ts';
+import type { ParsedFile } from '../../adapters/language/types.ts';
+import type { KnowledgeGraph } from '../graph/knowledge-graph.ts';
+export interface ExplainInput {
+    graph: KnowledgeGraph;
+    parsed: Map<string, ParsedFile>;
+    /** Module id, module directory, file path or workspace package name. */
+    target: string;
+    maxRelatedFiles?: number;
+}
+export interface ResolvedTarget {
+    moduleId: string | null;
+    filePath: string | null;
+    matchedBy: string;
+}
+/** Resolves a human supplied path/id to a module (and, optionally, a file). */
+export declare function resolveTarget(graph: KnowledgeGraph, rawTarget: string): ResolvedTarget | null;
+/** Counts the file-level edges that connect two modules. */
+export declare function countEdgesBetween(graph: KnowledgeGraph, from: string, to: string): {
+    relationships: Relationship[];
+    files: number;
+};
+/** Breadth-first transitive dependents: what a change here would touch. */
+export declare function transitiveDependents(graph: KnowledgeGraph, moduleId: string, depth?: number): string[];
+/** Produces the module explanation returned by `explain`. */
+export declare function explainModule(input: ExplainInput): ModuleExplanation | null;
+//# sourceMappingURL=explain.d.ts.map

package/dist/core/context/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/core/context/explain.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAwB,iBAAiB,EAAE,YAAY,EAAc,MAAM,sBAAsB,CAAC;AAC9G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChC,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAmC7F;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT;IAAE,aAAa,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAWlD;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAiBjG;AAqCD,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,iBAAiB,GAAG,IAAI,CAwG3E"}

package/dist/core/context/explain.js

@@ -0,0 +1,199 @@
+import { compareStrings, uniqueSorted } from "../../model/canonical.js";
+import { isInside, normalizeRelative } from "../../util/paths.js";
+/** Resolves a human supplied path/id to a module (and, optionally, a file). */
+export function resolveTarget(graph, rawTarget) {
+    const target = normalizeRelative(rawTarget);
+    if (target.length === 0)
+        return null;
+    const modules = graph.repository.modules;
+    const exactModule = modules.find((module) => module.id === target);
+    if (exactModule !== undefined)
+        return { moduleId: exactModule.id, filePath: null, matchedBy: 'module id' };
+    const fileModule = graph.fileToModule.get(target);
+    if (fileModule !== undefined)
+        return { moduleId: fileModule, filePath: target, matchedBy: 'file path' };
+    const packageMatch = graph.repository.workspace.packages.find((entry) => entry.name === target);
+    if (packageMatch !== undefined) {
+        const module = modules.find((entry) => entry.id === packageMatch.name || entry.path === packageMatch.path);
+        if (module !== undefined)
+            return { moduleId: module.id, filePath: null, matchedBy: 'workspace package name' };
+    }
+    const containing = modules
+        .filter((module) => module.path.length > 0 && isInside(module.path, target))
+        .sort((a, b) => b.path.length - a.path.length);
+    if (containing[0] !== undefined)
+        return { moduleId: containing[0].id, filePath: null, matchedBy: 'module directory' };
+    const byName = modules
+        .filter((module) => module.name === target || module.id.endsWith(`/${target}`))
+        .sort((a, b) => compareStrings(a.id, b.id));
+    if (byName[0] !== undefined)
+        return { moduleId: byName[0].id, filePath: null, matchedBy: 'module name' };
+    const prefixMatches = modules
+        .filter((module) => module.id.startsWith(target))
+        .sort((a, b) => compareStrings(a.id, b.id));
+    if (prefixMatches[0] !== undefined) {
+        return { moduleId: prefixMatches[0].id, filePath: null, matchedBy: 'module id prefix' };
+    }
+    return null;
+}
+/** Counts the file-level edges that connect two modules. */
+export function countEdgesBetween(graph, from, to) {
+    const files = new Set();
+    const relationships = new Set();
+    for (const edge of graph.fileEdges) {
+        if (edge.fromKind !== 'file' || edge.toKind !== 'file')
+            continue;
+        if (graph.fileToModule.get(edge.from) !== from)
+            continue;
+        if (graph.fileToModule.get(edge.to) !== to)
+            continue;
+        files.add(edge.from);
+        relationships.add(edge.relationship);
+    }
+    return { relationships: uniqueSorted(relationships), files: files.size };
+}
+/** Breadth-first transitive dependents: what a change here would touch. */
+export function transitiveDependents(graph, moduleId, depth = 3) {
+    const visited = new Set();
+    let frontier = [moduleId];
+    for (let level = 0; level < depth; level += 1) {
+        const next = [];
+        for (const current of frontier) {
+            for (const edge of graph.moduleEdges) {
+                if (edge.to !== current)
+                    continue;
+                if (visited.has(edge.from) || edge.from === moduleId)
+                    continue;
+                visited.add(edge.from);
+                next.push(edge.from);
+            }
+        }
+        if (next.length === 0)
+            break;
+        frontier = next;
+    }
+    return [...visited].sort(compareStrings);
+}
+function relevantConventions(moduleFiles, conventions) {
+    const files = new Set(moduleFiles);
+    const scoped = conventions.filter((convention) => convention.evidence.some((evidence) => files.has(evidence.source.split('#')[0] ?? evidence.source)));
+    const repositoryWide = conventions.filter((convention) => (convention.category === 'Toolchain' || convention.category === 'Imports') && !scoped.includes(convention));
+    return [...scoped, ...repositoryWide].slice(0, 6);
+}
+function relevantDecisions(moduleFiles, decisions) {
+    const files = new Set(moduleFiles);
+    const scoped = decisions.filter((decision) => decision.evidence.some((evidence) => {
+        const source = evidence.source.split('#')[0] ?? evidence.source;
+        if (files.has(source))
+            return true;
+        return source.length > 0 && [...files].some((file) => file.startsWith(`${source}/`));
+    }));
+    const global = decisions.filter((decision) => decision.kind === 'config-signal' && !scoped.includes(decision));
+    return [...scoped, ...global].slice(0, 5);
+}
+function buildSummary(graph, moduleId) {
+    const module = graph.repository.modules.find((entry) => entry.id === moduleId);
+    if (module === undefined)
+        return `No module found for "${moduleId}".`;
+    const roleText = module.roles.length > 0
+        ? ` Detected roles (heuristic): ${module.roles.map((role) => `${role.value} ${role.confidence.toFixed(2)}`).join(', ')}.`
+        : ' No architectural role reached the confidence threshold.';
+    return `${module.id} (${module.path || '<repository root>'}) — ${module.files.length} file(s), ${module.entryPoints.length} entry point(s), ${module.dependsOn.length} internal dependency/dependencies, used by ${module.usedBy.length} module(s).${roleText}`;
+}
+/** Produces the module explanation returned by `explain`. */
+export function explainModule(input) {
+    const { graph, parsed } = input;
+    const resolved = resolveTarget(graph, input.target);
+    if (resolved === null || resolved.moduleId === null)
+        return null;
+    const module = graph.repository.modules.find((entry) => entry.id === resolved.moduleId);
+    if (module === undefined)
+        return null;
+    const maxRelatedFiles = input.maxRelatedFiles ?? 25;
+    const moduleFileSet = new Set(module.files);
+    const dependsOn = module.dependsOn
+        .map((dependencyId) => {
+        const target = graph.repository.modules.find((entry) => entry.id === dependencyId);
+        const counts = countEdgesBetween(graph, module.id, dependencyId);
+        return {
+            id: dependencyId,
+            path: target?.path ?? dependencyId,
+            relationships: counts.relationships.length > 0 ? counts.relationships : ['depends-on'],
+            files: counts.files,
+        };
+    })
+        .sort((a, b) => compareStrings(a.id, b.id));
+    const usedBy = module.usedBy
+        .map((dependentId) => {
+        const source = graph.repository.modules.find((entry) => entry.id === dependentId);
+        const counts = countEdgesBetween(graph, dependentId, module.id);
+        return {
+            id: dependentId,
+            path: source?.path ?? dependentId,
+            relationships: counts.relationships.length > 0 ? counts.relationships : ['used-by'],
+            files: counts.files,
+        };
+    })
+        .sort((a, b) => compareStrings(a.id, b.id));
+    const externalCounts = new Map();
+    for (const edge of graph.fileEdges) {
+        if (edge.fromKind !== 'file' || edge.toKind !== 'package')
+            continue;
+        if (!moduleFileSet.has(edge.from))
+            continue;
+        externalCounts.set(edge.to, (externalCounts.get(edge.to) ?? 0) + 1);
+    }
+    const externalDependencies = [...externalCounts.entries()]
+        .map(([name, count]) => {
+        const entry = graph.repository.externalDependencies.find((candidate) => candidate.name === name);
+        return {
+            name,
+            scope: entry?.scope ?? 'runtime',
+            importance: entry?.importance ??
+                ({
+                    value: 'utility',
+                    confidence: 0.3,
+                    evidence: [{ source: '<graph>', detail: `imported from ${count} file(s) of this module` }],
+                }),
+        };
+    })
+        .sort((a, b) => b.importance.confidence === a.importance.confidence
+        ? compareStrings(a.name, b.name)
+        : b.importance.confidence - a.importance.confidence);
+    const publicApi = [...module.publicExports].sort((a, b) => compareStrings(a.name, b.name));
+    const publicKeys = new Set(publicApi.map((entry) => `${entry.file}#${entry.name}`));
+    const internalSymbols = graph.repository.symbols
+        .filter((symbol) => moduleFileSet.has(symbol.file) && !publicKeys.has(symbol.id))
+        .slice(0, 40)
+        .map((symbol) => ({ name: symbol.name, kind: symbol.kind, file: symbol.file }));
+    const impactModules = transitiveDependents(graph, module.id);
+    const impactFiles = uniqueSorted(graph.repository.modules.filter((entry) => impactModules.includes(entry.id)).flatMap((entry) => entry.files));
+    const targetNote = resolved.matchedBy === 'file path' && resolved.filePath !== null
+        ? ` Target "${resolved.filePath}" was matched to this module by file path.`
+        : '';
+    return {
+        module: {
+            id: module.id,
+            path: module.path,
+            name: module.name,
+            basis: module.basis,
+            roles: module.roles,
+            responsibilities: module.responsibilities,
+        },
+        summary: `${buildSummary(graph, module.id)}${targetNote}`,
+        entryPoints: module.entryPoints,
+        dependsOn,
+        usedBy,
+        externalDependencies,
+        publicApi,
+        internalSymbols,
+        conventions: relevantConventions(module.files, graph.repository.conventions),
+        decisions: relevantDecisions(module.files, graph.repository.decisions),
+        tests: { files: module.testFiles, testCount: module.testFiles.length },
+        git: module.git,
+        impact: { modules: impactModules, files: impactFiles.slice(0, 100) },
+        relatedFiles: module.files.slice(0, maxRelatedFiles),
+        warnings: parsed.size === 0 ? [{ code: 'WARN_NO_PARSED_FILES', severity: 'info', message: 'no parsed files available' }] : [],
+    };
+}
+//# sourceMappingURL=explain.js.map

package/dist/core/context/explain.js.map

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

package/dist/core/context/repository-context.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Repository level context projection.
+ *
+ * This is what an MCP client (or `explain` without a target) receives: a compact,
+ * structured overview — what the repository is, how it is organized, which modules
+ * matter, what is imported from outside, which commands exist, where documented
+ * decisions live. It summarises the graph; `explain` and `search` drill down.
+ */
+import type { ContextCommand, RepositoryContextPayload } from './types.ts';
+import type { KnowledgeGraph } from '../graph/knowledge-graph.ts';
+import type { ParsedFile } from '../../adapters/language/types.ts';
+/** Collects the runnable commands declared by the repository (documented facts). */
+export declare function collectCommands(graph: KnowledgeGraph): ContextCommand[];
+/** Builds the repository context payload. */
+export declare function buildRepositoryContext(graph: KnowledgeGraph, parsed: Map<string, ParsedFile>): RepositoryContextPayload;
+//# sourceMappingURL=repository-context.d.ts.map

package/dist/core/context/repository-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-context.d.ts","sourceRoot":"","sources":["../../../src/core/context/repository-context.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAOnE,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,EAAE,CAuBvE;AACD,6CAA6C;AAC7C,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAC9B,wBAAwB,CAsG1B"}