@pi-unipi/workflow 0.1.8 → 0.1.9

package/README.md

@@ -4,7 +4,7 @@ Structured development workflow commands for Pi coding agent.
 
 ## Overview
 
-13 slash commands that guide work from idea to completion. Each command maps to a skill that instructs the agent on what to do.
+19 slash commands that guide work from idea to completion. Each command maps to a skill that instructs the agent on what to do.
 
 ## Commands
 
@@ -22,7 +22,13 @@ Structured development workflow commands for Pi coding agent.
 | `/unipi:quick-work` | Fast single-task execution | `<string>` |
 | `/unipi:gather-context` | Research codebase, prepare for brainstorm | `<string>` |
 | `/unipi:document` | Generate documentation | `<string>` |
-| `/unipi:scan-issues` | Find bugs, anti-patterns, security issues | `<string>` |
+| `/unipi:scan-issues` | Find bugs, anti-patterns, security issues (passive scan) | `<string>` |
+| `/unipi:debug` | Active bug investigation, root-cause analysis | `<string>` |
+| `/unipi:fix` | Fix bugs using debug reports | `debug:<path> <string>` |
+| `/unipi:quick-fix` | Fast bug fix without debug report | `<string>` |
+| `/unipi:research` | Read-only research with bash access | `<string>` |
+| `/unipi:chore-create` | Create reusable chore definition | `<string>` |
+| `/unipi:chore-execute` | Execute a saved chore | `chore:<path> <string>` |
 
 ## Workflow
 
@@ -71,10 +77,36 @@ brainstorm → plan → work → review-work → consolidate
 # Generate documentation
 /unipi:document the auth module
 
-# Find issues
+# Deep research with bash access
+/unipi:research TypeScript 5.0 migration path
+
+# Find issues (passive scan)
 /unipi:scan-issues focus on security
 ```
 
+### Bug Fixing
+
+```bash
+# Debug and fix a bug (full flow)
+/unipi:debug TypeError in auth middleware
+/unipi:fix debug:2026-04-28-auth-typeerror-debug
+
+# Quick fix for simple bugs
+/unipi:quick-fix fix null check in user validation
+```
+
+### Chores
+
+```bash
+# Create reusable chores
+/unipi:chore-create push to github main
+/unipi:chore-create publish package to npm
+
+# Execute saved chores
+/unipi:chore-execute chore:push-github-main
+/unipi:chore-execute chore:publish-npm
+```
+
 ### Worktree Management
 
 ```bash
@@ -96,9 +128,13 @@ brainstorm → plan → work → review-work → consolidate
 │   ├── specs/          ← brainstorm output (design specs)
 │   ├── plans/          ← plan output (implementation plans)
 │   ├── generated/      ← document output (docs, guides)
-│   └── reviews/        ← review remarks (in plan docs)
+│   ├── reviews/        ← review remarks (in plan docs)
+│   ├── debug/          ← debug reports
+│   ├── fix/            ← fix reports
+│   ├── quick-work/     ← quick-work summaries
+│   └── chore/          ← reusable chore definitions
 ├── memory/             ← consolidate memory
-├── quick-work/         ← quick-work summaries
+├── ralph/              ← ralph loop state
 └── worktrees/          ← git worktrees
     ├── feat/auth/
     └── fix/login-bug/
@@ -110,6 +146,12 @@ brainstorm → plan → work → review-work → consolidate
 - **@pi-unipi/memory** — memory hooks for consolidate (optional)
 - **@pi-unipi/subagents** — parallel research for gather-context, scan-issues (optional)
 - **@pi-unipi/ralph** — loop integration for long-running tasks (optional)
+- **@pi-unipi/ask-user** — structured user input for all skills (optional)
+- **@pi-unipi/mcp** — MCP server tools for all skills (optional)
+- **@pi-unipi/web-api** — web research for research-type skills (optional)
+- **@pi-unipi/compactor** — compactor tools for main agent (optional)
+
+See [docs/coexist-triggers.md](docs/coexist-triggers.md) for detailed integration behavior.
 
 ## Installation
 

package/commands.ts

@@ -83,22 +83,100 @@ function suggestPlanFiles(prefix: string): { value: string; label: string; descr
   }
 }
 
+/**
+ * Suggest debug files from .unipi/docs/debug/ for fix command.
+ */
+function suggestDebugFiles(prefix: string): { value: string; label: string; description: string }[] {
+  const debugDir = join(process.cwd(), ".unipi", "docs", "debug");
+  if (!existsSync(debugDir)) return [];
+
+  try {
+    const search = prefix?.trim().split(/\s+/).pop() ?? "";
+    const files = readdirSync(debugDir)
+      .filter((f) => f.endsWith(".md"))
+      .map((f) => ({ name: f, time: statSync(join(debugDir, f)).mtimeMs }))
+      .sort((a, b) => b.time - a.time);
+    return files
+      .filter((f) => !search || f.name.includes(search))
+      .map((f) => ({
+        value: `debug:${f.name}`,
+        label: basename(f.name, ".md"),
+        description: `Debug: ${f.name}`,
+      }));
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Suggest chore files from .unipi/docs/chore/ for chore-execute command.
+ */
+function suggestChoreFiles(prefix: string): { value: string; label: string; description: string }[] {
+  const choreDir = join(process.cwd(), ".unipi", "docs", "chore");
+  if (!existsSync(choreDir)) return [];
+
+  try {
+    const search = prefix?.trim().split(/\s+/).pop() ?? "";
+    const files = readdirSync(choreDir)
+      .filter((f) => f.endsWith(".md"))
+      .map((f) => ({ name: f, time: statSync(join(choreDir, f)).mtimeMs }))
+      .sort((a, b) => b.time - a.time);
+    return files
+      .filter((f) => !search || f.name.includes(search))
+      .map((f) => ({
+        value: `chore:${f.name}`,
+        label: basename(f.name, ".md"),
+        description: `Chore: ${f.name}`,
+      }));
+  } catch {
+    return [];
+  }
+}
+
 /**
  * Suggest existing worktree names for merge/list commands.
+ * Recursively scans for actual git worktrees (directories containing .git files).
  */
 function suggestWorktrees(): { value: string; label: string; description: string }[] {
   const worktreesDir = join(process.cwd(), ".unipi", "worktrees");
   if (!existsSync(worktreesDir)) return [];
 
   try {
-    const dirs = readdirSync(worktreesDir, { withFileTypes: true })
-      .filter((d) => d.isDirectory())
-      .map((d) => d.name);
-    return dirs.map((d) => ({
-      value: d,
-      label: d,
-      description: `Worktree: ${d}`,
-    }));
+    const results: { value: string; label: string; description: string }[] = [];
+
+    /**
+     * Recursively find worktree directories (those containing a .git file).
+     * A worktree's .git file contains: gitdir: /path/to/.git/worktrees/<branch>
+     */
+    function findWorktrees(dir: string, relativePath: string): void {
+      const entries = readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        const relPath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+
+        if (entry.name === ".git" && entry.isFile()) {
+          // This is a worktree — extract branch name from gitdir path
+          try {
+            const gitContent = readFileSync(fullPath, "utf-8").trim();
+            const match = gitContent.match(/gitdir:\s+.+?\/([^/]+)$/);
+            const branchName = match?.[1] ?? entry.name;
+            results.push({
+              value: branchName,
+              label: branchName,
+              description: `Worktree: ${relPath}`,
+            });
+          } catch {
+            // Can't read .git file — skip
+          }
+        } else if (entry.isDirectory() && entry.name !== "node_modules" && entry.name !== ".git") {
+          // Recurse into subdirectories (but not into nested .git or node_modules)
+          findWorktrees(fullPath, relPath);
+        }
+      }
+    }
+
+    findWorktrees(worktreesDir, "");
+    return results;
   } catch {
     return [];
   }
@@ -199,6 +277,48 @@ const COMMANDS: WorkflowCommand[] = [
     skillName: "auto",
     argumentHint: "<description> plan:<file> specs:<file>",
   },
+  {
+    name: WORKFLOW_COMMANDS.DEBUG,
+    description:
+      "Active bug investigation — reproduce, diagnose, root-cause analysis",
+    skillName: "debug",
+    argumentHint: "<bug description or error>",
+  },
+  {
+    name: WORKFLOW_COMMANDS.FIX,
+    description:
+      "Fix bugs using debug reports — autocomplete for debug files",
+    skillName: "fix",
+    argumentHint: "debug:<file> <scope>",
+  },
+  {
+    name: WORKFLOW_COMMANDS.QUICK_FIX,
+    description:
+      "Fast bug fix without debug report — one shot",
+    skillName: "quick-fix",
+    argumentHint: "<bug description>",
+  },
+  {
+    name: WORKFLOW_COMMANDS.RESEARCH,
+    description:
+      "Read-only research with bash access — deep codebase investigation",
+    skillName: "research",
+    argumentHint: "<topic or question>",
+  },
+  {
+    name: WORKFLOW_COMMANDS.CHORE_CREATE,
+    description:
+      "Create reusable chore definition for repeatable tasks",
+    skillName: "chore-create",
+    argumentHint: "<chore description>",
+  },
+  {
+    name: WORKFLOW_COMMANDS.CHORE_EXECUTE,
+    description:
+      "Execute a saved chore — deploy, publish, push, etc.",
+    skillName: "chore-execute",
+    argumentHint: "chore:<file> <overrides>",
+  },
 ];
 
 /**
@@ -246,6 +366,16 @@ export function registerWorkflowCommands(
           items = suggestPlanFiles(prefix);
         }
 
+        // Fix command: suggest debug files
+        if (cmd.name === WORKFLOW_COMMANDS.FIX) {
+          items = suggestDebugFiles(prefix);
+        }
+
+        // Chore-execute command: suggest chore files
+        if (cmd.name === WORKFLOW_COMMANDS.CHORE_EXECUTE) {
+          items = suggestChoreFiles(prefix);
+        }
+
         // Defensive: filter out any items with non-string value
         if (items) {
           return items.filter((item) => typeof item.value === "string");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/workflow",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Structured development workflow commands for Pi coding agent",
   "type": "module",
   "license": "MIT",