pactkit 2.15.2__tar.gz → 2.16.0__tar.gz

{pactkit-2.15.2 → pactkit-2.16.0}/CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to PactKit will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [2.16.0] - 2026-07-13
+
+### Added
+- **`/project-debug` command** (STORY-slim-133) — Hypothesis-driven troubleshooting skill. Structured loop: Symptom → Hypothesize (≤3) → Verify (executable commands) → Narrow → Root Cause. Enforces evidence-gated file access (no aimless reading) and convergence guarantees (escalates to `/project-plan` if stuck after 3 iterations). Uses sonnet model with structured protocol.
+
 ## [2.15.2] - 2026-07-02
 
 ### Changed

{pactkit-2.15.2 → pactkit-2.16.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pactkit
-Version: 2.15.2
+Version: 2.16.0
 Summary: Spec-driven agentic DevOps toolkit for AI coding assistants
 Project-URL: Homepage, https://pactkit.dev
 Project-URL: Repository, https://github.com/pactkit/pactkit-public

{pactkit-2.15.2 → pactkit-2.16.0}/docs/architecture/governance/archive/lessons_archive_202603.md

@@ -66,3 +66,4 @@
 | 2026-03-26 | DeployerBase static methods use lazy imports to avoid circular dependencies between deploy_base.py and deployer.py | deploy_base.py:DeployerBase.render_prompt |
 | 2026-03-26 | Thin adapter conversion: pactkit-codex reduced from 15,356 lines (full fork) to 668 lines (thin adapter) by importing core via DeployerBase. Key: deploy_codex_playbooks needs explicit path replacement for ALL format prefixes (~/.claude/, ~/.config/opencode/ → ~/.codex/) | pactkit_codex/deployer.py:deploy_codex_playbooks |
 | 2026-03-27 | When migrating commands to skills (subdir/SKILL.md format), all path assertions in pre-existing tests must be updated in the same commit — 17 tests broke because they asserted flat commands/*.md paths | deployer.py:_deploy_commands |
+| 2026-03-30 | Frontend API path convention bugs are structurally preventable: ApiCallParser+api_convention_summary in trace phase surfaces prefix/wrapper conventions before implementation, eliminating a class of copy-paste path errors | visualize.py:ApiCallParser |

{pactkit-2.15.2 → pactkit-2.16.0}/docs/architecture/governance/lessons.md

@@ -2,7 +2,6 @@
 
 | Date | Lesson | Context |
 |------|--------|---------|
-| 2026-03-30 | Frontend API path convention bugs are structurally preventable: ApiCallParser+api_convention_summary in trace phase surfaces prefix/wrapper conventions before implementation, eliminating a class of copy-paste path errors | visualize.py:ApiCallParser |
 | 2026-03-31 | Rendering-only changes to visualize.py can be isolated by extracting a shared render helper (_render_nested_call_graph) that both forward and reverse BFS call — keeps AST parsing untouched | visualize.py:_render_nested_call_graph |
 | 2026-03-31 | dict.update() on call_edges causes last-wins overwrite when scanning same-name functions across files; use extend-merge pattern instead | visualize.py:_build_call_graph |
 | 2026-03-31 | CLI args must mirror visualize.py standalone argparse; feature implemented in visualize.py but not exposed in cli.py is effectively dead code | cli.py:viz_parser |
@@ -53,3 +52,4 @@
 | 2026-06-10 | Engineering guides are additive: new GUIDES_FILES entries auto-deploy via _deploy_guides() without deployer changes. Test impact limited to count assertions in test_story_slim128. | src/pactkit/prompts/guides.py:GUIDES_FILES |
 | 2026-06-29 | Large @inject rules (architecture 11KB, solution 8.4KB, engineering 4.3KB) removed from COMMAND_RULES_MAP — loaded on-demand via Read in playbooks. Saves ~12,500 tokens/PDCA session. | src/pactkit/prompts/rules.py:COMMAND_RULES_MAP |
 | 2026-07-02 | Hardcoding external tool CLI commands in SKILL_VISUALIZE_MD and deployer.py creates upgrade coupling — replaced with codegraph --help runtime discovery in _build_claude_md_managed_content() | src/pactkit/generators/deployer.py:_build_claude_md_managed_content |
+| 2026-07-13 | Adding project-debug required updating VALID_COMMANDS in config.py, VALID_SKILLS, COMMANDS_CONTENT registration in commands.py, and COMMAND_RULES_MAP in rules.py — plus 6 test files with hardcoded count assertions | src/pactkit/config.py:VALID_COMMANDS, src/pactkit/prompts/rules.py:COMMAND_RULES_MAP |

{pactkit-2.15.2 → pactkit-2.16.0}/docs/architecture/governance/rules.md

@@ -15,7 +15,7 @@
 
 ## Invariants
 
-1. All 4032+ tests must pass before any commit to `main`.
+1. All 4037+ tests must pass before any commit to `main`.
 2. Specs (`docs/specs/`) are the source of truth — code conforms to specs, not the reverse.
 3. CLI entry point is `pactkit` via `src/pactkit/cli.py:main`.
 4. No runtime dependencies beyond `pyyaml`.

{pactkit-2.15.2 → pactkit-2.16.0}/docs/product/archive/archive_202607.md

@@ -11,3 +11,10 @@
 > Spec: docs/specs/HOTFIX-slim-130.md
 
 - [x] Move @ references below YAML frontmatter block in all project-* skills
+
+### [STORY-slim-133] Structured Debug Skill (Hypothesis-Driven Troubleshooting)
+> Spec: docs/specs/STORY-slim-133.md
+
+- [x] Create SKILL.md protocol with all phases
+- [x] Add to routing table in pactkit.md
+- [x] Register in available-skills list

{pactkit-2.15.2 → pactkit-2.16.0}/docs/product/context.md

@@ -1,8 +1,8 @@
 # Project Context (Auto-generated)
-> Last updated: 2026-07-02T11:00:51+08:00 by pactkit context
+> Last updated: 2026-07-13T17:51:18+08:00 by pactkit context
 
 ## Sprint Status
-Backlog: 4 | In Progress: 0 | Done: 0 stories
+Backlog: 5 | In Progress: 0 | Done: 0 stories
 
 ## Current Stories
 None
@@ -16,11 +16,11 @@ None
 * main
 
 ## Key Decisions
-- codegraph sync must be enforced by code (pactkit visualize/sync), not by prompt instructions — prompt-only enforcement is unreliable for deterministic operations
 - Managed-block pattern (start/end markers + regex replace) is the canonical way to update mixed-ownership files — same pattern for CLAUDE.md and CLAUDE.local.md
 - Engineering guides are additive: new GUIDES_FILES entries auto-deploy via _deploy_guides() without deployer changes. Test impact limited to count assertions in test_story_slim128.
 - Large @inject rules (architecture 11KB, solution 8.4KB, engineering 4.3KB) removed from COMMAND_RULES_MAP — loaded on-demand via Read in playbooks. Saves ~12,500 tokens/PDCA session.
 - Hardcoding external tool CLI commands in SKILL_VISUALIZE_MD and deployer.py creates upgrade coupling — replaced with codegraph --help runtime discovery in _build_claude_md_managed_content()
+- Adding project-debug required updating VALID_COMMANDS in config.py, VALID_SKILLS, COMMANDS_CONTENT registration in commands.py, and COMMAND_RULES_MAP in rules.py — plus 6 test files with hardcoded count assertions
 
 ## Next Recommended Action
 `/project-plan`

{pactkit-2.15.2 → pactkit-2.16.0}/docs/product/sprint_board.md

@@ -31,7 +31,6 @@
 
 - [ ] Fix _deploy_commands prepend order
 
-
 ### [HOTFIX-slim-132] Add explicit board.py move_story command to project-act
 > Spec: docs/specs/HOTFIX-slim-132.md
 

pactkit-2.16.0/docs/specs/STORY-slim-133.md

@@ -0,0 +1,152 @@
+# STORY-slim-133: Structured Debug Skill with Hypothesis-Driven Troubleshooting
+
+| Field | Value |
+|-------|-------|
+| ID | STORY-slim-133 |
+| Status | Done |
+| Priority | P1 |
+| Release | 2.16.0 |
+
+## Background
+
+当前 troubleshooting 流程存在两个核心问题：
+1. **假设发散不收敛** — AI 列出大量可能原因但不逐个验证排除，导致排查停滞
+2. **信息过载** — 漫无目的地 grep/read 大量文件，消耗 token 但不推进定位
+
+现有工具覆盖不了这个场景：
+- `pactkit-trace` 是静态分析工具，前提是"已知要看哪里"
+- `pactkit-doctor` 仅做项目健康检查
+- `system-medic` 仅处理环境/配置问题
+- `project-hotfix` 前提是"已定位到问题"
+
+需要一个**从症状到根因**的结构化排查 skill，强制走「假设→验证→缩小」循环，用 opus 模型的强推理能力替代漫无目的的搜索。
+
+## Requirements
+
+### R1: Hypothesis-Driven Loop (MUST)
+
+Skill MUST enforce a structured loop: Observe → Hypothesize (≤3) → Verify (executable command per hypothesis) → Narrow. Each hypothesis MUST have a concrete verification step (a runnable command or code inspection with expected vs actual outcome). Skill MUST NOT proceed to the next hypothesis without executing verification on the current one first.
+
+### R2: Evidence-Gated File Access (MUST)
+
+Every file read MUST be justified by a stated hypothesis or evidence trail. Skill MUST NOT read files "to get familiar with the codebase" or "to understand the context" without linking to a specific hypothesis being tested — violation of this produces the exact "查不到点子上" problem this skill solves.
+
+### R3: Structured Input Protocol (MUST)
+
+Skill MUST provide a structured input template that minimizes user typing while capturing critical debugging info:
+- **Symptom**: What's happening (error message, unexpected behavior)
+- **Expected**: What should happen instead
+- **Reproduction**: How to trigger it (command, URL, input)
+- **Context**: What changed recently (optional)
+
+When user provides raw text instead of structured input, skill MUST extract and organize into this structure before proceeding.
+
+### R4: Convergence Guarantee (MUST)
+
+Each loop iteration MUST reduce the hypothesis space. If after 3 iterations no hypothesis is confirmed, skill MUST escalate:
+- **Round 1 escalation**: ask user for more information (additional symptoms, reproduction steps)
+- **Round 2 escalation (still stuck)**: nudge to `/project-plan` — "This looks like a cross-module issue that needs full architectural trace."
+
+MUST NOT loop indefinitely on the same hypothesis set. The skill's job is fast triage, not deep surgery.
+
+### R5: Model Selection (MUST)
+
+Skill MUST specify `model: sonnet` in SKILL.md frontmatter. Sonnet + structured protocol handles 80% of common bugs. For complex cross-module issues that don't converge, the escalation path is `/project-plan` (full PDCA with trace), not model upgrade.
+
+### R6: Concluding Report (MUST)
+
+Upon locating root cause, skill MUST output a structured conclusion:
+- **Root Cause**: One-sentence statement
+- **Evidence**: The verification step that confirmed it
+- **Fix Path**: Concrete next action (file:line to change, or command to run)
+- **PDCA Nudge**: Recommend `/project-hotfix` or `/project-act` as appropriate
+
+### R7: Codegraph Integration (SHOULD)
+
+If `.codegraph/` exists, skill SHOULD prefer codegraph for caller/callee analysis over grep during hypothesis verification. Fallback to grep when codegraph is unavailable.
+
+## Acceptance Criteria
+
+### AC1: Hypothesis Loop Enforced (R1, R4)
+
+- **Given** user invokes `/project-debug "tests fail with KeyError on user_id"`
+- **When** the skill starts processing
+- **Then** it outputs: (1) structured symptom summary, (2) ≤3 ranked hypotheses each with a verification command, (3) executes verification commands in order, (4) narrows based on results, (5) converges to root cause within ≤5 iterations
+
+### AC2: No Aimless File Reading (R2)
+
+- **Given** the skill is in a verification phase
+- **When** it needs to read a file
+- **Then** the read is preceded by a one-line justification linking to a hypothesis (e.g., "H2 verification: checking if `models.py:45` validates user_id before access")
+
+### AC3: Structured Input Extraction (R3)
+
+- **Given** user provides unstructured text like "部署之后接口报500了"
+- **When** the skill receives this input
+- **Then** it extracts and formats into the 4-field template, asks for missing critical fields (Reproduction), and does NOT start hypothesizing until Symptom is clear
+
+### AC4: Convergence Escalation (R4)
+
+- **Given** 3 iterations have passed without confirming a hypothesis
+- **When** the skill enters the 4th iteration
+- **Then** it asks user for more info; if still stuck after 1 more round, it nudges `/project-plan` with a summary of what was tried and ruled out
+
+### AC5: Sonnet Model with PDCA Escalation (R5)
+
+- **Given** the SKILL.md file exists at `~/.claude/skills/project-debug/SKILL.md`
+- **When** inspecting the frontmatter
+- **Then** the `model` field is set to `sonnet`
+
+### AC6: Conclusion Report Format (R6)
+
+- **Given** root cause has been identified through the verification loop
+- **When** the skill outputs its conclusion
+- **Then** it includes all 4 fields: Root Cause (one sentence), Evidence (which verification confirmed it), Fix Path (file:line or command), and PDCA Nudge (appropriate command recommendation)
+
+### AC7: Codegraph Preferred When Available (R7)
+
+- **Given** the project has `.codegraph/` directory
+- **When** the skill needs to trace callers/callees during verification
+- **Then** it uses `codegraph` CLI instead of raw grep
+
+## Target Call Chain
+
+```
+User invokes /project-debug "$symptom"
+→ SKILL.md protocol loaded (model: opus)
+→ Phase 1: Symptom Structuring (extract/confirm 4-field template)
+→ Phase 2: Hypothesis Generation (≤3, ranked by probability)
+→ Phase 3: Verification Loop (execute → observe → narrow)
+  └─ Loop until: root cause confirmed OR escalation triggered
+→ Phase 4: Conclusion Report (root cause + fix path + PDCA nudge)
+```
+
+No code implementation needed — this is a pure SKILL.md protocol (prompt-as-code for diagnostic reasoning).
+
+## Implementation Steps
+
+| Step | File | Action | Dependencies | Risk |
+|------|------|--------|-------------|------|
+| 1 | `~/.claude/skills/project-debug/SKILL.md` | Create skill protocol with all phases | None | Low |
+| 2 | `~/.claude/rules/pactkit.md` | Add command to routing table | Step 1 | Low |
+| 3 | Board | Register skill in available-skills | Step 1 | Low |
+
+## Security Scope
+
+| Check | Applicable | Reason |
+|-------|------------|--------|
+| SEC-1 (Injection) | N/A | No user input passed to shell unsanitized — verification commands are AI-composed |
+| SEC-2 (Auth) | N/A | No auth logic involved |
+| SEC-3 (Data Exposure) | N/A | Reads local files only |
+| SEC-4 (XSS) | N/A | No web output |
+| SEC-5 (Config) | N/A | No config files modified |
+| SEC-6 (Crypto) | N/A | No crypto involved |
+| SEC-7 (Logging) | N/A | No logging changes |
+| SEC-8 (SSRF) | N/A | No network requests |
+
+## Out of Scope
+
+- 自动修复代码 — skill 仅定位问题，修复走 `/project-hotfix` 或 `/project-act`
+- 环境/配置问题 — 已有 `system-medic` + `pactkit-doctor` 覆盖
+- 性能分析 — 属于另一个专项 skill 的范畴
+- CI/CD pipeline 问题 — 超出本地 debug 范围

{pactkit-2.15.2 → pactkit-2.16.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "pactkit"
-version = "2.15.2"
+version = "2.16.0"
 description = "Spec-driven agentic DevOps toolkit for AI coding assistants"
 readme = "README.md"
 license = "MIT"

{pactkit-2.15.2 → pactkit-2.16.0}/src/pactkit/__init__.py

@@ -1,3 +1,3 @@
 """PactKit - Spec-driven agentic DevOps toolkit."""
 
-__version__ = "2.15.2"
+__version__ = "2.16.0"

{pactkit-2.15.2 → pactkit-2.16.0}/src/pactkit/config.py

@@ -40,6 +40,7 @@ VALID_COMMANDS = frozenset(
         "project-clarify",
         "project-release",
         "project-pr",
+        "project-debug",
     }
 )
 
@@ -71,6 +72,7 @@ VALID_SKILLS = frozenset(
         "project-clarify",
         "project-release",
         "project-pr",
+        "project-debug",
     }
 )
 

{pactkit-2.15.2 → pactkit-2.16.0}/src/pactkit/prompts/commands.py

@@ -1,4 +1,5 @@
 from pactkit.prompts.workflows import (
+    DEBUG_PROMPT,
     DESIGN_PROMPT,
     HOTFIX_PROMPT,
     SPRINT_PROMPT,
@@ -868,3 +869,4 @@ model: sonnet
 COMMANDS_CONTENT["project-sprint.md"] = SPRINT_PROMPT
 COMMANDS_CONTENT["project-hotfix.md"] = HOTFIX_PROMPT
 COMMANDS_CONTENT["project-design.md"] = DESIGN_PROMPT
+COMMANDS_CONTENT["project-debug.md"] = DEBUG_PROMPT

{pactkit-2.15.2 → pactkit-2.16.0}/src/pactkit/prompts/rules.py

@@ -857,6 +857,7 @@ COMMAND_RULES_MAP = {
         "core", "sectional", "hierarchy", "atlas", "routing", "workflow",
         "mcp", "shared", "credential",
     ],
+    "project-debug": ["core", "shared", "credential"],
 }
 
 # Managed file prefixes for rules/ directory cleanup (deployer will clean these, leave user files intact)

{pactkit-2.15.2 → pactkit-2.16.0}/src/pactkit/prompts/workflows.py

@@ -804,3 +804,149 @@ Assign each Story to a horizon:
 - Does NOT enforce a specific tech stack — recommendations only, not mandates
 - Does NOT depend on WebSearch — works entirely from user input
 """
+
+# ==============================================================================
+# 5f. DEBUG PROMPT (STORY-slim-133)
+# ==============================================================================
+DEBUG_PROMPT = """---
+description: "Hypothesis-driven troubleshooting: structured debug from symptom to root cause"
+allowed-tools: [Read, Write, Edit, Bash, Glob, Grep]
+model: sonnet
+---
+@{{SKILLS_PREFIX}}_rules/03-shared-protocols.md
+
+
+# Command: Debug (v1.0.0 Hypothesis-Driven)
+- **Usage**: `/project-debug "$SYMPTOM"`
+- **Agent**: Senior Developer
+
+> **PRINCIPLE**: Debug by scientific method — not by reading everything.
+> Every file read must be justified by a hypothesis. Every hypothesis must have a verification step.
+> If 3 iterations don't converge, escalate to `/project-plan` for full architectural trace.
+
+## ⚠️ Scope of Application
+- ✅ Runtime errors (exceptions, crashes, unexpected behavior)
+- ✅ Test failures (assertion errors, unexpected output)
+- ✅ Logic bugs ("code runs but result is wrong")
+- ✅ Regression ("it worked before, now it doesn't")
+- ❌ Environment/config issues → use `system-medic` + `pactkit-doctor`
+- ❌ Performance issues → out of scope (different diagnostic approach)
+- ❌ Feature design → use `/project-plan`
+
+## 🧠 Phase 1: Symptom Structuring
+> **PURPOSE**: Minimize user input burden — extract structure from whatever they provide.
+
+1.  **Parse Input**: Extract from `$SYMPTOM`:
+    - **Symptom**: What's happening? (error message, traceback, unexpected behavior)
+    - **Expected**: What should happen instead?
+    - **Reproduction**: How to trigger it? (command, input, URL)
+    - **Context**: What changed recently? (recent commit, deploy, dependency update)
+
+2.  **If input is unstructured** (e.g., "接口报500了"):
+    - Extract what you can into the 4-field template
+    - Ask for **only** the critical missing field(s) — typically Reproduction
+    - Do NOT ask for all 4 fields if 2-3 are inferable
+
+3.  **If reproduction command exists**: Run it to capture the actual error output.
+    - This is evidence, not exploration. The output feeds Phase 2.
+
+4.  **Output checkpoint**:
+    ```
+    📋 Symptom Summary:
+    - Symptom: {extracted}
+    - Expected: {extracted or "TBD"}
+    - Reproduction: {command or "need from user"}
+    - Context: {recent changes or "unknown"}
+    ```
+
+## 🔍 Phase 2: Hypothesis Generation
+> **CONSTRAINT**: Maximum 3 hypotheses. Ranked by probability. Each MUST have a verification step.
+
+1.  **Analyze signals** from Phase 1 output:
+    - Error type (KeyError → data shape; ImportError → dependency; AssertionError → logic)
+    - Stack trace location (if available)
+    - Recency of changes (if Context provided)
+
+2.  **Generate ≤3 hypotheses**, format:
+    ```
+    H1 (probability%): {one-sentence hypothesis}
+       Verify: {executable command or specific file:line to check}
+       Expected if true: {what the verification would show}
+       Expected if false: {what it would show instead}
+
+    H2 (probability%): ...
+    H3 (probability%): ...
+    ```
+
+3.  **Hypothesis quality rules**:
+    - Each hypothesis MUST be falsifiable (there must be a way to disprove it)
+    - Verification MUST be a concrete action (not "investigate further" or "look into")
+    - Probabilities must sum to ≤100% (leave room for unknown unknowns)
+
+4.  **Codegraph Priority (R7)**: If `.codegraph/` exists, prefer codegraph for tracing:
+    - `codegraph callers <function>` over `grep -rn "function_name"`
+    - `codegraph callees <function>` for downstream impact
+    - Fallback to grep only if codegraph unavailable
+
+## 🔬 Phase 3: Verification Loop
+> **CONSTRAINT**: One hypothesis at a time. Execute → Observe → Conclude before moving to next.
+
+For each hypothesis (highest probability first):
+
+1.  **Justify** (one line): "Testing H{N}: checking if {hypothesis} by {action}"
+2.  **Execute**: Run the verification command or read the specific file:line
+    - **Evidence-Gated Read (R2)**: Every `Read` call MUST be preceded by:
+      `"H{N} verification: reading {file}:{line} to check {specific thing}"`
+    - MUST NOT read files "for context" or "to understand" without hypothesis link
+3.  **Observe**: Record actual vs expected output
+4.  **Conclude**:
+    - **Confirmed**: Evidence matches "expected if true" → proceed to Phase 4
+    - **Eliminated**: Evidence matches "expected if false" → mark H{N} as eliminated, proceed to next
+    - **Inconclusive**: Neither matches → refine hypothesis, re-verify once
+
+5.  **After each iteration**: State remaining hypothesis space:
+    ```
+    ❌ H1: eliminated (reason)
+    🔍 H2: testing next
+    ⏳ H3: pending
+    ```
+
+## 🚨 Phase 3.5: Convergence Escalation (R4)
+> **TRIGGER**: All initial hypotheses eliminated OR 3 iterations without confirmation.
+
+**Round 1 escalation**:
+- All 3 hypotheses eliminated → generate 2 new hypotheses from a DIFFERENT angle:
+  - If initial hypotheses were "code logic" → try "data/state" angle
+  - If initial were "recent change" → try "upstream dependency" angle
+- Ask user: "Initial hypotheses eliminated. Any additional symptoms or reproduction info?"
+
+**Round 2 escalation** (still stuck after Round 1):
+- Output summary of what was tried and ruled out
+- Nudge: "This looks like a cross-module issue that needs full architectural trace."
+- Recommend: `/project-plan "{problem summary}"` for deep analysis with pactkit-trace
+
+## ✅ Phase 4: Conclusion Report (R6)
+> **TRIGGER**: A hypothesis is confirmed with evidence.
+
+Output structured conclusion:
+```
+🎯 Root Cause
+{One-sentence statement of what's wrong}
+
+📎 Evidence
+{The verification step that confirmed it — command + output}
+
+🔧 Fix Path
+{Concrete next action: file:line to change, or command to run}
+
+💡 Next Step
+{PDCA nudge — recommend /project-hotfix for single-file fix, /project-act for multi-file}
+```
+
+## 🚫 What This Command Does NOT Do
+- Does NOT fix the code — only locates the root cause
+- Does NOT read files without justification — every read is hypothesis-linked
+- Does NOT loop indefinitely — max 2 escalation rounds then hands off to /project-plan
+- Does NOT replace /project-plan — it's fast triage, not deep architecture analysis
+- Does NOT handle environment issues — those go to system-medic
+"""

{pactkit-2.15.2 → pactkit-2.16.0}/tests/unit/test_config.py

@@ -38,15 +38,15 @@ class TestGetDefaultConfig:
         assert len(cfg["agents"]) == 9
 
     def test_default_commands_count(self):
-        # STORY-051: added project-release and project-pr → 11 commands
+        # STORY-slim-133: added project-debug → 12 commands
         cfg = _config().get_default_config()
-        assert len(cfg["commands"]) == 11
+        assert len(cfg["commands"]) == 12
 
     def test_default_skills_count(self):
-        # STORY-slim-063: VALID_SKILLS now includes 11 commands migrated to skills/ subdirs
-        # +pactkit-audit, +pactkit-report = 24 total
+        # STORY-slim-133: VALID_SKILLS now includes 12 commands migrated to skills/ subdirs
+        # +pactkit-audit, +pactkit-report = 25 total
         cfg = _config().get_default_config()
-        assert len(cfg["skills"]) == 24
+        assert len(cfg["skills"]) == 25
 
     def test_default_rules_count(self):
         """8 rule modules (1 merged global + 7 on-demand, post STORY-slim-128)."""

{pactkit-2.15.2 → pactkit-2.16.0}/tests/unit/test_pdca_slim.py

@@ -47,8 +47,8 @@ class TestCommandReduction:
 
     def test_valid_commands_count(self):
         cfg = _config()
-        # STORY-051 adds project-release and project-pr → 11 commands
-        assert len(cfg.VALID_COMMANDS) == 11
+        # STORY-051 adds project-release and project-pr; STORY-slim-133 adds project-debug → 12 commands
+        assert len(cfg.VALID_COMMANDS) == 12
 
     def test_kept_commands_present(self):
         cfg = _config()
@@ -61,9 +61,9 @@ class TestCommandReduction:
             assert cmd not in cfg.VALID_COMMANDS, f"Should be removed: {cmd}"
 
     def test_commands_content_count(self):
-        """STORY-051: COMMANDS_CONTENT should have 11 entries (added project-release, project-pr)."""
+        """STORY-051: COMMANDS_CONTENT should have 12 entries (added project-release, project-pr, project-debug)."""
         p = _prompts()
-        assert len(p.COMMANDS_CONTENT) == 11
+        assert len(p.COMMANDS_CONTENT) == 12
 
     def test_removed_commands_not_in_content(self):
         p = _prompts()
@@ -97,9 +97,9 @@ class TestSkillPromotion:
     }
 
     def test_valid_skills_count(self):
-        # +pactkit-audit, +pactkit-report = 24 total (13 embedded + 11 commands)
+        # +pactkit-audit, +pactkit-report = 25 total (13 embedded + 12 commands)
         cfg = _config()
-        assert len(cfg.VALID_SKILLS) == 24
+        assert len(cfg.VALID_SKILLS) == 25
 
     def test_new_skills_present(self):
         cfg = _config()
@@ -137,16 +137,16 @@ class TestSkillPromotion:
                 f"{var_name} should have YAML frontmatter"
 
     def test_default_config_has_10_skills(self):
-        # +pactkit-audit, +pactkit-report = 24 total (13 embedded + 11 commands)
+        # +pactkit-audit, +pactkit-report = 25 total (13 embedded + 12 commands)
         cfg = _config()
         default = cfg.get_default_config()
-        assert len(default['skills']) == 24
+        assert len(default['skills']) == 25
 
     def test_default_config_has_9_commands(self):
-        """STORY-051: default config now has 11 commands (added project-release, project-pr)."""
+        """STORY-slim-133: default config now has 12 commands (added project-debug)."""
         cfg = _config()
         default = cfg.get_default_config()
-        assert len(default['commands']) == 11
+        assert len(default['commands']) == 12
 
 
 # ===========================================================================

{pactkit-2.15.2 → pactkit-2.16.0}/tests/unit/test_prompt_structural_invariants.py

@@ -118,8 +118,8 @@ class TestPromptModuleCounts:
         assert len(prompts.RULES_MODULES) == 14
 
     def test_command_count(self):
-        """STORY-051: Should have 11 command playbooks (added project-release, project-pr)."""
-        assert len(prompts.COMMANDS_CONTENT) == 11
+        """STORY-slim-133: Should have 12 command playbooks (added project-debug)."""
+        assert len(prompts.COMMANDS_CONTENT) == 12
 
     def test_agent_count(self):
         """Should have 9 agent definitions."""

{pactkit-2.15.2 → pactkit-2.16.0}/tests/unit/test_selective_deploy.py

@@ -253,19 +253,18 @@ class TestConfigAutoGeneration:
 
 class TestDeploymentSummary:
     def test_summary_printed_full(self, tmp_path, capsys):
-        # STORY-slim-063: summary format changed to unified Skills count
-        # +pactkit-audit, +pactkit-report = 24 total (13 embedded + 11 commands)
+        # STORY-slim-133: 25 total (13 embedded + 12 commands)
         # Post STORY-slim-128: 8 rules (1 merged global + 7 on-demand)
         _run_deploy(tmp_path, config=get_default_config())
         output = capsys.readouterr().out
         assert "9/9 Agents" in output
-        assert "24/24 Skills" in output
+        assert "25/25 Skills" in output
         assert "13 embedded" in output
-        assert "11 commands" in output
+        assert "12 commands" in output
         assert "8/8 Rules" in output
 
     def test_summary_printed_partial(self, tmp_path, capsys):
-        # +pactkit-audit, +pactkit-report = 24 total (13 embedded + 11 commands)
+        # STORY-slim-133: 25 total (13 embedded + 12 commands)
         cfg = get_default_config()
         cfg["agents"] = ["system-architect", "senior-developer"]
         cfg["commands"] = ["project-plan", "project-act", "project-done"]
@@ -273,8 +272,8 @@ class TestDeploymentSummary:
         _run_deploy(tmp_path, config=cfg)
         output = capsys.readouterr().out
         assert "2/9 Agents" in output
-        # 13 embedded skills + 3 commands = 16 total skills deployed out of 24
-        assert "16/24 Skills" in output
+        # 13 embedded skills + 3 commands = 16 total skills deployed out of 25
+        assert "16/25 Skills" in output
 
 
 # ===========================================================================

{pactkit-2.15.2 → pactkit-2.16.0}/tests/unit/test_status_command.py

@@ -158,6 +158,6 @@ class TestBackwardCompatibility:
             assert cmd in p.COMMANDS_CONTENT, f"Missing {cmd}"
 
     def test_total_command_count(self):
-        """STORY-051: 11 commands total (added project-release, project-pr)."""
+        """STORY-slim-133: 12 commands total (added project-debug)."""
         cfg = _config()
-        assert len(cfg.VALID_COMMANDS) == 11
+        assert len(cfg.VALID_COMMANDS) == 12

{pactkit-2.15.2 → pactkit-2.16.0}/tests/unit/test_story063_prompt_slimming.py

@@ -215,7 +215,8 @@ class TestAC6DevRefGhostResolved:
 # HOTFIX-slim-127: bumped +280 for codegraph sync in Done Phase 2 + Hotfix Phase 3.6
 # STORY-slim-128: bumped +1650 for Engineering Concerns phases in Plan Phase 2 + Act Phase 1.5
 # Context slim: +170 for explicit {SKILLS_ROOT}/_rules/ paths in on-demand Read references
-BASELINE_TOTAL_CHARS = 92264
+# STORY-slim-133: bumped +8000 for new project-debug command (~4.5K chars, headroom for iteration)
+BASELINE_TOTAL_CHARS = 100264
 
 
 class TestAC7PromptSizeReduced:

pactkit-2.16.0/tests/unit/test_story133_debug_skill.py

@@ -0,0 +1,35 @@
+"""STORY-slim-133: project-debug skill registration and deployment.
+
+Tests verify that:
+- project-debug is registered in VALID_COMMANDS (TC-1)
+- project-debug SKILL.md source template exists in deployer (TC-2)
+- Deployed SKILL.md contains required frontmatter (TC-3)
+"""
+from pactkit.config import VALID_COMMANDS
+from pactkit.generators.deployer import _deploy_commands
+
+
+class TestDebugSkillRegistered:
+    """TC-1: project-debug is in VALID_COMMANDS."""
+
+    def test_project_debug_in_valid_commands(self):
+        assert "project-debug" in VALID_COMMANDS
+
+
+class TestDebugSkillDeploys:
+    """TC-2/TC-3: project-debug deploys with correct frontmatter."""
+
+    def test_deploy_creates_debug_skill(self, tmp_path):
+        commands_dir = tmp_path / "commands"
+        commands_dir.mkdir()
+        _deploy_commands(commands_dir, ["project-debug"])
+        # Classic profile deploys as subdirectory/SKILL.md
+        skill_file = commands_dir / "project-debug" / "SKILL.md"
+        assert skill_file.is_file(), "project-debug/SKILL.md not deployed"
+
+    def test_deployed_frontmatter_has_sonnet_model(self, tmp_path):
+        commands_dir = tmp_path / "commands"
+        commands_dir.mkdir()
+        _deploy_commands(commands_dir, ["project-debug"])
+        content = (commands_dir / "project-debug" / "SKILL.md").read_text()
+        assert "model: sonnet" in content

{pactkit-2.15.2 → pactkit-2.16.0}/tests/unit/test_story_slim063.py

@@ -60,7 +60,7 @@ class TestAC2ValidSkillsContainsAll:
     def test_valid_skills_count(self):
         from pactkit.config import VALID_SKILLS
 
-        assert len(VALID_SKILLS) == 24
+        assert len(VALID_SKILLS) == 25
 
     def test_commands_in_valid_skills(self):
         from pactkit.config import VALID_COMMANDS, VALID_SKILLS