@heart-of-gold/toolkit 0.1.24 → 0.1.30

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,15 @@ 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
+- `/share` — publish an HTML file or static site directory through the portable `share-html` skill
+- `/share-server-setup` — set up or adopt the local share server through the portable `share-server-setup` skill
 - `/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,15 +97,18 @@ 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
+9 skills · 2 agents · 3 knowledge files
 
 ```
-/marvin:work         # execute plans — implement, test, commit, ship
-/marvin:quick-review # fast opinionated quality pass (simplicity, tests, correctness)
-/marvin:compound     # document solved problems for future reference
-/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:work               # execute plans — implement, test, commit, ship
+/marvin:quick-review       # fast opinionated quality pass (simplicity, tests, correctness)
+/marvin:compound           # document solved problems for future reference
+/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)
+/marvin:share-server-setup # set up local artifact sharing infrastructure
+/marvin:share-html         # publish HTML/static output to a browser URL
 ```
 
 ### [Guide](plugins/guide/) — The Hitchhiker's Guide
@@ -172,6 +182,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 +206,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,
+  };
+}