@pi-unipi/unipi 0.1.6 → 0.1.11

package/README.md

@@ -19,6 +19,13 @@ pi install npm:@pi-unipi/info-screen
 pi install npm:@pi-unipi/subagents
 pi install npm:@pi-unipi/btw
 pi install npm:@pi-unipi/web-api
+pi install npm:@pi-unipi/compactor
+pi install npm:@pi-unipi/notify
+pi install npm:@pi-unipi/utility
+pi install npm:@pi-unipi/mcp
+pi install npm:@pi-unipi/ask-user
+pi install npm:@pi-unipi/milestone
+pi install npm:@pi-unipi/kanboard
 ```
 
 ## Packages
@@ -26,13 +33,20 @@ pi install npm:@pi-unipi/web-api
 | Package | Description |
 |---------|-------------|
 | `@pi-unipi/core` | Shared utilities, event types, constants |
-| `@pi-unipi/workflow` | 13 structured development workflow commands |
+| `@pi-unipi/workflow` | 20 structured development workflow commands |
 | `@pi-unipi/ralph` | Long-running iterative development loops |
 | `@pi-unipi/memory` | Persistent cross-session memory with vector search |
 | `@pi-unipi/info-screen` | Dashboard and module registry overlay |
 | `@pi-unipi/subagents` | Parallel sub-agent execution with file locking |
 | `@pi-unipi/btw` | Parallel side conversations with `/btw` |
 | `@pi-unipi/web-api` | Web search, read, and summarize with provider selection |
+| `@pi-unipi/compactor` | Session compaction, context management, batch execution |
+| `@pi-unipi/notify` | Cross-platform notifications (native, Gotify, Telegram) |
+| `@pi-unipi/utility` | Environment info, diagnostics, settings inspector, cleanup |
+| `@pi-unipi/mcp` | MCP server discovery, connection, and tool integration |
+| `@pi-unipi/ask-user` | Structured user input with options and freeform text |
+| `@pi-unipi/milestone` | Milestone tracking and project progress management |
+| `@pi-unipi/kanboard` | Kanboard visualization server with TUI overlay |
 
 ## Commands
 
@@ -45,6 +59,7 @@ pi install npm:@pi-unipi/web-api
 | `/unipi:work` | Execute plan in worktree |
 | `/unipi:review-work` | Review what was built |
 | `/unipi:consolidate` | Merge findings, update docs |
+| `/unipi:auto` | Full pipeline — brainstorm → plan → work → review → merge |
 | `/unipi:worktree-create` | Create git worktree |
 | `/unipi:worktree-list` | List all worktrees |
 | `/unipi:worktree-merge` | Merge worktree back |
@@ -53,6 +68,12 @@ pi install npm:@pi-unipi/web-api
 | `/unipi:gather-context` | Research codebase |
 | `/unipi:document` | Generate documentation |
 | `/unipi:scan-issues` | Find bugs, anti-patterns |
+| `/unipi:debug` | Active bug investigation — reproduce, diagnose, root-cause |
+| `/unipi:fix` | Fix bugs using debug reports |
+| `/unipi:quick-fix` | Fast one-shot fix for clear bugs |
+| `/unipi:research` | Deep codebase investigation and documentation review |
+| `/unipi:chore-create` | Create reusable chore (deploy, publish, etc.) |
+| `/unipi:chore-execute` | Run a saved chore |
 
 ### Ralph (`/unipi:ralph`)
 
@@ -103,6 +124,52 @@ pi install npm:@pi-unipi/web-api
 | `/unipi:web-settings` | Configure providers and API keys |
 | `/unipi:web-cache-clear` | Clear all cached web content |
 
+### Compactor (`/unipi:compact*`)
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:compact` | Compact session into brief |
+| `/unipi:compact-recall` | Recall from compacted sessions |
+| `/unipi:compact-stats` | Show compaction statistics |
+| `/unipi:compact-doctor` | Diagnose compactor issues |
+| `/unipi:compact-settings` | Configure compactor |
+| `/unipi:compact-preset` | Apply compaction presets |
+| `/unipi:compact-index` | Index context for search |
+| `/unipi:compact-search` | Search indexed context |
+| `/unipi:compact-purge` | Purge old compacted data |
+
+### Notify (`/unipi:notify-*`)
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:notify-settings` | Configure notification platforms |
+| `/unipi:notify-set-gotify` | Set Gotify server config |
+| `/unipi:notify-set-tg` | Set Telegram bot config |
+| `/unipi:notify-test` | Test notification delivery |
+
+### Utility (`/unipi:*`)
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:env` | Show environment info |
+| `/unipi:doctor` | Run diagnostics |
+| `/unipi:status` | Show module status |
+| `/unipi:cleanup` | Clean stale temp files |
+| `/unipi:reload` | Reload extensions |
+| `/unipi:name-badge` | Toggle session name badge overlay |
+| `/unipi:badge-gen` | Generate session name via background agent |
+| `/unipi:badge-toggle` | Configure badge settings |
+
+### MCP (`/unipi:mcp-*`)
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:mcp-add` | Add MCP server |
+| `/unipi:mcp-settings` | Configure MCP servers |
+| `/unipi:mcp-sync` | Sync MCP tools |
+| `/unipi:mcp-status` | Show MCP connection status |
+| `/unipi:mcp-reload` | Reload MCP connections |
+
 ### Tools
 
 | Tool | Package | Description |
@@ -120,12 +187,41 @@ pi install npm:@pi-unipi/web-api
 | `web_search` | web-api | Search the web via provider |
 | `web_read` | web-api | Extract content from URL |
 | `web_llm_summarize` | web-api | Summarize web content via LLM |
+| `notify_user` | notify | Send cross-platform notifications |
+| `ask_user` | ask-user | Structured user input with options |
+| `compact` | compactor | Compact session context |
+| `vcc_recall` | compactor | Recall from compacted sessions |
+| `ctx_execute` | compactor | Execute with context management |
+| `ctx_batch_execute` | compactor | Batch execute with rollback |
+| `ctx_index` | compactor | Index context for search |
+| `ctx_search` | compactor | Search indexed context |
+| `ctx_fetch_and_index` | compactor | Fetch and index web content |
+| `ctx_stats` | compactor | Show compaction statistics |
+| `ctx_doctor` | compactor | Diagnose compactor issues |
+| `set_session_name` | utility | Set session name for badge display |
+| `ctx_batch` | utility | Atomic batch execution with rollback |
+| `ctx_env` | utility | Show environment information |
+
+### Milestone (`/unipi:milestone-*`)
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:milestone-onboard` | Create MILESTONES.md from existing workflow docs |
+| `/unipi:milestone-update` | Sync MILESTONES.md with completed work |
+
+### Kanboard (`/unipi:kanboard*`)
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:kanboard` | Toggle kanboard visualization server |
+| `/unipi:kanboard-doctor` | Diagnose and fix kanboard parser issues |
+| `/unipi:name-gen` | Generate session name badge via background agent |
 
 ## How It Works
 
 **Core** provides shared infrastructure — event types, constants, utilities — so modules discover each other without tight coupling.
 
-**Workflow** provides 13 commands guiding work from idea to completion via brainstorm → plan → work → review → consolidate.
+**Workflow** provides 20 commands guiding work from idea to completion: brainstorm → plan → work → review → consolidate, plus quick-fix, debug, research, chore, and more.
 
 **Ralph** enables long-running iterative tasks. Start a loop, the agent works through iterations, reflects periodically, and completes when done.
 
@@ -139,6 +235,20 @@ pi install npm:@pi-unipi/web-api
 
 **Web API** provides web search, page reading, and LLM summarization through a ranked provider system. DuckDuckGo and Jina work out of the box; paid providers (SerpAPI, Tavily, Firecrawl, Perplexity) are configured via `/unipi:web-settings`.
 
+**Compactor** manages session context with compaction, indexing, search, and batch execution. Keep context lean without losing important information.
+
+**Notify** sends notifications across platforms — native OS, Gotify, and Telegram. Configure once, get alerts everywhere.
+
+**Utility** provides environment info, diagnostics, settings inspection, and cleanup tools for maintaining your development environment.
+
+**MCP** integrates Model Context Protocol servers — discover, connect, and use external tool servers seamlessly.
+
+**Ask User** provides structured user input with multiple-choice, multi-select, and freeform text options.
+
+**Milestone** tracks project progress with MILESTONES.md — onboards existing work and syncs with completed tasks.
+
+**Kanboard** provides a visualization server with htmx + Alpine.js UI for kanban boards, workflow timelines, and milestone progress. Includes a TUI overlay for quick access.
+
 ## Module Discovery
 
 Modules announce presence via `pi.events`. When `@pi-unipi/workflow` detects `@pi-unipi/ralph`, it enables loop integration. Each module works standalone.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "0.1.6",
+  "version": "0.1.11",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -42,13 +42,28 @@
       "node_modules/@pi-unipi/info-screen/index.ts",
       "node_modules/@pi-unipi/subagents/src/index.ts",
       "node_modules/@pi-unipi/btw/extensions/btw.ts",
-      "node_modules/@pi-unipi/web-api/src/index.ts"
+      "node_modules/@pi-unipi/web-api/src/index.ts",
+      "node_modules/@pi-unipi/utility/src/index.ts",
+      "node_modules/@pi-unipi/ask-user/index.ts",
+      "node_modules/@pi-unipi/mcp/src/index.ts",
+      "node_modules/@pi-unipi/compactor/src/index.ts",
+      "node_modules/@pi-unipi/notify/index.ts",
+      "node_modules/@pi-unipi/milestone/index.ts",
+      "node_modules/@pi-unipi/kanboard/index.ts",
+      "node_modules/@pi-unipi/command-enchantment/src/index.ts"
     ],
     "skills": [
       "node_modules/@pi-unipi/workflow/skills",
       "node_modules/@pi-unipi/ralph/SKILL.md",
       "node_modules/@pi-unipi/memory/skills",
-      "node_modules/@pi-unipi/btw/skills"
+      "node_modules/@pi-unipi/btw/skills",
+      "node_modules/@pi-unipi/ask-user/skills",
+      "node_modules/@pi-unipi/mcp/skills",
+      "node_modules/@pi-unipi/utility/skills",
+      "node_modules/@pi-unipi/compactor/skills",
+      "node_modules/@pi-unipi/notify/skills",
+      "node_modules/@pi-unipi/milestone/skills",
+      "node_modules/@pi-unipi/kanboard/skills"
     ]
   },
   "peerDependencies": {
@@ -58,17 +73,26 @@
     "@sinclair/typebox": "*"
   },
   "dependencies": {
+    "@pi-unipi/ask-user": "*",
+    "@pi-unipi/btw": "*",
+    "@pi-unipi/compactor": "*",
+    "@pi-unipi/notify": "*",
+    "@pi-unipi/command-enchantment": "*",
     "@pi-unipi/core": "*",
-    "@pi-unipi/workflow": "*",
-    "@pi-unipi/ralph": "*",
-    "@pi-unipi/memory": "*",
     "@pi-unipi/info-screen": "*",
+    "@pi-unipi/mcp": "*",
+    "@pi-unipi/memory": "*",
+    "@pi-unipi/ralph": "*",
     "@pi-unipi/subagents": "*",
-    "@pi-unipi/btw": "*",
-    "@pi-unipi/web-api": "*"
+    "@pi-unipi/utility": "*",
+    "@pi-unipi/milestone": "*",
+    "@pi-unipi/kanboard": "*",
+    "@pi-unipi/web-api": "*",
+    "@pi-unipi/workflow": "*"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
+    "tsx": "^4.21.0",
     "typescript": "^6.0.0"
   }
 }

package/packages/ask-user/README.md

@@ -0,0 +1,99 @@
+# @pi-unipi/ask-user
+
+Structured user input tool for the Pi coding agent — part of the Unipi suite.
+
+## Features
+
+### `ask_user` Tool
+
+Ask the user a question with structured options. Supports three modes:
+
+- **Single-select** — Pick one option from a list
+- **Multi-select** — Toggle multiple options, then submit
+- **Freeform** — Type a custom answer
+
+### Usage
+
+The agent calls the tool when it needs user input:
+
+```typescript
+ask_user({
+  question: "Which database should we use?",
+  options: [
+    { label: "PostgreSQL", description: "Reliable, feature-rich" },
+    { label: "SQLite", description: "Simple, serverless" },
+  ],
+})
+```
+
+### Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `question` | string | required | The question to ask |
+| `context` | string? | — | Additional context shown before question |
+| `options` | array? | [] | Multiple-choice options |
+| `allowMultiple` | boolean? | false | Enable multi-select mode |
+| `allowFreeform` | boolean? | true | Allow freeform text input |
+| `timeout` | number? | — | Auto-dismiss after N ms |
+
+### Keyboard Controls
+
+| Mode | Keys |
+|------|------|
+| Single-select | ↑↓ navigate, Enter select, Esc cancel |
+| Multi-select | ↑↓ navigate, Space toggle, Enter submit, Esc cancel |
+| Freeform | Type text, Enter submit, Esc back |
+
+### TUI Display
+
+**Single-select:**
+```
+─────────────────────────────
+ Which approach should we use?
+─────────────────────────────
+ > Option A
+   Option B
+   Option C
+   Type something...
+
+ ↑↓ navigate • Enter select • Esc cancel
+─────────────────────────────
+```
+
+**Multi-select:**
+```
+─────────────────────────────
+ Which features to enable?
+─────────────────────────────
+ > [✓] Logging
+   [ ] Metrics
+   [✓] Tracing
+   [ ] Type something...
+
+ ↑↓ navigate • Space toggle • Enter submit • Esc cancel
+─────────────────────────────
+```
+
+## Installation
+
+```bash
+pi install npm:@pi-unipi/ask-user
+```
+
+Or install the full Unipi suite:
+
+```bash
+pi install npm:@pi-unipi/unipi
+```
+
+## Bundled Skill
+
+The package includes a skill that guides the agent to use `ask_user` for high-stakes decisions. The skill is automatically discovered when the extension loads.
+
+## Dependencies
+
+- `@pi-unipi/core` — Shared constants and utilities
+- `@mariozechner/pi-coding-agent` — Pi extension API
+- `@mariozechner/pi-tui` — TUI components
+- `@sinclair/typebox` — Schema validation

package/packages/ask-user/index.ts

@@ -0,0 +1,44 @@
+/**
+ * @pi-unipi/ask-user — Extension entry
+ *
+ * Provides ask_user tool for structured user input with single-select,
+ * multi-select, and freeform modes. Includes bundled skill for agent guidance.
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import {
+  UNIPI_EVENTS,
+  MODULES,
+  ASK_USER_TOOLS,
+  emitEvent,
+  getPackageVersion,
+} from "@pi-unipi/core";
+import { registerAskUserTools } from "./tools.js";
+import { registerAskUserCommands } from "./commands.js";
+
+/** Package version */
+const VERSION = getPackageVersion(new URL(".", import.meta.url).pathname);
+
+export default function (pi: ExtensionAPI) {
+  // Register skills directory
+  const skillsDir = new URL("./skills", import.meta.url).pathname;
+  pi.on("resources_discover", async () => {
+    return {
+      skillPaths: [skillsDir],
+    };
+  });
+
+  // Register tools and commands
+  registerAskUserTools(pi);
+  registerAskUserCommands(pi);
+
+  // Session lifecycle — announce module
+  pi.on("session_start", async () => {
+    emitEvent(pi, UNIPI_EVENTS.MODULE_READY, {
+      name: MODULES.ASK_USER,
+      version: VERSION,
+      commands: ["unipi:ask-user-settings"],
+      tools: [ASK_USER_TOOLS.ASK],
+    });
+  });
+}

package/packages/ask-user/skills/ask-user/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: ask-user
+description: >
+  Interactive decision-gating tool for structured user input.
+  Use ask_user when you need user confirmation, preferences, or decisions
+  before proceeding with high-impact or ambiguous choices.
+allowed-tools:
+  - ask_user
+---
+
+# Ask User
+
+Use the `ask_user` tool to collect structured input from the user.
+
+## When to use ask_user
+
+- Architectural trade-offs with high impact
+- Requirements are ambiguous or conflicting
+- Assumptions would materially change implementation
+- User preferences needed (style, approach, priority)
+- Confirming before destructive operations
+
+## Decision Handshake Flow
+
+1. Gather evidence and summarize context
+2. Ask ONE focused question via `ask_user`
+3. Wait for explicit user choice
+4. Confirm the decision, then proceed
+
+## Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `question` | string | required | The question to ask |
+| `context` | string? | — | Additional context shown before question |
+| `options` | array? | [] | Multiple-choice options with labels, descriptions, values |
+| `allowMultiple` | boolean? | false | Enable multi-select |
+| `allowFreeform` | boolean? | true | Add "Custom response" checkable option |
+| `timeout` | number? | — | Auto-dismiss after N ms |
+
+### Option Properties
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `label` | string | required | Display label |
+| `description` | string? | — | Description shown below label |
+| `value` | string? | label | Value returned when selected |
+| `allowCustom` | boolean? | false | Allow user to add custom text for this option (shorthand for `action: "input"`) |
+| `action` | string? | "select" | Special action: `"select"`, `"input"`, `"end_turn"`, `"new_session"` |
+| `prefill` | string? | — | Prefill message for `"new_session"` action |
+
+### Action Types
+
+| Action | Behavior |
+|--------|----------|
+| `"select"` | Normal selection (default). Returns immediately. |
+| `"input"` | Enters text input mode. Returns `combined` response with selection + text. |
+| `"end_turn"` | Signals end of agent turn. Returns `end_turn` response kind. |
+| `"new_session"` | Starts a new session. Returns `new_session` response kind with optional `prefill`. |
+
+## Examples
+
+Single choice:
+```
+ask_user({
+  question: "Which database should we use?",
+  options: [
+    { label: "PostgreSQL", description: "Reliable, feature-rich" },
+    { label: "SQLite", description: "Simple, serverless" }
+  ]
+})
+```
+
+Multi-select:
+```
+ask_user({
+  question: "Which features to implement?",
+  options: [
+    { label: "Auth", value: "auth" },
+    { label: "Cache", value: "cache" },
+    { label: "Logging", value: "logging" }
+  ],
+  allowMultiple: true
+})
+```
+
+With context:
+```
+ask_user({
+  question: "Which approach?",
+  context: "Current bottleneck: network I/O. Goal: reduce latency.",
+  options: [
+    { label: "Cache-first" },
+    { label: "DB-first" }
+  ]
+})
+```
+
+Freeform only:
+```
+ask_user({
+  question: "What should we name this module?",
+  options: [],
+  allowFreeform: true
+})
+```
+
+Combined (multi-select + freeform):
+```
+ask_user({
+  question: "Which features and what custom feature?",
+  options: [
+    { label: "Auth", value: "auth" },
+    { label: "Cache", value: "cache" }
+  ],
+  allowMultiple: true,
+  allowFreeform: true
+})
+```
+User can check "Auth", "Cache", and "Custom response" to type additional features.
+
+With per-option custom text:
+```
+ask_user({
+  question: "Does this look right?",
+  options: [
+    { label: "Yes", value: "yes" },
+    { label: "Partially", value: "partial", allowCustom: true },
+    { label: "No", value: "no", allowCustom: true }
+  ],
+  allowFreeform: false
+})
+```
+Selecting "Partially" or "No" enters text input so the user can explain what needs to change.
+
+With end_turn and new_session actions:
+```
+ask_user({
+  question: "How would you like to proceed?",
+  options: [
+    { label: "Looks good, proceed", value: "proceed" },
+    { label: "I want changes", value: "changes", action: "input" },
+    { label: "Done for now", value: "done", action: "end_turn" },
+    { label: "Start fresh", value: "new", action: "new_session", prefill: "Let's redesign the..." }
+  ],
+  allowFreeform: false
+})
+```
+- "Looks good" returns immediately with selection
+- "I want changes" enters text input mode for the user to explain
+- "Done for now" signals the agent to end its turn
+- "Start fresh" starts a new session with the prefill message

package/packages/autocomplete/index.ts

@@ -0,0 +1,7 @@
+/**
+ * @pi-unipi/command-enchantment — Re-export
+ *
+ * Re-exports from src/ for module resolution.
+ */
+
+export { default } from "./src/index.js";