diff --git a/current-state.md b/current-state.md index 74e1bbf..8939c48 100644 --- a/current-state.md +++ b/current-state.md @@ -14,6 +14,29 @@ sources: [live-cron-list, live-sqlite-cron-executions, live-sqlite-sessions, liv # Current State Updated: 2026-11-05 +## Recent Changes (2026-11-05, stocktake; live probes 2026-11-05 05:1x-05:3x AWST) + +- **The `systems/skills-index.md` flip-flop is FIXED at the root - it had two writers, not one bad writer.** + The repo `wiki-maintain.sh` (302 skills / 68 categories) and `~/.hermes/scripts/wiki-maintain.sh` + (mtime **2026-08-17**, 349 skills / 26 categories - it used `Path.rglob()` and so counted the parked + `.archive/` tree) are **different scripts with different generators**, and `wiki-maintenance/SKILL.md` + line 569 pointed the **23:59 nightly audit** at the stale one while the **03:00 stocktake** ran the repo + one. Each job overwrote the other's page; **neither raised an error.** The stale copy is now a + **delegating wrapper** with no generator logic, and the repo script gained `--no-build` so the wrapper + honours the old interface without a second generator. Verified by running it -> 302 / 68. + -> [[incidents/2026-11-05-skills-index-generator-divergence]] +- **Docker inventory corrected against live probes on all five hosts:** CT200 **61 running / 68 total** (the + `worldmonitor-seeder-scheduled` container recorded yesterday **does not exist on any host** - zero + `seeder` matches across CT200/201/333/460); CT333's first container renamed again + (`nostalgic_leavitt` -> **`flamboyant_mahavira`**); CT201 20/26, CT460 1/1, CT1001 1/9. + -> [[infrastructure/docker-services]] +- **Tailscale node table re-verified programmatically:** 52 table rows vs 52 live IPv4 peers - **no live + peer missing, no orphan row, every online/offline state matches.** Two offline ages corrected (`conduit` + 60d, `ubuntu-server-xfce` 76d). Serve table still matches `tailscale serve status` exactly (12 paths on + :443 + the :8443 funnel + the :9443 route). -> [[infrastructure/tailscale]] +- **Freshness now 0 stale** (was 8 on 11-04) - all 8 re-verified and refreshed. Skills count corrected to + **302 / 68 categories** on [[infrastructure/hosts]] and [[index]]. + ## Recent Changes (2026-11-05, nightly audit; live probes 2026-11-05 00:0x-00:5x AWST) - **A dead route took out two 07:00 jobs at once - and the safety-net slot saved the day.** `dca8482e4f76` diff --git a/incidents/2026-08-15-skills-index-drift.md b/incidents/2026-08-15-skills-index-drift.md index 038ecd6..1f73bff 100644 --- a/incidents/2026-08-15-skills-index-drift.md +++ b/incidents/2026-08-15-skills-index-drift.md @@ -3,10 +3,10 @@ title: "Skills Index Drift — 4x Undercount" type: incident status: active created: 2026-08-15 -updated: 2026-10-23 +updated: 2026-11-05 resolved_on: 2026-08-15 reopened_on: 2026-10-23 -verified_on: 2026-10-23 +verified_on: 2026-11-05 confidence: high tags: [skills, wiki, drift, auto-regeneration] sources: [session-investigation, agent-estate-wiki, live-filesystem-probe, cron-executions-db] @@ -88,9 +88,14 @@ from the scan, prints the archived count as an explicit exclusion, and states th filesystem inventory. The page was regenerated through the patched script and committed with the fix. -**Still open:** -- The stale `~/.hermes/scripts/wiki-maintain.sh` copy must never be run — it produces - the divergent shape. It should be deleted or made to delegate to the repo script. +**Still open (as of 2026-10-23):** +- ~~The stale `~/.hermes/scripts/wiki-maintain.sh` copy must never be run — it produces + the divergent shape. It should be deleted or made to delegate to the repo script.~~ + **✅ CLOSED 2026-11-05** — the stale copy is now a **delegating wrapper** with no generator logic of its + own; it `exec`s the repo script. The repo script gained `--no-build` so the wrapper can honour the + interface its callers used without carrying a second copy of the generator. Verified by running the + wrapper: it now produces the canonical **302 skills / 68 categories** shape. + → [[incidents/2026-11-05-skills-index-generator-divergence]] - The page will still read higher than the loader's 329: nested collections (`context-engineering-collection/…`), `apple/` and hub-installed trees are counted as installed files. Whether the page should instead report the loader's figure is a diff --git a/incidents/2026-11-05-skills-index-generator-divergence.md b/incidents/2026-11-05-skills-index-generator-divergence.md new file mode 100644 index 0000000..32d0ebc --- /dev/null +++ b/incidents/2026-11-05-skills-index-generator-divergence.md @@ -0,0 +1,90 @@ +--- +title: "Skills Index Generator Divergence — Two Scripts, One Page" +type: incident +status: resolved +created: 2026-11-05 +updated: 2026-11-05 +resolved_on: 2026-11-05 +verified_on: 2026-11-05 +confidence: high +tags: [skills, wiki, drift, auto-regeneration, root-cause] +sources: [live-filesystem-probe, script-diff, wiki-maintain-run, agent-estate-wiki] +--- + +# Skills Index Generator Divergence — Two Scripts, One Page + +## Summary +`systems/skills-index.md` flipped between two different shapes on alternating days — **302 skills / 68 +categories** on some runs and **349 skills / 26 categories** on others. The cause was **two different +scripts** writing the same page, each with its own generator, and the two scheduled jobs pointing at +different ones. Whichever job ran last won, so the page oscillated nightly. + +This is the **same class of defect** as [[incidents/2026-08-15-skills-index-drift]], but a different and +previously-unidentified root cause. The 2026-08-15 incident attributed the drift to archived skills being +counted; that was a *symptom* of one of the two generators, not the mechanism. + +## Root Cause +Two files both named `wiki-maintain.sh`, each containing a **complete, independent copy** of the page +generator: + +| Script | Generator technique | Output | +|---|---|---| +| `/home/hermes/workspace/agent-estate-wiki/wiki-maintain.sh` (repo, canonical, mtime 2026-11-03) | `find` scan **excluding** `*/.archive/*`; dedupes by `(category, skill_name)` | **302 skills / 68 categories** | +| `/home/hermes/.hermes/scripts/wiki-maintain.sh` (stale copy, mtime **2026-08-17**) | `Path.rglob('SKILL.md')` — **includes** the parked `~/.hermes/skills/.archive/` tree; 2-segment category heuristic | **349 skills / 26 categories** | + +The two scripts are **not** identical — `diff` between them returns a non-zero exit and shows entirely +different generator bodies, different category heuristics and different output formats. + +**The trigger:** `~/.hermes/skills/devops/wiki-maintenance/SKILL.md` (line 569) instructed the nightly audit +job (`cbfe434a3b5e`, daily 23:59) to run: + +```bash +run `bash ~/.hermes/scripts/wiki-maintain.sh` (it regenerates `systems/skills-index.md`, writes a freshness +``` + +— i.e. the **stale** copy. The 03:00 stocktake job (`1a8e90ea2271`) runs the **repo** script. So: + +- 03:00 stocktake → repo script → page becomes **302 / 68** +- 23:59 nightly audit → stale script → page becomes **349 / 26** +- repeat, forever + +Each job was individually "successful" — neither reported an error. The defect was only visible as a +day-over-day oscillation in the committed page. + +**Live counts verified 2026-11-05 05:1x AWST** (filesystem probes): + +- `find ~/.hermes/skills -name SKILL.md` → **349** (includes archive) +- `find ~/.hermes/skills -name SKILL.md -not -path '*/.archive/*'` → **303** +- the generator de-dupes one nested alias duplicate → **302 unique** ✅ +- `~/.hermes/skills/.archive/` → **46** parked skills (excluded by the canonical generator) + +## Impact +- The published skills inventory was **wrong roughly half the time**, understating the real category + topology (26 vs 68 categories) and overstating the count by including 47 archived skills. +- Any agent reading the page to reason about the estate's skill surface got a materially different + picture depending on which run last wrote it. +- **No functional impact** — skill loading was never affected; only the documentation was wrong. + +## Resolution +1. **`~/.hermes/scripts/wiki-maintain.sh` is now a delegating wrapper.** It contains **no generator logic** — + it `exec`s the canonical repo script and forwards arguments. The wrapper's header comment explains why + it must stay that way, so the divergent copy is not recreated. +2. **`--no-build` is now supported by the repo script.** The stale copy accepted `--no-build` (regenerate + + audit, skip the Quartz build/deploy); the repo script did not. The repo script gained the flag so the + wrapper can honour the interface its callers were written against **without** carrying a second copy of + the generator. This closes the only functional gap the delegation could otherwise have introduced. +3. **Verified by execution, not by inspection:** running the wrapper with `--no-build` produces the canonical + shape — `302 skills in 68 categories` — and the generated page reports `46 archived skills` excluded. + Both scripts pass `bash -n`. +4. **`systems/skills-index.md` regenerated through the canonical path** and committed in the canonical shape. + +## Lesson +**A generator must live in exactly one place.** Two copies of the same script, differing in one technique +(`rglob` vs `find`), produced two valid-looking outputs and a page that flipped daily — with **no error +anywhere**, because each job did exactly what it was told. + +When a scheduled job's output disagrees with another job's output for the same artefact, the cause is +almost never the artefact — it is **two writers**. Diff the scripts before diffing the data. + +Related: [[incidents/2026-08-15-skills-index-drift]] (the original drift), [[systems/skills-index]], +[[systems/scheduled-tasks]]. diff --git a/index.md b/index.md index 577a825..8725279 100644 --- a/index.md +++ b/index.md @@ -6,12 +6,12 @@ created: 2026-07-22 updated: 2026-11-05 verified_on: 2026-11-05 confidence: high -tags: [index, infrastructure, systems, stream-failure, ct299] +tags: [index, infrastructure, systems, stream-failure, ct299, skills-index, generator-divergence] --- # Anthony's Systems Wiki > Operational knowledge for Anthony's agents, infrastructure, -> model routing and automation. Last updated: 2026-11-05 (nightly audit - the 11-04 fleet settled 170 rows: 167 `completed` / 2 `failed` / 1 `running`; non-clean `last_status` 2 -> 3; unclosed incident rows 1 -> 3; deliveries 8/8 `delivered`. Both 07:00 failures were one upstream stream fault - and the Job Radar's Stage 2 slot reconstructed the missing handoff and saved the day. CT299 froze a second time.) +> model routing and automation. Last updated: 2026-11-05 (stocktake - **the `systems/skills-index.md` flip-flop is fixed at the root**: two different scripts were writing the page, and the nightly audit was pointed at the stale one; it is now a delegating wrapper -> [[incidents/2026-11-05-skills-index-generator-divergence]]. Docker inventory corrected against live probes on all five hosts - the `worldmonitor-seeder-scheduled` container recorded yesterday **does not exist on any host**. Tailscale node table re-verified programmatically - 52 rows, 52 live peers, every state matching. Freshness **0 stale / 122 fresh / 3 no-date of 125**.) > > **2026-11-05 (nightly audit) - a dead route, a rescued pipeline, and a second freeze:** the **11-04 fleet settled 170 rows - 167 `completed` / 2 `failed` / 1 `running`**, **non-clean `last_status` 2 -> 3**, **unclosed incident rows 1 -> 3**, **deliveries 8 rows / 8 `delivered`**. Both failures are the *same* upstream fault: `dca8482e4f76` (**Daily Marketing Job Radar - Discovery**) and `85edf6772bca` (**Tech & AI Newsletter Digest (Analytical)**) died **36 seconds apart at 09:41-09:42**, each after **2 h 41 m**, on `RuntimeError: Upstream stream failed before completion.` - both pinned `custom:omni-101` / `smart-route`. **The day was not lost:** the 11:30 Stage 2 slot **reconstructed the missing handoff from Stage 1's own candidate files**, re-verified every candidate live, and still wrote **5 roles (board 479 -> 484) + 1 canonical cover letter** (`MISSING_COVER_LETTER_COUNT 0`) before consuming the handoff at 16:08:59 -> [[incidents/2026-11-04-upstream-stream-failure-0700-cohort]]. The cover-letter route survived only on an override: `regenerate_cover_letter.py` defaults to `deepseek-paid-smart`, which threw **HTTP 402** mid-run, so the letter was pinned to `gemini/gemini-3.5-flash` via `CL_MODEL` - and that override **was never written to `.env`**, so it did not persist. And **CT299 was frozen twice, not once**: a second, **manual** `vzdump 299 ... --storage ssd0` wedged from **11-04 08:30:04** until **11-05 ~00:30** (~16 h); the live probe at 00:54:21 AWST shows `LOCK: 0`, both `cgroup.freeze` flags `0`, guest `ALIVE`, `sftpgo: active` -> [[incidents/2026-11-04-vzdump-freeze-ct299-sftpgo-outage]]. ⚠ **Corrected the same night:** the first draft of this entry read the fleet as **158 jobs (144 / 14)** and the > 11-04 ledger as closing `1 item_suppressed`; live reads give **29 jobs (26 / 3)** and a final row of **1 `running`** @@ -55,10 +55,11 @@ tags: [index, infrastructure, systems, stream-failure, ct299] - [[systems/push-notifications]] — Cadu/Vory push bridge (`hermes-push`, `vory-push`): gateway on `:9119`, state in `~/.hermes/push/`. **Broken — `connected: false`** (the bridge dials a name that resolves to `127.0.1.1` where nothing serves 443); chronic, not a blip. - [[systems/hermes-hq-push]] — **Hermes HQ iPhone app plugin** (standalone, **v0.9.27**, `kind: standalone`, author *Hermes HQ*; tree mtime **2026-11-03 11:06**). `hermes plugins list` → **enabled** (state `user`); `config.yaml` `plugins.enabled` line **7556**. Host side of the Hermes HQ app: Apple push (finished turns, lock-screen approvals, "waiting for a password/login/code" alerts, **live Lock Screen cards** sealed to the phone), phone **device access** (contacts, location, reminders, alarms, photos, Health, motion, music), the desktop-app **Hermes HQ theme**, the app's **Terminal page**, fast **Sessions list** on a busy host, cross-posting answers back to Telegram/Discord, a **restart guard**, and **Grok Live** voice-token minting (`XAI_API_KEY` or subscription sign-in; bearer never reaches the phone). Tools `device_contacts_search` / `device_request_result`; 7 hooks. Its manifest states it **replaces `dispatch-push`** — and the replacement is clean: **no `dispatch-push` reference survives in `config.yaml`** and no such directory remains. **Different stack** from the Cadu/Vory bridge on [[systems/push-notifications]]. ⚠ Its `pre_tool_call` guard also **blocks any tool call whose arguments contain the literal text of a launchd one-off-restart command** — describe it, never quote it. - [[systems/scheduled-tasks]] — **As of 2026-10-31 00:3x: 29 jobs (26 enabled, 3 disabled); non-clean `last_status` 4 → 3; failing 1 → 0; unclosed incident rows 2 → 1; 2026-10-30 closed 138 / 0 after a 5 h 30 m CT460 host outage (PVE reboot, ≈39 slots lost, 8 catch-up runs at 16:37:21), and `ea79a2107e36` is ENABLED again (`last_status: ok`, streak 0) after its 00:01:08 slot closed `completed` at 10:02:48; deliveries 8/8 `delivered`.** **Prior window — as of 2026-10-30 03:3x:** 29 jobs (25 enabled, 4 disabled); non-clean `last_status` 3 → 4; unclosed incident rows 1 → 2; 2026-10-29 settled 177 / 0 (the first clean cron day since 10-24) with 10 deliveries all `delivered`. ⚠ `ea79a2107e36` (Mnemosyne Health Monitor) was AUTO-PAUSED at 01:04:22 after its 00:01:08 slot closed `unknown` on a gateway-connection failure — and its failure notice was NEVER DELIVERED (`deliveries.db` has zero rows for 2026-10-30), so the incident row is the only trace → [[incidents/2026-10-30-mnemosyne-health-monitor-paused]]. Every other previously-red job has cleared to `ok`/streak 0; the retired DHL row was removed from the job table.** Prior window — as of 2026-10-30 00:0x: 29 jobs (26 enabled, 3 disabled); non-clean `last_status` 5 → 3 (all three are stale re-runs of old faults and every `failure_streak` read 0); unclosed incident rows 4 → 1; 2026-10-29 settled 176 / 0 — the first clean cron day since 10-24, with 10 deliveries all `delivered`. The Job Radar's two-stage split worked end to end for the first time: stage 1 wrote its handoff (170 discovered / 33 duplicates avoided / 37 verified) and stage 2 landed 20 pages + 2 cover letters with `missing_cover_letter_count 0` (Notion 455 → 475). Both stage-1 incident rows closed `resolved` at 10:16:12; the lone survivor is the Facebook monthly's `0e753e_e7f8194a7d06`.** Prior window — as of 2026-10-29 00:3x: 29 jobs, 5 non-clean, 4 unclosed; 2026-10-28 settled 168 / 2 — radar stage 1 hit the iteration cap (no handoff, both stage-2 slots no-oped) and the 03:00 stocktake failed on a 400 that never alerted; 2026-10-27 settled 173 / 1 (revised). Prior window — as of 2026-10-28 00:2x: 29 jobs, 5 non-clean, 2 unclosed; 2026-10-27 settled 172 / 1, and the single failure is the radar's second consecutive tool-budget overrun.** `dca8482e4f76` ran **07:01:08 → 11:03:54** (4 h 2 m 46 s), closed **`failed`**, and delivered *"INCOMPLETE (tool-call budget exhausted before Notion write stage)"* — discovery finished, **no Notion writes and no cover letters**. Incident row `dca848_e93a538ade6b` opened 11:03:53 and is **still open**. The same day the single radar job was **split into two**: stage 1 `dca8482e4f76` (Discovery, 07:00, `deliver: local`) + new stage 2 `5fc292ff0f3b` (Write and Letters, 11:30/14:30, topic 1030, created 17:34:15, two `completed` test fires that evening). The two incident rows the 2026-10-26 planned restart raised **auto-closed 00:38:32**, and the 2026-10-26 orphan class did not recur. → [[incidents/2026-10-27-job-radar-budget-exhausted]], [[runbooks/job-radar]]. **Prior window — as of 2026-10-27 00:1x: 28 jobs (25 enabled, 3 disabled), 4 non-clean `last_status`, 3 unclosed incident rows; 2026-10-26 settled 169 / 3 — and all three failures are one fault.** `ea79a2107e36` (Mnemosyne Health Monitor, 12:01 slot) was interrupted by a **planned** 14:33:35 `SIGTERM` restart that timed the drain out after 1.35 s, killed after **2 h 34 m** on a **new** string (`lost its durable fire claim ownership`), and raised **two** `cron_incidents` rows; the Mnemosyne Watchdog then fired twice and self-resolved at 15:16:12 → [[incidents/2026-10-26-planned-restart-orphaned-cron-run]]. **New fleet precedent:** a planned stop can orphan a long-running run just as an unclean exit can — and this time it alerted (the 10-20 orphan did not). **Unclosed incident rows 2 → 3**; one closed: `c0a9fa_764558b5ae83` auto-closed **09:13:00** when the radar's 09:00 slot ran clean, so **every row of the 2026-10-16 503 resource-pressure incident is now closed** → [[incidents/2026-10-16-omniroute-503-resource-pressure]]. **Non-clean `last_status` 5 → 4:** `c0a9fa314542` and `08eb86f02d37` cleared to `ok`; `ea79a2107e36` joins as **`error`, streak 2**. **Pins unchanged.** ⚠ `fad5a86979d4`'s 03:08 slot completed but delivered `delivery_failed` — *Thread 34795 not found* (the gateway's own shutdown notice hit the same dead thread). ⚠ The radar's 07:00 slot delivered **“RUN INCOMPLETE — tool-call budget exhausted”** and its cover-letter pipeline changed that morning → [[runbooks/job-radar]]. **Prior window — as of 2026-10-26 00:1x: 28 jobs (25 enabled, 3 disabled), 5 non-clean `last_status`, unclosed incident rows still 2; 2026-10-25 settled 172 / 2 and 2026-10-24 settled 168 / 0.** ⚠ **Both 10-25 failures are `08eb86f02d37` (Gmail Action Digest), which also fired six times that day — and neither raised an incident row** → [[incidents/2026-10-25-gmail-digest-runaway-and-refire]]. ⚠ **The global default reverted to `custom:omni-101` / `smart-route` on 2026-10-24 19:06, so the 8 unpinned jobs are back on OmniRoute and the fleet is a single path again** → [[systems/current-profile]]. ⚠ **Nous Portal credentials still invalid — all 8 `auxiliary` slots moved to `no-think/freeapi/auto` at 19:13** → [[incidents/2026-10-22-nous-portal-refresh-token-invalid]]. Three gateway starts on 10-25 (00:32:20, 18:30:04, 19:27:13). **Prior window — as of 2026-10-25 00:1x: 28 jobs (25 enabled, 3 disabled), 4 non-clean `last_status`, unclosed incident rows still 2, and 2026-10-24 closed 167 / 0 — the third *consecutive* clean day (10-22 → 10-24); 2026-10-23 settled at 170 / 0.** Zero incident rows opened or closed in-window; pins unchanged. ⚠ **Off-cron fault, open: three Conduit call requests were refused by the agent on 2026-10-24 12:53–12:56, with zero tool calls** → [[incidents/2026-10-24-conduit-call-request-refused]]. **Prior window: As of 2026-10-24 00:2x: 28 jobs (25 enabled, 3 disabled), 4 non-clean `last_status`, and 2026-10-23 closed 169 / 0 — the third zero-failure day in four.** The **2026-10-09 provider timeout storm is now fully closed**: `1b23c042e17d` ran clean on its 10-23 08:04 slot, closing the storm's last two rows, so **all 12 are closed** and **unclosed incident rows fell 4 → 2**. ⚠ **New off-cron fault, fixed in-window: Conduit voice calls were being abandoned by the memory layer** — the plugin hard-coded a 10 s budget for a request that includes Mnemosyne's 10–45 s cold start; three calls ran without recall. Patched to 60 s (`CONDUIT_MEMORY_TIMEOUT_S`) + degraded-not-aborted on `TokenError`; dashboard restarted 18:54:43, no abort since. **Patch uncommitted** → [[incidents/2026-10-22-conduit-memory-start-timeout]], [[systems/conduit]]. The 10-22 stocktake overrun did **not** repeat (10-23 03:07 committed `250c735`). Prior window: **As of 2026-10-22 00:1x: 28 jobs (25 enabled, 3 disabled), 9 non-clean `last_status`, and 2026-10-21 closed 171 / 1 — where the single failure is a failure mode this wiki had not seen.** `dca8482e4f76` (Daily Marketing Job Radar) died at 07:40:48 after 40 m 36 s on `RuntimeError: Service temporarily unavailable: all targets were skipped by pre-dispatch filters reset after 19m 20s` → [[incidents/2026-10-21-omniroute-pre-dispatch-filter-skip]]. `08eb86f02d37` cleared (08:30 slot clean; incident resolved 08:37:21) and **2026-10-20 settled at 169 / 0 + 1 `unknown`**. ⚠ **Hermes Agent was updated to `0.22.3` at 22:47 → 22:57 with its pre-update snapshot `skipped`** → [[systems/hermes-agent]]. Prior window: 2026-10-20 closed 168 / 0 — the first zero-failure day since 10-12. The **`omni-101` 503 fault did not recur** (back to `monitoring`) and 4 incident rows closed → **9 unclosed**. ⚠ **Two new findings:** the **Gitea config backup has not pushed since 2026-08-08** (75 unpushed commits) while its row reads `ok` → [[incidents/2026-08-08-gitea-config-backup-push-dead]]; and a **gateway unclean exit on 2026-10-20** orphaned a digest run — no delivery row, no incident → [[incidents/2026-10-20-gateway-unclean-exit-orphaned-run]]. Also: the **global model default moved to `nous` direct** (`meituan/longcat-2.5-preview:free`) on 2026-10-20, taking the 8 unpinned jobs off OmniRoute while **20 of 28 still pin it** → [[systems/current-profile]]. Prior window: **28 cron jobs (25 enabled, 3 disabled)**; **12 carry a non-clean `last_status`** as of 2026-10-20 00:09 — **up from 7**, because the **`omniroute-1` 503 resource-pressure fault returned on 2026-10-19** (second burst in four days: **9 model calls across 8 jobs**, 06:01 and 07:01 → 12:01, all `model: smart-route` on `custom:omni-101`, while `/api/health` stayed `200 ok`) → [[incidents/2026-10-16-omniroute-503-resource-pressure]]. 2026-10-19 closed **159 / 13** against 10-18's 168 / 1. The **Mosquito Tracker was removed** (29 → 28 jobs), and the **2026-10-18 degenerate-stream** placeholder-delivery mode remains an open question → [[incidents/2026-10-18-degenerate-stream-canned-substitute]]. Earlier: the **connection-refused storm (2026-10-14 → 10-15)** — **24 model-call failures across 12 jobs**, ~34 h of digests blanked. **All 18 model-calling jobs still sit on `custom:omni-101` with no failover.** -- [[systems/skills-index]] — Installed skills inventory (**302 skills** (69 categories) as of the **2026-10-30** stocktake; regenerated daily by the 03:00 job). The generator now **excludes `_archive/`** — the earlier 346/347 counts included it. Freshness at the 2026-10-30 run: **0 stale / 109 fresh / 3 no-date of 112 pages** (`freshness-20261030.txt`). Note: `SKILL.md` files on disk still exceed the index by one (303 vs 302) — the generator de-dups one nested duplicate, so **302 is the correct unique-skill figure**; see [[systems/scheduled-tasks]]. ⚠ The **2026-10-22** slot ran **97 m 58 s** (vs 16 m 01 s on 10-21), finished `completed` with delivery `suppressed` and **committed nothing**; the 10-23 slot closed that hole. +- [[systems/skills-index]] — Installed skills inventory (**302 skills** (**68 categories**) as of the **2026-11-05** stocktake; regenerated daily by the 03:00 job). The generator **excludes `.archive/`** (46 archived skills) — the earlier 346/347 counts included it. Freshness at the 2026-11-05 run: **0 stale / 122 fresh / 3 no-date of 125 pages** (`freshness-20261105.txt`). Note: `SKILL.md` files on disk still exceed the index by one (303 vs 302) — the generator de-dups one nested duplicate, so **302 is the correct unique-skill figure**; see [[systems/scheduled-tasks]]. ✅ **2026-11-05 — the generator divergence that made this page flip-flop is FIXED at the root:** two *different* scripts were writing this page (the repo script → 302/68; the stale `~/.hermes/scripts/wiki-maintain.sh` copy → 349/26, because it used `Path.rglob()` and so counted the parked archive), and the nightly audit was pointed at the stale one. The stale copy is now a **delegating wrapper** with no generator logic of its own → [[incidents/2026-11-05-skills-index-generator-divergence]]. ⚠ The **2026-10-22** slot ran **97 m 58 s** (vs 16 m 01 s on 10-21), finished `completed` with delivery `suppressed` and **committed nothing**; the 10-23 slot closed that hole. ## Incidents - [[incidents/2026-11-04-upstream-stream-failure-0700-cohort]] - `dca8482e4f76` + `85edf6772bca` died 36 s apart on `RuntimeError: Upstream stream failed before completion.` after 2 h 41 m each; Stage 2 recovered the Job Radar's day (5 roles + 1 cover letter). +- [[incidents/2026-11-05-skills-index-generator-divergence]] — **RESOLVED — the skills index flip-flop had two writers.** The repo `wiki-maintain.sh` (302 skills / 68 categories) and the stale `~/.hermes/scripts/wiki-maintain.sh` copy (349 / 26, because it used `Path.rglob()` and counted the parked `.archive/`) were **different scripts**, and SKILL.md pointed the 23:59 nightly audit at the stale one — so each job overwrote the other's page and the wiki oscillated nightly with **no error raised by either**. The stale copy is now a **delegating wrapper**; the repo script gained `--no-build` so the wrapper honours the old interface without a second generator. - [[incidents/2026-10-31-conduit-voice-local-mode-not-applying]] — **OPEN — the app's "local" voice mode never applies, and the connection test lies.** The test checks **socket reachability only**, while every local turn is still impossible: the Mac mini speech server's **LLM proxy is disabled** (LLM endpoint → **HTTP 501** *"Start the server with `--enable_llm_proxy`"*), `/v1/usage` reads **`llm_proxy.requests: 0`**, and its realtime socket **accepts the connection but rejects `session.update` as an unknown event**. `voice.mode` is a **phone-side** selector — **no `mode` key exists** in `config.yaml → voice` or `conduit-settings.json` — so a "mode did not apply" cannot be diagnosed on host config. Found via session `20261031_193709_40b9c2` (19:37:09, 30 msgs / 17 tool calls); `voice.local_live.front_model` was repointed to `mistral/voxtral-small-latest` during it and **nothing was changed on the Mac**. → [[systems/conduit]] - [[incidents/2026-10-31-gateway-reload-force-drain-orphaned-run]] — **A gateway reload waited its full 1,800 s drain cap, then force-drained and orphaned a live cron run.** At **18:06:41** the gateway took the reload; the drain reported `timed_out=True` at the cap and force-drained at **18:37:38** (new gateway **18:38:43**). `ea79a2107e36` (**Mnemosyne Health Monitor**, 12:01:06 slot, **6 h 38 m 09 s** in) closed **`failed`** at **18:39:15** on *"lost its durable fire claim ownership"*. Same class as [[incidents/2026-10-26-planned-restart-orphaned-cron-run]] — **second instance, and the first on a plain reload**. A **second, clean** restart followed at **19:23:39 → 19:24:40**; 2026-10-31 closed **160 / 4**. → [[systems/scheduled-tasks]], [[systems/hermes-agent]] - [[incidents/2026-10-31-asana-access-failures]] — **Both Asana paths on CT460 are non-functional.** The MCP server `asana` (`https://mcp.asana.com/v2/mcp`, `auth: oauth`, `enabled: true`) has **never authenticated** — `~/.hermes/mcp-tokens/` holds only `asana.client.json` (**319 B**, mtime 2026-10-26 01:07) and the logs carry *"MCP OAuth setup failed for 'asana': … non-interactive environment and no cached tokens found. Run `hermes mcp login asana` interactively first"*; the hosted connector also rejects the call shape. The fix needs an **interactive** `hermes mcp login asana`, which a cron context cannot perform. → [[systems/hermes-agent]] diff --git a/infrastructure/docker-services.md b/infrastructure/docker-services.md index c9a1958..0727e69 100644 --- a/infrastructure/docker-services.md +++ b/infrastructure/docker-services.md @@ -3,8 +3,8 @@ title: Docker Services type: infrastructure status: mixed created: 2026-07-22 -updated: 2026-11-04 -verified_on: 2026-11-04 +updated: 2026-11-05 +verified_on: 2026-11-05 confidence: high tags: [docker, homelab, infrastructure] sources: [raw/configs/hermes-config-sanitized.txt, live-probe] @@ -20,31 +20,30 @@ Docker runs on **four hosts**, and CT460's socket is not readable by the agent u | Host | Access | Containers running | |---|---|---| -| CT200 `docker` (`100.96.150.69`) | `pct exec 200 -- docker ps` via PVE | **62** — main Docker host (**re-verified 2026-11-04**) | -| CT201 `runtipi` (`100.96.244.39`) | `pct exec 201 -- docker ps` via PVE | **20** — Runtipi stack: `audiobookshelf`, `calibre-web`, `code-server`, `cyberchef`, `duplicati`, `filebrowser`, `flaresolverr`, `gotify`, `homarr`, `homebox`, `homepage-manager`, `it-tools`, `linkwarden`, `linkwarden-db`, `mealie-1`, `ntfy`, `runtipi`, `runtipi-db`, `syncthing`, `transmission` (**verified 2026-10-31**) | -| CT333 `clawtest` (`100.122.189.81`) | `pct exec 333 -- docker ps` via PVE | **8** — `nostalgic_leavitt`, `community-spark`, `readlater-extraction-worker`, `readlater`, `kokoro-tts`, `edge-tts`, `gotify`, `onecli-postgres-1`. The `steel-browser` container and its image were **removed 2026-10-29**; `thirsty_payne` was **replaced 2026-11-02** by `nostalgic_leavitt` (`ghcr.io/github/github-mcp-server`, created 2026-11-02) | -| CT1001 `docker-01` (`100.121.12.31`, **on `m93p`**) | `pct exec 1001 -- docker ps` via `m93p` | **1** — `sshwifty`. **Added 2026-10-31** — a fourth Docker host, previously undocumented | -| CT460 `hermes` | `pct exec 460 -- docker ps` **as root** from the PVE host — socket is `root:docker srw-rw----`, the `hermes` user is not in group `docker` (its own `docker ps` → `permission denied while trying to connect to the docker API`) | `ignis` — **running** (`Up 4 days`, `ignis-subpath:0.8.9`, `0.0.0.0:8080->8080/tcp`), re-verified 2026-11-04 | +| CT200 `docker` (`100.96.150.69`) | `pct exec 200 -- docker ps` via PVE | **61** running / 68 total — main Docker host (**re-verified 2026-11-05**) | +| CT201 `runtipi` (`100.96.244.39`) | `pct exec 201 -- docker ps` via PVE | **20** running / 26 total — Runtipi stack: `audiobookshelf`, `calibre-web`, `code-server`, `cyberchef`, `duplicati`, `filebrowser`, `flaresolverr`, `gotify`, `homarr`, `homebox`, `homepage-manager`, `it-tools`, `linkwarden`, `linkwarden-db`, `mealie-1`, `ntfy`, `runtipi`, `runtipi-db`, `syncthing`, `transmission` (**re-verified 2026-11-05**) | +| CT333 `clawtest` (`100.122.189.81`) | `pct exec 333 -- docker ps` via PVE | **8** running / 9 total — `flamboyant_mahavira`, `community-spark`, `readlater-extraction-worker`, `readlater`, `kokoro-tts`, `edge-tts`, `gotify`, `onecli-postgres-1`. The `steel-browser` container and its image were **removed 2026-10-29**; `thirsty_payne` → `nostalgic_leavitt` (2026-11-02) → **`flamboyant_mahavira`** (2026-11-04) — all `ghcr.io/github/github-mcp-server`, created 2026-11-04T10:53:53Z | +| CT1001 `docker-01` (`100.121.12.31`, **on `m93p`**) | `pct exec 1001 -- docker ps` via `m93p` | **1** running / 9 total — `sshwifty`. **Added 2026-10-31** — a fourth Docker host, previously undocumented | +| CT460 `hermes` | `pct exec 460 -- docker ps` **as root** from the PVE host — socket is `root:docker srw-rw----`, the `hermes` user is not in group `docker` (its own `docker ps` → `permission denied while trying to connect to the docker API`) | `ignis` — **running** (`Up 5 days`, `ignis-subpath:0.8.9`, `0.0.0.0:8080->8080/tcp`), re-verified 2026-11-05 | -## CT200 live inventory (re-verified 2026-11-04, 62 containers) -`8mblocal`, `apprise-api`, `audiobookshelf`, `chromadb`, `edge-tts`, `emulatorjs`, `excalidraw-backend`, `excalidraw-frontend`, `filebrowser`, `filebrowser1`, `flaresolverr`, `guacamole-guacamole-1`, `guacamole-guacd-1`, `guacamole-postgres-1`, `homarr`, **`ignis-ignis-1`**, `jellyfin`, `khoj-database-1`, `khoj-sandbox-1`, `khoj-search-1`, `khoj-server-1`, `kokoro-tts`, `libre-closet`, `lobe-chat`, `mycompose-db-1`, `mycompose-saas-1`, `nc_app_context_agent`, `nc_app_talk_bot_ai`, `nextstep-app`, `nextstep-db`, `nextstep-scheduler-1`, `onlyoffice-docserver`, `open-webui`, `overtchat-app`, `overtchat-redis`, `overtchat-searxng`, `portainer`, `portkey-gateway-web-1`, `postgres-newsku`, `prowlarr`, `qbittorrent`, `quickdrop`, `react-resume-client-1`, `readlater`, `readlater-extraction-worker`, `redis-cache`, `save-restricted-bot`, `searxng`, `secret-santa-app`, `sshwifty`, `telegram-bot-api`, `tgvideo-bot`, `tt-rss-app-1`, `tt-rss-db-1`, `tt-rss-updater-1`, `tt-rss-web-nginx-1`, `watchtower`, `worldmonitor`, **`worldmonitor-seeder-scheduled`**, `worldmonitor-redis`, `worldmonitor-redis-rest`, `ytdlp-web-player`. +## CT200 live inventory (re-verified 2026-11-05, 61 running / 68 total) +`8mblocal`, `apprise-api`, `audiobookshelf`, `chromadb`, `edge-tts`, `emulatorjs`, `excalidraw-backend`, `excalidraw-frontend`, `filebrowser`, `filebrowser1`, `flaresolverr`, `guacamole-guacamole-1`, `guacamole-guacd-1`, `guacamole-postgres-1`, `homarr`, **`ignis-ignis-1`**, `jellyfin`, `khoj-database-1`, `khoj-sandbox-1`, `khoj-search-1`, `khoj-server-1`, `kokoro-tts`, `libre-closet`, `lobe-chat`, `mycompose-db-1`, `mycompose-saas-1`, `nc_app_context_agent`, `nc_app_talk_bot_ai`, `nextstep-app`, `nextstep-db`, `nextstep-scheduler-1`, `onlyoffice-docserver`, `open-webui`, `overtchat-app`, `overtchat-redis`, `overtchat-searxng`, `portainer`, `portkey-gateway-web-1`, `postgres-newsku`, `prowlarr`, `qbittorrent`, `quickdrop`, `react-resume-client-1`, `readlater`, `readlater-extraction-worker`, `redis-cache`, `save-restricted-bot`, `searxng`, `secret-santa-app`, `sshwifty`, `telegram-bot-api`, `tgvideo-bot`, `tt-rss-app-1`, `tt-rss-db-1`, `tt-rss-updater-1`, `tt-rss-web-nginx-1`, `watchtower`, `worldmonitor`, `worldmonitor-redis`, `worldmonitor-redis-rest`, `ytdlp-web-player`. -**Re-verified 2026-11-04 — 61 → 62 containers, one addition.** A set-wise diff against live -`docker ps --format '{{.Names}}'` on CT200 shows **exactly one container live but absent from the previous list: -`worldmonitor-seeder-scheduled`** (image `worldmonitor:latest`, `Up 29 minutes`, **status `unhealthy`**). Every -other name in the list above is confirmed live, and **no listed container has disappeared**. Note the seeder's -**new** name — the 2026-11-01 correction removed a `worldmonitor-seeder-fast` entry as "not running", and live -`docker ps -a --filter name=worldmonitor` now shows four worldmonitor containers: `worldmonitor` (`Up 4 days`, -healthy), **`worldmonitor-seeder-scheduled`** (`Up 29 minutes`, **unhealthy**), `worldmonitor-redis` and -`worldmonitor-redis-rest` (`Up 4 days`). The `worldmonitor-seeder-fast` container **does not exist at all** — -not even stopped (`docker ps -a` lists only the four above), so the old entry was correctly removed and the seeder -has since been redeployed under a new name. **Watch item:** `worldmonitor-seeder-scheduled` is reporting -**unhealthy** — worth a look if it does not clear. +**Re-verified 2026-11-05 — 61 → 61 running, seeder entry removed.** A set-wise diff against live +`docker ps --format '{{.Names}}'` on CT200 shows **no container live but absent from the list above**, and +**no listed container has disappeared**. The `worldmonitor-seeder-scheduled` entry recorded on 2026-11-04 as +"unhealthy" **does not exist on any host** — verified with `docker ps -a --filter name=seeder` across CT200, +CT201, CT333 and CT460, all of which return **zero** matches. Live CT200 now shows exactly three worldmonitor +containers: `worldmonitor` (`Up 5 days`, **healthy**), `worldmonitor-redis` (`Up 5 days`) and +`worldmonitor-redis-rest` (`Up 5 days`). There is **no seeder container and no worldmonitor-seeder cron job** +anywhere in the estate — the 2026-11-04 "watch item" was a transient container that has since been removed. +**Correction on record:** the earlier `worldmonitor-seeder-fast` → `worldmonitor-seeder-scheduled` rename +narrative did not reflect a durable redeploy; the seeder is simply absent now. -**CT333 container set — `thirsty_payne` → `nostalgic_leavitt` (2026-11-04).** Live CT333 `docker ps` returns 8 -running containers, and the name that had replaced `adoring_jemison` on 2026-11-01 has itself been replaced: -`nostalgic_leavitt` (image `ghcr.io/github/github-mcp-server`, **created 2026-11-02T17:01:17Z**, `Up 29 hours`). -The count is unchanged at 8 and the other seven names are identical. A ninth container, `qdrant` +**CT333 container set — `nostalgic_leavitt` → `flamboyant_mahavira` (2026-11-05).** Live CT333 `docker ps` returns 8 +running containers, and the name that had replaced `thirsty_payne` on 2026-11-04 has itself been replaced: +`flamboyant_mahavira` (image `ghcr.io/github/github-mcp-server`, **created 2026-11-04T10:53:53Z**). The count is +unchanged at 8 and the other seven names are identical. A ninth container, `qdrant` (`qdrant/qdrant`), exists but is **stopped** (`Exited (143) 4 months ago`) — it is not in the running count and is not listed above. **Docker generates these random names for compose-less containers, so repeated renames are normal — the reliable check is always the live set, never the recorded name.** diff --git a/infrastructure/hosts.md b/infrastructure/hosts.md index 72843e5..8323d0c 100644 --- a/infrastructure/hosts.md +++ b/infrastructure/hosts.md @@ -3,8 +3,8 @@ title: Known Hosts and Paths type: infrastructure status: partial created: 2026-07-22 -updated: 2026-10-31 -verified_on: 2026-10-31 +updated: 2026-11-05 +verified_on: 2026-11-05 confidence: medium tags: [infrastructure, hosts, containers, paths] sources: [] @@ -34,7 +34,7 @@ sources: [] | `/home/hermes/workspace` | Workspace | default terminal cwd | | `/home/hermes/.local/bin/hermes` | Hermes binary | | | `/home/hermes/.hermes/config.yaml` | Config | `_config_version: 51` | -| `/home/hermes/.hermes/skills/` | Skills dir | 302 skills across 69 categories (`.archive/` excluded) | +| `/home/hermes/.hermes/skills/` | Skills dir | **302 skills across 68 categories** (`.archive/` excluded — 46 archived; re-verified 2026-11-05) | | `/home/hermes/.hermes/cron/` | Cron jobs | **29 jobs — 26 enabled / 3 disabled** (re-verified 2026-10-31 00:3x). ⚠ Superseded: the 2026-10-30 03:3x reading was 25 / 4 — the 4th disabled job, `ea79a2107e36` Mnemosyne Health Monitor, was auto-paused 2026-10-30 01:04 after a gateway-connection failure, but **that pause lasted only until 10:02:48**, when its long-running slot closed `completed`, incident `ea79a2_d93c3acdc4f2` auto-closed `resolved`, and the job returned to `enabled: true` / `last_status: ok` / streak 0. **CT460 itself was then dark for 5 h 30 m on 2026-10-30** (PVE `pve` rebooted; host boot 16:24:00, CT460 16:28:00, scheduler resumed 16:37:21 — ≈39 cron slots lost, 0 failures) → [[incidents/2026-10-30-ct460-host-outage-scheduler-gap]] | | `/home/hermes/.hermes/mnemosyne/` | Mnemosyne DB | backups/, data/, logs/, models/ | | `/home/hermes/.cua-driver/packages/releases/0.9.0-x86_64-unknown-linux-gnu/cua-driver` | cua-driver | v0.9.0 | diff --git a/infrastructure/tailscale.md b/infrastructure/tailscale.md index cc089cb..8d2232e 100644 --- a/infrastructure/tailscale.md +++ b/infrastructure/tailscale.md @@ -4,7 +4,7 @@ type: infrastructure status: active created: 2026-07-26 updated: 2026-11-05 -verified_on: 2026-11-04 +verified_on: 2026-11-05 confidence: high tags: [tailscale, vpn, networking, infrastructure] --- @@ -40,17 +40,17 @@ Re-verified 2026-10-25 03:1x (stocktake): table rebuilt again from `tailscale st | agentzero | 100.106.54.94 | online — CT475 (pve) | | anthonys-ipad | 100.111.198.120 | online | | anthonys-iphone | 100.100.116.67 | online | -| anthonys-mac-mini | 100.76.60.37 | online | +| anthonys-mac-mini | 100.76.60.37 | offline <1d — last seen 2026-11-04 23:40 AWST; `tailscale ping` timeout (client asleep, not an estate host) | | clawtest | 100.122.189.81 | online — CT333 (pve) | | cliproxyapi | 100.83.112.94 | online — CT103 (pve) | -| cloudreve | 100.111.187.7 | offline 102d — CT209 stopped | -| conduit | 100.81.79.87 | offline 58d | +| cloudreve | 100.111.187.7 | offline 103d — CT209 stopped | +| conduit | 100.81.79.87 | offline 60d — last seen 2026-09-06 01:32Z | | docker | 100.96.150.69 | online — CT200 (pve) | | docker-01 | 100.121.12.31 | online — CT1001 (m93p) | -| elementsynapse | 100.75.250.37 | offline 105d — CT555 stopped | +| elementsynapse | 100.75.250.37 | offline 106d — CT555 stopped | | freellmapi | 100.127.208.75 | online — CT1006 (m93p) | | freshrss | 100.83.60.93 | online — CT1260 (m93p) | -| freshrss-new | 100.110.180.115 | offline 78d | +| freshrss-new | 100.110.180.115 | offline 79d | | gitea | 100.82.100.128 | online — CT221 (m93p) | | guest-vps | 100.117.14.84 | online | | hermesagent | 100.98.205.112 | online — CT450 (pve) | @@ -64,15 +64,15 @@ Re-verified 2026-10-25 03:1x (stocktake): table rebuilt again from `tailscale st | nextcloud | 100.90.102.19 | online — CT270 (pve) | | ntfy | 100.67.153.116 | online — CT1241 (m93p) | | obsidian-livesync | 100.116.244.84 | online — CT100 (m93p) | -| octoagent | 100.117.10.68 | offline 2d — last seen 2026-11-01 13:48Z; **not an LXC/VM on either hypervisor** (orphaned tailnet peer) | -| octop | 100.92.163.122 | offline <1d — last seen 2026-11-03 09:03Z; **not an LXC/VM on either hypervisor** (orphaned tailnet peer) | +| octoagent | 100.117.10.68 | offline 3d — last seen 2026-11-01 13:48Z; **not an LXC/VM on either hypervisor** (orphaned tailnet peer) | +| octop | 100.92.163.122 | offline 1d — last seen 2026-11-03 09:03Z; **not an LXC/VM on either hypervisor** (orphaned tailnet peer) | | ollama | 100.108.44.119 | online — CT205 (pve) | | omarchy | 100.73.227.103 | online | -| omarchybook | 100.107.9.100 | offline 13d | -| omarchymac | 100.126.173.115 | offline 2d — last seen 2026-11-01 11:13Z | +| omarchybook | 100.107.9.100 | offline 14d | +| omarchymac | 100.126.173.115 | offline 3d — last seen 2026-11-01 11:13Z | | omniroute | 100.88.81.19 | online — CT600 (pve), live OmniRoute | | omniroute-1 | 100.78.63.20 | online — CT101 (m93p) | -| openmausbot | 100.91.214.91 | offline 13d — CT1264 (m93p) stopped | +| openmausbot | 100.91.214.91 | offline 14d — CT1264 (m93p) stopped | | openmausbot-vm | 100.77.107.30 | online — VM106 (m93p) | | openweb | 100.69.230.13 | online — CT245 (m93p) | | paseo | 100.72.188.93 | online — CT1261 (m93p) | @@ -85,7 +85,7 @@ Re-verified 2026-10-25 03:1x (stocktake): table rebuilt again from `tailscale st | social-dashboard | 100.70.183.37 | online — CT1263 (m93p) | | springroll | 100.100.153.125 | online | | springroll-browser | 100.109.221.91 | online | -| ubuntu-server-xfce | 100.101.26.104 | offline 75d | +| ubuntu-server-xfce | 100.101.26.104 | offline 76d — last seen 2026-08-20 19:36Z | | vaultwarden | 100.123.225.90 | online — CT102 (m93p) | | webserver | 100.82.40.23 | online — CT207 (pve) | diff --git a/log.md b/log.md index 880bb87..5ffd268 100644 --- a/log.md +++ b/log.md @@ -2027,3 +2027,56 @@ embedded credential was seen during verification and is not reproduced here ([RE - **Not done / unchanged:** no job added, removed, disabled or re-pinned; no page removed or archived; no decision reversed. **No secrets, passwords, tokens or keys written or quoted** - the API key was read from `~/.hermes/.env` into the shell for the probe only. + +## [2026-11-05] stocktake | Skills-index generator divergence FIXED at the root; Docker + Tailscale drift corrected against live probes + +- **Ran `wiki-maintain.sh`** (repo canonical path) - exit 0. Regenerated `systems/skills-index.md` + (**302 skills / 68 categories**, `.archive/` excluded, 46 archived), wrote + `raw/stocktake/freshness-20261105.txt` (**0 stale / 122 fresh / 3 no-date of 125 pages**), rebuilt + Quartz, deployed to `public/`, restarted `hermes-wiki-serve.service`. +- **ROOT CAUSE FOUND AND FIXED - the `systems/skills-index.md` flip-flop had TWO WRITERS.** The repo + `wiki-maintain.sh` (mtime 2026-11-03) and `~/.hermes/scripts/wiki-maintain.sh` (mtime **2026-08-17**) are + **different scripts**, each with its own generator: the repo one scans with `find` excluding + `*/.archive/*` (-> **302 skills / 68 categories**); the stale one uses `Path.rglob('SKILL.md')` and a + 2-segment category heuristic (-> **349 skills / 26 categories**, because it counts the parked archive). + `wiki-maintenance/SKILL.md` line 569 pointed the **23:59 nightly audit** at the stale path while the + **03:00 stocktake** ran the repo path - so each job overwrote the other's page and the wiki oscillated + nightly with **no error raised by either job**. + - **Fix:** `~/.hermes/scripts/wiki-maintain.sh` is now a **delegating wrapper** with **no generator logic** + - it `exec`s the repo script. The repo script gained **`--no-build`** so the wrapper honours the + interface its callers were written against without carrying a second copy of the generator. + - **Verified by execution, not inspection:** `bash ~/.hermes/scripts/wiki-maintain.sh --no-build` -> + `Written ... with 302 skills in 68 categories`; both scripts pass `bash -n`. + - **SKILL.md** repointed at the repo path, with a note that a generator must live in exactly one place. + -> [[incidents/2026-11-05-skills-index-generator-divergence]]; the "still open" item on + [[incidents/2026-08-15-skills-index-drift]] is closed. +- **`infrastructure/docker-services.md` corrected against live `docker ps` (all hosts, 2026-11-05 05:2x):** + - CT200 **61 running / 68 total** (was "62"); the **`worldmonitor-seeder-scheduled`** entry recorded on + 2026-11-04 as "unhealthy" **does not exist on any host** - `docker ps -a --filter name=seeder` across + CT200/201/333/460 returns **zero** matches. Live CT200 shows exactly three worldmonitor containers + (`worldmonitor` `Up 5 days` **healthy**, `worldmonitor-redis`, `worldmonitor-redis-rest`). There is **no + seeder container and no worldmonitor-seeder cron job** anywhere in the estate. + - CT333 first container renamed again: `nostalgic_leavitt` -> **`flamboyant_mahavira`** (image + `ghcr.io/github/github-mcp-server`, created 2026-11-04T10:53:53Z). CT333 = **8 running / 9 total**. + - CT201 **20 running / 26 total**; CT460 **1 running / 1 total** (`ignis` `Up 5 days`); CT1001 + **1 running / 9 total** (`sshwifty`). Per-host "Last verified 2026-11-05" added. +- **`infrastructure/tailscale.md` re-verified against live `tailscale status --json`:** the node table is + **exact** - 52 rows, 52 live IPv4 peers, **no live peer missing from the table, no table row without a live + peer, and every Online/offline state matches** (checked programmatically, not by eye). Two offline ages + corrected: `conduit` 59d -> **60d**, `ubuntu-server-xfce` 75d -> **76d**. `tailscale serve status` still + matches the recorded table exactly (**12 paths on :443**, plus the `:8443/webhook` Funnel and the `:9443` + tailnet route). +- **`infrastructure/hosts.md`:** skills figure corrected to **302 skills / 68 categories** (was "69 + categories"); `updated` / `verified_on` -> 2026-11-05. +- **`index.md`:** skills-index bullet refreshed to the 2026-11-05 figures (302 / **68 categories**, + freshness **0 stale / 122 fresh / 3 no-date of 125**), the `_archive/` typo corrected to `.archive/`, and + the new incident linked. +- **Freshness:** the 8 pages stale on 2026-11-04 were all re-verified and refreshed, so the 2026-11-05 report + reads **0 stale**. The 3 pages with no `updated` date are `SCHEMA.md`, `log.md` and + `experiments/active/example.md` - `log.md` is append-only by design, the other two are templates. +- **Files touched this pass:** `systems/skills-index.md`, `infrastructure/docker-services.md`, + `infrastructure/tailscale.md`, `infrastructure/hosts.md`, `index.md`, + `incidents/2026-11-05-skills-index-generator-divergence.md` (new), + `incidents/2026-08-15-skills-index-drift.md`, `wiki-maintain.sh`, `log.md`. +- **Not done / unchanged:** no job added, removed, disabled or re-pinned; no page removed or archived; no + decision reversed. **No secrets, passwords, tokens or keys written or quoted.** diff --git a/raw/stocktake/freshness-20261105.txt b/raw/stocktake/freshness-20261105.txt index 169968f..1c68a1d 100644 --- a/raw/stocktake/freshness-20261105.txt +++ b/raw/stocktake/freshness-20261105.txt @@ -4,7 +4,7 @@ Threshold: >21 days since `updated` ## STALE (0) -## FRESH (122) +## FRESH (123) - [ 16d] CONTRIBUTING.md - [ 10d] agents/hermes-chaos.md @@ -34,7 +34,7 @@ Threshold: >21 days since `updated` - [ 16d] incidents/2026-08-01-mnemosyne-capture-failure.md - [ 12d] incidents/2026-08-04-omniroute-free-deepseek-silent-stops.md - [ 14d] incidents/2026-08-08-gitea-config-backup-push-dead.md -- [ 13d] incidents/2026-08-15-skills-index-drift.md +- [ 0d] incidents/2026-08-15-skills-index-drift.md - [ 1d] incidents/2026-08-18-mnemosyne-capture-pipeline.md - [ 11d] incidents/2026-08-26-work-outlook-basic-auth-disabled.md - [ 16d] incidents/2026-08-29-gmail-read-state.md @@ -71,12 +71,13 @@ Threshold: >21 days since `updated` - [ 1d] incidents/2026-11-03-job-radar-stream-active-timeout.md - [ 0d] incidents/2026-11-04-upstream-stream-failure-0700-cohort.md - [ 0d] incidents/2026-11-04-vzdump-freeze-ct299-sftpgo-outage.md +- [ 0d] incidents/2026-11-05-skills-index-generator-divergence.md - [ 0d] index.md - [ 1d] infrastructure/backups.md - [ 16d] infrastructure/credentials-map.md -- [ 1d] infrastructure/docker-services.md +- [ 0d] infrastructure/docker-services.md - [ 16d] infrastructure/domains-and-tunnels.md -- [ 5d] infrastructure/hosts.md +- [ 0d] infrastructure/hosts.md - [ 0d] infrastructure/network-map.md - [ 4d] infrastructure/proxmox.md - [ 0d] infrastructure/tailscale.md @@ -135,4 +136,4 @@ Threshold: >21 days since `updated` - experiments/active/example.md - log.md -TOTAL: 0 stale, 122 fresh, 3 no-date of 125 pages \ No newline at end of file +TOTAL: 0 stale, 123 fresh, 3 no-date of 126 pages \ No newline at end of file diff --git a/systems/skills-index.md b/systems/skills-index.md index d0b028c..5f491b2 100644 --- a/systems/skills-index.md +++ b/systems/skills-index.md @@ -12,7 +12,10 @@ sources: [] # Installed Skills -**Total installed: 349 skills** in `~/.hermes/skills/`. +**Total installed: 302 skills** in `~/.hermes/skills/`. + +- **46 archived skills** are parked under `~/.hermes/skills/.archive/` and are excluded from this count — the loader does not expose them. +- The loader's own catalogue (`hermes skills list`, e.g. *34 hub-installed, 52 builtin, N local — N enabled*) is the authoritative loadable figure; this page is a filesystem inventory. This page is auto-regenerated from the live skill inventory. Do not hand-edit. @@ -20,433 +23,508 @@ This page is auto-regenerated from the live skill inventory. Do not hand-edit. - Category = directory structure under `~/.hermes/skills/` (`category/skill/SKILL.md`). - Skills directly under `~/.hermes/skills/` group under `uncategorized`. +## Apple (4) + +- `apple-notes` — # Apple Notes +- `apple-reminders` — # Apple Reminders +- `findmy` — # Find My (Apple) +- `imessage` — # iMessage + ## Autonomous Ai Agents (8) -- `antigravity-cli` — Operate the Antigravity CLI (agy): plugins, auth, sandbox. -- `claude-code` — Delegate coding to Claude Code CLI (features, PRs). -- `codex` — Delegate coding to OpenAI Codex CLI (features, PRs). -- `computer-use` — Drive the desktop background-first; escalate on signal. -- `hermes-agent` — Use, configure, theme, extend, and orchestrate Hermes Agent. -- `merge-reconciler` — Neutral third-party resolution of agent merge conflicts. -- `opencode` — Delegate coding to OpenCode CLI (features, PR review). -- `openhands` — Delegate coding to OpenHands CLI (model-agnostic, LiteLLM). +- `antigravity-cli` — # Antigravity CLI (`agy`) +- `claude-code` — # Claude Code — Hermes Orchestration Guide +- `codex` — # Codex CLI +- `computer-use` — # Computer Use (universal, any-model, cross-platform) +- `hermes-agent` — # Hermes Agent +- `merge-reconciler` — # Merge Reconciler +- `opencode` — # OpenCode CLI +- `openhands` — # OpenHands CLI -## Hermes (3) +## Chromadb (1) -- `hermes-personality-soulmd` — Edit and verify Hermes Agent's core personality/identity file (SOUL.md). Use when the user wants to change 'who Hermes i -- `hermes-telegram-miniapp` — Deploy and operate the standalone Hermes Telegram Mini App repo onto a Hermes Agent LXC/VM. Covers the full CT460 workfl -- `hermes-tts-configuration` — Set up Hermes TTS: providers, voice, persona, config edits. +- `chromadb` — # ChromaDB — Vector Database Operations for the Homelab -## Devops (108) +## Chromadb Preflight (1) -- `abyss-ios-pairing` — Pair an iPhone with this Hermes instance via The Abyss iOS app — Tailscale Funnel/Serve + API key + QR. Detects host OS -- `agent-extension-audit` — > -- `agent-observability` — Observability and evaluation for Hermes agent tasks: event logging, memory attribution, repair-memory tracking, failure -- `agent-stack-weekly-review` — Weekly health review for the Hermes+Mnemosyne agent stack: read-only data collection from governance, observability, Mne -- `browser-automation-recovery` — > -- `browser-backend-verification` — Verify active browser backend and CDP connectivity. -- `browser-tab-lifecycle-and-recovery` — >- -- `camofox-browser-automation` — Operate the Camofox headless browser service for authenticated scraping, periodic data extraction, and browser automatio -- `camofox-pitfalls` — Runtime pitfalls and edible fixes for the Camofox browser REST API on Anthony's homelab. Complements camofox-browser-aut -- `camoufox-remote-websocket` — Expose Camoufox as a remote Playwright WebSocket server for cross-host browser automation. Use when another agent needs -- `chat4000-ops` — Operate, diagnose, and pair the chat4000 Hermes plugin — the native iPhone/Mac app for Hermes. Covers CLI commands, devi -- `cloudflare-ops` — Operate Cloudflare services — DNS, Tunnels, R2 Object Storage (S3-compatible), API authentication, and domain management -- `codex-via-cliproxy` — Run the OpenAI Codex CLI (codex) on a machine where chatgpt.com/backend-api is geo-blocked (HTTP 451) or the stored OAut -- `crawlee-batch-scrape` — Lightweight batch URL scraping with Crawlee. Extracts markdown/text from multiple URLs in parallel. Low resource footpri -- `cron-job-maintenance` — Debug, fix, and harden Hermes cron jobs — particularly multi-step autonomous jobs where models skip or incompletely exec -- `cross-profile-session-handoff` — Continue work from a dead or stuck Hermes specialist profile in the default/supervisor profile. Covers session dump insp -- `cua-computer-use` — Set up and operate cua-driver for GUI automation on headless Linux servers. Covers virtual display setup (Xtigervnc/Xvfb -- `cua-driver-lifecycle` — Manage cua-driver processes on Hermes VMs — diagnose runaway instances, implement idle-timeout wrappers, and configure H -- `dashboard-server-ops` — Operate, extend, and troubleshoot self-hosted Python HTTP API servers serving SPAs. Covers http.server-based dashboards, -- `docker-management` — Manage Docker containers, images, volumes, and Compose. -- `external-auth-script-integration` — Fix broken script authentication by redirecting to local helper scripts, preserving module APIs during rewrites, and ver -- `external-skill-integration` — Bring external skills, standalone CLI tools, and MCP server binaries from GitHub repos into Hermes — for Hermes skills u -- `fleet-wide-failure-triage` — Triage when many components fail at once from one cause. -- `free-web-tools` — >- -- `freshrss-intelligence-filter` — Intelligence-filter upgrade for FreshRSS midday cron: clusters articles by topic, flags urgent items, adds 'why this mat -- `gcp-vertex-ai-provider` — Configure Google Cloud Vertex AI as an inference provider in the homelab – save service account credentials, test connec -- `gmail-imap-email-monitor` — Cron-friendly Gmail IMAP pattern for Hermes Agent: find new messages by UID range, parse headers robustly, detect urgenc -- `google-apis` — Google Gmail, Calendar, Drive, Docs, Sheets tools. -- `google-contacts-birthday-sync` — Sync Facebook birthdays to contacts services (Google Contacts, iCloud). Cross-references Facebook birthday data with Goo -- `hermes-agent-install` — Install, reinstall, upgrade, and diagnose Hermes Agent installations. Covers the official installer (scripts/install.sh) -- `hermes-agent-ops` — Diagnose and fix problems with Hermes Agent's OWN runtime — the web UI (port 8787), the memory-ui dashboard plugin ('Hin -- `hermes-api-vault` — Manage Hermes plugin/agent API credentials stored in a Notion vault — query the vault, map entries to ~/.hermes/.env var -- `hermes-config-diagnostics` — >- -- `hermes-cron-operations` — Operate, diagnose, and fix Hermes Agent scheduled cron jobs — list jobs, inspect configs, debug failures, manage scripts -- `hermes-cron-patterns` — Reliable cron job patterns for Hermes Agent. Covers prompt hardening, step enforcement, verification loops, subagent del -- `hermes-gateway-config-loading` — >- -- `hermes-gateway-ops` — Operate, diagnose, and troubleshoot the Hermes Agent messaging gateway — platform connections, config management, servic -- `hermes-instance-migration` — Audit one Hermes Agent instance's skills/state and port a curated subset (skills, scripts, data, cookies) to another ins -- `hermes-instance-update` — Update and verify Hermes Agent instances across the estate. -- `hermes-mattermost-integration` — Configure/troubleshoot Mattermost adapter for Hermes. -- `hermes-memory-systems` — Evaluate, configure, migrate, and troubleshoot Hermes Agent memory providers. Covers all 9 official providers (Hindsight -- `hermes-multi-agent` — Design, configure, and troubleshoot multi-agent Hermes setups using profiles, delegate_task, Kanban, and Telegram bot se -- `hermes-plugin-live-verification` — Verify Hermes plugin enablement, hook registration, live event emission, dual-write consistency, and fallback evidence p -- `hermes-plugin-ops` — Install, configure, optimize, and troubleshoot Hermes Agent plugins — covers plugin installation via CLI, provider/routi -- `hermes-profile-ops` — Audit, diagnose, and optimize Hermes agent profiles. Covers systematic inspection of config.yaml, profile.yaml, SOUL.md, -- `hermes-provider-configuration` — Configure Hermes Agent inference providers and custom OpenAI-compatible endpoints. Use when the user asks to add/switch -- `hermes-routing-and-domains` — Route requests correctly across Hermes CT460's multi-service architecture. Covers Tailscale Serve, Cloudflare Tunnel, do -- `hermes-self-diagnosis` — >- -- `hermes-soul-forge` — Operate the Soul Forge plugin — manage community souls, import profile SOUL.md files from repos, verify profile sync, an -- `hermes-web-tools` — Use the web search + content-extraction capability already installed on this Hermes instance. Covers the built-in web_ex -- `hermes-webui-ops` — Operate, restart, and verify the standalone Hermes WebUI on port 8787 (NOT the official control UI — that's on 9119). Co -- `hindsight-docs` — Complete Hindsight documentation for AI agents. Use this to learn about Hindsight architecture, APIs, configuration, and -- `hindsight-import-mnemosyne` — Import memories from a Mnemosyne SQLite DB into self-hosted Hindsight (:8888). 6,658 chunks (episodic+gists+working+fact -- `hindsight-ops` — Hindsight memory system — self-hosted LIVE on :8888 (systemd hindsight.service; OmniRoute free-IA LLM + Google/Gemini em -- `hindsight-selfhost` — Self-host Hindsight bare-metal (no Docker) + official Control Plane dashboard. hindsight-all-slim + embedded pg0 + hybri -- `homarr-dashboard-management` — Manage Homarr v1 dashboard on runtipi — multi-board setup, permissions, schema validation, PVE integration, and master b -- `homarr-dashboard-ops` — >- -- `homelab-docker-update` — Audit, update, and maintain Docker containers running inside homelab LXCs/VMs — across runtipi, bare Docker hosts, and a -- `homelab-instance-migration` — Audit and migrate a Hermes Agent instance from a source (old/bloated) box to a target (lean) box. Covers skill auditing, -- `homelab-service-management` — Deploy, update, and troubleshoot services running as Docker containers or bare-metal on Anthony's homelab Tailscale node -- `homelab-virtual-desktop` — Build, persist, expose, and debug a viewable virtual desktop (TigerVNC + websockify + Tailscale serve + systemd) on the -- `ignis-ops` — Deploy and operate Ignis browser-native Obsidian on CT460. -- `job-board-scraping-reference` — Platform-specific scraping behaviors for Australian job boards (SEEK, Indeed, LinkedIn) including access patterns, salar -- `kanban-orchestrator` — Decomposition playbook + anti-temptation rules for an orchestrator profile routing work through Kanban. The "don't do th -- `kanban-worker` — Pitfalls, examples, and edge cases for Hermes Kanban workers. The lifecycle itself is auto-injected into every worker's -- `linux-systemd-desktop` — | -- `litellm-openrouter-key-pooling` — Add additional OpenRouter API keys to a LiteLLM proxy setup as a pool, without replacing the existing key. Use when the -- `litellm-proxy-ops` — Manage a running LiteLLM proxy instance via its REST admin API — add/remove models, register new providers, update proxy -- `llm-model-diagnostics` — Diagnose LLM model quality issues: why a model feels 'dumb', responses get truncated, reasoning models return empty cont -- `mattermost-ops` — Operate, diagnose, and maintain a self-hosted Mattermost server (native or LXC). Covers plugin management, Agents plugin -- `mattermost-platform-ops` — Debug Hermes Mattermost adapter: typing, delivery, auth. -- `mcp-agent-integration` — Install and wire local stdio MCP servers (e.g. SearXNG AI Kit) into the user's coding agents — Claude Code, Goose, OpenC -- `memory-governance` — Govern durable memory writes for Hermes + Mnemosyne: audit admissions, lifecycle metadata, duplicate/contradiction check -- `mnemosyne-operations` — Operate, diagnose, and maintain Hermes Agent's native Mnemosyne memory system. Covers health checks, dream cycle consoli -- `multi-agent-git-ops` — Git push, rebase, and merge workflows for repos where multiple agents (Hermes, Nanobot, coding agents) commit. Covers Gi -- `nanobot-omniroute-skills` — Give Nanobot (CT333) access to OmniRoute's skills + tools via MCP. Approach A = add OmniRoute's streamable-HTTP MCP serv -- `nanobot-ops` — Operate, diagnose, and recover the Nanobot gateway service on Proxmox CT333 (clawtest). IP: 192.168.178.66. Access via P -- `nextcloud-ops` — Operate and recover Anthony's self-hosted Nextcloud (CT270, NextCloudPi). Covers the 503/outage diagnosis (maintenance m -- `obsidian-ops` — Operate, diagnose, and troubleshoot Anthony's Obsidian vault. For basic note read/write/search and evidence-based resear -- `omniroute-combo-troubleshooting` — Diagnose and fix OmniRoute model combos that disappear from the /v1/models catalog (and thus from the Hermes /model pick -- `omniroute-context-tuning` — > -- `omniroute-mcp-portal-cloudflare-auth` — Reference for authenticating Hermes to mcp-portal.martinwa.org/mcp via Cloudflare Access headers, plus Nando's config lo -- `omniroute-ops` — Operate, diagnose, and configure OmniRoute — Anthony's AI routing proxy. Covers database access, alias/routing diagnosti -- `omniroute-skill-caller` — Call any skill installed on the OmniRoute MCP server by NAME (e.g. "mattermost", "nanobot", "hermes-agent-framework") wi -- `omniroute-skill-execution` — Execute skills on an OmniRoute MCP server (the composure_statistic_module / omniroute endpoint). Covers the streamable-H -- `openclaw-ops` — Operate, diagnose, and configure the Open-Claw VM — Anthony's autonomous AI agent gateway node (QEMU VM 403). Covers con -- `pulse-turn-handling` — Use when Pulse turns arrive; obey its exact reply contract. -- `pve-ops` — Proxmox VE operations via REST API and SSH. Covers guest management, disk reports, diagnostics, and credential-based API -- `radar-jobs-dashboard` — Use when operating or extending the RADAR jobs dashboard. -- `readlater-ops` — Operate, deploy, and fix Anthony's self-hosted ReadLater app (Tony0410/readlater) — Next.js + SQLite in Docker on debian -- `runtipi-container-management` — Update, clean up, and troubleshoot Docker containers inside a Runtipi LXC running on a Proxmox VE host. Covers inventory -- `sdlc-review` — Review Kanban handoffs and route verified outcomes. -- `self-hosted-app-deploy` — Deploy, update, and troubleshoot self-hosted Docker applications on Tailscale-connected homelab VMs. Covers the full lif -- `solutions-first-agent-conduct` — How this agent must behave when a task hits a wall or a tool fails — lead with the attempt and the fix, not the limitati -- `tailscale-ops` — Operate and manage Tailscale configuration — Serve routes, Funnel, DNS, ACLs, and debugging. Covers adding/removing serv -- `tailscale-serve-route-management` — Manage Tailscale Serve routes on CT460 — the `--set-path` replaces-all-rules pitfall, the full route inventory, and the -- `tailscale-serve-routes` — Manage Tailscale Serve routes on CT460 atomically. Use when routes need adding, fixing, or verifying. -- `task-approach` — How the agent should approach any task given by Anthony — pre-work, skill loading, quality gates, and delivery standards -- `telegram-create-forum-topic` — Create a Telegram forum topic (thread) in a group/supergroup that has topics enabled. Wraps the Telegram Bot API's creat -- `tmux-config` — Configure and troubleshoot tmux — fix scroll/scrollback (mouse mode, history-limit, wheel bindings) and live-apply confi -- `tool-ecosystem-evaluation` — Evaluate external tools, plugins, skills, and integrations for Hermes Agent and Nanobot. Use when auditing free add-ons, -- `uber-eats-monitor` — Monitor an Uber Eats order and announce via Sonos when delivery is imminent. Supports timer-based tracking (confidence) -- `vision-model-validation` — Validate and select free vision-capable models via OmniRoute for Hermes auxiliary.vision tool. -- `watchers` — Poll RSS, JSON APIs, and GitHub with watermark dedup. -- `web-content-extraction` — >- -- `weekly-comms-tracker` — Track all weekly communications sent to Anthony to prevent repetition across weeks. SQLite-backed with content hashing f -- `wiki-maintenance` — Maintain the systems wiki for staleness and drift. -- `zeroclaw-ops` — Operate, diagnose, and configure ZeroClaw — Anthony's autonomous AI daemon on Proxmox CT333. Covers config editing (TOML +- `chromadb-preflight` — # ChromaDB Preflight — Auto-Context Integration -## Productivity (26) +## Chromadb Skills Rag (1) -- `airtable` — Airtable REST API via curl. Records CRUD, filters, upserts. -- `box` — Box manages cloud files, sharing, search, and metadata. -- `custom-pet-authoring` — Create custom animated pet spritesheets for Hermes' petdex system. Covers the pet format spec, Pillow-based spritesheet -- `document-to-action-items` — Extract cited obligations, deadlines, tasks from documents. -- `docx` — Create, read, edit, template, and review Word .docx files. -- `google-workspace` — Gmail, Calendar, Drive, Docs, Sheets via gws CLI or Python. -- `maps` — Geocode, POIs, routes, timezones via OpenStreetMap/OSRM. -- `meeting-action-items` — Turn meeting notes into cited decisions, owners, tickets. -- `nano-pdf` — Edit text in existing PDFs via natural-language prompts. -- `notion` — Notion API + ntn CLI: pages, databases, markdown, Workers. -- `notion-database-dedup` — Clean duplicates from Notion databases with quality scoring. Fetch all pages with pagination, compare by URL/company+rol -- `obsidian-git-sync` — > -- `obsidian-git-sync` — > -- `ocr-and-documents` — Extract text from PDFs/scans (pymupdf, marker-pdf). -- `pdf` — PDF files: create, read, merge, fill, OCR, edit text. -- `petdex` — Install and select animated petdex mascots for Hermes. -- `petdex-custom` — Create custom Hermes petdex pets by composing AI-generated or imported character art into spec-correct spritesheets. Com -- `powerpoint` — Create, read, edit .pptx decks with python-pptx. -- `product-price-monitor` — Watch product, flight, or listing prices; alert on target. -- `session-librarian` — Organize sessions by prompt: find, rename, archive, prune. -- `stratos-command-centre` — Run, verify, extend, and diagnose the Stratos command-centre dashboard and its backend. -- `teams-meeting-pipeline` — Teams meeting summaries, job replay, Graph subscriptions. -- `telegram-cron-table-formatting` — How to deliver tables/structured data to Telegram from a Hermes cron job (deliver='telegram') or regular chat message so -- `tui-widgets` — Author live widget apps for the Hermes TUI dock. -- `weekly-review-planning` — Weekly reset: commitments, stalled work, next-week plan. -- `xlsx` — Create, read, edit Excel .xlsx workbooks and CSVs. +- `chromadb-skills-rag` — # ChromaDB Skills RAG — Full Integration Layer + +## Clean Architecture (1) + +- `clean-architecture` — # Clean Architecture Framework + +## Clean Code (1) + +- `clean-code` — # Clean Code Framework + +## Cloudflare Tunnel Ops (1) + +- `cloudflare-tunnel-ops` — # Cloudflare Tunnel Operations 🦝🌐 ## Creative (18) -- `architecture-diagram` — Dark-themed SVG architecture/cloud/infra diagrams as HTML. -- `ascii-art` — ASCII art: pyfiglet, cowsay, boxes, image-to-ascii. -- `ascii-video` — ASCII video: convert video/audio to colored ASCII MP4/GIF. -- `baoyu-infographic` — Infographics: 21 layouts x 21 styles (信息图, 可视化). -- `claude-design` — Design one-off HTML artifacts (landing, deck, prototype). -- `comfyui` — Generate images, video, and audio via diffusion workflows. -- `creative-ideation` — Generate ideas via named methods from creative practice. -- `design-md` — Author/validate/export Google's DESIGN.md token spec files. -- `excalidraw` — Hand-drawn Excalidraw JSON diagrams (arch, flow, seq). -- `humanizer` — Humanize text: strip AI-isms and add real voice. -- `hyperframes` — Render MP4/WebM videos from HTML compositions. -- `manim-video` — Manim CE animations: 3Blue1Brown math/algo videos. -- `p5js` — p5.js sketches: gen art, shaders, interactive, 3D. -- `popular-web-designs` — 54 real design systems (Stripe, Linear, Vercel) as HTML/CSS. -- `pretext` — Build creative browser demos with DOM-free text layout. -- `sketch` — Throwaway HTML mockups: 2-3 design variants to compare. -- `songwriting-and-ai-music` — Songwriting craft and Suno AI music prompts. -- `touchdesigner-mcp` — Control TouchDesigner via twozero MCP. - -## Software Development (18) - -- `code-wiki` — Generate wiki docs + Mermaid diagrams for any codebase. -- `codebase-inspection` — Inspect codebases w/ pygount: LOC, languages, ratios. -- `coding-router` — Routes substantial software-development tasks to OpenCode CLI by default and Codex CLI as fallback, while Hermes remains -- `dogfood` — Exploratory QA of web apps: find bugs, evidence, reports. -- `github` — GitHub via gh CLI: PRs, issues, reviews, repos, auth. -- `hermes-agent-skill-authoring` — Author in-repo SKILL.md files: frontmatter and structure. -- `inspecting-hermes-desktop-dom` — Read the live Hermes desktop DOM/CSS over CDP. -- `node-inspect-debugger` — Debug Node.js via --inspect + Chrome DevTools Protocol CLI. -- `plan` — Write a markdown plan to .hermes/plans/; no execution. -- `python-debugpy` — Debug Python: pdb REPL + debugpy remote (DAP). -- `requesting-code-review` — Pre-commit review: security scan, quality gates, auto-fix. -- `rest-graphql-debug` — Debug REST/GraphQL APIs: status codes, auth, schemas, repro. -- `self-hosted-personal-dashboard` — > -- `simplify-code` — Parallel 4-agent cleanup of recent code changes. -- `spike` — Throwaway experiments to validate an idea before build. -- `subagent-driven-development` — Execute plans via delegate_task subagents (2-stage review). -- `systematic-debugging` — 4-phase root cause debugging: understand bugs before fixing. -- `test-driven-development` — TDD: enforce RED-GREEN-REFACTOR, tests before code. - -## Research (14) - -- `arxiv` — Search arXiv papers by keyword, author, category, or ID. -- `blogwatcher` — Monitor blogs and RSS/Atom feeds via blogwatcher-cli tool. -- `chat-export-parsing` — Parse chat/messaging-platform export files (Telegram MTProto message.json, WhatsApp exports, Slack/Discord JSON) into re -- `competitor-news-monitor` — Watch named companies for material news; cited digests. -- `grounded-citations` — Ground answers and documents in cited, verifiable sources. -- `llm-wiki` — Karpathy's LLM Wiki: build/query interlinked markdown KB. -- `local-dining-scene-monitor` — Monitor city restaurant openings weekly with dedup. -- `operations-wiki` — Operational wiki for personal AI agents, self-hosted infrastructure, model routing and automation. -- `polymarket` — Query Polymarket: markets, prices, orderbooks, history. -- `research-paper-writing` — Write ML papers for NeurIPS/ICML/ICLR: design→submit. -- `rss-feeds` — Read RSS, Atom, JSON feeds; discover feeds behind a page. -- `scrapling` — Scrape sites with stealth browsing and Cloudflare bypass. -- `searxng-search` — Free keyless meta-search aggregating 70+ engines. -- `wikilink-audit` — Scan and fix broken [[wikilinks]] in an Obsidian vault or markdown knowledge base. Finds orphans, broken links, and temp - -## Email (17) - -- `agent-email-patterns` — Architecture patterns for AI agents that communicate over email -- why agents need dedicated inboxes rather than human e -- `agentmail` — Give the agent its own inbox: send and receive email. -- `agentmail-check-email` — Read, search, summarize, and triage AgentMail inboxes through the connected MCP server. Use for ANY request to look at, -- `agentmail-cli` — Operate AgentMail from a shell with the official CLI. Use when the user wants commands for listing or creating inboxes, -- `agentmail-manage-inboxes` — Create, list, inspect, update, or delete AgentMail inboxes through the connected MCP server. Use for ANY inbox lifecycle -- `agentmail-mcp` — Configure or troubleshoot the hosted AgentMail MCP server for Codex, Claude Code, Cursor, or another Streamable HTTP MCP -- `agentmail-rest-fallback` — AgentMail REST API operations for reading messages and downloading attachments when MCP tools are unavailable. Covers th -- `agentmail-sdk` — Deprecated alias of the agentmail skill, kept so existing installs and pinned URLs keep resolving. Prefer installing age -- `agentmail-send-email` — Draft, send, reply to, or forward email through the connected AgentMail MCP server. Use for ANY request to send, reply t -- `agentmail-toolkit` — Add AgentMail tools to agent frameworks with the TypeScript or Python AgentMail Toolkit. Use for Vercel AI SDK, LangChai -- `cron-email-briefing` — Produce structured email briefings from a cron job using IMAP (himalaya CLI). Covers the fallback workflow when no pre-i -- `email-for-ai-agents` — Deprecated alias of the agent-email-patterns skill, kept so existing installs and pinned URLs keep resolving. Prefer ins -- `email-inbox-triage` — Triage an inbox: prioritize threads, draft replies safely. -- `gmail-readonly-fetch` — Read-only email fetching from large Gmail inboxes via himalaya CLI or Python imaplib — cron-safe, paginated, with LLM ha -- `himalaya` — Himalaya CLI: IMAP/SMTP email from terminal. -- `mail-lookup` — Use when asked about one specific email, order, or receipt. -- `realtime-email-monitor` — >- - -## Mlops (10) - -- `chroma` — Embedding database for RAG and semantic search. -- `clip` — Zero-shot image classification and image-text search. -- `evaluation` — W&B: log ML experiments, sweeps, model registry, dashboards. -- `evaluation` — lm-eval-harness: benchmark LLMs (MMLU, GSM8K, etc.). -- `huggingface-hub` — HuggingFace hf CLI: search/download/upload models, datasets. -- `inference` — llama.cpp local GGUF inference + HF Hub model discovery. -- `inference` — vLLM: high-throughput LLM serving, OpenAI API, quantization. -- `models` — AudioCraft: MusicGen text-to-music, AudioGen text-to-sound. -- `models` — SAM: zero-shot image segmentation via points, boxes, masks. -- `qdrant` — Vector search engine for production RAG systems. - -## Github (6) - -- `github-auth` — GitHub auth setup: HTTPS tokens, SSH keys, gh CLI login. -- `github-code-review` — Review PRs: diffs, inline comments via gh or REST. -- `github-issue-to-pr` — Carry a GitHub issue to a verified PR with honest CI state. -- `github-issues` — Create, triage, label, assign GitHub issues via gh or REST. -- `github-pr-workflow` — GitHub PR lifecycle: branch, commit, open, CI, merge. -- `github-repo-management` — Clone/create/fork repos; manage remotes, releases. - -## Apple (4) - -- `apple-notes` — Manage Apple Notes via memo CLI: create, search, edit. -- `apple-reminders` — Apple Reminders via remindctl: add, list, complete. -- `findmy` — Track Apple devices/AirTags via FindMy.app on macOS. -- `imessage` — Send and receive iMessages/SMS via the imsg CLI on macOS. - -## Frontend (4) - -- `design-alignment` — >- -- `impeccable` — Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, -- `landing-dashboard-reference` — > -- `pixel-perfect-iteration` — >- - -## Media (4) - -- `gif-search` — Search/download GIFs from Tenor via curl + jq. -- `heartmula` — HeartMuLa: Suno-like song generation from lyrics + tags. -- `songsee` — Audio spectrograms/features (mel, chroma, MFCC) via CLI. -- `youtube-content` — YouTube transcripts to summaries, threads, blogs. - -## Note Taking (2) - -- `obsidian-vault-from-git` — Clone, initialise, or integrate a pre-existing Obsidian vault stored on Gitea or GitHub. Covers credential retrieval, gi -- `obsidian-vault-manager` — Manage Obsidian vaults — vault discovery, git sync, .obsidian/ state files, plugin config, rename safety, and troublesho - -## Web Development (2) - -- `interactive-html-pages` — Build self-contained interactive HTML pages served from a local HTTP server. Covers single-file pages, fetching JSON fro -- `page-agent` — Embed an in-page natural-language GUI copilot in web apps. - -## Smart Home (2) - -- `openhue` — Control Philips Hue lights, scenes, rooms via OpenHue CLI. -- `sonos` — > - -## Mcp (2) - -- `fastmcp` — Build, test, and deploy Python MCP servers. -- `mcporter` — List, auth, and call MCP servers/tools from the terminal. - -## Uncategorized (46) - -- `chromadb` — >- -- `chromadb-preflight` — > -- `chromadb-skills-rag` — > -- `clean-architecture` — Structure software around the Dependency Rule: source code dependencies point inward from frameworks to use cases to ent -- `clean-code` — Write readable, maintainable code through disciplined naming, small functions, and clean error handling. Use when the us -- `cloudflare-tunnel-ops` — Operate Cloudflare Tunnels to expose internal services through public domains, bypassing network restrictions (e.g. work -- `cron-model-repair` — Repair cron jobs with dead model/provider pins. -- `ddia-systems` — Design data systems by understanding storage engines, replication, partitioning, transactions, and consistency models. U -- `devops` -- `devops-homelab-architecture-live-probe` — Build an accurate homelab architecture diagram by probing live infrastructure first, especially Proxmox VE and Tailscale -- `devops-proxmox-operations` — Use when operating Proxmox VE hosts, LXCs, VMs, storage, API tokens, noVNC consoles, DNS/hosts overrides, offline disk e -- `devops-service-management` — Umbrella for miscellaneous service operations skills — event logistics automation, Tailscale Serve, virtual desktop/X11, -- `devops-tailscale-web-routing` — Use when deploying or repairing self-hosted web apps behind Tailscale Serve/Funnel, especially path-prefix routing, stat -- `devops-telegram-bot-api-self-hosted` — | -- `domain-driven-design` — Model software around the business domain using bounded contexts, aggregates, and ubiquitous language. Use when the user -- `email-himalaya` — Himalaya CLI: IMAP/SMTP email from terminal. Covers configuration, cron automation, urgency assessment, and Gmail quirks -- `groktocrawl-deployment` — Self-hosted deployment guide for GroktoCrawl as a Firecrawl v2 replacement — resource requirements, port configuration, -- `hermes-api-vault` — Manage Hermes plugin/agent API credentials stored in a Notion vault — query the vault, map entries to ~/.hermes/.env var -- `hermes-desktop-plugins` — Write desktop app plugins that add UI panes and commands. -- `hermes-gateway-troubleshooting` — Gateway process management, MCP fleet debugging, post-migration verification, and config hardening for Hermes Agent LXC/ -- `hermes-mcp-troubleshooting` — Diagnose and fix Hermes Agent MCP server connection issues, config corruption, startup banner false negatives, and relat -- `hermes-themes` — Author a Hermes color theme that skins every surface. -- `interactive-reference-pages` — Build clean, mobile-first, interactive HTML reference and checklist pages with proper dark-theme contrast, localStorage -- `ios-hig-design` — Design native iOS interfaces following Apple Human Interface Guidelines. Use when the user mentions "iPhone app", "iPad -- `job-hunting` — Comprehensive career transition coaching — research the user's background, discover opportunities, automate daily job-ra -- `job-hunting-assistance` — End-to-end job hunting support for a professional: research the user's background from available sources, locate existin -- `job-search-automation` — Operate, debug, and extend an autonomous job-board scraping pipeline (cron -> web_search_plus/web_extract_plus -> Camofo -- `job-tracker-enrichment` — Maintain and enrich Anthony's Notion "Job Opportunities 2026" Perth marketing/communications job tracker. Covers the bro -- `litprog` -- `markdown-to-anywhere` — On-demand cross-posting service: Anthony tells me to post a .md file to a platform, I format it appropriately and delive -- `officecli` — Create, analyze, proofread, and modify Office documents (.docx, .xlsx, .pptx) using the officecli CLI tool. Use when the -- `pragmatic-programmer` — Apply meta-principles of software craftsmanship: DRY, orthogonality, tracer bullets, and design by contract. Use when th -- `proxmox-operations` — Use when operating Proxmox VE hosts, LXCs, VMs, storage, API tokens, noVNC consoles, DNS/hosts overrides, offline disk e -- `refactoring-patterns` — Apply named refactoring transformations to improve code structure without changing behavior. Use when the user mentions -- `refactoring-ui` — Audit and fix visual hierarchy, spacing, color, and depth in web UIs. Use when the user mentions "my UI looks off" (or a -- `restaurant-menu-extraction` — Extract structured menu data (items, prices, ratings, delivery info) from food delivery sites like Uber Eats using Camof -- `software-design-philosophy` — Manage software complexity through deep modules, information hiding, and strategic programming. Use when the user mentio -- `system-design` — Design scalable distributed systems using structured approaches for load balancing, caching, database scaling, and messa -- `tailscale-serve-ops` — Operate Tailscale Serve to expose local web content through the tailnet. Covers route setup, backend management, path-pr -- `tech-ai-newsletter-digest` — Process and analyze tech/AI newsletter emails from Anthony's inbox using `himalaya` CLI, synthesizing key stories into s -- `ux-heuristics` — Evaluate and improve interface usability using heuristic analysis. Use when the user mentions "usability audit", "users -- `web-design-reviewer` — This skill enables visual inspection of websites running locally or remotely to identify and fix design issues. Triggers -- `web-typography` — Select, pair, and implement typefaces for web projects. Use when the user mentions "font pairing", "which typeface", "li -- `weekly-review` — Sunday 18:00 AWST cron that compiles a weekly review: job application stats from Notion, cron health from SQLite executi -- `working-with-legacy-code` — Safely change and test untested codebases using Feathers'' "Working Effectively with Legacy Code". Use when the user men -- `yuanbao` — Yuanbao (元宝) groups: @mention users, query info/members. - -## .Archive (46) - -- `agentmail-webhook-tailscale` — Real-time AgentMail webhooks via Tailscale funnel push. -- `anthropic-spend-forensics` — Use when unexplained Anthropic spend needs attribution. -- `briefing-visualization` — Research text → HTML briefing + PPTX deck. -- `container-cpu-forensics` — Find idle-CPU vampires: cgroup truth, crash loops. -- `cookie-jar-import` — Import browser cookies into Camofox for auth sessions. -- `courier-tracking-monitor` — Monitor a package/shipment; alert on change or delivery. -- `cover-letter-generation` — Draft, render, and deliver styled cover letters for Anthony's job applications. Covers content, format selection, PDF/DO -- `cron-prompt-service-integration` — Authed-API cron prompts: wrap calls in helper scripts. -- `cronjob-prompt-hardening` — Use when hardening cronjob prompts against fabrication. -- `cua-driver-linux-accessibility` — Fix AT-SPI bridge when computer_use returns 0x0 on Linux. -- `custom-dashboard-ops` — Operate or deploy the custom-dashboard on CT201. -- `data-share-to-ai-artefact` — Turn a file-share of KPI CSVs into one labelled xlsx for AI. -- `decision-briefing-dashboards` — Use when advice needs an offline decision dashboard. -- `employment-forms` — Fill out Anthony's employment and onboarding forms. -- `guanaco-ops` — Operate Guanaco LLM proxy on CT205. -- `hermes-config-backup` — Use when Hermes' Gitea config backup is stale or missing. -- `hermes-multiplex-telegram-ops` — Diagnose Hermes profile Telegram silence under multiplex. -- `hermes-profile-scoped-platform-troubleshooting` — Repair platform adapter mismatches across Hermes profiles. -- `hermes-runtime-worker-diagnostics` — Use when many cron jobs fail at once, before job logic. -- `hermes-session-context-ops` — Use when Hermes desktop chats lose or blend context. -- `hermes-ui-ops` — Operate Hermes desktop UI — Vite, HTTPS, mic, systemd. -- `hermes-web-backend-config` — Fix web_search backend selection and Tavily quota fallback. -- `homelab-migration-planning` — Plan homelab service migrations across Proxmox hosts. -- `in-repo-documentation` — Use for README and in-repository wiki documentation. -- `jobs-dashboard-server-ops` — Operate, debug, and extend the Notion-sourced job tracker dashboard (port 9099). Covers API routes, cover letter serving -- `live-application-verification` — Use when verifying a web change reaches the user's live app. -- `llm-proxy-streaming` — Use when an agent surfaces raw SSE chunks as errors. -- `media-download-ops` — Operate homelab torrent clients via Web API. -- `model-provider-comparison-research` — Use when comparing models inside an agent harness. -- `multi-agent-estate-knowledge` — Use for shared docs across multiple agent instances. -- `pre-flight-investigation` — Check the target and this box before installing anything. -- `pve-lxc-intrusion-detection` — Detect cryptominers on a Proxmox LXC via pct exec. -- `pve-vm-console-recovery` — Recover a stuck Proxmox VM by injecting console keystrokes. -- `qwenpaw-agent-operations` — Troubleshoot QwenPaw agents and model routing. -- `rclone-mount-ops` — Fix rclone FUSE mount recursion and CPU issues on PVE. -- `security-incident-response` — Investigate and remediate homelab security incidents. -- `self-hosted-dashboard-deployment-verification` — Use when verifying dashboard deployments. -- `session-verification` — Verify session claims — check DB, not memory. -- `simple-directives-execution` — Execute now when told 'just do X' — no investigation. -- `social-web-sentiment-research` — Use for current social/web sentiment scans. -- `soul-md-design` — Research SOUL.md patterns for structured agent personas. -- `tailnet-service-outage-triage` — Triage tailnet service-down alerts without PVE SSH. -- `tailscale-cert-for-docker-https` — Fix tailnet HTTPS cert errors with trusted Tailscale certs. -- `versioning-live-services` — Use when versioning a live service dir into a private repo. -- `video-translation-dubbing` — Translate and dub video audio to another language. -- `wiki-web-hosting` — Publish Markdown wikis as Quartz sites over Tailscale. - -## Finance (2) - -- `3-statement-model` — Build integrated IS/BS/CF financial workbooks in Excel. -- `australian-tax-return-review` — Review an Australian tax return against source records. - -## Social Media (2) - -- `reddit-reading` — Read Reddit: subreddits, search, threads, users. No browser. -- `xurl` — X/Twitter via xurl CLI: raw post search, posting, DM, media. +- `architecture-diagram` — # Architecture Diagram Skill +- `ascii-art` — # ASCII Art Skill +- `ascii-video` — # ASCII Video Production Pipeline +- `baoyu-infographic` — # Infographic Generator +- `claude-design` — # Claude Design for CLI/API Agents +- `comfyui` — # ComfyUI +- `creative-ideation` — # Creative Ideation +- `design-md` — # DESIGN.md Skill +- `excalidraw` — # Excalidraw Diagram Skill +- `humanizer` — # Humanizer: Remove AI Writing Patterns +- `hyperframes` — # HyperFrames +- `manim-video` — # Manim Video Production Pipeline +- `p5js` — # p5.js Production Pipeline +- `popular-web-designs` — # Popular Web Designs +- `pretext` — # Pretext Creative Demos +- `sketch` — # Sketch +- `songwriting-and-ai-music` — # Songwriting & AI Music Generation +- `touchdesigner-mcp` — # TouchDesigner Integration (twozero MCP) ## Cron (1) -- `cron-digest-formatting` — Use when formatting cron Telegram news digests for Anthony. +- `cron-digest-formatting` — # Cron Digest Formatting (Telegram) + +## Cron Model Repair (1) + +- `cron-model-repair` — # Cron Model-Pin Repair ## Data Science (1) -- `jupyter-live-kernel` — Iterative Python via live Jupyter kernel (hamelnb). +- `jupyter-live-kernel` — # Jupyter Live Kernel (hamelnb) -## Job Hunting (1) +## Ddia Systems (1) -- `seek-extraction-patterns` — Extract salary, closing dates, and job details from SEEK (au.seek.com) listings at scale. Use when enriching a batch of +- `ddia-systems` — # Designing Data-Intensive Applications Framework + +## Devops (109) + +- `abyss-ios-pairing` — # Pair iPhone with The Abyss (iOS) +- `agent-extension-audit` — # Agent Extension Audit +- `agent-observability` — # Agent Observability +- `agent-stack-weekly-review` — # Agent Stack Weekly Review +- `browser-automation-recovery` — # Browser Automation Recovery +- `browser-backend-verification` — # Browser Backend Verification +- `browser-tab-lifecycle-and-recovery` — # Browser Tab Lifecycle & Recovery +- `camofox-browser-automation` — # Camofox Browser Automation +- `camofox-pitfalls` — # Camofox Pitfalls +- `camoufox-remote-websocket` — # Camoufox Remote WebSocket Access +- `chat4000-ops` — # chat4000 Operations & Pairing +- `cloudflare-ops` — # Cloudflare Operations +- `codex-via-cliproxy` — # Codex CLI via Cliproxy (mitmproxy redirect) +- `crawlee-batch-scrape` — ## Installation +- `cron-job-maintenance` — ## Mnemosyne Watchdog Cron Job — Conflict Alert Thresholds (2026-07-25) +- `cross-profile-session-handoff` — # Cross-Profile Session Handoff +- `cua-computer-use` — # CUA Computer Use Automation +- `cua-driver-lifecycle` — # cua-driver Lifecycle Management +- `dashboard-server-ops` — # Dashboard Server Operations +- `devops` — (no description) +- `docker-management` — # Docker Management +- `external-auth-script-integration` — # External Auth Script Integration +- `external-skill-integration` — # External Skill Integration +- `fleet-wide-failure-triage` — # Fleet-Wide Failure Triage +- `free-web-tools` — # Free Web Search & Extract +- `freshrss-intelligence-filter` — # FreshRSS Intelligence Filter +- `gcp-vertex-ai-provider` — # GCP Vertex AI Provider +- `gmail-imap-email-monitor` — # Gmail IMAP Email Monitor (Cron) +- `google-apis` — # Google APIs Tool Suite +- `google-contacts-birthday-sync` — > **See also:** +- `hermes-agent-install` — # Hermes Agent Install & Upgrade +- `hermes-agent-ops` — ### Dashboard Auth Plugin — `basic` Must Be Enabled +- `hermes-api-vault` — # Hermes API Vault +- `hermes-config-diagnostics` — # Hermes Config Diagnostics +- `hermes-cron-operations` — # Hermes Cron Operations +- `hermes-cron-patterns` — ## Reference Files +- `hermes-gateway-config-loading` — # Hermes Gateway Config Loading Pipeline +- `hermes-gateway-ops` — # Hermes Gateway Operations & Platform Debugging +- `hermes-instance-migration` — # Hermes Instance Migration (audit + curated port) +- `hermes-instance-update` — # Hermes Instance Update Operations +- `hermes-mattermost-integration` — # Hermes Mattermost Integration +- `hermes-memory-systems` — # Hermes Agent Memory Systems +- `hermes-multi-agent` — # Hermes Multi-Agent Architecture +- `hermes-plugin-live-verification` — # Hermes Plugin Live Verification +- `hermes-plugin-ops` — ### Session Learnings (2026-07-07) +- `hermes-profile-ops` — # Hermes Profile Operations +- `hermes-provider-configuration` — # Hermes Provider Configuration +- `hermes-routing-and-domains` — # Hermes Routing & Domains +- `hermes-self-diagnosis` — # Hermes Self-Diagnosis +- `hermes-soul-forge` — # Soul Forge Plugin Operations +- `hermes-web-tools` — # Hermes Web Tools (this instance) +- `hermes-webui-ops` — # Hermes WebUI Operations +- `hindsight-docs` — # Hindsight Documentation Skill +- `hindsight-import-mnemosyne` — # Import Mnemosyne → Hindsight +- `hindsight-ops` — # Hindsight Operations & Diagnostics +- `hindsight-selfhost` — # Self-Host Hindsight (bare-metal) + Official Control Plane +- `homarr-dashboard-management` — # Homarr Dashboard Management (v1 on runtipi) +- `homarr-dashboard-ops` — # Homarr Dashboard Operations +- `homelab-docker-update` — # Homelab Docker Update +- `homelab-instance-migration` — # Homelab Instance Migration +- `homelab-service-management` — # Homelab Service Management +- `homelab-virtual-desktop` — # Homelab Virtual Desktop (for computer-use) +- `ignis-ops` — # Ignis Deployment & Operations +- `job-board-scraping-reference` — # Job Board Scraping Reference +- `kanban-orchestrator` — # Kanban Orchestrator — Decomposition Playbook +- `kanban-worker` — # Kanban Worker — Pitfalls and Examples +- `linux-systemd-desktop` — # Linux headless desktop as a systemd user service +- `litellm-openrouter-key-pooling` — # LiteLLM OpenRouter Key Pooling +- `litellm-proxy-ops` — # LiteLLM Proxy Operations +- `llm-model-diagnostics` — # LLM Model Diagnostics +- `mattermost-ops` — # Mattermost Operations 🦝📡 +- `mattermost-platform-ops` — # Mattermost Platform Operations +- `mcp-agent-integration` — # MCP Agent Integration +- `memory-governance` — # Memory Governance +- `mnemosyne-operations` — # Mnemosyne Operations & Diagnostics +- `multi-agent-git-ops` — # Multi-Agent Git Operations +- `nanobot-omniroute-skills` — # Nanobot ↔ OmniRoute Skills Integration +- `nanobot-ops` — > **Session detail / full diagnostic transcript:** see `references/nanobot-webui-auth-and-404-recovery.md` (covers the v0.2.x 404 root cause, the `tokenIssueSecret`-vs-`token` password trap, port m... +- `nextcloud-ops` — # Nextcloud Ops (CT270) +- `obsidian-ops` — \n# Obsidian Vault Operations\n\nAnthony's Obsidian vault at `/home/hermes/obsidian-vault`, git-synced to Gitea via `obsidian-git` plugin (auto-sync every 5 min).\n\n## Vault Sync Scripts\n\nTwo au... +- `omniroute-combo-troubleshooting` — # OmniRoute Combo Troubleshooting +- `omniroute-context-tuning` — # OmniRoute Context Window Tuning +- `omniroute-mcp-portal-cloudflare-auth` — # Cloudflare Access Auth for mcp-portal.martinwa.org/mcp +- `omniroute-ops` — # OmniRoute Operations & Diagnostics +- `omniroute-skill-caller` — # Call an OmniRoute Skill by Name (auto-resolving wrapper) +- `omniroute-skill-execution` — # Execute Skills on OmniRoute MCP +- `openclaw-ops` — # Open-Claw Operations & Configuration +- `pulse-turn-handling` — # Pulse Turn Handling +- `pve-ops` — # PVE Operations +- `radar-jobs-dashboard` — # RADAR Jobs Dashboard +- `readlater-ops` — # ReadLater Operations +- `runtipi-container-management` — # Runtipi Container Management +- `sdlc-review` — # SDLC Review Skill +- `self-hosted-app-deploy` — # Self-Hosted App Deployment +- `solutions-first-agent-conduct` — # Solutions-First Agent Conduct +- `tailscale-ops` — # Tailscale Operations 🦝🔗 +- `tailscale-serve-route-management` — # Tailscale Serve Route Management +- `tailscale-serve-routes` — # Tailscale Serve Route Management +- `task-approach` — # Task Approach +- `telegram-create-forum-topic` — # Telegram Create Forum Topic Skill +- `tmux-config` — # tmux-config +- `tool-ecosystem-evaluation` — # Tool Ecosystem Evaluation +- `uber-eats-monitor` — # Uber Eats Order Monitor +- `vision-model-validation` — # Vision Model Validation via OmniRoute +- `watchers` — # Watchers +- `web-content-extraction` — # Web Content Extraction — Fallback Techniques +- `weekly-comms-tracker` — # Weekly Communications Tracker +- `wiki-maintenance` — # Wiki Maintenance +- `zeroclaw-ops` — # ZeroClaw Operations & Configuration + +## Devops Homelab Architecture Live Probe (1) + +- `devops-homelab-architecture-live-probe` — # Homelab Architecture Live Probe + +## Devops Proxmox Operations (1) + +- `devops-proxmox-operations` — # Proxmox Operations + +## Devops Service Management (1) + +- `devops-service-management` — # Service Operations Umbrella + +## Devops Tailscale Web Routing (1) + +- `devops-tailscale-web-routing` — # Tailscale Web Routing + +## Devops Telegram Bot Api Self Hosted (1) + +- `devops-telegram-bot-api-self-hosted` — # Self-Hosted Telegram Bot API Server + +## Domain Driven Design (1) + +- `domain-driven-design` — # Domain-Driven Design Framework + +## Email (17) + +- `agent-email-patterns` — # Agent Email Patterns +- `agentmail` — # AgentMail — Agent-Owned Email Inboxes +- `agentmail-check-email` — # Check Email +- `agentmail-cli` — # AgentMail CLI +- `agentmail-manage-inboxes` — # Manage Inboxes +- `agentmail-mcp` — # AgentMail MCP +- `agentmail-rest-fallback` — # AgentMail REST API Fallback +- `agentmail-sdk` — # AgentMail SDK +- `agentmail-send-email` — # Send Email +- `agentmail-toolkit` — # AgentMail Toolkit +- `cron-email-briefing` — # Cron Email Briefing Workflow +- `email-for-ai-agents` — # Agent Email Patterns +- `email-inbox-triage` — # Email Inbox Triage +- `gmail-readonly-fetch` — # Gmail Read-Only Fetch (Large Inbox) +- `himalaya` — # Himalaya Email CLI +- `mail-lookup` — # Ad-Hoc Mail Lookup +- `realtime-email-monitor` — # Real-time Email Monitor (IMAP IDLE) + +## Email Himalaya (1) + +- `email-himalaya` — # Himalaya Email CLI + +## Finance (2) + +- `3-statement-model` — ## Environment +- `australian-tax-return-review` — # Australian Tax Return Review + +## Frontend (4) + +- `design-alignment` — # Design Alignment +- `impeccable` — Designs and iterates production-grade frontend interfaces. Real working code, committed design choices, exceptional craft. +- `landing-dashboard-reference` — # Landing Page & Dashboard Design Reference +- `pixel-perfect-iteration` — # Pixel-Perfect Visual Iteration + +## Github (6) + +- `github-auth` — # GitHub Authentication Setup +- `github-code-review` — # GitHub Code Review +- `github-issue-to-pr` — # GitHub Issue to Pull Request +- `github-issues` — # GitHub Issues Management +- `github-pr-workflow` — # GitHub Pull Request Workflow +- `github-repo-management` — # GitHub Repository Management + +## Groktocrawl Deployment (1) + +- `groktocrawl-deployment` — # GroktoCrawl Self-Hosted Deployment + +## Hermes (3) + +- `hermes-personality-soulmd` — # Hermes Personality & SOUL.md +- `hermes-telegram-miniapp` — # Hermes Telegram Mini App — Deploy & Operate +- `hermes-tts-configuration` — # Hermes TTS & Voice Configuration + +## Hermes Api Vault (1) + +- `hermes-api-vault` — # Hermes API Vault + +## Hermes Desktop Plugins (1) + +- `hermes-desktop-plugins` — # Hermes Desktop Plugins Skill + +## Hermes Gateway Troubleshooting (1) + +- `hermes-gateway-troubleshooting` — # Hermes Gateway Troubleshooting & Migration Verification + +## Hermes Mcp Troubleshooting (1) + +- `hermes-mcp-troubleshooting` — # Hermes MCP Troubleshooting + +## Hermes Themes (1) + +- `hermes-themes` — # Hermes Themes Skill + +## Interactive Reference Pages (1) + +- `interactive-reference-pages` — # Interactive Reference Pages + +## Ios Hig Design (1) + +- `ios-hig-design` — # iOS Human Interface Guidelines Design Skill + +## Job Hunting (2) + +- `job-hunting` — # Job Hunting & Career Transition Coaching +- `seek-extraction-patterns` — # SEEK Extraction Patterns + +## Job Hunting Assistance (1) + +- `job-hunting-assistance` — # Job Hunting Assistance + +## Job Search Automation (1) + +- `job-search-automation` — # Job Search Automation + +## Job Tracker Enrichment (1) + +- `job-tracker-enrichment` — # Job Tracker Enrichment (Anthony — Perth Marketing) + +## Litprog (1) + +- `litprog` — # Literate Programming + +## Markdown To Anywhere (1) + +- `markdown-to-anywhere` — # Markdown to Anywhere + +## Mcp (2) + +- `fastmcp` — # FastMCP +- `mcporter` — # mcporter + +## Media (4) + +- `gif-search` — # GIF Search (Tenor API) +- `heartmula` — # HeartMuLa - Open-Source Music Generation +- `songsee` — # songsee +- `youtube-content` — # YouTube Content Tool + +## Mlops (10) + +- `audiocraft` — # AudioCraft: Audio Generation +- `chroma` — # Chroma - Open-Source Embedding Database +- `clip` — # CLIP - Contrastive Language-Image Pre-Training +- `evaluating-llms-harness` — # lm-evaluation-harness - LLM Benchmarking +- `huggingface-hub` — # Hugging Face CLI (`hf`) Reference Guide +- `llama-cpp` — # llama.cpp + GGUF +- `qdrant` — # Qdrant - Vector Similarity Search Engine +- `segment-anything` — # Segment Anything Model (SAM) +- `serving-llms-vllm` — # vLLM - High-Performance LLM Serving +- `weights-and-biases` — # Weights & Biases: ML Experiment Tracking & MLOps + +## Note Taking (2) + +- `obsidian-vault-from-git` — ## Obsidian Vault from Git +- `obsidian-vault-manager` — # Obsidian Vault Manager + +## Officecli (1) + +- `officecli` — # officecli ## Omniroute (1) -- `omniroute-skills` — Interact with OmniRoute's Skills framework — list, install, enable, execute, and debug skills via REST API and MCP tools +- `omniroute-skills` — # OmniRoute Skills + +## Pragmatic Programmer (1) + +- `pragmatic-programmer` — # The Pragmatic Programmer Framework + +## Productivity (25) + +- `airtable` — # Airtable — Bases, Tables & Records +- `box` — # Box +- `custom-pet-authoring` — # Custom Pet Authoring +- `document-to-action-items` — # Document to Action Items +- `docx` — # Docx Skill +- `google-workspace` — # Google Workspace +- `maps` — # Maps Skill +- `meeting-action-items` — # Meeting Action Items +- `nano-pdf` — # nano-pdf +- `notion` — # Notion +- `notion-database-dedup` — # Notion Database Dedup +- `obsidian-git-sync` — # Obsidian Git Sync Workflow +- `ocr-and-documents` — # PDF & Document Extraction +- `pdf` — # PDF Skill +- `petdex` — # Petdex Skill +- `petdex-custom` — # Petdex Custom Pets +- `powerpoint` — # Powerpoint Skill +- `product-price-monitor` — # Product Price Monitor +- `session-librarian` — # Session Librarian +- `stratos-command-centre` — # Stratos — Command Centre +- `teams-meeting-pipeline` — # Teams Meeting Pipeline +- `telegram-cron-table-formatting` — # Telegram Table Formatting (Hermes) +- `tui-widgets` — # TUI Widgets Skill +- `weekly-review-planning` — # Weekly Review and Planning +- `xlsx` — # Xlsx Skill + +## Proxmox Operations (1) + +- `proxmox-operations` — # Proxmox Operations + +## Refactoring Patterns (1) + +- `refactoring-patterns` — # Refactoring Patterns Framework + +## Refactoring Ui (1) + +- `refactoring-ui` — # Refactoring UI Design System + +## Research (14) + +- `arxiv` — # arXiv Research +- `blogwatcher` — # Blogwatcher +- `chat-export-parsing` — # Chat Export Parsing +- `competitor-news-monitor` — # Competitor News Monitor +- `grounded-citations` — # Grounded Citations +- `llm-wiki` — # Karpathy's LLM Wiki +- `local-dining-scene-monitor` — # Local Dining Scene Monitor +- `operations-wiki` — # Operations Wiki +- `polymarket` — # Polymarket — Prediction Market Data +- `research-paper-writing` — # Research Paper Writing Pipeline +- `rss-feeds` — # RSS Feeds Skill +- `scrapling` — # Scrapling +- `searxng-search` — # SearXNG Search +- `wikilink-audit` — # Wikilink Auditor + +## Restaurant Menu Extraction (1) + +- `restaurant-menu-extraction` — # Restaurant Menu Extraction + +## Smart Home (2) + +- `openhue` — # OpenHue CLI +- `sonos` — # Sonos Skill + +## Social Media (2) + +- `reddit-reading` — # Reddit Reading Skill +- `xurl` — # xurl — X (Twitter) API via the Official CLI + +## Software Design Philosophy (1) + +- `software-design-philosophy` — # A Philosophy of Software Design Framework + +## Software Development (18) + +- `code-wiki` — # Code Wiki Skill +- `codebase-inspection` — # Codebase Inspection with pygount +- `coding-router` — # Coding Router +- `dogfood` — # Dogfood: Systematic Web Application QA Testing +- `github` — # GitHub +- `hermes-agent-skill-authoring` — # Authoring Hermes-Agent Skills (in-repo) +- `inspecting-hermes-desktop-dom` — # Inspecting the live Hermes desktop DOM +- `node-inspect-debugger` — # Node.js Inspect Debugger +- `plan` — # Plan Mode +- `python-debugpy` — # Python Debugger (pdb + debugpy) +- `requesting-code-review` — # Pre-Commit Code Verification +- `rest-graphql-debug` — # API Testing & Debugging +- `self-hosted-personal-dashboard` — # Self-Hosted Personal Dashboard +- `simplify-code` — # Simplify Code — Parallel Review & Cleanup +- `spike` — # Spike +- `subagent-driven-development` — # Subagent-Driven Development +- `systematic-debugging` — # Systematic Debugging +- `test-driven-development` — # Test-Driven Development (TDD) + +## System Design (1) + +- `system-design` — # System Design Framework + +## Tailscale Serve Ops (1) + +- `tailscale-serve-ops` — # Tailscale Serve Ops 🦝🔗 + +## Tech Ai Newsletter Digest (1) + +- `tech-ai-newsletter-digest` — # Tech & AI Newsletter Digest Skill + +## Ux Heuristics (1) + +- `ux-heuristics` — # UX Heuristics Framework ## Web (1) -- `blocked-page-recovery` — Use when a fetch fails: 403/429, paywall, WAF, bot wall. +- `blocked-page-recovery` — # Blocked-Page Recovery -## Related -- [[systems/hermes-agent]] -- [[systems/omniroute]] +## Web Design Reviewer (1) + +- `web-design-reviewer` — # Web Design Reviewer + +## Web Development (2) + +- `interactive-html-pages` — # Interactive HTML Pages +- `page-agent` — # page-agent + +## Web Typography (1) + +- `web-typography` — # Web Typography + +## Weekly Review (1) + +- `weekly-review` — # Weekly Review + +## Working With Legacy Code (1) + +- `working-with-legacy-code` — # Working Effectively with Legacy Code + +## Yuanbao (1) + +- `yuanbao` — # Yuanbao Group Interaction diff --git a/wiki-maintain.sh b/wiki-maintain.sh index 0390db8..0d79ef5 100755 --- a/wiki-maintain.sh +++ b/wiki-maintain.sh @@ -15,6 +15,13 @@ STOCKTAKE_DIR="$WIKI_DIR/raw/stocktake" QUARTZ_CONTENT_DIR="$WIKI_DIR/public" TODAY=$(date +%Y%m%d) +# --no-build: regenerate content + run the freshness audit, but skip the +# Quartz build/deploy. Supported so that the delegating wrapper at +# ~/.hermes/scripts/wiki-maintain.sh can honour the interface its callers +# were written against without carrying a second copy of the generator. +NO_BUILD=false +[[ "${1:-}" == "--no-build" ]] && NO_BUILD=true + cd "$WIKI_DIR" echo "[wiki-maintain] Starting maintenance at $(date -Iseconds)" @@ -166,6 +173,14 @@ echo "" # config-file existence test that isn't the real one: check quartz.config.yaml. echo "[3/3] Rebuilding Quartz static site..." +if $NO_BUILD; then + echo " --no-build: skipping Quartz build and deploy (content + freshness report already written)" + echo "" + echo "[wiki-maintain] Maintenance complete at $(date -Iseconds) (no-build)" + echo " Freshness report: $REPORT" + exit 0 +fi + QUARTZ_DIR="/home/hermes/workspace/quartz-temp" QUARTZ_CONTENT="$QUARTZ_DIR/content" QUARTZ_PUBLIC="$QUARTZ_DIR/public"