Skip to content

fix: align release version metadata - #6

Merged
philngt merged 1 commit into
mainfrom
fix/release-version-1.4.0
Aug 20, 2026
Merged

fix: align release version metadata#6
philngt merged 1 commit into
mainfrom
fix/release-version-1.4.0

Conversation

@philngt

@philngt philngt commented Aug 20, 2026

Copy link
Copy Markdown
Owner

Implementation

Summary / Context

Align the repository metadata with the intended 1.4.0 release.

This change:

  • Updates the canonical project version in pyproject.toml from 1.3.2 to 1.4.0.
  • Removes the stale hardcoded version example from the release workflow input description.
  • Replaces the runtime test's fixed 1.3.2 assertions with checks that:
    • Read the version from pyproject.toml
    • Validate its SemVer-compatible format
    • Confirm runtime version resolution returns the same value

Problem & Why

The release workflow was dispatched with version 1.4.0, but the canonical project metadata still declared 1.3.2.

The release-metadata job therefore stopped immediately with:

ERROR: release version 1.4.0 != pyproject version 1.3.2

The runtime test also hardcoded 1.3.2, meaning every legitimate version bump required an additional test rewrite.

This fix makes pyproject.toml the canonical release-version source and keeps the test focused on format and consistency rather than a specific historical version.

## Test Notes

- [x] python scripts/test_lint_wiki.py
- [x] python scripts/test_atomic_write.py
- [x] python scripts/test_detect_repetition.py
- [x] python scripts/lint-wiki.py --all-workspaces --wiki-root .
- [ ] N/A (reason):

Additional checks:

- [x] Release metadata resolves to 1.4.0
- [x] python3 -m scripts.cli --version returns contextd 1.4.0
- [x] python3 scripts/test_contextd_runtime.py — 46/46 passed
- [x] python3 scripts/test_artifact_schemas.py
- [x] python3 scripts/check-patterns-index.py
- [x] python3 -m compileall -q scripts
- [x] Strict all-workspace wiki lint passed

## Related Issues

Relates to the failed 1.4.0 release workflow run. No linked GitHub issue.

## Docs / Workflow Impact

- [x] Updated docs because behavior/workflow changed
- [ ] No docs update needed (reason):

The workflow_dispatch input description now explains that the release version must match pyproject.toml and must not include the v prefix, without embedding a version example that
becomes stale after each release.

## Wiki-specific checks

- [x] Preserved workspace isolation
- [x] No cross-workspace knowledge mixing
- [x] Avoided duplicate docs/patterns

No workspace knowledge, retrieval behavior, patterns, or contracts were changed.

## Project Spirit Check

- [x] Change reinforces knowledge-first workflow (contracts/patterns before invention)
- [x] Contributor experience stays simple and practical (no unnecessary complexity)
- [x] Project voice and intent remain consistent across docs/workflows
- [x] If trade-offs were made, rationale is stated clearly in this PR

Trade-off rationale:

The runtime test no longer pins one exact release number. Instead, it validates the version format and verifies that runtime resolution matches the canonical pyproject.toml value. This
preserves release safety while removing repetitive test maintenance for future version bumps.

@philngt
philngt merged commit cdec73c into main Aug 20, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant