Project>project overview from the dashboard endpoint; tools chooser drawn in Board>board; docs for Shell and t
This commit is contained in:
Sam
@@ -0,0 +1,55 @@
|
||||
---
|
||||
type: session
|
||||
id: session.paperclip-harness.paperclip-tuios-interface-discovery-skills-api-memory-stack-
|
||||
title: Paperclip-TUIOS interface discovery: skills API, memory stack, MOUSE-1, dashboard, old office scaffold
|
||||
status: active
|
||||
source_of_truth: false
|
||||
freshness: current
|
||||
last_reviewed: 2026-11-10
|
||||
tags:
|
||||
- pack/paperclip-harness
|
||||
- agent-memory/session
|
||||
- paperclip
|
||||
- tuios
|
||||
- skills-api
|
||||
- memory
|
||||
- mouse-1
|
||||
- dashboard
|
||||
- office-scaffold
|
||||
---
|
||||
|
||||
# Paperclip-TUIOS interface discovery: skills API, memory stack, MOUSE-1, dashboard, old office scaffold
|
||||
|
||||
Discovery pass recorded in `docs/PLAN-INTERFACE.md`, last commit `3d31243`.
|
||||
|
||||
1) Skills per agent: `GET /api/agents/{id}/skills` returns desired/managed sets + per-skill state. Builder currently: desired=[paperclipai/paperclip/paperclip]; company/<id>/obsidian-cli desired=false, managed=true, state="stale" (runtimeName obsidian-cli--b74ae42966, currentVersionId cf41ba39-..., sourcePath /home/sam/.paperclip/instances/default/skills/<companyId>/obsidian-cli). `POST /api/agents/{id}/skills/sync` accepts add/remove/replace (`replace` = exclusive set, keeps sub-agent context small). Full skills API surface: company skills CRUD/import/install-catalog/scan-projects/browse-project, versions, audit, comments, files, fork + fork-precheck, rename, reset, star, test-inputs, test-runs(+cancel), install-update, update-status, `GET/PUT/DELETE /api/companies/{id}/skill-policy` + `/evaluate`, skill-test-run-templates, `/api/skills/{index,available,catalog,...}`, invite-scoped skill index. Proposal: two rows in Agents>agents settings — skills (desired set, read-only first) and skill source; full browser later; fix stale obsidian-cli.
|
||||
|
||||
2) Memory is three distinct things: engram (v1.16.1 installed, MCP mode, NOT registered in ~/.pi/agent/mcp.json), headroom (v0.24.0 proxy at 192.168.20.13:8787, healthy, memory backend disabled, compression on — not a store), and pi memctx (injects notes into prompt). Only mcp servers registered: codebase-memory (/home/sam/.local/bin/codebase-memory-mcp), graphify-vault (/home/sam/.local/bin/relay-graphify-mcp), both lazy. Paperclip per-agent levers are adapterConfig/runtimeConfig. Proposal: a memory row in Agents>agents showing which of the three an agent uses, nothing more until measured.
|
||||
|
||||
3) MOUSE-1: MOUSE_API_KEY and JEV_API_KEY env names present (values not inspected); no mouse/mouse1/jev/switch binary installed. Existing notes state policy: "triage only: label, score, route, escalate. Never a gate, never a permit" — ruled out for merges/tool-call gating because it fails open on network errors. Adopted unchanged; if added, may only order Board>board needs-you list or pre-sort findings in Work>review.
|
||||
|
||||
4) Lazygit: already wired — `t` in Board>board or Work>work, opens in correct workspace, quits with `q`.
|
||||
|
||||
5) Old `office` (~/paseo/projects/tuios_coding_harness, scripts office/new-project/board): remembers host in .harness/host; runs new-project to write scaffold (settings.toml, per-role file, verify.sh, per-screen notes) only what is missing; refuses if session absent and prints exact `tuios new <session>` line (TUIOS cannot create sessions non-interactively — "Standard output is not a terminal"); then builds pages. Current office does host/refusal/pages but NO scaffold — cheapest real gap.
|
||||
|
||||
6) Dashboard: `GET /api/companies/{id}/dashboard` returns ~1.8KB: agents{active 6, running 0, paused 0, error 0}, tasks{open 8, inProgress 0, blocked 4, done 147}, costs{monthSpendCents 11, monthBudgetCents 0, utilization 0}, runActivity[14]. Proposal: Project>overview panel with those blocks + sparkline via tuios.dev/plot instead of embedding web dashboard. Artifacts explicitly dropped.
|
||||
|
||||
## Evidence
|
||||
|
||||
- Confidence: 90%
|
||||
- Reason: Rich evidence-backed discovery snapshot with concrete endpoints, component versions, paths, and proposals useful to future agents.
|
||||
|
||||
## Related
|
||||
|
||||
- [[packs/paperclip-harness/00-system/pi-agent/memory-manifest|Memory Manifest]]
|
||||
|
||||
## Related learned memories <!-- same-turn-2026-11-10 10:01:16 -->
|
||||
|
||||
- observation: [[packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns|Paperclip per-agent skills state and sync semantics]]
|
||||
- runbook: [[packs/paperclip-harness/70-runbooks/tmp-deployment-operations|Adopt an existing folder into the harness with `office` (and its known scaffold gap)]]
|
||||
- decision: [[packs/paperclip-harness/50-decisions/mouse-1-restricted-to-triage-never-a-gate-or-permit|MOUSE-1 restricted to triage; never a gate or permit]]
|
||||
- action: [[packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups|Recorded interface plan for Paperclip + TUIOS harness in docs/PLAN-INTERFACE.md]]
|
||||
- session: [[packs/paperclip-harness/80-sessions/paperclip-tuios-interface-discovery-skills-api-memory-stack-|Paperclip-TUIOS interface discovery: skills API, memory stack, MOUSE-1, dashboard, old office scaffold]]
|
||||
- context: [[packs/paperclip-harness/20-context/paperclip-tuios-harness-sam-s-coding-harness-office-board-wo|Paperclip-TUIOS harness (sam's coding harness: office/board/work screens)]]
|
||||
- session: [[packs/paperclip-harness/80-sessions/rich-discovery-paperclipai-2026-11-10-10-01-16|Rich discovery: paperclipai 2026-11-10 10:01:16]]
|
||||
- context: [[packs/paperclip-harness/20-context/home|paperclipai]]
|
||||
@@ -0,0 +1,149 @@
|
||||
---
|
||||
type: session
|
||||
id: session.paperclip-harness.rich-discovery-paperclipai-2026-11-10-10-01-16
|
||||
title: Rich discovery: paperclipai 2026-11-10 10:01:16
|
||||
status: active
|
||||
source_of_truth: false
|
||||
freshness: current
|
||||
last_reviewed: 2026-11-10
|
||||
tags:
|
||||
- pack/paperclip-harness
|
||||
- agent-memory/session
|
||||
- autolearn
|
||||
- rich-discovery
|
||||
- repo/paperclipai
|
||||
---
|
||||
|
||||
# Rich discovery: paperclipai 2026-11-10 10:01:16
|
||||
|
||||
Sanitized rich discovery snapshot captured automatically from the completed turn.
|
||||
|
||||
|
||||
## Source paths observed
|
||||
|
||||
- `home/sam/.local/bin/engram`
|
||||
- `home/sam/.config/environment.d/10-secrets.conf`
|
||||
- `home/sam/paseo/projects/paperclip-harness/.pi/memory-vault/packs/paperclip-harness/80-sessions/paperclip-harness-reverted-pane-split-interface-gap-discover.md`
|
||||
- `home/sam/paseo/projects/paperclip-harness/.pi/memory-vault/packs/paperclip-harness/80-sessions/rich-discovery-tmp-2026-11-10-07-35-38.md`
|
||||
- `home/sam/paseo/projects/paperclip-harness/.pi/memory-vault/packs/paperclip-harness/80-sessions/rich-discovery-home-2026-11-10-05-41-48.md`
|
||||
- `home/sam/paseo/projects/paperclip-harness/.pi/memory-vault/packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups.md`
|
||||
- `home/sam/paseo/projects/paperclip-harness/.pi/memory-vault/packs/paperclip-harness/20-context/home.md`
|
||||
- `github.com/Gentleman-Programming/engram/cmd/engram`
|
||||
- `api/skills/available`
|
||||
- `api/skills/catalog`
|
||||
- `api/skills/index`
|
||||
- `paperclipai/paperclip/paperclip`
|
||||
- `company/d4921013-e5da-4d88-8016-57d5746e2d03/obsidian-cli`
|
||||
- `home/sam/.paperclip/instances/default/skills/d4921013-e5da-4d88-8016-57d5746e2d03/obsidian-cli`
|
||||
- `home/sam/.pi/agent/skills/obsidian-`
|
||||
- `dir/.harness/host`
|
||||
- `home/sam/paseo/projects/tuios_coding_harness/plan/82-control-room.md`
|
||||
- `home/sam/paseo/projects/tuios_coding_harness/plan/83-interface.md`
|
||||
- `home/sam/paseo/projects/tuios_coding_harness/plan/80-forked-plan.md`
|
||||
- `home/sam/paseo/projects/tuios_coding_harness/plan/91-paperclip-or-oma.md`
|
||||
- `home/sam/paseo/projects/tuios_coding_harness/plan/50-open-work.md`
|
||||
- `home/sam/.pi/agent/git/gitea.lab.audasmedia.com.au/sam/pi-config/skills/graphify/SKILL.md`
|
||||
- `home/sam/.pi/agent/git/gitea.lab.audasmedia.com.au/sam/pi-config/skills/system-architect/SKILL.md`
|
||||
- `home/sam/.pi/agent/git/gitea.lab.audasmedia.com.au/sam/pi-config/extensions/pi-graphify/skills/graphify/SKILL.md`
|
||||
- `home/sam/.pi/agent/git/gitea.lab.audasmedia.com.au/sam/pi-config/node_modules`
|
||||
- `google/genai/dist/node/index.cjs`
|
||||
- `google/genai/dist/node/node.d.ts`
|
||||
- `home/sam/.config/systemd/user/lan-mouse.service`
|
||||
- `home/sam/.config/lan-mouse`
|
||||
- `home/sam/.config/lan-mouse/lan-mouse.pem`
|
||||
- `home/sam/.cache/lan-mouse`
|
||||
- `home/sam/.local/bin/lan-mouse-011`
|
||||
- `home/sam/.pi/agent/auth.json`
|
||||
- `home/sam/.pi/agent/mcp-cache.json`
|
||||
- `home/sam/.pi/agent/mcp.json`
|
||||
- `home/sam/.pi/agent/models.json`
|
||||
- `home/sam/.pi/agent/models-store.json`
|
||||
- `home/sam/.pi/agent/settings.json`
|
||||
- `home/sam/.pi/agent/trust.json`
|
||||
- `home/sam/.local/bin/codebase-memory-mcp`
|
||||
|
||||
## Final answer snapshot
|
||||
|
||||
Explored all of it. Recorded in `docs/PLAN-INTERFACE.md`; the short version:
|
||||
|
||||
## Skills per agent — Paperclip already models it
|
||||
|
||||
`GET /api/agents/{id}/skills` returns a desired set, a managed set and a state per skill. On `Builder` today:
|
||||
|
||||
```
|
||||
desired: ["paperclipai/paperclip/paperclip"]
|
||||
company/<id>/obsidian-cli desired: false managed: true state: "stale"
|
||||
```
|
||||
|
||||
`POST /api/agents/{id}/skills/sync` takes `add`, `remove` or **`replace`** — `replace` is exactly "this agent gets these and nothing else", which is how a sub-agent's context stays small. There is also a company skill catalog, versions, audit, and `GET/PUT /api/companies/{id}/skill-policy` with an `evaluate` call.
|
||||
|
||||
Proposal: two rows in `Agents>agents` settings — **skills** (the desired set, read-only first, add/remove later) and **skill source**. A full browser is a later screen, not a panel. Also: `obsidian-cli` sitting `stale` on Builder is worth fixing.
|
||||
|
||||
## Memory — three different things
|
||||
|
||||
| | state here | what it is |
|
||||
|---|---|---|
|
||||
| **engram** | installed, v1.16.1, MCP mode, **not** registered in `~/.pi/agent/mcp.json` (only `codebase-memory`, `graphify-vault`) | persistent memory |
|
||||
| **headroom** | running, v0.24.0, healthy at `192.168.20.13:8787`, memory backend **disabled**, compression on | a prompt-compression proxy, not a store |
|
||||
| **pi memctx** | in use now | injects notes into a prompt |
|
||||
|
||||
They are complementary. Paperclip's only per-agent lever is `adapterConfig` and `runtimeConfig`, so memory is set per agent by pointing that agent at the proxy or store it should use. Proposal: a **memory** row in `Agents>agents` settings showing which of the three that agent uses, and nothing more until one agent has run both ways and been measured.
|
||||
|
||||
## MOUSE-1
|
||||
|
||||
`MOUSE_API_KEY` is set (checked the name only, never the value). `JEV_API_KEY` too. No `mouse`, `mouse1`, `jev` or `switch` binary is installed.
|
||||
|
||||
There **are** notes, and they are good ones — in the old project's plan documents:
|
||||
|
||||
> MOUSE-1 is *"triage only: label, score, route, escalate. Never a gate, never a permit"* — explicitly ruled out for deciding a merge or allowing a tool call, because a cheap classifier that fails open on a network error makes a green run a lie.
|
||||
|
||||
I would adopt that policy unchanged. Its place, if added: ordering `Board>board`'s needs-you list, or pre-sorting findings in `Work>review`. Never the merge, never an approval.
|
||||
|
||||
## Lazygit
|
||||
|
||||
Already wired: `t` in `Board>board` or `Work>work`, choose Lazygit. Verified opening in the right workspace and closing with `q`.
|
||||
|
||||
## The old `office` — and what ours lacks
|
||||
|
||||
The previous `office` did four things: remember the host; run `new-project` to write the scaffold (`settings.toml`, a file per role, `verify.sh`, the per-screen notes) writing **only what is missing**; refuse if the session does not exist and print the exact `tuios new` line; then build the pages.
|
||||
|
||||
Ours does the host, the refusal and the pages — but **no scaffold**. No per-role files, no `verify.sh`, no page notes. That is the cheapest real gap in the whole plan.
|
||||
|
||||
## Dashboard — the API answers it in one call
|
||||
|
||||
`GET /api/companies/{id}/dashboard`, 1.8 KB:
|
||||
|
||||
```
|
||||
agents {active 6, running 0, paused 0, error 0}
|
||||
tasks {open 8, inProgress 0, blocked 4, done 147}
|
||||
costs {monthSpendCents 11, monthBudgetCents 0, utilization 0}
|
||||
runActivity [14 entries]
|
||||
```
|
||||
|
||||
Proposal: a `Project>overview` panel with those blocks and a sparkline drawn in Go with `tuios.dev/plot`, rather than embedding the web dashboard in a pane.
|
||||
|
||||
## Not doing
|
||||
|
||||
Artifacts — dropped as instructed.
|
||||
|
||||
I am ready for the task you are about to deliver; nothing in the tree is half-changed, the eight workspaces are running, and the last commit is `3d31243`.
|
||||
|
||||
## Evidence
|
||||
|
||||
- Confidence: 86%
|
||||
- Reason: Preserve full sanitized discovery detail from a rich investigation turn
|
||||
|
||||
## Related
|
||||
|
||||
- [[packs/paperclip-harness/00-system/pi-agent/memory-manifest|Memory Manifest]]
|
||||
|
||||
## Related learned memories <!-- same-turn-2026-11-10 10:01:16 -->
|
||||
|
||||
- observation: [[packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns|Paperclip per-agent skills state and sync semantics]]
|
||||
- runbook: [[packs/paperclip-harness/70-runbooks/tmp-deployment-operations|Adopt an existing folder into the harness with `office` (and its known scaffold gap)]]
|
||||
- decision: [[packs/paperclip-harness/50-decisions/mouse-1-restricted-to-triage-never-a-gate-or-permit|MOUSE-1 restricted to triage; never a gate or permit]]
|
||||
- action: [[packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups|Recorded interface plan for Paperclip + TUIOS harness in docs/PLAN-INTERFACE.md]]
|
||||
- session: [[packs/paperclip-harness/80-sessions/paperclip-tuios-interface-discovery-skills-api-memory-stack-|Paperclip-TUIOS interface discovery: skills API, memory stack, MOUSE-1, dashboard, old office scaffold]]
|
||||
- context: [[packs/paperclip-harness/20-context/paperclip-tuios-harness-sam-s-coding-harness-office-board-wo|Paperclip-TUIOS harness (sam's coding harness: office/board/work screens)]]
|
||||
- session: [[packs/paperclip-harness/80-sessions/rich-discovery-paperclipai-2026-11-10-10-01-16|Rich discovery: paperclipai 2026-11-10 10:01:16]]
|
||||
- context: [[packs/paperclip-harness/20-context/home|paperclipai]]
|
||||
Reference in New Issue
Block a user