pactkit 2.1.1__tar.gz → 2.2.0__tar.gz

{pactkit-2.1.1 → pactkit-2.2.0}/.gitignore

@@ -30,6 +30,18 @@ Thumbs.db
 docs/architecture/graphs/
 docs/architecture/snapshots/
 
+# PactKit - IP protection (keep locally, not tracked in git)
+# Only BUG-*.md specs are tracked; STORY/HOTFIX contain sensitive design details
+docs/specs/STORY-*.md
+docs/specs/HOTFIX-*.md
+docs/test_cases/STORY-*_case.md
+docs/test_cases/HOTFIX-*_case.md
+docs/product/sprint_board.md
+docs/product/context.md
+docs/product/archive/
+docs/product/prd.md
+docs/architecture/governance/
+
 # Claude Code local config
 .claude/
 

pactkit-2.2.0/.opencode/memory/project.md

@@ -0,0 +1,7 @@
+---
+description: ''
+label: project
+limit: 5000
+read_only: false
+---
+

{pactkit-2.1.1 → pactkit-2.2.0}/.opencode/pactkit.yaml

@@ -2,7 +2,7 @@
 # Edit this file to customize which components are deployed.
 # Remove items from a list to disable them. Default: all enabled.
 
-version: "2.1.1"
+version: "2.2.0"
 stack: python
 root: .
 developer: "slim"
@@ -60,6 +60,10 @@ rules:
 # CI/CD — set provider to github or gitlab to generate pipeline config
 ci:
   provider: github
+  # runner: ubuntu-latest
+  # language_version: "3.11"
+  # github_host: ""  # GHE server (empty = github.com)
+  # actions_ref: ""  # GHE actions prefix
 
 # Issue Tracker — set provider to github to link stories to issues
 issue_tracker:

{pactkit-2.1.1 → pactkit-2.2.0}/AGENTS.md

@@ -65,3 +65,10 @@ src/pactkit/
 
 @./docs/product/context.md
 output MUST use Chinese
+
+## PDCA Execution Lessons
+
+- **/project-done 不要重复跑回归测试**：如果 `/project-act` 阶段刚跑过全量测试且全绿，Done 阶段直接引用该结果，不要再跑一次。只有在 Done 阶段有额外文件修改（非 doc-only）时才重新跑。
+- **大文件一次读完**：`lessons.md` 等治理文件直接一次性读取，不要分多次小范围读取再拼凑。
+- **并行写多个独立文件**：rules.md、lessons.md、context.md、sprint_board.md 的更新互不依赖，应并行执行，不要串行。
+- **流程指令是指导，不是死板清单**：当上下文已经包含某个步骤的结果时（如测试结果、lint 结果），直接复用，不要机械重复执行。

{pactkit-2.1.1 → pactkit-2.2.0}/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to PactKit will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [2.2.0] - 2026-03-20
+
+### Added
+- **Context-Aware Rule Loading** (STORY-slim-011) — `COMMAND_RULES_MAP` maps each of 11 commands to only the rules it needs, reducing per-command token usage by 20-83%. Classic format uses `@import` injection; OpenCode format embeds rule content inline. Credential safety rule (`09`) is force-injected into every command regardless of configuration.
+- **Stack-Aware CI Pipeline Generation** (STORY-slim-012) — `CI_PROFILES` in `workflows.py` supports Python, Node.js, Go, and Java stacks with correct setup actions, install commands, and test runners. New `pactkit.yaml` CI config fields: `runner`, `language_version`, `github_host`, `actions_ref`.
+- **GitHub Enterprise (GHE) Support** — Explicit `ci.github_host` configuration for GHE Server environments, with `ci.actions_ref` prefix replacement for custom action mirrors. Auto-detection fallback via `_detect_ghe()`.
+- **OpenCode CI Parity** — `_deploy_opencode()` now calls `_deploy_ci()`, ensuring CI pipeline files are generated regardless of deployment format.
+- **CI Status Feedback** — `/project-done` Phase 4 now includes optional CI status check via `gh run list` after push (non-blocking).
+- **GitLab CI Stack-Aware** — GitLab CI templates now use correct Docker images and commands per stack (e.g., `node:20` + `npm ci` for Node projects).
+
+### Changed
+- `_deploy_ci()` refactored from hardcoded Python-only templates to parameterized builders (`_build_github_workflow()`, `_build_gitlab_ci()`).
+- `generate_default_yaml()` now outputs commented CI configuration fields (`runner`, `language_version`, `github_host`, `actions_ref`) for user discoverability.
+- CLAUDE.md no longer contains global rule `@import` directives — rules are now injected at command level.
+- OpenCode `opencode.json` instructions reduced to only `09-credential-safety.md` — other rules injected per-command.
+
 ## [2.1.1] - 2026-03-18
 
 ### Added

{pactkit-2.1.1 → pactkit-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pactkit
-Version: 2.1.1
+Version: 2.2.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
@@ -140,6 +140,22 @@ Or run the full cycle in one command:
 | **Init** | `/project-init` | System Architect | Bootstrap project structure and governance |
 | **Design** | `/project-design` | Product Designer | PRD generation -> Story decomposition -> Board setup |
 
+### Role-Based Command Guide
+
+Choose commands based on your role:
+
+| Role | Commands | What You Do |
+|------|----------|-------------|
+| **BA** | `/project-clarify` | Surface ambiguities, produce Clarified Brief |
+| **PM** | `/project-design` | Generate PRD, decompose into Stories |
+| **Architect** | `/project-plan`, `/project-init` | Create Specs, initialize project governance |
+| **Developer** | `/project-act`, `/project-hotfix` | TDD implementation, emergency fixes |
+| **QA** | `/project-check` | Security + quality audit, spec alignment |
+| **DevOps** | `/project-done`, `/project-release`, `/project-pr` | Commit, release, pull request |
+| **Team Lead** | `/project-sprint` | One-command PDCA orchestration (**Claude Code only**) |
+
+> **Solo developer?** Focus on `/project-plan` → `/project-act` → `/project-done`. Other commands become valuable when you have team collaboration or external stakeholders.
+
 ### Embedded Skills (auto-invoked by commands)
 
 | Skill | Embedded In | Purpose |
@@ -198,9 +214,9 @@ PactKit supports two deployment formats:
 
 ```
 ~/.claude/
-├── CLAUDE.md                 <- Modular constitution (entry point with @import)
-├── rules/                    <- 7 rule modules
-├── commands/                 <- 11 command playbooks
+├── CLAUDE.md                 <- Project context entry point
+├── rules/                    <- 8 rule modules (loaded per-command, not globally)
+├── commands/                 <- 11 command playbooks (with per-command rule @imports)
 ├── agents/                   <- 9 agent definitions
 └── skills/                   <- 10 skill packages
 ```
@@ -210,7 +226,7 @@ PactKit supports two deployment formats:
 ```
 ~/.config/opencode/
 ├── AGENTS.md                 <- On-demand @reference index (lazy rule loading)
-├── rules/                    <- 8 rule modules (3 core always-load + 5 on-demand)
+├── rules/                    <- 8 rule modules (3 core always-load + 6 on-demand)
 ├── commands/                 <- 11 command playbooks (with model: routing)
 ├── agents/                   <- 9 agent definitions (mode: subagent)
 ├── skills/                   <- 10 skill packages (with SKILL.md frontmatter)
@@ -218,7 +234,7 @@ PactKit supports two deployment formats:
 ```
 
 Key OpenCode differences:
-- **Rules**: Core rules always loaded via `instructions`; on-demand rules via `@reference` in AGENTS.md (lazy loading, -62% tokens)
+- **Rules**: Per-command inline embedding; credential safety always loaded via `instructions` (context-aware loading, -20% to -83% tokens per command)
 - **Agents**: `mode: subagent`, no `name` field, tools as record format
 - **Commands**: `agent: build` + `model: provider/model-id` (model routing)
 - **Config**: `pactkit.yaml` in `.opencode/` (not `.claude/`)
@@ -265,9 +281,9 @@ docs/
 | `agents` | list | all 9 | Agent definitions to deploy |
 | `commands` | list | all 11 | Command playbooks to deploy |
 | `skills` | list | all 10 | Skills to deploy |
-| `rules` | list | all 7 | Constitution rule modules to deploy |
+| `rules` | list | all 8 | Constitution rule modules to deploy |
 | `exclude` | object | `{}` | Components to exclude (e.g., `exclude.agents: [agent-name]`) |
-| `ci` | object | `provider: none` | CI/CD pipeline generation (`github`, `gitlab`, `none`) |
+| `ci` | object | `provider: none` | CI/CD pipeline generation (`github`, `gitlab`, `none`). Sub-fields: `runner` (default: `ubuntu-latest`), `language_version` (default: auto per stack), `github_host` (GHE server address), `actions_ref` (GHE actions prefix) |
 | `issue_tracker` | object | `provider: none` | External issue tracker (`github`, `none`) |
 | `hooks` | object | disabled | Opt-in hook templates (pre-commit, post-test, pre-push) |
 | `lint_blocking` | bool | `false` | Whether lint failures block commits |

{pactkit-2.1.1 → pactkit-2.2.0}/README.md

@@ -114,6 +114,22 @@ Or run the full cycle in one command:
 | **Init** | `/project-init` | System Architect | Bootstrap project structure and governance |
 | **Design** | `/project-design` | Product Designer | PRD generation -> Story decomposition -> Board setup |
 
+### Role-Based Command Guide
+
+Choose commands based on your role:
+
+| Role | Commands | What You Do |
+|------|----------|-------------|
+| **BA** | `/project-clarify` | Surface ambiguities, produce Clarified Brief |
+| **PM** | `/project-design` | Generate PRD, decompose into Stories |
+| **Architect** | `/project-plan`, `/project-init` | Create Specs, initialize project governance |
+| **Developer** | `/project-act`, `/project-hotfix` | TDD implementation, emergency fixes |
+| **QA** | `/project-check` | Security + quality audit, spec alignment |
+| **DevOps** | `/project-done`, `/project-release`, `/project-pr` | Commit, release, pull request |
+| **Team Lead** | `/project-sprint` | One-command PDCA orchestration (**Claude Code only**) |
+
+> **Solo developer?** Focus on `/project-plan` → `/project-act` → `/project-done`. Other commands become valuable when you have team collaboration or external stakeholders.
+
 ### Embedded Skills (auto-invoked by commands)
 
 | Skill | Embedded In | Purpose |
@@ -172,9 +188,9 @@ PactKit supports two deployment formats:
 
 ```
 ~/.claude/
-├── CLAUDE.md                 <- Modular constitution (entry point with @import)
-├── rules/                    <- 7 rule modules
-├── commands/                 <- 11 command playbooks
+├── CLAUDE.md                 <- Project context entry point
+├── rules/                    <- 8 rule modules (loaded per-command, not globally)
+├── commands/                 <- 11 command playbooks (with per-command rule @imports)
 ├── agents/                   <- 9 agent definitions
 └── skills/                   <- 10 skill packages
 ```
@@ -184,7 +200,7 @@ PactKit supports two deployment formats:
 ```
 ~/.config/opencode/
 ├── AGENTS.md                 <- On-demand @reference index (lazy rule loading)
-├── rules/                    <- 8 rule modules (3 core always-load + 5 on-demand)
+├── rules/                    <- 8 rule modules (3 core always-load + 6 on-demand)
 ├── commands/                 <- 11 command playbooks (with model: routing)
 ├── agents/                   <- 9 agent definitions (mode: subagent)
 ├── skills/                   <- 10 skill packages (with SKILL.md frontmatter)
@@ -192,7 +208,7 @@ PactKit supports two deployment formats:
 ```
 
 Key OpenCode differences:
-- **Rules**: Core rules always loaded via `instructions`; on-demand rules via `@reference` in AGENTS.md (lazy loading, -62% tokens)
+- **Rules**: Per-command inline embedding; credential safety always loaded via `instructions` (context-aware loading, -20% to -83% tokens per command)
 - **Agents**: `mode: subagent`, no `name` field, tools as record format
 - **Commands**: `agent: build` + `model: provider/model-id` (model routing)
 - **Config**: `pactkit.yaml` in `.opencode/` (not `.claude/`)
@@ -239,9 +255,9 @@ docs/
 | `agents` | list | all 9 | Agent definitions to deploy |
 | `commands` | list | all 11 | Command playbooks to deploy |
 | `skills` | list | all 10 | Skills to deploy |
-| `rules` | list | all 7 | Constitution rule modules to deploy |
+| `rules` | list | all 8 | Constitution rule modules to deploy |
 | `exclude` | object | `{}` | Components to exclude (e.g., `exclude.agents: [agent-name]`) |
-| `ci` | object | `provider: none` | CI/CD pipeline generation (`github`, `gitlab`, `none`) |
+| `ci` | object | `provider: none` | CI/CD pipeline generation (`github`, `gitlab`, `none`). Sub-fields: `runner` (default: `ubuntu-latest`), `language_version` (default: auto per stack), `github_host` (GHE server address), `actions_ref` (GHE actions prefix) |
 | `issue_tracker` | object | `provider: none` | External issue tracker (`github`, `none`) |
 | `hooks` | object | disabled | Opt-in hook templates (pre-commit, post-test, pre-push) |
 | `lint_blocking` | bool | `false` | Whether lint failures block commits |

pactkit-2.2.0/opencode.json

@@ -0,0 +1,3 @@
+{
+  "$schema": "https://opencode.ai/config.json"
+}

{pactkit-2.1.1 → pactkit-2.2.0}/pyproject.toml

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

{pactkit-2.1.1 → pactkit-2.2.0}/src/pactkit/__init__.py

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

{pactkit-2.1.1 → pactkit-2.2.0}/src/pactkit/config.py

@@ -545,6 +545,14 @@ def _rewrite_yaml(path: Path, data: dict) -> None:
         lines.append("# CI/CD — set provider to github or gitlab to generate pipeline config")
         lines.append("ci:")
         lines.append(f"  provider: {ci.get('provider', 'none')}")
+        runner = ci.get("runner", "ubuntu-latest")
+        lang_ver = ci.get("language_version", "3.11")
+        gh_host = ci.get("github_host", "")
+        act_ref = ci.get("actions_ref", "")
+        lines.append(f"  # runner: {runner}")
+        lines.append(f'  # language_version: "{lang_ver}"')
+        lines.append(f'  # github_host: "{gh_host}"  # GHE server (empty = github.com)')
+        lines.append(f'  # actions_ref: "{act_ref}"  # GHE actions prefix')
         lines.append("")
 
     # Write issue tracker section
@@ -831,9 +839,19 @@ def generate_default_yaml() -> str:
     for r in cfg["rules"]:
         lines.append(f"  - {r}")
 
+    ci = cfg.get("ci", {})
     lines.extend(["", "# CI/CD — set provider to github or gitlab to generate pipeline config"])
     lines.append("ci:")
-    lines.append(f"  provider: {cfg.get('ci', {}).get('provider', 'none')}")
+    ci_d = ci if isinstance(ci, dict) else {}
+    lines.append(f"  provider: {ci_d.get('provider', 'none')}")
+    runner = ci_d.get("runner", "ubuntu-latest")
+    lang_ver = ci_d.get("language_version", "3.11")
+    gh_host = ci_d.get("github_host", "")
+    act_ref = ci_d.get("actions_ref", "")
+    lines.append(f"  # runner: {runner}")
+    lines.append(f'  # language_version: "{lang_ver}"')
+    lines.append(f'  # github_host: "{gh_host}"  # GHE server (empty = github.com)')
+    lines.append(f'  # actions_ref: "{act_ref}"  # GHE actions prefix')
 
     lines.extend(["", "# Issue Tracker — set provider to github to link stories to issues"])
     lines.append("issue_tracker:")