spec-kitty-cli 3.2.0rc1__tar.gz → 3.2.0rc2__tar.gz

{spec_kitty_cli-3.2.0rc1 → spec_kitty_cli-3.2.0rc2}/CHANGELOG.md

@@ -17,6 +17,40 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+## [3.2.0rc2] - 2026-05-05
+
+3.2.0rc2 adds the TeamSpace mission-state repair and validation surface needed
+before public TeamSpace import. The repair command is available now; the
+TeamSpace dry-run path requires `spec-kitty-events>=5.0.0` once that contract
+package is published.
+
+### Added
+
+- Added deterministic `doctor mission-state --fix` repair for historical
+  `kitty-specs/` state, including Git safety checks, migration manifests, legacy
+  key cleanup, typed-row quarantine, lane normalization, and production
+  `status.json` rematerialization (#980).
+- Added `doctor mission-state --teamspace-dry-run` to synthesize canonical
+  TeamSpace envelopes in memory and validate them with the 5.0.0 event contract
+  when available (#980).
+- Documented the distributed Git repair workflow for coordinated repository
+  migration before TeamSpace launch (#980).
+- Added `doctor mission-state --include-fixtures` and the packaged
+  mission-state survey fixture pack used by the TeamSpace readiness audit
+  contract (#920, #922, #929).
+- Added an opt-in `TeamSpace Mission-State Readiness` GitHub Actions workflow
+  that runs `doctor mission-state --audit --fail-on teamspace-blocker` and
+  uploads the JSON audit artifact (#920, #934).
+
+### Changed
+
+- Aligned CLI sync emission for `WPStatusChanged` and `MissionClosed` with the
+  canonical TeamSpace event payload shape while keeping launch dry-run gated on
+  the published events contract (#980).
+- `doctor mission-state --audit` JSON reports now expose TeamSpace blocker
+  counts, and `--fail-on teamspace-blocker` gates import/sync readiness
+  without requiring network access (#920, #934).
+
 ## [3.2.0rc1] - 2026-05-05
 
 3.2.0rc1 is the first release candidate for the 3.2.0 line. It rolls up the

spec_kitty_cli-3.2.0rc2/PKG-INFO

@@ -0,0 +1,241 @@
+Metadata-Version: 2.4
+Name: spec-kitty-cli
+Version: 3.2.0rc2
+Summary: Spec Kitty, a tool for Specification Driven Development (SDD) agentic projects, with kanban and git worktree isolation.
+Project-URL: Repository, https://github.com/Priivacy-ai/spec-kitty
+Project-URL: Issues, https://github.com/Priivacy-ai/spec-kitty/issues
+Project-URL: Documentation, https://docs.spec-kitty.ai/
+Project-URL: Changelog, https://github.com/Priivacy-ai/spec-kitty/blob/main/CHANGELOG.md
+Author: Spec Kitty Contributors
+Maintainer: Spec Kitty Contributors
+License: MIT License
+        
+        Copyright GitHub, Inc.
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: agentic-development,ai-agents,ai-coding,claude-code,cli,code-generation,feature-specs,git-worktree,kanban,llm-tools,planning,requirements,sdd,spec-driven-development,specification,workflow-automation
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Version Control
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: cryptography>=42.0
+Requires-Dist: filelock>=3.13.0
+Requires-Dist: google-re2>=1.1
+Requires-Dist: httpx[socks]>=0.28.1
+Requires-Dist: jsonschema>=4.0
+Requires-Dist: packaging>=23.0
+Requires-Dist: platformdirs>=4.9.2
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pygments>=2.20.0
+Requires-Dist: python-ulid>=3.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: readchar>=4.2.1
+Requires-Dist: requests>=2.33.0
+Requires-Dist: rich>=14.3.3
+Requires-Dist: ruamel-yaml>=0.18.0
+Requires-Dist: spec-kitty-events<6.0.0,>=4.0.0
+Requires-Dist: spec-kitty-tracker<0.5,>=0.4
+Requires-Dist: toml>=0.10.2
+Requires-Dist: transitions>=0.9.2
+Requires-Dist: truststore>=0.10.4
+Requires-Dist: typer>=0.24.1
+Requires-Dist: websockets>=12.0
+Provides-Extra: lint
+Requires-Dist: bandit>=1.7.0; extra == 'lint'
+Requires-Dist: cyclonedx-bom>=4.0; extra == 'lint'
+Requires-Dist: mypy>=1.10.0; extra == 'lint'
+Requires-Dist: pip-audit>=2.7.0; extra == 'lint'
+Requires-Dist: ruff>=0.4.0; extra == 'lint'
+Requires-Dist: types-jsonschema>=4.0.0; extra == 'lint'
+Requires-Dist: types-psutil>=5.9.0; extra == 'lint'
+Requires-Dist: types-pyyaml>=6.0; extra == 'lint'
+Requires-Dist: types-requests>=2.33.0; extra == 'lint'
+Requires-Dist: types-toml>=0.10.0; extra == 'lint'
+Provides-Extra: test
+Requires-Dist: build>=1.0.0; extra == 'test'
+Requires-Dist: chardet<6,>=3.0.4; extra == 'test'
+Requires-Dist: diff-cover>=10.0.0; extra == 'test'
+Requires-Dist: mutmut>=3.5.0; extra == 'test'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'test'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'test'
+Requires-Dist: pytest-timeout>=2.2.0; extra == 'test'
+Requires-Dist: pytest>=9.0.3; extra == 'test'
+Requires-Dist: pytestarch>=4.0.0; extra == 'test'
+Requires-Dist: respx>=0.21.1; extra == 'test'
+Description-Content-Type: text/markdown
+
+<div align="center">
+    <img src="https://github.com/Priivacy-ai/spec-kitty/raw/main/media/logo_small.webp" alt="Spec Kitty Logo"/>
+    <h1>Spec Kitty</h1>
+    <p><strong>Spec-driven development for AI coding agents.</strong></p>
+</div>
+
+Spec Kitty is an open-source CLI for turning product intent into a repeatable agent workflow:
+
+```text
+spec -> plan -> tasks -> next -> review -> accept -> merge
+```
+
+It keeps the important context in your repository, creates work packages that agents can execute, and uses git worktrees so implementation work can happen without constantly switching branches.
+
+[![PyPI version](https://img.shields.io/pypi/v/spec-kitty-cli?style=flat-square&logo=pypi)](https://pypi.org/project/spec-kitty-cli/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue?style=flat-square)](https://www.python.org/downloads/)
+
+## Is It For You?
+
+Use Spec Kitty when:
+
+- AI coding sessions are losing requirements, decisions, or acceptance criteria.
+- You want specs, plans, tasks, reviews, and merge state stored in the repo.
+- Multiple agents or developers need clear work package boundaries.
+- You want a local workflow first, with optional hosted tracker and sync integrations later.
+
+It is probably overkill for one-off edits, tiny scripts, or teams that do not use Git.
+
+## What It Provides
+
+| Need | Spec Kitty provides |
+| --- | --- |
+| Start from intent | Guided `specify`, `plan`, and `tasks` workflows |
+| Keep agents aligned | Repository-native mission artifacts under `kitty-specs/` |
+| Split implementation | Work packages with lifecycle lanes such as `planned`, `in_progress`, `for_review`, and `done` |
+| Avoid branch chaos | Isolated git worktrees under `.worktrees/` |
+| See progress | Optional local kanban dashboard with `spec-kitty dashboard` |
+| Integrate agents | Slash commands or skills for common AI coding tools |
+
+## Quick Start
+
+Install the CLI:
+
+```bash
+pip install spec-kitty-cli
+# or
+uv tool install spec-kitty-cli
+```
+
+Create or initialize a project:
+
+```bash
+spec-kitty init my-project --ai claude
+cd my-project
+spec-kitty verify-setup
+```
+
+Replace `claude` with your agent key when needed. Common choices include `codex`, `cursor`, `gemini`, `copilot`, `opencode`, `qwen`, `windsurf`, `kiro`, and `vibe`.
+
+Open your AI coding agent in the project and run the core workflow:
+
+```text
+/spec-kitty.charter
+/spec-kitty.specify Build a small task list app.
+/spec-kitty.plan
+/spec-kitty.tasks
+```
+
+Then let the runtime choose the next action until the mission is ready:
+
+```bash
+spec-kitty next --agent claude --mission <mission-slug>
+```
+
+Review, accept, and merge:
+
+```text
+/spec-kitty.review
+/spec-kitty.accept
+/spec-kitty.merge --push
+```
+
+For the full walkthrough, see [Your First Feature](docs/tutorials/your-first-feature.md).
+
+## Everyday Commands
+
+| Command | Purpose |
+| --- | --- |
+| `spec-kitty init . --ai <agent>` | Add Spec Kitty to the current repo |
+| `spec-kitty verify-setup` | Check local installation and project wiring |
+| `spec-kitty dashboard` | Open the local mission dashboard |
+| `spec-kitty next --agent <agent> --mission <slug>` | Ask Spec Kitty what the agent should do next |
+| `spec-kitty upgrade` | Update an existing project after upgrading the CLI |
+| `spec-kitty --help` | Show available commands |
+
+## Documentation
+
+Start here:
+
+- [Getting Started](docs/tutorials/getting-started.md)
+- [Your First Feature](docs/tutorials/your-first-feature.md)
+- [CLI Command Reference](docs/reference/cli-commands.md)
+- [Slash Commands](docs/reference/slash-commands.md)
+- [Supported Agents](docs/reference/supported-agents.md)
+- [Dashboard Guide](docs/how-to/use-dashboard.md)
+- [Install and Upgrade](docs/how-to/install-and-upgrade.md)
+
+Deeper topics:
+
+- [Spec-Driven Development](docs/explanation/spec-driven-development.md)
+- [Mission System](docs/explanation/mission-system.md)
+- [Git Worktrees](docs/explanation/git-worktrees.md)
+- [Multi-Agent Orchestration](docs/explanation/multi-agent-orchestration.md)
+- [External Orchestrator Runbook](docs/how-to/run-external-orchestrator.md)
+- [Hosted Sync Workspaces](docs/how-to/sync-workspaces.md)
+
+## Development
+
+```bash
+git clone https://github.com/Priivacy-ai/spec-kitty.git
+cd spec-kitty
+pip install -e ".[test]"
+```
+
+When testing templates from a source checkout:
+
+```bash
+export SPEC_KITTY_TEMPLATE_ROOT="$(pwd)"
+spec-kitty init my-project --ai claude
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
+
+## Support
+
+- Open a [GitHub issue](https://github.com/Priivacy-ai/spec-kitty/issues/new) for bugs, feature requests, or questions.
+- See [CHANGELOG.md](CHANGELOG.md) for release notes.
+- See [CONTRIBUTORS.md](CONTRIBUTORS.md) and the [GitHub contributors graph](https://github.com/Priivacy-ai/spec-kitty/graphs/contributors) for contributor credits.
+
+## License
+
+Spec Kitty is released under the [MIT License](LICENSE).

spec_kitty_cli-3.2.0rc2/README.md

@@ -0,0 +1,143 @@
+<div align="center">
+    <img src="https://github.com/Priivacy-ai/spec-kitty/raw/main/media/logo_small.webp" alt="Spec Kitty Logo"/>
+    <h1>Spec Kitty</h1>
+    <p><strong>Spec-driven development for AI coding agents.</strong></p>
+</div>
+
+Spec Kitty is an open-source CLI for turning product intent into a repeatable agent workflow:
+
+```text
+spec -> plan -> tasks -> next -> review -> accept -> merge
+```
+
+It keeps the important context in your repository, creates work packages that agents can execute, and uses git worktrees so implementation work can happen without constantly switching branches.
+
+[![PyPI version](https://img.shields.io/pypi/v/spec-kitty-cli?style=flat-square&logo=pypi)](https://pypi.org/project/spec-kitty-cli/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-yellow?style=flat-square)](LICENSE)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue?style=flat-square)](https://www.python.org/downloads/)
+
+## Is It For You?
+
+Use Spec Kitty when:
+
+- AI coding sessions are losing requirements, decisions, or acceptance criteria.
+- You want specs, plans, tasks, reviews, and merge state stored in the repo.
+- Multiple agents or developers need clear work package boundaries.
+- You want a local workflow first, with optional hosted tracker and sync integrations later.
+
+It is probably overkill for one-off edits, tiny scripts, or teams that do not use Git.
+
+## What It Provides
+
+| Need | Spec Kitty provides |
+| --- | --- |
+| Start from intent | Guided `specify`, `plan`, and `tasks` workflows |
+| Keep agents aligned | Repository-native mission artifacts under `kitty-specs/` |
+| Split implementation | Work packages with lifecycle lanes such as `planned`, `in_progress`, `for_review`, and `done` |
+| Avoid branch chaos | Isolated git worktrees under `.worktrees/` |
+| See progress | Optional local kanban dashboard with `spec-kitty dashboard` |
+| Integrate agents | Slash commands or skills for common AI coding tools |
+
+## Quick Start
+
+Install the CLI:
+
+```bash
+pip install spec-kitty-cli
+# or
+uv tool install spec-kitty-cli
+```
+
+Create or initialize a project:
+
+```bash
+spec-kitty init my-project --ai claude
+cd my-project
+spec-kitty verify-setup
+```
+
+Replace `claude` with your agent key when needed. Common choices include `codex`, `cursor`, `gemini`, `copilot`, `opencode`, `qwen`, `windsurf`, `kiro`, and `vibe`.
+
+Open your AI coding agent in the project and run the core workflow:
+
+```text
+/spec-kitty.charter
+/spec-kitty.specify Build a small task list app.
+/spec-kitty.plan
+/spec-kitty.tasks
+```
+
+Then let the runtime choose the next action until the mission is ready:
+
+```bash
+spec-kitty next --agent claude --mission <mission-slug>
+```
+
+Review, accept, and merge:
+
+```text
+/spec-kitty.review
+/spec-kitty.accept
+/spec-kitty.merge --push
+```
+
+For the full walkthrough, see [Your First Feature](docs/tutorials/your-first-feature.md).
+
+## Everyday Commands
+
+| Command | Purpose |
+| --- | --- |
+| `spec-kitty init . --ai <agent>` | Add Spec Kitty to the current repo |
+| `spec-kitty verify-setup` | Check local installation and project wiring |
+| `spec-kitty dashboard` | Open the local mission dashboard |
+| `spec-kitty next --agent <agent> --mission <slug>` | Ask Spec Kitty what the agent should do next |
+| `spec-kitty upgrade` | Update an existing project after upgrading the CLI |
+| `spec-kitty --help` | Show available commands |
+
+## Documentation
+
+Start here:
+
+- [Getting Started](docs/tutorials/getting-started.md)
+- [Your First Feature](docs/tutorials/your-first-feature.md)
+- [CLI Command Reference](docs/reference/cli-commands.md)
+- [Slash Commands](docs/reference/slash-commands.md)
+- [Supported Agents](docs/reference/supported-agents.md)
+- [Dashboard Guide](docs/how-to/use-dashboard.md)
+- [Install and Upgrade](docs/how-to/install-and-upgrade.md)
+
+Deeper topics:
+
+- [Spec-Driven Development](docs/explanation/spec-driven-development.md)
+- [Mission System](docs/explanation/mission-system.md)
+- [Git Worktrees](docs/explanation/git-worktrees.md)
+- [Multi-Agent Orchestration](docs/explanation/multi-agent-orchestration.md)
+- [External Orchestrator Runbook](docs/how-to/run-external-orchestrator.md)
+- [Hosted Sync Workspaces](docs/how-to/sync-workspaces.md)
+
+## Development
+
+```bash
+git clone https://github.com/Priivacy-ai/spec-kitty.git
+cd spec-kitty
+pip install -e ".[test]"
+```
+
+When testing templates from a source checkout:
+
+```bash
+export SPEC_KITTY_TEMPLATE_ROOT="$(pwd)"
+spec-kitty init my-project --ai claude
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
+
+## Support
+
+- Open a [GitHub issue](https://github.com/Priivacy-ai/spec-kitty/issues/new) for bugs, feature requests, or questions.
+- See [CHANGELOG.md](CHANGELOG.md) for release notes.
+- See [CONTRIBUTORS.md](CONTRIBUTORS.md) and the [GitHub contributors graph](https://github.com/Priivacy-ai/spec-kitty/graphs/contributors) for contributor credits.
+
+## License
+
+Spec Kitty is released under the [MIT License](LICENSE).

spec_kitty_cli-3.2.0rc2/kitty-specs/stable-320-release-blocker-cleanup-01KQW4DF/tasks/README.md

@@ -0,0 +1,64 @@
+# Tasks Directory
+
+This directory contains work package (WP) prompt files.
+
+## Directory Structure (v0.9.0+)
+
+```
+tasks/
+├── WP01-setup-infrastructure.md
+├── WP02-user-authentication.md
+├── WP03-api-endpoints.md
+└── README.md
+```
+
+All WP files are stored flat in `tasks/`. Status is tracked in `status.events.jsonl`, not in WP frontmatter.
+
+## Work Package File Format
+
+Each WP file **MUST** use YAML frontmatter:
+
+```yaml
+---
+work_package_id: "WP01"
+title: "Work Package Title"
+dependencies: []
+planning_base_branch: "main"
+merge_target_branch: "main"
+branch_strategy: "Planning artifacts were generated on main; completed changes must merge back into main."
+subtasks:
+  - "T001"
+  - "T002"
+phase: "Phase 1 - Setup"
+assignee: ""
+agent: ""
+shell_pid: ""
+history:
+  - timestamp: "2025-01-01T00:00:00Z"
+    agent: "system"
+    action: "Prompt generated via /spec-kitty.tasks"
+---
+
+# Work Package Prompt: WP01 – Work Package Title
+
+[Content follows...]
+```
+
+## Status Tracking
+
+Status is tracked via the canonical event log (`status.events.jsonl`), not in WP frontmatter.
+Use `spec-kitty agent tasks move-task` to change WP status:
+
+```bash
+spec-kitty agent tasks move-task <WPID> --to <lane>
+```
+
+Example:
+```bash
+spec-kitty agent tasks move-task WP01 --to doing
+```
+
+## File Naming
+
+- Format: `WP01-kebab-case-slug.md`
+- Examples: `WP01-setup-infrastructure.md`, `WP02-user-auth.md`

spec_kitty_cli-3.2.0rc2/kitty-specs/unified-charter-bundle-chokepoint-01KP5Q2G/tasks/README.md

@@ -0,0 +1,64 @@
+# Tasks Directory
+
+This directory contains work package (WP) prompt files.
+
+## Directory Structure (v0.9.0+)
+
+```
+tasks/
+├── WP01-setup-infrastructure.md
+├── WP02-user-authentication.md
+├── WP03-api-endpoints.md
+└── README.md
+```
+
+All WP files are stored flat in `tasks/`. Status is tracked in `status.events.jsonl`, not in WP frontmatter.
+
+## Work Package File Format
+
+Each WP file **MUST** use YAML frontmatter:
+
+```yaml
+---
+work_package_id: "WP01"
+title: "Work Package Title"
+dependencies: []
+planning_base_branch: "main"
+merge_target_branch: "main"
+branch_strategy: "Planning artifacts were generated on main; completed changes must merge back into main."
+subtasks:
+  - "T001"
+  - "T002"
+phase: "Phase 1 - Setup"
+assignee: ""
+agent: ""
+shell_pid: ""
+history:
+  - timestamp: "2025-01-01T00:00:00Z"
+    agent: "system"
+    action: "Prompt generated via /spec-kitty.tasks"
+---
+
+# Work Package Prompt: WP01 – Work Package Title
+
+[Content follows...]
+```
+
+## Status Tracking
+
+Status is tracked via the canonical event log (`status.events.jsonl`), not in WP frontmatter.
+Use `spec-kitty agent tasks move-task` to change WP status:
+
+```bash
+spec-kitty agent tasks move-task <WPID> --to <lane>
+```
+
+Example:
+```bash
+spec-kitty agent tasks move-task WP01 --to doing
+```
+
+## File Naming
+
+- Format: `WP01-kebab-case-slug.md`
+- Examples: `WP01-setup-infrastructure.md`, `WP02-user-auth.md`

{spec_kitty_cli-3.2.0rc1 → spec_kitty_cli-3.2.0rc2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "spec-kitty-cli"
-version = "3.2.0rc1"
+version = "3.2.0rc2"
 description = "Spec Kitty, a tool for Specification Driven Development (SDD) agentic projects, with kanban and git worktree isolation."
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -70,7 +70,9 @@ dependencies = [
     # src/specify_cli/next/_internal_runtime/ (see WP01 of mission
     # shared-package-boundary-cutover-01KQ22DS), and absence is enforced by
     # tests/architectural/test_pyproject_shape.py.
-    "spec-kitty-events>=4.0.0,<5.0.0",
+    # TeamSpace dry-run requires spec-kitty-events>=5.0.0 at runtime; keep
+    # this as a public bounded range until 5.0.0 is published on PyPI.
+    "spec-kitty-events>=4.0.0,<6.0.0",
     "spec-kitty-tracker>=0.4,<0.5",
     "websockets>=12.0",  # WebSocket client for sync protocol
     "toml>=0.10.2",  # Config file parsing
@@ -138,6 +140,7 @@ artifacts = [
     "src/specify_cli/**/*.yaml",
     "src/specify_cli/**/*.yml",
     "src/specify_cli/**/*.json",
+    "src/specify_cli/**/*.jsonl",
     "src/charter/**/*.yaml",
     "src/charter/**/*.yml",
     "src/doctrine/**/*.md",

{spec_kitty_cli-3.2.0rc1 → spec_kitty_cli-3.2.0rc2}/src/specify_cli/audit/__init__.py

@@ -1,15 +1,25 @@
 """Read-only mission-state audit engine for spec-kitty."""
 
 from .engine import run_audit
-from .models import AuditOptions, MissionFinding, MissionAuditResult, RepoAuditReport, Severity
+from .models import (
+    TEAMSPACE_BLOCKER_CODES,
+    AuditOptions,
+    MissionAuditResult,
+    MissionFinding,
+    RepoAuditReport,
+    Severity,
+    is_teamspace_blocker,
+)
 from .serializer import build_report_json
 
 __all__ = [
     "run_audit",
+    "TEAMSPACE_BLOCKER_CODES",
     "AuditOptions",
     "MissionFinding",
     "MissionAuditResult",
     "RepoAuditReport",
     "Severity",
     "build_report_json",
+    "is_teamspace_blocker",
 ]

{spec_kitty_cli-3.2.0rc1 → spec_kitty_cli-3.2.0rc2}/src/specify_cli/audit/engine.py

@@ -46,7 +46,13 @@ from .classifiers.wp_files import classify_wp_files
 from .identity_adapter import (
     identity_state_to_findings,
 )
-from .models import AuditOptions, MissionAuditResult, MissionFinding, RepoAuditReport
+from .models import (
+    AuditOptions,
+    MissionAuditResult,
+    MissionFinding,
+    RepoAuditReport,
+    is_teamspace_blocker,
+)
 
 
 # ---------------------------------------------------------------------------
@@ -370,15 +376,22 @@ def _build_report(mission_results: list[MissionAuditResult]) -> RepoAuditReport:
     )
 
     severity_counts: dict[str, int] = {"error": 0, "warning": 0, "info": 0}
+    teamspace_blocker_count = 0
     for r in mission_results:
         for f in r.findings:
             severity_counts[f.severity.value] += 1
+            if is_teamspace_blocker(f):
+                teamspace_blocker_count += 1
 
     repo_summary: dict[str, Any] = {
         "total_missions": len(mission_results),
         "missions_with_errors": sum(1 for r in mission_results if r.has_errors),
         "missions_with_warnings": sum(1 for r in mission_results if r.has_warnings),
+        "missions_with_teamspace_blockers": sum(
+            1 for r in mission_results if r.has_teamspace_blockers
+        ),
         "total_findings": sum(len(r.findings) for r in mission_results),
+        "teamspace_blockers": teamspace_blocker_count,
         "findings_by_severity": severity_counts,
     }
 

spec_kitty_cli-3.2.0rc2/src/specify_cli/audit/fixtures/clean_modern/meta.json

@@ -0,0 +1,8 @@
+{
+  "friendly_name": "Clean modern fixture",
+  "mission_id": "01KQHRB8GCFJAX7HM4ZY52AQGR",
+  "mission_number": 1,
+  "mission_slug": "clean_modern",
+  "mission_type": "software-dev",
+  "target_branch": "main"
+}

spec_kitty_cli-3.2.0rc2/src/specify_cli/audit/fixtures/corrupt_jsonl/meta.json

@@ -0,0 +1,8 @@
+{
+  "friendly_name": "Corrupt JSONL fixture",
+  "mission_id": "01KQHRC0GCFJAX7HM4ZY52AQGR",
+  "mission_number": 4,
+  "mission_slug": "corrupt_jsonl",
+  "mission_type": "software-dev",
+  "target_branch": "main"
+}

spec_kitty_cli-3.2.0rc2/src/specify_cli/audit/fixtures/corrupt_jsonl/status.events.jsonl

@@ -0,0 +1 @@
+THIS IS NOT VALID JSON {{{

spec_kitty_cli-3.2.0rc2/src/specify_cli/audit/fixtures/forbidden_event_type/meta.json

@@ -0,0 +1,8 @@
+{
+  "friendly_name": "Forbidden event type fixture",
+  "mission_id": "01KQHRB7GCFJAX7HM4ZY52AQGR",
+  "mission_number": 3,
+  "mission_slug": "forbidden_event_type",
+  "mission_type": "software-dev",
+  "target_branch": "main"
+}

spec_kitty_cli-3.2.0rc2/src/specify_cli/audit/fixtures/forbidden_event_type/status.events.jsonl

@@ -0,0 +1 @@
+{"event_type":"wp_transition","mission_id":"01KQHRB7GCFJAX7HM4ZY52AQGR","wp_id":"WP01"}