Implement multi-glyph resonance system for XIC v1.5 (6 phases)

Complete end-to-end multi-glyph resonance enabling simultaneous analysis
of multiple glyphs with cross-glyph resonance metrics, guardrails, and
comprehensive telemetry.

## Phase 1: XIC Layer - Context Accumulation

### XICContext Enhancement
- Added glyph_contexts: list field for accumulating glyph IDs

### New Operations
- PUSH_GLYPH_CONTEXT: accumulate glyph with guardrail enforcement
- CLEAR_GLYPH_CONTEXT: reset context for new analysis chains

### Enhanced Existing Operations
- CALL_GLYPH: detects populated glyph_contexts, passes glyph_ids to pipeline
- RUN_PROMPT: supports multi-glyph context via glyph_ids parameter
- STREAM: supports multi-glyph context via glyph_ids parameter

### Guardrail Integration
- max_resonance_glyphs (default 10, configurable)
- enable_resonance_guardrails (default True)
- Enforced at PUSH_GLYPH_CONTEXT to prevent exceeding limit

## Phase 2: Symbolic Pipeline - Multi-Glyph Support

### Extended Signature
- run_symbolic_pipeline now accepts glyph_ids parameter
- Multi-glyph mode detection and routing
- glyph_ids takes precedence over glyph_id if both provided

### Multi-Glyph Processing
- SymbolicStep(kind="multi_glyph_resonance") for glyph_ids
- SymbolicStep(kind="guardrail") when truncation needed
- Guardrail enforcement with pipeline-level truncation to max_resonance_glyphs

### Null-Safety Fixes
- extract_glyph_resonances: handles None resonance_map
- get_dominant_glyphs: handles None resonance_map
- format_glyph_resonance_report: handles None resonance_map

## Phase 3: LAIN Cognitive Kernel - Resonance Computation

### New Method: compute_multi_glyph_resonance
- Takes glyph_ids list and execution result
- Computes 5-dimensional metrics per glyph:
  - weight: relative importance [0.0, 1.0]
  - lineage_score: symbolic ancestry [0.0, 1.0]
  - contributor_score: contribution to fusion [0.0, 1.0]
  - frequency_score: occurrence frequency [0.0, 1.0]
  - grammar_score: structural alignment [0.0, 1.0]
- Returns global_resonance_score as weighted average

### Enhanced execute_symbolic
- Detects context["glyph_ids"] for multi-glyph mode
- Post-processes LAIN result via compute_multi_glyph_resonance
- Merges multi-glyph metrics into fused_symbol
- Maintains backward compatibility (single-glyph unaffected)

## Phase 4: Guardrails & Telemetry

### Guardrail Enforcement
- PUSH_GLYPH_CONTEXT rejects pushes exceeding max_resonance_glyphs
- run_symbolic_pipeline truncates glyph_ids if needed
- Guardrail step recorded in pipeline with reason message

### Telemetry Collection
- ctx._state["last_resonance_stats"] stores:
  - glyph_count: number of glyphs processed
  - global_resonance_score: weighted average [0.0, 1.0]
  - guardrails_triggered: list of guardrail messages
  - timestamp: execution time

## Phase 5: Validation Suite

### 12 Comprehensive Tests (all passing)
1. New operations in OP_TABLE
2. XICContext.glyph_contexts field
3. PUSH_GLYPH_CONTEXT accumulation
4. CLEAR_GLYPH_CONTEXT reset
5. Guardrail enforcement on PUSH
6. run_symbolic_pipeline signature
7. compute_multi_glyph_resonance method
8. Multi-glyph resonance structure
9. execute_symbolic multi-glyph processing
10. Single-glyph backward compatibility
11. Demo programs validity
12. Multi-glyph demo structure

### Test File: test_multi_glyph_resonance.py
- Unit tests for all components
- Integration tests for data flow
- Backward compatibility validation
- Mock-based testing for isolated units

## Phase 6: Documentation

### Updated XIC_SEMANTICS_v1_5.md
- Added PUSH_GLYPH_CONTEXT instruction semantics
- Added CLEAR_GLYPH_CONTEXT instruction semantics
- Added comprehensive Multi-Glyph Resonance section with:
  - Context accumulation model diagram
  - Complete workflow documentation
  - Guardrail specifications
  - Telemetry format definition
  - Three-glyph analysis example with JSON/Python output

### Created demo_multi_glyph_resonance.gx.json
- Two-chain demonstration program
- Chain 1: 3-glyph analysis (compression, entropy, information)
- Chain 2: 4-glyph analysis (cognition, language, symbol, meaning)
- Shows complete resonance query pipeline
- Demonstrates context clearing and reset

### Created XIC_MULTI_GLYPH_RESONANCE_REPORT.md
- Comprehensive implementation documentation
- All 6 phases detailed with code examples
- Architecture overview and data flow diagrams
- Design decisions with rationale
- Backward compatibility guarantees
- Usage examples (CLI, JSON, programmatic)
- Future enhancement suggestions

## Key Features

✅ Explicit context accumulation (PUSH_GLYPH_CONTEXT)
✅ Automatic multi-glyph detection in CALL_GLYPH/RUN_PROMPT/STREAM
✅ Guardrails prevent exceeding max_resonance_glyphs
✅ Telemetry tracking for analytics
✅ Full backward compatibility maintained
✅ Single-glyph mode unaffected
✅ Comprehensive validation suite (12/12 tests passing)
✅ Complete formal specification updates
✅ Demo program showcase

## Backward Compatibility

- All XIC v1 programs work unchanged
- Single-glyph CALL_GLYPH still works identically
- Empty glyph_contexts → single-glyph behavior
- .gx binary format unchanged
- No breaking changes to APIs

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>

XIC_SEMANTICS_v1_5.md

@@ -50,7 +50,7 @@ Dual paths:
 
 ---
 
-## Instruction Semantics
+## Instruction Semantics (12 Instructions)
 
 ### 1. LOAD_MODEL
 
@@ -284,7 +284,54 @@ Dual paths:
 
 ---
 
-### 10. GET_GLYPH_RESONANCE
+### 10. PUSH_GLYPH_CONTEXT
+
+**Signature**
+```json
+{ "op": "PUSH_GLYPH_CONTEXT", "args": ["<glyph_id>"] }
+```
+
+**Preconditions**
+- `glyph_id` must be a valid string identifier.
+
+**Postconditions**
+- `glyph_id` is appended to `ctx.glyph_contexts` list (if not already present).
+- If `ctx.glyph_contexts` reaches `max_resonance_glyphs` (default 10), further pushes are rejected by guardrails.
+
+**Side effects**
+- Prints `[XIC-MULTI-GLYPH] Pushed glyph context: <glyph_id> (total: N)`
+- If guardrail triggered: prints `[XIC-GUARDRAIL] Resonance glyph count at limit (N)`
+
+**Remarks**
+- Used to accumulate glyphs for multi-glyph resonance computation.
+- Duplicates are ignored (idempotent).
+- Works only in symbolic mode.
+
+---
+
+### 11. CLEAR_GLYPH_CONTEXT
+
+**Signature**
+```json
+{ "op": "CLEAR_GLYPH_CONTEXT", "args": [] }
+```
+
+**Preconditions**
+- None.
+
+**Postconditions**
+- `ctx.glyph_contexts` list is emptied.
+
+**Side effects**
+- Prints `[XIC-MULTI-GLYPH] Cleared glyph context (N glyphs removed)`
+
+**Remarks**
+- Use to reset context before starting a new multi-glyph analysis chain.
+- No effect if context is already empty.
+
+---
+
+### 12. GET_GLYPH_RESONANCE
 
 **Signature**
 ```json
@@ -406,6 +453,115 @@ From XIC programs:
 
 ---
 
+## Multi-Glyph Resonance
+
+### Context Accumulation Model
+
+Multi-glyph resonance enables simultaneous analysis of multiple glyphs with cross-glyph resonance metrics:
+
+```
+PUSH_GLYPH_CONTEXT "glyph://a"
+PUSH_GLYPH_CONTEXT "glyph://b"
+PUSH_GLYPH_CONTEXT "glyph://c"
+    ↓
+ctx.glyph_contexts = ["glyph://a", "glyph://b", "glyph://c"]
+    ↓
+CALL_GLYPH "glyph://unified" "prompt"
+    ↓
+run_symbolic_pipeline(prompt, glyph_ids=["glyph://a", "glyph://b", "glyph://c"])
+    ↓
+LAIN computes multi-glyph resonance metrics
+    ↓
+fused_symbol contains:
+  - glyph_ids: ["glyph://a", "glyph://b", "glyph://c"]
+  - resonance_map: {glyph_id → GlyphResonanceMetrics}
+  - global_resonance_score: weighted average across all glyphs
+```
+
+### Workflow
+
+1. **PUSH_GLYPH_CONTEXT**: Accumulate glyph IDs in `ctx.glyph_contexts`
+2. **CALL_GLYPH**: Detects populated context, passes `glyph_ids` to pipeline
+3. **run_symbolic_pipeline**: Routes to multi-glyph mode (glyph_ids parameter)
+4. **execute_symbolic**: Computes multi-glyph resonance via `compute_multi_glyph_resonance()`
+5. **fused_symbol**: Contains metrics for all glyphs in unified resonance space
+6. **CLEAR_GLYPH_CONTEXT**: Reset context for new analysis
+
+### Guardrails
+
+- `max_resonance_glyphs`: Default 10, configurable via SET_PARAM
+- `enable_resonance_guardrails`: Default True, set via SET_PARAM
+- If `len(glyph_ids) > max_resonance_glyphs`:
+  - Truncated to first N glyphs
+  - SymbolicStep(kind="guardrail") recorded
+  - Message printed: `[XIC-GUARDRAIL] ...`
+
+### Telemetry
+
+When multi-glyph CALL_GLYPH executes, telemetry stored in:
+
+```python
+ctx._state["last_resonance_stats"] = {
+    "glyph_count": len(multi_glyph_ids),
+    "global_resonance_score": float,
+    "guardrails_triggered": [list of strings],
+    "timestamp": float,
+}
+```
+
+### Example: Three-Glyph Analysis
+
+```json
+{
+  "op": "SET_MODE",
+  "args": ["symbolic"]
+}
+{
+  "op": "PUSH_GLYPH_CONTEXT",
+  "args": ["glyph://compression"]
+}
+{
+  "op": "PUSH_GLYPH_CONTEXT",
+  "args": ["glyph://entropy"]
+}
+{
+  "op": "PUSH_GLYPH_CONTEXT",
+  "args": ["glyph://information"]
+}
+{
+  "op": "CALL_GLYPH",
+  "args": ["glyph://unified", "How do these three glyphs relate?"]
+}
+{
+  "op": "GET_GLYPH_RESONANCE",
+  "args": ["glyph://unified", "report"]
+}
+{
+  "op": "CLEAR_GLYPH_CONTEXT",
+  "args": []
+}
+```
+
+Result in `ctx._state["glyph_glyph://unified"]`:
+```python
+{
+    "multi_glyph": True,
+    "output_text": "...",
+    "fused_symbol": {
+        "summary": "...",
+        "glyph_ids": ["glyph://compression", "glyph://entropy", "glyph://information"]
+    },
+    "resonance_metrics": {
+        "glyph://compression": {"weight": 0.95, "lineage_score": 0.82, ...},
+        "glyph://entropy": {"weight": 0.73, "lineage_score": 0.68, ...},
+        "glyph://information": {"weight": 0.81, "lineage_score": 0.75, ...},
+    },
+    "global_resonance_score": 0.83,
+}
+```
+
+---
+
 ## Symbolic Pipeline Semantics
 
 ### run_symbolic_pipeline() Entrypoint