elevate

/rune:elevate — Promote Echoes to Global Scope

Promote project-level echoes to the global echo store with domain tagging. Elevated echoes become available across all projects via echo_search(query, scope="global").

Elevation is a copy, not a move. The original project echo remains untouched. Access history stays in the project DB — global entries start fresh tracking.

Prerequisites

• Project echoes must exist (.rune/echoes/ with MEMORY.md files)
• --scope <domain> argument is required (no default — prevents accidental bleed)

Allowed Domains

backend, frontend, devops, database, testing, architecture, general

Override via talisman.yml → echoes.global.domains.

Elevation Flow

Step 1: Parse and Validate Arguments

ARGUMENTS = $ARGUMENTS
if "--scope" not in ARGUMENTS:
    ERROR: "--scope <domain> is required. Valid domains: backend, frontend, devops, database, testing, architecture, general"
    EXIT

domain = extract value after --scope
Validate domain against allowed list

Step 2: Resolve Paths (CHOME Pattern)

CHOME = "${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
GLOBAL_MEMORY = "$CHOME/echoes/global/MEMORY.md"
GLOBAL_DIR = "$CHOME/echoes/global"
PROJECT_ECHOES = ".rune/echoes"

Never hardcode ~/.claude/.

Step 3: Scan Project Echoes

Read all MEMORY.md files in .rune/echoes/*/MEMORY.md via Glob.

For each file, parse entries using the header pattern:

## {Layer} — {Title} ({Date})

Filters (skip these entries):

• Entries with source: elevated:* — already elevated (EC-3.6: circular prevention)
• Entries with source: doc-pack:* — doc packs are managed separately
• Observations tier entries — too ephemeral for global scope

Step 4: Present Candidates

Use AskUserQuestion to present entries as a numbered list:

Project echoes available for elevation to global (domain: backend):

1. [etched] Rate Limiting Best Practice (2026-03-11) — planner
2. [inscribed] N+1 Query Detection Pattern (2026-03-10) — reviewer
3. [inscribed] Error Boundary Conventions (2026-03-09) — reviewer
4. [notes] Always use UTC timestamps (2026-03-08) — notes

Enter entry numbers to elevate (comma-separated), or 'all', or 'cancel':

Step 5: Dedup Check

For each selected entry, generate a content hash for dedup:

1. Strip metadata lines (**Source**:, **Category**:, **Domain**:, **Confidence**:)
2. Strip whitespace, lowercase remaining content
3. SHA-256 hash of cleaned content (full digest — SEC-P3-005)
4. Check against existing entries in GLOBAL_MEMORY
5. If hash matches existing entry: skip with message "Skipping '{title}' — already elevated"

Step 6: Entry Count Guard (EC-3.3)

Before appending, count existing elevated entries in GLOBAL_MEMORY (non-doc-pack entries).

If count + new entries > 50:

WARNING: Global MEMORY.md has {count} entries (limit: 50).
Elevating {new} more would exceed the limit.
Oldest elevated entries should be archived first.
Proceed anyway? (y/n)

Step 7: Append to Global MEMORY.md

For each entry passing dedup, append to $CHOME/echoes/global/MEMORY.md:

## Inscribed — {Original Title} ({Today's Date})

**Source**: `elevated:{project-name}@{original-role}`
**Category**: {original-category}
**Domain**: {domain from --scope}

{Original content body}

Rules:

• Layer becomes Inscribed (regardless of original layer)
• Source format: elevated:{project-basename}@{role} for audit trail
• Domain comes from --scope argument
• Date becomes today's date (elevation date, not original date)

Write safety (SEC-P3-006):

• Create lock dir: mkdir "$GLOBAL_DIR/.lock" 2>/dev/null — retry 3 times with 1s sleep
• Append content
• Release lock: rmdir "$GLOBAL_DIR/.lock"

Step 8: Signal and Confirm

1. Write dirty signal: touch "$CHOME/echoes/global/.global-echo-dirty"
2. Create global dir if needed: mkdir -p "$GLOBAL_DIR"
3. Confirm: "Elevated {N} entries to global scope (domain: {domain}). Skipped {M} duplicates."

Security

• SEC-P3-001: Domain argument validated against allowlist
• SEC-P3-003: Source MEMORY.md paths validated with realpath containment — must be under .rune/echoes/
• SEC-P3-006: Concurrent write protection via mkdir-based locking
• EC-3.6: Entries with source: elevated:* or source: doc-pack:* are skipped (no circular elevation)
• EC-3.3: Max 50 elevated entries in global MEMORY.md (doc packs are separate files, exempt)