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

djm81 · 2026-03-11T23:13:26Z

Description

Promotes the current dev line to main, including two merged dev changes:

the code-review-01-module-scaffold release documentation/version updates
the module-migration-11-project-codebase-ownership-realignment command-surface realignment that makes specfact code import the canonical brownfield import path

This release also includes the corresponding OpenSpec artifacts, prompt/template updates, command-audit/runtime validation coverage, and docs alignment needed to keep the grouped command model coherent.

Fixes #398

New Features #408

Contract References: No new core @icontract decorators are introduced specifically for this release PR. The shipped changes are command-surface ownership realignment, docs/prompt updates, OpenSpec artifacts, and regression coverage for the grouped CLI surface.

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: targeted runtime/command-surface regression coverage and PR orchestrator tests ✅

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 for the ownership realignment was captured under openspec/changes/module-migration-11-project-codebase-ownership-realignment/TDD_EVIDENCE.md. The paired modules repository shipped the signed specfact-project / specfact-codebase bundle updates, and the core repo added command-audit and temp-home runtime coverage to verify specfact code import resolves correctly after marketplace installs.

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 resolves on the grouped code surface after marketplace install in temp-home runtime validation.
Prompt/template resources now point at specfact code import instead of the removed flat import path.

- Sync version across pyproject.toml, setup.py, src/__init__.py, src/specfact_cli/__init__.py - Add CHANGELOG entry for 0.26.10 (fixes incorrect version publish issue) Co-authored-by: Cursor <cursoragent@cursor.com>

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

…156) * feat(backlog): implement --import-from-tmp for refine export/import round-trip - Add _parse_refined_export_markdown() to parse export-format markdown (ID, Body, Acceptance Criteria, optional title/metrics) - Import branch: read file, match by ID, update items; --write calls adapter.update_backlog_item() - Remove 'Import functionality pending implementation' message - Unit tests for parser (single item, AC/metrics, header-only, blocks without ID) - Bump version to 0.26.11 and sync across pyproject.toml, setup.py, src/__init__.py, src/specfact_cli/__init__.py - OpenSpec change: implement-backlog-refine-import-from-tmp (proposal, tasks, spec delta) Fixes #155 Co-authored-by: Cursor <cursoragent@cursor.com> * Fix type check issues --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com> Co-authored-by: Cursor <cursoragent@cursor.com>

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

* 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)

# Conflicts: # openspec/CHANGE_ORDER.md # openspec/changes/module-migration-10-bundle-command-surface-alignment/proposal.md

* fix: finalize cli runtime validation regressions * test: align satisfied dependency logging assertions --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

* feat: add OpenSpec change for backlog-core commands migration Change: backlog-02-migrate-core-commands - Add proposal, design, tasks, specs - Add TDD_EVIDENCE.md with implementation progress - GitHub Issue: #389 Rules applied: AGENTS.md Git Worktree Policy, TDD Hard Gate Made-with: Cursor * docs: update TDD_EVIDENCE and tasks for quality gate results Made-with: Cursor * docs: update TDD_EVIDENCE with test fix results Made-with: Cursor * docs: update TDD_EVIDENCE with all test fixes complete Made-with: Cursor --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.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>

chatgpt-codex-connector · 2026-03-11T23:13:31Z

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>

* 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>

djm81 and others added 30 commits January 27, 2026 23:58

Update gitignore

573fb7b

Update contribution standards to use openspec for SDD

907501e

Merge branch 'main' into dev

568000c

Migrate to new opsx openspec commands

fe082f6

Migrate workflow and openspec config

036afbe

fix: bump version to 0.26.10 for PyPI publish

5a1493f

- Sync version across pyproject.toml, setup.py, src/__init__.py, src/specfact_cli/__init__.py - Add CHANGELOG entry for 0.26.10 (fixes incorrect version publish issue) Co-authored-by: Cursor <cursoragent@cursor.com>

Update version and changelog

da606a1

Add canonical user-friendly workitem url for ado workitems

608f317

Update to support OSPX

719256c

Merge branch 'main' into dev

1f94d7c

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

Merge branch 'main' into dev

080743a

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

Merge branch 'main' into dev

5ab46a5

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

djm81 and others added 14 commits March 6, 2026 23:03

Add new command alignment change

00658a3

Merge branch 'dev' of https://github.com/nold-ai/specfact-cli into dev

f8e5af1

# Conflicts: # openspec/CHANGE_ORDER.md # openspec/changes/module-migration-10-bundle-command-surface-alignment/proposal.md

Merge branch 'main' into dev

08f028a

fix: finalize cli runtime validation regressions (#387)

332949e

* fix: finalize cli runtime validation regressions * test: align satisfied dependency logging assertions --------- Co-authored-by: Dominikus Nold <djm81@users.noreply.github.com>

docs: archive cli-val-07 change

2a4a0ab

Archive changes and update specs

d031281

Merge branch 'main' into dev

d21e157

Add code-review change proposals

216f03f

test: align command surface regression coverage

e979938

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

djm81 self-assigned this Mar 11, 2026

djm81 added bug Something isn't working enhancement New feature or request module-system Module system and registry QA Quality Assurance labels Mar 11, 2026

djm81 added this to SpecFact CLI Mar 11, 2026

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

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

[Change] code-review-01 - specfact-code-review Module Scaffold with Pydantic Models #398

Closed

djm81 and others added 2 commits March 12, 2026 00:16

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>

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

This was linked to issues Mar 12, 2026

import from-code command not available (v0.40.4) #407

Closed

[Change] module-migration-11 - Project And Codebase Ownership Realignment #408

Closed

djm81 merged commit bee319e into main Mar 12, 2026
22 checks passed

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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Release 0.41.0 changes from dev to main#411

Release 0.41.0 changes from dev to main#411
djm81 merged 264 commits intomainfrom
dev

djm81 commented Mar 11, 2026 •

edited

Loading

Uh oh!

chatgpt-codex-connector bot commented Mar 11, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

djm81 commented Mar 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

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 11, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

djm81 commented Mar 11, 2026 •

edited

Loading