@ai-agent-context/core 0.1.0

package/dist/adapters/language/ts-js/package-signals.js

@@ -0,0 +1,113 @@
+/**
+ * Package-name → signal mapping.
+ *
+ * Signals are coarse, deterministic, structural observations ("this file imports
+ * a database client"), not conclusions. Architecture detection combines them
+ * with file names, paths and dependency shape, and always reports confidence.
+ */
+import { SIGNALS } from "../types.js";
+const RULES = [
+    { match: '@prisma/client', signal: SIGNALS.dbAccess },
+    { match: 'prisma', signal: SIGNALS.dbAccess },
+    { match: 'pg', signal: SIGNALS.dbAccess },
+    { match: 'mysql', signal: SIGNALS.dbAccess },
+    { match: 'mysql2', signal: SIGNALS.dbAccess },
+    { match: 'mongoose', signal: SIGNALS.dbAccess },
+    { match: 'mongodb', signal: SIGNALS.dbAccess },
+    { match: 'typeorm', signal: SIGNALS.dbAccess },
+    { match: 'knex', signal: SIGNALS.dbAccess },
+    { match: 'drizzle-orm', signal: SIGNALS.dbAccess },
+    { match: 'sequelize', signal: SIGNALS.dbAccess },
+    { match: 'better-sqlite3', signal: SIGNALS.dbAccess },
+    { match: 'ioredis', signal: SIGNALS.dbAccess },
+    { match: 'redis', signal: SIGNALS.dbAccess },
+    { match: 'express', signal: SIGNALS.httpFramework },
+    { match: 'fastify', signal: SIGNALS.httpFramework },
+    { match: 'koa', signal: SIGNALS.httpFramework },
+    { match: 'hono', signal: SIGNALS.httpFramework },
+    { match: '@nestjs/*', signal: SIGNALS.httpFramework },
+    { match: 'react', signal: SIGNALS.uiFramework },
+    { match: 'react-dom', signal: SIGNALS.uiFramework },
+    { match: 'vue', signal: SIGNALS.uiFramework },
+    { match: 'svelte', signal: SIGNALS.uiFramework },
+    { match: 'next', signal: SIGNALS.uiFramework },
+    { match: 'solid-js', signal: SIGNALS.uiFramework },
+    { match: '@angular/*', signal: SIGNALS.uiFramework },
+    { match: 'axios', signal: SIGNALS.httpClient },
+    { match: 'node-fetch', signal: SIGNALS.httpClient },
+    { match: 'undici', signal: SIGNALS.httpClient },
+    { match: 'graphql', signal: SIGNALS.graphql },
+    { match: '@apollo/*', signal: SIGNALS.graphql },
+    { match: 'zod', signal: SIGNALS.validation },
+    { match: 'yup', signal: SIGNALS.validation },
+    { match: 'joi', signal: SIGNALS.validation },
+    { match: 'ajv', signal: SIGNALS.validation },
+    { match: 'class-validator', signal: SIGNALS.validation },
+    { match: 'stripe', signal: SIGNALS.externalSdk },
+    { match: 'twilio', signal: SIGNALS.externalSdk },
+    { match: '@sendgrid/*', signal: SIGNALS.externalSdk },
+    { match: 'openai', signal: SIGNALS.externalSdk },
+    { match: '@anthropic-ai/*', signal: SIGNALS.externalSdk },
+    { match: '@aws-sdk/*', signal: SIGNALS.externalSdk },
+    { match: 'bull', signal: SIGNALS.queue },
+    { match: 'bullmq', signal: SIGNALS.queue },
+    { match: 'kafkajs', signal: SIGNALS.queue },
+    { match: 'amqplib', signal: SIGNALS.queue },
+    { match: 'nats', signal: SIGNALS.queue },
+    { match: 'worker_threads', signal: SIGNALS.worker },
+    { match: 'node:worker_threads', signal: SIGNALS.worker },
+    { match: 'vitest', signal: SIGNALS.testFramework },
+    { match: 'jest', signal: SIGNALS.testFramework },
+    { match: 'mocha', signal: SIGNALS.testFramework },
+    { match: 'ava', signal: SIGNALS.testFramework },
+    { match: '@playwright/test', signal: SIGNALS.testFramework },
+    { match: 'cypress', signal: SIGNALS.testFramework },
+    { match: 'dotenv', signal: SIGNALS.configLibrary },
+    { match: 'convict', signal: SIGNALS.configLibrary },
+    { match: 'winston', signal: SIGNALS.loggingLibrary },
+    { match: 'pino', signal: SIGNALS.loggingLibrary },
+    { match: 'log4js', signal: SIGNALS.loggingLibrary },
+    { match: 'bunyan', signal: SIGNALS.loggingLibrary },
+    { match: 'commander', signal: SIGNALS.cliFramework },
+    { match: 'yargs', signal: SIGNALS.cliFramework },
+    { match: 'cac', signal: SIGNALS.cliFramework },
+    { match: 'meow', signal: SIGNALS.cliFramework },
+    { match: '@oclif/*', signal: SIGNALS.cliFramework },
+];
+/** Extracts the package name from an import specifier (`@scope/pkg/sub` → `@scope/pkg`). */
+export function packageNameFromSpecifier(specifier) {
+    if (specifier.startsWith('.') || specifier.startsWith('/') || specifier.length === 0)
+        return null;
+    const parts = specifier.split('/');
+    if (specifier.startsWith('@')) {
+        if (parts.length < 2)
+            return null;
+        return `${parts[0]}/${parts[1]}`;
+    }
+    return parts[0] ?? null;
+}
+/** Signals implied by importing `specifier`. */
+export function signalsForSpecifier(specifier) {
+    const packageName = packageNameFromSpecifier(specifier);
+    if (packageName === null)
+        return [];
+    const signals = [];
+    if (specifier.startsWith('node:') || packageName.startsWith('node:')) {
+        const bare = specifier.replace(/^node:/, '');
+        if (bare === 'worker_threads')
+            signals.push(SIGNALS.worker);
+        return signals;
+    }
+    for (const rule of RULES) {
+        if (rule.match.endsWith('/*')) {
+            const prefix = rule.match.slice(0, -1);
+            if (packageName.startsWith(prefix))
+                signals.push(rule.signal);
+            continue;
+        }
+        if (packageName === rule.match)
+            signals.push(rule.signal);
+    }
+    return signals;
+}
+//# sourceMappingURL=package-signals.js.map

package/dist/adapters/language/ts-js/package-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-signals.js","sourceRoot":"","sources":["../../../../src/adapters/language/ts-js/package-signals.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAQtC,MAAM,KAAK,GAAiB;IAC1B,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IACrD,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC7C,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IACzC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC5C,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC7C,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC/C,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC9C,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC9C,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC3C,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IAClD,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IAChD,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IACrD,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC9C,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC5C,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IACnD,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IACnD,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IAC/C,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IAChD,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IACrD,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IAC/C,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IACnD,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IAC7C,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IAChD,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IAC9C,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IAClD,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IACpD,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE;IAC9C,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE;IACnD,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE;IAC/C,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE;IAC7C,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE;IAC/C,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE;IAC5C,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE;IAC5C,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE;IAC5C,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE;IAC5C,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE;IACxD,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IAChD,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IAChD,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IACrD,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IAChD,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IACzD,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE;IACpD,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE;IACxC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE;IAC1C,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE;IAC3C,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE;IAC3C,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE;IACxC,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;IACnD,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;IACxD,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IAClD,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IAChD,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IACjD,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IAC/C,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IAC5D,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IACnD,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IAClD,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,aAAa,EAAE;IACnD,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE;IACpD,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE;IACjD,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE;IACnD,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,cAAc,EAAE;IACnD,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE;IACpD,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE;IAChD,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE;IAC9C,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE;IAC/C,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE;CACpD,CAAC;AAEF,4FAA4F;AAC5F,MAAM,UAAU,wBAAwB,CAAC,SAAiB;IACxD,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClG,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC1B,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,MAAM,WAAW,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC7C,IAAI,IAAI,KAAK,gBAAgB;YAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5D,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9D,SAAS;QACX,CAAC;QACD,IAAI,WAAW,KAAK,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/adapters/language/tsconfig/adapter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `tsconfig.json` adapter.
+ *
+ * tsconfig files are JSON with comments and trailing commas, so they are parsed
+ * with a small tolerant pre-processor. Only the facts the analysis needs are
+ * extracted: module format hints, path aliases (`baseUrl` + `paths`), strictness
+ * and the `extends` chain, which the alias resolver follows separately.
+ */
+import { type FileDescriptor, type LanguageAdapter, type ParsedFile } from '../types.ts';
+/** Removes comments and trailing commas so that `JSON.parse` accepts the file. */
+export declare function relaxJson(contents: string): string;
+export interface TsConfigFacts {
+    extendsChain: string[];
+    baseUrl: string | null;
+    paths: Record<string, string[]>;
+    strict: boolean;
+    moduleResolution: string | null;
+    module: string | null;
+    target: string | null;
+    jsx: string | null;
+    composite: boolean;
+    declaration: boolean;
+}
+/** Reads the facts the analysis needs from a parsed tsconfig document. */
+export declare function readTsConfigFacts(raw: Record<string, unknown>): TsConfigFacts;
+export declare class TsConfigAdapter implements LanguageAdapter {
+    readonly id = "tsconfig";
+    readonly displayName = "TypeScript configuration";
+    readonly languageIds: readonly string[];
+    readonly alwaysEnabled = true;
+    handles(file: FileDescriptor): boolean;
+    parse(input: {
+        path: string;
+        language: string;
+        contents: string;
+    }): ParsedFile;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapters/language/tsconfig/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/language/tsconfig/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAoB,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAK3G,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqClD;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,CA6B7E;AAED,qBAAa,eAAgB,YAAW,eAAe;IACrD,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,WAAW,8BAA8B;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAA0B;IACjE,QAAQ,CAAC,aAAa,QAAQ;IAE9B,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAItC,KAAK,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU;CAmC/E"}

package/dist/adapters/language/tsconfig/adapter.js

@@ -0,0 +1,130 @@
+/**
+ * `tsconfig.json` adapter.
+ *
+ * tsconfig files are JSON with comments and trailing commas, so they are parsed
+ * with a small tolerant pre-processor. Only the facts the analysis needs are
+ * extracted: module format hints, path aliases (`baseUrl` + `paths`), strictness
+ * and the `extends` chain, which the alias resolver follows separately.
+ */
+import { createParsedFile } from "../types.js";
+import { isPlainObject } from "../json/adapter.js";
+const TSCONFIG_NAMES = new Set(['tsconfig.json', 'tsconfig.base.json', 'jsconfig.json', 'tsconfig.build.json']);
+/** Removes comments and trailing commas so that `JSON.parse` accepts the file. */
+export function relaxJson(contents) {
+    let output = '';
+    let index = 0;
+    let inString = false;
+    while (index < contents.length) {
+        const character = contents[index];
+        if (inString) {
+            output += character;
+            if (character === '\\') {
+                output += contents[index + 1] ?? '';
+                index += 2;
+                continue;
+            }
+            if (character === '"')
+                inString = false;
+            index += 1;
+            continue;
+        }
+        if (character === '"') {
+            inString = true;
+            output += character;
+            index += 1;
+            continue;
+        }
+        if (character === '/' && contents[index + 1] === '/') {
+            while (index < contents.length && contents[index] !== '\n')
+                index += 1;
+            continue;
+        }
+        if (character === '/' && contents[index + 1] === '*') {
+            index += 2;
+            while (index < contents.length && !(contents[index] === '*' && contents[index + 1] === '/'))
+                index += 1;
+            index += 2;
+            continue;
+        }
+        output += character;
+        index += 1;
+    }
+    return output.replace(/,(\s*[}\]])/g, '$1');
+}
+/** Reads the facts the analysis needs from a parsed tsconfig document. */
+export function readTsConfigFacts(raw) {
+    const extendsValue = raw.extends;
+    const extendsChain = typeof extendsValue === 'string'
+        ? [extendsValue]
+        : Array.isArray(extendsValue)
+            ? extendsValue.filter((entry) => typeof entry === 'string')
+            : [];
+    const compilerOptions = isPlainObject(raw.compilerOptions) ? raw.compilerOptions : {};
+    const rawPaths = isPlainObject(compilerOptions.paths) ? compilerOptions.paths : {};
+    const paths = {};
+    for (const key of Object.keys(rawPaths).sort()) {
+        const value = rawPaths[key];
+        if (Array.isArray(value)) {
+            paths[key] = value.filter((entry) => typeof entry === 'string');
+        }
+    }
+    return {
+        extendsChain,
+        baseUrl: typeof compilerOptions.baseUrl === 'string' ? compilerOptions.baseUrl : null,
+        paths,
+        strict: compilerOptions.strict === true,
+        moduleResolution: typeof compilerOptions.moduleResolution === 'string' ? compilerOptions.moduleResolution : null,
+        module: typeof compilerOptions.module === 'string' ? compilerOptions.module : null,
+        target: typeof compilerOptions.target === 'string' ? compilerOptions.target : null,
+        jsx: typeof compilerOptions.jsx === 'string' ? compilerOptions.jsx : null,
+        composite: compilerOptions.composite === true,
+        declaration: compilerOptions.declaration === true,
+    };
+}
+export class TsConfigAdapter {
+    id = 'tsconfig';
+    displayName = 'TypeScript configuration';
+    languageIds = ['typescript', 'json'];
+    alwaysEnabled = true;
+    handles(file) {
+        return TSCONFIG_NAMES.has(file.basename);
+    }
+    parse(input) {
+        try {
+            const parsed = JSON.parse(relaxJson(input.contents));
+            if (!isPlainObject(parsed))
+                throw new Error('tsconfig must contain a JSON object');
+            const facts = readTsConfigFacts(parsed);
+            return createParsedFile(input.path, 'tsconfig', {
+                metadata: {
+                    'tsconfig.extends': facts.extendsChain,
+                    'tsconfig.baseUrl': facts.baseUrl,
+                    'tsconfig.paths': facts.paths,
+                    'tsconfig.strict': facts.strict,
+                    'tsconfig.moduleResolution': facts.moduleResolution,
+                    'tsconfig.module': facts.module,
+                    'tsconfig.target': facts.target,
+                    'tsconfig.jsx': facts.jsx,
+                    'tsconfig.composite': facts.composite,
+                    'tsconfig.declaration': facts.declaration,
+                },
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return createParsedFile(input.path, 'tsconfig', {
+                parseStatus: 'failed',
+                diagnostics: [
+                    {
+                        code: 'WARN_TSCONFIG_INVALID',
+                        severity: 'warning',
+                        message: 'TypeScript project detected but tsconfig.json is invalid.',
+                        source: input.path,
+                        hint: `${message}. Run: agent-context status`,
+                    },
+                ],
+            });
+        }
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapters/language/tsconfig/adapter.js.map

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

package/dist/adapters/language/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Language adapter contract.
+ *
+ * The core analysis pipeline never sees a language specific AST. Every adapter
+ * (TypeScript/JavaScript today; Python, Go, Rust, Java, C# later) reduces a file
+ * to the same language-agnostic intermediate representation declared here:
+ * imports, exports, symbols, calls, coarse signals and free-form metadata.
+ *
+ * Adding a language therefore means writing one adapter and registering it in
+ * the {@link LanguageRegistry} — no change to the graph, architecture or
+ * serialization layers.
+ */
+import type { DiagnosticPayload, ImportSyntax, ParseStatus, SymbolKind } from '../../model/types.ts';
+export interface ImportRecord {
+    /** Specifier exactly as written in the source. */
+    specifier: string;
+    syntax: ImportSyntax;
+    /** Named imports, without the local alias (`{ a as b }` adds `a`). */
+    names: string[];
+    /** Default import binding, when present. */
+    defaultImport?: string;
+    /** Namespace import binding (`* as ns`), when present. */
+    namespaceImport?: string;
+    /** 1-based line of the import statement. */
+    line: number;
+    /** `true` for side-effect-only imports (`import './x'`). */
+    hasSideEffects: boolean;
+    /** `true` for `import type` / `export type` forms. */
+    typeOnly: boolean;
+}
+export interface ExportRecord {
+    name: string;
+    kind: SymbolKind | 'unknown' | 'reexport' | 'star';
+    isDefault: boolean;
+    line: number;
+    /** Set for re-exports: the module the symbols come from. */
+    fromSpecifier?: string;
+    /** Names pulled from another module (`export { a } from 'b'`). */
+    names?: string[];
+    typeOnly?: boolean;
+}
+export interface SymbolRecord {
+    name: string;
+    kind: SymbolKind;
+    exported: boolean;
+    isDefault: boolean;
+    extends: string[];
+    implements: string[];
+    /** 1-based line of the declaration. */
+    line: number;
+    /** Decorator names, when the language supports them. */
+    decorators?: string[];
+}
+export interface CallRecord {
+    name: string;
+    line: number;
+    /** Receiver identifier for `receiver.method(...)` calls. */
+    receiver?: string;
+}
+export interface RouteRecord {
+    method: string;
+    path: string;
+    line: number;
+}
+/** Language-agnostic signals understood by the analysis core. */
+export declare const SIGNALS: {
+    readonly envAccess: "env:access";
+    readonly testSuite: "test:suite";
+    readonly consoleUsage: "console:usage";
+    readonly httpRoute: "http:route";
+    readonly httpFramework: "http:framework";
+    readonly httpClient: "http:client";
+    readonly graphql: "graphql:library";
+    readonly dbAccess: "db:access";
+    readonly uiFramework: "ui:framework";
+    readonly jsx: "jsx:present";
+    readonly browserApi: "browser:api";
+    readonly worker: "worker:usage";
+    readonly queue: "queue:usage";
+    readonly schedule: "schedule:usage";
+    readonly eventEmitter: "event:emitter";
+    readonly customErrorClass: "error:custom-class";
+    readonly validation: "validation:library";
+    readonly externalSdk: "sdk:external";
+    readonly configLibrary: "config:library";
+    readonly loggingLibrary: "logging:library";
+    readonly cliFramework: "cli:framework";
+    readonly testFramework: "test:framework";
+    readonly decorators: "decorators:present";
+    readonly commonjs: "module:commonjs";
+    readonly esm: "module:esm";
+    readonly typeOnlyExports: "types:only-exports";
+};
+export type Signal = (typeof SIGNALS)[keyof typeof SIGNALS] | `decorator:${string}`;
+export interface ParseOptions {
+    /** Absolute path is not required: adapters work on text only. */
+    path: string;
+    /** Resolved language id for the file. */
+    language: string;
+}
+export interface ParsedFile {
+    path: string;
+    language: string;
+    parseStatus: ParseStatus;
+    imports: ImportRecord[];
+    exports: ExportRecord[];
+    symbols: SymbolRecord[];
+    calls: CallRecord[];
+    routes: RouteRecord[];
+    /** Deduplicated, sorted signals. */
+    signals: string[];
+    /**
+     * Language specific structured data. Known keys:
+     * - `json.keys` — top-level keys of a JSON document
+     * - `markdown.headings` — heading titles
+     * - `package.name` / `package.scripts` / `package.dependencies` — package facts
+     * - `tsconfig.paths` / `tsconfig.baseUrl` — TypeScript path aliases
+     */
+    metadata: Record<string, unknown>;
+    diagnostics: DiagnosticPayload[];
+}
+export interface FileDescriptor {
+    /** Repository-relative POSIX path. */
+    path: string;
+    /** Last path segment. */
+    basename: string;
+    /** Lowercase extension, including the dot (`''` when absent). */
+    extension: string;
+}
+export interface LanguageAdapter {
+    /** Stable language id, for example `typescript`, `json`, `markdown`. */
+    readonly id: string;
+    readonly displayName: string;
+    /** Language ids this adapter can produce (a TS adapter also handles JS). */
+    readonly languageIds: readonly string[];
+    /**
+     * When `true` the adapter runs regardless of the `languages` configuration —
+     * used for structural files such as `package.json` and `tsconfig.json`.
+     */
+    readonly alwaysEnabled: boolean;
+    /** `true` when this adapter claims the file. */
+    handles(file: FileDescriptor): boolean;
+    /** Pure function: text in, facts out. Must never throw. */
+    parse(input: ParseOptions & {
+        contents: string;
+    }): ParsedFile;
+}
+/** Helper used by adapters to build a correctly defaulted {@link ParsedFile}. */
+export declare function createParsedFile(path: string, language: string, overrides?: Partial<ParsedFile>): ParsedFile;
+/** Sorts and deduplicates signals for deterministic output. */
+export declare function normalizeSignals(signals: Iterable<string>): string[];
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/language/types.d.ts.map

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

package/dist/adapters/language/types.js

@@ -0,0 +1,51 @@
+/** Language-agnostic signals understood by the analysis core. */
+export const SIGNALS = {
+    envAccess: 'env:access',
+    testSuite: 'test:suite',
+    consoleUsage: 'console:usage',
+    httpRoute: 'http:route',
+    httpFramework: 'http:framework',
+    httpClient: 'http:client',
+    graphql: 'graphql:library',
+    dbAccess: 'db:access',
+    uiFramework: 'ui:framework',
+    jsx: 'jsx:present',
+    browserApi: 'browser:api',
+    worker: 'worker:usage',
+    queue: 'queue:usage',
+    schedule: 'schedule:usage',
+    eventEmitter: 'event:emitter',
+    customErrorClass: 'error:custom-class',
+    validation: 'validation:library',
+    externalSdk: 'sdk:external',
+    configLibrary: 'config:library',
+    loggingLibrary: 'logging:library',
+    cliFramework: 'cli:framework',
+    testFramework: 'test:framework',
+    decorators: 'decorators:present',
+    commonjs: 'module:commonjs',
+    esm: 'module:esm',
+    typeOnlyExports: 'types:only-exports',
+};
+/** Helper used by adapters to build a correctly defaulted {@link ParsedFile}. */
+export function createParsedFile(path, language, overrides = {}) {
+    return {
+        path,
+        language,
+        parseStatus: 'ok',
+        imports: [],
+        exports: [],
+        symbols: [],
+        calls: [],
+        routes: [],
+        signals: [],
+        metadata: {},
+        diagnostics: [],
+        ...overrides,
+    };
+}
+/** Sorts and deduplicates signals for deterministic output. */
+export function normalizeSignals(signals) {
+    return [...new Set(signals)].sort();
+}
+//# sourceMappingURL=types.js.map

package/dist/adapters/language/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/language/types.ts"],"names":[],"mappings":"AA2EA,iEAAiE;AACjE,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,YAAY;IACvB,YAAY,EAAE,eAAe;IAC7B,SAAS,EAAE,YAAY;IACvB,aAAa,EAAE,gBAAgB;IAC/B,UAAU,EAAE,aAAa;IACzB,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,WAAW;IACrB,WAAW,EAAE,cAAc;IAC3B,GAAG,EAAE,aAAa;IAClB,UAAU,EAAE,aAAa;IACzB,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE,gBAAgB;IAC1B,YAAY,EAAE,eAAe;IAC7B,gBAAgB,EAAE,oBAAoB;IACtC,UAAU,EAAE,oBAAoB;IAChC,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,gBAAgB;IAC/B,cAAc,EAAE,iBAAiB;IACjC,YAAY,EAAE,eAAe;IAC7B,aAAa,EAAE,gBAAgB;IAC/B,UAAU,EAAE,oBAAoB;IAChC,QAAQ,EAAE,iBAAiB;IAC3B,GAAG,EAAE,YAAY;IACjB,eAAe,EAAE,oBAAoB;CAC7B,CAAC;AA2DX,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAgB,EAAE,YAAiC,EAAE;IAClG,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,WAAW,EAAE,IAAI;QACjB,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,EAAE;QACf,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,gBAAgB,CAAC,OAAyB;IACxD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtC,CAAC"}

package/dist/agent-context.d.ts

@@ -0,0 +1,122 @@
+import type { LanguageRegistry } from './adapters/language/registry.ts';
+import type { ConfigOverrides, AgentContextConfig } from './config/types.ts';
+import type { ProgressReporter } from './logging/diagnostics.ts';
+import { Logger } from './logging/diagnostics.ts';
+import type { GitAdapter } from './adapters/git/git-adapter.ts';
+import type { ChangeSet, ContextDiff, Convention, Decision, FileNode, ModuleExplanation, ModuleNode, Repository, ScanReport, SearchResult } from './model/types.ts';
+import { type PersistedContext } from './core/serialization/reader.ts';
+import { type LocalState } from './core/scanner/cache.ts';
+import type { ArchitectureDocument, DependenciesDocument, IndexDocument } from './core/serialization/types.ts';
+import type { RepositoryContext } from './core/context/types.ts';
+import { SearchService, type SearchOptions } from './core/search/service.ts';
+export interface AgentContextOptions {
+    /** Repository root; defaults to `process.cwd()`. */
+    root?: string;
+    /** Configuration overrides (CLI flags take exactly this path). */
+    config?: ConfigOverrides;
+    /** Explicit configuration file path. */
+    configPath?: string;
+    logger?: Logger;
+    registry?: LanguageRegistry;
+    progress?: ProgressReporter;
+    /** Injectable clock (deterministic tests). */
+    now?: () => number;
+    /** Injectable git adapter (tests, sandboxes). */
+    gitAdapter?: GitAdapter;
+}
+export interface ScanOptions {
+    /** Ignore the local state and re-read every file. */
+    force?: boolean;
+    /** Do not write `.agent/`. */
+    dryRun?: boolean;
+}
+export interface StatusReport {
+    status: 'up-to-date' | 'stale' | 'missing';
+    lastScanAt: string | null;
+    configPath: string | null;
+    configHashMatches: boolean;
+    contextFiles: {
+        present: string[];
+        missing: string[];
+        invalid: Array<{
+            file: string;
+            reason: string;
+        }>;
+    };
+    changes: ChangeSet;
+    counts: LocalState['counts'];
+    git: {
+        available: boolean;
+        reason?: string;
+        commitsAnalyzed: number;
+    };
+}
+export interface InitResult {
+    configPath: string;
+    created: string[];
+    alreadyExisted: boolean;
+    overwritten: boolean;
+}
+export declare class AgentContext {
+    readonly root: string;
+    private readonly options;
+    private resolvedConfig;
+    private configSource;
+    private pipeline;
+    private persisted;
+    private constructor();
+    /**
+     * 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 load(options?: AgentContextOptions): Promise<AgentContext>;
+    /** Resolved configuration (defaults + config file + overrides). */
+    get config(): AgentContextConfig;
+    /** Path of the configuration file in use, relative to the root, when it exists. */
+    get configFile(): string | null;
+    private pipelineOptions;
+    /** Runs the pipeline; read-only queries use `dryRun` so nothing is written. */
+    private ensurePipeline;
+    /** Scans the repository and persists the context into `.agent/`. */
+    scan(options?: ScanOptions): Promise<ScanReport>;
+    /** Complete repository model, in memory. */
+    getRepository(): Promise<Repository>;
+    /** Architecture projection. */
+    getArchitecture(): Promise<ArchitectureDocument>;
+    getDependencies(): Promise<DependenciesDocument>;
+    getConventions(): Promise<Convention[]>;
+    getDecisions(): Promise<Decision[]>;
+    getIndex(): Promise<IndexDocument>;
+    getFiles(): Promise<FileNode[]>;
+    /** Modules of the repository, each with heuristic roles and evidence. */
+    getModules(): Promise<ModuleNode[]>;
+    /** Module ids that depend on the given module (direct dependents). */
+    getDependents(moduleId: string): Promise<string[]>;
+    /** Module ids the given module depends on. */
+    getDependenciesOf(moduleId: string): Promise<string[]>;
+    /** Compact, agent oriented repository context. */
+    getRepositoryContext(): Promise<RepositoryContext>;
+    /** Structured explanation of a module (or of the module owning a file). */
+    explain(target: string): Promise<ModuleExplanation | null>;
+    /** Context changes relative to the persisted context. */
+    diff(): Promise<ContextDiff>;
+    /** Deterministic lexical search over files, modules, symbols, conventions, decisions. */
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /** Search with an explicitly provided backend (embeddings, vector database, ...). */
+    searchWith(service: SearchService, query: string, options?: SearchOptions): Promise<SearchResult[]>;
+    /** Compares the working tree with the persisted context. */
+    status(): Promise<StatusReport>;
+    /**
+     * Creates `.agent/` and `.agent/config.json`.
+     *
+     * Idempotent: an existing configuration is left untouched unless `force` is set.
+     */
+    init(options?: {
+        force?: boolean;
+    }): Promise<InitResult>;
+    /** Returns the persisted context or throws a helpful error when it is missing. */
+    requirePersistedContext(): Promise<PersistedContext>;
+}
+//# sourceMappingURL=agent-context.d.ts.map

package/dist/agent-context.d.ts.map

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