scan

name	scan
description	Run cnbl scan on a target repo to classify every file by kind (domain logic, port, adapter, script, spec, config, glue, discard). Outputs JSONL. Use when the user wants to "scan a repo", "see what's in a project", or "classify files".
model	haiku
effort	low
allowed-tools	["Bash","Read"]

scan

Run the scanner on a target repo and display the classification report.

Usage

cnbl scan <repo-path> --output /tmp/cnbl-scan.jsonl --report

Output

JSONL stream where each line is a HarvestItem:

{
  "rel_path": "src/model.py",
  "lang": "python",
  "kind": "domain_logic",
  "size_bytes": 1234,
  "notes": null
}

Kinds

Kind	Meaning
domain_logic	Types, structs, classes worth porting
port	Interfaces, traits, protocols
adapter	Infrastructure implementations
entrypoint	main files, cmd/ directories
test_harness	Test files (discarded during planning)
script	Shell/Nu scripts
spec	Markdown docs
config	TOML/YAML/JSON/BAML config files
glue	Re-export files (lib.rs, init.py, mod.rs)
discard	Unrecognized or fixture files

Report

With --report, a summary table prints to stderr showing counts per kind and the languages found in each category. Use this to get a quick overview before running plan.

Notes

• Files > 512KB are skipped (logged to stderr)
• Tree-sitter grammars: Python, Go, Shell, Rust
• TypeScript classified by lang only (no grammar)
• Ignored dirs: .git, node_modules, target, pycache, .venv, dist