@ai-agent-context/core 0.1.0

package/dist/agent-context.js

@@ -0,0 +1,243 @@
+/**
+ * Public API of `ai-agent-context`.
+ *
+ * ```ts
+ * import { AgentContext } from 'ai-agent-context';
+ *
+ * const context = await AgentContext.load({ root: process.cwd() });
+ * const payments = await context.explain('src/payments');
+ * ```
+ *
+ * Design notes:
+ * - the facade is the only entry point to the pipeline and it is what the CLI and
+ *   the MCP adapter call, so neither contains business logic;
+ * - read-only queries use a *dry run* of the pipeline: the local cache makes it
+ *   cheap and `.agent/` on disk is never modified by a query;
+ * - `scan()` is the only method that persists the context.
+ */
+import path from 'node:path';
+import { existsSync } from 'node:fs';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { Logger } from "./logging/diagnostics.js";
+import { AGENT_DIR, AGENT_GITIGNORE, CONFIG_FILE } from "./model/schema.js";
+import { compareStrings } from "./model/canonical.js";
+import { loadConfig, writeConfigFile } from "./config/load.js";
+import { runPipeline } from "./pipeline/scan-pipeline.js";
+import { readPersistedContext } from "./core/serialization/reader.js";
+import { LocalStateStore } from "./core/scanner/cache.js";
+import { explainModule } from "./core/context/explain.js";
+import { buildRepositoryContext } from "./core/context/repository-context.js";
+import { SearchService } from "./core/search/service.js";
+import { ContextStateError } from "./errors.js";
+export class AgentContext {
+    root;
+    options;
+    resolvedConfig;
+    configSource = null;
+    pipeline = null;
+    persisted = null;
+    constructor(root, options, config) {
+        this.root = root;
+        this.options = options;
+        this.resolvedConfig = config;
+    }
+    /**
+     * Loads the context for a repository.
+     *
+     * Nothing is scanned yet: the first query (or `scan()`) runs the pipeline. This
+     * keeps `AgentContext.load()` cheap for callers that only need configuration.
+     */
+    static async load(options = {}) {
+        const root = path.resolve(options.root ?? process.cwd());
+        const loaded = await loadConfig({
+            root,
+            ...(options.config === undefined ? {} : { overrides: options.config }),
+            ...(options.configPath === undefined ? {} : { configPath: options.configPath }),
+        });
+        const context = new AgentContext(root, options, loaded.config);
+        context.configSource = loaded.source;
+        context.persisted = await readPersistedContext(root);
+        return context;
+    }
+    /** Resolved configuration (defaults + config file + overrides). */
+    get config() {
+        return this.resolvedConfig;
+    }
+    /** Path of the configuration file in use, relative to the root, when it exists. */
+    get configFile() {
+        return this.configSource;
+    }
+    pipelineOptions(scanOptions = {}) {
+        return {
+            root: this.root,
+            ...(this.options.config === undefined ? {} : { overrides: this.options.config }),
+            ...(this.options.configPath === undefined ? {} : { configPath: this.options.configPath }),
+            logger: this.options.logger ?? new Logger({ level: 'silent' }),
+            ...(this.options.registry === undefined ? {} : { registry: this.options.registry }),
+            ...(this.options.progress === undefined ? {} : { progress: this.options.progress }),
+            ...(this.options.now === undefined ? {} : { now: this.options.now }),
+            ...(this.options.gitAdapter === undefined ? {} : { gitAdapter: this.options.gitAdapter }),
+            dryRun: scanOptions.dryRun === true,
+            force: scanOptions.force === true,
+        };
+    }
+    /** Runs the pipeline; read-only queries use `dryRun` so nothing is written. */
+    async ensurePipeline(scanOptions = {}) {
+        const dryRun = scanOptions.dryRun === true;
+        if (this.pipeline !== null && (dryRun || !scanOptions.force))
+            return this.pipeline;
+        const result = await runPipeline(this.pipelineOptions(scanOptions));
+        this.pipeline = result;
+        return result;
+    }
+    /** Scans the repository and persists the context into `.agent/`. */
+    async scan(options = {}) {
+        const result = await this.ensurePipeline({ ...options, dryRun: options.dryRun === true, force: true });
+        this.pipeline = result;
+        this.persisted = await readPersistedContext(this.root);
+        return result.report;
+    }
+    /** Complete repository model, in memory. */
+    async getRepository() {
+        return (await this.ensurePipeline()).graph.repository;
+    }
+    /** Architecture projection. */
+    async getArchitecture() {
+        return (await this.ensurePipeline()).documents.architecture;
+    }
+    async getDependencies() {
+        return (await this.ensurePipeline()).documents.dependencies;
+    }
+    async getConventions() {
+        return (await this.ensurePipeline()).documents.conventions.conventions;
+    }
+    async getDecisions() {
+        return (await this.ensurePipeline()).documents.decisions.decisions;
+    }
+    async getIndex() {
+        return (await this.ensurePipeline()).documents.index;
+    }
+    async getFiles() {
+        return (await this.ensurePipeline()).graph.repository.files;
+    }
+    /** Modules of the repository, each with heuristic roles and evidence. */
+    async getModules() {
+        return (await this.ensurePipeline()).graph.repository.modules;
+    }
+    /** Module ids that depend on the given module (direct dependents). */
+    async getDependents(moduleId) {
+        const repository = await this.getRepository();
+        return (repository.modules.find((module) => module.id === moduleId)?.usedBy ?? []).sort(compareStrings);
+    }
+    /** Module ids the given module depends on. */
+    async getDependenciesOf(moduleId) {
+        const repository = await this.getRepository();
+        return (repository.modules.find((module) => module.id === moduleId)?.dependsOn ?? []).sort(compareStrings);
+    }
+    /** Compact, agent oriented repository context. */
+    async getRepositoryContext() {
+        const result = await this.ensurePipeline();
+        return buildRepositoryContext(result.graph, result.parsed);
+    }
+    /** Structured explanation of a module (or of the module owning a file). */
+    async explain(target) {
+        const result = await this.ensurePipeline();
+        return explainModule({ graph: result.graph, parsed: result.parsed, target });
+    }
+    /** Context changes relative to the persisted context. */
+    async diff() {
+        return (await this.ensurePipeline()).diff;
+    }
+    /** Deterministic lexical search over files, modules, symbols, conventions, decisions. */
+    async search(query, options = {}) {
+        const result = await this.ensurePipeline();
+        return SearchService.fromGraph({ graph: result.graph, parsed: result.parsed }).search(query, options);
+    }
+    /** Search with an explicitly provided backend (embeddings, vector database, ...). */
+    async searchWith(service, query, options = {}) {
+        await this.ensurePipeline();
+        return service.search(query, options);
+    }
+    /** Compares the working tree with the persisted context. */
+    async status() {
+        const result = await this.ensurePipeline();
+        const persisted = this.persisted ?? (await readPersistedContext(this.root));
+        const state = await new LocalStateStore(this.root).read();
+        const configHashMatches = state !== null && state.configHash === result.configHash;
+        const changes = result.report.changes;
+        const pending = changes.added.length > 0 || changes.modified.length > 0 || changes.deleted.length > 0;
+        const present = [];
+        if (persisted.index !== null)
+            present.push('index.json');
+        if (persisted.architecture !== null)
+            present.push('architecture.json');
+        if (persisted.dependencies !== null)
+            present.push('dependencies.json');
+        if (persisted.conventions !== null)
+            present.push('conventions.json');
+        if (persisted.decisions !== null)
+            present.push('decisions.json');
+        const status = persisted.index === null ? 'missing' : pending || !configHashMatches ? 'stale' : 'up-to-date';
+        return {
+            status,
+            lastScanAt: state?.lastScanAt ?? null,
+            configPath: this.configSource,
+            configHashMatches,
+            contextFiles: { present, missing: [...persisted.missing], invalid: [...persisted.invalid] },
+            changes,
+            counts: state?.counts ?? {
+                files: 0,
+                modules: 0,
+                dependencies: 0,
+                entryPoints: 0,
+                conventions: 0,
+                decisions: 0,
+            },
+            git: {
+                available: result.git.availability.available,
+                ...(result.git.availability.reason === undefined ? {} : { reason: result.git.availability.reason }),
+                commitsAnalyzed: result.git.commitsAnalyzed,
+            },
+        };
+    }
+    /**
+     * Creates `.agent/` and `.agent/config.json`.
+     *
+     * Idempotent: an existing configuration is left untouched unless `force` is set.
+     */
+    async init(options = {}) {
+        const configPath = path.join(this.root, CONFIG_FILE);
+        const existed = existsSync(configPath);
+        const created = [];
+        if (!existsSync(path.join(this.root, AGENT_DIR))) {
+            await mkdir(path.join(this.root, AGENT_DIR), { recursive: true });
+            created.push(`${AGENT_DIR}/`);
+        }
+        const gitignorePath = path.join(this.root, AGENT_DIR, '.gitignore');
+        if (!existsSync(gitignorePath)) {
+            await writeFile(gitignorePath, AGENT_GITIGNORE, 'utf8');
+            created.push(`${AGENT_DIR}/.gitignore`);
+        }
+        let overwritten = false;
+        if (!existed || options.force === true) {
+            const loaded = await loadConfig({ root: this.root, ignoreFile: true });
+            await writeConfigFile(this.root, loaded.config, true);
+            if (existed)
+                overwritten = true;
+            else
+                created.push(CONFIG_FILE);
+        }
+        return { configPath, created: created.sort(compareStrings), alreadyExisted: existed, overwritten };
+    }
+    /** Returns the persisted context or throws a helpful error when it is missing. */
+    async requirePersistedContext() {
+        const persisted = this.persisted ?? (await readPersistedContext(this.root));
+        if (persisted.index === null) {
+            throw new ContextStateError('No usable .agent/ context found in this repository.', [
+                'Run: agent-context init && agent-context scan',
+            ]);
+        }
+        return persisted;
+    }
+}
+//# sourceMappingURL=agent-context.js.map

package/dist/agent-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context.js","sourceRoot":"","sources":["../src/agent-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIpD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAclD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAuB,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAyB,MAAM,gCAAgC,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAmB,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,OAAO,EAAE,aAAa,EAAsB,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA2ChD,MAAM,OAAO,YAAY;IACd,IAAI,CAAS;IACL,OAAO,CAAsB;IACtC,cAAc,CAAqB;IACnC,YAAY,GAAkB,IAAI,CAAC;IACnC,QAAQ,GAA0B,IAAI,CAAC;IACvC,SAAS,GAA4B,IAAI,CAAC;IAElD,YAAoB,IAAY,EAAE,OAA4B,EAAE,MAA0B;QACxF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAA+B,EAAE;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;YAC9B,IAAI;YACJ,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;YACtE,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;SAChF,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/D,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;QACrC,OAAO,CAAC,SAAS,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,mEAAmE;IACnE,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,mFAAmF;IACnF,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAEO,eAAe,CAAC,cAA2B,EAAE;QACnD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAChF,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACzF,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnF,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnF,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACpE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACzF,MAAM,EAAE,WAAW,CAAC,MAAM,KAAK,IAAI;YACnC,KAAK,EAAE,WAAW,CAAC,KAAK,KAAK,IAAI;SAClC,CAAC;IACJ,CAAC;IAED,+EAA+E;IACvE,KAAK,CAAC,cAAc,CAAC,cAA2B,EAAE;QACxD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,KAAK,IAAI,CAAC;QAC3C,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;QACnF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,IAAI,CAAC,UAAuB,EAAE;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvG,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,aAAa;QACjB,OAAO,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IACxD,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,eAAe;QACnB,OAAO,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,OAAO,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,OAAO,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,OAAO,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC;IAC9D,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,UAAU;QACd,OAAO,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;IAChE,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,aAAa,CAAC,QAAgB;QAClC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9C,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1G,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QACtC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9C,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC7G,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAC,oBAAoB;QACxB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC3C,OAAO,sBAAsB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7D,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,OAAO,CAAC,MAAc;QAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC3C,OAAO,aAAa,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,IAAI;QACR,OAAO,CAAC,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC;IAED,yFAAyF;IACzF,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,UAAyB,EAAE;QACrD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC3C,OAAO,aAAa,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxG,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,UAAU,CAAC,OAAsB,EAAE,KAAa,EAAE,UAAyB,EAAE;QACjF,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC5B,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,iBAAiB,GAAG,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU,CAAC;QACnF,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QACtC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACtG,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,SAAS,CAAC,KAAK,KAAK,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzD,IAAI,SAAS,CAAC,YAAY,KAAK,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACvE,IAAI,SAAS,CAAC,YAAY,KAAK,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACvE,IAAI,SAAS,CAAC,WAAW,KAAK,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACrE,IAAI,SAAS,CAAC,SAAS,KAAK,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAEjE,MAAM,MAAM,GACV,SAAS,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;QAEhG,OAAO;YACL,MAAM;YACN,UAAU,EAAE,KAAK,EAAE,UAAU,IAAI,IAAI;YACrC,UAAU,EAAE,IAAI,CAAC,YAAY;YAC7B,iBAAiB;YACjB,YAAY,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE;YAC3F,OAAO;YACP,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI;gBACvB,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,CAAC;gBACV,YAAY,EAAE,CAAC;gBACf,WAAW,EAAE,CAAC;gBACd,WAAW,EAAE,CAAC;gBACd,SAAS,EAAE,CAAC;aACb;YACD,GAAG,EAAE;gBACH,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,SAAS;gBAC5C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;gBACnG,eAAe,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe;aAC5C;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,UAA+B,EAAE;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QACvC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;YACjD,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;QACpE,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC/B,MAAM,SAAS,CAAC,aAAa,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;YACxD,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,aAAa,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACtD,IAAI,OAAO;gBAAE,WAAW,GAAG,IAAI,CAAC;;gBAC3B,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IACrG,CAAC;IAED,kFAAkF;IAClF,KAAK,CAAC,uBAAuB;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5E,IAAI,SAAS,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,IAAI,iBAAiB,CAAC,qDAAqD,EAAE;gBACjF,+CAA+C;aAChD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/config/defaults.d.ts

@@ -0,0 +1,13 @@
+/** Default configuration, aligned with the documented `.agent/config.json` example. */
+import type { AgentContextConfig } from './types.ts';
+/** Directory patterns that are never analyzed. */
+export declare const DEFAULT_EXCLUDE: string[];
+export declare const DEFAULT_INCLUDE: string[];
+/** Files that are never read, even when they match the include patterns. */
+export declare const DEFAULT_SENSITIVE_PATTERNS: string[];
+export declare const DEFAULT_CONFIG: AgentContextConfig;
+/** Directories searched for architecture decision records and documentation. */
+export declare const DECISION_SOURCES: string[];
+/** Documented package.json fields that represent entry points. */
+export declare const PACKAGE_ENTRY_FIELDS: readonly ["main", "module", "types", "browser", "exports", "bin"];
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,kDAAkD;AAClD,eAAO,MAAM,eAAe,EAAE,MAAM,EAenC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,EAA+F,CAAC;AAEpI,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,EAAE,MAAM,EAwB9C,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,kBAsC5B,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,EAAE,MAAM,EAUpC,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,mEAAoE,CAAC"}

package/dist/config/defaults.js

@@ -0,0 +1,98 @@
+/** Directory patterns that are never analyzed. */
+export const DEFAULT_EXCLUDE = [
+    'node_modules/**',
+    'dist/**',
+    'build/**',
+    'out/**',
+    'coverage/**',
+    'vendor/**',
+    'target/**',
+    '.git/**',
+    '.agent/**',
+    '.cache/**',
+    '.next/**',
+    '.turbo/**',
+    '.venv/**',
+    '__pycache__/**',
+];
+export const DEFAULT_INCLUDE = ['src/**', 'packages/**', 'apps/**', 'lib/**', 'test/**', 'tests/**', '**/*.md', '*.json'];
+/** Files that are never read, even when they match the include patterns. */
+export const DEFAULT_SENSITIVE_PATTERNS = [
+    '**/.env',
+    '**/.env.*',
+    '**/*.env',
+    '**/.npmrc',
+    '**/.pypirc',
+    '**/.netrc',
+    '**/.htpasswd',
+    '**/.git-credentials',
+    '**/credentials',
+    '**/credentials.*',
+    '**/secrets',
+    '**/secrets.*',
+    '**/*.pem',
+    '**/*.key',
+    '**/*.p12',
+    '**/*.pfx',
+    '**/*.jks',
+    '**/*.keystore',
+    '**/*.crt',
+    '**/id_rsa*',
+    '**/id_ed25519*',
+    '**/.ssh/**',
+    '**/service-account*.json',
+];
+export const DEFAULT_CONFIG = {
+    version: 1,
+    root: '.',
+    include: [...DEFAULT_INCLUDE],
+    exclude: [...DEFAULT_EXCLUDE],
+    ignore: [],
+    languages: ['typescript', 'javascript'],
+    features: {
+        architecture: true,
+        dependencies: true,
+        conventions: true,
+        decisions: true,
+        git: true,
+        search: true,
+    },
+    analysis: {
+        moduleDepth: 2,
+        concurrency: 0, // 0 => derive from the machine (see util/concurrency)
+        maxFileSizeBytes: 1_048_576,
+        followSymlinks: false,
+        sourceRoots: ['src', 'lib', 'app', 'apps', 'packages', 'services'],
+        git: {
+            windowDays: 180,
+            maxCommits: 5000,
+            recentDays: 30,
+            architectureSignalPatterns: ['refactor', 'architecture', 'adr', 'breaking', 'migrat', 'restructure', 'rewrite'],
+        },
+    },
+    output: {
+        includeTimestamp: false,
+        prettyJson: true,
+        conventionsMarkdown: true,
+    },
+    security: {
+        allowSensitiveFiles: false,
+        redactSecrets: true,
+        extraSensitivePatterns: [],
+    },
+};
+/** Directories searched for architecture decision records and documentation. */
+export const DECISION_SOURCES = [
+    'docs',
+    'docs/adr',
+    'adr',
+    'adrs',
+    'architecture',
+    'docs/architecture',
+    'doc',
+    'spec',
+    'specs',
+];
+/** Documented package.json fields that represent entry points. */
+export const PACKAGE_ENTRY_FIELDS = ['main', 'module', 'types', 'browser', 'exports', 'bin'];
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAGA,kDAAkD;AAClD,MAAM,CAAC,MAAM,eAAe,GAAa;IACvC,iBAAiB;IACjB,SAAS;IACT,UAAU;IACV,QAAQ;IACR,aAAa;IACb,WAAW;IACX,WAAW;IACX,SAAS;IACT,WAAW;IACX,WAAW;IACX,UAAU;IACV,WAAW;IACX,UAAU;IACV,gBAAgB;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEpI,4EAA4E;AAC5E,MAAM,CAAC,MAAM,0BAA0B,GAAa;IAClD,SAAS;IACT,WAAW;IACX,UAAU;IACV,WAAW;IACX,YAAY;IACZ,WAAW;IACX,cAAc;IACd,qBAAqB;IACrB,gBAAgB;IAChB,kBAAkB;IAClB,YAAY;IACZ,cAAc;IACd,UAAU;IACV,UAAU;IACV,UAAU;IACV,UAAU;IACV,UAAU;IACV,eAAe;IACf,UAAU;IACV,YAAY;IACZ,gBAAgB;IAChB,YAAY;IACZ,0BAA0B;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAuB;IAChD,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,GAAG;IACT,OAAO,EAAE,CAAC,GAAG,eAAe,CAAC;IAC7B,OAAO,EAAE,CAAC,GAAG,eAAe,CAAC;IAC7B,MAAM,EAAE,EAAE;IACV,SAAS,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;IACvC,QAAQ,EAAE;QACR,YAAY,EAAE,IAAI;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,IAAI;QACf,GAAG,EAAE,IAAI;QACT,MAAM,EAAE,IAAI;KACb;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC,EAAE,sDAAsD;QACtE,gBAAgB,EAAE,SAAS;QAC3B,cAAc,EAAE,KAAK;QACrB,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC;QAClE,GAAG,EAAE;YACH,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,EAAE;YACd,0BAA0B,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,CAAC;SAChH;KACF;IACD,MAAM,EAAE;QACN,gBAAgB,EAAE,KAAK;QACvB,UAAU,EAAE,IAAI;QAChB,mBAAmB,EAAE,IAAI;KAC1B;IACD,QAAQ,EAAE;QACR,mBAAmB,EAAE,KAAK;QAC1B,aAAa,EAAE,IAAI;QACnB,sBAAsB,EAAE,EAAE;KAC3B;CACF,CAAC;AAEF,gFAAgF;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAAa;IACxC,MAAM;IACN,UAAU;IACV,KAAK;IACL,MAAM;IACN,cAAc;IACd,mBAAmB;IACnB,KAAK;IACL,MAAM;IACN,OAAO;CACR,CAAC;AAEF,kEAAkE;AAClE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAU,CAAC"}

package/dist/config/load.d.ts

@@ -0,0 +1,25 @@
+import type { AgentContextConfig, ConfigOverrides, LoadedConfig } from './types.ts';
+/** Deep merge of CLI overrides on top of a resolved configuration. */
+export declare function applyOverrides(config: AgentContextConfig, overrides: ConfigOverrides | undefined): AgentContextConfig;
+/** Validation of the merged result (guards against contradictory overrides). */
+export declare function validateMerged(config: AgentContextConfig): string[];
+export interface LoadConfigOptions {
+    /** Repository root (absolute or relative to `process.cwd()`). */
+    root: string;
+    /** CLI overrides; take precedence over the config file. */
+    overrides?: ConfigOverrides;
+    /** Explicit config file path. Defaults to `<root>/.agent/config.json`. */
+    configPath?: string;
+    /** Skip reading the config file entirely (used by `init`). */
+    ignoreFile?: boolean;
+}
+export declare function loadConfig(options: LoadConfigOptions): Promise<LoadedConfig>;
+/** Synchronous config resolution for CLI startup paths that must not await. */
+export declare function resolveConfigSync(root: string, overrides?: ConfigOverrides, configText?: string): LoadedConfig;
+/** Validates an already parsed configuration object (used by tests and adapters). */
+export declare function normalizeConfig(raw: unknown): AgentContextConfig;
+/** Writes `.agent/config.json`, creating `.agent/` when necessary. */
+export declare function writeConfigFile(root: string, config: AgentContextConfig, pretty?: boolean): Promise<string>;
+/** Configuration template written by `agent-context init` (documented in the README). */
+export declare function initConfigTemplate(): AgentContextConfig;
+//# sourceMappingURL=load.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpF,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,eAAe,GAAG,SAAS,GAAG,kBAAkB,CAmBrH;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAYnE;AAED,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAqBlF;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CAc9G;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAEhE;AAED,sEAAsE;AACtE,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,UAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAM9G;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,IAAI,kBAAkB,CAEvD"}

package/dist/config/load.js

@@ -0,0 +1,106 @@
+/**
+ * Configuration loading and merging.
+ *
+ * Precedence (highest first):
+ * 1. CLI flags (`ConfigOverrides`)
+ * 2. `.agent/config.json`
+ * 3. built-in defaults
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { ConfigError } from "../errors.js";
+import { hashValue, stringifyCanonical } from "../model/canonical.js";
+import { AGENT_DIR, CONFIG_FILE } from "../model/schema.js";
+import { DEFAULT_CONFIG } from "./defaults.js";
+import { parseConfigText, validateConfig } from "./validate.js";
+/** Deep merge of CLI overrides on top of a resolved configuration. */
+export function applyOverrides(config, overrides) {
+    if (!overrides)
+        return config;
+    const merged = {
+        ...config,
+        include: overrides.include ?? config.include,
+        exclude: overrides.exclude ?? config.exclude,
+        ignore: overrides.ignore ?? config.ignore,
+        languages: overrides.languages ?? config.languages,
+        features: { ...config.features, ...(overrides.features ?? {}) },
+        analysis: {
+            ...config.analysis,
+            ...(overrides.analysis ?? {}),
+            git: { ...config.analysis.git, ...(overrides.analysis?.git ?? {}) },
+        },
+        output: { ...config.output, ...(overrides.output ?? {}) },
+        security: { ...config.security, ...(overrides.security ?? {}) },
+    };
+    if (overrides.root !== undefined)
+        merged.root = overrides.root;
+    return merged;
+}
+/** Validation of the merged result (guards against contradictory overrides). */
+export function validateMerged(config) {
+    const warnings = [];
+    if (config.include.length === 0) {
+        warnings.push('include patterns are empty: no files will be analyzed');
+    }
+    if (config.languages.length === 0) {
+        warnings.push('no languages configured: no source files will be parsed');
+    }
+    if (config.analysis.moduleDepth < 1) {
+        throw new ConfigError('analysis.moduleDepth must be >= 1', ['Set moduleDepth to at least 1 in .agent/config.json.']);
+    }
+    return warnings;
+}
+export async function loadConfig(options) {
+    const root = path.resolve(options.root);
+    const configPath = options.configPath ? path.resolve(options.configPath) : path.join(root, CONFIG_FILE);
+    const warnings = [];
+    let fileConfig = structuredClone(DEFAULT_CONFIG);
+    let source = null;
+    if (!options.ignoreFile && existsSync(configPath)) {
+        source = path.relative(root, configPath).split(path.sep).join('/');
+        const text = await readFile(configPath, 'utf8');
+        const validated = parseConfigText(text, source);
+        fileConfig = validated.config;
+        warnings.push(...validated.warnings);
+    }
+    const config = applyOverrides(fileConfig, options.overrides);
+    warnings.push(...validateMerged(config));
+    // Note: `root` is intentionally excluded from the hash — moving a repository
+    // must not invalidate the local cache.
+    const hash = hashValue({ ...config, root: '.' });
+    return { config, source, hash, warnings };
+}
+/** Synchronous config resolution for CLI startup paths that must not await. */
+export function resolveConfigSync(root, overrides, configText) {
+    const configPath = path.join(path.resolve(root), CONFIG_FILE);
+    const warnings = [];
+    let fileConfig = structuredClone(DEFAULT_CONFIG);
+    let source = null;
+    if (configText !== undefined) {
+        source = path.relative(root, configPath).split(path.sep).join('/');
+        const validated = parseConfigText(configText, source);
+        fileConfig = validated.config;
+        warnings.push(...validated.warnings);
+    }
+    const config = applyOverrides(fileConfig, overrides);
+    warnings.push(...validateMerged(config));
+    return { config, source, hash: hashValue({ ...config, root: '.' }), warnings };
+}
+/** Validates an already parsed configuration object (used by tests and adapters). */
+export function normalizeConfig(raw) {
+    return validateConfig(raw).config;
+}
+/** Writes `.agent/config.json`, creating `.agent/` when necessary. */
+export async function writeConfigFile(root, config, pretty = true) {
+    const agentDir = path.join(root, AGENT_DIR);
+    await mkdir(agentDir, { recursive: true });
+    const target = path.join(root, CONFIG_FILE);
+    await writeFile(target, stringifyCanonical(config, pretty), 'utf8');
+    return target;
+}
+/** Configuration template written by `agent-context init` (documented in the README). */
+export function initConfigTemplate() {
+    return structuredClone(DEFAULT_CONFIG);
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

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

package/dist/config/types.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Configuration model of `ai-agent-context`.
+ *
+ * Configuration lives in `.agent/config.json` and can be overridden by CLI
+ * flags, which always take precedence over the file.
+ */
+export interface FeaturesConfig {
+    architecture: boolean;
+    dependencies: boolean;
+    conventions: boolean;
+    decisions: boolean;
+    /** Git metadata analysis (recently changed files, activity, ownership). */
+    git: boolean;
+    /** Local search index / query support. */
+    search: boolean;
+}
+export interface GitAnalysisConfig {
+    /** How far back `git log` looks, in days. */
+    windowDays: number;
+    /** Hard cap on parsed commits, to keep large repositories fast. */
+    maxCommits: number;
+    /** Window (days) used for the `recentChanges` / `recentActivity` signal. */
+    recentDays: number;
+    /** Patterns that mark a commit message as an architectural change signal. */
+    architectureSignalPatterns: string[];
+}
+export interface AnalysisConfig {
+    /**
+     * Maximum directory depth below a workspace package root at which
+     * automatically detected modules are created.
+     */
+    moduleDepth: number;
+    /** Bounded concurrency for file system and parsing work. */
+    concurrency: number;
+    /** Files larger than this are recorded but not parsed. */
+    maxFileSizeBytes: number;
+    /** Never followed by default: symlink loops are a real risk in monorepos. */
+    followSymlinks: boolean;
+    /** Directories treated as source roots when deriving module ids. */
+    sourceRoots: string[];
+    git: GitAnalysisConfig;
+}
+export interface OutputConfig {
+    /**
+     * When `true`, `generatedAt` is written into `.agent/index.json`. Disabled by
+     * default so that an unchanged repository produces an unchanged context.
+     */
+    includeTimestamp: boolean;
+    prettyJson: boolean;
+    /** Generate the human readable `.agent/conventions.md` projection. */
+    conventionsMarkdown: boolean;
+}
+export interface SecurityConfig {
+    /** Opt-in escape hatch for reading `.env`-like files. Off by default. */
+    allowSensitiveFiles: boolean;
+    /** Redact secret-looking values from excerpts copied into the context. */
+    redactSecrets: boolean;
+    /** Additional glob patterns treated as sensitive. */
+    extraSensitivePatterns: string[];
+}
+export interface AgentContextConfig {
+    version: number;
+    root: string;
+    include: string[];
+    exclude: string[];
+    ignore: string[];
+    languages: string[];
+    features: FeaturesConfig;
+    analysis: AnalysisConfig;
+    output: OutputConfig;
+    security: SecurityConfig;
+}
+/** Deep partial used for CLI overrides and `init --force` templates. */
+export interface ConfigOverrides {
+    root?: string;
+    include?: string[];
+    exclude?: string[];
+    ignore?: string[];
+    languages?: string[];
+    features?: Partial<FeaturesConfig>;
+    analysis?: Partial<Omit<AnalysisConfig, 'git'>> & {
+        git?: Partial<GitAnalysisConfig>;
+    };
+    output?: Partial<OutputConfig>;
+    security?: Partial<SecurityConfig>;
+}
+export interface LoadedConfig {
+    config: AgentContextConfig;
+    /** Path of the config file that was read, or `null` for pure defaults. */
+    source: string | null;
+    /** Stable hash of the resolved configuration (used for cache invalidation). */
+    hash: string;
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,GAAG,EAAE,OAAO,CAAC;IACb,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,0BAA0B,EAAE,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,gBAAgB,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,cAAc,EAAE,OAAO,CAAC;IACxB,oEAAoE;IACpE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,EAAE,iBAAiB,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,mBAAmB,EAAE,OAAO,CAAC;IAC7B,0EAA0E;IAC1E,aAAa,EAAE,OAAO,CAAC;IACvB,qDAAqD;IACrD,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC,GAAG;QAAE,GAAG,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;KAAE,CAAC;IACvF,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,0EAA0E;IAC1E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/config/types.js

@@ -0,0 +1,8 @@
+/**
+ * Configuration model of `ai-agent-context`.
+ *
+ * Configuration lives in `.agent/config.json` and can be overridden by CLI
+ * flags, which always take precedence over the file.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

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