@aria_asi/cli 0.2.0

package/dist/aria-web/src/lib/codebase-scanner.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Auto codebase discovery scanner — produces a compressed "schema image"
+ * that eliminates cold starts for any LLM.
+ *
+ * Scans a directory and detects language, framework, package manager, database,
+ * ORM, test framework, entry points, project structure, dependencies, and
+ * architecture patterns. Outputs a SchemaImage object and a human-readable
+ * compressed text block.
+ *
+ * Zero external dependencies — uses only Node.js built-ins (fs, path, crypto,
+ * child_process, events). Optional chokidar support for file watching.
+ *
+ * @module codebase-scanner
+ */
+/** Inferred purpose of a directory within a project. */
+export type DirectoryPurpose = 'routes' | 'components' | 'utilities' | 'services' | 'hooks' | 'models' | 'controllers' | 'middleware' | 'store' | 'types' | 'config' | 'styles' | 'assets' | 'tests' | 'e2e-tests' | 'docs' | 'scripts' | 'migrations' | 'infrastructure' | 'prisma' | 'api' | 'db' | 'root';
+/** Architecture pattern classification. */
+export type ArchitecturePattern = 'mvc' | 'microservices' | 'monolith' | 'monorepo' | 'layered' | 'serverless' | 'unknown';
+/** A node in the directory tree with its inferred purpose. */
+export interface DirectoryNode {
+    /** Relative path from project root. */
+    path: string;
+    /** Directory name. */
+    name: string;
+    /** Inferred purpose of this directory. */
+    purpose: DirectoryPurpose;
+    /** Count of immediate children (files + dirs) within. */
+    itemCount: number;
+    /** Notable file names within this directory (max 12). */
+    notableFiles: string[];
+    /** Child directories. */
+    children: DirectoryNode[];
+}
+/** A top-level dependency with version string. */
+export interface Dependency {
+    name: string;
+    version: string;
+    /** production | dev */
+    type: 'production' | 'dev';
+}
+/** Compressed schema image — the primary scan output. */
+export interface SchemaImage {
+    /** Project name (from package.json or directory name). */
+    projectName: string;
+    /** Absolute root path scanned. */
+    rootPath: string;
+    /** Detected primary language. */
+    language: string;
+    /** Detected framework (e.g. "Next.js 15", "FastAPI", "Axum"). */
+    framework: string;
+    /** Package manager used. */
+    packageManager: string;
+    /** Database with provider detail. */
+    database: string | null;
+    /** ORM with model count if detectable. */
+    orm: string | null;
+    /** Test framework. */
+    testFramework: string | null;
+    /** Relative entry-point paths. */
+    entryPoints: string[];
+    /** Directory tree with inferred purposes. */
+    structure: DirectoryNode[];
+    /** Notable dependencies. */
+    dependencies: Dependency[];
+    /** Architecture pattern. */
+    architecture: ArchitecturePattern;
+    /** High-level patterns observed. */
+    keyPatterns: string[];
+    /** Total file count (excluding ignored dirs). */
+    fileCount: number;
+    /** Count of test files found. */
+    testCount: number;
+    /** ISO-8601 timestamp of last scan. */
+    lastScan: string;
+}
+/** Returned by estimateProjectSize. */
+export interface ProjectSize {
+    files: number;
+    lines: number;
+}
+/**
+ * Scan a codebase directory and produce a compressed schema image.
+ *
+ * The schema image captures language, framework, package manager, database,
+ * ORM, test framework, entry points, project structure, dependencies,
+ * architecture pattern, and key patterns — everything an LLM needs to
+ * understand a codebase without reading all the files.
+ *
+ * @param rootPath - Absolute or relative path to the project root.
+ * @returns A SchemaImage with all detected information.
+ */
+export declare function scanCodebase(rootPath: string): Promise<SchemaImage>;
+/**
+ * Compress a SchemaImage into a human-readable text block optimized for LLM
+ * context windows. This is the "schema image" text that should be injected
+ * into system prompts to eliminate cold starts.
+ *
+ * @param image - The schema image from {@link scanCodebase}.
+ * @returns A compressed text block describing the codebase.
+ */
+export declare function schemaImageToText(image: SchemaImage): string;
+/**
+ * Watch a codebase directory for changes and re-scan automatically.
+ *
+ * Uses Node.js built-in `fs.watch` with a 500ms debounce. If chokidar is
+ * available as an optional dependency, it will be preferred automatically
+ * (more reliable cross-platform watching).
+ *
+ * @param rootPath - Absolute or relative path to the project root.
+ * @param onChange - Callback invoked with the updated SchemaImage on changes.
+ * @returns An object with a `stop()` method to stop watching.
+ */
+export declare function watchCodebase(rootPath: string, onChange: (image: SchemaImage) => void): {
+    stop: () => void;
+};
+/**
+ * Estimate the size of a project (file count and total lines of code).
+ *
+ * Attempts to use `cloc` if available on the system, otherwise falls back
+ * to a manual line count via Node.js built-in `fs` operations. The manual
+ * fallback caps at 10,000 files for performance.
+ *
+ * @param rootPath - Absolute or relative path to the project root.
+ * @returns A ProjectSize with file count and approximate line count.
+ */
+export declare function estimateProjectSize(rootPath: string): Promise<ProjectSize>;
+//# sourceMappingURL=codebase-scanner.d.ts.map

package/dist/aria-web/src/lib/codebase-scanner.d.ts.map

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