test(spec): restructure envelope examples to match synthesize/edit model

Rename specification example files to align with synthesize/edit
envelope terminology and remove outdated operation types. Rename:
incremental-diff.json → edit-id-targeting.json, json-pointer-diff.json
→ edit-pointer-targeting.json, section-update.json → edit-section-replace.json.
Delete full-generation.json, composite.json, parallel-manifest.json,
chunked-stream.jsonl, and template-fill.json. Update edit-delegation.json
to reflect the new orchestrator -> maintain context -> apply engine flow
with lightweight handles.

Author: urmzd

spec/examples/chunked-stream.jsonl

@@ -1,122 +1,53 @@
 {
-  "_comment": "Full edit delegation cycle using envelope format for every message",
+  "_comment": "Edit delegation cycle showing orchestrator -> maintain context -> apply engine -> handle",
 
   "step_1_handle": {
-    "_description": "Orchestrator holds this envelope after artifact creation",
+    "_description": "Orchestrator holds this handle after artifact creation via init context",
     "protocol": "aap/0.1",
     "id": "dashboard-001",
     "version": 3,
     "name": "handle",
-    "operation": {"direction": "output", "format": "text/html", "updated_at": "2026-03-29T14:00:00Z", "state": "published"},
+    "meta": {"format": "text/html", "state": "published"},
     "content": [
-      {"sections": ["nav", "stats", "users", "orders"], "token_count": 10240}
+      {"id": "dashboard-001", "version": 3, "token_count": 10240}
     ]
   },
 
-  "step_2_projection": {
-    "_description": "Orchestrator requests and receives a structure projection — an envelope",
-    "protocol": "aap/0.1",
-    "id": "dashboard-001",
-    "version": 3,
-    "name": "projection",
-    "operation": {"direction": "output", "format": "text/html", "created_at": "2026-03-29T14:01:00Z"},
-    "content": [
-      {
-        "projection_type": "structure",
-        "token_count": 10240,
-        "outline": "HTML dashboard with 4 main sections",
-        "sections": [
-          {"id": "nav", "label": "Navigation", "token_count": 820, "summary": "Top nav bar with logo, search, and user menu"},
-          {"id": "stats", "label": "Statistics Cards", "token_count": 1200, "summary": "4 stat cards: users (1,247), revenue ($12,340), orders (312), uptime (99.7%)"},
-          {"id": "users", "label": "Users Table", "token_count": 5100, "summary": "Sortable table with 50 user rows"},
-          {"id": "orders", "label": "Orders Table", "token_count": 3120, "summary": "Sortable table with 30 order rows"}
-        ]
-      }
-    ]
-  },
-
-  "step_3_edit_intent": {
-    "_description": "Orchestrator sends edit intent — an input envelope with parallel intents",
-    "protocol": "aap/0.1",
-    "id": "dashboard-001",
-    "version": 3,
-    "name": "intent",
-    "operation": {"direction": "input", "format": "text/html"},
-    "content": [
-      {
-        "intent": "Update the revenue stat card to show $15,720 and the orders count to 384",
-        "target_sections": ["stats"],
-        "constraints": {"preserve_structure": true, "mode_hint": "diff"}
-      }
-    ]
-  },
-
-  "step_3_internal_dispatch": {
-    "_description": "What happens inside the edit operation (not visible to orchestrator)",
+  "step_2_maintain_context": {
+    "_description": "Maintain context receives artifact + message, produces edit envelope (not visible to orchestrator)",
 
-    "maintain_agent_context": {
-      "system_prompt": "You are a maintain-agent. Produce AAP diff envelopes to apply the requested change.",
+    "maintain_context_input": {
+      "system_prompt": "You are an AAP maintain context. Given an artifact and an edit instruction, produce a name: \"edit\" envelope.",
       "artifact_injected": "(full HTML content of dashboard-001 v3 — ~10,240 tokens)",
-      "intent": "Update the revenue stat card to show $15,720 and the orders count to 384"
+      "message": "Update the revenue stat card to show $15,720 and the orders count to 384"
     },
 
-    "maintain_agent_output": {
+    "maintain_context_output": {
       "protocol": "aap/0.1",
       "id": "dashboard-001",
       "version": 4,
-      "name": "diff",
-      "operation": {"direction": "output", "format": "text/html", "tokens_used": 65},
+      "name": "edit",
+      "meta": {"format": "text/html", "tokens_used": 65},
       "content": [
-        {"op": "replace", "target": {"search": "$12,340"}, "content": "$15,720"},
-        {"op": "replace", "target": {"search": "<span class=\"stat-value\">312</span>"}, "content": "<span class=\"stat-value\">384</span>"}
+        {"op": "replace", "target": {"type": "id", "value": "revenue-value"}, "content": "$15,720"},
+        {"op": "replace", "target": {"type": "id", "value": "orders-count"}, "content": "384"}
       ]
-    },
-
-    "apply_engine": "Resolves diff operations against stored v3 content → produces v4 (CPU, 0 tokens, ~2μs)"
+    }
   },
 
-  "step_4_edit_result": {
-    "_description": "Orchestrator receives result envelope — summary of changes + updated handle",
-    "protocol": "aap/0.1",
-    "id": "dashboard-001",
-    "version": 4,
-    "name": "result",
-    "operation": {"direction": "output", "format": "text/html", "tokens_used": 65, "checksum": "sha256:b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3"},
-    "content": [
-      {
-        "status": "applied",
-        "mode_used": "diff",
-        "changes": [
-          {"section_id": "stats", "description": "Updated revenue from $12,340 to $15,720 and orders from 312 to 384"}
-        ]
-      }
-    ]
+  "step_3_apply_engine": {
+    "_description": "Apply engine resolves edit operations against stored v3 content -> produces v4 artifact + handle (CPU, 0 tokens, ~2us)"
   },
 
-  "step_5_audit": {
-    "_description": "Audit entry — also an envelope",
+  "step_4_handle_returned": {
+    "_description": "Orchestrator receives updated handle — never sees the artifact content",
     "protocol": "aap/0.1",
     "id": "dashboard-001",
     "version": 4,
-    "name": "audit",
-    "operation": {"direction": "output"},
+    "name": "handle",
+    "meta": {"format": "text/html", "state": "published"},
     "content": [
-      {
-        "entry_id": "audit-dash001-004",
-        "operation": "edit",
-        "actor": "agent:orchestrator",
-        "timestamp": "2026-03-29T14:02:00Z",
-        "version_before": 3,
-        "version_after": 4,
-        "status": "success",
-        "tokens_used": 65,
-        "detail": {
-          "intent": "Update the revenue stat card to show $15,720 and the orders count to 384",
-          "target_sections": ["stats"],
-          "mode_used": "diff",
-          "changes": [{"section_id": "stats", "description": "Updated revenue from $12,340 to $15,720 and orders from 312 to 384"}]
-        }
-      }
+      {"id": "dashboard-001", "version": 4, "token_count": 10240}
     ]
   }
 }

spec/examples/composite.json

@@ -2,22 +2,20 @@
   "protocol": "aap/0.1",
   "id": "dashboard-001",
   "version": 2,
-  "name": "diff",
-  "operation": {
-    "direction": "output",
+  "name": "edit",
+  "meta": {
     "format": "text/html",
-    "updated_at": "2026-03-29T10:05:00Z",
     "tokens_used": 42
   },
   "content": [
     {
       "op": "replace",
-      "target": {"search": "<span class=\"stat-value\">$12,340</span>"},
+      "target": {"type": "id", "value": "revenue-value"},
       "content": "<span class=\"stat-value\">$15,720</span>"
     },
     {
       "op": "replace",
-      "target": {"search": "<span class=\"stat-value\">1,205</span>"},
+      "target": {"type": "id", "value": "user-count"},
       "content": "<span class=\"stat-value\">1,342</span>"
     }
   ]

spec/examples/edit-delegation.json

@@ -2,25 +2,24 @@
   "protocol": "aap/0.1",
   "id": "config-001",
   "version": 2,
-  "name": "diff",
-  "operation": {
-    "direction": "output",
+  "name": "edit",
+  "meta": {
     "format": "application/json"
   },
   "content": [
     {
       "op": "replace",
-      "target": {"pointer": "/database/host"},
+      "target": {"type": "pointer", "value": "/database/host"},
       "content": "\"prod-db.example.com\""
     },
     {
       "op": "replace",
-      "target": {"pointer": "/features/dark_mode"},
+      "target": {"type": "pointer", "value": "/features/dark_mode"},
       "content": "true"
     },
     {
       "op": "delete",
-      "target": {"pointer": "/deprecated_field"}
+      "target": {"type": "pointer", "value": "/deprecated_field"}
     }
   ]
 }

spec/examples/incremental-diff.json spec/examples/edit-id-targeting.jsonspec/examples/incremental-diff.json renamed to spec/examples/edit-id-targeting.json

@@ -2,16 +2,15 @@
   "protocol": "aap/0.1",
   "id": "dashboard-001",
   "version": 3,
-  "name": "section",
-  "operation": {
-    "direction": "output",
+  "name": "edit",
+  "meta": {
     "format": "text/html",
-    "updated_at": "2026-03-29T10:10:00Z",
     "tokens_used": 95
   },
   "content": [
     {
-      "id": "users-table",
+      "op": "replace",
+      "target": {"type": "id", "value": "users-table"},
       "content": "<table>\n  <tr><th>Name</th><th>Email</th><th>Role</th><th>Status</th></tr>\n  <tr><td>Alice</td><td>alice@example.com</td><td>Admin</td><td>Active</td></tr>\n  <tr><td>Bob</td><td>bob@example.com</td><td>User</td><td>Active</td></tr>\n  <tr><td>Charlie</td><td>charlie@example.com</td><td>User</td><td>Inactive</td></tr>\n  <tr><td>Dana</td><td>dana@example.com</td><td>Editor</td><td>Active</td></tr>\n</table>"
     }
   ]

spec/examples/json-pointer-diff.json spec/examples/edit-pointer-targeting.jsonspec/examples/json-pointer-diff.json renamed to spec/examples/edit-pointer-targeting.json

@@ -0,0 +1,15 @@
+{
+  "protocol": "aap/0.1",
+  "id": "dashboard-001",
+  "version": 1,
+  "name": "synthesize",
+  "meta": {
+    "format": "text/html",
+    "tokens_used": 210
+  },
+  "content": [
+    {
+      "body": "<!DOCTYPE html>\n<html>\n<head><title>Dashboard</title></head>\n<body>\n<aap:target id=\"stats\">\n<div class=\"stats\">\n  <div class=\"stat\"><span class=\"label\">Revenue</span><aap:target id=\"revenue-value\"><span class=\"stat-value\">$12,340</span></aap:target></div>\n  <div class=\"stat\"><span class=\"label\">Users</span><aap:target id=\"user-count\"><span class=\"stat-value\">1,205</span></aap:target></div>\n</div>\n</aap:target>\n<aap:target id=\"users-table\">\n<table>\n  <tr><th>Name</th><th>Email</th><th>Role</th></tr>\n  <tr><td>Alice</td><td>alice@example.com</td><td>Admin</td></tr>\n  <tr><td>Bob</td><td>bob@example.com</td><td>User</td></tr>\n</table>\n</aap:target>\n<aap:target id=\"orders-table\">\n<table>\n  <tr><th>Order</th><th>Product</th><th>Amount</th></tr>\n  <tr><td>#001</td><td>Widget</td><td>$29.99</td></tr>\n</table>\n</aap:target>\n</body>\n</html>"
+    }
+  ]
+}