@heart-of-gold/toolkit 0.1.23 → 0.1.29

package/.claude-plugin/marketplace.json

@@ -9,31 +9,31 @@
       "name": "guide",
       "source": "./plugins/guide",
       "description": "The Hitchhiker's Guide — content creation suite with automated pipeline, daily briefs, and blog writing",
-      "version": "0.1.0"
+      "version": "0.3.0"
     },
     {
       "name": "deep-thought",
       "source": "./plugins/deep-thought",
       "description": "The Answer Computer — reasoning tools for brainstorming, planning, and deep thinking",
-      "version": "0.1.0"
+      "version": "0.2.2"
     },
     {
       "name": "marvin",
       "source": "./plugins/marvin",
       "description": "The Paranoid Android — quality tools for code review, knowledge compounding, and work execution",
-      "version": "0.1.0"
+      "version": "0.3.0"
     },
     {
       "name": "babel-fish",
       "source": "./plugins/babel-fish",
       "description": "Universal Translator — media generation tools for audio, image, and video content",
-      "version": "0.1.0"
+      "version": "0.2.0"
     },
     {
       "name": "quellis",
       "source": "./plugins/quellis",
       "description": "AI Coaching Companion — ICF methodology, powerful questions, goal-setting, and reflection",
-      "version": "0.1.0"
+      "version": "0.3.0"
     }
   ]
 }

package/README.md

@@ -2,7 +2,7 @@
 
 > **Don't Panic.**
 
-29 skills for AI coding agents. Five plugins. Works with **Claude Code, Codex, OpenCode, Pi**, and any tool supporting the [agentskills.io](https://agentskills.io) standard. Named after *The Hitchhiker's Guide to the Galaxy* because the universe is absurd and your tools should at least have personality.
+30 skills for AI coding agents. Five plugins. Works with **Claude Code, Codex, OpenCode, Pi**, and any tool supporting the [agentskills.io](https://agentskills.io) standard. Named after *The Hitchhiker's Guide to the Galaxy* because the universe is absurd and your tools should at least have personality.
 
 ## Installation
 
@@ -38,8 +38,13 @@ Pi also discovers skills from the shared `~/.agents/skills/` location, so instal
 When installed as a Pi package, Heart of Gold exposes Pi-native extension commands for the flagship workflows:
 - `/deep-thought-brainstorm` — start a brainstorm (collaborative discovery)
 - `/deep-thought-plan` — start planning (research and produce a plan document)
+- `/deep-thought-architect` — turn brainstorm decisions into stories and architecture docs
 - `/marvin-work` — start executing a plan (with always-on safety guardrails)
 
+Pi package installs also include a Pi-only guided workflow enhancer for supported Heart of Gold skills. For `brainstorm`, `plan`, and `architect`, when the assistant asks a high-confidence structured question, Pi can upgrade it into a custom interactive TUI and feed the answer back into the same workflow. Shared skills remain plain-text portable in every other harness.
+
+For extension debugging, Pi also exposes `/deep-thought-guided-debug` to toggle notices explaining when a guided prompt was extracted, skipped, dismissed, or answered.
+
 The skills themselves enforce their own boundaries (read-only for brainstorm/plan, safe commands for work) via `allowed-tools` and prompt constraints — no manual mode switching needed.
 
 The work extension also provides always-on guardrails that protect `.env`, `.git/`, and `node_modules/` from edits, block `git add .` and destructive `rm`, and require confirmation for `git push` / `npm publish`.
@@ -90,7 +95,7 @@ The unglamorous work that compounds.
 
 Execute plans task by task with tests after every change. Quick-review code with an emphasis on simplicity — catch YAGNI violations, premature abstractions, and code that solves problems that don't exist yet. Document solutions so the next person doesn't waste time re-discovering what you already figured out.
 
-6 skills · 2 agents · 3 knowledge files
+7 skills · 2 agents · 3 knowledge files
 
 ```
 /marvin:work         # execute plans — implement, test, commit, ship
@@ -99,6 +104,7 @@ Execute plans task by task with tests after every change. Quick-review code with
 /marvin:redteam      # adversarial review — find weaknesses, expose with failing tests
 /marvin:scaffold     # prepare project structure, configs, dependencies
 /marvin:test-writer  # write failing tests from user stories
+/marvin:copy-editor  # two-layer copy editor (typography audit + LLM judgment)
 ```
 
 ### [Guide](plugins/guide/) — The Hitchhiker's Guide
@@ -107,16 +113,18 @@ Your personal content engine.
 
 Configurable sources (RSS, Gmail, HN, web search), narrative briefs, LinkedIn drafts, blog outlines, voice fidelity checking, iMessage delivery, and two-way captures.
 
-7 skills · 2 agents · 5 scripts
+9 skills · 2 agents · 5 scripts
 
 ```
-/guide:setup       # configure your sources, themes, and voice
-/guide:pipeline    # run the full content engine
-/guide:capture     # morning/evening thought capture
-/guide:write-post  # guided blog writing (7 phases)
-/guide:claude-code # Claude Code CLI guidance
-/guide:codex       # Codex CLI guidance
-/guide:gemini      # Gemini CLI guidance
+/guide:setup              # configure your sources, themes, and voice
+/guide:pipeline           # run the full content engine
+/guide:capture            # morning/evening thought capture
+/guide:write-post         # guided blog writing (7 phases)
+/guide:share-server-setup # set up local artifact sharing infrastructure
+/guide:share-html         # publish HTML/static output to a browser URL
+/guide:claude-code        # Claude Code CLI guidance
+/guide:codex              # Codex CLI guidance
+/guide:gemini             # Gemini CLI guidance
 ```
 
 ### [Babel Fish](plugins/babel-fish/) — Universal Translator
@@ -172,6 +180,10 @@ bunx @heart-of-gold/toolkit list deep-thought
 
 # Show supported targets
 bunx @heart-of-gold/toolkit targets
+
+# Manage the local share server reference implementation
+bunx @heart-of-gold/toolkit share-server health
+bunx @heart-of-gold/toolkit share-server install
 ```
 
 ## Release Safety
@@ -192,10 +204,11 @@ npm run check:compat
 
 - **Codex/OpenCode/Pi**: Bun runtime (for `bunx`)
 - **Claude Code**: No additional requirements
-- **Guide plugin**: Python 3.10+, `feedparser`, `pyyaml`, `jq`, `curl`
+- **Guide plugin**: Python 3.10+, `feedparser`, `pyyaml`, `jq`, `curl`, `zip`
 - **Babel Fish audio**: ElevenLabs API key
 - **Babel Fish image**: OpenRouter API key
 - **iMessage delivery**: macOS (optional)
+- **Private tailnet viewer exposure**: Tailscale CLI (optional)
 
 ## Acknowledgments
 

package/extensions/pi/architect.ts

@@ -0,0 +1,23 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+
+export default function architectExtension(pi: ExtensionAPI) {
+	pi.registerCommand("deep-thought-architect", {
+		description: "Start architect — turn brainstorm decisions into stories and architecture docs",
+		handler: async (args, ctx) => {
+			const source =
+				args.trim() || (ctx.hasUI ? (await ctx.ui.editor("Architect input (feature or brainstorm path)", ""))?.trim() : undefined);
+			if (!source) {
+				ctx.ui.notify("Usage: /deep-thought-architect <feature or brainstorm path>", "info");
+				return;
+			}
+
+			const prompt = `/skill:architect ${source}`;
+			if (ctx.isIdle()) {
+				pi.sendUserMessage(prompt);
+			} else {
+				pi.sendUserMessage(prompt, { deliverAs: "followUp" });
+				ctx.ui.notify("Architect queued as follow-up", "info");
+			}
+		},
+	});
+}

package/extensions/pi/guided-workflows-core.js

@@ -0,0 +1,147 @@
+export const WORKFLOW_PATTERNS = [
+  { workflow: "brainstorm", pattern: /^\/(?:skill:brainstorm|brainstorm|deep-thought:brainstorm|deep-thought-brainstorm)\b/i },
+  { workflow: "plan", pattern: /^\/(?:skill:plan|plan|deep-thought:plan|deep-thought-plan)\b/i },
+  { workflow: "architect", pattern: /^\/(?:skill:architect|architect|deep-thought:architect|deep-thought-architect)\b/i },
+];
+
+export const RESET_COMMAND_PATTERN =
+  /^\/(?!(?:skill:brainstorm|brainstorm|deep-thought:brainstorm|deep-thought-brainstorm|skill:plan|plan|deep-thought:plan|deep-thought-plan|skill:architect|architect|deep-thought:architect|deep-thought-architect)\b)\S+/i;
+
+export function normalizeInline(text) {
+  return String(text)
+    .replace(/\*\*(.*?)\*\*/g, "$1")
+    .replace(/__(.*?)__/g, "$1")
+    .replace(/`([^`]+)`/g, "$1")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+export function detectWorkflow(text) {
+  const trimmed = String(text).trim();
+  for (const { workflow, pattern } of WORKFLOW_PATTERNS) {
+    if (pattern.test(trimmed)) return workflow;
+  }
+  return undefined;
+}
+
+export function parseExtractionEnvelope(text) {
+  try {
+    let json = String(text).trim();
+    const codeBlock = json.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    if (codeBlock) json = codeBlock[1].trim();
+    const parsed = JSON.parse(json);
+    if (!parsed || typeof parsed !== "object" || typeof parsed.kind !== "string") return null;
+    if (parsed.kind === "none") return parsed;
+    if (parsed.kind !== "single_choice" && parsed.kind !== "text") return null;
+    if (typeof parsed.question !== "string" || parsed.question.trim() === "") return null;
+    if (parsed.kind === "single_choice") {
+      if (!Array.isArray(parsed.options) || parsed.options.length < 2 || parsed.options.length > 5) return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+
+function splitQuestionAndContext(lines, optionStartIndex) {
+  const prior = lines.slice(0, optionStartIndex).map((line) => normalizeInline(line)).filter(Boolean);
+  if (prior.length === 0) return { question: "Choose an option" };
+
+  let question = prior[prior.length - 1];
+  let contextLines = prior.slice(0, -1);
+
+  for (let i = prior.length - 1; i >= 0; i--) {
+    const line = prior[i];
+    if (line.endsWith("?") || line.endsWith(":")) {
+      question = line.replace(/:$/, "");
+      contextLines = prior.slice(Math.max(0, i - 2), i);
+      break;
+    }
+  }
+
+  return { question, context: contextLines.join(" ").trim() || undefined };
+}
+
+export function heuristicExtractOptions(text) {
+  const lines = String(text).split(/\r?\n/);
+  const options = [];
+  let optionStartIndex = -1;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    const match = line.match(/^(\d+\.|[-*])\s+(.*)$/);
+    if (!match) {
+      if (options.length > 0) break;
+      continue;
+    }
+    if (optionStartIndex === -1) optionStartIndex = i;
+    const body = normalizeInline(match[2]);
+    const parts = body.split(/\s+[—-]\s+/);
+    const label = parts[0]?.trim();
+    const description = parts.slice(1).join(" — ").trim() || undefined;
+    if (!label) break;
+    options.push({ label, description });
+  }
+
+  if (optionStartIndex === -1 || options.length < 2 || options.length > 5) return null;
+  const { question, context } = splitQuestionAndContext(lines, optionStartIndex);
+  return { kind: "single_choice", question, context, options, confidence: "medium" };
+}
+
+export function heuristicExtractText(text) {
+  const lines = String(text)
+    .split(/\r?\n/)
+    .map((line) => normalizeInline(line))
+    .filter(Boolean);
+
+  for (let i = lines.length - 1; i >= 0; i--) {
+    const line = lines[i];
+    if (!line.endsWith("?")) continue;
+    if (/^(if|when|otherwise|for example)\b/i.test(line)) continue;
+    return {
+      kind: "text",
+      question: line,
+      context: lines.slice(Math.max(0, i - 2), i).join(" ").trim() || undefined,
+      confidence: "low",
+    };
+  }
+
+  return null;
+}
+
+export function heuristicExtractPrompt(text) {
+  return heuristicExtractOptions(text) ?? heuristicExtractText(text) ?? { kind: "none", reason: "no clear prompt", confidence: "low" };
+}
+
+export function coerceExtractedPrompt(workflow, extracted) {
+  if (!extracted || extracted.kind === "none") return null;
+  if (extracted.confidence === "low") return null;
+
+  if (extracted.kind === "single_choice") {
+    const options = (extracted.options ?? [])
+      .filter((option) => option && typeof option.label === "string" && option.label.trim() !== "")
+      .map((option) => ({
+        label: normalizeInline(option.label),
+        description: option.description ? normalizeInline(option.description) : undefined,
+      }));
+    if (options.length < 2 || options.length > 5) return null;
+    return {
+      kind: "single_choice",
+      workflow,
+      question: normalizeInline(extracted.question),
+      context: extracted.context ? normalizeInline(extracted.context) : undefined,
+      options,
+      answerInstruction: extracted.answerInstruction ? normalizeInline(extracted.answerInstruction) : undefined,
+      confidence: extracted.confidence,
+    };
+  }
+
+  return {
+    kind: "text",
+    workflow,
+    question: normalizeInline(extracted.question),
+    context: extracted.context ? normalizeInline(extracted.context) : undefined,
+    answerInstruction: extracted.answerInstruction ? normalizeInline(extracted.answerInstruction) : undefined,
+    confidence: extracted.confidence,
+  };
+}