feat(symphony): add Symphony orchestrator integration for cross-workspace context persistence

- CLI commands: capture, restore, archive, search for managing cross-run context
- Hook scripts: after-create (init+restore), after-run (capture), before-remove (archive)
- Global SQLite database at ~/.stackmemory/symphony/ for cross-workspace storage
- WORKFLOW.md template documenting integration setup
- Tests covering capture, restore, archive, search, and hook script validation

Author: StackMemory Bot (CLI)

scripts/symphony/WORKFLOW.md

@@ -0,0 +1,63 @@
+# StackMemory + Symphony Integration
+
+## Overview
+
+StackMemory provides persistent agent memory across Symphony workspace lifecycle events.
+When Symphony creates a workspace for an issue, StackMemory restores context from prior
+attempts. After each run, it captures context. Before workspace removal, it archives everything.
+
+## Hook Configuration
+
+Add to your Symphony `config.toml`:
+
+```toml
+[hooks]
+after_create = "scripts/symphony/after-create.sh"
+after_run = "scripts/symphony/after-run.sh"
+before_remove = "scripts/symphony/before-remove.sh"
+```
+
+## Environment Variables
+
+Symphony sets these automatically:
+
+| Variable | Description | Example |
+|---|---|---|
+| `SYMPHONY_WORKSPACE_DIR` | Workspace path | `/tmp/symphony/STA-476` |
+| `SYMPHONY_ISSUE_ID` | Internal issue ID | `uuid-string` |
+| `SYMPHONY_ISSUE_IDENTIFIER` | Human-readable ID | `STA-476` |
+| `SYMPHONY_ATTEMPT` | Current attempt number | `1` |
+
+## Lifecycle
+
+```
+Issue assigned
+  → after_create: stackmemory init + restore prior context
+  → agent runs...
+  → after_run: capture frames/anchors/events to global store
+  → (repeat for retries, attempt increments)
+  → before_remove: archive full context, workspace deleted
+```
+
+## Manual Commands
+
+```bash
+# Capture context from a workspace
+stackmemory symphony capture --issue STA-476 --workspace /path/to/ws --attempt 1
+
+# Restore prior context into workspace
+stackmemory symphony restore --issue STA-476 --workspace /path/to/ws
+
+# Archive before deletion
+stackmemory symphony archive --issue STA-476 --workspace /path/to/ws
+
+# Search across all issue contexts
+stackmemory symphony search "database migration"
+```
+
+## Storage
+
+Global context stored at `~/.stackmemory/symphony/context.db` (SQLite).
+Per-workspace context at `<workspace>/.stackmemory/context.db`.
+
+The global database persists across workspace deletions, enabling cross-attempt learning.

scripts/symphony/after-create.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Symphony after_create hook
+# Initializes StackMemory in the workspace directory
+# Called once when Symphony creates a new workspace for an issue
+#
+# Environment: SYMPHONY_WORKSPACE_DIR, SYMPHONY_ISSUE_ID, SYMPHONY_ISSUE_IDENTIFIER
+set -euo pipefail
+
+WORKSPACE="${SYMPHONY_WORKSPACE_DIR:-$(pwd)}"
+ISSUE_ID="${SYMPHONY_ISSUE_IDENTIFIER:-${SYMPHONY_ISSUE_ID:-unknown}}"
+
+cd "$WORKSPACE"
+
+# Initialize StackMemory if not already present
+if [ ! -d ".stackmemory" ]; then
+  stackmemory init 2>/dev/null || true
+fi
+
+# Restore relevant context from prior runs on this issue
+stackmemory symphony restore --issue "$ISSUE_ID" --workspace "$WORKSPACE" 2>/dev/null || true
+
+echo "[stackmemory] Workspace initialized for $ISSUE_ID"

scripts/symphony/after-run.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+# Symphony after_run hook
+# Captures context from the agent run and tags it with the issue identifier
+# Called after each agent attempt (success or failure)
+#
+# Environment: SYMPHONY_WORKSPACE_DIR, SYMPHONY_ISSUE_ID, SYMPHONY_ISSUE_IDENTIFIER
+set -euo pipefail
+
+WORKSPACE="${SYMPHONY_WORKSPACE_DIR:-$(pwd)}"
+ISSUE_ID="${SYMPHONY_ISSUE_IDENTIFIER:-${SYMPHONY_ISSUE_ID:-unknown}}"
+ATTEMPT="${SYMPHONY_ATTEMPT:-1}"
+
+cd "$WORKSPACE"
+
+# Capture context from this run, tagged with issue ID and attempt number
+stackmemory symphony capture \
+  --issue "$ISSUE_ID" \
+  --workspace "$WORKSPACE" \
+  --attempt "$ATTEMPT" \
+  2>/dev/null || true
+
+echo "[stackmemory] Context captured for $ISSUE_ID (attempt $ATTEMPT)"

scripts/symphony/before-remove.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+# Symphony before_remove hook
+# Archives workspace context before Symphony deletes the workspace
+# Called when the issue reaches a terminal state
+#
+# Environment: SYMPHONY_WORKSPACE_DIR, SYMPHONY_ISSUE_ID, SYMPHONY_ISSUE_IDENTIFIER
+set -euo pipefail
+
+WORKSPACE="${SYMPHONY_WORKSPACE_DIR:-$(pwd)}"
+ISSUE_ID="${SYMPHONY_ISSUE_IDENTIFIER:-${SYMPHONY_ISSUE_ID:-unknown}}"
+
+cd "$WORKSPACE"
+
+# Archive context to global store before workspace deletion
+stackmemory symphony archive \
+  --issue "$ISSUE_ID" \
+  --workspace "$WORKSPACE" \
+  2>/dev/null || true
+
+echo "[stackmemory] Context archived for $ISSUE_ID"