@ai-agent-context/core 0.1.0

package/dist/core/graph/modules.js

@@ -0,0 +1,139 @@
+import { basename, depth, dirname, isInside, normalizeRelative, relativeTo, stem } from "../../util/paths.js";
+import { compareStrings } from "../../model/canonical.js";
+const ENTRY_NAME_PATTERN = /^(index|mod)\.[cm]?[jt]sx?$/;
+function isModuleFile(file) {
+    return file.kind === 'source' || file.kind === 'test';
+}
+/** Directory of the nearest workspace package, or `null` when none contains the path. */
+function owningPackageDirectory(workspace, filePath) {
+    const candidates = [...workspace.packages].sort((a, b) => b.path.length - a.path.length);
+    for (const entry of candidates) {
+        if (entry.path.length === 0 || isInside(entry.path, filePath)) {
+            return { directory: normalizeRelative(entry.path), name: entry.name };
+        }
+    }
+    return null;
+}
+export function buildModules(input) {
+    const moduleFiles = input.files.filter(isModuleFile);
+    const candidates = [];
+    const takenIds = new Set();
+    const addCandidate = (candidate) => {
+        if (candidates.some((entry) => entry.directory === candidate.directory))
+            return;
+        let id = candidate.id;
+        if (takenIds.has(id))
+            id = candidate.directory;
+        takenIds.add(id);
+        candidates.push({ ...candidate, id });
+    };
+    // 1. workspace packages are always modules
+    for (const entry of input.workspace.packages) {
+        addCandidate({
+            directory: normalizeRelative(entry.path),
+            basis: 'workspace-package',
+            id: entry.name,
+            packageName: entry.name,
+        });
+    }
+    const fileCountByDirectory = new Map();
+    const directoriesWithEntry = new Set();
+    for (const file of moduleFiles) {
+        const directory = normalizeRelative(dirname(file.path));
+        fileCountByDirectory.set(directory, (fileCountByDirectory.get(directory) ?? 0) + 1);
+        if (ENTRY_NAME_PATTERN.test(basename(file.path)))
+            directoriesWithEntry.add(directory);
+    }
+    // 2. directories exposing an index/mod entry file
+    for (const directory of [...directoriesWithEntry].sort(compareStrings)) {
+        const ownership = owningPackageDirectory(input.workspace, directory);
+        const packageDirectory = ownership?.directory ?? '';
+        if (directory === packageDirectory)
+            continue;
+        addCandidate({ directory, basis: 'index-file', id: directory, packageName: ownership?.name ?? null });
+    }
+    // 3. directories up to `moduleDepth` below their package root with >= 2 files
+    const sortedDirectories = [...fileCountByDirectory].sort((a, b) => compareStrings(a[0], b[0]));
+    for (const [directory, count] of sortedDirectories) {
+        if (count < 2)
+            continue;
+        const ownership = owningPackageDirectory(input.workspace, directory);
+        const packageDirectory = ownership?.directory ?? '';
+        const relative = directory.length === 0 ? '' : (relativeTo(packageDirectory, directory) ?? directory);
+        const relativeDepth = relative.length === 0 ? 0 : depth(relative);
+        if (relativeDepth < 1 || relativeDepth > input.moduleDepth)
+            continue;
+        addCandidate({ directory, basis: 'directory', id: directory, packageName: ownership?.name ?? null });
+    }
+    candidates.sort((a, b) => a.directory.length === b.directory.length
+        ? compareStrings(a.directory, b.directory)
+        : b.directory.length - a.directory.length);
+    const fileToModule = new Map();
+    const modulesById = new Map();
+    const moduleForFile = (file) => {
+        for (const candidate of candidates) {
+            if (candidate.directory.length === 0 || isInside(candidate.directory, file.path)) {
+                return {
+                    id: candidate.id,
+                    basis: candidate.basis,
+                    directory: candidate.directory,
+                    packageName: candidate.packageName,
+                };
+            }
+        }
+        return { id: file.path, basis: 'single-file', directory: normalizeRelative(dirname(file.path)), packageName: null };
+    };
+    for (const file of moduleFiles) {
+        const assignment = moduleForFile(file);
+        fileToModule.set(file.path, assignment.id);
+        let moduleNode = modulesById.get(assignment.id);
+        if (moduleNode === undefined) {
+            moduleNode = {
+                id: assignment.id,
+                path: assignment.directory,
+                name: assignment.basis === 'workspace-package'
+                    ? assignment.id
+                    : assignment.basis === 'single-file'
+                        ? stem(file.path)
+                        : basename(assignment.directory) || assignment.directory,
+                basis: assignment.basis,
+                roles: [],
+                packageName: assignment.packageName,
+                isWorkspacePackage: assignment.basis === 'workspace-package',
+                files: [],
+                entryPoints: [],
+                dependsOn: [],
+                usedBy: [],
+                publicExports: [],
+                boundaries: [],
+                signals: [],
+                responsibilities: [],
+                git: null,
+                testFiles: [],
+            };
+            modulesById.set(assignment.id, moduleNode);
+        }
+        moduleNode.files.push(file.path);
+        if (file.kind === 'test')
+            moduleNode.testFiles.push(file.path);
+        const parsed = input.parsed.get(file.path);
+        if (parsed !== undefined) {
+            for (const signal of parsed.signals) {
+                if (!moduleNode.signals.includes(signal))
+                    moduleNode.signals.push(signal);
+            }
+        }
+        file.moduleId = assignment.id;
+        file.packageName = assignment.packageName;
+    }
+    for (const moduleNode of modulesById.values()) {
+        if (moduleNode.basis === 'single-file')
+            moduleNode.path = normalizeRelative(dirname(moduleNode.files[0] ?? ''));
+        moduleNode.files.sort(compareStrings);
+        moduleNode.testFiles.sort(compareStrings);
+        moduleNode.signals.sort(compareStrings);
+    }
+    const modules = [...modulesById.values()].sort((a, b) => compareStrings(a.id, b.id));
+    return { modules, fileToModule };
+}
+//# sourceMappingURL=modules.js.map

package/dist/core/graph/modules.js.map

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

package/dist/core/graph/resolver.d.ts

@@ -0,0 +1,50 @@
+import type { DependencyKind } from '../../model/types.ts';
+/** Extensions tried when a specifier has no extension, in deterministic order. */
+export declare const RESOLUTION_EXTENSIONS: string[];
+export interface AliasEntry {
+    /** Pattern such as `@app/*` or `@app/domain`. */
+    pattern: string;
+    /** Replacement targets, e.g. `src/*`. */
+    targets: string[];
+    /** Directory that relative targets are resolved against. */
+    base: string;
+    /** tsconfig that declared the alias. */
+    source: string;
+}
+export interface ResolverInput {
+    /** All analyzed file paths (repository-relative POSIX). */
+    filePaths: ReadonlySet<string>;
+    /** Path aliases collected from tsconfig files. */
+    aliases: AliasEntry[];
+    /** Workspace package name → package directory and entry candidates. */
+    workspacePackages: Map<string, {
+        directory: string;
+        entries: string[];
+    }>;
+}
+export interface ResolvedImport {
+    kind: DependencyKind;
+    /** Resolved file path, package name or builtin name. */
+    target: string;
+    /** Entry file of a workspace package, when known. */
+    entry: string | null;
+    confidence: number;
+    evidence: string;
+    /** Candidates that were tried and rejected (only for unresolved imports). */
+    attempts: string[];
+}
+/** Tries the extension and index-file candidates of a specifier base path. */
+export declare function withExtensions(base: string, filePaths: ReadonlySet<string>): string | null;
+export declare class ImportResolver {
+    private readonly filePaths;
+    private readonly aliases;
+    private readonly workspacePackages;
+    constructor(input: ResolverInput);
+    /** Resolves a specifier written in `fromFile`. */
+    resolve(specifier: string, fromFile: string): ResolvedImport;
+    private resolveWorkspaceEntry;
+    private matchAlias;
+}
+/** Relative specifier target without extension resolution; used by tests. */
+export declare function relativeSpecifierTarget(specifier: string, fromFile: string): string;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/core/graph/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/core/graph/resolver.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO3D,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,UAAmF,CAAC;AAWtH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,kDAAkD;IAClD,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,uEAAuE;IACvE,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAoB1F;AAaD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqC;gBAE3D,KAAK,EAAE,aAAa;IAShC,kDAAkD;IAClD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc;IA8D5D,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,UAAU;CA4BnB;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnF"}

package/dist/core/graph/resolver.js

@@ -0,0 +1,180 @@
+/**
+ * Import resolution.
+ *
+ * Resolution is deterministic and purely in-memory: it looks only at the set of
+ * analyzed files plus alias/workspace metadata, which is why a single file change
+ * never triggers a full repository re-read.
+ *
+ * Classification distinguishes the dependency kinds the task requires: internal
+ * file, workspace package, external package and Node built-in modules (plus an
+ * honest `unresolved` result with the candidates that were tried).
+ */
+import { builtinModules } from 'node:module';
+import { extname, dirname, join, normalizeRelative } from "../../util/paths.js";
+import { compareStrings } from "../../model/canonical.js";
+import { packageNameFromSpecifier } from "../../adapters/language/ts-js/package-signals.js";
+const BUILTINS = new Set([...builtinModules, ...builtinModules.map((name) => `node:${name}`)]);
+/** Extensions tried when a specifier has no extension, in deterministic order. */
+export const RESOLUTION_EXTENSIONS = ['.ts', '.tsx', '.mts', '.cts', '.d.ts', '.js', '.jsx', '.mjs', '.cjs', '.json'];
+/** TypeScript ESM rewrite: `./x.js` may be emitted from `./x.ts`. */
+const ESM_TO_TS = {
+    '.js': ['.ts', '.tsx', '.d.ts', '.js'],
+    '.jsx': ['.tsx', '.jsx'],
+    '.mjs': ['.mts', '.mjs'],
+    '.cjs': ['.cts', '.cjs'],
+    '.d.ts': ['.d.ts'],
+};
+/** Tries the extension and index-file candidates of a specifier base path. */
+export function withExtensions(base, filePaths) {
+    const normalized = normalizeRelative(base);
+    if (filePaths.has(normalized))
+        return normalized;
+    const extension = extname(normalized);
+    if (extension.length > 0) {
+        const rewrites = ESM_TO_TS[extension];
+        if (rewrites === undefined)
+            return null;
+        const stem = normalized.slice(0, -extension.length);
+        for (const candidate of rewrites) {
+            if (filePaths.has(`${stem}${candidate}`))
+                return `${stem}${candidate}`;
+        }
+        return null;
+    }
+    for (const candidate of RESOLUTION_EXTENSIONS) {
+        if (filePaths.has(`${normalized}${candidate}`))
+            return `${normalized}${candidate}`;
+    }
+    for (const candidate of RESOLUTION_EXTENSIONS) {
+        if (filePaths.has(`${normalized}/index${candidate}`))
+            return `${normalized}/index${candidate}`;
+    }
+    return null;
+}
+function unresolved(specifier, attempts) {
+    return {
+        kind: 'unresolved',
+        target: specifier,
+        entry: null,
+        confidence: 0.3,
+        evidence: `could not resolve "${specifier}" to an analyzed file`,
+        attempts,
+    };
+}
+export class ImportResolver {
+    filePaths;
+    aliases;
+    workspacePackages;
+    constructor(input) {
+        this.filePaths = input.filePaths;
+        // Deeper `base` first: the tsconfig closest to the importing file wins.
+        this.aliases = [...input.aliases].sort((a, b) => a.base.length === b.base.length ? compareStrings(a.pattern, b.pattern) : b.base.length - a.base.length);
+        this.workspacePackages = input.workspacePackages;
+    }
+    /** Resolves a specifier written in `fromFile`. */
+    resolve(specifier, fromFile) {
+        const normalizedSpecifier = specifier.replace(/\\/g, '/');
+        if (normalizedSpecifier.length === 0)
+            return unresolved(specifier, ['empty specifier']);
+        if (normalizedSpecifier.startsWith('.') || normalizedSpecifier.startsWith('/')) {
+            const base = join(dirname(fromFile), normalizedSpecifier);
+            const resolved = withExtensions(base, this.filePaths);
+            if (resolved !== null) {
+                const sameDirectory = dirname(fromFile) === dirname(resolved);
+                return {
+                    kind: 'internal-file',
+                    target: resolved,
+                    entry: null,
+                    confidence: 0.99,
+                    evidence: sameDirectory
+                        ? `relative import inside ${dirname(fromFile) === '' ? '<repository root>' : dirname(fromFile)}`
+                        : `relative import resolved to ${resolved}`,
+                    attempts: [],
+                };
+            }
+            return unresolved(specifier, [`no analyzed file matched "${base}" with a known extension or index file`]);
+        }
+        const aliasMatch = this.matchAlias(normalizedSpecifier);
+        if (aliasMatch !== null)
+            return aliasMatch;
+        const packageName = packageNameFromSpecifier(normalizedSpecifier);
+        if (packageName !== null) {
+            const workspacePackage = this.workspacePackages.get(packageName);
+            if (workspacePackage !== undefined) {
+                return {
+                    kind: 'workspace-package',
+                    target: packageName,
+                    entry: this.resolveWorkspaceEntry(packageName),
+                    confidence: 0.97,
+                    evidence: `specifier resolves to workspace package "${packageName}" (${workspacePackage.directory})`,
+                    attempts: [],
+                };
+            }
+            if (BUILTINS.has(normalizedSpecifier)) {
+                return {
+                    kind: 'node-builtin',
+                    target: normalizedSpecifier,
+                    entry: null,
+                    confidence: 0.99,
+                    evidence: 'specifier is a Node.js built-in module',
+                    attempts: [],
+                };
+            }
+            return {
+                kind: 'external-package',
+                target: packageName,
+                entry: null,
+                confidence: 0.96,
+                evidence: 'specifier is an external package dependency',
+                attempts: [],
+            };
+        }
+        return unresolved(specifier, ['specifier is neither relative, aliased, nor a package name']);
+    }
+    resolveWorkspaceEntry(packageName) {
+        const workspacePackage = this.workspacePackages.get(packageName);
+        if (workspacePackage === undefined)
+            return null;
+        for (const candidate of workspacePackage.entries) {
+            const resolved = withExtensions(candidate, this.filePaths);
+            if (resolved !== null)
+                return resolved;
+        }
+        return null;
+    }
+    matchAlias(specifier) {
+        for (const alias of this.aliases) {
+            const wildcard = alias.pattern.includes('*');
+            if (!wildcard && alias.pattern !== specifier)
+                continue;
+            const prefix = wildcard ? alias.pattern.slice(0, alias.pattern.indexOf('*')) : alias.pattern;
+            if (!specifier.startsWith(prefix))
+                continue;
+            const rest = wildcard ? specifier.slice(prefix.length) : '';
+            for (const target of alias.targets) {
+                const substituted = wildcard ? target.replace('*', rest) : target;
+                const base = normalizeRelative(join(alias.base, substituted));
+                const resolved = withExtensions(base, this.filePaths);
+                if (resolved !== null) {
+                    return {
+                        kind: 'internal-file',
+                        target: resolved,
+                        entry: null,
+                        confidence: 0.95,
+                        evidence: `alias "${alias.pattern}" declared in ${alias.source} resolved to ${resolved}`,
+                        attempts: [],
+                    };
+                }
+            }
+            return unresolved(specifier, [
+                `alias "${alias.pattern}" declared in ${alias.source} did not resolve to an analyzed file`,
+            ]);
+        }
+        return null;
+    }
+}
+/** Relative specifier target without extension resolution; used by tests. */
+export function relativeSpecifierTarget(specifier, fromFile) {
+    return normalizeRelative(join(dirname(fromFile), specifier));
+}
+//# sourceMappingURL=resolver.js.map

package/dist/core/graph/resolver.js.map

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

package/dist/core/scanner/cache.d.ts

@@ -0,0 +1,49 @@
+import type { FileKind, ParsedFileSnapshot } from './types.ts';
+export interface FileStateRecord {
+    hash: string;
+    size: number;
+    mtimeMs: number;
+    language: string;
+    kind: FileKind;
+}
+export interface LocalStateCounts {
+    files: number;
+    modules: number;
+    dependencies: number;
+    entryPoints: number;
+    conventions: number;
+    decisions: number;
+}
+export interface LocalState {
+    schemaVersion: number;
+    generatedBy: string;
+    toolVersion: string;
+    /** ISO timestamp of the last successful scan (local only, never canonical). */
+    lastScanAt: string | null;
+    /** Hash of the resolved configuration; a change invalidates the cache. */
+    configHash: string;
+    counts: LocalStateCounts;
+    files: Record<string, FileStateRecord>;
+    /** Hashes of the canonical `.agent/*` files as written by the last scan. */
+    canonical: Record<string, string>;
+}
+export declare function localStatePath(root: string): string;
+export declare function cacheDirectory(root: string): string;
+export declare class LocalStateStore {
+    private readonly file;
+    constructor(root: string);
+    get path(): string;
+    read(): Promise<LocalState | null>;
+    write(state: LocalState): Promise<void>;
+    remove(): Promise<void>;
+}
+/** Content-addressed cache of parse results. */
+export declare class ParseCache {
+    private readonly root;
+    constructor(root: string);
+    get directory(): string;
+    get(hash: string): Promise<ParsedFileSnapshot | null>;
+    put(hash: string, file: ParsedFileSnapshot): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/core/scanner/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/core/scanner/cache.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAI/D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACvC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,IAAI,EAAE,MAAM;IAIxB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,IAAI,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA2BlC,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAG9B;AAMD,gDAAgD;AAChD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,IAAI,EAAE,MAAM;IAIxB,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEK,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAYrD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/core/scanner/cache.js

@@ -0,0 +1,101 @@
+/**
+ * Local (gitignored) incremental scanning state.
+ *
+ * Two artifacts, both inside `.agent/.local/` so they are never committed:
+ * - `state.json` — per file hash/size/mtime plus the last scan timestamp;
+ * - `cache/<shard>/<sha256>.json` — content-addressed parse results, so an
+ *   unchanged file (or an identical file elsewhere in the repository) is never
+ *   parsed twice.
+ */
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { AGENT_DIR, LOCAL_DIR, SCHEMA_VERSION, STATE_FILE, GENERATOR_NAME } from "../../model/schema.js";
+import { stringifyCanonical } from "../../model/canonical.js";
+export function localStatePath(root) {
+    return path.join(root, STATE_FILE);
+}
+export function cacheDirectory(root) {
+    return path.join(root, AGENT_DIR, LOCAL_DIR, 'cache');
+}
+export class LocalStateStore {
+    file;
+    constructor(root) {
+        this.file = localStatePath(root);
+    }
+    get path() {
+        return this.file;
+    }
+    async read() {
+        try {
+            const contents = await readFile(this.file, 'utf8');
+            const parsed = JSON.parse(contents);
+            if (parsed.schemaVersion !== SCHEMA_VERSION)
+                return null;
+            return {
+                schemaVersion: SCHEMA_VERSION,
+                generatedBy: parsed.generatedBy ?? GENERATOR_NAME,
+                toolVersion: parsed.toolVersion ?? '0.0.0',
+                lastScanAt: parsed.lastScanAt ?? null,
+                configHash: parsed.configHash ?? '',
+                counts: {
+                    files: parsed.counts?.files ?? 0,
+                    modules: parsed.counts?.modules ?? 0,
+                    dependencies: parsed.counts?.dependencies ?? 0,
+                    entryPoints: parsed.counts?.entryPoints ?? 0,
+                    conventions: parsed.counts?.conventions ?? 0,
+                    decisions: parsed.counts?.decisions ?? 0,
+                },
+                files: parsed.files ?? {},
+                canonical: parsed.canonical ?? {},
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async write(state) {
+        await mkdir(path.dirname(this.file), { recursive: true });
+        await writeFile(this.file, stringifyCanonical(state), 'utf8');
+    }
+    async remove() {
+        await rm(this.file, { force: true });
+    }
+}
+function shardPath(root, hash) {
+    return path.join(cacheDirectory(root), hash.slice(0, 2), `${hash}.json`);
+}
+/** Content-addressed cache of parse results. */
+export class ParseCache {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    get directory() {
+        return cacheDirectory(this.root);
+    }
+    async get(hash) {
+        if (hash.length === 0)
+            return null;
+        try {
+            const contents = await readFile(shardPath(this.root, hash), 'utf8');
+            const parsed = JSON.parse(contents);
+            if (parsed.schemaVersion !== SCHEMA_VERSION || parsed.file === undefined)
+                return null;
+            return parsed.file;
+        }
+        catch {
+            return null;
+        }
+    }
+    async put(hash, file) {
+        if (hash.length === 0)
+            return;
+        const target = shardPath(this.root, hash);
+        await mkdir(path.dirname(target), { recursive: true });
+        await writeFile(target, stringifyCanonical({ schemaVersion: SCHEMA_VERSION, file }), 'utf8');
+    }
+    async clear() {
+        await rm(this.directory, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/core/scanner/cache.js.map

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

package/dist/core/scanner/scanner.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Repository scanner.
+ *
+ * Pipeline: walk → decide what changed → parse only what changed → emit file
+ * facts. Parsing is content-addressed, so:
+ *
+ * - a file whose size and mtime are unchanged is never read at all;
+ * - a changed file is hashed and, when its hash is already cached, not re-parsed;
+ * - a new file that is byte-identical to an existing one reuses its cache entry.
+ *
+ * The scanner performs no language specific work: adapters are resolved through
+ * the {@link LanguageRegistry} and return the language-agnostic IR.
+ */
+import type { ChangeSet, FileKind, FileNode } from '../../model/types.ts';
+import type { ParsedFile } from '../../adapters/language/types.ts';
+import type { AgentContextConfig } from '../../config/types.ts';
+import type { DiagnosticsCollector, Logger, ProgressReporter } from '../../logging/diagnostics.ts';
+import { FileSystemAdapter } from '../../adapters/filesystem/fs-adapter.ts';
+import { LanguageRegistry } from '../../adapters/language/registry.ts';
+import type { ParseCache, LocalState } from './cache.ts';
+/** Classifies a file, language agnostically. */
+export declare function classifyFile(path: string, signals?: readonly string[]): FileKind;
+export interface ScanOptions {
+    root: string;
+    config: AgentContextConfig;
+    /** Hash of the resolved configuration, used for cache invalidation. */
+    configHash: string;
+    registry?: LanguageRegistry;
+    fsAdapter?: FileSystemAdapter;
+    /** Previous local state, when available (enables the incremental path). */
+    state: LocalState | null;
+    cache: ParseCache;
+    diagnostics: DiagnosticsCollector;
+    logger: Logger;
+    progress?: ProgressReporter;
+}
+export interface ScanOutput {
+    files: FileNode[];
+    /** Parsed facts of every readable file, keyed by repository-relative path. */
+    parsed: Map<string, ParsedFile>;
+    changes: ChangeSet;
+    /** Number of files whose content was parsed during this scan. */
+    parsedNow: number;
+    /** Number of files served from the local parse cache without being parsed. */
+    reused: number;
+    skippedSensitive: string[];
+    skippedLarge: string[];
+    failed: string[];
+    partial: string[];
+    /** All walked paths, used for lockfile and workspace detection. */
+    presentFiles: Set<string>;
+    /** Raw contents of pnpm-workspace.yaml, when present. */
+    pnpmWorkspaceYaml: string | null;
+}
+/**
+ * Scans a repository and returns file level facts plus the change set relative to
+ * the previous local state.
+ */
+export declare function scanRepository(options: ScanOptions): Promise<ScanOutput>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/core/scanner/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/core/scanner/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAKhE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACnG,OAAO,EAAE,iBAAiB,EAAmB,MAAM,yCAAyC,CAAC;AAE7F,OAAO,EAAE,gBAAgB,EAAyB,MAAM,qCAAqC,CAAC;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA6CzD,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO,GAAG,QAAQ,CAmBpF;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,CAAC;IAC3B,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,2EAA2E;IAC3E,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,oBAAoB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,8EAA8E;IAC9E,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChC,OAAO,EAAE,SAAS,CAAC;IACnB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mEAAmE;IACnE,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAmCD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAsN9E"}