agentic-compaction 0.0.1 → 0.0.3

package/README.md

@@ -1,25 +1,25 @@
-# codebase-compact
+# agentic-compaction
 
 Walks a project directory, parses JS/TS/Python files, and outputs a compact structural skeleton of the entire codebase. Designed for feeding project context into LLM prompts with minimal token usage.
 
 Typical compaction rate: **~95%** token reduction.
 
-## Install
+## Quick Start
 
 ```bash
-npm install -g codebase-compact
+npx agentic-compaction /path/to/project
 ```
 
-Or run directly from the repo:
+## Install
 
 ```bash
-node src/cli.js /path/to/project
+npm install -g agentic-compaction
 ```
 
 ## CLI Usage
 
 ```bash
-codebase-compact [path] [options]
+agentic-compaction [path] [options]
 ```
 
 **Options:**
@@ -36,7 +36,7 @@ Output is saved to the target directory as `compacted_<project>_<date>.md`.
 **Example:**
 
 ```bash
-$ codebase-compact ~/projects/my-app
+$ npx agentic-compaction ~/projects/my-app
 
 Saved to /home/user/projects/my-app/compacted_my-app_2026-02-12_15-30-00.md
 
@@ -49,7 +49,7 @@ Saved to /home/user/projects/my-app/compacted_my-app_2026-02-12_15-30-00.md
 ## Library Usage
 
 ```js
-import { compactProject, compactFile } from 'codebase-compact';
+import { compactProject, compactFile } from 'agentic-compaction';
 
 // Compact an entire directory
 const { output, stats } = compactProject('/path/to/project');

package/{compacted_2026-02-12_15-24-24.txt → compacted_standalonecompaction_2026-02-12_17-42-33.md}

@@ -1,6 +1,6 @@
 ## src/cli.js
-imports: 2 ext, ./index.js, ./formatter.js
-fn: getDateStamp:8, pad:10
+imports: 3 ext, ./index.js, ./formatter.js
+fn: getDateStamp:9, pad:11
 ## src/formatter.js
 imports: ./parsers/python.js, ./parsers/babel.js, ./parsers/python.js
 exports: estimateTokens, formatTokenCount, formatOutput

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "agentic-compaction",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Walk a project directory and output a compact structural skeleton of the entire codebase",
   "type": "module",
   "main": "./src/index.js",
   "bin": {
-    "codebase-compact": "./src/cli.js"
+    "agentic-compaction": "./src/cli.js"
   },
   "scripts": {
     "test": "node --test test/"

package/src/cli.js

@@ -2,6 +2,7 @@
 
 import { resolve, join, basename } from 'path';
 import { writeFileSync } from 'fs';
+import pc from 'picocolors';
 import { compactProject } from './index.js';
 import { formatTokenCount } from './formatter.js';
 
@@ -52,8 +53,9 @@ const compactionRate = stats.rawTokens > 0
   ? ((1 - stats.compactedTokens / stats.rawTokens) * 100).toFixed(1)
   : '0';
 
-console.log(`\nSaved to ${outputPath}\n`);
-console.log(`  Files:            ${stats.files}`);
-console.log(`  Project tokens:   ${formatTokenCount(stats.rawTokens)}`);
-console.log(`  Compacted tokens: ${formatTokenCount(stats.compactedTokens)}`);
-console.log(`  Compaction rate:  ${compactionRate}%`);
+console.log(`\n${pc.green('✔')} ${pc.bold('Compaction complete!')}\n`);
+console.log(`  ${pc.dim('Saved to')} ${pc.cyan(outputPath)}\n`);
+console.log(`  ${pc.dim('Files')}            ${pc.white(stats.files)}`);
+console.log(`  ${pc.dim('Project tokens')}   ${pc.yellow(formatTokenCount(stats.rawTokens))}`);
+console.log(`  ${pc.dim('Compacted tokens')} ${pc.green(formatTokenCount(stats.compactedTokens))}`);
+console.log(`  ${pc.dim('Compaction rate')}  ${pc.bold(pc.green(compactionRate + '%'))}`);

package/compacted_standalonecompaction_2026-02-12_15-26-38.md

@@ -1,34 +0,0 @@
-## src/cli.js
-imports: 2 ext, ./index.js, ./formatter.js
-fn: getDateStamp:8, pad:10
-## src/formatter.js
-imports: ./parsers/python.js, ./parsers/babel.js, ./parsers/python.js
-exports: estimateTokens, formatTokenCount, formatOutput
-fn: estimateTokens:5, formatTokenCount:10, formatOutput:16
-## src/index.js
-imports: 1 ext, ./walker.js, ./formatter.js, ./parsers/babel.js, ./parsers/python.js
-exports: isBabelParseable, isPythonParseable, estimateTokens, formatTokenCount, compactFile, compactProject
-fn: compactFile:17, compactProject:38
-## src/parsers/babel.js
-imports: 2 ext
-exports: isBabelParseable, extractSignatures, extractSkeleton, formatSignaturesForPrompt, formatSkeletonForPrompt
-fn: isBabelParseable:9, isPascalCase:13, getReactHOCInfo:17, isCreateContext:52, extractDependencyArray:69, getParamsString:97, getTypeName:123, getReturnType:141, extractSignatures:146, extractSkeleton:242, formatSignaturesForPrompt:402, formatSkeletonForPrompt:407
-## src/parsers/python.js
-exports: isPythonParseable, extractSkeleton, formatSkeletonForPrompt
-fn: isPythonParseable:3, extractSkeleton:14, formatSkeletonForPrompt:148
-## src/walker.js
-imports: 2 ext, ./parsers/babel.js, ./parsers/python.js
-exports: collectFiles
-fn: collectFiles:24, SKIP_DIRS_OR_DOT:48, isParseable:52
-## test/fixtures/sample.js
-imports: 1 ext, ./api
-exports: MyComponent, MyComponent*
-components: MyComponent:6
-fn: helper:16
-hooks: useState(1), useEffect([id]):9
-## test/fixtures/sample.py
-imports: 4 ext
-classes: BaseProcessor:9, Config @dataclass (BaseProcessor):13
-fn: process_data:17, fetch_remote:20, @app.route api_handler:24
-## test/test.js
-imports: 5 ext, ../src/index.js, ../src/parsers/babel.js, ../src/parsers/python.js, ../src/walker.js

package/compacted_standalonecompaction_2026-02-12_15-28-25.md

@@ -1,34 +0,0 @@
-## src/cli.js
-imports: 2 ext, ./index.js, ./formatter.js
-fn: getDateStamp:8, pad:10
-## src/formatter.js
-imports: ./parsers/python.js, ./parsers/babel.js, ./parsers/python.js
-exports: estimateTokens, formatTokenCount, formatOutput
-fn: estimateTokens:5, formatTokenCount:10, formatOutput:16
-## src/index.js
-imports: 1 ext, ./walker.js, ./formatter.js, ./parsers/babel.js, ./parsers/python.js
-exports: isBabelParseable, isPythonParseable, estimateTokens, formatTokenCount, compactFile, compactProject
-fn: compactFile:17, compactProject:38
-## src/parsers/babel.js
-imports: 2 ext
-exports: isBabelParseable, extractSignatures, extractSkeleton, formatSignaturesForPrompt, formatSkeletonForPrompt
-fn: isBabelParseable:9, isPascalCase:13, getReactHOCInfo:17, isCreateContext:52, extractDependencyArray:69, getParamsString:97, getTypeName:123, getReturnType:141, extractSignatures:146, extractSkeleton:242, formatSignaturesForPrompt:402, formatSkeletonForPrompt:407
-## src/parsers/python.js
-exports: isPythonParseable, extractSkeleton, formatSkeletonForPrompt
-fn: isPythonParseable:3, extractSkeleton:14, formatSkeletonForPrompt:148
-## src/walker.js
-imports: 2 ext, ./parsers/babel.js, ./parsers/python.js
-exports: collectFiles
-fn: collectFiles:24, SKIP_DIRS_OR_DOT:48, isParseable:52
-## test/fixtures/sample.js
-imports: 1 ext, ./api
-exports: MyComponent, MyComponent*
-components: MyComponent:6
-fn: helper:16
-hooks: useState(1), useEffect([id]):9
-## test/fixtures/sample.py
-imports: 4 ext
-classes: BaseProcessor:9, Config @dataclass (BaseProcessor):13
-fn: process_data:17, fetch_remote:20, @app.route api_handler:24
-## test/test.js
-imports: 5 ext, ../src/index.js, ../src/parsers/babel.js, ../src/parsers/python.js, ../src/walker.js