@ai-agent-context/core 0.1.0

package/dist/config/validate.d.ts

@@ -0,0 +1,15 @@
+import type { AgentContextConfig } from './types.ts';
+export interface ValidatedConfig {
+    config: AgentContextConfig;
+    warnings: string[];
+}
+/**
+ * Validates raw configuration JSON against the documented schema.
+ *
+ * Unknown keys produce warnings (forward compatibility) while invalid types
+ * raise {@link ConfigError}.
+ */
+export declare function validateConfig(raw: unknown, source?: string): ValidatedConfig;
+/** Parses configuration text, translating JSON syntax errors into ConfigError. */
+export declare function parseConfigText(contents: string, source?: string): ValidatedConfig;
+//# sourceMappingURL=validate.d.ts.map

package/dist/config/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/config/validate.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,kBAAkB,EAMnB,MAAM,YAAY,CAAC;AA2EpB,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,SAAuB,GAAG,eAAe,CA4G3F;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAuB,GAAG,eAAe,CAYhG"}

package/dist/config/validate.js

@@ -0,0 +1,202 @@
+/**
+ * Hand-written validation.
+ *
+ * No runtime schema library is used on purpose: the package ships zero runtime
+ * dependencies, and validation errors must read like instructions, e.g.
+ *
+ * ```text
+ * .agent/config.json: "analysis.moduleDepth" must be an integer (received: string "two")
+ * ```
+ */
+import { ConfigError } from "../errors.js";
+import { DEFAULT_CONFIG } from "./defaults.js";
+const KNOWN_KEYS = new Set([
+    'version',
+    'root',
+    'include',
+    'exclude',
+    'ignore',
+    'languages',
+    'features',
+    'analysis',
+    'output',
+    'security',
+]);
+const FEATURE_KEYS = [
+    'architecture',
+    'dependencies',
+    'conventions',
+    'decisions',
+    'git',
+    'search',
+];
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function describe(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return `array(${value.length})`;
+    if (typeof value === 'object')
+        return 'object';
+    return `${typeof value} ${JSON.stringify(value)}`.trim();
+}
+function strings(value, path, source) {
+    if (!Array.isArray(value)) {
+        throw new ConfigError(`${source}: "${path}" must be an array of glob patterns (received: ${describe(value)})`);
+    }
+    return value.map((entry, index) => {
+        if (typeof entry !== 'string') {
+            throw new ConfigError(`${source}: "${path}[${index}]" must be a string (received: ${describe(entry)})`);
+        }
+        return entry;
+    });
+}
+function bool(value, path, source) {
+    if (typeof value !== 'boolean')
+        throw new ConfigError(`${source}: "${path}" must be a boolean (received: ${describe(value)})`);
+    return value;
+}
+function integer(value, path, source, min, max) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || !Number.isInteger(value)) {
+        throw new ConfigError(`${source}: "${path}" must be an integer (received: ${describe(value)})`);
+    }
+    if (value < min || value > max) {
+        throw new ConfigError(`${source}: "${path}" must be between ${min} and ${max} (received: ${value})`);
+    }
+    return value;
+}
+function text(value, path, source) {
+    if (typeof value !== 'string')
+        throw new ConfigError(`${source}: "${path}" must be a string (received: ${describe(value)})`);
+    return value;
+}
+function object(value, path, source) {
+    if (!isPlainObject(value))
+        throw new ConfigError(`${source}: "${path}" must be an object (received: ${describe(value)})`);
+    return value;
+}
+/**
+ * Validates raw configuration JSON against the documented schema.
+ *
+ * Unknown keys produce warnings (forward compatibility) while invalid types
+ * raise {@link ConfigError}.
+ */
+export function validateConfig(raw, source = '.agent/config.json') {
+    if (!isPlainObject(raw)) {
+        throw new ConfigError(`${source}: expected a JSON object at the top level (received: ${describe(raw)})`, [
+            'Run: agent-context init --force to regenerate a valid configuration.',
+        ]);
+    }
+    const warnings = [];
+    for (const key of Object.keys(raw)) {
+        if (!KNOWN_KEYS.has(key))
+            warnings.push(`${source}: unknown key "${key}" is ignored`);
+    }
+    const config = structuredClone(DEFAULT_CONFIG);
+    if (raw.version !== undefined)
+        config.version = integer(raw.version, 'version', source, 1, 1000);
+    if (raw.root !== undefined)
+        config.root = text(raw.root, 'root', source);
+    if (raw.include !== undefined)
+        config.include = strings(raw.include, 'include', source);
+    if (raw.exclude !== undefined)
+        config.exclude = strings(raw.exclude, 'exclude', source);
+    if (raw.ignore !== undefined)
+        config.ignore = strings(raw.ignore, 'ignore', source);
+    if (raw.languages !== undefined) {
+        config.languages = strings(raw.languages, 'languages', source).map((entry) => entry.trim().toLowerCase());
+    }
+    if (raw.features !== undefined) {
+        const rawFeatures = object(raw.features, 'features', source);
+        const features = { ...config.features };
+        for (const key of FEATURE_KEYS) {
+            const value = rawFeatures[key];
+            if (value !== undefined)
+                features[key] = bool(value, `features.${key}`, source);
+        }
+        for (const key of Object.keys(rawFeatures)) {
+            if (!FEATURE_KEYS.includes(key)) {
+                warnings.push(`${source}: unknown feature "${key}" is ignored`);
+            }
+        }
+        config.features = features;
+    }
+    if (raw.analysis !== undefined) {
+        const rawAnalysis = object(raw.analysis, 'analysis', source);
+        const analysis = { ...config.analysis };
+        if (rawAnalysis.moduleDepth !== undefined) {
+            analysis.moduleDepth = integer(rawAnalysis.moduleDepth, 'analysis.moduleDepth', source, 1, 10);
+        }
+        if (rawAnalysis.concurrency !== undefined) {
+            analysis.concurrency = integer(rawAnalysis.concurrency, 'analysis.concurrency', source, 0, 128);
+        }
+        if (rawAnalysis.maxFileSizeBytes !== undefined) {
+            analysis.maxFileSizeBytes = integer(rawAnalysis.maxFileSizeBytes, 'analysis.maxFileSizeBytes', source, 1024, 1_073_741_824);
+        }
+        if (rawAnalysis.followSymlinks !== undefined) {
+            analysis.followSymlinks = bool(rawAnalysis.followSymlinks, 'analysis.followSymlinks', source);
+        }
+        if (rawAnalysis.sourceRoots !== undefined) {
+            analysis.sourceRoots = strings(rawAnalysis.sourceRoots, 'analysis.sourceRoots', source);
+        }
+        if (rawAnalysis.git !== undefined) {
+            const rawGit = object(rawAnalysis.git, 'analysis.git', source);
+            const git = { ...analysis.git };
+            if (rawGit.windowDays !== undefined)
+                git.windowDays = integer(rawGit.windowDays, 'analysis.git.windowDays', source, 1, 3650);
+            if (rawGit.maxCommits !== undefined) {
+                git.maxCommits = integer(rawGit.maxCommits, 'analysis.git.maxCommits', source, 1, 1_000_000);
+            }
+            if (rawGit.recentDays !== undefined)
+                git.recentDays = integer(rawGit.recentDays, 'analysis.git.recentDays', source, 1, 3650);
+            if (rawGit.architectureSignalPatterns !== undefined) {
+                git.architectureSignalPatterns = strings(rawGit.architectureSignalPatterns, 'analysis.git.architectureSignalPatterns', source);
+            }
+            analysis.git = git;
+        }
+        config.analysis = analysis;
+    }
+    if (raw.output !== undefined) {
+        const rawOutput = object(raw.output, 'output', source);
+        const output = { ...config.output };
+        if (rawOutput.includeTimestamp !== undefined) {
+            output.includeTimestamp = bool(rawOutput.includeTimestamp, 'output.includeTimestamp', source);
+        }
+        if (rawOutput.prettyJson !== undefined)
+            output.prettyJson = bool(rawOutput.prettyJson, 'output.prettyJson', source);
+        if (rawOutput.conventionsMarkdown !== undefined) {
+            output.conventionsMarkdown = bool(rawOutput.conventionsMarkdown, 'output.conventionsMarkdown', source);
+        }
+        config.output = output;
+    }
+    if (raw.security !== undefined) {
+        const rawSecurity = object(raw.security, 'security', source);
+        const security = { ...config.security };
+        if (rawSecurity.allowSensitiveFiles !== undefined) {
+            security.allowSensitiveFiles = bool(rawSecurity.allowSensitiveFiles, 'security.allowSensitiveFiles', source);
+        }
+        if (rawSecurity.redactSecrets !== undefined) {
+            security.redactSecrets = bool(rawSecurity.redactSecrets, 'security.redactSecrets', source);
+        }
+        if (rawSecurity.extraSensitivePatterns !== undefined) {
+            security.extraSensitivePatterns = strings(rawSecurity.extraSensitivePatterns, 'security.extraSensitivePatterns', source);
+        }
+        config.security = security;
+    }
+    return { config, warnings };
+}
+/** Parses configuration text, translating JSON syntax errors into ConfigError. */
+export function parseConfigText(contents, source = '.agent/config.json') {
+    try {
+        return validateConfig(JSON.parse(contents), source);
+    }
+    catch (error) {
+        if (error instanceof ConfigError)
+            throw error;
+        const message = error instanceof Error ? error.message : String(error);
+        throw new ConfigError(`${source}: invalid JSON (${message})`, ['Run: agent-context init --force to regenerate the configuration.'], error);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/config/validate.js.map

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

package/dist/core/architecture/detector.d.ts

@@ -0,0 +1,10 @@
+import type { ParsedFile } from '../../adapters/language/types.ts';
+import type { KnowledgeGraph } from '../graph/knowledge-graph.ts';
+export interface ArchitectureDetectionSummary {
+    entryPoints: number;
+    rolesDetected: number;
+    modulesWithRoles: number;
+}
+/** Applies entry point, role and responsibility detection to the graph. */
+export declare function applyArchitectureDetection(graph: KnowledgeGraph, parsed: Map<string, ParsedFile>): ArchitectureDetectionSummary;
+//# sourceMappingURL=detector.d.ts.map

package/dist/core/architecture/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../../src/core/architecture/detector.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAInE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,2EAA2E;AAC3E,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAC9B,4BAA4B,CAkC9B"}

package/dist/core/architecture/detector.js

@@ -0,0 +1,37 @@
+import { compareStrings } from "../../model/canonical.js";
+import { detectEntryPoints } from "./entry-points.js";
+import { detectModuleRoles, detectResponsibilities } from "./role-detector.js";
+/** Applies entry point, role and responsibility detection to the graph. */
+export function applyArchitectureDetection(graph, parsed) {
+    const entryPoints = detectEntryPoints({
+        workspace: graph.repository.workspace,
+        files: graph.repository.files,
+        parsed,
+    });
+    graph.repository.entryPoints = entryPoints;
+    const entryPointsByModule = new Map();
+    for (const entry of entryPoints) {
+        if (entry.moduleId === null)
+            continue;
+        const list = entryPointsByModule.get(entry.moduleId) ?? [];
+        list.push(entry);
+        entryPointsByModule.set(entry.moduleId, list);
+    }
+    let rolesDetected = 0;
+    let modulesWithRoles = 0;
+    for (const module of graph.repository.modules) {
+        module.entryPoints = (entryPointsByModule.get(module.id) ?? []).sort((a, b) => a.path === b.path ? compareStrings(a.type, b.type) : compareStrings(a.path, b.path));
+        module.roles = detectModuleRoles({
+            module,
+            files: graph.repository.files,
+            parsed,
+            externalDependencies: graph.externalDependencies,
+        });
+        module.responsibilities = detectResponsibilities(module, parsed);
+        rolesDetected += module.roles.length;
+        if (module.roles.length > 0)
+            modulesWithRoles += 1;
+    }
+    return { entryPoints: entryPoints.length, rolesDetected, modulesWithRoles };
+}
+//# sourceMappingURL=detector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detector.js","sourceRoot":"","sources":["../../../src/core/architecture/detector.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAS/E,2EAA2E;AAC3E,MAAM,UAAU,0BAA0B,CACxC,KAAqB,EACrB,MAA+B;IAE/B,MAAM,WAAW,GAAG,iBAAiB,CAAC;QACpC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,SAAS;QACrC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK;QAC7B,MAAM;KACP,CAAC,CAAC;IACH,KAAK,CAAC,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;IAE3C,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC5D,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;YAAE,SAAS;QACtC,MAAM,IAAI,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC3D,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC9C,MAAM,CAAC,WAAW,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC5E,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CACpF,CAAC;QACF,MAAM,CAAC,KAAK,GAAG,iBAAiB,CAAC;YAC/B,MAAM;YACN,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK;YAC7B,MAAM;YACN,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;SACjD,CAAC,CAAC;QACH,MAAM,CAAC,gBAAgB,GAAG,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjE,aAAa,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QACrC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,gBAAgB,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC;AAC9E,CAAC"}

package/dist/core/architecture/entry-points.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Entry point detection.
+ *
+ * Sources of truth, in order of strength:
+ * 1. declared `package.json` fields (`main`, `module`, `exports`, `bin`);
+ * 2. npm scripts that reference a file (`start`, `dev`, `test`, ...);
+ * 3. naming conventions (`cli.ts`, `server.ts`, `main.ts`, `index.ts`);
+ * 4. behavioural signals (HTTP routes registered, workers started).
+ *
+ * Every entry point reports confidence and the evidence that produced it.
+ */
+import type { EntryPoint, FileNode, WorkspaceInfo } from '../../model/types.ts';
+import type { ParsedFile } from '../../adapters/language/types.ts';
+export interface EntryPointInput {
+    workspace: WorkspaceInfo;
+    files: FileNode[];
+    parsed: Map<string, ParsedFile>;
+}
+export declare function detectEntryPoints(input: EntryPointInput): EntryPoint[];
+//# sourceMappingURL=entry-points.d.ts.map

package/dist/core/architecture/entry-points.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-points.d.ts","sourceRoot":"","sources":["../../../src/core/architecture/entry-points.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAkB,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAanE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACjC;AAcD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,EAAE,CAqLtE"}

package/dist/core/architecture/entry-points.js

@@ -0,0 +1,190 @@
+import { SIGNALS } from "../../adapters/language/types.js";
+import { CONFIDENCE } from "../../model/schema.js";
+import { compareStrings } from "../../model/canonical.js";
+import { basename, dirname, join, normalizeRelative, stem } from "../../util/paths.js";
+import { truncate } from "../../util/text.js";
+import { withExtensions } from "../graph/resolver.js";
+const CLI_STEM = /^(cli|bin|command|commands)([-_.].*)?$/i;
+const APPLICATION_STEM = /^(index|main|server|app|bootstrap|start)$/i;
+const WORKER_STEM = /^(worker|workers|job|jobs|scheduler|consumer)([-_.].*)?$/i;
+const SCRIPT_FILE_PATTERN = /[\w./@-]+\.(?:[cm]?[jt]sx?)/g;
+function manifestPath(packageDirectory) {
+    return packageDirectory.length === 0 ? 'package.json' : `${packageDirectory}/package.json`;
+}
+/** `true` when a path sits directly in the package root or its `src` directory. */
+function isSourceRootLevel(filePath, packageDirectory) {
+    const directory = normalizeRelative(dirname(filePath));
+    const root = normalizeRelative(packageDirectory);
+    const candidates = new Set([root, root.length === 0 ? 'src' : `${root}/src`]);
+    return candidates.has(directory);
+}
+export function detectEntryPoints(input) {
+    const results = [];
+    const resolvable = new Set(input.files.map((file) => file.path));
+    const fileByPath = new Map(input.files.map((file) => [file.path, file]));
+    const add = (entry) => {
+        const exists = results.some((candidate) => candidate.path === entry.path && candidate.type === entry.type);
+        if (!exists)
+            results.push(entry);
+    };
+    // 1. declared package.json fields
+    for (const workspacePackage of input.workspace.packages) {
+        const manifest = manifestPath(workspacePackage.path);
+        for (const declared of workspacePackage.entries) {
+            if (declared.field === 'types')
+                continue;
+            const raw = declared.value.replace(/^\.\//, '');
+            const type = declared.field === 'bin' ? 'package-bin' : declared.field === 'exports' ? 'package-export' : 'package-main';
+            const resolved = withExtensions(join(workspacePackage.path, raw), resolvable);
+            if (resolved !== null) {
+                add({
+                    path: resolved,
+                    moduleId: fileByPath.get(resolved)?.moduleId ?? null,
+                    type,
+                    confidence: CONFIDENCE.declared,
+                    evidence: [{ source: manifest, detail: `package.json "${declared.field}" points here (${declared.value})` }],
+                    details: `declared by ${workspacePackage.name}`,
+                });
+            }
+            else if (!raw.includes('*')) {
+                add({
+                    path: normalizeRelative(join(workspacePackage.path, raw)),
+                    moduleId: null,
+                    type,
+                    confidence: 0.6,
+                    evidence: [
+                        {
+                            source: manifest,
+                            detail: `package.json "${declared.field}" points here (${declared.value}), but the file is not in the analyzed tree`,
+                        },
+                    ],
+                    details: `declared by ${workspacePackage.name}`,
+                });
+            }
+        }
+    }
+    // 2. npm scripts that reference a file
+    const scriptNames = (scripts) => Object.entries(scripts).sort((a, b) => compareStrings(a[0], b[0]));
+    for (const workspacePackage of input.workspace.packages) {
+        const manifest = manifestPath(workspacePackage.path);
+        for (const [scriptName, command] of scriptNames(workspacePackage.scripts)) {
+            const matches = command.match(SCRIPT_FILE_PATTERN) ?? [];
+            for (const candidate of matches) {
+                if (candidate.includes('node_modules'))
+                    continue;
+                const resolved = withExtensions(join(workspacePackage.path, candidate), resolvable);
+                if (resolved === null)
+                    continue;
+                const fileStem = stem(resolved);
+                const type = /test|spec/.test(scriptName) || /test|spec/.test(fileStem)
+                    ? 'test'
+                    : CLI_STEM.test(fileStem)
+                        ? 'cli'
+                        : /^(start|dev|serve|preview|run)$/.test(scriptName)
+                            ? 'application'
+                            : 'library';
+                add({
+                    path: resolved,
+                    moduleId: fileByPath.get(resolved)?.moduleId ?? null,
+                    type,
+                    confidence: 0.85,
+                    evidence: [{ source: manifest, detail: `npm script "${scriptName}" runs this file: ${truncate(command, 120)}` }],
+                    details: `script "${scriptName}"`,
+                });
+            }
+        }
+    }
+    // 3. naming conventions and behavioural signals
+    for (const file of input.files) {
+        if (file.kind === 'config' || file.kind === 'docs' || file.kind === 'asset')
+            continue;
+        const facts = input.parsed.get(file.path);
+        const fileStem = stem(file.path);
+        const moduleId = file.moduleId;
+        if (file.kind === 'test') {
+            add({
+                path: file.path,
+                moduleId,
+                type: 'test',
+                confidence: 0.95,
+                evidence: [{ source: file.path, detail: 'file name matches the test conventions of the repository' }],
+            });
+            continue;
+        }
+        if (facts !== undefined && facts.routes.length > 0) {
+            const preview = facts.routes.slice(0, 4).map((route) => `${route.method} ${route.path}`).join(', ');
+            add({
+                path: file.path,
+                moduleId,
+                type: 'http-routes',
+                confidence: 0.87,
+                evidence: [{ source: file.path, detail: `registers HTTP routes: ${preview}` }],
+            });
+        }
+        if (facts !== undefined && (facts.signals.includes(SIGNALS.worker) || facts.signals.includes(SIGNALS.schedule))) {
+            add({
+                path: file.path,
+                moduleId,
+                type: 'worker',
+                confidence: 0.7,
+                evidence: [
+                    {
+                        source: file.path,
+                        detail: `background work signals: ${facts.signals
+                            .filter((signal) => signal.startsWith('worker:') || signal.startsWith('schedule:'))
+                            .join(', ')}`,
+                    },
+                ],
+            });
+        }
+        if (CLI_STEM.test(fileStem) || (facts !== undefined && facts.signals.includes(SIGNALS.cliFramework))) {
+            add({
+                path: file.path,
+                moduleId,
+                type: 'cli',
+                confidence: facts?.signals.includes(SIGNALS.cliFramework) === true ? 0.85 : 0.8,
+                evidence: [{ source: file.path, detail: `entry naming matches CLI conventions ("${basename(file.path)}")` }],
+            });
+            continue;
+        }
+        if (WORKER_STEM.test(fileStem)) {
+            add({
+                path: file.path,
+                moduleId,
+                type: 'worker',
+                confidence: 0.7,
+                evidence: [{ source: file.path, detail: `entry naming matches worker conventions ("${basename(file.path)}")` }],
+            });
+            continue;
+        }
+        const owningPackageName = input.workspace.packages.find((entry) => entry.path.length === 0 ? true : file.path.startsWith(`${entry.path}/`))?.name;
+        const workspacePackage = input.workspace.packages.find((entry) => entry.name === owningPackageName);
+        if (workspacePackage !== undefined &&
+            isSourceRootLevel(file.path, workspacePackage.path) &&
+            APPLICATION_STEM.test(fileStem)) {
+            const type = fileStem === 'index' && (facts?.exports.length ?? 0) === 0 ? 'library' : 'application';
+            add({
+                path: file.path,
+                moduleId,
+                type,
+                confidence: fileStem === 'index' ? 0.7 : 0.85,
+                evidence: [
+                    { source: file.path, detail: `entry naming convention at the source root ("${basename(file.path)}")` },
+                ],
+                details: facts !== undefined && facts.routes.length > 0 ? 'registers HTTP routes' : undefined,
+            });
+            continue;
+        }
+        if (fileStem === 'index' && moduleId !== null && moduleId !== file.path) {
+            add({
+                path: file.path,
+                moduleId,
+                type: 'library',
+                confidence: 0.65,
+                evidence: [{ source: file.path, detail: 'module barrel file (index.*) re-exporting the module surface' }],
+            });
+        }
+    }
+    return results.sort((a, b) => (a.path === b.path ? compareStrings(a.type, b.type) : compareStrings(a.path, b.path)));
+}
+//# sourceMappingURL=entry-points.js.map

package/dist/core/architecture/entry-points.js.map

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

package/dist/core/architecture/role-detector.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Heuristic architectural role detection.
+ *
+ * Every role is a {@link Detection}: a value, a confidence and the evidence that
+ * produced it. Nothing here claims to be a fact — `payments` is reported as
+ * "looks like a service layer (0.72)" together with the signals behind it, so an
+ * agent (or a human) can verify instead of trusting.
+ *
+ * Confidences combine probabilistically (`1 - Π(1 - w)`): two independent signals
+ * are measurably stronger than one, and a single weak signal never looks certain.
+ */
+import type { Detection, ExternalDependency, FileNode, ModuleNode, ModuleRole } from '../../model/types.ts';
+import type { ParsedFile } from '../../adapters/language/types.ts';
+export interface RoleDetectionInput {
+    module: ModuleNode;
+    files: FileNode[];
+    parsed: Map<string, ParsedFile>;
+    externalDependencies: ExternalDependency[];
+}
+/** Detects architectural roles of a module, with confidence and evidence. */
+export declare function detectModuleRoles(input: RoleDetectionInput): Detection<ModuleRole>[];
+/**
+ * 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 declare function detectResponsibilities(module: ModuleNode, parsed: Map<string, ParsedFile>): Detection[];
+/** Sorted, unique list of detected role values (used by `diff`). */
+export declare function roleValues(roles: readonly Detection<ModuleRole>[]): string[];
+//# sourceMappingURL=role-detector.d.ts.map

package/dist/core/architecture/role-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-detector.d.ts","sourceRoot":"","sources":["../../../src/core/architecture/role-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC5G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAmInE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChC,oBAAoB,EAAE,kBAAkB,EAAE,CAAC;CAC5C;AAcD,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAAC,UAAU,CAAC,EAAE,CA6DpF;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,EAAE,CAmDvG;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,SAAS,CAAC,UAAU,CAAC,EAAE,GAAG,MAAM,EAAE,CAE5E"}