@wichayutdew/pi-workflows 0.1.1

package/examples/mr-comments.workflow.yaml

@@ -0,0 +1,115 @@
+# yaml-language-server: $schema=../schemas/workflow.schema.json
+version: 1
+id: mr-comments
+command: mr-comments
+description: Inspect merge-request feedback, plan changes, implement, and verify
+start: inspect
+maxStepVisits: 5
+summaryMaxChars: 4000
+steps:
+  inspect:
+    title: Inspect merge request
+    prompt:
+      file: prompts/mr-comments/inspect.md
+    subagent:
+      agent: pi-workflows.step
+      context: fresh
+      timeoutMs: 600000
+      turnBudget:
+        maxTurns: 12
+        graceTurns: 2
+    permissions:
+      tools: [read, grep, bash]
+      mcp: [gitlab/get_merge_request, gitlab/list_merge_request_discussions]
+      bash:
+        mode: read-only
+    requires:
+      tools: [read, bash, mcp]
+    transitions:
+      ready: plan
+      blocked: $pause
+  plan:
+    title: Plan the change
+    prompt:
+      file: prompts/mr-comments/plan.md
+    subagent:
+      agent: pi-workflows.step
+      context: fresh
+      timeoutMs: 600000
+      turnBudget:
+        maxTurns: 16
+        graceTurns: 2
+    permissions:
+      tools: [read, grep, bash]
+      mcp: [gitlab/get_merge_request, gitlab/list_merge_request_discussions]
+      extensions: [plannotator]
+      skills: [superpowers:brainstorming]
+      bash:
+        mode: read-only
+    requires:
+      tools: [read, mcp]
+      extensions: [plannotator]
+      skills: [superpowers:brainstorming]
+    gate:
+      provider: plannotator
+      submitOutcome: submit
+      approvedOutcome: approved
+      rejectedOutcome: changes-requested
+      timeoutMs: 5000
+    transitions:
+      approved: implement
+      changes-requested: plan
+      blocked: $pause
+  implement:
+    title: Implement the approved plan
+    prompt:
+      file: prompts/mr-comments/implement.md
+    subagent:
+      agent: pi-workflows.step
+      context: fresh
+      timeoutMs: 1200000
+      artifacts: true
+    permissions:
+      tools: [read, grep, edit, write, bash]
+      skills: [superpowers:test-driven-development]
+      bash:
+        mode: allow-list
+        allow:
+          - executable: git
+            argsPrefixes: [[status], [diff]]
+          - executable: npm
+            argsPrefix: [test]
+        approvedSources: [verification-worker]
+    requires:
+      tools: [read, edit, bash]
+      skills: [superpowers:test-driven-development]
+    transitions:
+      ready: verify
+      blocked: $pause
+  verify:
+    title: Verify the result
+    prompt:
+      file: prompts/mr-comments/verify.md
+    subagent:
+      agent: pi-workflows.step
+      context: fresh
+      timeoutMs: 600000
+      turnBudget:
+        maxTurns: 16
+        graceTurns: 2
+    permissions:
+      tools: [read, grep, bash]
+      bash:
+        mode: allow-list
+        allow:
+          - executable: git
+            argsPrefixes: [[status], [diff]]
+          - executable: npm
+            argsPrefix: [test]
+        approvedSources: [verification-reviewer]
+    requires:
+      tools: [read, bash]
+    transitions:
+      passed: $done
+      failed: implement
+      blocked: $pause

package/examples/prompts/mr-comments/implement.md

@@ -0,0 +1,8 @@
+Implement the approved plan with a small, coherent diff.
+
+Use repository conventions and the allowed skill. Add or update focused tests
+where practical. Run only exact reviewed worker commands plus the static
+allow-list. Do not perform remote actions. Complete with `ready` when
+implementation and focused checks are complete; include the exact fenced JSON
+contract in the summary for verification. Complete with `blocked` if the
+harness, configuration, or repository must be fixed first.

package/examples/prompts/mr-comments/inspect.md

@@ -0,0 +1,5 @@
+Inspect the merge request described by:
+
+{{workflow.input}}
+
+Read the relevant discussion and repository state. Separate facts from assumptions. Do not modify files. When the requested work is clear, complete with `ready`. If identity, access, or requirements are unresolved, complete with `blocked`.

package/examples/prompts/mr-comments/plan.md

@@ -0,0 +1,13 @@
+Create a concrete implementation plan from the inspected feedback.
+
+Include scope, exact files or symbols, risks, and verification. Account for prior review feedback:
+
+{{gate.feedback}}
+
+Include one fenced `json` verification contract with a top-level
+`repositories` array. Put exact standalone implementation commands under
+`worker[].command` and independent commands under `reviewer[].command`.
+
+When the plan is ready, call `workflow_complete_step` with outcome `submit` and
+place the full Markdown plan in `artifact`. The Plannotator gate decides the
+next transition; its reviewed artifact becomes the next step's handoff.

package/examples/prompts/mr-comments/verify.md

@@ -0,0 +1,7 @@
+Review the implementation against the requested merge-request feedback and approved plan.
+
+Inspect the diff and run the exact reviewed reviewer commands plus the static
+allow-list. Complete with `passed` only when evidence supports completion.
+Complete with `failed` to return to implementation and preserve the exact
+fenced JSON contract in the summary, or `blocked` when a human must repair the
+workflow or environment.

package/examples/settings.yaml

@@ -0,0 +1,19 @@
+# yaml-language-server: $schema=../schemas/settings.schema.json
+version: 1
+allowProjectWorkflows: false
+permissionCeiling:
+  tools: [read, grep, bash]
+  mcp: []
+  extensions: []
+  skills: []
+  bash:
+    mode: read-only
+  subagent:
+    agents: [pi-workflows.step, scout, worker, reviewer]
+    contexts: [fresh]
+    models: []
+    maxTimeoutMs: 900000
+    maxTurns: 40
+    maxGraceTurns: 3
+    maxToolCalls: 100
+    artifacts: false

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@wichayutdew/pi-workflows",
+  "version": "0.1.1",
+  "description": "A declarative, pauseable workflow harness for Pi",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wichayutdew/pi-workflows.git"
+  },
+  "homepage": "https://github.com/wichayutdew/pi-workflows#readme",
+  "bugs": {
+    "url": "https://github.com/wichayutdew/pi-workflows/issues"
+  },
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "workflow",
+    "agent"
+  ],
+  "files": [
+    "dist",
+    "src",
+    "agents",
+    "examples",
+    "schemas",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ],
+    "subagents": {
+      "agents": [
+        "./agents"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir=dist --target=node --format=esm --packages=external",
+    "format": "bunx --bun prettier . --write",
+    "format:check": "bunx --bun prettier . --check",
+    "lint": "bun --bun eslint .",
+    "lint:fix": "bun --bun eslint . --fix",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "check": "bun run lint && bun run format:check && bun run typecheck && bun test && bun run build"
+  },
+  "dependencies": {
+    "yaml": "^2.8.3"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "pi-subagents": ">=0.35.1",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "pi-subagents": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.81.1",
+    "@earendil-works/pi-tui": "^0.81.1",
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^24.0.0",
+    "eslint": "^10.7.0",
+    "globals": "^17.7.0",
+    "pi-subagents": "^0.35.1",
+    "prettier": "^3.9.5",
+    "typebox": "^1.1.38",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.64.0"
+  },
+  "packageManager": "bun@1.3.14",
+  "engines": {
+    "node": ">=22.19.0"
+  }
+}

package/schemas/settings.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Pi workflows settings",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version"],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "version": {
+      "const": 1
+    },
+    "allowProjectWorkflows": {
+      "type": "boolean",
+      "default": false
+    },
+    "permissionCeiling": {
+      "$ref": "workflow.schema.json#/$defs/permissionCeiling"
+    }
+  }
+}