office: usage text, no session before the project is known good; commands on PATH
This commit is contained in:
Sam
@@ -0,0 +1,116 @@
|
||||
---
|
||||
type: session
|
||||
id: session.paperclip-harness.rich-discovery-home-2026-11-12-00-35-25
|
||||
title: Rich discovery: home 2026-11-12 00:35:25
|
||||
status: active
|
||||
source_of_truth: false
|
||||
freshness: current
|
||||
last_reviewed: 2026-11-12
|
||||
tags:
|
||||
- pack/paperclip-harness
|
||||
- agent-memory/session
|
||||
- autolearn
|
||||
- rich-discovery
|
||||
- repo/home
|
||||
---
|
||||
|
||||
# Rich discovery: home 2026-11-12 00:35:25
|
||||
|
||||
Sanitized rich discovery snapshot captured automatically from the completed turn.
|
||||
|
||||
|
||||
## Source paths observed
|
||||
|
||||
- `gitea.lab.audasmedia.com.au/sam/paperclip-harness.git`
|
||||
- `NixOS/nixpkgs/0954f7ee2f6bb3dc7d4e3d0d8bcb8fd4bde4cfc5`
|
||||
- `NixOS/nixpkgs/f4a03c008967841f2a0b3cb7c436fc6fc31671f6`
|
||||
- `home/sam/.config/fontconfig/conf.d/10-hm-fonts.conf`
|
||||
- `fontconfig/conf.d/10-hm-fonts.conf`
|
||||
- `etc/nixos/hosts/sam-4screen-desktop/configuration.nix`
|
||||
- `etc/nixos/hosts/sam-thinkpad/configuration.nix`
|
||||
- `home/sam/paseo/projects/email_agent`
|
||||
|
||||
## Final answer snapshot
|
||||
|
||||
You are right that I was inconsistent. Here is the exact state, then the simple rule for `office`.
|
||||
|
||||
## What is applied, precisely
|
||||
|
||||
| | `/etc/nixos` changed? | Evaluates to pi | Running pi | Needs |
|
||||
|---|---|---|---|---|
|
||||
| **`.13`** | **yes, now**: lock bumped to 2026-11-07, `initExtra` → `initContent` | **1.5.0** | 0.82.1 | one `sudo nixos-rebuild switch` |
|
||||
| **`.27`** | **yes, now**: same two edits | 1.5.0 | 0.82.1 | a fix first — see below |
|
||||
| **`.51`** | no | 0.87.1 | 0.87.1 | the same two edits, then rebuild |
|
||||
|
||||
Earlier I said "applied" when I had only tested a copy in `/tmp`. That was wrong wording on my part: nothing had been written to `/etc/nixos`. It has been now, on `.13` and `.27`, and `.13`'s dry-run build passes with 465 derivations to build and 5.5 GiB to fetch.
|
||||
|
||||
On `.13`, the rebuild is:
|
||||
|
||||
```sh
|
||||
sudo nixos-rebuild switch --flake /etc/nixos#nixos-desktop
|
||||
```
|
||||
|
||||
**`.27` cannot be rebuilt yet.** Its evaluation fails in home-manager's fontconfig code:
|
||||
|
||||
```
|
||||
… while evaluating the option `home-manager.users.sam.fonts.fontconfig.configFile.fonts.settings':
|
||||
error: … head values (attrsets.nix:1711)
|
||||
```
|
||||
|
||||
That is home-manager 2026-11-10 disagreeing with something in `.27`'s font configuration, not the Pi change. The smaller next attempt is to bump **nixpkgs only** on `.27` and leave home-manager where it is — I would try that before touching fonts.
|
||||
|
||||
`.51` would need the same two edits to reach 1.5.0. Say whether you want `.51` aligned in the same pass, or left at 0.87.1 until `.13` is proven.
|
||||
|
||||
## Your notes, adopted — and the commands simplified
|
||||
|
||||
I read `docs/STARTUP-COMMANDS.md`. Four things from it are now in our `bin/office`:
|
||||
|
||||
- **A host name → address table** (`nixos-desktop`/`.13` → `192.168.20.13`, and so on), because the old version broke on names ssh could not resolve.
|
||||
- **A check whether the named host is this machine**, before any ssh. I hit exactly that trap tonight: `office --remote 192.168.20.13` from `.13` tried to log in to itself.
|
||||
- **An ssh probe** (`ssh -o BatchMode=yes <addr> true`) before doing anything remote, so a missing key says so instead of half-working.
|
||||
- **`bin/board --reset`** — closes every pane, waits until the session is empty, clears the workspace names, then builds. `--replace` alone can run out of workspace slots on a half-built session.
|
||||
|
||||
One thing is *simpler* than the old design: it needed `tuios new --host …` plus `office … --host …`, because `office` could not create a session. Ours can, through the daemon's own verb. So it is one command.
|
||||
|
||||
## The rule, in one table
|
||||
|
||||
| Situation | Command |
|
||||
|---|---|
|
||||
| folder on this machine, shell on this machine | `bin/office <folder> --project "<Name>"` |
|
||||
| folder Paperclip has not seen yet | `bin/office <folder> --new "<Name>"` |
|
||||
| folder on another machine | `bin/office <folder> --project "<Name>" --host nixos-desktop` |
|
||||
| repair / rebuild | `bin/board`, `bin/board --replace`, `bin/board --reset` |
|
||||
| start again from nothing | `bin/project-reset <folder>` |
|
||||
|
||||
And the rule that removes the confusion: **the folder and the session live on the same machine.** If you are typing inside the session, on the machine that owns the folder, it is just `bin/office <folder>`. `--host` is only for the case where those two differ.
|
||||
|
||||
Written into `docs/STARTUP.md`, committed as `7b2cccf` and pushed.
|
||||
|
||||
## Your `email_agent` case, concretely
|
||||
|
||||
The folder is on `.13`, the Paperclip project is **Email Agent** (`local_path`, so no worktree policy), and the session must live on `.13`. From `.27`:
|
||||
|
||||
```sh
|
||||
bin/office /home/sam/paseo/projects/email_agent --project "Email Agent" --host nixos-desktop --session email-agent
|
||||
```
|
||||
|
||||
That runs the work on `.13` over ssh, creates the session there, and builds eight panes. Then `tuios attach --host nixos-desktop email-agent`. No program can move your client, so that last step is always yours.
|
||||
|
||||
## 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-12 00:35:25 -->
|
||||
|
||||
- context: [[packs/paperclip-harness/20-context/tmp|NixOS /etc/nixos flake: hosts, Pi CLI versions, office workflow]]
|
||||
- observation: [[packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns|NixOS fleet: Pi CLI version state and .27 fontconfig evaluation failure]]
|
||||
- runbook: [[packs/paperclip-harness/70-runbooks/tmp-deployment-operations|Rebuild/switch a NixOS host and fix home-manager fontconfig eval error]]
|
||||
- action: [[packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups|Pi 1.5.0 edits in /etc/nixos, simplified office/board scripts, docs/STARTUP.md]]
|
||||
- decision: [[packs/paperclip-harness/50-decisions/paperclip-harness-ui-six-workspaces-spec-first-four-panel-li|Convention: folder and session must live on the same machine; --host only when they differ]]
|
||||
- session: [[packs/paperclip-harness/80-sessions/rich-discovery-home-2026-11-12-00-35-25|Rich discovery: home 2026-11-12 00:35:25]]
|
||||
- context: [[packs/paperclip-harness/20-context/home|home]]
|
||||
Reference in New Issue
Block a user