citation-cli

Cite, don't import — track cited code in package.json with Quote / Paraphrase / Synthesize semantics.

Install

npm install -g citation-cli

Or as a dev dependency:

npm install --save-dev citation-cli

Usage

Record a citation — scans files in the target directory and records each as a quote with its sha256 hash in package.json:

cite add my-pkg \
  --source ../packages/ref \
  --version 1.0.0 \
  --target ./src/clients/my-pkg

Check integrity of cited files — compares sha256 hashes of quoted files, reports drift or missing files:

cite check

Check a specific package:

cite check my-pkg

File status

Files are tracked with one of three statuses:

• quote — exact copy, sha256 recorded, checked for drift
• paraphrase — intentionally modified, skipped during check
• synthesize — merged into an existing file, skipped during check

Migrating from assimilai

If you have a legacy "assimilai" block in package.json, migrate it to the v2 "citation" schema with:

cite migrate

Use --dry-run to preview the translation without writing.

Documentation

• Specification
• Website