@pi-unipi/unipi 2.0.6 → 2.0.7

package/packages/ralph/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: ralph
+description: >
+  Long-running iterative development loops. Run arbitrarily-long tasks without
+  diluting model attention. Triggers: ralph, ralph loop, iterative loop,
+  long-running task, development loop.
+---
+
+# Ralph Loop
+
+Long-running iterative development loops. Run complex tasks across multiple iterations with reflection checkpoints.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `/unipi:ralph start <name> [options]` | Start a new loop |
+| `/unipi:ralph stop` | Pause current loop |
+| `/unipi:ralph resume <name>` | Resume a paused loop |
+| `/unipi:ralph status` | Show all loops |
+| `/unipi:ralph cancel <name>` | Delete loop state |
+| `/unipi:ralph archive <name>` | Move loop to archive |
+| `/unipi:ralph clean [--all]` | Clean completed loops |
+| `/unipi:ralph list --archived` | Show archived loops |
+| `/unipi:ralph nuke [--yes]` | Delete all ralph data |
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `ralph_start` | Start a ralph loop (LLM-callable) |
+| `ralph_done` | Signal iteration complete, request next |
+
+## Options
+
+- `--max-iterations N` — Stop after N iterations (default: 50)
+- `--items-per-iteration N` — Process N items per iteration
+- `--reflect-every N` — Reflection checkpoint every N iterations
+
+## How It Works
+
+1. **Start** — Create a task file with goals and checklist
+2. **Iterate** — LLM works on task, updates checklist, calls `ralph_done`
+3. **Reflect** — Every N iterations, pause and assess progress
+4. **Complete** — When done, LLM outputs `COMPLETE` marker
+
+## Integration with Workflow
+
+When `@unipi/workflow` is present:
+- `/unipi:work` suggests ralph for large tasks
+- Ralph loops emit events that workflow can track
+- Ralph state is available to info-screen (when present)
+
+## Task File Format
+
+```markdown
+# Task
+
+{Description}
+
+## Goals
+- Goal 1
+- Goal 2
+
+## Checklist
+- [ ] Item 1
+- [ ] Item 2
+- [x] Completed item
+
+## Notes
+{Progress notes}
+```
+
+## State
+
+Loop state stored in `.unipi/ralph/` directory:
+- `.unipi/ralph/{name}.md` — Task file
+- `.unipi/ralph/{name}.state.json` — Loop state
+- `.unipi/ralph/archive/` — Completed loops
+
+## Tips
+
+- Use `--items-per-iteration` for large checklists
+- Use `--reflect-every 10` for long-running tasks
+- Press ESC to pause, send message to resume
+- Task file is updated each iteration — check it for progress

package/packages/ralph/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@pi-unipi/ralph",
+  "version": "2.0.7",
+  "description": "Long-running iterative development loops for Pi coding agent",
+  "type": "module",
+  "license": "MIT",
+  "author": "Neuron Mr White",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Neuron-Mr-White/unipi.git",
+    "directory": "packages/ralph"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "unipi",
+    "ralph",
+    "loops"
+  ],
+  "files": [
+    "*.ts",
+    "SKILL.md",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "skills": [
+      "./SKILL.md"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pi-unipi/core": "^2.0.0",
+    "@pi-unipi/info-screen": "*"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-ai": "*",
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*",
+    "@sinclair/typebox": "*"
+  }
+}

package/packages/subagents/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@pi-unipi/subagents",
+  "version": "2.0.7",
+  "description": "Subagents for UniPi — parallel execution, file locking, workflow integration",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node --test src/__tests__/*.test.ts"
+  },
+  "dependencies": {
+    "@pi-unipi/core": "*",
+    "@pi-unipi/workflow": "*",
+    "@pi-unipi/info-screen": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*",
+    "@sinclair/typebox": "*"
+  }
+}

package/packages/updater/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@pi-unipi/updater",
+  "version": "2.0.7",
+  "description": "Auto-updater, changelog browser, and readme browser for Unipi — checks npm registry, renders CHANGELOG.md and README.md files in TUI overlays",
+  "type": "module",
+  "license": "MIT",
+  "author": "Neuron Mr White",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Neuron-Mr-White/unipi.git",
+    "directory": "packages/updater"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi-coding-agent",
+    "unipi",
+    "updater",
+    "changelog",
+    "readme"
+  ],
+  "files": [
+    "index.ts",
+    "src/**/*.ts",
+    "skills/**/*",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "src/index.ts"
+    ],
+    "skills": [
+      "skills"
+    ]
+  },
+  "scripts": {
+    "test": "node --experimental-strip-types --test tests/**/*.test.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pi-unipi/core": "*"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.0"
+  }
+}

package/packages/utility/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@pi-unipi/utility",
+  "version": "2.0.7",
+  "description": "Utility commands and tools for Pi coding agent — lifecycle, diagnostics, cache, analytics, display, batch execution",
+  "type": "module",
+  "license": "MIT",
+  "author": "Neuron Mr White",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Neuron-Mr-White/unipi.git",
+    "directory": "packages/utility"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi-coding-agent",
+    "unipi",
+    "utility",
+    "continue",
+    "diagnostics",
+    "cache",
+    "analytics"
+  ],
+  "files": [
+    "src/index.ts",
+    "src/commands.ts",
+    "src/types.ts",
+    "src/**/*.ts",
+    "README.md",
+    "skills/**/*.md"
+  ],
+  "pi": {
+    "extensions": [
+      "src/index.ts"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pi-unipi/core": "*",
+    "diff": "^7.0.0",
+    "@shikijs/cli": "^4.0.2"
+  },
+  "devDependencies": {
+    "@types/diff": "^7.0.2"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "@sinclair/typebox": "*"
+  },
+  "scripts": {
+    "test": "npx tsx --test tests/**/*.test.ts"
+  }
+}

package/packages/web-api/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@pi-unipi/web-api",
+  "version": "2.0.7",
+  "description": "Web search, read, and summarize tools with provider-based backend selection for Pi coding agent",
+  "type": "module",
+  "license": "MIT",
+  "author": "Neuron Mr White",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Neuron-Mr-White/unipi.git",
+    "directory": "packages/web-api"
+  },
+  "homepage": "https://github.com/Neuron-Mr-White/unipi#readme",
+  "bugs": {
+    "url": "https://github.com/Neuron-Mr-White/unipi/issues"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi-coding-agent",
+    "unipi",
+    "web-api",
+    "search",
+    "read",
+    "summarize"
+  ],
+  "pi": {
+    "extensions": [
+      "src/index.ts"
+    ],
+    "skills": [
+      "skills"
+    ]
+  },
+  "files": [
+    "src/**/*.ts",
+    "skills/**/*",
+    "README.md"
+  ],
+  "dependencies": {
+    "@pi-unipi/core": "*",
+    "defuddle": "^0.18.1",
+    "linkedom": "^0.18.12",
+    "lodash": "^4.17.21",
+    "mime-types": "^2.1.35",
+    "wreq-js": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*",
+    "@sinclair/typebox": "*"
+  },
+  "devDependencies": {
+    "@types/lodash": "^4.17.24",
+    "@types/node": "^25.6.0"
+  }
+}

package/packages/workflow/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@pi-unipi/workflow",
+  "version": "2.0.7",
+  "description": "Structured development workflow commands for Pi coding agent",
+  "type": "module",
+  "license": "MIT",
+  "author": "Neuron Mr White",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Neuron-Mr-White/unipi.git",
+    "directory": "packages/workflow"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "unipi",
+    "workflow"
+  ],
+  "files": [
+    "*.ts",
+    "skills/**/*",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "skills": [
+      "./skills"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pi-unipi/core": "^2.0.0"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-ai": "*",
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*",
+    "@sinclair/typebox": "*"
+  }
+}