@ai-agent-context/core 0.1.0

package/dist/core/context/repository-context.js

@@ -0,0 +1,134 @@
+import { compareStrings } from "../../model/canonical.js";
+import { GENERATOR_NAME, SCHEMA_VERSION } from "../../model/schema.js";
+const COMMAND_PATTERN = /^(start|dev|serve|build|test|lint|typecheck|check|format|migrate|seed|generate|clean)$/;
+const COMMAND_ORDER = ['start', 'dev', 'build', 'test', 'lint', 'typecheck', 'format'];
+/** Collects the runnable commands declared by the repository (documented facts). */
+export function collectCommands(graph) {
+    const commands = [];
+    const manager = graph.repository.workspace.packageManager === 'unknown' ? 'npm' : graph.repository.workspace.packageManager;
+    for (const entry of [...graph.repository.workspace.packages].sort((a, b) => compareStrings(a.path, b.path))) {
+        for (const [name, script] of Object.entries(entry.scripts).sort((a, b) => compareStrings(a[0], b[0]))) {
+            if (!COMMAND_PATTERN.test(name) && !name.startsWith('test:'))
+                continue;
+            commands.push({
+                name,
+                command: `${manager} run ${name}${entry.path.length > 0 ? ` --workspace ${entry.name}` : ''}`,
+                script,
+                scope: entry.path.length === 0 ? 'root' : entry.name,
+            });
+        }
+    }
+    return commands.sort((a, b) => {
+        const indexA = COMMAND_ORDER.indexOf(a.name);
+        const indexB = COMMAND_ORDER.indexOf(b.name);
+        const rankA = indexA === -1 ? COMMAND_ORDER.length : indexA;
+        const rankB = indexB === -1 ? COMMAND_ORDER.length : indexB;
+        if (rankA !== rankB)
+            return rankA - rankB;
+        return compareStrings(`${a.scope}|${a.name}`, `${b.scope}|${b.name}`);
+    });
+}
+/** Builds the repository context payload. */
+export function buildRepositoryContext(graph, parsed) {
+    const repository = graph.repository;
+    const modulesByImportance = [...repository.modules]
+        .sort((a, b) => {
+        const scoreA = a.usedBy.length * 10 + a.files.length;
+        const scoreB = b.usedBy.length * 10 + b.files.length;
+        if (scoreA !== scoreB)
+            return scoreB - scoreA;
+        return compareStrings(a.id, b.id);
+    })
+        .slice(0, 25);
+    const entryPoints = [...repository.entryPoints]
+        .sort((a, b) => (b.confidence === a.confidence ? compareStrings(a.path, b.path) : b.confidence - a.confidence))
+        .slice(0, 30);
+    const importanceRank = { infrastructure: 3, framework: 2, tooling: 1, utility: 0 };
+    const externalDependencies = [...repository.externalDependencies]
+        .sort((a, b) => {
+        const rankA = importanceRank[a.importance.value] * 1000 + a.importedByModules;
+        const rankB = importanceRank[b.importance.value] * 1000 + b.importedByModules;
+        if (rankA !== rankB)
+            return rankB - rankA;
+        return compareStrings(a.name, b.name);
+    })
+        .slice(0, 25);
+    return {
+        schemaVersion: SCHEMA_VERSION,
+        generatedBy: GENERATOR_NAME,
+        repository: {
+            name: repository.name,
+            languages: repository.languages,
+            fileCount: repository.files.length,
+            sourceFileCount: repository.files.filter((file) => file.kind === 'source').length,
+            testFileCount: repository.files.filter((file) => file.kind === 'test').length,
+            moduleCount: repository.modules.length,
+            symbolCount: repository.symbols.length,
+            dependencyCount: repository.dependencies.length,
+            entryPointCount: repository.entryPoints.length,
+        },
+        workspace: {
+            isMonorepo: repository.workspace.isMonorepo,
+            model: repository.workspace.workspaceModel,
+            packageManager: repository.workspace.packageManager,
+            packageManagerEvidence: repository.workspace.packageManagerEvidence,
+            lockfiles: repository.workspace.lockfiles,
+            packages: repository.workspace.packages.map((entry) => ({
+                name: entry.name,
+                path: entry.path,
+                version: entry.version,
+                private: entry.private,
+                runtimeDependencies: entry.runtimeDependencies.length,
+                developmentDependencies: entry.developmentDependencies.length,
+            })),
+        },
+        commands: collectCommands(graph),
+        modules: modulesByImportance.map((module) => ({
+            id: module.id,
+            path: module.path,
+            basis: module.basis,
+            files: module.files.length,
+            roles: module.roles,
+            dependsOn: module.dependsOn,
+            usedBy: module.usedBy,
+            entryPoints: module.entryPoints.map((entry) => entry.path).slice(0, 5),
+            publicExports: module.publicExports.map((entry) => entry.name).slice(0, 10),
+            git: module.git,
+        })),
+        entryPoints,
+        externalDependencies,
+        conventions: repository.conventions.map((convention) => ({
+            id: convention.id,
+            category: convention.category,
+            statement: convention.statement,
+            confidence: convention.confidence,
+        })),
+        decisions: repository.decisions.map((decision) => ({
+            id: decision.id,
+            title: decision.title,
+            status: decision.status,
+            origin: decision.origin,
+            source: decision.source,
+        })),
+        cycles: repository.cycles,
+        diagnostics: {
+            parsedFiles: parsed.size,
+            sensitiveSkipped: repository.files.filter((file) => file.sensitive).length,
+            partialParses: repository.files
+                .filter((file) => file.parseStatus === 'partial')
+                .map((file) => file.path)
+                .slice(0, 20),
+            failedParses: repository.files
+                .filter((file) => file.parseStatus === 'failed')
+                .map((file) => file.path)
+                .slice(0, 20),
+            unresolvedImports: graph.unresolved.slice(0, 20),
+        },
+        notes: [
+            'Roles carrying a confidence value are heuristics derived from file names, paths and import signals; they are not authoritative statements about the architecture.',
+            'Conventions and decisions carry their evidence; entries with origin "inferred" were derived by heuristics rather than authored by humans.',
+            'All analysis is local: no repository content leaves the machine and no LLM is involved.',
+        ],
+    };
+}
+//# sourceMappingURL=repository-context.js.map

package/dist/core/context/repository-context.js.map

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

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

@@ -0,0 +1,94 @@
+/** Payload shapes of the context projections (canonical, serializable). */
+import type { Detection, EntryPoint, GitModuleSignals, ModuleBasis, ModuleRole } from '../../model/types.ts';
+export interface ContextCommand {
+    name: string;
+    /** Ready to paste command line. */
+    command: string;
+    /** The raw npm script body. */
+    script: string;
+    /** `root` or the workspace package name. */
+    scope: string;
+}
+export interface RepositoryContextPayload {
+    schemaVersion: number;
+    generatedBy: string;
+    repository: {
+        name: string;
+        languages: string[];
+        fileCount: number;
+        sourceFileCount: number;
+        testFileCount: number;
+        moduleCount: number;
+        symbolCount: number;
+        dependencyCount: number;
+        entryPointCount: number;
+    };
+    workspace: {
+        isMonorepo: boolean;
+        model: string;
+        packageManager: string;
+        packageManagerEvidence: Array<{
+            source: string;
+            detail: string;
+        }>;
+        lockfiles: string[];
+        packages: Array<{
+            name: string;
+            path: string;
+            version: string | null;
+            private: boolean;
+            runtimeDependencies: number;
+            developmentDependencies: number;
+        }>;
+    };
+    commands: ContextCommand[];
+    modules: Array<{
+        id: string;
+        path: string;
+        basis: ModuleBasis;
+        files: number;
+        roles: Detection<ModuleRole>[];
+        dependsOn: string[];
+        usedBy: string[];
+        entryPoints: string[];
+        publicExports: string[];
+        git: GitModuleSignals | null;
+    }>;
+    entryPoints: EntryPoint[];
+    externalDependencies: Array<{
+        name: string;
+        scope: string;
+        declaredBy: string[];
+        importedByModules: number;
+        importance: Detection;
+    }>;
+    conventions: Array<{
+        id: string;
+        category: string;
+        statement: string;
+        confidence: number;
+    }>;
+    decisions: Array<{
+        id: string;
+        title: string;
+        status: string;
+        origin: string;
+        source: string;
+    }>;
+    cycles: string[][];
+    diagnostics: {
+        parsedFiles: number;
+        sensitiveSkipped: number;
+        partialParses: string[];
+        failedParses: string[];
+        unresolvedImports: Array<{
+            file: string;
+            specifier: string;
+            attempts: string[];
+        }>;
+    };
+    notes: string[];
+}
+/** Short alias used by the public API. */
+export type RepositoryContext = RepositoryContextPayload;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/context/types.js

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

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

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

package/dist/core/conventions/detector.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Observable convention detection.
+ *
+ * Guarantee: no convention is invented. Every statement comes from a counted
+ * observation with counts and example files attached as evidence; small samples
+ * get low confidence or are not reported at all.
+ *
+ * Categories: Naming, Imports, Tests, Error handling, Exports, Structure,
+ * Toolchain, Documentation, Languages.
+ */
+import type { Convention, Evidence, Repository } from '../../model/types.ts';
+import type { ParsedFile } from '../../adapters/language/types.ts';
+import type { AliasEntry } from '../graph/resolver.ts';
+/** Minimum sample sizes below which a convention is not reported. */
+export declare const MIN_SAMPLE: {
+    readonly fileNaming: 6;
+    readonly symbols: 4;
+    readonly imports: 4;
+    readonly tests: 2;
+    readonly exports: 4;
+};
+export interface ConventionDetectionInput {
+    repository: Repository;
+    parsed: Map<string, ParsedFile>;
+    aliases: AliasEntry[];
+}
+export declare function makeConvention(category: string, statement: string, confidence: number, evidence: Evidence[], origin?: Convention['origin']): Convention;
+export declare function detectFileNaming(conventions: Convention[], repository: Repository): void;
+export declare function detectSymbolNaming(conventions: Convention[], repository: Repository): void;
+interface ImportStatistics {
+    filesWithImports: number;
+    relative: number;
+    alias: number;
+    workspace: number;
+    external: number;
+    requireCalls: number;
+    typeOnlyFiles: number;
+    explicitJsExtensions: number;
+    externalFirstFiles: number;
+    orderedFiles: number;
+}
+/** Counts import styles across the repository. */
+export declare function collectImportStatistics(parsed: Map<string, ParsedFile>, aliases: AliasEntry[]): ImportStatistics;
+export declare function detectImportConventions(conventions: Convention[], repository: Repository, parsed: Map<string, ParsedFile>, aliases: AliasEntry[]): void;
+export declare function detectTestConventions(conventions: Convention[], repository: Repository, parsed: Map<string, ParsedFile>): void;
+export declare function detectErrorConventions(conventions: Convention[], repository: Repository): void;
+export declare function detectExportConventions(conventions: Convention[], repository: Repository): void;
+export declare function detectStructureConventions(conventions: Convention[], repository: Repository): void;
+export declare function detectToolchainConventions(conventions: Convention[], repository: Repository, parsed: Map<string, ParsedFile>): void;
+export declare function detectDocumentationConventions(conventions: Convention[], repository: Repository, parsed: Map<string, ParsedFile>): void;
+export declare function detectLanguageConventions(conventions: Convention[], repository: Repository): void;
+/** Runs every convention detector and returns a deterministic, ordered list. */
+export declare function detectConventions(input: ConventionDetectionInput): Convention[];
+export {};
+//# sourceMappingURL=detector.d.ts.map

package/dist/core/conventions/detector.d.ts.map

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