diff --git a/omp-docs/core/index.md b/omp-docs/core/index.md index 608948a..a7d80f5 100644 --- a/omp-docs/core/index.md +++ b/omp-docs/core/index.md @@ -13,6 +13,8 @@ These files define the structural conventions that govern the agent system itsel * [AGENTS.md Format Specification](agents-md-format.md) — Canonical structure and conventions for the system-level instruction file that governs agent behavior. * [Pi Settings System](settings.md) — pi-era `settings.json` record (archive): providers, models, packages, subagent overrides. * [dankvoice](dankvoice.md) — Cloned-voice vocalization extension: `/say` and auto-speak over frank-tts, endpoint read from `agent/models.yml`. +* [OMP Status Line Customization](statusline.md) — How presets, composer shapes, and segment arrays actually interact; the fleet's tuned bar. (moved from /pi/, 2026-10-19) +* [OMP Subagent Limits & Fan-out Policy](subagent-limits.md) — Live caps: concurrency 2, no nested spawns (the `maxRecursionDepth: 0` trap), per-endpoint in-flight ceilings, isolation policy. (moved from /pi/, 2026-10-19) ## Change Tracking diff --git a/omp-docs/core/settings.md b/omp-docs/core/settings.md index ceaba6f..2fbadfa 100644 --- a/omp-docs/core/settings.md +++ b/omp-docs/core/settings.md @@ -222,7 +222,7 @@ Currently installed: | `@xynogen/pix-ls` | 0.2.1 | Directory listing | | `@xynogen/pix-edit` | 0.2.1 | File editing utilities | -See [packages](../packages/index.md) for full package documentation. +See [Pi Packages](/pi/packages/index.md) for full package documentation. --- @@ -236,5 +236,5 @@ When `lastChangelogVersion` is behind pi's internal version, pi prompts for migr - [pi](../pi/index.md) — Pi configuration overview - [[models|models]] — Provider and model definitions -- [packages](../packages/index.md) — Installed package documentation +- [Pi Packages](/pi/packages/index.md) — Installed package documentation - [[skills|skills]] — Installed skill documentation diff --git a/omp-docs/pi/statusline.md b/omp-docs/core/statusline.md similarity index 100% rename from omp-docs/pi/statusline.md rename to omp-docs/core/statusline.md diff --git a/omp-docs/pi/subagent-limits.md b/omp-docs/core/subagent-limits.md similarity index 97% rename from omp-docs/pi/subagent-limits.md rename to omp-docs/core/subagent-limits.md index e1100ff..9608367 100644 --- a/omp-docs/pi/subagent-limits.md +++ b/omp-docs/core/subagent-limits.md @@ -92,6 +92,6 @@ just the setting description. # See Also -- [/pi/statusline.md](/pi/statusline.md) — the omp-era bundle-audit page pattern this page follows +- [/core/statusline.md](/core/statusline.md) — the omp-era bundle-audit page pattern this page follows - [/pi/packages/pi-subagents.md](/pi/packages/pi-subagents.md) — retired pi-era subagent system (historical) - [/system/index.md](/system/index.md) — fleet endpoints these ceilings target diff --git a/omp-docs/index.md b/omp-docs/index.md index 40c4b9f..1830896 100644 --- a/omp-docs/index.md +++ b/omp-docs/index.md @@ -31,9 +31,11 @@ CachyOS, skills tooling — each with its verified operational facts. The legacy pi agent configuration (~/.pi era): settings, models, packages, skills. Kept for reference; the live harness is OMP under `~/.omp`. -## [OMP packages and skills](packages/index.md), [skills index](skills/index.md) +## [Skills tooling](skills/index.md) -Extensions and skills installed for the current OMP harness. +The Agent Skills standard, the `skills` CLI, this fleet's store wiring, and +the registries — for the live OMP harness. Pi-era packages are archived under +[Pi-era agent setup](pi/index.md). ## [Core config](core/index.md) diff --git a/omp-docs/log.md b/omp-docs/log.md index cf850f6..6eb267a 100644 --- a/omp-docs/log.md +++ b/omp-docs/log.md @@ -105,13 +105,13 @@ Census of `omp-docs/` against `~/Projects/serverAppConfig/serverAppConfigs-docs/ ## 2026-10-18 — Status line docs truth audit (full-source re-verification) -Exhaustive claim-by-claim re-audit of [OMP Status Line Customization](/pi/statusline.md) against the minified `dist/cli.js` bundle plus a live screenshot matrix (band × {off, percentage, embedded}, claude × off). Page carries an **Audit log** section; four first-pass claims were false and are corrected (see there): claude's rule is *not* the context meter (meter is `box`/`band` only; the "red rule" was the session-accent filler), the "Tern-only" composer-bar claim was bogus (the readout is `composer.tokenRate`, default off), `segmentOptions` are **not** gated to `preset: custom` (only the segment arrays are), and the `mode` segment's states are Plan/Prewalk/Goal/Vibe/Loop (no yolo). Page expanded with: the 7-preset defaults table, per-shape `statusAttachment`/`bottomBar` model (8 built-ins + plugin shape registry), `contextLine` per-value behavior, the 27-segment catalog with triggers/options, `segmentOptions` schema, and the full `statusLine.*`/`composer.*` knob registry. The bundle's own "(box composer only)" knob description for `contextLine` is upstream-wrong — band honors it. +Exhaustive claim-by-claim re-audit of [OMP Status Line Customization](/core/statusline.md) against the minified `dist/cli.js` bundle plus a live screenshot matrix (band × {off, percentage, embedded}, claude × off). Page carries an **Audit log** section; four first-pass claims were false and are corrected (see there): claude's rule is *not* the context meter (meter is `box`/`band` only; the "red rule" was the session-accent filler), the "Tern-only" composer-bar claim was bogus (the readout is `composer.tokenRate`, default off), `segmentOptions` are **not** gated to `preset: custom` (only the segment arrays are), and the `mode` segment's states are Plan/Prewalk/Goal/Vibe/Loop (no yolo). Page expanded with: the 7-preset defaults table, per-shape `statusAttachment`/`bottomBar` model (8 built-ins + plugin shape registry), `contextLine` per-value behavior, the 27-segment catalog with triggers/options, `segmentOptions` schema, and the full `statusLine.*`/`composer.*` knob registry. The bundle's own "(box composer only)" knob description for `contextLine` is upstream-wrong — band honors it. ServerAppConfigs-docs overlap census: flagged separately for the operator (morning report); no doc merged/changed on either side. ## 2026-10-18 — Status line rebuilt on custom segments; frank-archon display name slimmed -Interactive tune-up of the omp status bar (grilling session, live loop: config edit → watcher repaint → niri screenshot verify). New knowledge page: [OMP Status Line Customization](/pi/statusline.md). +Interactive tune-up of the omp status bar (grilling session, live loop: config edit → watcher repaint → niri screenshot verify). New knowledge page: [OMP Status Line Customization](/core/statusline.md). * **Mechanics discovered:** `leftSegments`/`rightSegments` are inert unless `preset: custom` (fleet was on `nerd` with dead arrays; `segmentOptions` *do* merge under named presets); `composer.shape` routes them — `band` merges both arrays into one row above the editor (title rides the working row), `claude` splits them into top chip + bottom strip. The context meter exists **only in `box`/`band`** — `contextLine`: `off` plain rule, `embedded` hoists the context segment into the labeled inline meter (`60% ——— × 200K`), `percentage`/`annotated` paint an unlabeled proportional rule meter (all four live-verified); every other shape's rule is a constant session-accent filler. Working row (session title + tok/s readout gated by `composer.tokenRate`, default off) is composer chrome — model/thinking can never join it. Eight composer shapes ship in the bundle; plugins can register more. * **Final bar (`band`, after a `claude` sojourn):** left = `session_name · vim · mode · hostname · path · git(no branch text) · pr`; right cluster in array order = `model · cost · time_spent` (`context_pct` hoists out of the run to paint the labeled inline meter `60% ——— × 200K` as a flexible spacer between the groups). Cut: tok/s duplicate, clock, cache trio, `context_total`, `subagents`, `session` hash, and `token_in`/`token_out` (cumulative totals live in `/session`). `path`: logical `project/worktree` label (`stripWorkPrefix: true`, kept after a live `false` trial of the full cwd); branch text dropped (worktree branches are autogenerated), dirty badges kept. diff --git a/omp-docs/packages/index.md b/omp-docs/packages/index.md deleted file mode 100644 index 17cc244..0000000 --- a/omp-docs/packages/index.md +++ /dev/null @@ -1,15 +0,0 @@ -# Pi Packages - -Self-contained extensions and tools bundled as npm packages, distributed via the `pi install` system. Each package contains extensions, skills, prompts, or themes. - ---- - -## Concept Files - -* [pi-browser-use](pi-browser-use.md) — Browser automation extension wrapping chrome-devtools-mcp with `browser_` prefix, full config reference, session modes, and vision model setup. -* [pi-permission-system](pi-permission-system.md) — Permission enforcement and policy configuration system with 10 interconnected docs. - -## Cross-References - -- All packages are installed via `pi install npm:` and loaded by pi's extension system. -- The pi-package distribution mechanism and package.json manifest format are superseded; see [Skills](../skills/index.md). diff --git a/omp-docs/pi/index.md b/omp-docs/pi/index.md index ebb6181..68dd767 100644 --- a/omp-docs/pi/index.md +++ b/omp-docs/pi/index.md @@ -1,37 +1,28 @@ -# Pi Configuration +# Pi Configuration (archive) -> **Archive note (2026-10-18).** Most pages in this directory document the retired -> **pi** harness (settings.json / models.json, `frank-default-*` endpoints, verified -> 2026-08-28). The live harness is **omp** — its config is `agent/config.yml` + -> `agent/models.yml` in this repo, the current fleet endpoints are on -> [System hosts](/system/index.md), and omp-specific knowledge lands in pages like -> [OMP Status Line Customization](/pi/statusline.md) below. Read pi pages as -> historical records, not current state. +> **Archive (2026-10-18).** This directory documents the retired **pi** harness +> (`settings.json` / `models.json`, `frank-default-*` endpoints). The live +> harness is **omp**: config in `agent/config.yml` + `agent/models.yml` (this +> repo), fleet endpoints on [System hosts](/system/index.md). Read these pages +> as historical records, not current state. Knowledge that survived the harness +> move lives under [Core](/core/index.md): +> [OMP Status Line](/core/statusline.md) and +> [OMP Subagent Limits](/core/subagent-limits.md). -## Configuration Files +## Configuration Files (pi-era) -- [Pi Settings System (settings.json)](/core/settings.md) — Main `settings.json` reference. Providers, models, packages, subagent overrides. -- [Pi Models Configuration](/pi/models.md) — `models.json` reference. Provider definitions, model specs, endpoints. -- [OMP Status Line Customization](/pi/statusline.md) — How presets, composer shapes, and segment arrays actually interact; the fleet's tuned bar. +- [Pi Settings System (settings.json)](/core/settings.md) — Main `settings.json` record. Providers, models, packages, subagent overrides. +- [Pi Models Configuration](/pi/models.md) — `models.json` record. Provider definitions, model specs, endpoints. -## Extensions +## Extensions (pi-era) -- [Pi Packages](/pi/packages/index.md) — Installed npm packages that extend pi functionality. - - [Pi Peon](/pi/packages/pi-peon.md) — CESP/OpenPeon sound-pack player for lifecycle events. - - [Pi Web Access](/pi/packages/pi-web-access.md) — Web search, URL fetching, GitHub cloning, PDF extraction, video understanding. - - [Pi Browser Use](/packages/pi-browser-use.md) — Browser automation extension wrapping chrome-devtools-mcp with a `browser_` prefix. - - [Pi Permission System](/packages/pi-permission-system.md) — Permission enforcement and policy configuration for subagent extensions. +- [Pi Packages](/pi/packages/index.md) — installed npm packages: peon, web-access, subagents, browser-use, permission-system. -## Skills +## Skills (pi-era) -- [Pi Skills](/pi/skills.md) — Installed agent skills. Symlinked from `~/.agents/skills/` and `~/.pi/agent/skills/`. +- [Pi Skills](/pi/skills.md) — installed skills inventory. Current skill toolchain: [Skills](/skills/index.md). -## Subagent Architecture - -- [OMP Subagent Limits & Fan-out Policy](/pi/subagent-limits.md) — Live caps: concurrency 2, no nested spawns (and the `maxRecursionDepth: 0` trap), per-endpoint in-flight ceilings, isolation policy. -- [Pi Subagents](/pi/packages/pi-subagents.md) — (historical) pi-era delegation system. Chains, parallel execution, TUI clarification. - -## Architecture +## Architecture (pi-era) ```mermaid graph TD @@ -51,7 +42,7 @@ graph TD M --> O[dankclaw 192.168.0.143:7770] ``` -## Note on the Live Default +## Note on the Live Default (historical) In the pi era, `models.json` defined the live provider set: the main session provider was `llamacpp` with default model `frank-default-large` (Dankclaw); @@ -60,8 +51,3 @@ to `frank-default-large`. Two scopes owned settings: the user `~/.pi/settings.json` (main → Dankclaw/large) and the project `/home/dank/.pi/agent/settings.json` (main → Dankserver/small); when they disagreed, the project-scope file won for the agent's own main session. - -> **Note:** This documentation describes the pi-coding-agent harness (config -> format, packages, skill system) as general reference material. The live -> harness is OMP at `~/.omp/`; OMP-managed skills live in -> `~/.omp/agent/managed-skills/`. diff --git a/omp-docs/pi/packages/index.md b/omp-docs/pi/packages/index.md index a27c256..7819aa1 100644 --- a/omp-docs/pi/packages/index.md +++ b/omp-docs/pi/packages/index.md @@ -1,29 +1,27 @@ # Pi Packages -Pi extends its functionality through npm packages installed via `pi install`. Each package provides extensions, skills, prompts, or themes. +Pi extended itself through npm packages (`pi install npm:`), each +bundling extensions, skills, prompts, or themes. The harness is retired +(2026-10-18); this page is the merged census of what was installed — one row +per package, detail pages kept as historical records. -## Installed Packages +## Installed packages -| Package | Version | Description | -|---------|---------|-------------| -| [[pi-peon|pi-peon]] | 0.1.1 | CESP/OpenPeon sound-pack player for pi lifecycle events | -| [[pi-web-access|pi-web-access]] | 0.22.0 | Web search, URL fetching, GitHub cloning, PDF extraction, video understanding | +| Package | Version | Detail | What it did | +|---------|---------|--------|-------------| +| `@wierdbytes/pi-peon` | 0.1.1 | [Pi Peon](pi-peon.md) | CESP/OpenPeon sound-pack player for pi lifecycle events. | +| `pi-web-access` | 0.22.0 | [Pi Web Access](pi-web-access.md) | Web search, URL fetching, GitHub cloning, PDF extraction, video understanding. | +| `pi-subagents` | 0.36.0 | [Pi Subagents](pi-subagents.md) | Core subagent delegation — chains, parallel execution, TUI clarification. | +| `pi-browser-use` | — | [Pi Browser Use](pi-browser-use.md) | Browser automation wrapping chrome-devtools-mcp behind a `browser_` prefix. | +| `pi-permission-system` | — | [Pi Permission System](pi-permission-system.md) | Permission enforcement and policy configuration; upstream docs are 10 interlinked pages. | -## Core Extension +## Where the concepts live now -| Package | Version | Description | -|---------|---------|-------------| -| [[pi-subagents|pi-subagents]] | 0.36.0 | Core subagent delegation — chains, parallel execution, TUI clarification | - ---- +* Subagent delegation → [OMP Subagent Limits & Fan-out Policy](/core/subagent-limits.md) (live caps). +* Skill/package distribution → [Skills](/skills/index.md) (Agent Skills standard + `skills` CLI). +* Web access → the `web/searxng` provider and MCP tooling; see [Agentic web research](/agentic-web-research/index.md). ## See Also -- [[settings|settings]] — Package configuration in settings.json -- [pi](../index.md) — Pi configuration overview - - * [Pi Peon](pi-peon.md) — CESP/OpenPeon sound-pack player for pi lifecycle events — peons, GLaDOS, battlecruisers, and 300+ community sound packs. - - * [Pi Subagents](pi-subagents.md) — Core pi extension for delegating tasks to subagents with chains, parallel execution, and TUI clarification. - - * [Pi Web Access](pi-web-access.md) — Web search, URL fetching, GitHub cloning, PDF extraction, and video understanding for Pi. Zero-config with Exa MCP. +- [Pi Settings System](/core/settings.md) — where these packages were registered (`settings.json` archive). +- [Pi Configuration](/pi/index.md) — pi-era overview. diff --git a/omp-docs/packages/pi-browser-use.md b/omp-docs/pi/packages/pi-browser-use.md similarity index 93% rename from omp-docs/packages/pi-browser-use.md rename to omp-docs/pi/packages/pi-browser-use.md index 9a3fcbf..d6b8469 100644 --- a/omp-docs/packages/pi-browser-use.md +++ b/omp-docs/pi/packages/pi-browser-use.md @@ -113,5 +113,5 @@ Resolves API key and base URL from the model registry automatically. ## Cross-References -- See [Skills](../skills/index.md) for the skill toolchain that replaced pi-package distribution. -- See [OKF Specification](../references/okf-spec.md) for the knowledge bundle format. +- See [Skills](/skills/index.md) for the skill toolchain that replaced pi-package distribution. +- See [OKF Specification](/references/okf-spec.md) for the knowledge bundle format. diff --git a/omp-docs/pi/packages/pi-peon.md b/omp-docs/pi/packages/pi-peon.md index d86e4b5..42145b6 100644 --- a/omp-docs/pi/packages/pi-peon.md +++ b/omp-docs/pi/packages/pi-peon.md @@ -81,5 +81,5 @@ The `/peon` command opens an interactive settings modal with: ## See Also -- [packages](../../packages/index.md) — Package overview +- [Pi Packages](index.md) — Package overview - [pi](../index.md) — Pi configuration diff --git a/omp-docs/packages/pi-permission-system.md b/omp-docs/pi/packages/pi-permission-system.md similarity index 86% rename from omp-docs/packages/pi-permission-system.md rename to omp-docs/pi/packages/pi-permission-system.md index 4702499..8a6bf3d 100644 --- a/omp-docs/packages/pi-permission-system.md +++ b/omp-docs/pi/packages/pi-permission-system.md @@ -33,5 +33,5 @@ timestamp: 2026-08-28 ## Cross-References -- See [Skills](../skills/index.md) for the skill toolchain that replaced pi-package distribution. -- See [AGENTS.md Format](../core/agents-md-format.md) for the system-level instruction format that governs how this system is referenced in agent contracts. +- See [Skills](/skills/index.md) for the skill toolchain that replaced pi-package distribution. +- See [AGENTS.md Format](/core/agents-md-format.md) for the system-level instruction format that governs how this system is referenced in agent contracts. diff --git a/omp-docs/system/dankserver.md b/omp-docs/system/dankserver.md index 714a617..e6b67c2 100644 --- a/omp-docs/system/dankserver.md +++ b/omp-docs/system/dankserver.md @@ -86,4 +86,4 @@ The old page (verified 2026-08-28) listed an RTX 3090, 60 GiB RAM, and a - [[dankclaw|dankclaw]] — the other inference box (dragoon + zealot) - [[network|network]] — Network topology -- [/pi/statusline.md](/pi/statusline.md) — where these models surface in the TUI +- [/core/statusline.md](/core/statusline.md) — where these models surface in the TUI