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.