Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (code-symphony) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

CodeSymphony

Turn any codebase into music. CodeSymphony walks your project, analyzes its structure (functions, branching, depth, entropy), and composes a multi-voice score in the genre that fits. Everything runs on your machine — no code ever leaves your computer.

Install & Run

npx code-symphony

A local HTTP server starts at http://localhost:4173 and your browser opens. Pick a project folder and press Analyze. The first run takes a few seconds; reopening the same project is instant (disk-cached).

Landing page / version info: https://code-symphony-landing.web.app

Features

Persistent recent projects — pick from your recent list on startup (VSCode-style). --no-recent to skip.
Per-project disk cache keyed by file mtime + .gitignore + package version → same project = instant re-open
Deterministic output — same code, same music, every time (seeded motif + modulation)
Music-theory-aware mapping (v0.4+):
- Strict weak-beat consonance — melody stays on chord tones except in genuine passing/neighbor contexts
- Appoggiatura resolution — dissonance always resolves to the nearest chord tone
- V→I cadence with leading-tone gesture
- Bridge/chorus modulation (relative minor/major, whole-step lift) for epic genres
- Parallel 5th / 8ve avoidance in harmony
- Walking bass with chromatic approach to the next bar's root (jazz)
9 genres — classical, jazz, rock, ambient, electronic, lofi, folk, blues, cinematic (auto-picks based on project metrics, or force with --genre)
Playback — Web Audio, per-voice toggles, follow-playback, MIDI / JSON export
Change project button without restart; Re-analyze on file changes
Update banner checks for new versions in the background

CLI Options

Flag	Default	What it does
`--port <n>`	`4173`	HTTP port (falls back to a free port if busy)
`--root <path>`	last used	project root to analyze
`--genre <name>`	auto	force a genre
`--max-files <n>`	`500`	max files to scan
`--max-bytes <n>`	`10 MB`	max total bytes
`--no-open`		do not auto-open the browser
`--no-recent`		ignore the recent-project list on startup
`--prune`		purge `~/.code-symphony/cache` and exit
`--json`		one-shot analysis to stdout (CI-friendly, requires `--root`)

Privacy

All analysis, rendering, and playback happen locally. No code, file paths, or results are transmitted. The landing page (above) uses standard Firebase Hosting, which logs IP/User-Agent of visitors — that's the only web footprint.

How it works

Scanner — walks the project, respects .gitignore + a sane blacklist (node_modules, dist, .git, etc.)
Analyzer — AST metrics (via @babel/parser for JS/TS) or regex token fallback for other languages
Mapper — deterministic code-to-music: language → root, depth/branching → mode & motif contour, functions/classes → form shape
Web UI — VexFlow score + Web Audio synthesis + MIDI/JSON export

Storage

~/.code-symphony/
├── config.json       # recent projects list
└── cache/<hash>/
    ├── meta.json     # fingerprint + createdAt
    ├── analysis.json # genre-independent analysis
    └── score-*.json  # one per genre

Prune manually with code-symphony --prune, or the disk cache self-prunes past 500 MB at startup.

License

MIT