@principal-ai/codebase-composition

Codebase decomposition into semantic layers for the Principal AI ecosystem.

Overview

This package decomposes and composes codebases into structured semantic layers, enabling sophisticated analysis through layer-by-layer examination of project architecture.

Key Features

- Package Layer - Discover and analyze package.json, requirements.txt, Cargo.toml, etc.
- Framework Layer - Identify React, Vue, Angular, and other frameworks
- Type Layer - Extract TypeScript types and interfaces
- Version Control Layer - Git integration for ignore patterns and file filtering
- File Type Layer - Categorize and analyze different file types
- Dependency Layer - Track and analyze project dependencies

Installation

``bash
bun install @principal-ai/codebase-composition
`

Usage

`typescript
import { PackageLayerModule, FrameworkLayerModule } from '@principal-ai/codebase-composition';
import { FileTree } from '@principal-ai/repository-abstraction';

// Use layer modules to analyze your codebase
const packageLayer = new PackageLayerModule();
const frameworkLayer = new FrameworkLayerModule();

// Analyze a file tree
const analysis = await packageLayer.analyze(fileTree);
`

Dependencies

- @principal-ai/repository-abstraction - For tree abstractions
- ignore - Gitignore pattern matching
- js-toml - TOML parsing
- pip-requirements-js - Python requirements parsing
- typescript - Type extraction

Development

`bash


Install dependencies

bun install

Build the package

bun run build

Run tests

bun test

Type checking

bun run typecheck

Watch mode for development

bun run dev
``

License

Private package - not for public distribution.