ccap-kernel

library0.2.0jsnpmunverified

CCAP-Kernel (v0.2.0) is an AI-native semantic compiler that compresses large codebases into high-entropy semantic maps using Spectral Graph Theory and Minimum Description Length (MDL), achieving over 95% token savings. It is developed by Reack and released under MIT license. Key differentiators include multi-model token budgeting for OpenAI/Claude/Gemini, path-agnostic linking for cross-platform isomorphism, ghost link detection for architectural debt, and calibrated auditing. The project is in early alpha stage with rapid development (moving from v0.1.x to v0.2.0 within months). It targets AI-assisted software engineering workflows by providing a progressive precision workflow from global navigation to surgical patching.

devops ai-ml

npm install ccap-kernel

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CCAP-KERNEL

ccap-kernel

devopsjavascriptv0.2.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ccap-kernel

✓ import { semanticCompress } from 'ccap-kernel'

This package is intended as a CLI tool (npx ccap-kernel) and does not export a direct JS API in v0.2.0. Use the command line instead.

ccap

✓ npx ccap-kernel --help

Primary usage via npx. The package may expose a programmatic API in future versions.

Shows how to analyze a codebase into a semantic map and apply a surgical patch, plus simulate token budgeting for a specific AI model.

npx ccap-kernel analyze --path ./src --output map.json npx ccap-kernel patch --target map.json --symbol myFunction --code 'new implementation' # Alternatively with token budget simulation: npx ccap-kernel budget --model gpt-4o --map map.json

Debug

Known issues

breakingv0.2.0 changes the output format of semantic maps; maps from v0.1.x are not compatible.

fix

Re-run analysis with v0.2.0 to regenerate maps.

affects: >=0.1.0 <0.2.0

deprecatedThe `--legacy` flag for Windows path normalization is deprecated and will be removed in v0.3.0.

fix

Use the default path-agnostic linker; remove `--legacy` flag.

affects: >=0.2.0

gotchaCLI commands require Node.js >=18.x; older versions will fail silently.

fix

Ensure Node.js version is 18 or higher.

affects: >=0.2.0

gotchaThe `budget` command currently only supports OpenAI, Claude, and Gemini; using an unsupported model name will produce no output.

fix

Use one of: 'gpt-4o', 'claude-3.5', 'gemini-1.5'.

affects: 0.2.0

deprecatedThe `--verbose` flag is deprecated; use `--log-level debug` instead.

fix

Replace `--verbose` with `--log-level debug`.

affects: >=0.2.0

gotchaGhost link detection requires a valid .git directory; running outside a git repository will skip the feature.

fix

Initialize a git repository or use `--no-ghost-link` to suppress.

affects: >=0.2.0

breakingv0.1.x used JSON maps by default; v0.2.0 switches to a custom binary format for performance. JSON output requires `--format json`.

fix

Add `--format json` to commands expecting JSON output, or update tools to handle binary format.

affects: >=0.2.0

Errors

Common errors & fixes

Error: Cannot find module 'ccap-kernel'

Attempting to import/require the package as a library instead of using the CLI.

fix

Use `npx ccap-kernel` or install globally with `npm i -g ccap-kernel` and run as a command.

SyntaxError: Unexpected token '.'

Running an older Node.js version (<18) that doesn't support modern JavaScript syntax used by the CLI.

fix

Upgrade Node.js to version 18 or later.

Error: ENOENT: no such file or directory, open 'ccap-config.json'

The CLI requires a configuration file (ccap-config.json) in the project root for some commands.

fix

Create a ccap-config.json file with appropriate settings, or run `npx ccap-kernel init` to generate one.

Warning: Unsupported model 'gpt-3.5'. Falling back to default.

Only OpenAI GPT-4o, Claude 3.5, and Gemini 1.5 are supported for budget simulation.

fix

Use one of the supported model names: gpt-4o, claude-3.5, gemini-1.5.

Upgrade

Version history

0.2.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

18 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/Reack/ccap-kernel ↗

packageccap-kernel ↗

homepagehttps://github.com/Reack/ccap-kernel#readme ↗