@ai-agent-context/core 0.1.0

package/dist/logging/diagnostics.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Diagnostics and logging.
+ *
+ * A single unparsable file produces a warning and analysis continues; only
+ * repository-level problems raise {@link AgentContextError}. Both surfaces are
+ * collected in a {@link DiagnosticsCollector} that the CLI can print (verbose
+ * mode) or serialize (`--json`).
+ */
+import type { DiagnosticPayload } from '../model/types.ts';
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'verbose';
+export type LogSink = (line: string) => void;
+export interface LoggerOptions {
+    level?: LogLevel;
+    sink?: LogSink;
+}
+/** Structured progress logger; writes to a sink so the CLI owns the formatting. */
+export declare class Logger {
+    private readonly level;
+    private readonly sink;
+    constructor(options?: LoggerOptions);
+    get currentLevel(): LogLevel;
+    enabled(level: Exclude<LogLevel, 'silent'>): boolean;
+    log(level: Exclude<LogLevel, 'silent'>, message: string): void;
+    error(message: string): void;
+    warn(message: string): void;
+    info(message: string): void;
+    verbose(message: string): void;
+}
+export declare const silentLogger: Logger;
+export interface DiagnosticsCollectorOptions {
+    logger?: Logger;
+}
+/** Collects warnings/errors produced during analysis. */
+export declare class DiagnosticsCollector {
+    private readonly items;
+    private readonly logger;
+    constructor(options?: DiagnosticsCollectorOptions);
+    add(payload: DiagnosticPayload): void;
+    warn(code: string, message: string, options?: {
+        source?: string;
+        hint?: string;
+    }): void;
+    info(code: string, message: string, options?: {
+        source?: string;
+        hint?: string;
+    }): void;
+    error(code: string, message: string, options?: {
+        source?: string;
+        hint?: string;
+    }): void;
+    /** Deterministically ordered diagnostics. */
+    list(): DiagnosticPayload[];
+    warnings(): DiagnosticPayload[];
+    errors(): DiagnosticPayload[];
+    get count(): number;
+}
+export interface ProgressEvent {
+    phase: string;
+    message: string;
+    completed?: number;
+    total?: number;
+}
+export type ProgressReporter = (event: ProgressEvent) => void;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/logging/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/logging/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAIxE,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,mFAAmF;AACnF,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;gBAEnB,OAAO,GAAE,aAAkB;IAKvC,IAAI,YAAY,IAAI,QAAQ,CAE3B;IAED,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,OAAO;IAIpD,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9D,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG/B;AAED,eAAO,MAAM,YAAY,QAAkC,CAAC;AAE5D,MAAM,WAAW,2BAA2B;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,GAAE,2BAAgC;IAIrD,GAAG,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAOrC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAO3F,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAO3F,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAO5F,6CAA6C;IAC7C,IAAI,IAAI,iBAAiB,EAAE;IAS3B,QAAQ,IAAI,iBAAiB,EAAE;IAI/B,MAAM,IAAI,iBAAiB,EAAE;IAI7B,IAAI,KAAK,IAAI,MAAM,CAElB;CACF;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC"}

package/dist/logging/diagnostics.js

@@ -0,0 +1,92 @@
+import { compareStrings } from "../model/canonical.js";
+const LEVEL_ORDER = { silent: 0, error: 1, warn: 2, info: 3, verbose: 4 };
+/** Structured progress logger; writes to a sink so the CLI owns the formatting. */
+export class Logger {
+    level;
+    sink;
+    constructor(options = {}) {
+        this.level = options.level ?? 'info';
+        this.sink = options.sink ?? ((line) => process.stderr.write(`${line}\n`));
+    }
+    get currentLevel() {
+        return this.level;
+    }
+    enabled(level) {
+        return LEVEL_ORDER[this.level] >= LEVEL_ORDER[level];
+    }
+    log(level, message) {
+        if (!this.enabled(level))
+            return;
+        this.sink(message);
+    }
+    error(message) {
+        this.log('error', message);
+    }
+    warn(message) {
+        this.log('warn', `warning: ${message}`);
+    }
+    info(message) {
+        this.log('info', message);
+    }
+    verbose(message) {
+        this.log('verbose', `debug: ${message}`);
+    }
+}
+export const silentLogger = new Logger({ level: 'silent' });
+/** Collects warnings/errors produced during analysis. */
+export class DiagnosticsCollector {
+    items = [];
+    logger;
+    constructor(options = {}) {
+        this.logger = options.logger ?? silentLogger;
+    }
+    add(payload) {
+        this.items.push(payload);
+        if (payload.severity === 'error')
+            this.logger.error(payload.message);
+        else if (payload.severity === 'warning')
+            this.logger.warn(payload.message);
+        else
+            this.logger.verbose(payload.message);
+    }
+    warn(code, message, options = {}) {
+        const payload = { code, severity: 'warning', message };
+        if (options.source !== undefined)
+            payload.source = options.source;
+        if (options.hint !== undefined)
+            payload.hint = options.hint;
+        this.add(payload);
+    }
+    info(code, message, options = {}) {
+        const payload = { code, severity: 'info', message };
+        if (options.source !== undefined)
+            payload.source = options.source;
+        if (options.hint !== undefined)
+            payload.hint = options.hint;
+        this.add(payload);
+    }
+    error(code, message, options = {}) {
+        const payload = { code, severity: 'error', message };
+        if (options.source !== undefined)
+            payload.source = options.source;
+        if (options.hint !== undefined)
+            payload.hint = options.hint;
+        this.add(payload);
+    }
+    /** Deterministically ordered diagnostics. */
+    list() {
+        return [...this.items].sort((a, b) => compareStrings(a.code, b.code) ||
+            compareStrings(a.source ?? '', b.source ?? '') ||
+            compareStrings(a.message, b.message));
+    }
+    warnings() {
+        return this.list().filter((item) => item.severity === 'warning');
+    }
+    errors() {
+        return this.list().filter((item) => item.severity === 'error');
+    }
+    get count() {
+        return this.items.length;
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/logging/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/logging/diagnostics.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD,MAAM,WAAW,GAA6B,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AASpG,mFAAmF;AACnF,MAAM,OAAO,MAAM;IACA,KAAK,CAAW;IAChB,IAAI,CAAU;IAE/B,YAAY,UAAyB,EAAE;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,OAAO,CAAC,KAAkC;QACxC,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,GAAG,CAAC,KAAkC,EAAE,OAAe;QACrD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO;QACjC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,OAAe;QACnB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,CAAC,OAAe;QACrB,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAM5D,yDAAyD;AACzD,MAAM,OAAO,oBAAoB;IACd,KAAK,GAAwB,EAAE,CAAC;IAChC,MAAM,CAAS;IAEhC,YAAY,UAAuC,EAAE;QACnD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,YAAY,CAAC;IAC/C,CAAC;IAED,GAAG,CAAC,OAA0B;QAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;aAChE,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;;YACtE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,OAAe,EAAE,UAA8C,EAAE;QAClF,MAAM,OAAO,GAAsB,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;QAC1E,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAClE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC5D,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,OAAe,EAAE,UAA8C,EAAE;QAClF,MAAM,OAAO,GAAsB,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACvE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAClE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC5D,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,IAAY,EAAE,OAAe,EAAE,UAA8C,EAAE;QACnF,MAAM,OAAO,GAAsB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QACxE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAClE,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC5D,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC;IAED,6CAA6C;IAC7C,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;YAC9B,cAAc,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;YAC9C,cAAc,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CACvC,CAAC;IACJ,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IACnE,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;CACF"}

package/dist/model/canonical.d.ts

@@ -0,0 +1,24 @@
+export declare function sha256(input: string | Buffer): string;
+/** Short, stable content hash used for cache sharding and edge ids. */
+export declare function shortHash(input: string, length?: number): string;
+/**
+ * Recursively sorts object keys so that `JSON.stringify` output does not depend
+ * on property insertion order.
+ */
+export declare function canonicalize<T>(value: T): T;
+/** Canonical JSON with two-space indentation and a trailing newline. */
+export declare function stringifyCanonical(value: unknown, pretty?: boolean): string;
+/** Locale-independent, code-unit based string comparison. */
+export declare function compareStrings(a: string, b: string): number;
+/** Stable, order-insensitive hash of an arbitrary value. */
+export declare function hashValue(value: unknown): string;
+/** Sorts a copy of the array by a derived string key. */
+export declare function sortBy<T>(items: readonly T[], key: (item: T) => string): T[];
+/** Deduplicates strings and sorts them. */
+export declare function uniqueSorted(values: Iterable<string>): string[];
+/**
+ * Rounds confidence to two decimals and clamps it into `[0, 0.99]`, so that a
+ * heuristic result can never masquerade as an absolute fact.
+ */
+export declare function clampConfidence(value: number): number;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/model/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../../src/model/canonical.ts"],"names":[],"mappings":"AAUA,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAErD;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,MAAM,CAE5D;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAe3C;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,UAAO,GAAG,MAAM,CAGxE;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED,yDAAyD;AACzD,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,CAAC,EAAE,CAE5E;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAE/D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/dist/model/canonical.js

@@ -0,0 +1,69 @@
+/**
+ * Deterministic serialization helpers.
+ *
+ * A context file must be byte-identical for an identical repository state, so
+ * every persisted value goes through {@link canonicalize} (recursively sorted
+ * object keys) and {@link stringifyCanonical} (stable formatting). Arrays keep
+ * the order assigned by the builders, which sort their output explicitly.
+ */
+import { createHash } from 'node:crypto';
+export function sha256(input) {
+    return createHash('sha256').update(input).digest('hex');
+}
+/** Short, stable content hash used for cache sharding and edge ids. */
+export function shortHash(input, length = 16) {
+    return sha256(input).slice(0, length);
+}
+/**
+ * Recursively sorts object keys so that `JSON.stringify` output does not depend
+ * on property insertion order.
+ */
+export function canonicalize(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => canonicalize(entry));
+    }
+    if (value !== null && typeof value === 'object') {
+        const source = value;
+        const result = {};
+        for (const key of Object.keys(source).sort(compareStrings)) {
+            const entry = source[key];
+            if (entry === undefined)
+                continue;
+            result[key] = canonicalize(entry);
+        }
+        return result;
+    }
+    return value;
+}
+/** Canonical JSON with two-space indentation and a trailing newline. */
+export function stringifyCanonical(value, pretty = true) {
+    const canonical = canonicalize(value);
+    return `${pretty ? JSON.stringify(canonical, null, 2) : JSON.stringify(canonical)}\n`;
+}
+/** Locale-independent, code-unit based string comparison. */
+export function compareStrings(a, b) {
+    if (a === b)
+        return 0;
+    return a < b ? -1 : 1;
+}
+/** Stable, order-insensitive hash of an arbitrary value. */
+export function hashValue(value) {
+    return sha256(stringifyCanonical(value, false));
+}
+/** Sorts a copy of the array by a derived string key. */
+export function sortBy(items, key) {
+    return [...items].sort((a, b) => compareStrings(key(a), key(b)));
+}
+/** Deduplicates strings and sorts them. */
+export function uniqueSorted(values) {
+    return [...new Set(values)].sort(compareStrings);
+}
+/**
+ * Rounds confidence to two decimals and clamps it into `[0, 0.99]`, so that a
+ * heuristic result can never masquerade as an absolute fact.
+ */
+export function clampConfidence(value) {
+    const clamped = Math.max(0, Math.min(0.99, value));
+    return Math.round(clamped * 100) / 100;
+}
+//# sourceMappingURL=canonical.js.map

package/dist/model/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../../src/model/canonical.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,MAAM,CAAC,KAAsB;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,MAAM,GAAG,EAAE;IAClD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAID;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAI,KAAQ;IACtC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAiB,CAAC;IACnE,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,MAAsB,CAAC;IAChC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,MAAM,GAAG,IAAI;IAC9D,MAAM,SAAS,GAAG,YAAY,CAAC,KAAkB,CAAC,CAAC;IACnD,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC;AACxF,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,CAAS,EAAE,CAAS;IACjD,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,MAAM,CAAI,KAAmB,EAAE,GAAwB;IACrE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,YAAY,CAAC,MAAwB;IACnD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACzC,CAAC"}

package/dist/model/schema.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Schema constants for the versioned `.agent/` context format.
+ *
+ * The format is explicit about its version so that consumers (CLI, MCP adapters,
+ * agents, humans reading the JSON) can detect incompatible layouts.
+ */
+/** Current schema version of every file written into `.agent/`. */
+export declare const SCHEMA_VERSION = 1;
+export declare const GENERATOR_NAME = "ai-agent-context";
+/** Directory that stores the versioned, committable context. */
+export declare const AGENT_DIR = ".agent";
+/** Directory inside `.agent/` that stores local (gitignored) state and caches. */
+export declare const LOCAL_DIR = ".local";
+/** Config file path, relative to the repository root. */
+export declare const CONFIG_FILE = ".agent/config.json";
+export declare const CACHE_DIR = ".agent/.local/cache";
+export declare const STATE_FILE = ".agent/.local/state.json";
+/** Canonical generated context files. Order is the documented output order. */
+export declare const CONTEXT_FILES: readonly ["index.json", "architecture.json", "dependencies.json", "conventions.json", "conventions.md", "decisions.json"];
+export type ContextFile = (typeof CONTEXT_FILES)[number];
+/** Content written into `.agent/.gitignore` so the local cache is never committed. */
+export declare const AGENT_GITIGNORE = "# Local, machine-specific state and caches (never committed).\n.local/\n";
+/** Confidence values reported when a signal is conclusive. */
+export declare const CONFIDENCE: {
+    /** Structural facts from configuration files, e.g. package.json `main`. */
+    readonly declared: 0.99;
+    /** Direct observation across many files, e.g. all classes are PascalCase. */
+    readonly strong: 0.88;
+    /** Multiple independent signals agree. */
+    readonly medium: 0.72;
+    /** A single, weaker signal. */
+    readonly weak: 0.52;
+    /** Mentioned only for completeness; needs human verification. */
+    readonly speculative: 0.3;
+};
+export type ConfidenceLevel = keyof typeof CONFIDENCE;
+//# sourceMappingURL=schema.d.ts.map

package/dist/model/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/model/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mEAAmE;AACnE,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAEjD,gEAAgE;AAChE,eAAO,MAAM,SAAS,WAAW,CAAC;AAElC,kFAAkF;AAClF,eAAO,MAAM,SAAS,WAAW,CAAC;AAElC,yDAAyD;AACzD,eAAO,MAAM,WAAW,uBAA6B,CAAC;AAEtD,eAAO,MAAM,SAAS,wBAAoC,CAAC;AAE3D,eAAO,MAAM,UAAU,6BAAyC,CAAC;AAEjE,+EAA+E;AAC/E,eAAO,MAAM,aAAa,2HAOhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,sFAAsF;AACtF,eAAO,MAAM,eAAe,6EAA6E,CAAC;AAE1G,8DAA8D;AAC9D,eAAO,MAAM,UAAU;IACrB,2EAA2E;;IAE3E,6EAA6E;;IAE7E,0CAA0C;;IAE1C,+BAA+B;;IAE/B,iEAAiE;;CAEzD,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,UAAU,CAAC"}

package/dist/model/schema.js

@@ -0,0 +1,42 @@
+/**
+ * Schema constants for the versioned `.agent/` context format.
+ *
+ * The format is explicit about its version so that consumers (CLI, MCP adapters,
+ * agents, humans reading the JSON) can detect incompatible layouts.
+ */
+/** Current schema version of every file written into `.agent/`. */
+export const SCHEMA_VERSION = 1;
+export const GENERATOR_NAME = 'ai-agent-context';
+/** Directory that stores the versioned, committable context. */
+export const AGENT_DIR = '.agent';
+/** Directory inside `.agent/` that stores local (gitignored) state and caches. */
+export const LOCAL_DIR = '.local';
+/** Config file path, relative to the repository root. */
+export const CONFIG_FILE = `${AGENT_DIR}/config.json`;
+export const CACHE_DIR = `${AGENT_DIR}/${LOCAL_DIR}/cache`;
+export const STATE_FILE = `${AGENT_DIR}/${LOCAL_DIR}/state.json`;
+/** Canonical generated context files. Order is the documented output order. */
+export const CONTEXT_FILES = [
+    'index.json',
+    'architecture.json',
+    'dependencies.json',
+    'conventions.json',
+    'conventions.md',
+    'decisions.json',
+];
+/** Content written into `.agent/.gitignore` so the local cache is never committed. */
+export const AGENT_GITIGNORE = `# Local, machine-specific state and caches (never committed).\n.local/\n`;
+/** Confidence values reported when a signal is conclusive. */
+export const CONFIDENCE = {
+    /** Structural facts from configuration files, e.g. package.json `main`. */
+    declared: 0.99,
+    /** Direct observation across many files, e.g. all classes are PascalCase. */
+    strong: 0.88,
+    /** Multiple independent signals agree. */
+    medium: 0.72,
+    /** A single, weaker signal. */
+    weak: 0.52,
+    /** Mentioned only for completeness; needs human verification. */
+    speculative: 0.3,
+};
+//# sourceMappingURL=schema.js.map

package/dist/model/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/model/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mEAAmE;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAEjD,gEAAgE;AAChE,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAElC,kFAAkF;AAClF,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAElC,yDAAyD;AACzD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,SAAS,cAAc,CAAC;AAEtD,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,SAAS,IAAI,SAAS,QAAQ,CAAC;AAE3D,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,SAAS,IAAI,SAAS,aAAa,CAAC;AAEjE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,YAAY;IACZ,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,gBAAgB;IAChB,gBAAgB;CACR,CAAC;AAIX,sFAAsF;AACtF,MAAM,CAAC,MAAM,eAAe,GAAG,0EAA0E,CAAC;AAE1G,8DAA8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,2EAA2E;IAC3E,QAAQ,EAAE,IAAI;IACd,6EAA6E;IAC7E,MAAM,EAAE,IAAI;IACZ,0CAA0C;IAC1C,MAAM,EAAE,IAAI;IACZ,+BAA+B;IAC/B,IAAI,EAAE,IAAI;IACV,iEAAiE;IACjE,WAAW,EAAE,GAAG;CACR,CAAC"}