Adaptation Difference Ledger
Review adaptation differences and CSV edits against an explicit baseline using a three-way comparison with the current ledger.
The problem it solves
Adaptation Difference Ledger Adaptation Difference Ledger records reviewable differences between a source work and one or more adaptations. It keeps source and adaptation descriptions side by side, categorizes the change, records significance and evidence, and creates deterministic Markdown or JSON reports.
Who Adaptation Difference Ledger is for
- People who need a small, purpose-built utility instead of a broad platform.
- Users working with adaptations, comparison, fiction who want the documented v1.2.1 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Review adaptation differences and CSV edits against an explicit baseline using a three-way comparison with the current ledger.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.2.1
Capabilities below come from the current project README and release documentation.
Adaptation Difference Ledger records reviewable differences between a source work and one or more adaptations. It keeps source and adaptation descriptions side by side, categorizes the change, records significance and evidence, and creates deterministic Markdown or JSON reports.
Verified examples
Screenshots are shown only when the current README references a local source image. Otherwise, repository example files are linked directly.
Platforms and implementation
The public release claims only the cataloged platforms and technologies.
Supported platforms
- Windows
- macOS
- Linux
Built with
- Python
Changelog
Release notes from the canonical v1.2.1 source tag.
- Correct released documentation labels; package behavior is unchanged.
- Preserve the original v1.2.0 tags and artifacts. This patch supplies corrected documentation in new artifacts.
- Add
--baseline baseline.jsonto--import-csv edited.csv --format jsonfor three-way review against the current ledger.
- Add side-by-side HTML review with scene/chapter anchors and filters, plus previewed stable-ID CSV merging.
- Added regression coverage for the audited behavior and invalid inputs.
- Initial source/adaptation schema validation, category and significance summaries, filtered Markdown/JSON reports, examples, and automated tests.
Quick start
The shortest documented path into the current release.
Before running these source commands, download the v1.2.1 source archive, extract it, and open a terminal in the extracted project folder containing README.md. Follow the tagged README for required runtimes and any platform-specific setup.
Requires Python 3.10 or newer.
python -m pip install .
adaptation-ledger examples/ledger.json
adaptation-ledger examples/ledger.json --adaptation film --format jsonThe versioned JSON input defines one source, uniquely identified adaptations, and difference records. Categories include character, event, setting, timeline, theme, dialogue, ending, and other. Significance is explicitly supplied as minor, moderate, or major.
Use repeated --adaptation flags to focus a report and --output to write a new file. Existing outputs are refused.
Current limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
- The program organizes user-supplied observations; it does not watch, read, scrape, or judge the works.
- Significance is editorial metadata, not an objective score.
- Copyrighted quotations belong in the user's private input only when legally appropriate; examples use invented text.
- The ledger does not determine whether a creative change is good or bad.
Privacy and licensing
Review the actual data boundary before using a tool with sensitive inputs.
Privacy and safety
Markdown creates an evidence-oriented comparison by adaptation. JSON adds counts by category, significance, and adaptation. Processing is entirely local with no network requests, telemetry, AI, or content upload.
License and release
Adaptation Difference Ledger is published under MIT. The current cataloged release is v1.2.1, published 2026-10-16.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
Adaptation Difference Ledger v1.2.1
Use the tagged release for downloads and release notes. Use the repository for source, issues, contribution guidance, security reporting, and complete documentation.
Page source: current Forge catalog plus README and CHANGELOG from the canonical GitHub release tag. Fingerprint: a7568beaa6fd0a23.