Spoiler-Safe Character Guide
Validate character facts and introductions, gate aliases by milestone, and add a printable searchable HTML guide with boundary previews.
The problem it solves
Spoiler-Safe Character Guide [](https://github.com/loganpendragonmultiverse/spoiler-safe-character-guide/actions/workflows/ci.yml)
Who Spoiler-Safe Character Guide is for
- People who need a small, purpose-built utility instead of a broad platform.
- Users working with writing, characters, spoiler control who want the documented v1.1.0 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Validate character facts and introductions, gate aliases by milestone, and add a printable searchable HTML guide with boundary previews.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.1.0
Capabilities below come from the current project README and release documentation.
[](https://github.com/loganpendragonmultiverse/spoiler-safe-character-guide/actions/workflows/ci.yml)
Generate character references limited to facts revealed through a chosen story milestone. The command runs locally, uses explicit UTF-8 JSON input, and produces deterministic JSON or Markdown reports without modifying the supplied source material.
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
What changed in v1.1.0
Validate character facts and introductions, gate aliases by milestone, and add a printable searchable HTML guide with boundary previews.
spoiler-character-guide examples/sample.json --format html --output guide.htmlEach character may set introduced_at (default 0) and aliases as objects with name and milestone. Facts require text and a nonnegative integer milestone. Future character names, aliases and facts are omitted from every export; unsupported extra fields are also omitted. The HTML guide searches only visible content and can preview earlier boundaries up to the exported ceiling. It cannot reveal later material because that material is absent from the file. Use browser Print for a clean printable guide. Introduction boundaries and fact accuracy remain author-controlled.
Quick start
The shortest documented path into the current release.
python -m pip install .
spoiler-character-guide examples/sample.json
spoiler-character-guide examples/sample.json --format json --output report.jsonThe example documents the complete v1 input shape. Markdown is intended for immediate review; JSON preserves structured evidence for scripts and later comparison. An existing output file is never overwritten.
Current limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
Spoiler safety depends on accurate milestone numbering in the supplied source data; the tool does not infer canon or read manuscripts.
Privacy and licensing
Review the actual data boundary before using a tool with sensitive inputs.
Privacy and safety
All character data stays local.
Python 3.10 or newer is supported on Windows, macOS, and Linux. The package has no runtime dependencies, telemetry, account, or hosted service.
License and release
Spoiler-Safe Character Guide is published under MIT. The current cataloged release is v1.1.0, published 2026-09-07.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
Spoiler-Safe Character Guide v1.1.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 local repository. Fingerprint: 95a681e3534a6251.