@blxzer/pactile 0.5.0 → 0.6.0-beta.4

package/dist/templates/markdown/worktree.yaml.txt

@@ -1,58 +1,58 @@
-# Worktree Configuration for Multi-Agent Pipeline
-# Used for worktree initialization in multi-agent workflows
-#
-# All paths are relative to project root
-
-#-------------------------------------------------------------------------------
-# Paths
-#-------------------------------------------------------------------------------
-
-# Worktree storage directory (relative to project root)
-# Recommended: keep worktrees outside the main repo to avoid conflicts
-worktree_dir: ../<project-name>-worktrees
-
-#-------------------------------------------------------------------------------
-# Files to Copy
-#-------------------------------------------------------------------------------
-
-# Files to copy to each worktree (each worktree needs independent copy)
-# These files contain sensitive info or need worktree-independent config
-copy:
-  # Environment variables (uncomment and customize as needed)
-  # - .env
-  # - .env.local
-  # Workflow config
-  - .pactile/.developer
-
-#-------------------------------------------------------------------------------
-# Post-Create Hooks
-#-------------------------------------------------------------------------------
-
-# Commands to run after creating worktree
-# Executed in worktree directory, in order, abort on failure
-post_create:
-  # Install dependencies (uncomment based on your package manager)
-  # - npm install
-  # - pnpm install --frozen-lockfile
-  # - yarn install --frozen-lockfile
-  # - pip install -r requirements.txt
-  # - bundle install
-  # - cargo build
-
-#-------------------------------------------------------------------------------
-# Pre-Merge Checks
-#-------------------------------------------------------------------------------
-
-# Pre-merge validation (used by create_pr.py)
-pre_merge:
-  # Type checking (uncomment based on your setup)
-  # - npm run typecheck
-  # - pnpm typecheck
-  # - mypy .
-  # Linting
-  # - npm run lint
-  # - pnpm lint
-  # - ruff check .
-  # Testing
-  # - npm test
-  # - pytest
+# Worktree Configuration for Multi-Agent Pipeline
+# Used for worktree initialization in multi-agent workflows
+#
+# All paths are relative to project root
+
+#-------------------------------------------------------------------------------
+# Paths
+#-------------------------------------------------------------------------------
+
+# Worktree storage directory (relative to project root)
+# Recommended: keep worktrees outside the main repo to avoid conflicts
+worktree_dir: ../<project-name>-worktrees
+
+#-------------------------------------------------------------------------------
+# Files to Copy
+#-------------------------------------------------------------------------------
+
+# Files to copy to each worktree (each worktree needs independent copy)
+# These files contain sensitive info or need worktree-independent config
+copy:
+  # Environment variables (uncomment and customize as needed)
+  # - .env
+  # - .env.local
+  # Workflow config
+  - .pactile/.developer
+
+#-------------------------------------------------------------------------------
+# Post-Create Hooks
+#-------------------------------------------------------------------------------
+
+# Commands to run after creating worktree
+# Executed in worktree directory, in order, abort on failure
+post_create:
+  # Install dependencies (uncomment based on your package manager)
+  # - npm install
+  # - pnpm install --frozen-lockfile
+  # - yarn install --frozen-lockfile
+  # - pip install -r requirements.txt
+  # - bundle install
+  # - cargo build
+
+#-------------------------------------------------------------------------------
+# Pre-Merge Checks
+#-------------------------------------------------------------------------------
+
+# Pre-merge validation (used by the Pactile CLI)
+pre_merge:
+  # Type checking (uncomment based on your setup)
+  # - npm run typecheck
+  # - pnpm typecheck
+  # - mypy .
+  # Linting
+  # - npm run lint
+  # - pnpm lint
+  # - ruff check .
+  # Testing
+  # - npm test
+  # - pytest

package/dist/templates/pactile/CONTEXT.md

@@ -1,113 +1,113 @@
-# CONTEXT
-
-Project domain glossary — the single source of truth for project-specific terms used in this repository. Read **on demand** when project terms matter (e.g. before planning questions, PRD writing, or check reviews); **never always-inject** — this file stays out of the automatic session prompt budget.
-
-Only project-specific concepts belong here; generic programming concepts already documented under `.pactile/` do not need entries. Each entry: term + one-line definition + `_Avoid_` aliases when a common synonym causes confusion. Language follows `artifact_locale` (en → English only; zh → Chinese terms with English gloss). Seed below is bilingual so either locale can start from the same file; delete entries that do not apply.
-
-## Governance domain seed
-
-Optional starting set for the review-pool vocabulary — delete entries that do not apply:
-
-**点子** (_idea_):
-Undecided development direction or improvement; a candidate for the review pool.
-_Avoid_: requirement, thought
-
-**不足** (_debt_):
-Confirmed but unresolved gap found in review or verification.
-_Avoid_: issue, bug (unless it is a tracked defect elsewhere)
-
-**审核池** (_review pool_):
-Inbox for ideas and debt; states inbox / review / accepted / rejected / rework.
-_Avoid_: backlog, idea dump
-
-**开发计划** (_dev plan_):
-Plan file: accepted item ids + order + blocking edges + fog. Cite pool ids only.
-_Avoid_: roadmap
-
-**可裁决条目** (_adjudicable item_):
-Pool item with intent / motivation / coarse acceptance / non-goals.
-_Avoid_: todo
-
-**拒绝知识库** (_knowledge base_):
-Archive of rejected-concept reasons, used to dedupe prior requests.
-_Avoid_: blacklist
-
-## Framework domain seed (optional)
-
-Optional starting set — delete entries that do not apply to this project:
-
-**Task** (_task_):
-PACTILE task, directory under `.pactile/tasks/`, lifecycle planning / in_progress / completed.
-_Avoid_: ticket, issue
-
-**PRD** (_product requirements document_):
-Task requirements artifact: Goal / User Stories / Requirements / Acceptance Criteria / Implementation Decisions.
-_Avoid_: spec sheet
-
-**Gate** (_gate_):
-Mandatory checkpoint at planning / execution / archive boundaries.
-_Avoid_: —
-
-**Evidence** (_evidence_):
-Verification evidence in `verify.md` (command output, paths, acceptance).
-_Avoid_: report
-
-**Contract** (_contract_):
-Execution contract in `implement.md` (execution_mode / verification_profile / quality_gates).
-_Avoid_: plan
-
-**Child** (_child_):
-Independently verifiable deliverable under a Parent task tree.
-_Avoid_: sub-ticket
-
-**artifact_locale** (_artifact locale_):
-Project artifact language setting (en / zh).
-_Avoid_: locale
-
-**Task Ladder** (_task ladder_):
-Triage ladder: No Task / Micro-Grill / Lite / Full / Parent.
-_Avoid_: —
-
-## Architecture (deep-module vocabulary)
-
-Seed for codebase-design terms. Keep these seven; do not treat them as generic programming words.
-
-**module** (_module_):
-A unit of any size that has an interface and an implementation.
-_Avoid_: component, service
-
-**interface** (_interface_):
-Every fact a caller needs in order to use the module correctly.
-_Avoid_: API, signature
-
-**depth** (_depth_):
-Leverage on the interface: how much behavior each unit of interface can drive.
-_Avoid_: abstraction level
-
-**seam** (_seam_):
-A place where behavior can change without editing the original site.
-_Avoid_: boundary
-
-**adapter** (_adapter_):
-A concrete thing that satisfies an interface at a seam.
-_Avoid_: implementation
-
-**leverage** (_leverage_):
-Capability the caller gains from depth.
-_Avoid_: reuse
-
-**locality** (_locality_):
-Concentration the maintainer gains from depth (change / knowledge / verification in one place).
-_Avoid_: cohesion
-
-## Project glossary
-
-Add project-specific terms below (term + one-line definition + `_Avoid_` aliases):
-
-| Term | Definition | Avoid |
-| --- | --- | --- |
-| _TBD_ | | |
-
-## ADR
-
-Architecture decisions live in `docs/adr/` (lazy-created). Write an ADR only when **all three** conditions hold: hard to reverse · would surprise without context · real tradeoff. See `docs/adr/README.md` for the full boundary.
+# CONTEXT
+
+Project domain glossary — the single source of truth for project-specific terms used in this repository. Read **on demand** when project terms matter (e.g. before planning questions, PRD writing, or check reviews); **never always-inject** — this file stays out of the automatic session prompt budget.
+
+Only project-specific concepts belong here; generic programming concepts already documented under `.pactile/` do not need entries. Each entry: term + one-line definition + `_Avoid_` aliases when a common synonym causes confusion. Language follows `artifact_locale` (en → English only; zh → Chinese terms with English gloss). Seed below is bilingual so either locale can start from the same file; delete entries that do not apply.
+
+## Task Kernel V2 terms
+
+These terms describe the current V2 Task model. They do not rename or reinterpret an existing Task that the unified reader identifies as V1 legacy.
+
+**Task** (_task_):
+由 V2 Kernel 记录的一份有界交付物，包含验收标准、交付层级和硬依赖 Task ID。
+_Avoid_: ticket, issue, workstream
+
+**Deliverable** (_deliverable_):
+Task 承诺产出、Review 时可供检查的具体结果。
+_Avoid_: activity, effort
+
+**Acceptance Criterion (AC)** (_acceptance criterion_):
+交付物必须满足的可观察条件；Close 时每条 AC 都要映射到一个或多个证据引用。
+_Avoid_: vague goal, unchecked checklist item
+
+**Delivery level** (_delivery level_):
+Task 声明的交付类别：`local-result`、`pull-request`、`merged-result` 或 `documentation`。Close 证据必须使用同一 level。
+_Avoid_: rigor, quality tier
+
+**Hard dependency** (_hard dependency_):
+依赖 Task 必须成功 Close 后，被依赖 Task 才能通过 Kernel 门继续推进。
+_Avoid_: preference, advisory order
+
+**Run** (_run_):
+Task 的一次执行尝试，记录授权、写集、结果和可选的候选快照。一个 Task 可以保留多次 Run。
+_Avoid_: Task, overwritten retry
+
+**Candidate snapshot** (_candidate snapshot_):
+由完成的 Run 冻结的条目和 fingerprint；Review 与 Close 都指向确切快照。
+_Avoid_: current unrecorded working tree
+
+**Review** (_review_):
+绑定到某个 Run 候选快照的独立追加式判定。Close 使用该候选的最新 Review，且判定必须通过。
+_Avoid_: generic approval, unbound review note
+
+**Close** (_close_):
+Kernel 结项转换：依赖、候选绑定 Review 和 AC 证据均满足后，记录与 Task 交付层级匹配的交付证据。
+_Avoid_: directory move, commit, publication
+
+**V1 legacy Task** (_legacy Task_):
+统一 reader 明确识别出的既有旧版 Task。保留其数据，只使用其版本对应的兼容行为；不能因为 V2 Task 缺少可选文件就把它当成 V1。
+_Avoid_: old-style V2 Task
+
+**artifact_locale** (_artifact locale_):
+项目产物语言设置（en / zh）。
+_Avoid_: locale
+
+## Governance domain seed
+
+Optional starting set for governance vocabulary — delete entries that do not apply:
+
+**点子** (_idea_):
+Undecided development direction or improvement, not yet a Task.
+_Avoid_: requirement, thought
+
+**不足** (_debt_):
+Confirmed but unresolved gap found in review or verification.
+_Avoid_: issue, bug (unless it is a tracked defect elsewhere)
+
+**拒绝知识库** (_knowledge base_):
+Archive of rejected-concept reasons, used to dedupe prior requests.
+_Avoid_: blacklist
+
+## Architecture (deep-module vocabulary)
+
+Seed for codebase-design terms. Keep these seven; do not treat them as generic programming words.
+
+**module** (_module_):
+A unit of any size that has an interface and an implementation.
+_Avoid_: component, service
+
+**interface** (_interface_):
+Every fact a caller needs in order to use the module correctly.
+_Avoid_: API, signature
+
+**depth** (_depth_):
+Leverage on the interface: how much behavior each unit of interface can drive.
+_Avoid_: abstraction level
+
+**seam** (_seam_):
+A place where behavior can change without editing the original site.
+_Avoid_: boundary
+
+**adapter** (_adapter_):
+A concrete thing that satisfies an interface at a seam.
+_Avoid_: implementation
+
+**leverage** (_leverage_):
+Capability the caller gains from depth.
+_Avoid_: reuse
+
+**locality** (_locality_):
+Concentration the maintainer gains from depth (change / knowledge / verification in one place).
+_Avoid_: cohesion
+
+## Project glossary
+
+Add project-specific terms below (term + one-line definition + `_Avoid_` aliases):
+
+| Term | Definition | Avoid |
+| --- | --- | --- |
+| _TBD_ | | |
+
+## ADR
+
+Architecture decisions live in `docs/adr/` (lazy-created). Write an ADR only when **all three** conditions hold: hard to reverse · would surprise without context · real tradeoff. See `docs/adr/README.md` for the full boundary.

package/dist/templates/pactile/config/execution-strategy-rules.json

@@ -1,31 +1,30 @@
-{
-  "version": 1,
-  "doc_only_capabilities": [
-    "markdown-documentation"
-  ],
-  "code_capabilities": [
-    "cli-templates",
-    "python-task-scripts",
-    "vitest-integration",
-    "typescript",
-    "python"
-  ],
-  "code_path_segments": [
-    "src",
-    "packages",
-    "scripts",
-    "lib"
-  ],
-  "pair_warnings": [
-    {
-      "execution_mode": "worker",
-      "isolation": "git-worktree",
-      "message": "worker usually runs in main-worktree; git-worktree is rare for pactile-implement"
-    },
-    {
-      "execution_mode": "inline",
-      "isolation": "git-worktree",
-      "message": "inline + git-worktree is unusual; consider child-task if isolation is intentional"
-    }
-  ]
-}
+{
+  "version": 1,
+  "doc_only_capabilities": [
+    "markdown-documentation"
+  ],
+  "code_capabilities": [
+    "cli-templates",
+    "vitest-integration",
+    "typescript",
+    "python"
+  ],
+  "code_path_segments": [
+    "src",
+    "packages",
+    "scripts",
+    "lib"
+  ],
+  "pair_warnings": [
+    {
+      "execution_mode": "worker",
+      "isolation": "git-worktree",
+      "message": "worker usually runs in main-worktree; git-worktree is rare for pactile-implement"
+    },
+    {
+      "execution_mode": "inline",
+      "isolation": "git-worktree",
+      "message": "inline + git-worktree is unusual; consider child-task if isolation is intentional"
+    }
+  ]
+}

package/dist/templates/pactile/config.yaml

@@ -1,130 +1,111 @@
-# Pactile Configuration
-# Project-level settings for the Pactile workflow system
-#
-# All values have sensible defaults. Only override what you need.
-
-#-------------------------------------------------------------------------------
-# Session Recording
-#-------------------------------------------------------------------------------
-
-# Commit message used when auto-committing journal/index changes
-# after running add_session.py
-session_commit_message: "chore: record journal"
-
-# Maximum lines per journal file before rotating to a new one
-max_journal_lines: 2000
-
-#-------------------------------------------------------------------------------
-# Session Auto-Commit
-#-------------------------------------------------------------------------------
-
-# Auto-commit behavior for session journal + task archive operations.
-# - true (default): scripts auto-stage and auto-commit journal / task changes
-#   after add_session.py / task.py archive runs.
-# - false: scripts do not touch git. Files (journal-*.md, task archive moves)
-#   are still written to disk; you decide whether to git add / commit.
-#
-# Use `false` if your project's .gitignore intentionally excludes `.pactile/`
-# and you want session data kept local-only, or if you prefer to review
-# staged changes manually before each commit.
-#
-# Accepts: true / false / yes / no / 1 / 0 / on / off (case-insensitive).
-#
-# session_auto_commit: true
-
-#-------------------------------------------------------------------------------
-# Context injection (opt-in)
-#-------------------------------------------------------------------------------
-
-# Optional get_context enrichment. Default off — JOURNAL FILE stays metadata-only.
-#
-# context_injection:
-#   journal_snippet: false   # opt-in; inject ≤150 token recent journal summary in get_context
-
-#-------------------------------------------------------------------------------
-# Task Lifecycle Hooks
-#-------------------------------------------------------------------------------
-
-# Shell commands to run after task lifecycle events.
-# Each hook receives TASK_JSON_PATH environment variable pointing to task.json.
-# Hook failures print a warning but do not block the main operation.
-#
-# hooks:
-#   after_create:
-#     - "echo 'Task created'"
-#   after_start:
-#     - "echo 'Task started'"
-#   after_finish:
-#     - "echo 'Task finished'"
-#   after_archive:
-#     - "echo 'Task archived'"
-
-#-------------------------------------------------------------------------------
-# Monorepo / Packages
-#-------------------------------------------------------------------------------
-
-# Declare packages for monorepo projects.
-# Pactile auto-detects workspaces during `pactile init`, but you can also
-# configure them manually here.
-#
-# packages:
-#   frontend:
-#     path: packages/frontend
-#   backend:
-#     path: packages/backend
-#   docs:
-#     path: docs-site
-#     type: submodule
-#   # For polyrepo / meta-repo layouts (independent .git in each subdir),
-#   # mark the package with `git: true`. The runtime treats it as an
-#   # independent repository for things like git-context display.
-#   webapp:
-#     path: ./webapp
-#     git: true
-
-# Default package used when --package is not specified.
-# default_package: frontend
-
-#-------------------------------------------------------------------------------
-# Human-reviewed artifact locale (zh | en)
-#-------------------------------------------------------------------------------
-
-# Language for prd/design/implement/verify/handoff and task create seeds.
-# Does NOT translate CLI UI or existing archived tasks.
-#
-# artifact_locale: zh
-
-#-------------------------------------------------------------------------------
-# Smart Search CLI (optional per-machine override)
-#-------------------------------------------------------------------------------
-# run_smart_search.py resolves: env PACTILE_SMART_SEARCH_COMMAND, then this
-# setting, then PATH, then node_modules/.bin and repo wrappers. No .runtime cache.
-#
-# smart_search:
-#   command: smart-search
-
-#-------------------------------------------------------------------------------
-# Cursor subagent dispatch (documentation only — not Cursor product settings)
-#-------------------------------------------------------------------------------
-# See .pactile/framework/cursor-subagent-policy.md
-#
-# cursor:
-#   subagent_dispatch:
-#     mode: agent
-#     model_policy: cursor-configured
-#   child_worker:
-#     mode: separate_writable_agent_session
-#     reuse_policy: true
-
-#-------------------------------------------------------------------------------
-# Codex (dispatch behavior)
-#-------------------------------------------------------------------------------
-# Codex-only knob; other platforms ignore it. Default ("inline") makes the
-# main Codex agent edit code directly because Codex sub-agents run with
-# `fork_turns="none"` isolation and can't inherit the parent session's
-# task context. Set to "sub-agent" to opt into the legacy dispatch model
-# (main agent spawns pactile-implement / pactile-check / pactile-research
-# sub-agents).
-#
-# codex:
-#   dispatch_mode: inline  # or "sub-agent" to dispatch pactile-* sub-agents
+# Pactile Configuration
+# Project-level settings for the Pactile workflow system
+#
+# All values have sensible defaults. Only override what you need.
+
+#-------------------------------------------------------------------------------
+# Session Recording
+#-------------------------------------------------------------------------------
+
+# Commit message used when auto-committing journal/index changes
+# after running pactile session add
+session_commit_message: "chore: record journal"
+
+# Maximum lines per journal file before rotating to a new one
+max_journal_lines: 2000
+
+#-------------------------------------------------------------------------------
+# Session Auto-Commit
+#-------------------------------------------------------------------------------
+
+# Auto-commit behavior for session journal + task archive operations.
+# - true (default): scripts auto-stage and auto-commit journal / task changes
+#   after pactile session add / pactile task archive runs.
+# - false: scripts do not touch git. Files (journal-*.md, task archive moves)
+#   are still written to disk; you decide whether to git add / commit.
+#
+# Use `false` if your project's .gitignore intentionally excludes `.pactile/`
+# and you want session data kept local-only, or if you prefer to review
+# staged changes manually before each commit.
+#
+# Accepts: true / false / yes / no / 1 / 0 / on / off (case-insensitive).
+#
+# session_auto_commit: true
+
+#-------------------------------------------------------------------------------
+# Context injection (opt-in)
+#-------------------------------------------------------------------------------
+
+# Optional get_context enrichment. Default off — JOURNAL FILE stays metadata-only.
+#
+# context_injection:
+#   journal_snippet: false   # opt-in; inject ≤150 token recent journal summary in get_context
+
+#-------------------------------------------------------------------------------
+# Task Lifecycle Hooks
+#-------------------------------------------------------------------------------
+
+# Shell commands to run after task lifecycle events.
+# Each hook receives TASK_JSON_PATH environment variable pointing to task.json.
+# Hook failures print a warning but do not block the main operation.
+#
+# hooks:
+#   after_create:
+#     - "echo 'Task created'"
+#   after_start:
+#     - "echo 'Task started'"
+#   after_finish:
+#     - "echo 'Task finished'"
+#   after_archive:
+#     - "echo 'Task archived'"
+
+#-------------------------------------------------------------------------------
+# Monorepo / Packages
+#-------------------------------------------------------------------------------
+
+# Declare packages for monorepo projects.
+# Pactile auto-detects workspaces during `pactile init`, but you can also
+# configure them manually here.
+#
+# packages:
+#   frontend:
+#     path: packages/frontend
+#   backend:
+#     path: packages/backend
+#   docs:
+#     path: docs-site
+#     type: submodule
+#   # For polyrepo / meta-repo layouts (independent .git in each subdir),
+#   # mark the package with `git: true`. The runtime treats it as an
+#   # independent repository for things like git-context display.
+#   webapp:
+#     path: ./webapp
+#     git: true
+
+# Default package used when --package is not specified.
+# default_package: frontend
+
+#-------------------------------------------------------------------------------
+# Human-reviewed artifact locale (zh | en)
+#-------------------------------------------------------------------------------
+
+# Language for prd/design/implement/verify/handoff and task create seeds.
+# Does NOT translate CLI UI or existing archived tasks.
+#
+# artifact_locale: zh
+
+#-------------------------------------------------------------------------------
+# Smart Search CLI (optional per-machine override)
+#-------------------------------------------------------------------------------
+# The Smart Search adapter resolves env PACTILE_SMART_SEARCH_COMMAND, then this
+# setting, then PATH, then node_modules/.bin and repo wrappers. No .runtime cache.
+#
+# smart_search:
+#   command: smart-search
+
+#-------------------------------------------------------------------------------
+# Codex desktop task bridge (CLI and App-native tools; no config switch)
+#-------------------------------------------------------------------------------
+# Use `pactile codex prepare|receipt|status` for native desktop task requests
+# and host-reported receipts. Pactile does not dispatch Codex subagents. See
+# .pactile/framework/codex-worker-dispatch.md.