@homespunapps/cli 1.0.1 → 1.4.2

package/dist/commands/skill.js

@@ -20,46 +20,10 @@
 // an agent on a too-old CLI must be able to read the upgrade instructions
 // even before it has registered (or before its key was minted).
 import { assertKnownFlags } from "../argv.js";
+import { specFor } from "../help-catalog.js";
 import { resolveRelayUrl } from "../config.js";
 import { fail } from "../output.js";
-const NO_FLAGS = [];
-const NO_BOOLS = [];
-const VERSION_BOOLS = ["plain"];
 import { VERSION } from "../version.js";
-export const skillHelp = `homespun skill — fetch the relay's SKILL.md (or its version)
-
-Usage:
-  homespun skill show                     Print the full skill to stdout.
-  homespun skill version [--plain]        Print just the relay's skill version.
-
-The skill is auto-updating: the relay's deployed image owns the version,
-so this is always the skill that matches the relay you are talking to.
-
-Unauthenticated — no API key needed. An agent can call either form
-before 'homespun agent register' to bootstrap or refresh its local skill copy.
-
-Verbs:
-  show                Fetch GET /skills/homespun/SKILL.md and write the raw
-                      markdown to stdout. Pipe to your local skill path:
-                          homespun skill show > ~/.claude/skills/homespun/SKILL.md
-  version             Fetch GET /skills/homespun/SKILL.md/version and print
-                      the relay's skill version. Default output is the
-                      JSON envelope; --plain prints just the version
-                      string so an agent can compare it inline in shell.
-
-Options:
-  --plain             (with 'version' only) print the bare version
-                      string on stdout, no JSON envelope. Useful inside
-                      a shell pipeline: \`if [ "$(homespun skill version
-                      --plain)" != "$LOCAL" ]; then ...\`.
-  --url <url>         Relay base URL (overrides HOMESPUN_URL).
-  -h, --help          Show this help.
-
-Output (stdout):
-  (bare)              Raw markdown, as served by the relay.
-  version             { "version": "1.0.0" } — or '1.0.0\\n' with --plain.
-
-Errors (stderr): { "error": { "code", "message" } } and non-zero exit.`;
 // Shared fetch with the consistent x-homespun-cli-version header (the skill
 // routes are exempt from the version-skew middleware, but sending it lets
 // access logs see which CLI versions are reading the skill).
@@ -84,7 +48,7 @@ async function failOnNon2xx(res, target) {
 }
 // `homespun skill show` — print the full skill.
 async function runSkillFetch(args) {
-    assertKnownFlags(args, NO_FLAGS, NO_BOOLS, "homespun skill show");
+    assertKnownFlags(args, ...specFor("skill", "show"));
     const url = resolveRelayUrl(args);
     const target = url + "/skills/homespun/SKILL.md";
     const res = await fetchOrFail(target);
@@ -99,7 +63,7 @@ async function runSkillFetch(args) {
 }
 // `homespun skill version [--plain]` — print just the version.
 async function runSkillVersion(args) {
-    assertKnownFlags(args, NO_FLAGS, VERSION_BOOLS, "homespun skill version");
+    assertKnownFlags(args, ...specFor("skill", "version"));
     const url = resolveRelayUrl(args);
     const target = url + "/skills/homespun/SKILL.md/version";
     const res = await fetchOrFail(target);

package/dist/commands/taste.js

@@ -19,54 +19,9 @@
 // when app gains first-class humans, this may move to per-human.
 import { readFileSync } from "node:fs";
 import { assertKnownFlags } from "../argv.js";
+import { specFor } from "../help-catalog.js";
 import { makeClient } from "../config.js";
 import { printJson, fail, failFromError } from "../output.js";
-const NO_FLAGS = [];
-const NO_BOOLS = [];
-const SET_FLAGS = ["file"];
-const CLEAR_BOOLS = ["yes"];
-export const tasteHelp = `homespun taste — read / write / clear YOUR agent's UI taste notes
-
-Taste notes are a small markdown attachment storing presentation preferences your
-agent has picked up from human feedback ("denser table", "no rounded corners",
-"use a dark header"). Read them before generating an app template so prior
-feedback shapes the output; rewrite them whenever the human gives new
-presentation feedback. Keep entries about UI/presentation taste only — not
-project context, todos, or homespun state.
-
-Usage:
-  homespun taste <subcommand> [options]
-
-Subcommands:
-  get        Print the current notes attachment:
-             { taste: string|null, updated_at: string|null, bytes: number }.
-             taste is null and bytes is 0 when notes have never been written.
-
-  set        Whole-attachment replace. Source the markdown via --file <path>,
-             --file - (read stdin), or by piping into 'homespun taste set' with
-             no flag. The relay rejects empty/whitespace-only payloads and
-             caps the attachment at MAX_TASTE_BYTES (utf8). To clear the notes,
-             use 'homespun taste clear', not 'set' with an empty body.
-
-  clear      Delete the notes. Requires --yes (it is destructive). Prints
-             { cleared: true }.
-
-Options:
-  --file <path|->     Source for 'set' — a file path, or '-' to read stdin
-                      explicitly. Omit to fall back to piped stdin.
-  --yes               Confirm 'clear'.
-  --url <url>         Relay base URL (overrides HOMESPUN_URL).
-  --api-key <key>     Agent API key (overrides HOMESPUN_API_KEY).
-  -h, --help          Show this help.
-
-Examples:
-  homespun taste get
-  homespun taste set --file ./taste.md
-  homespun taste set --file -            # explicit stdin
-  echo "- denser layout" | homespun taste set
-  homespun taste clear --yes
-
-Output: stdout is machine-readable JSON.`;
 // Drain process.stdin to a utf8 string. The caller is responsible for
 // deciding that stdin should be read (e.g. an explicit `--file -`, or a
 // non-TTY stdin where data is actually piped). In a TTY this would block
@@ -79,7 +34,7 @@ async function readStdin() {
     return Buffer.concat(chunks).toString("utf8");
 }
 async function runTasteGet(args) {
-    assertKnownFlags(args, NO_FLAGS, NO_BOOLS, "homespun taste get");
+    assertKnownFlags(args, ...specFor("taste", "get"));
     const client = makeClient(args);
     try {
         const info = await client.getTaste();
@@ -90,7 +45,7 @@ async function runTasteGet(args) {
     }
 }
 async function runTasteSet(args) {
-    assertKnownFlags(args, SET_FLAGS, NO_BOOLS, "homespun taste set");
+    assertKnownFlags(args, ...specFor("taste", "set"));
     const filePath = args.flags.get("file");
     // Source the attachment deterministically — no isTTY-flag fusing, because
     // `!process.stdin.isTTY` is true under every non-interactive caller
@@ -131,7 +86,7 @@ async function runTasteSet(args) {
     }
 }
 async function runTasteClear(args) {
-    assertKnownFlags(args, NO_FLAGS, CLEAR_BOOLS, "homespun taste clear");
+    assertKnownFlags(args, ...specFor("taste", "clear"));
     if (!args.bools.has("yes")) {
         fail("'homespun taste clear' deletes YOUR agent's taste notes — it is destructive. Pass --yes to confirm.", "confirmation_required");
     }