jamminrebel/pom-omp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: initialize POM 2 repo (docs guards green; release gates recorded NOT RUN pending install)

Browse Source
This commit is contained in:
Antigravity
2026-08-19 10:31:00 +02:00
commit 7ffd00b5c5
111 changed files with 12522 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

60
docs/SETTINGS.md Normal file
View File

@@ -0,0 +1,60 @@
# Settings
## Oh My Pi host settings
Use `<project>/.omp/config.yml`. POM creates a recommended file during project bootstrap and ships the same template at `config/config.yml`.
Important host controls:
| Key | POM purpose |
|---|---|
| `theme.dark/light` | Select POM Nocturne/Parchment after `/pom theme install` |
| `statusLine.showHookStatus` | Display POM stage, gate, Hive, retry, and approval segments |
| `terminal.showImages` | Show visual references and generated images in capable terminals |
| `tools.intentTracing` | Expose semantic tool intent in the live experience |
| artifact spill settings | Keep large tool output out of the conversation surface |
| `task.batch` / concurrency | Support bounded specialist waves |
| `compaction.strategy: snapcompact` | Preserve long-running production context |
| one-at-a-time steering/follow-up | Keep autopilot continuation ordered |
## POM settings
Precedence:
```text
built-in defaults
→ ~/.omp/agent/pom.json
→ <project>/.omp/pom.json
→ persisted project state for mutable experience fields
```
| Setting | Values | Purpose |
|---|---|---|
| `autoToolProfiles` | boolean | Route OMP active tools by stage |
| `autoModelRouting` | boolean | Resolve and activate the stage model role |
| `dashboardWidget` | boolean | Enable the persistent HUD |
| `stopGuard` | boolean | Continue an active stage briefly, then force explicit blocking |
| `defaultMode` | `autopilot`, `collaborative`, `strict-autopilot` | Select prompt personality |
| `defaultView` | `cinematic`, `rich`, `compact`, `minimal` | Select terminal information density |
| `defaultMotion` | `off`, `subtle`, `full` | Select activity animation intensity |
| `defaultToolProfile` | `auto`, `creative`, `research`, `draft`, `audit`, `delivery` | Initial active-tool policy |
| `maxStudioAgents` | 1–12 | Bound a Hive task batch |
| `projectRootMode` | `child`, `cwd` | Create a child project or use the current directory |
| `destructiveProjectCommands` | `block`, `allow` | Guard recursive destructive commands |
| `gitMode` | `off`, `checkpoint`, `branch-per-stage` | Control production checkpoints |
| `hudPlacement` | `aboveEditor`, `belowEditor` | Place the production HUD |
| `showThinkingLane` | boolean | Annotate visible thinking with stage/execution lane |
`/pom settings` persists view/motion in project state and HUD/thinking options in `.omp/pom.json`.
## Compatibility and verification state
| Requirement | Window | Source |
|---|---|---|
| `@oh-my-pi/pi-coding-agent` | `>=16.4.6 <17` | `peerDependencies` |
| `@oh-my-pi/pi-tui` | `>=16.4.6 <17` | `peerDependencies` |
| `@oh-my-pi/pi-utils` | `>=16.4.6 <17` | `peerDependencies` |
| Bun | `>=1.3.14` | `engines.bun` |
| Node.js + npm | Node 22 or newer | Local scripts and the `node:test` suite |
Verification state is PARTIAL. `npm run smoke`, `npm run release:check`, and `node --import tsx --test tests/state.test.ts` pass. The full `npm run verify` gate is blocked: an npm registry outage left `node_modules` incomplete (OMP SDK peer packages, `@types/node`, `yauzl`, and the OMP theme schema that `scripts/verify.mjs` reads). Restore registry access, reinstall, then rerun the full gate. See the README sections Verification status and Registry outage and offline guidance.