@ai-agent-context/core 0.1.0

package/dist/core/serialization/documents.js

@@ -0,0 +1,224 @@
+import { compareStrings, uniqueSorted } from "../../model/canonical.js";
+import { GENERATOR_NAME, SCHEMA_VERSION } from "../../model/schema.js";
+import { renderConventionsMarkdown } from "../conventions/renderer.js";
+function withTimestamp(document, options) {
+    return options.generatedAt === undefined ? document : { ...document, generatedAt: options.generatedAt };
+}
+/** Builds the `index.json` manifest. */
+export function buildIndexDocument(graph, parsed, config, options) {
+    const files = graph.repository.files;
+    const countKind = (kind) => files.filter((file) => file.kind === kind).length;
+    const document = {
+        schemaVersion: SCHEMA_VERSION,
+        generatedBy: GENERATOR_NAME,
+        repository: {
+            name: graph.repository.name,
+            rootName: graph.repository.name,
+            packageManager: graph.repository.workspace.packageManager,
+            workspaceModel: graph.repository.workspace.workspaceModel,
+            isMonorepo: graph.repository.workspace.isMonorepo,
+            languages: graph.repository.languages,
+            counts: {
+                files: files.length,
+                source: countKind('source'),
+                tests: countKind('test'),
+                config: countKind('config'),
+                docs: countKind('docs'),
+                assets: countKind('asset'),
+                modules: graph.repository.modules.length,
+                symbols: graph.repository.symbols.length,
+                dependencies: graph.repository.dependencies.length,
+                entryPoints: graph.repository.entryPoints.length,
+                conventions: graph.repository.conventions.length,
+                decisions: graph.repository.decisions.length,
+                externalDependencies: graph.repository.externalDependencies.length,
+            },
+        },
+        files: {
+            entries: files
+                .map((file) => ({
+                path: file.path,
+                hash: file.hash,
+                language: file.language,
+                kind: file.kind,
+                module: file.moduleId,
+            }))
+                .sort((a, b) => compareStrings(a.path, b.path)),
+            sensitiveSkipped: files.filter((file) => file.sensitive).map((file) => file.path).sort(compareStrings),
+        },
+        context: {
+            architecture: 'architecture.json',
+            dependencies: 'dependencies.json',
+            conventions: 'conventions.json',
+            conventionsMarkdown: 'conventions.md',
+            decisions: 'decisions.json',
+        },
+        git: config.features.git
+            ? { enabled: true, windowDays: config.analysis.git.windowDays, commitsAnalyzed: options.commitsAnalyzed }
+            : null,
+        diagnostics: options.diagnostics.sort((a, b) => compareStrings(`${a.code}|${a.source ?? ''}`, `${b.code}|${b.source ?? ''}`)),
+    };
+    void parsed;
+    return withTimestamp(document, options);
+}
+/** Builds `architecture.json`. */
+export function buildArchitectureDocument(graph, config, options) {
+    const repository = graph.repository;
+    const modules = repository.modules
+        .map((module) => ({
+        id: module.id,
+        path: module.path,
+        name: module.name,
+        basis: module.basis,
+        packageName: module.packageName,
+        isWorkspacePackage: module.isWorkspacePackage,
+        roles: module.roles,
+        responsibilities: module.responsibilities,
+        entryPoints: module.entryPoints.map((entry) => entry.path).sort(compareStrings),
+        dependsOn: [...module.dependsOn].sort(compareStrings),
+        usedBy: [...module.usedBy].sort(compareStrings),
+        publicExports: module.publicExports.map((entry) => ({ name: entry.name, kind: entry.kind, file: entry.file })),
+        boundaries: module.boundaries,
+        files: module.files.length,
+        fileList: [...module.files].sort(compareStrings),
+        testFiles: [...module.testFiles].sort(compareStrings),
+        signals: [...module.signals].sort(compareStrings),
+        git: module.git,
+    }))
+        .sort((a, b) => compareStrings(a.id, b.id));
+    const document = {
+        schemaVersion: SCHEMA_VERSION,
+        generatedBy: GENERATOR_NAME,
+        summary: {
+            modules: modules.length,
+            workspacePackages: repository.workspace.packages.length,
+            entryPoints: repository.entryPoints.length,
+            rolesDetected: modules.reduce((sum, module) => sum + module.roles.length, 0),
+            cycles: repository.cycles.length,
+        },
+        workspace: {
+            packageManager: repository.workspace.packageManager,
+            workspaceModel: repository.workspace.workspaceModel,
+            workspaceGlobs: repository.workspace.workspaceGlobs,
+            packageManagerEvidence: repository.workspace.packageManagerEvidence,
+            packages: repository.workspace.packages.map((entry) => ({
+                name: entry.name,
+                path: entry.path,
+                private: entry.private,
+                version: entry.version,
+                entries: entry.entries.length,
+            })),
+        },
+        entryPoints: [...repository.entryPoints].sort((a, b) => a.path === b.path ? compareStrings(a.type, b.type) : compareStrings(a.path, b.path)),
+        modules,
+    };
+    void config;
+    return withTimestamp(document, options);
+}
+const MAX_FILE_IMPORTS = 400;
+/** Builds `dependencies.json` (module edges, external packages, per-file imports). */
+export function buildDependenciesDocument(graph, config, options) {
+    const perFile = new Map();
+    for (const file of graph.repository.files) {
+        if (file.sensitive)
+            continue;
+        perFile.set(file.path, { module: file.moduleId, internal: new Set(), external: new Set() });
+    }
+    for (const edge of graph.fileEdges) {
+        const entry = perFile.get(edge.from);
+        if (entry === undefined)
+            continue;
+        if (edge.kind === 'internal-module') {
+            entry.internal.add(edge.to);
+            continue;
+        }
+        if (edge.kind === 'workspace-package') {
+            entry.internal.add(edge.to);
+            continue;
+        }
+        if (edge.toKind === 'file') {
+            const targetModule = graph.fileToModule.get(edge.to) ?? null;
+            if (targetModule !== null && targetModule !== entry.module)
+                entry.internal.add(targetModule);
+            continue;
+        }
+        if (edge.toKind === 'package')
+            entry.external.add(edge.to);
+    }
+    const fileImports = [...perFile.entries()]
+        .map(([file, entry]) => ({
+        file,
+        module: entry.module,
+        internalModules: uniqueSorted(entry.internal),
+        externalPackages: uniqueSorted(entry.external),
+    }))
+        .filter((entry) => entry.internalModules.length > 0 || entry.externalPackages.length > 0)
+        .sort((a, b) => compareStrings(a.file, b.file))
+        .slice(0, MAX_FILE_IMPORTS);
+    const internal = graph.moduleEdges
+        .map((edge) => ({
+        from: edge.from,
+        to: edge.to,
+        kind: (edge.kind === 'workspace-package' ? 'workspace-package' : 'internal-module'),
+        confidence: edge.confidence,
+        evidence: edge.evidence,
+    }))
+        .sort((a, b) => compareStrings(`${a.from}|${a.to}`, `${b.from}|${b.to}`));
+    const document = {
+        schemaVersion: SCHEMA_VERSION,
+        generatedBy: GENERATOR_NAME,
+        summary: {
+            internalModuleEdges: internal.length,
+            crossPackageEdges: internal.filter((edge) => edge.kind === 'workspace-package').length,
+            externalPackages: graph.externalDependencies.length,
+            unresolvedImports: graph.unresolved.length,
+            cycles: graph.cycles.length,
+        },
+        internal,
+        external: [...graph.externalDependencies].sort((a, b) => compareStrings(a.name, b.name)),
+        fileImports,
+        cycles: graph.cycles,
+        unresolved: graph.unresolved,
+    };
+    void config;
+    return withTimestamp(document, options);
+}
+/** Builds `conventions.json` and the human readable `conventions.md` projection. */
+export function buildConventionsDocuments(graph, config, options) {
+    const document = {
+        schemaVersion: SCHEMA_VERSION,
+        generatedBy: GENERATOR_NAME,
+        conventions: [...graph.repository.conventions].sort((a, b) => a.category === b.category ? compareStrings(a.statement, b.statement) : compareStrings(a.category, b.category)),
+    };
+    const timestamped = withTimestamp(document, options);
+    const markdownMeta = { repositoryName: graph.repository.name };
+    if (config.output.includeTimestamp && options.generatedAt !== undefined) {
+        markdownMeta.generatedAt = options.generatedAt;
+    }
+    return {
+        document: timestamped,
+        markdown: renderConventionsMarkdown(timestamped.conventions, markdownMeta),
+    };
+}
+/** Builds `decisions.json`. */
+export function buildDecisionsDocument(graph, options) {
+    const document = {
+        schemaVersion: SCHEMA_VERSION,
+        generatedBy: GENERATOR_NAME,
+        decisions: [...graph.repository.decisions].sort((a, b) => a.origin === b.origin ? compareStrings(a.id, b.id) : a.origin === 'explicit' ? -1 : 1),
+    };
+    return withTimestamp(document, options);
+}
+/** Builds every canonical document in one pass. */
+export function buildContextDocuments(graph, parsed, config, options) {
+    const conventions = buildConventionsDocuments(graph, config, options);
+    return {
+        index: buildIndexDocument(graph, parsed, config, options),
+        architecture: buildArchitectureDocument(graph, config, options),
+        dependencies: buildDependenciesDocument(graph, config, options),
+        conventions: conventions.document,
+        conventionsMarkdown: conventions.markdown,
+        decisions: buildDecisionsDocument(graph, options),
+    };
+}
+//# sourceMappingURL=documents.js.map

package/dist/core/serialization/documents.js.map

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

package/dist/core/serialization/reader.d.ts

@@ -0,0 +1,22 @@
+import type { ArchitectureDocument, ConventionsDocument, DecisionsDocument, DependenciesDocument, IndexDocument } from './types.ts';
+export interface PersistedContext {
+    index: IndexDocument | null;
+    architecture: ArchitectureDocument | null;
+    dependencies: DependenciesDocument | null;
+    conventions: ConventionsDocument | null;
+    decisions: DecisionsDocument | null;
+    /** Files that do not exist yet. */
+    missing: string[];
+    /** Files that exist but could not be used (invalid JSON or schema mismatch). */
+    invalid: Array<{
+        file: string;
+        reason: string;
+    }>;
+}
+/** Reads the persisted context, tolerating missing or damaged files. */
+export declare function readPersistedContext(root: string): Promise<PersistedContext>;
+/** `true` when a usable context exists (index.json with a supported schema). */
+export declare function hasUsableContext(context: PersistedContext): boolean;
+/** Names of the canonical files this tool writes. */
+export declare function contextFileNames(): readonly string[];
+//# sourceMappingURL=reader.d.ts.map

package/dist/core/serialization/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../../src/core/serialization/reader.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1C,YAAY,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1C,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,mCAAmC;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gFAAgF;IAChF,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAqCD,wEAAwE;AACxE,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CASlF;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAEnE;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,IAAI,SAAS,MAAM,EAAE,CAEpD"}

package/dist/core/serialization/reader.js

@@ -0,0 +1,65 @@
+/**
+ * Reader for previously generated `.agent/` context.
+ *
+ * Reading is tolerant: a missing or unparsable file becomes a warning, never a
+ * crash, and a schema version mismatch is reported explicitly so the CLI can tell
+ * the user to re-run `scan`.
+ */
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { AGENT_DIR, CONTEXT_FILES, SCHEMA_VERSION } from "../../model/schema.js";
+const EMPTY = {
+    index: null,
+    architecture: null,
+    dependencies: null,
+    conventions: null,
+    decisions: null,
+    missing: [],
+    invalid: [],
+};
+async function readJson(root, name, result) {
+    const target = path.join(root, AGENT_DIR, name);
+    let contents;
+    try {
+        contents = await readFile(target, 'utf8');
+    }
+    catch {
+        result.missing.push(name);
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(contents);
+        if (parsed.schemaVersion !== SCHEMA_VERSION) {
+            result.invalid.push({
+                file: name,
+                reason: `schema version ${String(parsed.schemaVersion)} is not supported (expected ${SCHEMA_VERSION})`,
+            });
+            return null;
+        }
+        return parsed;
+    }
+    catch (error) {
+        result.invalid.push({ file: name, reason: error instanceof Error ? error.message : String(error) });
+        return null;
+    }
+}
+/** Reads the persisted context, tolerating missing or damaged files. */
+export async function readPersistedContext(root) {
+    const result = { ...EMPTY, missing: [], invalid: [] };
+    result.index = await readJson(root, 'index.json', result);
+    result.architecture = await readJson(root, 'architecture.json', result);
+    result.dependencies = await readJson(root, 'dependencies.json', result);
+    result.conventions = await readJson(root, 'conventions.json', result);
+    result.decisions = await readJson(root, 'decisions.json', result);
+    result.missing.sort();
+    return result;
+}
+/** `true` when a usable context exists (index.json with a supported schema). */
+export function hasUsableContext(context) {
+    return context.index !== null;
+}
+/** Names of the canonical files this tool writes. */
+export function contextFileNames() {
+    return CONTEXT_FILES;
+}
+//# sourceMappingURL=reader.js.map

package/dist/core/serialization/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../../src/core/serialization/reader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAqBjF,MAAM,KAAK,GAAqB;IAC9B,KAAK,EAAE,IAAI;IACX,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,IAAI;IAClB,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,KAAK,UAAU,QAAQ,CAAI,IAAY,EAAE,IAAY,EAAE,MAAwB;IAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAChD,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAA+B,CAAC;QAClE,IAAI,MAAM,CAAC,aAAa,KAAK,cAAc,EAAE,CAAC;YAC5C,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;gBAClB,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,kBAAkB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,+BAA+B,cAAc,GAAG;aACvG,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,MAAW,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpG,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY;IACrD,MAAM,MAAM,GAAqB,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACxE,MAAM,CAAC,KAAK,GAAG,MAAM,QAAQ,CAAgB,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACzE,MAAM,CAAC,YAAY,GAAG,MAAM,QAAQ,CAAuB,IAAI,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAC9F,MAAM,CAAC,YAAY,GAAG,MAAM,QAAQ,CAAuB,IAAI,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAC9F,MAAM,CAAC,WAAW,GAAG,MAAM,QAAQ,CAAsB,IAAI,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;IAC3F,MAAM,CAAC,SAAS,GAAG,MAAM,QAAQ,CAAoB,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACrF,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,gBAAgB,CAAC,OAAyB;IACxD,OAAO,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC;AAChC,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/core/serialization/types.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Canonical `.agent/` documents.
+ *
+ * The documents are the *machine readable* representation of the graph: JSON with
+ * a schema version, deterministic ordering and no timestamps unless explicitly
+ * enabled. `conventions.md` is a human projection of `conventions.json`.
+ *
+ * Document shapes are versioned independently of the in-memory model, so the
+ * model can evolve while readers keep working against schema v1.
+ */
+import type { Convention, Decision, EntryPoint, ExternalDependency, GitModuleSignals, ModuleBasis, ModuleRole, Detection, DiagnosticPayload } from '../../model/types.ts';
+export interface IndexDocument {
+    schemaVersion: number;
+    generatedBy: string;
+    generatedAt?: string;
+    repository: {
+        name: string;
+        /** Repository name only: absolute paths are machine specific and not canonical. */
+        rootName: string;
+        packageManager: string;
+        workspaceModel: string;
+        isMonorepo: boolean;
+        languages: string[];
+        counts: {
+            files: number;
+            source: number;
+            tests: number;
+            config: number;
+            docs: number;
+            assets: number;
+            modules: number;
+            symbols: number;
+            dependencies: number;
+            entryPoints: number;
+            conventions: number;
+            decisions: number;
+            externalDependencies: number;
+        };
+    };
+    files: {
+        /** Hash of every analyzed file: enables `status` and `diff` without rescanning. */
+        entries: Array<{
+            path: string;
+            hash: string;
+            language: string;
+            kind: string;
+            module: string | null;
+        }>;
+        sensitiveSkipped: string[];
+    };
+    context: {
+        architecture: string;
+        dependencies: string;
+        conventions: string;
+        conventionsMarkdown: string;
+        decisions: string;
+    };
+    git: {
+        enabled: boolean;
+        windowDays: number;
+        commitsAnalyzed: number;
+    } | null;
+    diagnostics: DiagnosticPayload[];
+}
+export interface ArchitectureDocument {
+    schemaVersion: number;
+    generatedBy: string;
+    generatedAt?: string;
+    summary: {
+        modules: number;
+        workspacePackages: number;
+        entryPoints: number;
+        rolesDetected: number;
+        cycles: number;
+    };
+    workspace: {
+        packageManager: string;
+        workspaceModel: string;
+        workspaceGlobs: string[];
+        packageManagerEvidence: Array<{
+            source: string;
+            detail: string;
+        }>;
+        packages: Array<{
+            name: string;
+            path: string;
+            private: boolean;
+            version: string | null;
+            entries: number;
+        }>;
+    };
+    entryPoints: EntryPoint[];
+    modules: ArchitectureModule[];
+}
+export interface ArchitectureModule {
+    id: string;
+    path: string;
+    name: string;
+    basis: ModuleBasis;
+    packageName: string | null;
+    isWorkspacePackage: boolean;
+    /** Heuristic roles; each carries confidence and evidence. */
+    roles: Array<Detection<ModuleRole>>;
+    /** Heuristic responsibilities; each carries confidence and evidence. */
+    responsibilities: Array<Detection>;
+    entryPoints: string[];
+    dependsOn: string[];
+    usedBy: string[];
+    publicExports: Array<{
+        name: string;
+        kind: string;
+        file: string;
+    }>;
+    boundaries: string[];
+    files: number;
+    fileList: string[];
+    testFiles: string[];
+    signals: string[];
+    git: GitModuleSignals | null;
+}
+export interface DependenciesDocument {
+    schemaVersion: number;
+    generatedBy: string;
+    generatedAt?: string;
+    summary: {
+        internalModuleEdges: number;
+        crossPackageEdges: number;
+        externalPackages: number;
+        unresolvedImports: number;
+        cycles: number;
+    };
+    /** Module → module edges (the architectural dependency graph). */
+    internal: Array<{
+        from: string;
+        to: string;
+        kind: 'internal-module' | 'workspace-package';
+        confidence: number;
+        evidence: Array<{
+            source: string;
+            detail: string;
+        }>;
+    }>;
+    external: ExternalDependency[];
+    /** Per-file projection: what each file imports (module ids and package names). */
+    fileImports: Array<{
+        file: string;
+        module: string | null;
+        internalModules: string[];
+        externalPackages: string[];
+    }>;
+    cycles: string[][];
+    unresolved: Array<{
+        file: string;
+        specifier: string;
+        attempts: string[];
+    }>;
+}
+export interface ConventionsDocument {
+    schemaVersion: number;
+    generatedBy: string;
+    generatedAt?: string;
+    conventions: Convention[];
+}
+export interface DecisionsDocument {
+    schemaVersion: number;
+    generatedBy: string;
+    generatedAt?: string;
+    decisions: Decision[];
+}
+export interface ContextDocuments {
+    index: IndexDocument;
+    architecture: ArchitectureDocument;
+    dependencies: DependenciesDocument;
+    conventions: ConventionsDocument;
+    decisions: DecisionsDocument;
+    conventionsMarkdown: string;
+}
+export interface DocumentBuildOptions {
+    /** ISO timestamp; only included when `output.includeTimestamp` is enabled. */
+    generatedAt?: string;
+    diagnostics: DiagnosticPayload[];
+    commitsAnalyzed: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/serialization/types.d.ts.map

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

package/dist/core/serialization/types.js

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

package/dist/core/serialization/types.js.map

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

package/dist/core/serialization/writer.d.ts

@@ -0,0 +1,17 @@
+import type { AgentContextConfig } from '../../config/types.ts';
+import type { ContextDocuments } from './types.ts';
+export interface WriteContextResult {
+    directory: string;
+    /** File name → sha256 of the written content (used for `status`/`diff`). */
+    hashes: Record<string, string>;
+    written: string[];
+}
+/** Serializes the documents into the exact byte content of each `.agent` file. */
+export declare function serializeContextDocuments(documents: ContextDocuments, config: AgentContextConfig): Record<string, string>;
+/** Writes `.agent/` (creating it when needed) and returns content hashes. */
+export declare function writeContext(root: string, documents: ContextDocuments, config: AgentContextConfig): Promise<WriteContextResult>;
+/** Removes everything under `.agent/` that this tool generated (never source code). */
+export declare function removeContextDirectory(root: string, options: {
+    keepConfig: boolean;
+}): Promise<string[]>;
+//# sourceMappingURL=writer.d.ts.map

package/dist/core/serialization/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/core/serialization/writer.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,kFAAkF;AAClF,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,kBAAkB,GACzB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AAED,6EAA6E;AAC7E,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAqB7B;AAED,uFAAuF;AACvF,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,UAAU,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgB9G"}

package/dist/core/serialization/writer.js

@@ -0,0 +1,64 @@
+/**
+ * Deterministic writer for the `.agent/` context.
+ *
+ * Everything written here is meant to be committed: canonical JSON with sorted
+ * keys, a `.gitignore` that keeps the local cache out of version control, and no
+ * timestamps unless the user asks for them.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { AGENT_DIR, AGENT_GITIGNORE, CONTEXT_FILES } from "../../model/schema.js";
+import { sha256, stringifyCanonical } from "../../model/canonical.js";
+/** Serializes the documents into the exact byte content of each `.agent` file. */
+export function serializeContextDocuments(documents, config) {
+    const output = {
+        'index.json': stringifyCanonical(documents.index, config.output.prettyJson),
+        'architecture.json': stringifyCanonical(documents.architecture, config.output.prettyJson),
+        'dependencies.json': stringifyCanonical(documents.dependencies, config.output.prettyJson),
+        'conventions.json': stringifyCanonical(documents.conventions, config.output.prettyJson),
+        'decisions.json': stringifyCanonical(documents.decisions, config.output.prettyJson),
+    };
+    if (config.output.conventionsMarkdown)
+        output['conventions.md'] = documents.conventionsMarkdown;
+    return output;
+}
+/** Writes `.agent/` (creating it when needed) and returns content hashes. */
+export async function writeContext(root, documents, config) {
+    const directory = path.join(root, AGENT_DIR);
+    await mkdir(path.join(directory, '.local'), { recursive: true });
+    const contents = serializeContextDocuments(documents, config);
+    const hashes = {};
+    const written = [];
+    for (const name of CONTEXT_FILES) {
+        const content = contents[name];
+        if (content === undefined)
+            continue;
+        await writeFile(path.join(directory, name), content, 'utf8');
+        hashes[name] = sha256(content);
+        written.push(name);
+    }
+    const gitignorePath = path.join(directory, '.gitignore');
+    await writeFile(gitignorePath, AGENT_GITIGNORE, 'utf8');
+    hashes['.gitignore'] = sha256(AGENT_GITIGNORE);
+    written.push('.gitignore');
+    return { directory, hashes, written: written.sort() };
+}
+/** Removes everything under `.agent/` that this tool generated (never source code). */
+export async function removeContextDirectory(root, options) {
+    const { rm } = await import('node:fs/promises');
+    const directory = path.join(root, AGENT_DIR);
+    const removed = [];
+    const generated = [...CONTEXT_FILES, '.gitignore'];
+    for (const name of generated) {
+        await rm(path.join(directory, name), { force: true });
+        removed.push(name);
+    }
+    await rm(path.join(directory, '.local'), { recursive: true, force: true });
+    removed.push('.local/');
+    if (!options.keepConfig) {
+        await rm(path.join(directory, 'config.json'), { force: true });
+        removed.push('config.json');
+    }
+    return removed.sort();
+}
+//# sourceMappingURL=writer.js.map

package/dist/core/serialization/writer.js.map

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

package/dist/core/workspace/package-facts.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Reconstruction of package facts from the parsed metadata of `package.json`.
+ *
+ * The scanner keeps only the language-agnostic IR, so the workspace layer rebuilds
+ * the facts it needs from that metadata. This keeps a single source of truth and
+ * makes the cache round-trip lossless for analysis purposes.
+ */
+import type { ParsedFile } from '../../adapters/language/types.ts';
+import type { PackageFacts } from '../../adapters/language/package-json/adapter.ts';
+/** Reads {@link PackageFacts} back from a parsed `package.json` file. */
+export declare function packageFactsFromParsed(parsed: ParsedFile): PackageFacts | null;
+//# sourceMappingURL=package-facts.d.ts.map

package/dist/core/workspace/package-facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-facts.d.ts","sourceRoot":"","sources":["../../../src/core/workspace/package-facts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAqB,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAevG,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI,CAiC9E"}