adam/foundry
1
0
Fork 0
Code Issues 7 Pull requests 6 Projects 1 Releases Packages Wiki Activity Actions

P2 · Infra-write ergonomics (scoped allow-rules + mode convention) #9

New issue
Open
opened 2026-07-11 19:59:54 -05:00 by adam · 0 comments
adam commented 2026-07-11 19:59:54 -05:00
Owner
Copy link

Priority: P3 · Size: S · Depends on: #1 (final LAN convention)

Goal

Bake the 2026-07-11 Dockhand learnings into the dockhand-api skill, and confirm Hermes can use the Dockhand API headlessly (it was asleep, so parity was never verified).

Why

Three gotchas were discovered but not yet written into the skill:

  1. Cloning the public git.adamayala.work URL hangs (Pangolin SSO) → Dockhand must use the LAN :3000 URL. (Repo records already switched; document the rule.)
  2. A hung clone wedges the git-stack in syncStatus: "syncing" (no timeout, never self-clears) and blocks other stacks with "Sync already in progress" — clears via a Dockhand container restart (on boot it logs "Recovering N git stack(s) from stale syncing state").
  3. Media-app PUID must be 99/100 (cross-links issue #2).

Also: the skill's Hermes-verification note currently says "not verified — host was asleep."

Steps

  • Update .claude/skills/dockhand-api/SKILL.md with gotchas 1–3.
  • Branch + PR the doc change (per repo convention; don't push straight to main).
  • When the MacBook is awake, SSH to hermes and run the headless check: service-token op read of op://foundry/dockhand/api_key → Bearer → GET /api/git/stacks.
  • Update the skill's Hermes note with the verified result.

Acceptance

Skill PR merged; the Hermes curl returns the stack list; the verification note reflects reality.

Resources

Skills: dockhand-api, homelab-ssh, op-secrets, forgejo-api. Memory: project_dockhand_uid_and_clone_gotchas.

**Priority:** P3 · **Size:** S · **Depends on:** #1 (final LAN convention) ## Goal Bake the 2026-07-11 Dockhand learnings into the `dockhand-api` skill, and confirm Hermes can use the Dockhand API headlessly (it was asleep, so parity was never verified). ## Why Three gotchas were discovered but not yet written into the skill: 1. Cloning the **public** `git.adamayala.work` URL hangs (Pangolin SSO) → Dockhand must use the LAN `:3000` URL. (Repo records already switched; document the rule.) 2. A hung clone wedges the git-stack in `syncStatus: "syncing"` (no timeout, never self-clears) and blocks other stacks with "Sync already in progress" — **clears via a Dockhand container restart** (on boot it logs "Recovering N git stack(s) from stale syncing state"). 3. Media-app PUID must be `99/100` (cross-links issue #2). Also: the skill's Hermes-verification note currently says "not verified — host was asleep." ## Steps - Update `.claude/skills/dockhand-api/SKILL.md` with gotchas 1–3. - Branch + PR the doc change (per repo convention; don't push straight to main). - When the MacBook is awake, SSH to `hermes` and run the headless check: service-token `op read` of `op://foundry/dockhand/api_key` → `Bearer` → `GET /api/git/stacks`. - Update the skill's Hermes note with the verified result. ## Acceptance Skill PR merged; the Hermes curl returns the stack list; the verification note reflects reality. ## Resources Skills: `dockhand-api`, `homelab-ssh`, `op-secrets`, `forgejo-api`. Memory: `project_dockhand_uid_and_clone_gotchas`.
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
add-qrcode2stl-stack
add-ntfy-stack
fix-stackyard-image-tag
add-stackyard-stack
fix-omniroute-key-docs
add-omniroute-stack
add-ntfy-notifications
feat/obico-ml-detection
docs/lan-endpoints
printing-infra
homeassistant-vm
No results found.
Labels
Clear labels   
lab-honing
Lab-access honing backlog (from 2026-07-11 session review)

No labels
lab-honing
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
adam/foundry#9
No description provided.