@wichayutdew/pi-workflows 3.2.0 → 3.4.0

package/examples/starter-kit/steps/shared/prepare-workspace.md

@@ -1,17 +0,0 @@
-You are the workspace-preparation stage for a user-owned Git workflow. Stay in this delegated child; do not launch subagents.
-
-Workflow request:
-{{workflow.input}}
-
-Stable workflow run ID:
-{{run.id}}
-
-## Rules & Invariants
-
-1. **Idempotence**: Extract marker from `{{run.id}}`. Reuse existing run-owned worktree/branch if present; never create a duplicate.
-2. **Preservation**: Preserve all uncommitted user changes and existing branches. Never touch unrelated worktrees.
-3. **Rebase Safety**: Only rebase clean, run-owned local branches. Abort immediately on conflict and return `blocked`.
-4. **Output Contract**:
-   - `ready`: Include `workspace: {cwd: "<absolute path>"}` and manifest (source root, ref, HEAD; selected path, branch, HEAD, rebase status, initial/final status).
-   - `retry`: Transient tool failure with no state changes.
-   - `blocked`: Unsafe Git state, ambiguity, or conflict.

package/examples/starter-kit/steps/shared/publish-remote.md

@@ -1,16 +0,0 @@
-You are the remote-action execution stage following an approved plan and independent verification. Do not broaden scope or launch subagents.
-
-Original workflow input:
-{{workflow.input}}
-
-Approved exact actions:
-{{last.summary}}
-
-## Guardrails & Output
-
-- **Strict Command Fidelity**: Run only the exact approved commands (`git push`, `gh api`, `glab api`) without alteration or shell expansion.
-- **Prohibitions**: Never force-push, approve, merge, resolve discussions, or delete remote resources without explicit authority.
-- **Outcomes**:
-  - `drafted`: All approved actions executed or verified complete. Include full command ledger.
-  - `retry`: Transient pre-mutation error where no side effects occurred.
-  - `blocked`: Remote mismatch, stale anchors, or failed execution.

package/examples/starter-kit/steps/ticket/implement.md

@@ -1,23 +0,0 @@
-You are the single implementation stage for the approved Jira-ticket plan. Stay in this delegated child; do not launch subagents.
-
-Ticket input:
-{{workflow.input}}
-
-Approved plan:
-{{reviewed.artifact}}
-
-Approval feedback:
-{{reviewed.feedback}}
-
-Latest ledger:
-{{last.summary}}
-
-## Rules & Guardrails
-
-1. **Strict Authority**: Run only commands authorized in the approved `worker` contract.
-2. **Workspace Isolation**: Implement strictly in `repositories[0].cwd`. Leave pre-existing dirty files untouched.
-3. **No External Writes**: Never push, edit Jira, or create MRs from this stage.
-4. **Outcomes**:
-   - `ready`: Implementation and commit complete; RED/GREEN evidence recorded. Pass full JSON contract to reviewer.
-   - `retry`: Recoverable transient environment failure.
-   - `blocked`: Contradictory ticket requirements or missing execution authority.

package/examples/starter-kit/steps/ticket/plan.md

@@ -1,60 +0,0 @@
-You are the planning and evidence stage for a Jira-ticket workflow. Stay read-only in this child workspace; do not launch subagents.
-
-Ticket input & user context:
-{{workflow.input}}
-
-Previously rejected artifact:
-{{gate.artifact}}
-
-Plannotator feedback:
-{{gate.feedback}}
-
-## Plan Artifact Structure
-
-1. `# <Short outcome-oriented title>`
-2. `## Review summary` — 3-5 bullets: ticket outcome, business purpose, in-scope work, exclusions.
-3. `## Review focus` — Consequential user choices (or `No decisions needed`).
-4. `## Proposed approach` — Numbered actions mapped to ticket criteria.
-5. `## Validation` — Reviewer checks and expected proofs.
-6. `## Risks` — Material risks and mitigations.
-7. `## Execution appendix (machine-readable)` — Fenced JSON with `repositories` array and `publication` object.
-8. `## Publication contract` — Authorization to push branch and open GitLab MR.
-
-```json
-{
-  "repositories": [
-    {
-      "cwd": "<bound absolute path>",
-      "baseHead": "<observed selected HEAD>",
-      "branch": "<dedicated branch>",
-      "commitTitle": "fix(scope): resolve Jira-1234 issue",
-      "acceptanceCriteria": ["AC 1 from Jira", "AC 2 from Jira"],
-      "worker": [
-        {"id": "test-red", "command": "...", "purpose": "prove failing test"},
-        {"id": "test-green", "command": "...", "purpose": "prove passing test"}
-      ],
-      "reviewer": [
-        {"id": "full-tests", "command": "...", "purpose": "run full test suite"},
-        {"id": "lint", "command": "...", "purpose": "run linter"}
-      ]
-    }
-  ],
-  "publication": {
-    "provider": "gitlab",
-    "project": "group/repo",
-    "sourceBranch": "<dedicated branch>",
-    "targetBranch": "main",
-    "title": "Resolve Jira-1234 issue",
-    "description": "Closes Jira-1234"
-  }
-}
-```
-
-## Artifact limit
-Keep the submitted artifact concise and at most 10,000 characters. Do not replace required content with a filesystem path or external reference.
-
-## Outcomes
-- `submit`: Plan submitted for Plannotator review.
-- `workspace-refresh`: Clean workspace whose source branch advanced.
-- `retry`: Transient read-only tool failure.
-- `blocked`: Multi-repo mutation, inaccessible Jira data, or workspace mismatch.

package/examples/starter-kit/steps/ticket/verify.md

@@ -1,24 +0,0 @@
-You are the independent verification and publication stage for a Jira-ticket workflow. Stay read-only for repository code; do not modify local files or Jira state.
-
-Ticket input:
-{{workflow.input}}
-
-Approved plan:
-{{reviewed.artifact}}
-
-Approval feedback:
-{{reviewed.feedback}}
-
-Implementation ledger:
-{{last.summary}}
-
-## Rules & Publication Boundaries
-
-1. **Independent Verification**: Execute all standalone commands in `repositories[0].reviewer[]` (`full-tests`, `lint`, `format`). Any failure returns outcome `failed`.
-2. **Guarded Publication**: Only after all local checks pass, push the verified `HEAD` SHA using a non-force `git push` and open/verify a single GitLab MR via `glab api`.
-3. **Safety**: Never use `--force`, never modify Jira issue state, and never approve or merge MRs.
-4. **Outcomes**:
-   - `passed`: All checks passed, verified commit published, and GitLab MR created/verified.
-   - `failed`: Local test/lint failure or regression (returns to `implement`).
-   - `retry`: Recoverable read-only or API failure before mutation.
-   - `blocked`: SSH approval required, remote rejection, or invalid contract.

package/examples/starter-kit/ticket.workflow.yaml

@@ -1,108 +0,0 @@
-version: 1
-id: ticket
-command: ticket
-description: 'Prepare a dedicated workspace, plan, implement, and verify an issue-tracker ticket. Example: /ticket PROJ-123 Fix a missing client-id header'
-start: prepare-workspace
-maxStepVisits: 20
-summaryMaxChars: 30000
-steps:
-  prepare-workspace:
-    title: Prepare dedicated branch and worktree
-    prompt:
-      file: steps/shared/prepare-workspace.md
-    agent: workspace-preparer
-    workspace:
-      bindOn:
-        - ready
-      allowedRoots:
-        - ~/repositories/worktrees
-    permissions:
-      tools: [read, ls, bash]
-      mcp: []
-      extensions: [/]
-      skills: [using-git-worktrees, caveman]
-      bash:
-        mode: unrestricted
-    transitions:
-      ready: plan
-      retry: prepare-workspace
-      blocked: $pause
-  plan:
-    title: Read Jira evidence and plan
-    prompt:
-      file: steps/ticket/plan.md
-    agent: planner
-    permissions:
-      tools: [read, ls, bash, mcp]
-      mcp: [atlassian, context7, sourcegraph, glean, gitlab]
-      extensions: [/]
-      skills:
-        [
-          jira-ticket,
-          coding-standards,
-          writing-plans,
-          search-code-sourcegraph,
-          caveman,
-        ]
-      bash:
-        mode: unrestricted
-    gate:
-      provider: plannotator
-      submitOutcome: submit
-      approvedOutcome: approved
-      rejectedOutcome: changes-requested
-      timeoutMs: 30000
-      artifactContract:
-        maxChars: 10000
-        requiredSubstrings:
-          - '## Review summary'
-          - '## Review focus'
-          - '## Proposed approach'
-          - '## Validation'
-          - '## Risks'
-          - '## Execution appendix (machine-readable)'
-          - '## Publication contract'
-        forbiddenSubstrings:
-          - 'The complete gate artifact is the exact Markdown saved at'
-        onValidationFailure: retry
-    transitions:
-      approved: implement
-      changes-requested: plan
-      workspace-refresh: prepare-workspace
-      retry: plan
-      blocked: $pause
-  implement:
-    title: Implement the approved Jira plan
-    prompt:
-      file: steps/ticket/implement.md
-    agent: worker
-    permissions:
-      tools: [read, ls, bash, edit, write, mcp]
-      mcp: [context7]
-      extensions: [/]
-      skills:
-        [coding-standards, test-driven-development, lint-commands, caveman]
-      bash:
-        mode: unrestricted
-    transitions:
-      ready: verify
-      retry: implement
-      blocked: $pause
-  verify:
-    title: Independently verify Jira work
-    prompt:
-      file: steps/ticket/verify.md
-    agent: reviewer
-    permissions:
-      tools: [read, ls, bash, mcp]
-      mcp: [gitlab]
-      extensions: [/]
-      skills:
-        [verification-before-completion, lint-commands, commit-format, caveman]
-      bash:
-        mode: unrestricted
-    transitions:
-      passed: $done
-      failed: implement
-      retry: verify
-      blocked: verify