@astrofoundry/pi-astro 0.20.1 → 0.20.3

package/extensions/astro-subagents/agents.test.ts

@@ -1,4 +1,4 @@
-import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
@@ -107,3 +107,16 @@ describe("discovery", () => {
         expect(missing).toEqual(["nope"]);
     });
 });
+
+describe("bundled agent files", () => {
+    it("every agents/*.md parses and declares a specialist-safe front matter", () => {
+        const dir = join(import.meta.dirname, "..", "..", "agents");
+        const files = readdirSync(dir).filter((f) => f.endsWith(".md"));
+        expect(files.length).toBeGreaterThan(0);
+        for (const file of files) {
+            const agent = parseAgentFile(readFileSync(join(dir, file), "utf-8"), join(dir, file), "bundled");
+            expect(agent, file).not.toBeNull();
+            expect(agent?.name, file).toBe(`astro.${file.replace(/\.md$/, "")}`);
+        }
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrofoundry/pi-astro",
-  "version": "0.20.1",
+  "version": "0.20.3",
   "description": "Personal pi customizations (extensions, subagents, skills, prompts, themes) for the pi coding agent.",
   "keywords": [
     "pi-package"

package/skills/inference/SKILL.md

@@ -31,13 +31,14 @@ A model load after restart takes up to a minute; `health=503` during that time i
 | `hermes-api-health` | `/health` (expect 200) and `/v1/models` (expect 401: the endpoint is up and requires the backend key) |
 | `hermes-version` | installed version |
 | `hermes-guest-status`, `hermes-snapshots` | LXC 101 state and snapshots (Pulsar) |
-| `hermes-releases [n]` | upstream releases of `NousResearch/hermes-agent` with notes |
+| `hermes-releases [n]` | upstream releases of `NousResearch/hermes-agent`, notes cut at 6000 characters |
+| `hermes-release <tag>` | one release with its complete notes |
 | `hermes-upgrade --confirm` | Pulsar wrapper: snapshot `preupgrade<timestamp>`, `hermes update`, `hermes config migrate`, restart both gateways, wait for a Discord connection and API 401, keep the two newest snapshots |
 
 ## Hermes upgrade procedure
 
 1. `hermes-version` and `hermes-releases 10`.
-2. Read every release from the installed version up to the target. Stop and report when a note mentions a manual step, a configuration change beyond `hermes config migrate`, a breaking change, a new Python or system dependency, or a required intermediate version. Quote the sentence.
+2. Read every release from the installed version up to the target; use `hermes-release <tag>` for any note the list cut off. Stop and report when a note mentions a manual step, a configuration change beyond `hermes config migrate`, a breaking change, a new Python or system dependency, or a required intermediate version. Quote the sentence.
 3. `hermes-status` and `hermes-api-health` must be healthy before the upgrade; `hermes-snapshots` shows the existing snapshots.
 4. `hermes-upgrade --confirm` (up to 20 minutes). The wrapper prints the rollback command when a step fails; repeat it verbatim in your report and do not roll back yourself.
 5. `hermes-version`, `hermes-status`, `hermes-api-health`. Report old and new version, the snapshot name, and the health results.

package/specialists/entry/remote/spc-inference-nexus-entry.sh

@@ -14,7 +14,7 @@ port() { case "$1" in embed) echo 8081 ;; rerank) echo 8082 ;; esac; }
 agent_state() {
   l="$(label "$1")"
   printf '%-8s ' "$1"
-  launchctl print "gui/$uid/$l" 2>/dev/null | grep -E '^\s*(state|pid) = ' | tr -s ' ' | tr '\n' ' ' || printf 'not loaded '
+  launchctl print "gui/$uid/$l" 2>/dev/null | grep -E '^[[:space:]](state|pid) = ' | tr -s ' ' | tr '\n' ' ' || printf 'not loaded '
   printf 'health=%s\n' "$(curl -s -o /dev/null -w '%{http_code}' -m 5 "http://127.0.0.1:$(port "$1")/health" || echo 000)"
 }
 

package/specialists/inference/run.ts

@@ -75,7 +75,8 @@ ${Object.entries(INFERENCE_COMMANDS)
     .map(([name, c]) => `      ${name.padEnd(22)} ${c.help}`)
     .join("\n")}
   europa-health               GET the Europa embedding /health over HTTP (Europa is usually off by design)
-  hermes-releases [n]         latest n upstream Hermes releases with notes (default 5); read them before hermes-upgrade
+  hermes-releases [n]         latest n upstream Hermes releases, notes cut at 6000 chars (default 5)
+  hermes-release <tag>        one release with its full notes; read every release between the installed version and the target before hermes-upgrade
 
 Europa control and Hermes configuration are operator tasks.`;
 
@@ -121,16 +122,29 @@ export function compactReleases(releases: GithubRelease[]): { tag: string; name:
     }));
 }
 
-async function hermesReleases(config: InferenceConfig, countArg: string | undefined): Promise<number> {
-    const n = countArg === undefined ? 5 : Number(countArg);
-    if (!Number.isInteger(n) || n < 1 || n > 30) throw new UsageError("hermes-releases [n]: n must be 1..30");
+const RELEASE_TAG = /^[A-Za-z0-9._-]{1,60}$/;
+
+async function github(config: InferenceConfig, path: string): Promise<unknown> {
     if (!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(config.hermesRepo)) throw new ServiceError("hermesRepo must be owner/name");
-    const response = await fetch(`https://api.github.com/repos/${config.hermesRepo}/releases?per_page=${n}`, {
+    const response = await fetch(`https://api.github.com/repos/${config.hermesRepo}${path}`, {
         headers: { Accept: "application/vnd.github+json", "User-Agent": "pi-astro-inference-specialist" },
         signal: AbortSignal.timeout(30_000),
     });
-    if (!response.ok) throw new ServiceError(`GitHub answered ${response.status} for ${config.hermesRepo} releases`);
-    printJson({ repository: config.hermesRepo, releases: compactReleases((await response.json()) as GithubRelease[]) });
+    if (!response.ok) throw new ServiceError(`GitHub answered ${response.status} for ${config.hermesRepo}${path}`);
+    return response.json();
+}
+
+async function hermesReleases(config: InferenceConfig, countArg: string | undefined): Promise<number> {
+    const n = countArg === undefined ? 5 : Number(countArg);
+    if (!Number.isInteger(n) || n < 1 || n > 30) throw new UsageError("hermes-releases [n]: n must be 1..30");
+    printJson({ repository: config.hermesRepo, releases: compactReleases((await github(config, `/releases?per_page=${n}`)) as GithubRelease[]) });
+    return 0;
+}
+
+async function hermesRelease(config: InferenceConfig, tag: string | undefined): Promise<number> {
+    if (tag === undefined || !RELEASE_TAG.test(tag)) throw new UsageError("hermes-release <tag>, e.g. v2026.9.14");
+    const release = (await github(config, `/releases/tags/${encodeURIComponent(tag)}`)) as GithubRelease;
+    printJson({ repository: config.hermesRepo, ...compactReleases([release])[0], notes: release.body ?? "" });
     return 0;
 }
 
@@ -150,6 +164,7 @@ export async function command(args: string[]): Promise<number> {
     const config = readConfig<InferenceConfig>(SERVICE, SHAPE);
     if (args[0] === "europa-health") return europaHealth(config);
     if (args[0] === "hermes-releases") return hermesReleases(config, args[1]);
+    if (args[0] === "hermes-release") return hermesRelease(config, args[1]);
     const { remote, spec } = buildInferenceRemote(args);
     const targets: Record<Target, { host: string; user: string; keyFile: string }> = {
         nexus: { host: config.nexusHost, user: config.nexusUser, keyFile: secretPath(SERVICE, "SSH_KEY_NEXUS") },