agentic-compaction 0.0.3 → 0.0.5

package/README.md

@@ -74,11 +74,12 @@ hooks: useState(2), useEffect([user]):18, useAuth
 ```
 
 The skeleton captures:
-- **Imports** (local paths shown, externals counted)
+- **Imports** (deduplicated local paths shown, externals counted)
 - **Exports** (default marked with `*`)
-- **Components** (PascalCase functions, HOC-wrapped)
-- **Functions** (with line numbers)
-- **Hooks** (counts, useEffect deps, custom hooks)
+- **Components** (top-level PascalCase functions, HOC-wrapped)
+- **Functions** (top-level only, with line numbers)
+- **Hooks** (only from top-level components: counts, useEffect deps, custom hooks)
+- **Constants** (top-level only)
 - **Classes, interfaces, types** (TS)
 - **Python**: imports, classes (with bases/decorators), functions, constants
 
@@ -86,9 +87,9 @@ The skeleton captures:
 
 | Language | Parser | Extensions |
 |----------|--------|------------|
-| JavaScript | `@babel/parser` | `.js`, `.jsx`, `.mjs`, `.cjs` |
-| TypeScript | `@babel/parser` | `.ts`, `.tsx`, `.mts`, `.cts` |
-| Python | Regex-based (zero deps) | `.py` |
+| JavaScript | `@babel/parser` (top-level only) | `.js`, `.jsx`, `.mjs`, `.cjs` |
+| TypeScript | `@babel/parser` (top-level only) | `.ts`, `.tsx`, `.mts`, `.cts` |
+| Python | Regex-based (top-level only, zero deps) | `.py` |
 
 ## Skipped Directories
 

package/compacted_standalonecompaction_2026-02-12_17-57-32.md

@@ -0,0 +1,37 @@
+## src/cli.js
+imports: 3 ext, ./index.js, ./formatter.js
+fn: getDateStamp():9, pad(n):11
+const: now, args, targetPath, jsonOutput, i +5 more
+## src/formatter.js
+imports: ./parsers/python.js, ./parsers/babel.js, ./parsers/python.js
+fn: estimateTokens(text)+:5, formatTokenCount(count)+:10, formatOutput(results)+:16
+const: lines, output
+## src/index.js
+imports: 1 ext, ./walker.js, ./formatter.js, ./parsers/babel.js, ./parsers/python.js
+fn: compactFile(filePath, content)+:17, compactProject(rootPath, options = ...)+:38
+const: skeleton, formatted, files, results, rawTokens +4 more
+## src/parsers/babel.js
+imports: 2 ext
+fn: isBabelParseable(path)+:9, isPascalCase(name):13, getReactHOCInfo(node):17, isCreateContext(node):52, extractDependencyArray(node):69, getParamsString(params):97, getTypeName(typeAnnotation):127, getReturnType(node):145, extractSignatures(code, filePath = ...)+:150, extractSkeleton(code, filePath = ...)+:246, formatSignaturesForPrompt(signatures)+:438, formatSkeletonForPrompt(skeleton)+:443
+const: traverse, BABEL_EXTENSIONS, callee, hocType, method +75 more
+## src/parsers/python.js
+fn: isPythonParseable(path)+:3, extractSkeleton(code, filePath = ...)+:14, formatSkeletonForPrompt(skeleton)+:148
+const: PYTHON_EXTENSIONS, lines, skeleton, pendingDecorators, i +25 more
+## src/walker.js
+imports: 2 ext, ./parsers/babel.js, ./parsers/python.js
+fn: collectFiles(dir, rootDir = ..., files = ...)+:24, SKIP_DIRS_OR_DOT(name):48, isParseable(path):52
+const: SKIP_DIRECTORIES, fullPath, relativePath
+## test/fixtures/sample.js
+imports: 1 ext, ./api
+components: MyComponent({ id })*:6
+fn: helper(x):16
+const: API_URL
+hooks: useState: data, useEffect([id])
+## test/fixtures/sample.py
+imports: 4 ext
+classes: BaseProcessor:9, Config @dataclass (BaseProcessor):13
+fn: process_data(items, timeout=30):17, fetch_remote(url, **kwargs):20, @app.route api_handler(request):24
+const: MAX_RETRIES, DEFAULT_TIMEOUT
+## test/test.js
+imports: 5 ext, ../src/index.js, ../src/parsers/babel.js, ../src/parsers/python.js, ../src/walker.js
+const: __dirname, fixturesDir, code, skeleton, code +14 more

package/compacted_standalonecompaction_2026-02-12_17-58-28.md

@@ -0,0 +1,37 @@
+## src/cli.js
+imports: 3 ext, ./index.js, ./formatter.js
+fn: getDateStamp():9, pad(n):11
+const: now, args, targetPath, jsonOutput, i +5 more
+## src/formatter.js
+imports: ./parsers/python.js, ./parsers/babel.js, ./parsers/python.js
+fn: estimateTokens(text)+:5, formatTokenCount(count)+:10, formatOutput(results)+:16
+const: lines, output
+## src/index.js
+imports: 1 ext, ./walker.js, ./formatter.js, ./parsers/babel.js, ./parsers/python.js
+fn: compactFile(filePath, content)+:17, compactProject(rootPath, options = ...)+:38
+const: skeleton, formatted, files, results, rawTokens +4 more
+## src/parsers/babel.js
+imports: 2 ext
+fn: isBabelParseable(path)+:9, isPascalCase(name):13, getReactHOCInfo(node):17, isCreateContext(node):52, extractDependencyArray(node):69, getParamsString(params):97, getTypeName(typeAnnotation):127, getReturnType(node):145, extractSignatures(code, filePath = ...)+:150, extractSkeleton(code, filePath = ...)+:246, formatSignaturesForPrompt(signatures)+:438, formatSkeletonForPrompt(skeleton)+:443
+const: traverse, BABEL_EXTENSIONS, callee, hocType, method +75 more
+## src/parsers/python.js
+fn: isPythonParseable(path)+:3, extractSkeleton(code, filePath = ...)+:14, formatSkeletonForPrompt(skeleton)+:148
+const: PYTHON_EXTENSIONS, lines, skeleton, pendingDecorators, i +25 more
+## src/walker.js
+imports: 2 ext, ./parsers/babel.js, ./parsers/python.js
+fn: collectFiles(dir, rootDir = ..., files = ...)+:24, SKIP_DIRS_OR_DOT(name):48, isParseable(path):52
+const: SKIP_DIRECTORIES, fullPath, relativePath
+## test/fixtures/sample.js
+imports: 1 ext, ./api
+components: MyComponent({ id })*:6
+fn: helper(x):16
+const: API_URL
+hooks: useState: data, useEffect([id])
+## test/fixtures/sample.py
+imports: 4 ext
+classes: BaseProcessor:9, Config @dataclass (BaseProcessor):13
+fn: process_data(items, timeout=30):17, fetch_remote(url, **kwargs):20, @app.route api_handler(request):24
+const: MAX_RETRIES, DEFAULT_TIMEOUT
+## test/test.js
+imports: 5 ext, ../src/index.js, ../src/parsers/babel.js, ../src/parsers/python.js, ../src/walker.js
+const: __dirname, fixturesDir, code, skeleton, code +14 more

package/compacted_standalonecompaction_2026-02-12_18-05-15.md

@@ -0,0 +1,35 @@
+## src/cli.js
+imports: 3 ext, ./index.js, ./formatter.js
+fn: getDateStamp():9
+const: args, targetPath, jsonOutput, dirName, filename +2 more
+## src/formatter.js
+imports: ./parsers/python.js, ./parsers/babel.js
+fn: estimateTokens(text)+:5, formatTokenCount(count)+:10, formatOutput(results)+:16
+## src/index.js
+imports: 1 ext, ./walker.js, ./formatter.js, ./parsers/babel.js, ./parsers/python.js
+fn: compactFile(filePath, content)+:17, compactProject(rootPath, options = ...)+:38
+## src/parsers/babel.js
+imports: 2 ext
+fn: isBabelParseable(path)+:9, isPascalCase(name):13, getReactHOCInfo(node):17, isCreateContext(node):52, extractDependencyArray(node):69, getParamsString(params):97, getTypeName(typeAnnotation):127, getReturnType(node):145, extractSignatures(code, filePath = ...)+:150, extractSkeleton(code, filePath = ...)+:246, formatSignaturesForPrompt(signatures)+:444, formatSkeletonForPrompt(skeleton)+:449
+const: traverse, BABEL_EXTENSIONS
+## src/parsers/python.js
+fn: isPythonParseable(path)+:3, extractSkeleton(code, filePath = ...)+:14, formatSkeletonForPrompt(skeleton)+:148
+const: PYTHON_EXTENSIONS
+## src/walker.js
+imports: 2 ext, ./parsers/babel.js, ./parsers/python.js
+fn: collectFiles(dir, rootDir = ..., files = ...)+:24, SKIP_DIRS_OR_DOT(name):48, isParseable(path):52
+const: SKIP_DIRECTORIES
+## test/fixtures/sample.js
+imports: 1 ext, ./api
+components: MyComponent({ id })*:6
+fn: helper(x):16
+const: API_URL
+hooks: useState: data, useEffect([id])
+## test/fixtures/sample.py
+imports: 4 ext
+classes: BaseProcessor:9, Config @dataclass (BaseProcessor):13
+fn: process_data(items, timeout=30):17, fetch_remote(url, **kwargs):20, @app.route api_handler(request):24
+const: MAX_RETRIES, DEFAULT_TIMEOUT
+## test/test.js
+imports: 5 ext, ../src/index.js, ../src/parsers/babel.js, ../src/parsers/python.js, ../src/walker.js
+const: __dirname, fixturesDir

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-compaction",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Walk a project directory and output a compact structural skeleton of the entire codebase",
   "type": "module",
   "main": "./src/index.js",

package/src/parsers/babel.js

@@ -111,7 +111,11 @@ const getParamsString = (params) => {
       return `...${param.argument?.name || 'args'}`;
     }
     if (param.type === 'ObjectPattern') {
-      return '{ ... }';
+      const keys = param.properties.map(p => {
+        if (p.type === 'RestElement') return `...${p.argument?.name || 'rest'}`;
+        return p.key?.name || '?';
+      });
+      return `{ ${keys.join(', ')} }`;
     }
     if (param.type === 'ArrayPattern') {
       return '[ ... ]';
@@ -265,16 +269,18 @@ export const extractSkeleton = (code, filePath = '') => {
 
   const skeleton = {
     imports: [],
-    exports: [],
     components: [],
     functions: [],
-    hooks: { useState: 0, useEffect: [], useCallback: 0, useMemo: 0, useRef: 0, custom: [] },
-    constants: 0,
+    hooks: { useState: [], useEffect: [], useCallback: 0, useMemo: 0, useRef: 0, custom: [] },
+    constants: [],
     classes: [],
     interfaces: [],
     types: [],
   };
 
+  // Collect export info: name -> 'default' | 'named'
+  const exportMap = new Map();
+
   traverse(ast, {
     ImportDeclaration(path) {
       const source = path.node.source.value;
@@ -289,9 +295,9 @@ export const extractSkeleton = (code, filePath = '') => {
     ExportDefaultDeclaration(path) {
       const decl = path.node.declaration;
       if (decl.type === 'Identifier') {
-        skeleton.exports.push({ name: decl.name, type: 'default' });
+        exportMap.set(decl.name, 'default');
       } else if (decl.type === 'FunctionDeclaration' && decl.id) {
-        skeleton.exports.push({ name: decl.id.name, type: 'default' });
+        exportMap.set(decl.id.name, 'default');
       }
     },
 
@@ -299,50 +305,65 @@ export const extractSkeleton = (code, filePath = '') => {
       if (path.node.declaration) {
         const decl = path.node.declaration;
         if (decl.type === 'FunctionDeclaration' && decl.id) {
-          skeleton.exports.push({ name: decl.id.name, type: 'named' });
+          exportMap.set(decl.id.name, 'named');
         } else if (decl.type === 'VariableDeclaration') {
           decl.declarations.forEach(d => {
             if (d.id?.name) {
-              skeleton.exports.push({ name: d.id.name, type: 'named' });
+              exportMap.set(d.id.name, 'named');
             }
           });
         }
       }
       if (path.node.specifiers) {
         path.node.specifiers.forEach(s => {
-          skeleton.exports.push({ name: s.exported?.name || s.local.name, type: 'named' });
+          exportMap.set(s.exported?.name || s.local.name, 'named');
         });
       }
     },
 
     FunctionDeclaration(path) {
+      if (path.parent.type !== 'Program' && path.parent.type !== 'ExportNamedDeclaration' && path.parent.type !== 'ExportDefaultDeclaration') return;
       const name = path.node.id?.name;
       if (!name) return;
 
+      const params = getParamsString(path.node.params);
+      const isAsync = path.node.async || false;
+      const entry = { name, line: path.node.loc?.start?.line || 0, params, async: isAsync };
+
       if (isPascalCase(name)) {
-        skeleton.components.push({ name, line: path.node.loc?.start?.line || 0 });
+        skeleton.components.push(entry);
       } else {
-        skeleton.functions.push({ name, line: path.node.loc?.start?.line || 0 });
+        skeleton.functions.push(entry);
       }
     },
 
     VariableDeclarator(path) {
+      const declParent = path.parentPath?.parent;
+      if (declParent?.type !== 'Program' && declParent?.type !== 'ExportNamedDeclaration' && declParent?.type !== 'ExportDefaultDeclaration') return;
       const name = path.node.id?.name;
       const init = path.node.init;
       if (!name || !init) return;
 
       if (init.type === 'ArrowFunctionExpression' || init.type === 'FunctionExpression') {
+        const params = getParamsString(init.params);
+        const isAsync = init.async || false;
+        const entry = { name, line: path.node.loc?.start?.line || 0, params, async: isAsync };
+
         if (isPascalCase(name)) {
-          skeleton.components.push({ name, line: path.node.loc?.start?.line || 0 });
+          skeleton.components.push(entry);
         } else {
-          skeleton.functions.push({ name, line: path.node.loc?.start?.line || 0 });
+          skeleton.functions.push(entry);
         }
         return;
       }
 
       const hocInfo = getReactHOCInfo(init);
       if (hocInfo) {
-        skeleton.components.push({ name, line: path.node.loc?.start?.line || 0, hoc: hocInfo.type });
+        let params = '?';
+        if (hocInfo.innerFn) {
+          params = getParamsString(hocInfo.innerFn.params);
+        }
+        skeleton.components.push({ name, line: path.node.loc?.start?.line || 0, hoc: hocInfo.type, params, async: false });
         return;
       }
 
@@ -352,16 +373,30 @@ export const extractSkeleton = (code, filePath = '') => {
         return;
       }
 
-      skeleton.constants++;
+      skeleton.constants.push(name);
     },
 
     CallExpression(path) {
       const callee = path.node.callee;
       if (callee.type === 'Identifier' && callee.name.startsWith('use')) {
+        // Only capture hooks inside top-level functions (components)
+        const funcScope = path.scope.getFunctionParent();
+        if (funcScope && funcScope.parent?.block?.type !== 'Program') return;
         const hookName = callee.name;
         const line = path.node.loc?.start?.line || 0;
 
-        if (hookName === 'useEffect') {
+        if (hookName === 'useState') {
+          // Extract destructured variable name from parent: const [name, setName] = useState(...)
+          let varName = null;
+          const parent = path.parent;
+          if (parent?.type === 'VariableDeclarator' && parent.id?.type === 'ArrayPattern') {
+            const first = parent.id.elements[0];
+            if (first?.type === 'Identifier') {
+              varName = first.name;
+            }
+          }
+          skeleton.hooks.useState.push(varName || '?');
+        } else if (hookName === 'useEffect') {
           const deps = extractDependencyArray(path.node.arguments[1]);
           skeleton.hooks.useEffect.push({ line, deps });
         } else if (skeleton.hooks[hookName] !== undefined) {
@@ -396,6 +431,13 @@ export const extractSkeleton = (code, filePath = '') => {
     },
   });
 
+  // Apply export markers to components, functions, classes
+  for (const entry of [...skeleton.components, ...skeleton.functions, ...skeleton.classes]) {
+    const exportType = exportMap.get(entry.name);
+    if (exportType === 'default') entry.exportMarker = '*';
+    else if (exportType === 'named') entry.exportMarker = '+';
+  }
+
   return skeleton;
 };
 
@@ -414,17 +456,17 @@ export const formatSkeletonForPrompt = (skeleton) => {
     const extCount = skeleton.imports.length - local.length;
     const parts = [];
     if (extCount > 0) parts.push(`${extCount} ext`);
-    parts.push(...local.map(i => i.source));
+    parts.push(...[...new Set(local.map(i => i.source))]);
     lines.push(`imports: ${parts.join(', ')}`);
   }
 
-  if (skeleton.exports.length > 0) {
-    const exportNames = skeleton.exports.map(e => e.type === 'default' ? `${e.name}*` : e.name).join(', ');
-    lines.push(`exports: ${exportNames}`);
-  }
-
   if (skeleton.components.length > 0) {
-    const componentList = skeleton.components.map(c => c.hoc ? `${c.name}(${c.hoc}):${c.line}` : `${c.name}:${c.line}`).join(', ');
+    const componentList = skeleton.components.map(c => {
+      const marker = c.exportMarker || '';
+      const params = c.params !== undefined ? `(${c.params})` : '';
+      const hoc = c.hoc ? `(${c.hoc})` : '';
+      return `${c.name}${hoc}${params}${marker}:${c.line}`;
+    }).join(', ');
     lines.push(`components: ${componentList}`);
   }
 
@@ -433,11 +475,26 @@ export const formatSkeletonForPrompt = (skeleton) => {
   }
 
   if (skeleton.functions.length > 0) {
-    lines.push(`fn: ${skeleton.functions.map(f => `${f.name}:${f.line}`).join(', ')}`);
+    const funcList = skeleton.functions.map(f => {
+      const marker = f.exportMarker || '';
+      const asyncPrefix = f.async ? 'async ' : '';
+      const params = f.params !== undefined ? `(${f.params})` : '';
+      return `${asyncPrefix}${f.name}${params}${marker}:${f.line}`;
+    }).join(', ');
+    lines.push(`fn: ${funcList}`);
+  }
+
+  if (skeleton.constants.length > 0) {
+    const names = skeleton.constants;
+    if (names.length > 5) {
+      lines.push(`const: ${names.slice(0, 5).join(', ')} +${names.length - 5} more`);
+    } else {
+      lines.push(`const: ${names.join(', ')}`);
+    }
   }
 
   const hookParts = [];
-  if (skeleton.hooks.useState > 0) hookParts.push(`useState(${skeleton.hooks.useState})`);
+  if (skeleton.hooks.useState.length > 0) hookParts.push(`useState: ${skeleton.hooks.useState.join(', ')}`);
   if (skeleton.hooks.useCallback > 0) hookParts.push(`useCallback(${skeleton.hooks.useCallback})`);
   if (skeleton.hooks.useMemo > 0) hookParts.push(`useMemo(${skeleton.hooks.useMemo})`);
   if (skeleton.hooks.useRef > 0) hookParts.push(`useRef(${skeleton.hooks.useRef})`);
@@ -445,9 +502,9 @@ export const formatSkeletonForPrompt = (skeleton) => {
 
   if (skeleton.hooks.useEffect.length > 0) {
     const effects = skeleton.hooks.useEffect.map(eff => {
-      if (eff.deps === null) return `useEffect(∞):${eff.line}`;
-      if (eff.deps === '?') return `useEffect(?):${eff.line}`;
-      return `useEffect([${eff.deps.join(',')}]):${eff.line}`;
+      if (eff.deps === null) return `useEffect(∞)`;
+      if (eff.deps === '?') return `useEffect(?)`;
+      return `useEffect([${eff.deps.join(',')}])`;
     });
     hookParts.push(...effects);
   }
@@ -457,7 +514,11 @@ export const formatSkeletonForPrompt = (skeleton) => {
   }
 
   if (skeleton.classes.length > 0) {
-    lines.push(`classes: ${skeleton.classes.map(c => `${c.name}:${c.line}`).join(', ')}`);
+    const classList = skeleton.classes.map(c => {
+      const marker = c.exportMarker || '';
+      return `${c.name}${marker}:${c.line}`;
+    }).join(', ');
+    lines.push(`classes: ${classList}`);
   }
 
   if (skeleton.interfaces.length > 0 || skeleton.types.length > 0) {

package/src/parsers/python.js

@@ -17,7 +17,7 @@ export const extractSkeleton = (code, filePath = '') => {
     imports: [],
     functions: [],
     classes: [],
-    constants: 0,
+    constants: [],
   };
 
   // Collect decorators as we scan
@@ -126,9 +126,9 @@ export const extractSkeleton = (code, filePath = '') => {
     }
 
     // Top-level assignments (constants)
-    const assignMatch = line.match(/^[A-Za-z_]\w*\s*[=:]/) || line.match(/^[A-Za-z_]\w*\s*:/);
+    const assignMatch = line.match(/^([A-Za-z_]\w*)\s*[=:]/);
     if (assignMatch) {
-      skeleton.constants++;
+      skeleton.constants.push(assignMatch[1]);
       pendingDecorators = [];
       continue;
     }
@@ -172,10 +172,20 @@ export const formatSkeletonForPrompt = (skeleton) => {
   if (skeleton.functions.length > 0) {
     const funcList = skeleton.functions.map(f => {
       const deco = f.decorators.length > 0 ? `@${f.decorators[0]} ` : '';
-      return `${deco}${f.name}:${f.line}`;
+      const params = f.params ? `(${f.params})` : '()';
+      return `${deco}${f.name}${params}:${f.line}`;
     }).join(', ');
     lines.push(`fn: ${funcList}`);
   }
 
+  if (skeleton.constants.length > 0) {
+    const names = skeleton.constants;
+    if (names.length > 5) {
+      lines.push(`const: ${names.slice(0, 5).join(', ')} +${names.length - 5} more`);
+    } else {
+      lines.push(`const: ${names.join(', ')}`);
+    }
+  }
+
   return lines.join('\n');
 };

package/test/test.js

@@ -21,7 +21,7 @@ describe('babel parser', () => {
     assert.ok(skeleton.imports.length > 0);
     assert.ok(skeleton.components.length > 0);
     assert.ok(skeleton.functions.length > 0);
-    assert.strictEqual(skeleton.hooks.useState, 1);
+    assert.deepStrictEqual(skeleton.hooks.useState, ['data']);
     assert.strictEqual(skeleton.hooks.useEffect.length, 1);
   });
 });
@@ -35,7 +35,7 @@ describe('python parser', () => {
     assert.strictEqual(skeleton.imports.length, 4);
     assert.strictEqual(skeleton.functions.length, 3);
     assert.strictEqual(skeleton.classes.length, 2);
-    assert.ok(skeleton.constants >= 2);
+    assert.ok(skeleton.constants.length >= 2);
   });
 
   it('parses decorators', () => {