Did This Character Know That? Matrix
Review character knowledge across scenes, with optional explicit event order for knowledge uses and telling-character warnings.
The problem it solves
Did This Character Know That? Matrix Did This Character Know That? Matrix maps revelations against characters and ordered scenes. It shows when knowledge was recorded and flags supplied scene uses that occur before the character's recorded learning point.
Who Did This Character Know That? Matrix is for
- People who need a small, purpose-built utility instead of a broad platform.
- Users working with writing, characters, revelations who want the documented v1.3.0 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Review character knowledge across scenes, with optional explicit event order for knowledge uses and telling-character warnings.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.3.0
Capabilities below come from the current project README and release documentation.
Did This Character Know That? Matrix maps revelations against characters and ordered scenes. It shows when knowledge was recorded and flags supplied scene uses that occur before the character's recorded learning point.
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.3.0 source tag.
- Explain unordered and explicitly ordered scene timing accurately in HTML reports.
- Support validated explicit intra-scene order across knowledge events and uses.
- Evaluate use and telling-character warnings at the supplied event position.
- Preserve unordered scene semantics and cutoff behavior; reject reversed scene comparisons and make change ordering deterministic.
- Add an interactive character-by-scene evidence grid, explicit knowledge-source relationships and alternate scene-order comparisons.
- Added regression coverage for the audited behavior and invalid inputs.
- Added confirmed, inferred, suspected, false-belief, corrected, and revoked knowledge states.
- Added evidence tracking, per-character summaries, and between-scene comparisons.
- Added typed premature-use, contradictory-belief, and missing-evidence warnings.
- Added versioned scenes, characters, revelations, learning events, and uses.
- Added scene-bounded knowledge matrices.
- Added evidence-backed review flags for uses before recorded knowledge.
Quick start
The shortest documented path into the current release.
Before running these source commands, download the v1.3.0 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.
python -m pip install .
knowledge-matrix examples/novel.json
knowledge-matrix examples/novel.json --through arrival --format json
knowledge-matrix examples/novel.json --compare-from arrival --through letterInputs explicitly define scenes, characters, revelations, knowledge events, and optional uses. A scene boundary hides later revelations, learning events, and uses. Output is deterministic Markdown or JSON and existing files are refused.
Version 1.1 accepts a state on every knowledge event: confirmed, inferred, suspected, false-belief, corrected, or revoked. Add evidence to identify the source scene or note. --compare-from reports state changes between two scenes, and the output includes per-character summaries plus typed review warnings.
The tool validates author-maintained notes; it does not extract facts from prose or prove that a continuity issue exists. Missing knowledge records can create false positives, while ambiguous dialogue may not imply knowledge. Requires Python 3.10 or newer.
Part of the Logan Pendragon Forge open-source collection. Licensed under the MIT License.
Current limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
The current v1.3.0 release is bounded by the behavior documented in its README and changelog. It does not claim unsupported platforms, automatic interpretation, or results beyond the evidence it produces.
Privacy and licensing
Review the actual data boundary before using a tool with sensitive inputs.
Privacy and safety
No privacy behavior beyond the current repository documentation is claimed. Review the source, security policy, and input/output behavior before using sensitive material.
License and release
Did This Character Know That? Matrix is published under MIT. The current cataloged release is v1.3.0, published 2026-10-15.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
Did This Character Know That? Matrix v1.3.0
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: ee149d3f3f15f91a.