feat: add ZCode platform plugin

[karthick-kk]

Summary

Adds native memsearch support for ZCode, a terminal coding agent with a plugin marketplace and shell hook system. ZCode is the sixth supported platform alongside Claude Code, Codex, DeepSeek Harness, OpenClaw, and OpenCode.

ZCode uses the same Stop-hook capture pattern as Claude Code and Codex, but stores conversations in a SQLite database (~/.zcode/cli/db/db.sqlite) instead of JSONL transcripts, requiring a custom parse-session.py to extract turns.

What ZCode provides for hooks

ZCode fires hooks on 3 lifecycle events (no SessionEnd, like Codex):

Hook	Async	Timeout	Purpose
SessionStart	no	10s	Orphan cleanup, bootstrap memsearch, watch/index, cold-start injection
UserPromptSubmit	no	15s	Memory availability hint
Stop	yes	120s	Parse last turn from SQLite DB, summarize via claude -p, save to daily .md

Key env vars injected by ZCode:

• CLAUDE_SESSION_ID — session ID (template variable)
• ZCODE_PROJECT_DIR / CLAUDE_PROJECT_DIR — project working directory
• CLAUDE_PLUGIN_ROOT — plugin install directory (resolves ${CLAUDE_PLUGIN_ROOT} in hooks.json)

Architecture

The ZCode plugin closely follows the Codex plugin (shell hooks, no SessionEnd, main-context skill), with one key difference: session storage is SQLite, not JSONL. The parse-session.py script queries the message and part tables, groups messages into turns (user prompt → assistant response), renders text and tool-call parts, and omits reasoning blocks.

Summarization uses claude -p --model haiku (same as the Claude Code plugin) with recursion prevention via CLAUDECODE= and MEMSEARCH_IN_STOP_WORKER=1. Falls back to truncated raw text if claude -p is unavailable.

Memory anchors use the format <!-- session:<id> db:<path> --> (instead of rollout:/transcript:), enabling the memory-recall skill to drill back into the SQLite session database.

Changes

New: plugins/zcode/

• .claude-plugin/plugin.json — plugin manifest
• hooks/hooks.json — declares 3 hooks using ${CLAUDE_PLUGIN_ROOT} path resolution
• hooks/common.sh — env var resolution, JSON helpers, orphan cleanup, Milvus Lite lock handling
• hooks/stop.sh — async capture: SQLite session parsing → claude -p summarization → daily .md append
• hooks/session-start.sh — bootstrap, watch/index, cold-start injection
• hooks/user-prompt-submit.sh — memory availability hint
• scripts/parse-session.py — ZCode SQLite session parser
• scripts/derive-collection.sh, maintenance-runner.py — synced from _shared
• prompts/, skills/ — synced from _shared

Modified: core library

• src/memsearch/config.py — added zcode to PluginsConfig + key mappings
• src/memsearch/cli.py — added zcode to --plugin help, init wizard, summarize prompts
• plugins/_shared/scripts/maintenance-runner.py — added zcode to DEFAULT_NATIVE_MODELS

Modified: marketplace + shared sources

• .claude-plugin/marketplace.json — added memsearch-zcode entry
• plugins/_shared/skills/ — added zcode to platform lists + references/zcode.md
• scripts/sync-skills.sh, sync-prompts.sh — added zcode to sync arrays

Tests

• tests/test_zcode_parse_session.py — 4 tests (last turn, specific turn, nonexistent session, reasoning omission)
• tests/test_zcode_stop_hook.py — 3 tests (UTF-8 fallback, empty content skip, no session id)
• tests/test_config.py — zcode assertions in set/get roundtrip
• tests/test_maintenance_runner.py — zcode added to platform list
• tests/test_skills_sync.py — zcode added to FS_PLATFORMS

Docs

• docs/platforms/zcode/ — index, installation, how-it-works, memory-recall
• docs/platforms/index.md — added zcode to comparison table and cross-platform sharing section

Test results

365 passed, 7 skipped, 3 warnings in 48.98s

All existing tests pass, plus 7 new zcode-specific tests. Ruff is clean on all new/modified Python files (the 16 pre-existing ruff warnings in maintenance-runner.py and claude-code/transcript.py are unchanged).

Checklist

• Plugin follows the same architecture as existing shell-hook platforms (Codex)
• parse-session.py handles the SQLite session storage unique to ZCode
• Skills synced from _shared (not hand-edited in platform copies)
• Tests cover parse-session.py and stop.sh edge cases
• Docs follow the same structure as other platform docs
• All tests pass (uv run python -m pytest)
• Ruff passes on new/modified files
• Conventional commit message used