@fro.bot/systematic 2.33.3 → 3.0.1

package/dist/schemas/systematic-config.schema.json

@@ -37,12 +37,12 @@
       }
     }
   ],
-  "$id": "https://fro.bot/systematic/schemas/v2/systematic-config.schema.json",
+  "$id": "https://fro.bot/systematic/schemas/v3/systematic-config.schema.json",
   "definitions": {
     "__schema0": {
       "description": "JSON Schema URL for IDE autocomplete. The value is informational only — the loader does not fetch or validate against it. Add this to enable IDE schema activation and field-level autocomplete in editors that support JSON Schema (VSCode, Zed, IntelliJ).",
       "examples": [
-        "https://fro.bot/systematic/schemas/v2/systematic-config.schema.json"
+        "https://fro.bot/systematic/schemas/latest/systematic-config.schema.json"
       ],
       "allOf": [
         {
@@ -100,13 +100,6 @@
             }
           ]
         },
-        "ankane-readme-writer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "api-contract-reviewer": {
           "allOf": [
             {
@@ -135,13 +128,6 @@
             }
           ]
         },
-        "cli-agent-readiness-reviewer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "cli-readiness-reviewer": {
           "allOf": [
             {
@@ -170,20 +156,6 @@
             }
           ]
         },
-        "data-integrity-guardian": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
-        "data-migration-expert": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "data-migrations-reviewer": {
           "allOf": [
             {
@@ -198,13 +170,6 @@
             }
           ]
         },
-        "design-implementation-reviewer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "design-iterator": {
           "allOf": [
             {
@@ -219,13 +184,6 @@
             }
           ]
         },
-        "dhh-rails-reviewer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "feasibility-reviewer": {
           "allOf": [
             {
@@ -233,13 +191,6 @@
             }
           ]
         },
-        "figma-design-sync": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "framework-docs-researcher": {
           "allOf": [
             {
@@ -261,27 +212,6 @@
             }
           ]
         },
-        "julik-frontend-races-reviewer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
-        "kieran-python-reviewer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
-        "kieran-rails-reviewer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "kieran-typescript-reviewer": {
           "allOf": [
             {
@@ -296,13 +226,6 @@
             }
           ]
         },
-        "lint": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "maintainability-reviewer": {
           "allOf": [
             {
@@ -317,13 +240,6 @@
             }
           ]
         },
-        "performance-oracle": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "performance-reviewer": {
           "allOf": [
             {
@@ -373,13 +289,6 @@
             }
           ]
         },
-        "schema-drift-detector": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "scope-guardian-reviewer": {
           "allOf": [
             {
@@ -401,13 +310,6 @@
             }
           ]
         },
-        "security-sentinel": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "slack-researcher": {
           "allOf": [
             {
@@ -436,13 +338,6 @@
             }
           ]
         },
-        "design/design-implementation-reviewer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "design/design-iterator": {
           "allOf": [
             {
@@ -450,20 +345,6 @@
             }
           ]
         },
-        "design/figma-design-sync": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
-        "docs/ankane-readme-writer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "document-review/adversarial-document-reviewer": {
           "allOf": [
             {
@@ -590,13 +471,6 @@
             }
           ]
         },
-        "review/cli-agent-readiness-reviewer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "review/cli-readiness-reviewer": {
           "allOf": [
             {
@@ -618,20 +492,6 @@
             }
           ]
         },
-        "review/data-integrity-guardian": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
-        "review/data-migration-expert": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "review/data-migrations-reviewer": {
           "allOf": [
             {
@@ -646,34 +506,6 @@
             }
           ]
         },
-        "review/dhh-rails-reviewer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
-        "review/julik-frontend-races-reviewer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
-        "review/kieran-python-reviewer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
-        "review/kieran-rails-reviewer": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "review/kieran-typescript-reviewer": {
           "allOf": [
             {
@@ -695,13 +527,6 @@
             }
           ]
         },
-        "review/performance-oracle": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "review/performance-reviewer": {
           "allOf": [
             {
@@ -730,13 +555,6 @@
             }
           ]
         },
-        "review/schema-drift-detector": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "review/security-reviewer": {
           "allOf": [
             {
@@ -744,13 +562,6 @@
             }
           ]
         },
-        "review/security-sentinel": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "review/testing-reviewer": {
           "allOf": [
             {
@@ -765,13 +576,6 @@
             }
           ]
         },
-        "workflow/lint": {
-          "allOf": [
-            {
-              "$ref": "#/definitions/__schema4"
-            }
-          ]
-        },
         "workflow/pr-comment-resolver": {
           "allOf": [
             {
@@ -1256,7 +1060,6 @@
           "agent-browser",
           "agent-native-architecture",
           "agent-native-audit",
-          "andrew-kane-gem-writer",
           "ce:brainstorm",
           "ce:compound",
           "ce:compound-refresh",
@@ -1264,19 +1067,11 @@
           "ce:plan",
           "ce:review",
           "ce:work",
-          "changelog",
-          "claude-permissions-optimizer",
           "compound-docs",
           "deepen-plan",
           "deploy-docs",
-          "dhh-rails-style",
           "document-review",
-          "dspy-ruby",
-          "every-style-editor",
-          "feature-video",
           "frontend-design",
-          "gemini-imagegen",
-          "generate_command",
           "git-clean-gone-branches",
           "git-commit",
           "git-commit-push-pr",
@@ -1284,22 +1079,32 @@
           "lfg",
           "onboarding",
           "orchestrating-subagents",
-          "orchestrating-swarms",
-          "proof",
-          "rclone",
           "report-bug-ce",
           "reproduce-bug",
           "resolve-pr-feedback",
-          "setup",
           "slfg",
           "test-browser",
           "test-driven-development",
+          "todos",
+          "using-systematic",
+          "writing-skills",
+          "andrew-kane-gem-writer",
+          "changelog",
+          "claude-permissions-optimizer",
+          "dhh-rails-style",
+          "dspy-ruby",
+          "every-style-editor",
+          "feature-video",
+          "gemini-imagegen",
+          "generate_command",
+          "orchestrating-swarms",
+          "proof",
+          "rclone",
+          "setup",
           "test-xcode",
           "todo-create",
           "todo-resolve",
           "todo-triage",
-          "using-systematic",
-          "writing-skills",
           "writing-systematic-skills"
         ]
       }
@@ -1325,38 +1130,26 @@
           "adversarial-document-reviewer",
           "adversarial-reviewer",
           "agent-native-reviewer",
-          "ankane-readme-writer",
           "api-contract-reviewer",
           "architecture-strategist",
           "best-practices-researcher",
           "bug-reproduction-validator",
-          "cli-agent-readiness-reviewer",
           "cli-readiness-reviewer",
           "code-simplicity-reviewer",
           "coherence-reviewer",
           "correctness-reviewer",
-          "data-integrity-guardian",
-          "data-migration-expert",
           "data-migrations-reviewer",
           "deployment-verification-agent",
-          "design-implementation-reviewer",
           "design-iterator",
           "design-lens-reviewer",
-          "dhh-rails-reviewer",
           "feasibility-reviewer",
-          "figma-design-sync",
           "framework-docs-researcher",
           "git-history-analyzer",
           "issue-intelligence-analyst",
-          "julik-frontend-races-reviewer",
-          "kieran-python-reviewer",
-          "kieran-rails-reviewer",
           "kieran-typescript-reviewer",
           "learnings-researcher",
-          "lint",
           "maintainability-reviewer",
           "pattern-recognition-specialist",
-          "performance-oracle",
           "performance-reviewer",
           "pr-comment-resolver",
           "previous-comments-reviewer",
@@ -1364,19 +1157,14 @@
           "project-standards-reviewer",
           "reliability-reviewer",
           "repo-research-analyst",
-          "schema-drift-detector",
           "scope-guardian-reviewer",
           "security-lens-reviewer",
           "security-reviewer",
-          "security-sentinel",
           "slack-researcher",
           "spec-flow-analyzer",
           "systematic-implementer",
           "testing-reviewer",
-          "design/design-implementation-reviewer",
           "design/design-iterator",
-          "design/figma-design-sync",
-          "docs/ankane-readme-writer",
           "document-review/adversarial-document-reviewer",
           "document-review/coherence-reviewer",
           "document-review/design-lens-reviewer",
@@ -1395,35 +1183,52 @@
           "review/agent-native-reviewer",
           "review/api-contract-reviewer",
           "review/architecture-strategist",
-          "review/cli-agent-readiness-reviewer",
           "review/cli-readiness-reviewer",
           "review/code-simplicity-reviewer",
           "review/correctness-reviewer",
-          "review/data-integrity-guardian",
-          "review/data-migration-expert",
           "review/data-migrations-reviewer",
           "review/deployment-verification-agent",
-          "review/dhh-rails-reviewer",
-          "review/julik-frontend-races-reviewer",
-          "review/kieran-python-reviewer",
-          "review/kieran-rails-reviewer",
           "review/kieran-typescript-reviewer",
           "review/maintainability-reviewer",
           "review/pattern-recognition-specialist",
-          "review/performance-oracle",
           "review/performance-reviewer",
           "review/previous-comments-reviewer",
           "review/project-standards-reviewer",
           "review/reliability-reviewer",
-          "review/schema-drift-detector",
           "review/security-reviewer",
-          "review/security-sentinel",
           "review/testing-reviewer",
           "workflow/bug-reproduction-validator",
-          "workflow/lint",
           "workflow/pr-comment-resolver",
           "workflow/spec-flow-analyzer",
-          "workflow/systematic-implementer"
+          "workflow/systematic-implementer",
+          "ankane-readme-writer",
+          "cli-agent-readiness-reviewer",
+          "data-integrity-guardian",
+          "data-migration-expert",
+          "design-implementation-reviewer",
+          "design/design-implementation-reviewer",
+          "design/figma-design-sync",
+          "dhh-rails-reviewer",
+          "docs/ankane-readme-writer",
+          "figma-design-sync",
+          "julik-frontend-races-reviewer",
+          "kieran-python-reviewer",
+          "kieran-rails-reviewer",
+          "lint",
+          "performance-oracle",
+          "review/cli-agent-readiness-reviewer",
+          "review/data-integrity-guardian",
+          "review/data-migration-expert",
+          "review/dhh-rails-reviewer",
+          "review/julik-frontend-races-reviewer",
+          "review/kieran-python-reviewer",
+          "review/kieran-rails-reviewer",
+          "review/performance-oracle",
+          "review/schema-drift-detector",
+          "review/security-sentinel",
+          "schema-drift-detector",
+          "security-sentinel",
+          "workflow/lint"
         ]
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fro.bot/systematic",
-  "version": "2.33.3",
+  "version": "3.0.1",
   "description": "Structured engineering workflows for OpenCode",
   "type": "module",
   "homepage": "https://fro.bot/systematic",
@@ -14,6 +14,14 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "pi": {
+    "extensions": [
+      "./dist/pi.js"
+    ],
+    "skills": [
+      "./skills"
+    ]
+  },
   "files": [
     "dist",
     "skills",
@@ -25,7 +33,7 @@
   ],
   "scripts": {
     "clean": "rimraf dist",
-    "build": "bun run clean && bun build src/index.ts src/cli.ts --outdir dist --target bun --splitting --external @opencode-ai/plugin --external js-yaml && tsc --emitDeclarationOnly",
+    "build": "bun run clean && bun build src/index.ts src/cli.ts --outdir dist --target bun --splitting --external @opencode-ai/plugin --external js-yaml && bun build src/pi.ts --outdir dist --target node --external @earendil-works/pi-coding-agent --external typebox && tsc --emitDeclarationOnly",
     "dev": "bun --watch src/index.ts",
     "test": "bun test tests/unit",
     "test:integration": "bun test tests/integration",
@@ -62,12 +70,26 @@
     "node": ">=18"
   },
   "peerDependencies": {
-    "@opencode-ai/plugin": "^1.1.30"
+    "@opencode-ai/plugin": "^1.1.30",
+    "@earendil-works/pi-coding-agent": "^0.80.6",
+    "typebox": "^1.1.38"
+  },
+  "peerDependenciesMeta": {
+    "@opencode-ai/plugin": {
+      "optional": true
+    },
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "typebox": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@biomejs/biome": "2.5.3",
-    "@opencode-ai/plugin": "1.17.18",
-    "@opencode-ai/sdk": "1.17.18",
+    "@earendil-works/pi-coding-agent": "0.80.6",
+    "@opencode-ai/plugin": "1.17.20",
+    "@opencode-ai/sdk": "1.17.20",
     "@semantic-release/exec": "7.1.0",
     "@types/bun": "latest",
     "@types/js-yaml": "4.0.9",
@@ -77,8 +99,9 @@
     "conventional-changelog-conventionalcommits": "9.3.1",
     "markdownlint-cli": "0.48.0",
     "rimraf": "6.1.3",
-    "semantic-release": "25.0.6",
+    "semantic-release": "25.0.7",
     "semantic-release-export-data": "1.2.0",
+    "typebox": "1.3.6",
     "typescript": "6.0.3"
   },
   "dependencies": {

package/skills/ce-brainstorm/references/handoff.md

@@ -6,10 +6,10 @@ This content is loaded when Phase 4 begins — after the requirements document i
 
 #### 4.1 Present Next-Step Options
 
-The Phase 4 menu's visible option count varies by state: no requirements doc hides the review and Proof options, unresolved `Resolve Before Planning` hides `Plan implementation` and `Build it now`, a failing direct-to-work gate hides `Build it now`. Count the visible options for the current state and choose the rendering mode accordingly:
+The Phase 4 menu's visible option count varies by state: no requirements doc hides the review option, unresolved `Resolve Before Planning` hides `Plan implementation` and `Build it now`, a failing direct-to-work gate hides `Build it now`. Count the visible options for the current state and choose the rendering mode accordingly:
 
 - **4 or fewer visible:** use the platform's blocking question tool (`question` in OpenCode — call `ToolSearch` with `select:question` first if its schema isn't loaded; `request_user_input` in Codex; `ask_user` in Gemini, `ask_user` in Pi (requires the `pi-ask-user` extension)). This is the default.
-- **5 or more visible:** render as a numbered list in chat. This is the narrow option-overflow fallback; trimming would hide legitimate choices (plan, review, Proof, build, refine, pause are all distinct destinations). Include a hint that free-form input is accepted ("Pick a number or describe what you want.") so the numbered list retains the blocking tool's open-endedness.
+- **5 or more visible:** render as a numbered list in chat. This is the narrow option-overflow fallback; trimming would hide legitimate choices (plan, review, build, refine, pause are all distinct destinations). Include a hint that free-form input is accepted ("Pick a number or describe what you want.") so the numbered list retains the blocking tool's open-endedness.
 
 Never silently skip the question.
 
@@ -47,10 +47,9 @@ Present only the options that apply. Renumber so visible options stay contiguous
 
 1. **Plan implementation with `ce-plan` (Recommended)** - Move to `ce-plan` for structured implementation planning. Shown only when `Resolve Before Planning` is empty.
 2. **Agent review of requirements doc with `ce-doc-review`** - Dispatch reviewer agents to check the doc for coherence, feasibility, scope, and other persona-specific issues; auto-apply safe fixes; route remaining findings interactively. Shown only when a requirements document exists.
-3. **Open in Proof — review and comment to iterate with the agent** - Open the doc in Every's Proof editor, iterate with the agent via comments, or copy a link to share with others. Shown only when a requirements document exists.
-4. **Build it now with `ce-work` (skip planning)** - Skip planning and move to `ce-work`; suited to lightweight, well-defined changes. Shown only when `Resolve Before Planning` is empty **and** scope is lightweight, success criteria are clear, scope boundaries are clear, and no meaningful technical or research questions remain (the "direct-to-work gate").
-5. **More clarifying questions to sharpen the doc** - Keep refining scope, edge cases, constraints, and preferences through further dialogue. Always shown.
-6. **Done for now** - Pause; the requirements doc is saved and can be resumed later. Always shown.
+3. **Build it now with `ce-work` (skip planning)** - Skip planning and move to `ce-work`; suited to lightweight, well-defined changes. Shown only when `Resolve Before Planning` is empty **and** scope is lightweight, success criteria are clear, scope boundaries are clear, and no meaningful technical or research questions remain (the "direct-to-work gate").
+4. **More clarifying questions to sharpen the doc** - Keep refining scope, edge cases, constraints, and preferences through further dialogue. Always shown.
+5. **Done for now** - Pause; the requirements doc is saved and can be resumed later. Always shown.
 
 **Post-review nudge (subsequent rounds only):** If the user has already run `ce-doc-review` this session and residual P0/P1 findings remain unaddressed, add a one-line prose nudge adjacent to the menu (e.g., "Document review flagged 2 P1 findings you may want to address — pick \"Agent review of requirements doc\" to run another pass."). Reference the option by label, not number: the menu renumbers when `Resolve Before Planning` hides `Plan implementation` and `Build it now`, so a hardcoded option number can point users at the wrong action. Do not add a separate menu option; reuse the existing agent-review option.
 
@@ -72,26 +71,6 @@ Immediately load the `ce-work` skill in the current session using the finalized
 
 **If user selects "More clarifying questions to sharpen the doc":** Return to Phase 1.3 (Collaborative Dialogue) and continue asking the user clarifying questions one at a time to further refine scope, edge cases, constraints, and preferences. Continue until the user is satisfied, then return to Phase 4. Do not show the closing summary yet.
 
-**If user selects "Open in Proof — review and comment to iterate with the agent":**
-
-Load the `ce-proof` skill in HITL-review mode with:
-
-- **source file:** `docs/brainstorms/YYYY-MM-DD-<topic>-requirements.md`
-- **doc title:** `Requirements: <topic title>`
-- **identity:** `ai:systematic` / `Systematic`
-- **recommended next step:** `ce-plan` (shown in the ce-proof skill's final terminal output)
-
-Follow `references/hitl-review.md` in the ce-proof skill. It uploads the doc, prompts the user for review in Proof's web UI, ingests each thread by reading it fresh and replying in-thread, applies agreed edits as tracked suggestions, and syncs the final markdown back to the source file atomically on proceed.
-
-When the ce-proof skill returns control:
-
-- `status: proceeded` with `localSynced: true` → the requirements doc on disk now reflects the review. Return to the Phase 4 options and re-render the menu (the doc may have changed substantially during review, so option eligibility can shift — re-evaluate `Resolve Before Planning`, direct-to-work gate, and residual ce-doc-review findings against the updated doc).
-- `status: proceeded` with `localSynced: false` → the reviewed version lives in Proof at `docUrl` but the local copy is stale. Offer to pull the Proof doc to `localPath` using the ce-proof skill's Pull workflow. Re-render the Phase 4 menu after the pull completes (or is declined). If the pull was declined, include a one-line note above the menu that `<localPath>` is stale vs. Proof — otherwise `Plan implementation` / `Build it now` / `Agent review of requirements doc` will silently read the pre-review copy (ce-doc-review would analyze stale content, and planning or work would skip the user's Proof edits).
-- `status: done_for_now` → the doc on disk may be stale if the user edited in Proof before leaving. Offer to pull the Proof doc to `localPath` so the local requirements file stays in sync, then return to the Phase 4 options. If the pull was declined, include the stale-local note above the menu. `done_for_now` means the user stopped the HITL loop without syncing — it does not mean they ended the whole brainstorm; they may still want to plan implementation, run an agent review, or keep refining the doc.
-- `status: aborted` → fall back to the Phase 4 options without changes.
-
-If the initial upload fails (network error, Proof API down), retry once after a short wait. If it still fails, tell the user the upload didn't succeed and briefly explain why, then return to the Phase 4 options — don't leave them wondering why the option did nothing.
-
 **If user selects "Done for now":** Display the closing summary (see 4.3) and end the turn.
 
 #### 4.3 Closing Summary

package/skills/ce-brainstorm/references/universal-brainstorming.md

@@ -59,5 +59,4 @@ When the conversation has enough material to narrow — reflect back what you've
 
 - **Create a plan** → hand off to `ce:plan` with the decided goal and constraints
 - **Save summary to disk** → write the summary as a markdown file in the current working directory
-- **Open in Proof (web app) — review and comment to iterate with the agent** → load the `ce-proof` skill to open the doc in Every's Proof editor, iterate with the agent via comments, or copy a link to share with others
 - **Done** → the conversation was the value, no artifact needed