Release 0.42.1 changes from dev to main by djm81 · Pull Request #418 · nold-ai/specfact-cli

djm81 · 2026-03-17T19:14:16Z

Description

Promotes the current dev line to main for the 0.42.1 patch release, including the merged dev changes since release PR #411 (0.41.0):

the module-migration-11-project-codebase-ownership-realignment command-surface realignment that keeps specfact code import as the canonical brownfield import path and tightens project vs codebase ownership
the code-review-09-f4-automation-upgrade repository-owned pre-commit integration for specfact code review run, plus the related reward-ledger and house-rules documentation updates
CI and test-environment fallback hardening so release/test workflows install missing lint/type/pytest tooling directly and avoid broken cached Hatch environments

This release also includes the corresponding OpenSpec artifacts, changelog/version updates, prompt/template alignment, and regression coverage needed to keep the grouped command model and review workflow coherent.

Fixes #393, #408

New Features: release aggregation PR for already-merged dev work

Contract References: No new core @icontract decorators are introduced specifically for this release PR. The shipped changes focus on command ownership realignment, repository pre-commit review automation, CI fallback behavior, docs/prompt updates, and regression coverage.

Type of Change

Please check all that apply:

🐛 Bug fix (non-breaking change which fixes an issue)
✨ New feature (non-breaking change which adds functionality)
💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
📚 Documentation update
🔒 Contract enforcement (adding/updating @icontract decorators)
🧪 Test enhancement (scenario tests, property-based tests)
🔧 Refactoring (code improvement without functionality change)

Contract-First Testing Evidence

Required for all changes affecting CLI commands or public APIs:

Contract Validation

Runtime contracts added/updated (@icontract decorators on public APIs)
Type checking enforced (@beartype decorators applied)
CrossHair exploration completed: hatch run contract-test-exploration
Contract violations reviewed and addressed

Test Execution

Contract validation: hatch run contract-test-contracts ✅
Contract exploration: hatch run contract-test-exploration ✅
Scenario tests: hatch run contract-test-scenarios ✅
Full test suite: merged dev work added targeted CLI/runtime/script regression coverage and release-CI hardening ✅

Test Quality

CLI commands tested with typer test client
Edge cases covered with Hypothesis property tests
Error handling tested with invalid inputs
Rich console output verified manually or with snapshots

How Has This Been Tested?

Contract-First Approach: TDD evidence was captured for the shipped changes under openspec/changes/module-migration-11-project-codebase-ownership-realignment/TDD_EVIDENCE.md, openspec/changes/code-review-09-f4-automation-upgrade/TDD_EVIDENCE.md, and the related code-review change folders. The release range also adds unit/integration coverage for command ownership, prompt validation, smart-test coverage, and the pre-commit code-review helper script.

Manual Testing

Tested CLI commands manually
Verified rich console output
Tested with different input scenarios
Checked error messages for clarity

Automated Testing

Contract validation passes
Property-based tests cover edge cases
Scenario tests cover user workflows
All existing tests still pass

Test Environment

Python version: 3.12
OS: Ubuntu Linux

Checklist

My code follows the style guidelines (PEP 8, ruff format, isort)
I have performed a self-review of my code
I have added/updated contracts (@icontract, @beartype)
I have added/updated docstrings (Google style)
I have made corresponding changes to documentation
My changes generate no new warnings (basedpyright, ruff, pylint)
All tests pass locally
I have added tests that prove my fix/feature works
Any dependent changes have been merged

Quality Gates Status

Type checking ✅ (hatch run type-check)
Linting ✅ (hatch run lint)
Contract validation ✅ (hatch run contract-test-contracts)
Contract exploration ✅ (hatch run contract-test-exploration)
Scenario tests ✅ (hatch run contract-test-scenarios)

Screenshots/Recordings (if applicable)

specfact code import --help remains the canonical grouped import surface after the ownership realignment.
The repository pre-commit flow now runs specfact code review run through scripts/pre_commit_code_review.py and scripts/pre-commit-smart-checks.sh.

* feat: add debug logs under ~/.specfact/logs with operation metadata - User-level log dir: get_specfact_home_logs_dir() (~/.specfact/logs, 0o755) - debug_print() routes to console and rotating specfact-debug.log when --debug - debug_log_operation() for structured metadata (ADO, GitHub, backlog, init) - CLI init_debug_log_file() when --debug; help text updated Closes #158 OpenSpec change: add-debug-logs-specfact-home Co-authored-by: Cursor <cursoragent@cursor.com> * Add debug logging for selected commands at first * release: 0.26.13 - debug log parity for upgrade, versions and changelog - Log upgrade success (up to date) to ~/.specfact/logs/specfact-debug.log - Bump version to 0.26.13; sync pyproject.toml, setup.py, src/__init__.py, specfact_cli/__init__.py - CHANGELOG: 0.26.13 Fixed entry for upgrade debug parity Co-authored-by: Cursor <cursoragent@cursor.com> * Remove pr markdown --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com> Co-authored-by: Cursor <cursoragent@cursor.com>

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com> Signed-off-by: Dom <39115308+djm81@users.noreply.github.com>

#164) * Improving error logging capabilities * small fix on changelog * Archived change --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

) (#167) * feat: backlog refine --ignore-refined and --id, startup docs (fixes #166) OpenSpec change: improve-backlog-refine-and-cli-startup. Adds --ignore-refined/--no-ignore-refined, --id <issue-id>; helper _item_needs_refinement; interactive refinement prompt section; version 0.26.15. * Add change for this branch and improve change create workflow * Improve refinement prompt and add specification feedback, update docs and add backlog refinement tutorial * Fix spec update and tasks * Improve pr orchestrator pipeline triggers --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

…tems view (#174)

Signed-off-by: Dom <39115308+djm81@users.noreply.github.com>

- Replace empty except with debug_log_operation in _load_standup_config and _load_backlog_config (correct signature: operation, target, status, error) - Add dim console message in sprint end date parse except block - Gate summarize prompt description/comments on --comments; add include_comments to _build_summarize_prompt_content and call site - Add test for metadata-only summarize when include_comments=False; update existing test to pass include_comments=True Co-authored-by: Cursor <cursoragent@cursor.com>

* feat: CLI modular command registry and lazy load (arch-01) Co-authored-by: Cursor <cursoragent@cursor.com> * Add missing exports * Fix lazy loading review findigns * Removed example package and fixed tests * Fix test failures and lazy load logic for modules * Fix tests --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com> Co-authored-by: Cursor <cursoragent@cursor.com>

* fix: use POST instead of PATCH for ADO work item creation Azure DevOps API requires POST (not PATCH) for creating work items. Also fixed category grouping to always register group commands. Made-with: Cursor * docs: add changelog entry for ADO POST fix Made-with: Cursor * chore: bump version to 0.40.4 Made-with: Cursor * fix: update test mocks from PATCH to POST for ADO create - Reverted incorrect unconditional _mount_installed_category_groups call - Updated test_create_issue mocks to use requests.post instead of requests.patch Made-with: Cursor * test: skip category group test when bundles not installed The test_bootstrap_with_category_grouping_disabled_registers_flat_commands test expects bundles like specfact-codebase to be installed, but in CI they may not be. Added pytest.skip() when 'code' command is not available. Made-with: Cursor --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

- Archived backlog-02-migrate-core-commands change - Updated CHANGE_ORDER.md with implementation status - Updated main specs with backlog-add, backlog-analyze-deps, backlog-delta, backlog-sync, backlog-verify-readiness Made-with: Cursor

* feat: document code-review module scaffold * chore: sync 0.41.0 release version artifacts --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

Signed-off-by: Dom <39115308+djm81@users.noreply.github.com>

* Realign code import ownership surface * Harden temp registry command audit test --------- Signed-off-by: Dom <39115308+djm81@users.noreply.github.com> Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

Link the existing change issue, record TDD evidence, and align the OpenSpec artifacts with the bundle-owned DDL and paired worktree implementation flow. Made-with: Cursor Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

Made-with: Cursor Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

* Track house-rules skill OpenSpec changes Made-with: Cursor * Cursor: Apply local changes for cloud agent --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

chatgpt-codex-connector · 2026-03-17T19:14:24Z

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

Signed-off-by: Dom <39115308+djm81@users.noreply.github.com>

djm81 and others added 30 commits January 29, 2026 13:57

Potential fix for pull request finding 'Empty except'

6bd9d7f

Co-authored-by: Copilot Autofix powered by AI <223894421+github-code-quality[bot]@users.noreply.github.com> Signed-off-by: Dom <39115308+djm81@users.noreply.github.com>

Fix unused variable review

d7d194b

Fix unused variable review

39563fc

Fix type and test errors

d15485a

Merge branch 'main' into dev

6c9c9b9

Finalize change

bd9b96a

Change for debug logs archived

c7e4546

Merge branch 'main' into dev

09e8040

fix: improve ADO backlog refine error logging and user-facing error UX (

642e1a9

#164) * Improving error logging capabilities * small fix on changelog * Archived change --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

Merge branch 'main' into dev

64365db

Add change proposals for full scrum support

aad02cd

Merge branch 'main' into dev

a3c3fb4

Add support for systematic, structured issue creation with copilot help

1f054c5

feat(backlog): daily standup defaults, iteration/sprint, unassigned i…

899b9c2

…tems view (#174)

Issue 179 resolution (#180)

b596766

Merge branch 'main' into dev

bb7214f

Signed-off-by: Dom <39115308+djm81@users.noreply.github.com>

Update openspec enforcement rules

10fee30

Structure openspec changes

8e770dc

Fix ruff finding

5782860

Fix linter issues with StrEnum and parameters

05c592d

Fix tests and depcreation warnings

f7e3d0f

Improve sync script

15d710b

Merge branch 'main' into dev

b223161

Add change for modular command registry

870db6a

Fix review finding on dev sync script

5404c18

Update modular change proposal

e4650dd

djm81 and others added 18 commits March 11, 2026 01:10

feat: document code-review module scaffold (#410)

e91e672

* feat: document code-review module scaffold * chore: sync 0.41.0 release version artifacts --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

Add change for project codebase ownership

aa494ff

Merge branch 'main' into dev

b62292c

Signed-off-by: Dom <39115308+djm81@users.noreply.github.com>

Realign code import ownership surface (#412)

67aaf31

* Realign code import ownership surface * Harden temp registry command audit test --------- Signed-off-by: Dom <39115308+djm81@users.noreply.github.com> Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

Update code review changes

1f4d236

docs: update reward ledger OpenSpec tracking (#413)

516b4c7

Link the existing change issue, record TDD evidence, and align the OpenSpec artifacts with the bundle-owned DDL and paired worktree implementation flow. Made-with: Cursor Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

Track house-rules skill OpenSpec changes (#414)

8579fe5

Made-with: Cursor Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

docs: Update change-proposal for code-review-07 (#415)

ff8d041

* Track house-rules skill OpenSpec changes Made-with: Cursor * Cursor: Apply local changes for cloud agent --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

Finalize code-review-07 status

b524f3a

Finalize code-review-08 status

097d8ef

feat: apply code-review-09 pre-commit integration

37efea0

fix: fall back when cached hatch test env is broken

fa503da

fix: avoid hatch env for coverage xml export

6e828e7

fix: install type-check and lint tools directly in CI

0aa178f

fix: install pytest fallback deps in test job

9f6a749

fix: install pytest-cov for test fallback path

c451134

djm81 self-assigned this Mar 17, 2026

djm81 added enhancement New feature or request QA Quality Assurance code-review Code review automation and quality governance labels Mar 17, 2026

djm81 added this to SpecFact CLI Mar 17, 2026

github-project-automation bot moved this to Todo in SpecFact CLI Mar 17, 2026

djm81 moved this from Todo to In Progress in SpecFact CLI Mar 17, 2026

djm81 linked an issue Mar 17, 2026 that may be closed by this pull request

[Change] code-review-09 - Integrate specfact code review into pre-commit and portable project workflows #393

Closed

Merge branch 'main' into dev

f328223

Signed-off-by: Dom <39115308+djm81@users.noreply.github.com>

djm81 merged commit 78b337c into main Mar 17, 2026
18 checks passed

github-project-automation bot moved this from In Progress to Done in SpecFact CLI Mar 17, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Release 0.42.1 changes from dev to main#418

Release 0.42.1 changes from dev to main#418
djm81 merged 277 commits intomainfrom
dev

djm81 commented Mar 17, 2026

Uh oh!

chatgpt-codex-connector bot commented Mar 17, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

djm81 commented Mar 17, 2026

Description

Type of Change

Contract-First Testing Evidence

Contract Validation

Test Execution

Test Quality

How Has This Been Tested?

Manual Testing

Automated Testing

Test Environment

Checklist

Quality Gates Status

Screenshots/Recordings (if applicable)

Uh oh!

chatgpt-codex-connector bot commented Mar 17, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant