FableCodex 0.5.1

FableCodex 0.5.1

Fixed

• Clarified codex-fable5 update output by showing the target ref before checkout changes.
• Warns when release-tag checkout may leave a git checkout in detached HEAD state.
• Prints post-update version details after update completes.

Verification

• CI passed on Python 3.11, 3.12, and 3.13.
• Local release checks passed before the release PR was merged.

FableCodex 0.5.0

FableCodex 0.5.0

Added

• Added codex-fable5 version to report the installed plugin version, paths, and git checkout state.
• Added codex-fable5 update to update a clean FableCodex checkout to the latest stable tag or an explicit ref.

Changed

• Documented the new version and update commands across all localized READMEs.
• Strengthened wrapper tests for dirty-checkout protection and prerelease tag filtering.

Verification

• CI passed on Python 3.11, 3.12, and 3.13.
• Local release checklist passed before the release PR was merged.

FableCodex 0.4.4

Summary

FableCodex 0.4.4 is a stability and maintainability release for the Codex Fable5 plugin.

Changed

• Split the monolithic script test suite into focused modules while keeping tests/test_scripts.py as a compatibility placeholder.
• Extracted shared state, locking, JSON, and event helpers for the goal and findings ledgers into codex_fable_state.py.
• Strengthened CI workflow validation so the pinned FABLE-5 source fetch and coverage --source validation stay semantically linked.
• Updated contributor, release, and CI verification commands to compile the new shared helper module.
• Updated README install examples to --ref v0.4.4.

Verification

• CI passed on Python 3.11, 3.12, and 3.13.
• Local release PR verification ran 34 unittest tests successfully.
• Coverage matrix validation reports 71 rows and valid status.

v0.4.3

Patch release for the Codex Fable5 plugin.

Changed:

• Condensed the Codex Fable5 skill body around non-negotiables, a core loop, and a routing map so the primary execution rules stay more salient.
• Strengthened release and test validation around pinned FABLE-5 source coverage and SKILL.md routing-map structure.

Validation:

• Unit test suite: 32 tests passed.
• Script compilation, shell wrapper syntax, coverage matrix validation, and whitespace checks passed.
• Pinned upstream FABLE-5 source coverage validated at 71/71 headings.

v0.4.2

Patch release for the Codex Fable5 plugin.

Changed:

• Reworked README guidance around quick start, goal ledgers, findings gates, command reference, local state, and explicit limitations.
• Added localized README files for Korean, Japanese, Simplified Chinese, and Traditional Chinese (Taiwan).
• Added explicit Fable-to-Codex conversion priorities, do-not-convert boundaries, and provider availability notes.

Fixed:

• Hardened goal and findings ledgers against malformed state, concurrent findings writes, and failed forced plan replacement.
• Made coverage checking tolerate source markdown that starts below an H1 heading.
• Aligned release, contributor, README, and provider-bridge examples with the current package layout and verification commands.
• Corrected the coverage matrix and CI validation so it checks the pinned upstream FABLE-5 source.

FableCodex 0.4.1

Fixed

• Fixed goals create --force so stale findings from a replaced plan are archived before they can block the new final checkpoint.
• Fixed malformed .codex-fable5 ledger JSON handling so CLI commands report controlled codex-fable5 errors instead of Python tracebacks.

Validation

• python3 -m unittest discover -s tests -v passed: 21 tests OK.
• python3 -m py_compile ... passed.
• Wrapper sh -n checks passed for codex-fable5, codex-findings, and codex-goals.
• Coverage matrix validation passed with 71 rows.

v0.4.0

Highlights

FableCodex v0.4.0 adds an evidence-backed findings gate to the existing Fable-style goal workflow. The new flow is meant for review-sensitive work where accepted review issues should not be lost before final completion.

What's New

• Added codex_findings.py, a local findings ledger stored under .codex-fable5/.
• Added a single user-facing terminal wrapper: codex-fable5.
• Added codex-fable5 findings ... commands for adding, listing, resolving, rejecting, blocking, reopening, and gating findings.
• Added codex-fable5 goals ... as the terminal entrypoint for the existing goal ledger.
• Kept codex-findings and codex-goals as advanced aliases.

Findings Gate Behavior

• Findings are evidence-backed review or verification issues, not brainstorming notes.
• New findings attach to the active goal automatically when a goal is in progress.
• A finding cannot be resolved without resolution evidence and verification evidence.
• Final goal checkpoints now fail while open or blocked findings remain.
• codex-fable5 findings gate exits non-zero when blocking findings remain, so it can be used in manual release or review workflows.

User-Facing Commands

From a checkout:

export PATH="$PWD/plugins/codex-fable5/bin:$PATH"
codex-fable5 status

Track a finding:

codex-fable5 findings add \
  --title "Missing final verification" \
  --evidence "Review found no command output proving the final state."
codex-fable5 findings next
codex-fable5 findings resolve \
  --id F001 \
  --evidence "Added final verification." \
  --verify-evidence "Tests passed and final status was checked."
codex-fable5 findings gate

In Codex chat, users can simply ask:

Use $codex-fable5 to implement this and track findings before final completion.

When To Use It

Use findings tracking for multi-file work, migrations, security-sensitive changes, failed or uncertain verification, or review/sub-agent feedback with concrete evidence.

Do not use it for simple edits or routine factual answers.

Updating

Stable install:

codex plugin marketplace remove fablecodex
codex plugin marketplace add baskduf/FableCodex --ref v0.4.0
codex plugin remove codex-fable5@fablecodex
codex plugin add codex-fable5@fablecodex

Development install tracking main:

codex plugin marketplace upgrade fablecodex
codex plugin remove codex-fable5@fablecodex
codex plugin add codex-fable5@fablecodex

Restart Codex after updating the plugin.

Validation

• python3 -m unittest discover -s tests -v
• python3 -m py_compile plugins/codex-fable5/skills/codex-fable5/scripts/codex_findings.py plugins/codex-fable5/skills/codex-fable5/scripts/codex_goals.py plugins/codex-fable5/skills/codex-fable5/scripts/fable_coverage.py plugins/codex-fable5/skills/codex-fable5/scripts/make_litellm_config.py tests/test_scripts.py
• sh -n plugins/codex-fable5/bin/codex-fable5
• sh -n plugins/codex-fable5/bin/codex-findings
• sh -n plugins/codex-fable5/bin/codex-goals
• python3 plugins/codex-fable5/skills/codex-fable5/scripts/fable_coverage.py

FableCodex 0.3.1

What this project is

FableCodex is a Codex plugin marketplace package that brings Fable-style operating habits into Codex workflows. It is not a model clone, model unlock, or replacement for Fable 5. It packages Codex-native guidance, references, examples, and helper scripts that make Codex work more deliberately: inspect first, keep evidence, verify results, and report clearly.

Workflow this release supports

The core workflow is a tool-first Codex loop:

1. Inspect the current repo, files, tools, and task context before making claims.
2. Break multi-step work into explicit stories when useful.
3. Capture concrete evidence at each checkpoint.
4. Reproduce unknown failures before choosing a fix.
5. Keep competing hypotheses for debugging until evidence narrows them.
6. Run the relevant tests, checks, rendered previews, or connector readbacks before saying the work is done.
7. Summarize what changed, what was verified, and any remaining risk.

This release also keeps the boundary clear: prompt and skill guidance can improve operating discipline, but it cannot reproduce another model's weights, hidden runtime, context window, training, or provider-side behavior.

What changed in 0.3.1

Fixed

• Fixed the goal ledger so failed or blocked stories are never reported as complete.
• Reopened failed or blocked stories through next before advancing later pending stories.

Changed

• Standardized local verification, release, and provider bridge examples on python3.
• Strengthened marketplace plugin path tests to verify every entry resolves inside the repository.

Added

• OSS community baseline with contribution, conduct, governance, security, support, and roadmap docs.
• GitHub issue templates, pull request template, and CI workflow.
• Release checklist, CODEOWNERS, repository hygiene ignores, and GitHub Actions update automation.
• A test that verifies the plugin manifest version is documented in the changelog.

Verification

• python3 -m unittest discover -s tests -v
• python3 -m py_compile plugins/codex-fable5/skills/codex-fable5/scripts/codex_goals.py plugins/codex-fable5/skills/codex-fable5/scripts/fable_coverage.py plugins/codex-fable5/skills/codex-fable5/scripts/make_litellm_config.py tests/test_scripts.py
• python3 plugins/codex-fable5/skills/codex-fable5/scripts/fable_coverage.py

Install

Choose one marketplace source.

Stable release:

codex plugin marketplace add baskduf/FableCodex --ref v0.3.1
codex plugin add codex-fable5@fablecodex

Development version:

codex plugin marketplace add baskduf/FableCodex --ref main
codex plugin add codex-fable5@fablecodex

Local development:

codex plugin marketplace add ~/Desktop/FableCodex
codex plugin add codex-fable5@fablecodex

Restart Codex after installing or updating the plugin.

Start using it

Use $codex-fable5 to run this task with a Fable-style, tool-first Codex workflow.