pactkit 2.10.6__tar.gz → 2.12.0__tar.gz

{pactkit-2.10.6 → pactkit-2.12.0}/.github/workflows/pactkit.yml

@@ -20,7 +20,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[visualize]"
+          pip install -e .
           pip install pytest ruff
           pactkit init
 

{pactkit-2.10.6 → pactkit-2.12.0}/.opencode/pactkit.yaml

@@ -2,7 +2,6 @@
 # Edit this file to customize which components are deployed.
 # Remove items from a list to disable them. Default: all enabled.
 
-version: "2.10.4"
 stack: python
 root: .
 developer: "slim"
@@ -72,6 +71,15 @@ rules:
   - 08-architecture-principles
   - 09-sectional-write
   - 11-pdca-nudge
+  - 12-solution-design
+  - 05-principles
+  - 01-workflow-conventions
+  - 02-mcp-integration
+  - 03-shared-protocols
+  - 04-architecture-principles
+  - 05-sectional-write
+  - 06-solution-design
+  - pactkit
 
 # CI/CD — set provider to github or gitlab to generate pipeline config
 ci:
@@ -85,12 +93,6 @@ ci:
 issue_tracker:
   provider: github
 
-# Hooks — safe, report-only hook templates (command-type only)
-hooks:
-  post_test_coverage: false
-  pre_commit_lint: false
-  pre_push_check: false
-
 # Lint — configure lint behavior in /project-done
 lint_blocking: false
 auto_fix: false
@@ -163,3 +165,7 @@ e2e:
   env_file: .env.test
   test_dir: tests/e2e
   type: none
+hooks:
+  post_test_coverage: false
+  pre_commit_lint: false
+  pre_push_check: false

{pactkit-2.10.6 → pactkit-2.12.0}/CHANGELOG.md

@@ -4,6 +4,26 @@ All notable changes to PactKit will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [2.12.0] - 2026-05-06
+
+### Changed
+- **Rules architecture refactor** (STORY-slim-112) — Merged 6 global core rules into single `pactkit.md`; on-demand rules renumbered 01-06 and moved to `~/.claude/skills/_rules/`. Reduces context window usage by ~60% per conversation.
+- **Auto-deploy on version mismatch** — After `pipx upgrade pactkit`, the next CLI command auto-syncs deployed files without requiring explicit `pactkit init`.
+
+### Fixed
+- **Hardcoded paths in deployer** — `_build_command_rules_header()` now uses `FormatProfile.rules_dir` / `skills_dir` instead of hardcoded `~/.claude/` paths.
+- **Stale filename references** — Updated cross-references in visualize.py, commands.py, lazy_visualize.py, and test files to match new rule filenames.
+
+## [2.11.0] - 2026-04-25
+
+### Added
+- **Lateral Scan** (STORY-slim-106) — Plan Phase 1 now scans for duplicate patterns before writing Specs. If overlap > 30% with existing implementations, Spec must include `R0: Extract shared abstraction` or declare tech debt accepted. Removed dead hooks code from rules.
+- **DEFERRED comment mechanism** (STORY-slim-105) — When skipping a SHOULD requirement, code must include `# DEFERRED(SHOULD): R{N} — reason` comment. Coverage table output added to Check phase for tracking deferred items.
+
+### Fixed
+- **Residual pactkit.yaml version operations** (HOTFIX-slim-107) — Removed `update_version()` function and CLI subcommand from board.py, plus all stale references in prompts, agents, and skills docs. Version is now exclusively managed in pyproject.toml + __init__.py with deploy marker at ~/.claude/.pactkit-version.
+- **CI tree-sitter deps** — Install tree-sitter optional dependencies in CI workflow to prevent import failures.
+
 ## [2.10.6] - 2026-04-22
 
 ### Fixed

{pactkit-2.10.6 → pactkit-2.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pactkit
-Version: 2.10.6
+Version: 2.12.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
@@ -369,7 +369,6 @@ docs/
 | Field | Type | Default | Description |
 |-------|------|---------|-------------|
 | `stack` | string | auto-detected | Project stack (`python`, `node`, `go`, `java`) |
-| `version` | string | current | PactKit version that generated the config |
 | `developer` | string | `""` | Developer prefix for Story IDs (multi-developer collaboration) |
 | `agents` | list | all 9 | Agent definitions to deploy |
 | `commands` | list | all 11 | Command playbooks to deploy |

{pactkit-2.10.6 → pactkit-2.12.0}/README.md

@@ -327,7 +327,6 @@ docs/
 | Field | Type | Default | Description |
 |-------|------|---------|-------------|
 | `stack` | string | auto-detected | Project stack (`python`, `node`, `go`, `java`) |
-| `version` | string | current | PactKit version that generated the config |
 | `developer` | string | `""` | Developer prefix for Story IDs (multi-developer collaboration) |
 | `agents` | list | all 9 | Agent definitions to deploy |
 | `commands` | list | all 11 | Command playbooks to deploy |

{pactkit-2.10.6 → pactkit-2.12.0}/docs/architecture/governance/archive/lessons_archive_202603.md

@@ -50,3 +50,7 @@
 | 2026-03-24 | Worktree isolation diverges from working-tree: verify visualize.py _scan_files() signature is preserved across stories to avoid breaking callers | visualize.py:_scan_files |
 | 2026-03-24 | Extracting _detect_stack() from _detect_file_ext() enables both file discovery and test mapping to share stack detection — DRY refactoring | visualize.py:_detect_stack |
 | 2026-03-24 | Standalone skill scripts using exec() require all imports in _SHARED_HEADER; new stdlib imports (dataclass) must be added to skills/__init__.py _SHARED_HEADER, not just the standalone header section | skills/__init__.py:_SHARED_HEADER |
+| 2026-03-24 | detect_topology() must delegate to _TOPOLOGY_PARSERS parser.detect() first, not _TOPOLOGY_MARKERS alone — parsers and markers can diverge silently causing empty graphs | visualize.py:detect_topology |
+| 2026-03-24 | _scan_hooks() only accepts files with 'use' prefix in hook dirs (src/hooks/, composables/) to prevent utility files from becoming hook nodes | visualize.py:_scan_hooks |
+| 2026-03-24 | regression_workflow_impact hook/store matching uses node.id substring of changed file path, not reverse — e.g. 'useAuth' in 'src/hooks/useAuth.ts' | visualize.py:regression_workflow_impact |
+| 2026-03-25 | export_focus_graphs() in visualize.py uses forward_reach() (not reverse_reach()) because entry points (command/service/page) are graph roots that invoke downward — forward BFS shows their dependency tree | src/pactkit/skills/visualize.py:export_focus_graphs |

{pactkit-2.10.6 → pactkit-2.12.0}/docs/architecture/governance/lessons.md

@@ -2,9 +2,6 @@
 
 | Date | Lesson | Context |
 |------|--------|---------|
-| 2026-03-24 | _scan_hooks() only accepts files with 'use' prefix in hook dirs (src/hooks/, composables/) to prevent utility files from becoming hook nodes | visualize.py:_scan_hooks |
-| 2026-03-24 | regression_workflow_impact hook/store matching uses node.id substring of changed file path, not reverse — e.g. 'useAuth' in 'src/hooks/useAuth.ts' | visualize.py:regression_workflow_impact |
-| 2026-03-25 | export_focus_graphs() in visualize.py uses forward_reach() (not reverse_reach()) because entry points (command/service/page) are graph roots that invoke downward — forward BFS shows their dependency tree | src/pactkit/skills/visualize.py:export_focus_graphs |
 | 2026-03-26 | board.py update_task: added 3-tier fuzzy fallback (single-task auto-mark, substring match, numeric index) to handle real-world callers that don't know exact task names on the board | src/pactkit/skills/board.py:update_task |
 | 2026-03-26 | Position-based block removal (start, end tuples) is safer than str.find() for board operations — prevents substring false matches on similar story IDs | board.py:_parse_story_blocks |
 | 2026-03-26 | Fixing _parse_story_blocks to return adjusted_end (len match) inherently fixed fix_board offset compensation — root cause fix in board.py:_parse_story_blocks eliminated downstream R2 symptom in board.py:fix_board | board.py:_parse_story_blocks,board.py:fix_board |
@@ -53,3 +50,7 @@
 | 2026-04-21 | Version tracking in pactkit.yaml caused cross-project desync — moved to ~/.claude/.pactkit-version as single source of truth for deploy state. config.py get_default_config() no longer includes version field. | STORY-slim-102 |
 | 2026-04-22 | When the same bug pattern recurs 3+ times across specs (BUG-010, BUG-slim-089, STORY-033, STORY-slim-054), promote the fix from spec-level to a standing rule in 08-architecture-principles.md — ad-hoc spec fixes do not prevent recurrence | ~/.claude/rules/08-architecture-principles.md:§9 |
 | 2026-04-22 | Signal Strength L3 SHOULD semantics in rules.py:RULES_MODULES['core'] must use RFC 2119 wording — 'warning, non-blocking' caused AI to systematically defer all SHOULD tasks during Act | src/pactkit/prompts/rules.py:51 |
+| 2026-04-23 | Rule files deploy from src/pactkit/prompts/rules.py via pactkit deploy — never edit ~/.claude/rules/ directly | src/pactkit/prompts/rules.py:RULES_MODULES |
+| 2026-04-24 | Plan Phase横向扫描(Lateral Scan)比纵向trace更重要——PactSearch的10个技术债中60%源于缺少水平重复检测。修复方向是改Plan playbook引导Architect用已有工具(LSP/visualize/grep)做横向扫描，而非新建CLI | commands.py:Plan_Phase_1 |
+| 2026-04-24 | When migrating functionality (e.g., version checking from pactkit.yaml to global marker), grep all references across source, prompts, tests, and CLI help text — partial migration leaves ghost behavior | board.py:update_version |
+| 2026-04-27 | When extracting project-specific rules into a framework, generalize by removing project names, library references, and spec IDs — keep only the anti-pattern/fix-pattern structure that applies to any codebase | rules.py:RULES_MODULES |

{pactkit-2.10.6 → pactkit-2.12.0}/docs/architecture/governance/rules.md

@@ -15,7 +15,7 @@
 
 ## Invariants
 
-1. All 3790+ tests must pass before any commit to `main`.
+1. All 3841+ 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.12.0/docs/e2e/journey.md

@@ -0,0 +1,243 @@
+# User Journey Format Specification
+
+> This document defines the canonical format for `docs/e2e/journey.md` in PactKit-managed projects.
+> It is a **format specification template** -- projects copy and fill this structure with their own journeys.
+
+## Purpose
+
+A user journey describes an end-to-end flow that spans multiple stories. While individual stories
+have their own acceptance criteria (in `docs/test_cases/`), journeys capture the cross-story
+integration path that a real user follows.
+
+**Relationship to other artifacts:**
+- `docs/test_cases/{ID}_case.md` -- single-story acceptance (Gherkin scenarios)
+- `docs/e2e/journey.md` -- cross-story user flows (this document)
+- `tests/e2e/` -- executable E2E test code implementing journey segments
+
+---
+
+## Journey Structure
+
+Each journey follows this format:
+
+```markdown
+## Journey: {Journey Name}
+
+> {One-line description of the user goal}
+
+### Pre-conditions (Fixtures)
+
+| Fixture | Description | Setup Method |
+|---------|-------------|--------------|
+| {name} | {what it provides} | {seed script / API call / fixture function} |
+
+### Steps
+
+#### Step 1: {Step Title} [client]
+
+**Action**: {What the user does}
+
+**Assertions**:
+- STRUCTURE: {element/component} exists on page
+- STRUCTURE: {data container} is non-empty
+- BEHAVIOR: {interaction} triggers {expected response}
+
+#### Step 2: {Step Title} [server]
+
+**Action**: {What the system processes}
+
+**Assertions**:
+- STRUCTURE: {database record / API response} contains expected fields
+- STRUCTURE: {response payload} is non-empty
+- BEHAVIOR: {side effect} is observable (log entry, event emitted, etc.)
+
+#### Step 3: {Step Title} [server+client]
+
+**Action**: {Full-stack interaction}
+
+**Assertions**:
+- STRUCTURE: {UI element} renders with data from server
+- STRUCTURE: {response} matches expected schema shape
+- BEHAVIOR: {round-trip} completes within timeout
+```
+
+---
+
+## Execution Layer Annotations
+
+Each step MUST be annotated with its execution layer:
+
+| Annotation | Meaning | Test Tooling |
+|------------|---------|--------------|
+| `[client]` | Browser/UI interaction only | Playwright, Cypress |
+| `[server]` | Backend/API processing only | pytest + httpx, curl |
+| `[server+client]` | Full-stack round-trip | Playwright + API assertions |
+
+---
+
+## Assertion Types
+
+Assertions are classified into two categories with different enforcement rules:
+
+### Structure Assertions (MUST)
+
+Structure assertions verify that the expected elements, fields, or components **exist** and are
+**non-empty**. These are deterministic and safe to assert in any context.
+
+Examples:
+- "SQL code block element exists on page"
+- "Chart component is rendered"
+- "API response contains `data` field"
+- "Answer container has text content (length > 0)"
+
+### Content Assertions (MUST NOT for AI-generated content)
+
+Content assertions verify specific text values, numbers, or exact strings. These are appropriate
+for deterministic outputs but MUST NOT be used for AI-generated content.
+
+**When content is deterministic** (e.g., user profile display, static labels):
+- Exact text matching is acceptable
+- Numeric value assertions are acceptable
+
+**When content is AI-generated** (e.g., chatbot responses, generated analysis):
+- MUST NOT assert specific text content
+- MUST NOT assert exact numeric values in generated output
+- MUST NOT assert specific word choices or phrasing
+
+---
+
+## AI Content Assertion Strategy
+
+> This section provides guidance for projects that include AI-generated content in their user journeys
+> (e.g., chatbots, AI assistants, generated reports, analysis tools).
+
+### What to Assert (MUST)
+
+| Category | Example Assertion |
+|----------|------------------|
+| Structure exists | "SQL code block element is present in the response area" |
+| Non-empty | "Response container has text content with length > 0" |
+| Component renders | "Chart component is mounted and visible" |
+| Schema shape | "API response has `answer` field of type string" |
+| Timing | "Response arrives within N seconds" |
+| State transition | "Loading spinner disappears after response" |
+
+### What NOT to Assert (MUST NOT)
+
+| Anti-Pattern | Why It Fails |
+|--------------|--------------|
+| `assert response.text == "The answer is 42"` | AI output is non-deterministic |
+| `assert chart.data_points == [1.5, 2.3, 4.1]` | Generated values vary per run |
+| `assert sql_block.contains("SELECT * FROM users")` | AI may generate equivalent but different SQL |
+| `assert summary.word_count == 150` | Length varies with model/prompt |
+
+### Correct Pattern
+
+```python
+# STRUCTURE: verify element exists
+assert page.locator(".sql-code-block").is_visible()
+
+# NON-EMPTY: verify content was generated
+sql_content = page.locator(".sql-code-block").text_content()
+assert len(sql_content.strip()) > 0
+
+# SCHEMA: verify response shape, not content
+response = api_client.get("/chat/answer")
+assert "answer" in response.json()
+assert isinstance(response.json()["answer"], str)
+assert len(response.json()["answer"]) > 0
+
+# BEHAVIOR: verify state transition occurred
+assert page.locator(".loading-spinner").is_hidden()
+assert page.locator(".answer-area").is_visible()
+```
+
+---
+
+## Pre-condition Fixtures
+
+Each journey MUST declare its pre-conditions as named fixtures:
+
+```markdown
+### Pre-conditions (Fixtures)
+
+| Fixture | Description | Setup Method |
+|---------|-------------|--------------|
+| authenticated_user | Logged-in user session | `conftest.py::auth_fixture` |
+| sample_dataset | Pre-loaded test data | `scripts/seed_test_data.py` |
+| clean_state | Empty database with schema | `pytest fixture: db_reset` |
+```
+
+Fixtures are referenced by name in step pre-conditions, enabling:
+- Test isolation (each journey starts from a known state)
+- Parallelization (independent journeys can run concurrently)
+- Debugging (reproduce failures by loading specific fixtures)
+
+---
+
+## Example: Complete Journey
+
+```markdown
+## Journey: First Question to Answer
+
+> New user asks their first question and receives an AI-generated answer.
+
+### Pre-conditions (Fixtures)
+
+| Fixture | Description | Setup Method |
+|---------|-------------|--------------|
+| authenticated_user | Logged-in user with valid session | `conftest.py::auth_user` |
+| connected_datasource | At least one data source configured | `seed/datasource.sql` |
+
+### Steps
+
+#### Step 1: Navigate to Chat [client]
+
+**Action**: User opens the chat interface from dashboard.
+
+**Assertions**:
+- STRUCTURE: Chat input field is visible
+- STRUCTURE: Message history area exists (may be empty)
+- BEHAVIOR: Input field accepts text input
+
+#### Step 2: Submit Question [server+client]
+
+**Action**: User types a question and presses Enter.
+
+**Assertions**:
+- STRUCTURE: Loading indicator appears
+- STRUCTURE: User message appears in history
+- BEHAVIOR: API call to `/api/chat` is triggered
+
+#### Step 3: Receive Answer [server+client]
+
+**Action**: Server processes the question and streams response.
+
+**Assertions**:
+- STRUCTURE: Answer area becomes visible
+- STRUCTURE: Answer text content is non-empty
+- STRUCTURE: SQL code block is present (if query was data-related)
+- BEHAVIOR: Loading indicator disappears
+- MUST NOT: Assert specific answer text content (AI-generated)
+- MUST NOT: Assert exact SQL query string (AI-generated)
+
+#### Step 4: View Generated Visualization [client]
+
+**Action**: User clicks on the chart tab to see generated visualization.
+
+**Assertions**:
+- STRUCTURE: Chart component is rendered
+- STRUCTURE: Chart has at least one data series
+- BEHAVIOR: Chart responds to hover interaction
+- MUST NOT: Assert specific chart data values (AI-generated)
+```
+
+---
+
+## Usage in Check Phase 4
+
+When `/project-check` Phase 4 (E2E Execution) runs:
+
+1. If `docs/e2e/journey.md` exists, read it to identify journey segments affected by the current story
+2. E2E tests SHOULD cover the affected segments (not the full journey)
+3. Journey definitions inform test scope; `docs/test_cases/` informs acceptance criteria

{pactkit-2.10.6 → pactkit-2.12.0}/docs/product/archive/archive_202604.md

@@ -241,3 +241,49 @@
 - [x] Change L3 Semantics text in rules.py
 - [x] Add SHOULD clarification note
 - [x] Add test for L3 content
+
+### [STORY-slim-105] SHOULD 覆盖追踪与改动类型声明
+> Spec: docs/specs/STORY-slim-105.md
+
+- [x] 更新01-core-protocol.md SHOULD语义
+- [x] 更新05-workflow-conventions.md DEFERRED规范
+- [x] schemas.py新增常量
+- [x] spec_linter.py新增W010
+- [x] project-act.md覆盖表输出
+- [x] 测试用例
+
+### [STORY-slim-106] Plan 阶段横向扫描强化与 hooks 死代码清理
+> Spec: docs/specs/STORY-slim-106.md
+
+- [x] R1: Plan playbook Lateral Scan 步骤
+- [x] R2: Solution Design Internal Patterns
+- [x] R3: Architecture Principles 通用化
+- [x] R4: 删除 hooks 死代码
+- [x] R5: spec_linter W006
+- [x] 测试覆盖
+
+### [HOTFIX-slim-107] Remove residual pactkit.yaml version operations
+> Spec: docs/specs/HOTFIX-slim-107.md
+
+- [x] Remove update_version function
+- [x] Update CLI help text
+- [x] Clean prompt references
+- [x] Update agent docs
+
+### [STORY-slim-107] Integrate tech debt prevention patterns into framework rules
+> Spec: docs/specs/STORY-slim-107.md
+
+- [x] Expand architecture §1 DRY with dual-write
+- [x] Expand architecture §6 Security (deny-by-default, input validation, timing)
+- [x] Add architecture §10 Code Enforces / LLM≠Calculator
+- [x] Add architecture §11 Concurrency & Async Safety
+- [x] Add architecture §12 Cache Lifecycle
+- [x] Add architecture §13 Dead Code Hygiene
+- [x] Add String→Enum to solution module
+- [x] Run test suite
+
+### [BUG-slim-107] Fix scan_excludes replacing defaults and hidden root module
+> Spec: docs/specs/BUG-slim-107.md
+
+- [x] Merge custom excludes with defaults
+- [x] Show root module in available list

pactkit-2.12.0/docs/product/context.md

@@ -0,0 +1,31 @@
+# Project Context (Auto-generated)
+> Last updated: 2026-05-06T14:08:28+08:00 by pactkit context
+
+## Sprint Status
+Backlog: 1 | In Progress: 0 | Done: 4 stories
+
+## Current Stories
+None
+
+## Recent Completions
+- STORY-slim-110: project-design 集成 User Journey 生成
+- STORY-slim-109: E2E journey.md 规范定义与 File Atlas 集成
+- STORY-slim-108: pactkit-trace --summary 模式：接口摘要输出
+
+## Active Branches
++ claude/naughty-euclid-e6a787
+  develop
+* main
+
+## Key Decisions
+- Signal Strength L3 SHOULD semantics in rules.py:RULES_MODULES['core'] must use RFC 2119 wording — 'warning, non-blocking' caused AI to systematically defer all SHOULD tasks during Act
+- Rule files deploy from src/pactkit/prompts/rules.py via pactkit deploy — never edit ~/.claude/rules/ directly
+- Plan Phase横向扫描(Lateral Scan)比纵向trace更重要——PactSearch的10个技术债中60%源于缺少水平重复检测。修复方向是改Plan playbook引导Architect用已有工具(LSP/visualize/grep)做横向扫描，而非新建CLI
+- When migrating functionality (e.g., version checking from pactkit.yaml to global marker), grep all references across source, prompts, tests, and CLI help text — partial migration leaves ghost behavior
+- When extracting project-specific rules into a framework, generalize by removing project names, library references, and spec IDs — keep only the anti-pattern/fix-pattern structure that applies to any codebase
+
+## Next Recommended Action
+`/project-plan`
+
+## Agent Continuation
+No active work session.

pactkit-2.12.0/docs/product/sprint_board.md

@@ -0,0 +1,39 @@
+# Sprint Board
+
+## 📋 Backlog
+
+
+### [STORY-slim-112] Rules 架构重构：全局原则 vs 按需操作规程
+> Spec: docs/specs/STORY-slim-112.md
+
+- [ ] 拆分 RULES_CORE/ONDEMAND + 新建 05-principles
+- [ ] 更新 deployer 双目录部署
+- [ ] 更新所有 skill @import 路径
+- [ ] 更新测试断言
+
+## 🔄 In Progress
+
+## ✅ Done
+
+### [STORY-slim-111] Check Phase 4 Playwright 断言策略指南
+> Spec: docs/specs/STORY-slim-111.md
+
+- [x] 修改 project-check SKILL.md Phase 4 增加断言策略
+
+### [STORY-slim-110] project-design 集成 User Journey 生成
+> Spec: docs/specs/STORY-slim-110.md
+
+- [x] 修改 project-design SKILL.md Phase 1 Group B
+
+### [STORY-slim-109] E2E journey.md 规范定义与 File Atlas 集成
+> Spec: docs/specs/STORY-slim-109.md
+
+- [x] 注册 File Atlas
+- [x] 创建 journey.md 格式规范
+- [x] 修改 project-check Phase 4
+
+### [STORY-slim-108] pactkit-trace --summary 模式：接口摘要输出
+> Spec: docs/specs/STORY-slim-108.md
+
+- [x] 修改 pactkit-trace SKILL.md Phase 3
+- [x] 修改 project-act SKILL.md Phase 1

pactkit-2.12.0/docs/specs/BUG-slim-107.md

@@ -0,0 +1,12 @@
+# BUG-slim-107: Custom scan_excludes replaces defaults, leaking .next as modules
+
+## Background
+When a project's `pactkit.yaml` defines custom `visualize.scan_excludes`, it completely replaces the built-in `SCAN_EXCLUDES` set. Projects lose critical exclusions like `.next`, causing build artifacts to be detected as modules. Combined with the root module `.` being hidden from the "Available modules" error message, this misleads AI into concluding "visual scan not applicable to Python projects".
+
+## Target
+- `src/pactkit/skills/visualize.py:280` — merge custom excludes with defaults instead of replacing
+- `src/pactkit/skills/visualize.py:1180` — include root module in available list with descriptive label
+
+## Fix
+1. `_detect_modules`: union custom scan_excludes with SCAN_EXCLUDES
+2. Available modules list: show root module as `"." (project root)` instead of filtering it out

pactkit-2.12.0/docs/specs/HOTFIX-slim-107.md

@@ -0,0 +1,19 @@
+# HOTFIX-slim-107: Remove residual pactkit.yaml version field operations
+
+## Background
+STORY-slim-102 migrated version checking from pactkit.yaml to `~/.claude/.pactkit-version` global marker, but left 4 residual references that still read/write version in pactkit.yaml.
+
+## Target Files
+| File | Line(s) | Issue |
+|------|---------|-------|
+| `src/pactkit/skills/board.py` | 239-256, 401-402, 417-418 | `update_version()` function + CLI entry |
+| `src/pactkit/cli.py` | 146 | `--if-needed` help text references pactkit.yaml |
+| `src/pactkit/prompts/commands.py` | 659 | Manual pactkit.yaml creation includes `version: 0.0.1` |
+| `src/pactkit/prompts/agents.py` | 29 | "Release field (from pactkit.yaml version)" |
+| `src/pactkit/prompts/skills.py` | 127-130, 152, 699 | `update_version` docs and usage |
+| `src/pactkit/prompts/agents.py` | 145 | "Use update_version to update version number" |
+
+## Fix
+- Remove `update_version()` function and CLI subcommand from board.py
+- Update help text, prompts, and agent docs to remove pactkit.yaml version references
+- Version is now managed in pyproject.toml + __init__.py only; deploy marker at ~/.claude/.pactkit-version