@heart-of-gold/toolkit 0.1.37 → 0.1.38

package/.claude-plugin/marketplace.json

@@ -15,19 +15,19 @@
       "name": "deep-thought",
       "source": "./plugins/deep-thought",
       "description": "The Answer Computer — reasoning tools for brainstorming, planning, and deep thinking",
-      "version": "0.2.7"
+      "version": "0.2.8"
     },
     {
       "name": "marvin",
       "source": "./plugins/marvin",
       "description": "The Paranoid Android — quality tools for code review, knowledge compounding, and work execution",
-      "version": "0.3.7"
+      "version": "0.3.8"
     },
     {
       "name": "babel-fish",
       "source": "./plugins/babel-fish",
       "description": "Universal Translator — media generation tools for audio, image, and video content",
-      "version": "0.2.5"
+      "version": "0.2.6"
     },
     {
       "name": "quellis",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heart-of-gold/toolkit",
-  "version": "0.1.37",
+  "version": "0.1.38",
   "type": "module",
   "description": "Cross-platform installer for Heart of Gold skills — works with Codex, OpenCode, Pi, Claude Code, and more",
   "bin": {

package/plugins/babel-fish/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "babel-fish",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Universal Translator — media generation tools for audio, image, video, and visualization",
   "author": {
     "name": "ondrej-svec",

package/plugins/deep-thought/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "deep-thought",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "The Answer Computer — reasoning tools for brainstorming, planning, architecture design, and deep thinking",
   "author": {
     "name": "ondrej-svec",

package/plugins/marvin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "marvin",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "The Paranoid Android — quality tools for code review, knowledge compounding, and work execution",
   "author": {
     "name": "ondrej-svec",

package/plugins/marvin/skills/share-server-control/SKILL.md

@@ -59,6 +59,16 @@ bash scripts/enable-viewer.sh --public-base-url "https://<machine>.<tailnet>.ts.
 bash scripts/disable-viewer.sh
 ```
 
+### Delete a published artifact by slug
+```bash
+heart-of-gold share-server delete <slug>
+```
+
+### Delete only an alias pointer
+```bash
+heart-of-gold share-server delete --alias <alias> --onlyAlias
+```
+
 ## Notes
 
 - In v1, lifecycle control assumes the reference server was installed as a macOS LaunchAgent.
@@ -73,6 +83,8 @@ bash scripts/disable-viewer.sh
 - `scripts/restart.sh` — restart the LaunchAgent cleanly
 - `scripts/enable-viewer.sh` — enable private Tailscale Serve exposure for the viewer listener
 - `scripts/disable-viewer.sh` — turn off private Tailscale Serve exposure
+- `heart-of-gold share-server delete <slug>` — remove a published artifact, its aliases, and its metadata entries
+- `heart-of-gold share-server delete --alias <alias> --onlyAlias` — remove only an alias pointer
 
 ## References
 

package/share-server/README.md

@@ -59,6 +59,18 @@ bun share-server/src/index.ts init
 bun share-server/src/index.ts health
 ```
 
+### Delete a published share
+
+```bash
+heart-of-gold share-server delete <slug>
+```
+
+### Delete only an alias pointer
+
+```bash
+heart-of-gold share-server delete --alias <alias> --onlyAlias
+```
+
 ### Install stable local server files
 
 ```bash
@@ -93,6 +105,19 @@ curl -fsS -X POST \
   http://127.0.0.1:4815/publish
 ```
 
+## Cleanup model
+
+Artifacts are immutable when published, but the admin surface can remove them when cleanup is needed.
+
+Supported cleanup operations:
+- delete a share by slug
+- delete an alias pointer without deleting the underlying artifact
+
+Deleting a share removes:
+- the artifact directory
+- any aliases pointing at that slug
+- matching metadata entries in `metadata/shares.jsonl`
+
 ## Security model
 
 - publish/admin API binds to localhost only

package/share-server/src/index.ts

@@ -4,7 +4,7 @@ import { dirname, join, resolve } from "node:path";
 import { homedir, platform } from "node:os";
 import { ensureConfigAndDataDirs, loadConfig, resolveConfigPath, writeConfig } from "./config";
 import { publishArtifact } from "./publish";
-import { ensureStorageLayout } from "./storage";
+import { deleteAlias, deleteArtifact, ensureStorageLayout, readAlias, readMetadata, removeAliasesForSlug, rewriteMetadata } from "./storage";
 import { createViewerHandler } from "./viewer";
 import type { HealthResponse } from "./types";
 
@@ -92,14 +92,7 @@ async function startServer(flags: Record<string, string | boolean>): Promise<voi
       }
 
       if (request.method === "GET" && url.pathname === "/shares") {
-        const sharesPath = join(dataRoot, "metadata", "shares.jsonl");
-        const text = existsSync(sharesPath) ? await Bun.file(sharesPath).text() : "";
-        const items = text
-          .split(/\r?\n/)
-          .map((line) => line.trim())
-          .filter(Boolean)
-          .map((line) => JSON.parse(line));
-        return Response.json({ ok: true, items });
+        return Response.json({ ok: true, items: readMetadata(dataRoot) });
       }
 
       if (request.method === "POST" && url.pathname === "/publish") {
@@ -127,6 +120,39 @@ async function startServer(flags: Record<string, string | boolean>): Promise<voi
         }
       }
 
+      if (request.method === "DELETE" && url.pathname.startsWith("/shares/")) {
+        const slug = decodeURIComponent(url.pathname.replace(/^\/shares\//, "")).trim();
+        if (!slug) {
+          return Response.json({ ok: false, error: { code: "MISSING_SLUG", message: "Share slug is required." } }, { status: 400 });
+        }
+
+        const removedArtifact = deleteArtifact(dataRoot, slug);
+        const removedAliases = removeAliasesForSlug(dataRoot, slug);
+        const existing = readMetadata(dataRoot);
+        const filtered = existing.filter((record) => record.slug !== slug);
+        const metadataRemoved = filtered.length !== existing.length;
+        rewriteMetadata(dataRoot, filtered);
+
+        if (!removedArtifact && !metadataRemoved && removedAliases.length === 0) {
+          return Response.json({ ok: false, error: { code: "NOT_FOUND", message: `Share not found: ${slug}` } }, { status: 404 });
+        }
+
+        return Response.json({ ok: true, slug, removedArtifact, removedAliases, metadataRemoved });
+      }
+
+      if (request.method === "DELETE" && url.pathname.startsWith("/aliases/")) {
+        const alias = decodeURIComponent(url.pathname.replace(/^\/aliases\//, "")).trim();
+        if (!alias) {
+          return Response.json({ ok: false, error: { code: "MISSING_ALIAS", message: "Alias is required." } }, { status: 400 });
+        }
+        const slug = readAlias(dataRoot, alias);
+        const removed = deleteAlias(dataRoot, alias);
+        if (!removed) {
+          return Response.json({ ok: false, error: { code: "NOT_FOUND", message: `Alias not found: ${alias}` } }, { status: 404 });
+        }
+        return Response.json({ ok: true, alias, slug, removed: true });
+      }
+
       return Response.json({ ok: false, error: { code: "INVALID_REQUEST", message: "Unknown route" } }, { status: 404 });
     },
   });

package/share-server/src/storage.ts

@@ -39,23 +39,81 @@ export function artifactPath(dataRoot: string, slug: string): string {
   return join(artifactsDir(dataRoot), slug);
 }
 
+export function metadataFilePath(dataRoot: string): string {
+  return join(metadataDir(dataRoot), "shares.jsonl");
+}
+
 export function writeMetadata(dataRoot: string, record: ShareRecord): void {
-  const filePath = join(metadataDir(dataRoot), "shares.jsonl");
+  const filePath = metadataFilePath(dataRoot);
   writeFileSync(filePath, `${JSON.stringify(record)}\n`, { flag: "a" });
 }
 
+export function readMetadata(dataRoot: string): ShareRecord[] {
+  const filePath = metadataFilePath(dataRoot);
+  if (!existsSync(filePath)) return [];
+  return readFileSync(filePath, "utf-8")
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .map((line) => JSON.parse(line) as ShareRecord);
+}
+
+export function rewriteMetadata(dataRoot: string, records: ShareRecord[]): void {
+  const filePath = metadataFilePath(dataRoot);
+  const content = records.map((record) => JSON.stringify(record)).join("\n");
+  writeFileSync(filePath, `${content}${content ? "\n" : ""}`, "utf-8");
+}
+
 export function writeAlias(dataRoot: string, alias: string, slug: string): void {
   const aliasPath = join(aliasesDir(dataRoot), `${slugify(alias)}.json`);
   writeFileSync(aliasPath, `${JSON.stringify({ alias: slugify(alias), slug }, null, 2)}\n`, "utf-8");
 }
 
+export function aliasPath(dataRoot: string, alias: string): string {
+  return join(aliasesDir(dataRoot), `${slugify(alias)}.json`);
+}
+
 export function readAlias(dataRoot: string, alias: string): string | null {
-  const aliasPath = join(aliasesDir(dataRoot), `${slugify(alias)}.json`);
-  if (!existsSync(aliasPath)) return null;
-  const parsed = JSON.parse(readFileSync(aliasPath, "utf-8")) as { slug?: string };
+  const filePath = aliasPath(dataRoot, alias);
+  if (!existsSync(filePath)) return null;
+  const parsed = JSON.parse(readFileSync(filePath, "utf-8")) as { slug?: string };
   return parsed.slug ?? null;
 }
 
+export function deleteAlias(dataRoot: string, alias: string): boolean {
+  const filePath = aliasPath(dataRoot, alias);
+  if (!existsSync(filePath)) return false;
+  rmSync(filePath, { force: true });
+  return true;
+}
+
+export function removeAliasesForSlug(dataRoot: string, slug: string): string[] {
+  const removed: string[] = [];
+  const root = aliasesDir(dataRoot);
+  if (!existsSync(root)) return removed;
+  for (const entry of readdirSync(root)) {
+    if (!entry.endsWith('.json')) continue;
+    const filePath = join(root, entry);
+    try {
+      const parsed = JSON.parse(readFileSync(filePath, 'utf-8')) as { alias?: string; slug?: string };
+      if (parsed.slug === slug) {
+        rmSync(filePath, { force: true });
+        removed.push(parsed.alias ?? entry.replace(/\.json$/, ''));
+      }
+    } catch {
+      // ignore malformed alias records during cleanup
+    }
+  }
+  return removed;
+}
+
+export function deleteArtifact(dataRoot: string, slug: string): boolean {
+  const path = artifactPath(dataRoot, slug);
+  if (!existsSync(path)) return false;
+  rmSync(path, { recursive: true, force: true });
+  return true;
+}
+
 export function copyDirectoryContents(sourceDir: string, destinationDir: string): void {
   mkdirSync(destinationDir, { recursive: true });
   for (const entry of readdirSync(sourceDir)) {

package/src/commands/share-server.ts

@@ -2,6 +2,8 @@ import { defineCommand } from "citty";
 import { cpSync, existsSync, mkdirSync, rmSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { homedir } from "node:os";
+import { dataRootForConfig } from "../../share-server/src/config";
+import { deleteAlias, deleteArtifact, readAlias, readMetadata, removeAliasesForSlug, rewriteMetadata } from "../../share-server/src/storage";
 
 function packageRoot(): string {
   let dir = dirname(new URL(import.meta.url).pathname);
@@ -86,6 +88,48 @@ export const shareServerCommand = defineCommand({
         console.log(JSON.stringify({ ok: true, serverDir: targetDir }, null, 2));
       },
     }),
+    delete: defineCommand({
+      meta: { name: "delete", description: "Delete a published share by slug, or remove an alias" },
+      args: {
+        slug: { type: "positional", required: false },
+        alias: { type: "string", required: false },
+        config: { type: "string", required: false },
+        onlyAlias: { type: "boolean", required: false },
+      },
+      run({ args }) {
+        const dataRoot = dataRootForConfig(args.config ? String(args.config) : undefined);
+
+        if (args.alias && args.onlyAlias) {
+          const alias = String(args.alias);
+          const slug = readAlias(dataRoot, alias);
+          const removed = deleteAlias(dataRoot, alias);
+          console.log(JSON.stringify(removed
+            ? { ok: true, alias, slug, removed: true }
+            : { ok: false, error: { code: "NOT_FOUND", message: `Alias not found: ${alias}` } }
+          ));
+          process.exit(removed ? 0 : 1);
+        }
+
+        const slug = args.slug ? String(args.slug) : undefined;
+        if (!slug) {
+          console.error("share-server delete requires either <slug> or --alias <alias> --onlyAlias");
+          process.exit(1);
+        }
+
+        const removedArtifact = deleteArtifact(dataRoot, slug);
+        const removedAliases = removeAliasesForSlug(dataRoot, slug);
+        const existing = readMetadata(dataRoot);
+        const filtered = existing.filter((record) => record.slug !== slug);
+        const metadataRemoved = filtered.length !== existing.length;
+        rewriteMetadata(dataRoot, filtered);
+        const ok = removedArtifact || metadataRemoved || removedAliases.length > 0;
+        console.log(JSON.stringify(ok
+          ? { ok: true, slug, removedArtifact, removedAliases, metadataRemoved }
+          : { ok: false, error: { code: "NOT_FOUND", message: `Share not found: ${slug}` } }
+        ));
+        process.exit(ok ? 0 : 1);
+      },
+    }),
     "install-launch-agent": defineCommand({
       meta: { name: "install-launch-agent", description: "Write a macOS LaunchAgent for the installed reference server" },
       args: {