@heart-of-gold/toolkit 0.1.32 → 0.1.33

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.2"
+      "version": "0.2.3"
     },
     {
       "name": "marvin",
       "source": "./plugins/marvin",
       "description": "The Paranoid Android — quality tools for code review, knowledge compounding, and work execution",
-      "version": "0.3.0"
+      "version": "0.3.3"
     },
     {
       "name": "babel-fish",
       "source": "./plugins/babel-fish",
       "description": "Universal Translator — media generation tools for audio, image, and video content",
-      "version": "0.2.0"
+      "version": "0.2.1"
     },
     {
       "name": "quellis",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heart-of-gold/toolkit",
-  "version": "0.1.32",
+  "version": "0.1.33",
   "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.0",
+  "version": "0.2.1",
   "description": "Universal Translator — media generation tools for audio, image, video, and visualization",
   "author": {
     "name": "ondrej-svec",

package/plugins/babel-fish/skills/visualize/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: visualize
 description: >
-  Render mind maps and tree visualizations from markdown. Prefer terminal output for quick local inspection,
-  and generate shareable HTML when the user wants a browser view and share-html infrastructure is configured.
-  Works on brainstorm docs, plan docs, markdown files, or any structured content. Triggers: visualize,
-  mindmap, mind map, show me the structure, draw a map.
+  Render mind maps and tree visualizations from markdown. Prefer shareable HTML first for brainstorms, plans,
+  architecture docs, and other structured workflow artifacts when share-html infrastructure is configured;
+  otherwise fall back to terminal output for quick local inspection. Works on markdown files or any structured
+  content. Triggers: visualize, mindmap, mind map, show me the structure, draw a map.
 allowed-tools:
   - Read
   - Bash
@@ -88,25 +88,26 @@ This script:
 
 ## Phase 0 — Determine What to Visualize
 
-First decide whether the user wants:
-- a quick terminal view
-- a browser/shareable HTML view
+First decide whether this should be a browser/shareable HTML view or a quick terminal view.
 
-**Prefer browser/shareable HTML when:**
+**Prefer browser/shareable HTML first when:**
+- the source is a brainstorm, plan, architecture doc, or other structured workflow artifact
 - the user asks to open it in a browser
 - the user wants to share the result with another person or device
 - the structure is large enough that browser navigation is more useful than terminal rendering
+- `share-html` is configured
 
 **Prefer terminal rendering when:**
-- the user wants a quick local look
-- the environment is SSH-heavy or browser access is not requested
 - share-html is not configured
+- the user explicitly wants a quick terminal-only look
+- the environment is SSH-heavy and the browser/share path is not requested
 
 When invoked as `/visualize [path]`:
 
 **If a file path is provided:**
 1. Read the file
-2. Render it directly with the mind map renderer
+2. If it looks like a brainstorm, plan, architecture doc, or the user asked for browser viewing, try the shareable HTML path first
+3. Otherwise render it directly with the mind map renderer
 
 **If no path is provided:**
 1. Check if there's a recent brainstorm or plan document in the conversation context
@@ -140,17 +141,19 @@ The default mode is **vertical layout** — boxes on main branches, compact leav
 
 ### Path B — Shareable HTML
 
-If the user wants browser viewing or sharing and `share-html` is configured:
+For brainstorms, plans, architecture docs, and other structured workflow artifacts, prefer this path first when `share-html` is configured.
 
 1. Verify or assume the input markdown is ready
 2. Run:
    ```bash
-   bash scripts/render-and-share.sh [file]
+   bash scripts/render-and-share.sh --url-only [file]
    ```
-3. Read the returned JSON
-4. Return the primary URL to the user (`url` when present, otherwise `viewerUrl`)
+3. Read the returned URL from stdout
+4. Return that URL to the user as the primary result
 5. Briefly explain what was published
 
+If you need more detail for debugging, you may run the helper without `--url-only` and inspect the returned JSON.
+
 If publishing fails because the share server is not configured, say so clearly and fall back to terminal rendering unless the user wants to stop and run `share-server-setup` first.
 
 **For shell usage** (not through assistant panels): terminal rendering can use ANSI colors, or `--horizontal` for the wide spatial layout.
@@ -160,7 +163,7 @@ If publishing fails because the share server is not configured, say so clearly a
 After rendering or sharing, briefly note:
 - for terminal mode: "Use `--depth N` to see more/less detail"
 - for terminal mode: "Use `--width N` to fit a different terminal size"
-- for shared HTML: return the viewer URL and say whether it is local-only or publicly reachable on the user's tailnet
+- for shared HTML: return the final browser URL as the main result and say whether it is local-only or publicly reachable on the user's tailnet
 - if publishing failed due to missing share infrastructure: suggest `share-server-setup`
 - if the source was a brainstorm/plan/architecture doc, offer to continue the workflow (e.g., proceed to `/plan`, `/work`, or implementation)
 

package/plugins/babel-fish/skills/visualize/scripts/render-and-share.sh

@@ -9,14 +9,16 @@ SLUG=""
 TITLE=""
 ALIAS=""
 KEEP_HTML=0
+URL_ONLY=0
 HTML_OUT=""
 TEMP_DIR=""
 
 usage() {
   cat <<'EOF'
-Usage: render-and-share.sh <markdown-file> [--slug STEM] [--title TITLE] [--alias ALIAS] [--html-out PATH] [--keep-html]
+Usage: render-and-share.sh <markdown-file> [--slug STEM] [--title TITLE] [--alias ALIAS] [--html-out PATH] [--keep-html] [--url-only]
 
 Generate an HTML mind map from a markdown file, publish it via share-html, and print the publish JSON.
+Use --url-only to print only the final browser URL.
 EOF
 }
 
@@ -27,6 +29,7 @@ while [[ $# -gt 0 ]]; do
     --alias) ALIAS="$2"; shift 2 ;;
     --html-out) HTML_OUT="$2"; shift 2 ;;
     --keep-html) KEEP_HTML=1; shift ;;
+    --url-only) URL_ONLY=1; shift ;;
     --help) usage; exit 0 ;;
     --*) echo "Unknown argument: $1" >&2; exit 1 ;;
     *)
@@ -104,4 +107,17 @@ if [[ -n "$SLUG" ]]; then CMD+=(--slug "$SLUG"); fi
 if [[ -n "$TITLE" ]]; then CMD+=(--title "$TITLE"); fi
 if [[ -n "$ALIAS" ]]; then CMD+=(--alias "$ALIAS"); fi
 
-"${CMD[@]}"
+PUBLISH_JSON="$("${CMD[@]}")"
+
+if [[ "$URL_ONLY" -eq 1 ]]; then
+  python3 - <<'PY' "$PUBLISH_JSON"
+import json, sys
+payload = json.loads(sys.argv[1])
+if not payload.get("ok", True):
+    print(json.dumps(payload))
+    raise SystemExit(1)
+print(payload.get("url") or payload.get("viewerUrl") or "")
+PY
+else
+  printf '%s\n' "$PUBLISH_JSON"
+fi

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

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

package/plugins/deep-thought/skills/architect/SKILL.md

@@ -176,12 +176,12 @@ Use **AskUserQuestion** with:
 - header: "Next step"
 - options:
   1. label: "Start implementation (Recommended)", description: "Proceed to scaffold or test writing"
-  2. label: "Visualize / Share", description: "Prefer a shareable HTML view when sharing is configured; otherwise render structure in the terminal"
+  2. label: "Visualize / Share", description: "Generate a shareable HTML view first when sharing is configured; otherwise render structure in the terminal"
   3. label: "Review and refine", description: "Adjust stories or architecture based on feedback"
   4. label: "Done for now", description: "Return later"
 - multiSelect: false
 
-**If user selects "Visualize / Share":** Run `/babel-fish:visualize {stories_path}/{slug}.architecture.md` and prefer the shareable HTML flow when browser viewing or sharing is useful and `share-html` is configured. Otherwise render the terminal mind map. After rendering or sharing, return to this handoff with the remaining options.
+**If user selects "Visualize / Share":** Run `/babel-fish:visualize {stories_path}/{slug}.architecture.md` and try the shareable HTML flow first when `share-html` is configured. Otherwise render the terminal mind map. After rendering or sharing, return to this handoff with the remaining options.
 
 **If pipeline mode (`$BRAINSTORM_PATH` set):**
 Complete without asking. Output paths for downstream consumers:

package/plugins/deep-thought/skills/brainstorm/SKILL.md

@@ -291,13 +291,13 @@ Ask the user what to do next.
 - Prefer the harness's structured choice UI if available
 - Otherwise present this short plain-text choice list:
   1. **Proceed to /plan** — Turn these decisions into an implementation plan
-  2. **Visualize / Share** — Prefer a shareable HTML mind map when sharing is configured; otherwise render in the terminal
+  2. **Visualize / Share** — Generate a shareable HTML mind map first when sharing is configured; otherwise render in the terminal
   3. **Keep exploring** — More questions or refine decisions before moving on
   4. **Done for now** — Return later; to plan: `/plan {brainstorm-path}`
 
 **If user selects "Proceed to /plan":** Suggest running `/plan {brainstorm-path}`.
 
-**If user selects "Visualize / Share":** Run `/babel-fish:visualize {brainstorm-path}` and prefer the shareable HTML flow when browser viewing or sharing is useful and `share-html` is configured. Otherwise render the terminal mind map. After rendering or sharing, return to this handoff with the remaining options.
+**If user selects "Visualize / Share":** Run `/babel-fish:visualize {brainstorm-path}` and try the shareable HTML flow first when `share-html` is configured. Otherwise render the terminal mind map. After rendering or sharing, return to this handoff with the remaining options.
 
 **If user selects "Keep exploring":** Return to Phase 3 and continue asking questions one at a time. When satisfied, update the document and return to this handoff.
 

package/plugins/deep-thought/skills/plan/SKILL.md

@@ -283,13 +283,13 @@ Ask the user what to do next.
 - Prefer the harness's structured choice UI if available
 - Otherwise present this short plain-text choice list:
   1. **Start /work (Recommended)** — Begin implementing this plan
-  2. **Visualize / Share** — Prefer a shareable HTML mind map when sharing is configured; otherwise render in the terminal
+  2. **Visualize / Share** — Generate a shareable HTML mind map first when sharing is configured; otherwise render in the terminal
   3. **Review and refine** — Adjust the plan based on feedback
   4. **Done for now** — Return later; to start: `/work {plan-path}`
 
 **If user selects "Start /work":** Suggest running `/work {plan-path}`.
 
-**If user selects "Visualize / Share":** Run `/babel-fish:visualize {plan-path}` and prefer the shareable HTML flow when browser viewing or sharing is useful and `share-html` is configured. Otherwise render the terminal mind map. After rendering or sharing, return to this handoff with the remaining options.
+**If user selects "Visualize / Share":** Run `/babel-fish:visualize {plan-path}` and try the shareable HTML flow first when `share-html` is configured. Otherwise render the terminal mind map. After rendering or sharing, return to this handoff with the remaining options.
 
 **If user selects "Review and refine":** Accept feedback, update the plan, then present these options again.
 

package/plugins/guide/scripts/fetch-gmail.sh

@@ -82,15 +82,11 @@ print(fetch_body)
 PY
 }
 
-GMAIL_SETTINGS_RAW=$(read_gmail_settings "$CONFIG_PATH" 2>/dev/null) || GMAIL_SETTINGS_RAW=""
-if [[ -n "$GMAIL_SETTINGS_RAW" ]]; then
-  GMAIL_LABEL=$(echo "$GMAIL_SETTINGS_RAW" | sed -n '1p')
-  MAX_ITEMS=$(echo "$GMAIL_SETTINGS_RAW" | sed -n '2p')
-  GMAIL_LABEL_ID=$(echo "$GMAIL_SETTINGS_RAW" | sed -n '3p')
-  FETCH_BODY=$(echo "$GMAIL_SETTINGS_RAW" | sed -n '4p')
-  GMAIL_LABEL="${GMAIL_LABEL:-Content-Feed}"
-  MAX_ITEMS="${MAX_ITEMS:-20}"
-  FETCH_BODY="${FETCH_BODY:-false}"
+if mapfile -t GMAIL_SETTINGS < <(read_gmail_settings "$CONFIG_PATH" 2>/dev/null); then
+  GMAIL_LABEL="${GMAIL_SETTINGS[0]:-Content-Feed}"
+  MAX_ITEMS="${GMAIL_SETTINGS[1]:-20}"
+  GMAIL_LABEL_ID="${GMAIL_SETTINGS[2]:-}"
+  FETCH_BODY="${GMAIL_SETTINGS[3]:-false}"
 else
   GMAIL_LABEL="Content-Feed"
   MAX_ITEMS="20"
@@ -98,61 +94,14 @@ else
   FETCH_BODY="false"
 fi
 
-# Collect seen Gmail message IDs from previous days to avoid duplicates
-PIPELINE_DIR=$(python3 -c "
-import yaml, sys
-with open(sys.argv[1]) as f:
-    c = yaml.safe_load(f)
-print(c.get('output', {}).get('pipeline_dir', 'content/pipeline'))
-" "$CONFIG_PATH" 2>/dev/null || echo "content/pipeline")
-
-SEEN_IDS=$(python3 -c "
-import json, glob, os, sys
-
-pipeline_dir = sys.argv[1]
-config_path = sys.argv[2]
-
-# Resolve relative pipeline_dir against project root (config's grandparent,
-# since config lives in content/ which is one level below project root)
-if not os.path.isabs(pipeline_dir):
-    config_dir = os.path.dirname(os.path.abspath(config_path))
-    # Walk up until we find .git or use config's parent's parent as fallback
-    project_root = config_dir
-    while project_root != '/':
-        if os.path.isdir(os.path.join(project_root, '.git')):
-            break
-        project_root = os.path.dirname(project_root)
-    pipeline_dir = os.path.join(project_root, pipeline_dir)
-
-seen = set()
-# Check last 7 days of signals files
-for path in sorted(glob.glob(os.path.join(pipeline_dir, '*/signals.json')))[-7:]:
-    try:
-        signals = json.load(open(path))
-        for s in signals:
-            if s.get('source') == 'gmail':
-                mid = s.get('metadata', {}).get('message_id', '')
-                if mid:
-                    seen.add(mid)
-    except (json.JSONDecodeError, KeyError):
-        pass
-# Output as comma-separated IDs
-print(','.join(seen))
-" "$PIPELINE_DIR" "$CONFIG_PATH" 2>/dev/null || echo "")
-
-if [[ -n "$SEEN_IDS" ]]; then
-  SEEN_COUNT=$(echo "$SEEN_IDS" | tr ',' '\n' | wc -l | tr -d ' ')
-  echo "  · $SEEN_COUNT previously seen Gmail message IDs loaded" >&2
-fi
-
 # Fetch emails using gws +triage helper (more reliable than raw API calls —
 # the helper handles auth scopes internally, avoiding insufficientPermissions errors)
 # Fetch recent emails with labels, then filter by label ID in Python
 GWS_ERR=$(mktemp)
 trap "rm -f $GWS_ERR" EXIT
 EMAILS_JSON=$(gws gmail +triage \
-  --query "newer_than:7d" \
-  --max 200 \
+  --query "newer_than:3d" \
+  --max 50 \
   --format json \
   --labels \
   2>"$GWS_ERR") || {
@@ -173,21 +122,17 @@ EMAILS_JSON=$(gws gmail +triage \
 # Determine the scripts directory (where this script lives)
 SCRIPTS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
-export _GMAIL_LABEL_ID="$GMAIL_LABEL_ID"
-export _GMAIL_MAX_ITEMS="$MAX_ITEMS"
-export _GMAIL_CONFIG_PATH="$CONFIG_PATH"
-export _GMAIL_SEEN_IDS="$SEEN_IDS"
-
 if [[ "$FETCH_BODY" == "true" ]]; then
   # Deep mode: filter messages first, then pass to fetch-gmail-deep.py for
   # full body fetching, link extraction, and article following
-  echo "$EMAILS_JSON" | python3 -c "
-import json, sys, yaml, os
+  echo "$EMAILS_JSON" | python3 - "$GMAIL_LABEL_ID" "$MAX_ITEMS" "$CONFIG_PATH" <<'PY' 2>/dev/null | python3 "$SCRIPTS_DIR/fetch-gmail-deep.py" || {
+import json
+import sys
+import yaml
 
-label_id = os.environ['_GMAIL_LABEL_ID']
-max_items = int(os.environ['_GMAIL_MAX_ITEMS'])
-config_path = os.environ['_GMAIL_CONFIG_PATH']
-seen_ids = set(os.environ.get('_GMAIL_SEEN_IDS', '').split(',')) - {''}
+label_id = sys.argv[1]
+max_items = int(sys.argv[2])
+config_path = sys.argv[3]
 
 data = json.load(sys.stdin)
 messages = data.get('messages', []) if isinstance(data, dict) else data
@@ -195,12 +140,6 @@ messages = data.get('messages', []) if isinstance(data, dict) else data
 if label_id:
     messages = [m for m in messages if label_id in m.get('labels', [])]
 
-before = len(messages)
-messages = [m for m in messages if m.get('id', '') not in seen_ids]
-skipped = before - len(messages)
-if skipped:
-    print(f'  Dedup: skipped {skipped} already-seen messages', file=sys.stderr)
-
 messages = messages[:max_items]
 
 with open(config_path) as f:
@@ -208,19 +147,19 @@ with open(config_path) as f:
 gmail_config = config.get('sources', {}).get('gmail', {}) or {}
 
 json.dump({'messages': messages, 'config': gmail_config}, sys.stdout)
-" | python3 "$SCRIPTS_DIR/fetch-gmail-deep.py" || {
+PY
     echo "Error: Deep Gmail processing failed" >&2
     exit 1
   }
 else
   # Shallow mode: subject-only signals (original behavior)
-  echo "$EMAILS_JSON" | python3 -c "
-import json, sys, os
+  echo "$EMAILS_JSON" | python3 - "$GMAIL_LABEL_ID" "$MAX_ITEMS" <<'PY' 2>/dev/null || {
+import json
+import sys
 from datetime import datetime, timezone
 
-label_id = os.environ.get('_GMAIL_LABEL_ID', '')
-max_items = int(os.environ.get('_GMAIL_MAX_ITEMS', '20'))
-seen_ids = set(os.environ.get('_GMAIL_SEEN_IDS', '').split(',')) - {''}
+label_id = sys.argv[1]
+max_items = int(sys.argv[2])
 
 data = json.load(sys.stdin)
 messages = data.get('messages', []) if isinstance(data, dict) else data
@@ -228,12 +167,6 @@ messages = data.get('messages', []) if isinstance(data, dict) else data
 if label_id:
     messages = [m for m in messages if label_id in m.get('labels', [])]
 
-before = len(messages)
-messages = [m for m in messages if m.get('id', '') not in seen_ids]
-skipped = before - len(messages)
-if skipped:
-    print(f'  Dedup: skipped {skipped} already-seen messages', file=sys.stderr)
-
 messages = messages[:max_items]
 
 signals = []
@@ -270,7 +203,7 @@ for email in messages:
     })
 
 json.dump(signals, sys.stdout, indent=2)
-" 2>/dev/null || {
+PY
     echo "Error: Failed to parse gws output" >&2
     exit 1
   }

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

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