Skip to content

Clarify ledger artifact identity and roadmap priorities#43

Merged
WhatsYourWhy merged 1 commit into
mainfrom
codex/review-and-update-ledger_schema-and-roadmap
Jan 28, 2026
Merged

Clarify ledger artifact identity and roadmap priorities#43
WhatsYourWhy merged 1 commit into
mainfrom
codex/review-and-update-ledger_schema-and-roadmap

Conversation

@WhatsYourWhy

Copy link
Copy Markdown
Owner

Motivation

  • Make artifact identity and path semantics explicit to avoid future tooling disagreements about what constitutes the "same artifact".
  • Tighten guidance for RUN_FAIL traces to prevent nondeterministic data from leaking into semantic comparisons.
  • Reflect that validator/diff tooling and schema discipline are first-class near-term priorities and ensure the manifest is explicitly derived from the ledger.

Description

  • In docs/LEDGER_SCHEMA.md declare that artifact.logical_name defines semantic identity and that artifact.path must be a deterministic pure function of artifact identity, and add rules to normalize or omit stack traces for RUN_FAIL entries.
  • In docs/ROADMAP.md update Near-term phases to: build deterministic runtime + ledger (Phase 0), deliver validator completeness and semantic diff tooling (Phase 1), and add branching and failure semantics (Phase 2).
  • In docs/DESIGN.md add the line that the ledger is the source of truth and the manifest must never contain information not reconstructible from the ledger.

Testing

  • None — these are documentation-only changes and no automated tests were run.

Codex Task

@WhatsYourWhy WhatsYourWhy merged commit 614c482 into main Jan 28, 2026
2 checks passed
@WhatsYourWhy WhatsYourWhy deleted the codex/review-and-update-ledger_schema-and-roadmap branch January 28, 2026 10:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant