@heart-of-gold/toolkit 0.1.29 → 0.1.30

package/README.md

@@ -39,6 +39,8 @@ When installed as a Pi package, Heart of Gold exposes Pi-native extension comman
 - `/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.
@@ -95,16 +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.
 
-7 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:copy-editor  # two-layer copy editor (typography audit + LLM judgment)
+/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
@@ -113,18 +117,16 @@ 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.
 
-9 skills · 2 agents · 5 scripts
+7 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: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
+/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
 ```
 
 ### [Babel Fish](plugins/babel-fish/) — Universal Translator

package/extensions/pi/index.ts

@@ -4,6 +4,7 @@ import architectExtension from "./architect";
 import brainstormExtension from "./brainstorm";
 import guidedWorkflowsExtension from "./guided-workflows";
 import planExtension from "./plan";
+import shareExtension from "./share";
 import workExtension from "./work";
 
 export default function heartOfGoldPiExtensions(pi: ExtensionAPI) {
@@ -11,5 +12,6 @@ export default function heartOfGoldPiExtensions(pi: ExtensionAPI) {
 	brainstormExtension(pi);
 	planExtension(pi);
 	architectExtension(pi);
+	shareExtension(pi);
 	workExtension(pi);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heart-of-gold/toolkit",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "type": "module",
   "description": "Cross-platform installer for Heart of Gold skills — works with Codex, OpenCode, Pi, Claude Code, and more",
   "bin": {
@@ -65,10 +65,10 @@
       "./plugins/guide/skills/gemini",
       "./plugins/guide/skills/pipeline",
       "./plugins/guide/skills/setup",
-      "./plugins/guide/skills/share-html",
-      "./plugins/guide/skills/share-server-setup",
       "./plugins/guide/skills/write-post",
       "./plugins/marvin/skills/compound",
+      "./plugins/marvin/skills/share-html",
+      "./plugins/marvin/skills/share-server-setup",
       "./plugins/marvin/skills/quick-review",
       "./plugins/marvin/skills/redteam",
       "./plugins/marvin/skills/scaffold",

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

@@ -1,6 +1,6 @@
 {
   "name": "guide",
-  "version": "0.3.1",
+  "version": "0.3.0",
   "description": "The Hitchhiker's Guide — content creation suite with automated pipeline, daily briefs, and blog writing",
   "author": {
     "name": "ondrej-svec",

package/plugins/guide/README.md

@@ -73,26 +73,6 @@ Guided blog writing in seven phases:
 
 Can pick up blog outlines generated by the pipeline (`needs_write_post: true` in frontmatter).
 
-### /guide:share-server-setup
-
-Set up or adopt a local share server for browser-viewable coding-agent artifacts.
-
-Use it when you want a reusable local service that can host generated HTML reports or static previews, optionally exposed privately over Tailscale. The setup flow supports:
-- configuring an already-running compatible server
-- installing the reference Heart of Gold share server
-- setting up macOS LaunchAgent persistence for long-running use
-- optionally wiring only the viewer surface through `tailscale serve`
-
-### /guide:share-html
-
-Publish a local HTML file or static site directory to the configured share server and return a browser URL.
-
-Supports:
-- a single `.html` file
-- a directory containing `index.html`
-
-If the server is not configured yet, run `/guide:share-server-setup` first.
-
 ### /guide:claude-code
 
 Headless Claude Code handoff for second opinions, code review, targeted analysis, or follow-up on a bounded task.

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

@@ -82,11 +82,15 @@ print(fetch_body)
 PY
 }
 
-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}"
+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}"
 else
   GMAIL_LABEL="Content-Feed"
   MAX_ITEMS="20"
@@ -94,14 +98,61 @@ 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:3d" \
-  --max 50 \
+  --query "newer_than:7d" \
+  --max 200 \
   --format json \
   --labels \
   2>"$GWS_ERR") || {
@@ -122,17 +173,21 @@ 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 - "$GMAIL_LABEL_ID" "$MAX_ITEMS" "$CONFIG_PATH" <<'PY' 2>/dev/null | python3 "$SCRIPTS_DIR/fetch-gmail-deep.py" || {
-import json
-import sys
-import yaml
+  echo "$EMAILS_JSON" | python3 -c "
+import json, sys, yaml, os
 
-label_id = sys.argv[1]
-max_items = int(sys.argv[2])
-config_path = sys.argv[3]
+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(',')) - {''}
 
 data = json.load(sys.stdin)
 messages = data.get('messages', []) if isinstance(data, dict) else data
@@ -140,6 +195,12 @@ 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:
@@ -147,19 +208,19 @@ with open(config_path) as f:
 gmail_config = config.get('sources', {}).get('gmail', {}) or {}
 
 json.dump({'messages': messages, 'config': gmail_config}, sys.stdout)
-PY
+" | python3 "$SCRIPTS_DIR/fetch-gmail-deep.py" || {
     echo "Error: Deep Gmail processing failed" >&2
     exit 1
   }
 else
   # Shallow mode: subject-only signals (original behavior)
-  echo "$EMAILS_JSON" | python3 - "$GMAIL_LABEL_ID" "$MAX_ITEMS" <<'PY' 2>/dev/null || {
-import json
-import sys
+  echo "$EMAILS_JSON" | python3 -c "
+import json, sys, os
 from datetime import datetime, timezone
 
-label_id = sys.argv[1]
-max_items = int(sys.argv[2])
+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(',')) - {''}
 
 data = json.load(sys.stdin)
 messages = data.get('messages', []) if isinstance(data, dict) else data
@@ -167,6 +228,12 @@ 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 = []
@@ -203,7 +270,7 @@ for email in messages:
     })
 
 json.dump(signals, sys.stdout, indent=2)
-PY
+" 2>/dev/null || {
     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.0",
+  "version": "0.3.1",
   "description": "The Paranoid Android — quality tools for code review, knowledge compounding, and work execution",
   "author": {
     "name": "ondrej-svec",

package/plugins/marvin/README.md

@@ -2,7 +2,7 @@
 
 > "Here I am, brain the size of a planet, and they ask me to review your code. Call that job satisfaction? 'Cause I don't."
 
-A quality plugin for Claude Code. Seven skills for the unglamorous work that compounds: executing plans, reviewing code, documenting solutions, scaffolding projects, writing failing tests, adversarial review, and keeping copy clean.
+A quality plugin for Claude Code. Nine skills for the unglamorous work that compounds: executing plans, reviewing code, documenting solutions, scaffolding projects, writing failing tests, adversarial review, keeping copy clean, and publishing browser-viewable artifacts.
 
 ## Skills
 
@@ -29,6 +29,12 @@ Write failing tests from user stories and architecture docs. Behavioral tests ve
 ### `/marvin:copy-editor`
 Two-layer copy editor. Layer 1 is a deterministic typography audit (regex-level, auto-closeable). Layer 2 is LLM judgment — reject-list hits, nominal-style detection, clarity/ambiguity pass for participant-facing content, voice/register check, and spoken-readability read. Loads repo-local `.copy-editor.yaml` to compose the baked-in language profile with the repo's style guide.
 
+### `/marvin:share-server-setup`
+Set up or adopt a local share server for browser-viewable coding-agent artifacts. Supports configuring an existing compatible server, installing the Heart of Gold reference share server, adding macOS LaunchAgent persistence, and optionally exposing only the viewer surface over `tailscale serve`.
+
+### `/marvin:share-html`
+Publish a local HTML file or static site directory to the configured share server and return a browser URL. Supports a single `.html` file or a directory containing `index.html`.
+
 ## Agents
 
 | Agent | Focus |

package/src/index.ts

@@ -8,7 +8,7 @@ import { shareServerCommand } from "./commands/share-server";
 const main = defineCommand({
   meta: {
     name: "heart-of-gold",
-    version: "0.1.29",
+    version: "0.1.30",
     description:
       "Cross-platform installer for Heart of Gold skills — Codex, OpenCode, Pi, Claude Code, and more",
   },