opencode-planpilot 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-planpilot",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Planpilot plugin for OpenCode",
   "type": "module",
   "repository": {

package/src/command.ts

@@ -13,6 +13,7 @@ import {
 import { AppError, invalidInput } from "./lib/errors"
 import { ensureNonEmpty, projectMatchesPath, resolveMaybeRealpath } from "./lib/util"
 import { formatGoalDetail, formatPlanDetail, formatPlanMarkdown, formatStepDetail } from "./lib/format"
+import { PLANPILOT_HELP_TEXT } from "./prompt"
 
 const DEFAULT_PAGE = 1
 const DEFAULT_LIMIT = 20
@@ -72,6 +73,14 @@ export async function runCommand(argv: string[], context: CommandContext, io: Co
     let shouldSync = false
 
     switch (section) {
+      case "help": {
+        if (subcommand !== undefined || args.length) {
+          const rest = [subcommand, ...args].filter((x) => x !== undefined)
+          throw invalidInput(`help unexpected argument: ${rest.join(" ")}`)
+        }
+        log(PLANPILOT_HELP_TEXT)
+        return
+      }
       case "plan": {
         const result = await handlePlan(app, subcommand, args, { cwd: context.cwd })
         planIds = result.planIds
@@ -234,6 +243,11 @@ function handlePlanAddTree(app: PlanpilotApp, args: string[]): number[] {
   log(`Created plan ID: ${result.plan.id}: ${result.plan.title} (steps: ${result.stepCount}, goals: ${result.goalCount})`)
   app.setActivePlan(result.plan.id, false)
   log(`Active plan set to ${result.plan.id}: ${result.plan.title}`)
+
+  // Print full detail so the AI can reference plan/step/goal IDs immediately.
+  const detail = app.getPlanDetail(result.plan.id)
+  log("")
+  log(formatPlanDetail(detail.plan, detail.steps, detail.goals))
   return [result.plan.id]
 }
 
@@ -1464,4 +1478,3 @@ function syncPlanMarkdown(app: PlanpilotApp, planIds: number[]) {
     fs.writeFileSync(mdPath, markdown, "utf8")
   })
 }
-

package/src/index.ts

@@ -5,56 +5,7 @@ import { openDatabase } from "./lib/db"
 import { invalidInput } from "./lib/errors"
 import { formatStepDetail } from "./lib/format"
 import { parseWaitFromComment } from "./lib/util"
-
-const PLANPILOT_TOOL_DESCRIPTION = [
-  "Planpilot planner for plan workflows.",
-  "Hints: 1. Model is plan/step/goal with ai/human executors and status auto-propagation upward (goals -> steps -> plan). 2. Keep comments short and decision-focused. 3. Add human steps only when AI cannot act. 4. Use `step wait` when ending a reply while waiting on external tasks.",
-  "",
-  "Usage:",
-  "- argv is tokenized: [section, subcommand, ...args]",
-  "- section: plan | step | goal",
-  "",
-  "Plan commands:",
-  "- plan add <title> <content>",
-  "- plan add-tree <title> <content> --step <content> [--executor ai|human] [--goal <content>]... [--step ...]...",
-  "- plan list [--scope project|all] [--status todo|done|all] [--limit N] [--page N] [--order id|title|created|updated] [--desc]",
-  "- plan count [--scope project|all] [--status todo|done|all]",
-  "- plan search --search <term> [--search <term> ...] [--search-mode any|all] [--search-field plan|title|content|comment|steps|goals|all] [--match-case] [--scope project|all] [--status todo|done|all] [--limit N] [--page N] [--order id|title|created|updated] [--desc]",
-  "- plan show <id>",
-  "- plan export <id> <path>",
-  "- plan comment <id> <comment> [<id> <comment> ...]",
-  "- plan update <id> [--title <title>] [--content <content>] [--status todo|done] [--comment <comment>]",
-  "- plan done <id>",
-  "- plan remove <id>",
-  "- plan activate <id> [--force]",
-  "- plan show-active",
-  "- plan deactivate",
-  "",
-  "Step commands:",
-  "- step add <plan_id> <content...> [--executor ai|human] [--at <pos>]",
-  "- step add-tree <plan_id> <content> [--executor ai|human] [--goal <content> ...]",
-  "- step list <plan_id> [--status todo|done|all] [--executor ai|human] [--limit N] [--page N]",
-  "- step count <plan_id> [--status todo|done|all] [--executor ai|human]",
-  "- step show <id>",
-  "- step show-next",
-  "- step wait <id> --delay <ms> [--reason <text>]",
-  "- step wait <id> --clear",
-  "- step comment <id> <comment> [<id> <comment> ...]",
-  "- step update <id> [--content <content>] [--status todo|done] [--executor ai|human] [--comment <comment>]",
-  "- step done <id> [--all-goals]",
-  "- step move <id> --to <pos>",
-  "- step remove <id...>",
-  "",
-  "Goal commands:",
-  "- goal add <step_id> <content...>",
-  "- goal list <step_id> [--status todo|done|all] [--limit N] [--page N]",
-  "- goal count <step_id> [--status todo|done|all]",
-  "- goal show <id>",
-  "- goal comment <id> <comment> [<id> <comment> ...]",
-  "- goal update <id> [--content <content>] [--status todo|done] [--comment <comment>]",
-  "- goal done <id...>",
-  "- goal remove <id...>",
-].join("\n")
+import { PLANPILOT_SYSTEM_INJECTION, PLANPILOT_TOOL_DESCRIPTION, formatPlanpilotAutoContinueMessage } from "./prompt"
 
 export const PlanpilotPlugin: Plugin = async (ctx) => {
   const inFlight = new Set<string>()
@@ -221,12 +172,10 @@ export const PlanpilotPlugin: Plugin = async (ctx) => {
       if (autoContext?.aborted || autoContext?.ready === false) return
 
       const timestamp = new Date().toISOString()
-      const message = `Planpilot plugin auto message @ ${timestamp}
-Hints:
-- If the next step needs human action, insert a human step before it.
-- If you need to wait for something to finish, use the step wait subcommand.
-Next step details:
-${detail.trimEnd()}`
+      const message = formatPlanpilotAutoContinueMessage({
+        timestamp,
+        stepDetail: detail,
+      })
 
       const promptBody: any = {
         agent: autoContext?.agent ?? undefined,
@@ -249,6 +198,9 @@ ${detail.trimEnd()}`
   }
 
   return {
+    "experimental.chat.system.transform": async (_input, output) => {
+      output.system.push(PLANPILOT_SYSTEM_INJECTION)
+    },
     tool: {
       planpilot: tool({
         description: PLANPILOT_TOOL_DESCRIPTION,
@@ -285,9 +237,12 @@ ${detail.trimEnd()}`
         },
       }),
     },
-    "experimental.session.compacting": async ({ sessionID }) => {
+    "experimental.session.compacting": async ({ sessionID }, output) => {
       skipNextAuto.add(sessionID)
       lastIdleAt.set(sessionID, Date.now())
+
+      // Compaction runs with tools disabled; inject Planpilot guidance into the continuation summary.
+      output.context.push(PLANPILOT_TOOL_DESCRIPTION)
     },
     event: async ({ event }) => {
       if (event.type === "session.idle") {
@@ -310,4 +265,3 @@ function containsForbiddenFlags(argv: string[]): boolean {
     return false
   })
 }
-

package/src/prompt.ts

@@ -0,0 +1,104 @@
+export const PLANPILOT_HELP_TEXT = [
+  "Planpilot - Plan/Step/Goal auto-continue workflow.",
+  "",
+  "Model:",
+  "- plan -> step -> goal",
+  "- step.executor: ai | human",
+  "- status rolls up: goals -> steps -> plan",
+  "",
+  "Rules (important):",
+  "- Prefer assigning steps to ai. Use human steps only for actions that require human approval/credentials",
+  "  or elevated permissions / destructive operations (e.g. GitHub web UI, sudo, deleting data/files).",
+  "- One step = one executor. Do NOT mix ai/human work within the same step.",
+  "  If a person must do something, create a separate human step.",
+  "- Keep statuses up to date. Mark goals/steps done as soon as they are completed so roll-up and auto-continue stay correct.",
+  "- `step wait` is ONLY for asynchronous, non-blocking external work that is already in progress",
+  "  (build/test/job/CI/network/remote service).",
+  "  If you can run something now, do it instead of waiting.",
+  "  Do NOT use `step wait` to wait for human action.",
+  "- Keep comments short and decision-focused.",
+  "",
+  "Status propagation:",
+  "- Step with goals: done iff ALL goals are done; else todo.",
+  "- Plan with steps: done iff ALL steps are done; else todo.",
+  "- Step with 0 goals: manual status (`step update` / `step done`).",
+  "- Plan with 0 steps: manual status (`plan update` / `plan done`).",
+  "- When a plan becomes done, it is removed from active plan.",
+  "",
+  "Auto-continue:",
+  "- When the session is idle and an active plan exists:",
+  "  - if next pending step.executor is ai: Planpilot auto-sends the next step + goals.",
+  "  - if next pending step.executor is human: no auto-continue.",
+  "- Pause while waiting on external systems: `step wait`.",
+  "- Stop auto-continue:",
+  "  - `plan deactivate`, OR",
+  "  - insert a human step BEFORE the next pending ai step (so the next executor becomes human).",
+  "",
+  "Invocation:",
+  "- argv is tokenized: [section, subcommand, ...args]",
+  "- section: help | plan | step | goal",
+  "",
+  "Commands:",
+  "- help",
+  "",
+  "Plan:",
+  "- plan add <title> <content>",
+  "- plan add-tree <title> <content> --step <content> [--executor ai|human] [--goal <content>]... [--step ...]...",
+  "- plan list [--scope project|all] [--status todo|done|all] [--limit N] [--page N] [--order id|title|created|updated] [--desc]",
+  "- plan count [--scope project|all] [--status todo|done|all]",
+  "- plan search --search <term> [--search <term> ...] [--search-mode any|all] [--search-field plan|title|content|comment|steps|goals|all] [--match-case] [--scope project|all] [--status todo|done|all] [--limit N] [--page N] [--order id|title|created|updated] [--desc]",
+  "- plan show <id>",
+  "- plan export <id> <path>",
+  "- plan comment <id> <comment> [<id> <comment> ...]",
+  "- plan update <id> [--title <title>] [--content <content>] [--status todo|done] [--comment <comment>]",
+  "- plan done <id>",
+  "- plan remove <id>",
+  "- plan activate <id> [--force]",
+  "- plan show-active",
+  "- plan deactivate",
+  "",
+  "Step:",
+  "- step add <plan_id> <content...> [--executor ai|human] [--at <pos>]",
+  "- step add-tree <plan_id> <content> [--executor ai|human] [--goal <content> ...]",
+  "- step list <plan_id> [--status todo|done|all] [--executor ai|human] [--limit N] [--page N]",
+  "- step count <plan_id> [--status todo|done|all] [--executor ai|human]",
+  "- step show <id>",
+  "- step show-next",
+  "- step wait <id> --delay <ms> [--reason <text>]",
+  "- step wait <id> --clear",
+  "- step comment <id> <comment> [<id> <comment> ...]",
+  "- step update <id> [--content <content>] [--status todo|done] [--executor ai|human] [--comment <comment>]",
+  "- step done <id> [--all-goals]",
+  "- step move <id> --to <pos>",
+  "- step remove <id...>",
+  "",
+  "Goal:",
+  "- goal add <step_id> <content...>",
+  "- goal list <step_id> [--status todo|done|all] [--limit N] [--page N]",
+  "- goal count <step_id> [--status todo|done|all]",
+  "- goal show <id>",
+  "- goal comment <id> <comment> [<id> <comment> ...]",
+  "- goal update <id> [--content <content>] [--status todo|done] [--comment <comment>]",
+  "- goal done <id...>",
+  "- goal remove <id...>",
+].join("\n")
+
+export const PLANPILOT_TOOL_DESCRIPTION = [
+  "Planpilot planner for auto-continue plan workflows.",
+  "For multi-step and complex tasks, use Planpilot to structure work into plans/steps/goals.",
+  "Run `planpilot help` for full usage + rules.",
+].join("\n")
+
+export const PLANPILOT_SYSTEM_INJECTION =
+  "If the task is multi-step or complex, must use the `planpilot` plan tool. For full usage + rules, run: planpilot help."
+
+export function formatPlanpilotAutoContinueMessage(input: { timestamp: string; stepDetail: string }): string {
+  const detail = (input.stepDetail ?? "").trimEnd()
+  return [
+    `Planpilot @ ${input.timestamp}`,
+    "This message was automatically sent by the Planpilot tool because the next pending step executor is ai.",
+    "For full usage + rules, run: planpilot help",
+    "Next step details:",
+    detail,
+  ].join("\n")
+}