nold-ai · djm81 · Mar 28, 2026 · Feb 10, 2026 · Feb 10, 2026 · Feb 10, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,16 +9,36 @@ All notable changes to this project will be documented in this file.
 
 ---
 
-## [Unreleased]
+## [0.43.1] - Unreleased
+
+### Changed
+
+- **Packaging:** Workflow slash-command prompts (`specfact.*.md`) are no longer duplicated in the core wheel; canonical copies live in **specfact-cli-modules** bundle packages under each bundle’s `resources/prompts/`. Install bundles (or use a dev repo checkout with `resources/prompts/`) for `specfact init ide` prompt export.
+- IDE template drift checks on startup resolve source templates via the same installed-module discovery path as `specfact init ide`, not a single core `resources/prompts` directory inside the package.
+
+---
+
+## [0.43.0] - 2026-03-28
 
 ### Added
 
+- Spec-Kit v0.4.x adapter alignment: extension catalog detection (`scan_extensions`), preset scanning (`scan_presets`), hook event detection (`scan_hook_events`), and 3-tier version detection (CLI → heuristic → None).
+- `ToolCapabilities` model expanded with `extensions`, `extension_commands`, `presets`, `hook_events`, and `detected_version_source` fields for v0.4.x metadata.
+- BridgeConfig presets (`preset_speckit_classic`, `preset_speckit_specify`, `preset_speckit_modern`) now map all 7 Spec-Kit slash commands: `/speckit.specify`, `/speckit.plan`, `/speckit.tasks`, `/speckit.implement`, `/speckit.constitution`, `/speckit.clarify`, `/speckit.analyze`.
+- 44 new unit/integration tests covering extension catalogs, version detection, preset scanning, hook events, and full `get_capabilities()` flow.
 - CI: `scripts/check-docs-commands.py` and `scripts/check-cross-site-links.py` with `hatch run docs-validate`
   (command examples vs CLI; modules URLs warn-only when live site lags); workflow runs validation plus
   `tests/unit/docs/`.
 - Documentation: `docs/reference/documentation-url-contract.md` and navigation links describing how core and modules published URLs relate; OpenSpec spec updates for cross-site linking expectations.
 - Documentation: converted 20 module-owned guide and tutorial pages under `docs/` to thin handoff summaries with canonical links to `modules.specfact.io`; added `docs/reference/core-to-modules-handoff-urls.md` mapping core permalinks to modules URLs.
 
+### Changed
+
+- `SpecKitAdapter.get_capabilities()` refactored with helper methods (`_detect_layout`, `_detect_version`, `_extract_extension_fields`) to reduce cyclomatic complexity.
+- Logging in `speckit.py` and `speckit_scanner.py` switched from `logging.getLogger` to `get_bridge_logger` per production command path convention.
+
+---
+
 ## [0.42.6] - 2026-03-26
 
 ### Fixed

diff --git a/docs/guides/adapter-development.md b/docs/guides/adapter-development.md
@@ -34,6 +34,10 @@ All methods should preserve runtime contracts (`@icontract`) and runtime type ch
 - `tool`, `version`, `layout`, `specs_dir`
 - `supported_sync_modes`
 - `has_external_config`, `has_custom_hooks`
+- `extensions`, `extension_commands` — detected tool extensions and their provided commands
+- `presets` — active preset names (e.g., from `presets/` directory)
+- `hook_events` — detected hook event types (e.g., `before_task`, `after_task`)
+- `detected_version_source` — how version was detected: `"cli"`, `"heuristic"`, or `None`
 
 Sync selection and safe behavior depend on this model.
 

diff --git a/docs/guides/ai-ide-workflow.md b/docs/guides/ai-ide-workflow.md
@@ -47,7 +47,7 @@ specfact init ide --ide cursor --install-deps
 **What it does**:
 
 1. Detects your IDE (or uses `--ide` flag)
-2. Copies prompt templates from `resources/prompts/` to IDE-specific location
+2. Copies prompt templates from installed bundle modules (or an optional dev checkout under `resources/prompts/`) to the IDE-specific location
 3. Creates/updates IDE settings if needed
 4. Makes slash commands available in your IDE
 5. Optionally installs required packages (`beartype`, `icontract`, `crosshair-tool`, `pytest`)

diff --git a/docs/guides/integrations-overview.md b/docs/guides/integrations-overview.md
@@ -36,10 +36,12 @@ SpecFact CLI integrations fall into four main categories:
 
 **What it provides**:
 
-- ✅ Interactive slash commands (`/speckit.specify`, `/speckit.plan`) with AI assistance
+- ✅ Interactive slash commands (`/speckit.specify`, `/speckit.plan`, `/speckit.tasks`, `/speckit.implement`, `/speckit.constitution`, `/speckit.clarify`, `/speckit.analyze`) with AI assistance
 - ✅ Rapid prototyping workflow: spec → plan → tasks → code
 - ✅ Constitution and planning for new features
 - ✅ IDE integration with CoPilot chat
+- ✅ Extension ecosystem — 46+ community extensions with pluggable presets
+- ✅ Version-aware detection — SpecFact auto-detects Spec-Kit version, extensions, presets, and hook events
 
 **When to use**:
 

diff --git a/docs/guides/speckit-comparison.md b/docs/guides/speckit-comparison.md
@@ -36,6 +36,8 @@ permalink: /guides/speckit-comparison/
 | **GitHub integration** | ✅ Native slash commands | ✅ GitHub Actions + CLI | Spec-Kit for native integration |
 | **Learning curve** | ✅ Low (markdown + slash commands) | ⚠️ Medium (decorators + contracts) | Spec-Kit for ease of use |
 | **High-risk brownfield** | ⚠️ Good documentation | ✅ Formal verification | **SpecFact for high-risk** |
+| **Extension awareness** | ✅ 46+ community extensions | ✅ Auto-detects extensions, presets, hooks | SpecFact bridges extension metadata |
+| **Version detection** | N/A | ✅ CLI + heuristic detection (v0.4.x) | SpecFact adapts to detected version |
 | **Free tier** | ✅ Open-source | ✅ Apache 2.0 | Both free |
 
 ---

diff --git a/docs/guides/speckit-journey.md b/docs/guides/speckit-journey.md
@@ -18,7 +18,7 @@ permalink: /guides/speckit-journey/
 
 Spec-Kit is **excellent** for:
 
-- ✅ **Interactive Specification** - Slash commands (`/speckit.specify`, `/speckit.plan`) with AI assistance
+- ✅ **Interactive Specification** - Slash commands (`/speckit.specify`, `/speckit.plan`, `/speckit.tasks`, `/speckit.implement`, `/speckit.constitution`, `/speckit.clarify`, `/speckit.analyze`) with AI assistance
 - ✅ **Rapid Prototyping** - Quick spec → plan → tasks → code workflow for **NEW features**
 - ✅ **Learning & Exploration** - Great for understanding state machines, contracts, requirements
 - ✅ **IDE Integration** - CoPilot chat makes it accessible to less technical developers

diff --git a/openspec/CHANGE_ORDER.md b/openspec/CHANGE_ORDER.md
@@ -275,6 +275,21 @@ Cross-repo dependency: `docs-07-core-handoff-conversion` depends on `specfact-cl
 |--------|-------|---------------|----------|------------|
 | openspec | 01 | openspec-01-intent-trace | [#350](https://github.com/nold-ai/specfact-cli/issues/350) | #238 (requirements-01); #239 (requirements-02) |
 
+### Spec-Kit v0.4.x alignment (spec-kit integration review, 2026-03-27)
+
+Spec-Kit has evolved to v0.4.3 with 46 extensions, pluggable presets, 7+ slash commands. These changes update the adapter interface and add change proposal bridging.
+
+| Module | Order | Change folder | GitHub # | Blocked by |
+|--------|-------|---------------|----------|------------|
+| speckit | 02 | speckit-02-v04-adapter-alignment | [#453](https://github.com/nold-ai/specfact-cli/issues/453) | — |
+| speckit | 03 | speckit-03-change-proposal-bridge *(specfact-cli-modules)* | [modules#116](https://github.com/nold-ai/specfact-cli-modules/issues/116) | speckit-02 (#453) |
+
+**Cross-repo note**: speckit-03 lives in `nold-ai/specfact-cli-modules` but depends on speckit-02 in this repo (ToolCapabilities extension fields).
+
+**Updated proposals** (spec-kit interop sections added 2026-03-27):
+- `sync-01-unified-kernel`: Added spec-kit extension interop — sync kernel detects external sync actors from spec-kit reconcile/sync/iterate extensions
+- `requirements-03-backlog-sync`: Added spec-kit backlog extension awareness — prevents duplicate issue creation when spec-kit Jira/ADO/Linear extensions have already created issues
+
 ### CLI end-user validation (validation gap plan, 2026-02-19)
 
 | Module | Order | Change folder | GitHub # | Blocked by |
@@ -360,6 +375,8 @@ Set these in GitHub so issue dependencies are explicit. Optional dependencies ar
 | [#350](https://github.com/nold-ai/specfact-cli/issues/350) | openspec-01 intent trace | #238, #239 |
 | [#254](https://github.com/nold-ai/specfact-cli/issues/254) | integration-01 cross-change contracts | #237, #239, #240, #241, #246 |
 | [#255](https://github.com/nold-ai/specfact-cli/issues/255) | dogfooding-01 full-chain e2e proof | #239, #240, #241, #242, #247 |
+| [#453](https://github.com/nold-ai/specfact-cli/issues/453) | speckit-02 v0.4.x adapter alignment | — |
+| [modules#116](https://github.com/nold-ai/specfact-cli-modules/issues/116) | speckit-03 change proposal bridge *(modules repo)* | speckit-02 (#453) |
 | TBD | doc-frontmatter-schema | — |
 | TBD | ci-docs-sync-check | doc-frontmatter-schema |
 

diff --git a/...hanges/packaging-02-cross-platform-runtime-and-module-resources/TDD_EVIDENCE.md b/...hanges/packaging-02-cross-platform-runtime-and-module-resources/TDD_EVIDENCE.md
@@ -37,3 +37,33 @@ HATCH_DATA_DIR=/tmp/hatch-data HATCH_CACHE_DIR=/tmp/hatch-cache VIRTUALENV_OVERR
 
 - Result: passed.
 - Summary: `specfact code review run` completed with no findings on the shipped production files.
+
+## Task 3.5 — Remove bundle workflow prompts from core wheel (2026-03-28)
+
+- Change: drop `resources/prompts` from `[tool.hatch.build.targets.wheel.force-include]`, delete repo-root `resources/prompts/`, align startup drift checks and init template resolution with `discover_prompt_template_files`, bump **0.43.1**.
+
+### Pre-implementation failing run (Task 3.5)
+
+- Timestamp: 2026-03-28T00:18:00+01:00 (local)
+- Command:
+
+```bash
+cd /home/dom/git/nold-ai/specfact-cli-worktrees/chore/packaging-02-finish-core-prompt-cleanup
+hatch run smart-test-full
+```
+
+- Result: failed.
+- Failure summary: exit code 1 — tests and/or checks failed after removing `resources/prompts` from the wheel and repo without updating startup checks, init template resolution, and tests (expected until implementation was completed).
+
+### Post-change verification (Task 3.5)
+
+```bash
+cd /home/dom/git/nold-ai/specfact-cli-worktrees/chore/packaging-02-finish-core-prompt-cleanup
+hatch env create
+hatch run format && hatch run type-check && hatch run contract-test
+hatch run smart-test-full
+```
+
+- Timestamp: 2026-03-28T00:22:00+01:00 (local)
+- Command: `hatch run smart-test-full` (from worktree `chore/packaging-02-finish-core-prompt-cleanup`)
+- Result: passed (exit 0).
diff --git a/...ec/changes/packaging-02-cross-platform-runtime-and-module-resources/proposal.md b/...ec/changes/packaging-02-cross-platform-runtime-and-module-resources/proposal.md
@@ -36,5 +36,5 @@ None.
 <!-- source_repo: nold-ai/specfact-cli -->
 - **GitHub Issue**: #441
 - **Issue URL**: <https://github.com/nold-ai/specfact-cli/issues/441>
-- **Last Synced Status**: proposed
+- **Last Synced Status**: implementation-complete (task 3.5 core prompt removal; pending archive)
 - **Sanitized**: false
diff --git a/openspec/changes/packaging-02-cross-platform-runtime-and-module-resources/tasks.md b/openspec/changes/packaging-02-cross-platform-runtime-and-module-resources/tasks.md
@@ -18,7 +18,7 @@
 - [x] 3.2 Replace brittle path-injection behavior with installation-scoped runtime/module resolution and explicit compatibility diagnostics.
 - [x] 3.3 Refactor `specfact init ide` to build a prompt catalog from installed module resource locations rather than `specfact_cli/resources/prompts`.
 - [x] 3.4 Refactor core init/install resource copying to resolve module-owned templates, starting with backlog field mapping templates, from installed bundle packages.
-- [ ] 3.5 Remove or relocate bundle-owned prompt/resources from core packaging so ownership matches installed modules.
+- [x] 3.5 Remove or relocate bundle-owned prompt/resources from core packaging so ownership matches installed modules.
 
 ## 4. Validation And Documentation
 

diff --git a/openspec/changes/requirements-03-backlog-sync/proposal.md b/openspec/changes/requirements-03-backlog-sync/proposal.md
@@ -19,6 +19,7 @@ When backlog items change, requirements aren't updated. When requirements change
 - **NEW**: Backlog adapter extension: adapters provide `extract_requirements_fields()` and `update_requirements_fields()` methods for bidirectional sync
 - **EXTEND**: Requirements module (requirements-02) extended with sync commands
 - **DESIGN DECISION**: v1 starts with pull-first (backlog → requirements) as primary direction; push (requirements → backlog) is preview-only and requires explicit `--write` confirmation via patch-mode
+- **EXTEND**: Spec-Kit backlog extension awareness — before creating issues during push (requirements → backlog), the sync SHALL query `ToolCapabilities.extension_commands` (from speckit-02) to detect active spec-kit backlog extensions (Jira, ADO, Linear, GitHub Projects, Trello). When a spec-kit backlog extension is active, the sync SHALL scan spec-kit feature `tasks.md` files for existing issue references (e.g., `PROJ-123`, `AB#456`) and import them as pre-existing mappings. Issue creation is skipped for tasks that already have spec-kit extension mappings, preventing duplicate issues. This detection is implemented in `speckit-03-change-proposal-bridge` (specfact-cli-modules) and consumed here via the adapter interface.
 
 ## Capabilities
 ### New Capabilities
@@ -27,8 +28,8 @@ When backlog items change, requirements aren't updated. When requirements change
 
 ### Modified Capabilities
 
-- `backlog-adapter`: Extended with requirements field extraction and update methods for bidirectional sync
-- `requirements-module`: Extended with sync and drift commands
+- `backlog-adapter`: Extended with requirements field extraction and update methods for bidirectional sync; extended with spec-kit backlog extension issue mapping import
+- `requirements-module`: Extended with sync and drift commands; extended with spec-kit duplicate issue prevention
 
 
 ---

diff --git a/openspec/changes/speckit-02-v04-adapter-alignment/.openspec.yaml b/openspec/changes/speckit-02-v04-adapter-alignment/.openspec.yaml
@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-03-27
diff --git a/openspec/changes/speckit-02-v04-adapter-alignment/CHANGE_VALIDATION.md b/openspec/changes/speckit-02-v04-adapter-alignment/CHANGE_VALIDATION.md
@@ -0,0 +1,82 @@
+# Change Validation Report: speckit-02-v04-adapter-alignment
+
+**Validation Date**: 2026-03-27
+**Change Proposal**: [proposal.md](./proposal.md)
+**Validation Method**: Dry-run simulation — interface analysis, dependency graph, format compliance
+
+## Executive Summary
+
+- Breaking Changes: 0 detected
+- Dependent Files: 8 (7 in specfact-cli, 3 in specfact-cli-modules)
+- Impact Level: Low
+- Validation Result: Pass
+- User Decision: N/A
+
+## Breaking Changes Detected
+
+None. All changes are additive:
+
+- `ToolCapabilities` extended with 5 optional fields (all default to `None`) — existing constructors unaffected
+- `BridgeConfig.preset_speckit_*()` methods expanded with additional command mappings — existing commands preserved, new ones added
+- `SpecKitScanner` receives new methods (`scan_extensions`, `scan_presets`, `scan_hook_events`) — no existing methods modified
+- `SpecKitAdapter.get_capabilities()` enhanced but returns same type with same existing fields
+
+## Dependencies Affected
+
+### No Critical Updates Required
+
+All dependent files continue working without modification:
+
+| File | Impact |
+|---|---|
+| `src/specfact_cli/adapters/base.py` | No impact — imports ToolCapabilities, doesn't access new fields |
+| `src/specfact_cli/adapters/ado.py` | No impact — constructs ToolCapabilities with existing fields only |
+| `src/specfact_cli/adapters/github.py` | No impact — same as ado |
+| `src/specfact_cli/adapters/openspec.py` | No impact — same as ado |
+| `src/specfact_cli/sync/bridge_probe.py` | No impact — consumes ToolCapabilities, new fields optional |
+| `src/specfact_cli/sync/__init__.py` | No impact — re-export only |
+| `specfact-cli-modules/.../bridge_probe.py` | No impact — consumes ToolCapabilities |
+| `specfact-cli-modules/.../test_bridge_probe.py` | No impact — tests existing behavior |
+
+### Recommended Updates (downstream consumers, not required for this change)
+
+- `sync-01-unified-kernel`: Should consume `extension_commands` for external sync actor detection (proposal updated)
+- `requirements-03-backlog-sync`: Should consume `extension_commands` for backlog extension awareness (proposal updated)
+
+## Impact Assessment
+
+- **Code Impact**: 4 files modified (speckit.py, capabilities.py, bridge.py, speckit_scanner.py), all additive
+- **Test Impact**: Existing tests unaffected; new tests required for new methods and fields
+- **Documentation Impact**: 2 docs updated (speckit-comparison.md, speckit-journey.md)
+- **Release Impact**: Minor (new capabilities, no breaking changes)
+
+## Format Validation
+
+- **proposal.md Format**: Pass
+  - Has Why, What Changes, Capabilities (2 new + 2 modified), Impact sections
+  - Capabilities correctly map to spec files
+- **tasks.md Format**: Pass
+  - 9 numbered groups with checkbox tasks
+  - Includes contract tasks (9.1), test tasks throughout, quality gates (9.2)
+  - TDD evidence task (9.3)
+  - Missing: explicit git worktree creation/PR tasks (acceptable — this is a core-lib change, not a module)
+- **specs Format**: Pass
+  - 4 spec files: speckit-extension-catalog, speckit-version-detection, bridge-adapter, bridge-registry
+  - All use Given/When/Then format with `####` scenario headers
+  - ADDED and MODIFIED markers used correctly
+- **design.md Format**: Pass
+  - Context, Goals/Non-Goals, 6 Decisions with rationale and alternatives, Risks/Trade-offs, Open Questions
+- **Config.yaml Compliance**: Pass
+
+## OpenSpec Validation
+
+- **Status**: Pass
+- **Command**: `openspec validate speckit-02-v04-adapter-alignment --strict`
+- **Issues Found/Fixed**: 0
+
+## Cross-Change Conflict Analysis
+
+- **No conflicts** with other pending changes in specfact-cli
+- **Enables** speckit-03-change-proposal-bridge (specfact-cli-modules) — provides ToolCapabilities.extension_commands
+- **Enhances** sync-01-unified-kernel — provides detect_external_sync_actors() input data
+- **Enhances** requirements-03-backlog-sync — provides backlog extension detection input
diff --git a/openspec/changes/speckit-02-v04-adapter-alignment/TDD_EVIDENCE.md b/openspec/changes/speckit-02-v04-adapter-alignment/TDD_EVIDENCE.md
@@ -0,0 +1,44 @@
+# TDD Evidence: speckit-02-v04-adapter-alignment
+
+## Implementation Order
+
+Production code for tasks 1.1–7.2 was written first (ToolCapabilities fields, scanner methods, version detection, bridge presets, get_capabilities integration). Tests were then written targeting all new behavior.
+
+## Post-Implementation Test Run (passing)
+
+**Timestamp:** 2026-03-27T23:13:50Z
+
+**Command:** `hatch test -- tests/unit/models/test_capabilities.py tests/unit/models/test_bridge.py tests/unit/importers/test_speckit_scanner.py tests/unit/adapters/test_speckit.py -v`
+
+**Result:** 110 passed in 4.90s
+
+New tests added:
+- `TestToolCapabilitiesV04Fields` — 8 tests (backward compat, all new fields)
+- `TestScanExtensions` — 7 tests (catalog parsing, ignore, malformed JSON, merge)
+- `TestScanPresets` — 4 tests (JSON, directory, malformed fallback)
+- `TestScanHookEvents` — 4 tests (pattern detection, sorting, edge cases)
+- `TestVersionDetection` — 8 tests (heuristics, CLI mock, priority)
+- `TestGetCapabilitiesV04` — 7 tests (extensions, presets, hooks, version, cross-repo, legacy)
+- `TestBridgeConfigPresets` — 4 new parametrized tests (7-command set validation)
+
+## Full Suite Run (passing)
+
+**Timestamp:** 2026-03-27T23:13:50Z
+
+**Command:** `hatch test --cover -v`
+
+**Result:** 2248 passed, 9 skipped in 171.02s
+
+## Quality Gates
+
+| Gate | Result | Timestamp |
+|------|--------|-----------|
+| `hatch run format` | All checks passed | 2026-03-27T23:12Z |
+| `hatch run type-check` | 0 errors, 1437 warnings | 2026-03-27T23:12Z |
+| `hatch run contract-test` | Passed (cached) | 2026-03-27T23:12Z |
+| `hatch test --cover -v` | 2248 passed, 0 failed | 2026-03-27T23:13Z |
+| `specfact code review run` | PASS, Score 120, 0 findings | 2026-03-27T23:13Z |
+
+## Note
+
+Production code was written before tests in this change (not strict TDD red-green-refactor). The OpenSpec change was created with specs and design first, followed by implementation and then test coverage. All new public methods have `@beartype` and `@icontract` contracts as primary validation, with unit tests as secondary coverage per project conventions.