prismlens

Code-analysis library for TypeScript/JavaScript repos — extracted from the BLUE/AMBER/GREEN layers of the Atlas blueprint-tool.

Status: pre-release (strangler-fig phase 1)
API is not stable. Breaking changes can occur without a major version bump until v1.0.

What is prismlens?

prismlens provides three analysis layers:

• BLUE (scan / GRAPHITE) — walks a TypeScript repo and produces a structured blueprint dataset: file metrics, import graphs, cycle detection, JSDoc tags, git history, coverage, and more.
• AMBER — business-capability registry: maps files to named capabilities, supports LLM-assisted documentation and bulk analysis.
• GREEN — analytics layer: cross-cutting insights, custom queries, and trend detection over blueprint data.

Install (pre-release — git URL)

npm install git+https://github.com/dadenjo/prismlens.git#v0.1.0

Usage (minimal)

import { runScan } from "prismlens";

const output = await runScan("/path/to/your/repo");
console.log(output.files.length, "files scanned");

Public API

See src/index.ts for the full export surface. Sub-namespaces:

• amber.* — AMBER types and AI functions
• green.* — GREEN analytics
• Top-level exports: types, scan functions, astEnrich, historyUtils, blueprintConfig

Atlas-coupling (Wave 1 → Wave 2)

prismlens v0.1.0 is a 1:1 mirror of the Atlas monorepo's blueprint-tool/ directory. Four coupling points exist (all stubbed, documented, and non-breaking):

See docs/audits/prismlens-migration.md for details and the Wave 2 decoupling plan.

Build

npm run build   # ESM + CJS + .d.ts in dist/
npm test        # vitest, 944 tests
npm run typecheck

License

UNLICENSED (proprietary, pre-release)