@gluecharm-lab/easyspecs-cli 0.0.14 → 0.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gluecharm-lab/easyspecs-cli",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "description": "EasySpecs headless CLI (synthesis, analysis, diagnose, download/upload context, auth, ACE)",
   "license": "Elastic-2.0",
   "homepage": "https://easyspecs.ai/",

package/resources/opencode-agents/agent-ace-curator.md

@@ -29,3 +29,6 @@ Each operation’s **`sourceLessonIds`** must list the contributing **`lessonId`
 **When `operations` may stay `[]`:** every lesson is **`noise`** or redundant with an **existing** rule/overlay (same intent already present — read full playbook/overlay files if excerpts are truncated), or promoting would **duplicate** without adding clarity.
 
 **Do not** emit `append` rules that merely restate generic advice already obvious from the base agent doc; prefer lessons grounded in **this repo’s** trace.
+
+## Referenced implementation files
+- architecture.md:1-12

package/resources/opencode-agents/agent-context-drift-compare.md

@@ -0,0 +1,48 @@
+# Agent: Context drift comparison
+
+| Field | Value |
+| ----- | ----- |
+| **AGENT_ID** | `ctx-context-drift-compare` |
+| **Display name** | Context drift comparison |
+| **SRS-56** | Compare reference docs to repository evidence; emit JSON payload |
+
+## Responsibility
+
+**`.opencode/` exclusion:** Do not cite `.opencode/` paths as product evidence.
+
+The prompt file gives **absolute paths** to:
+
+1. A **manifest JSON** (reference excerpts + evidence snippets/paths).
+2. The **output JSON path** you **must write**.
+
+Read the manifest, explore the worktree as needed (`grep`, `read`, `glob`) to ground claims, then write **only** valid JSON to the output path.
+
+## Output JSON (mandatory)
+
+Write **only** this object shape (no markdown wrapper, no commentary):
+
+```json
+{
+  "summary": "2-6 sentences: overall drift picture.",
+  "findings": [
+    {
+      "severity": "warn",
+      "title": "Short label",
+      "detail": "What diverges and why it matters.",
+      "referenceRefs": "optional: SRS § or doc path",
+      "evidenceRefs": "optional: src/ path or test"
+    }
+  ],
+  "unverifiable": ["item the manifest could not confirm"],
+  "truncationAck": true
+}
+```
+
+- **severity** must be **`info`**, **`warn`**, or **`error`**.
+- **findings** may be empty if the reference fully matches evidence.
+- **truncationAck** must be **`true`** if the manifest indicates truncation; otherwise **`false`**.
+- **unverifiable** may be empty.
+
+## Failure modes
+
+If you cannot produce valid JSON, still write a minimal object with **`summary`** explaining failure, **`findings: []`**, **`unverifiable: ["…"]`**, **`truncationAck: false`**.

package/resources/opencode-agents/agent-list-data-model.md

@@ -23,6 +23,10 @@ Emit **entities only** (`DM-*` with **`name`** and **`slug`** for **`DM-<nn>-<sl
 
 Coordination output is **JSON** (no markdown `##` headings in the artifact). Maintain an append-only root **`revisionLog`** array (see schema): each pass that **adds, merges, refines, or rewrites** rows must **append** at least `{ "summary": "…" }` (optional `"at"` ISO-8601). **Never delete** prior `revisionLog` entries. Prefer emitting **`revisionLog`** once the file holds real content; keep it updated alongside **Incremental JSON** writes.
 
+## SRS-50 — Stable coordination writes
+
+EasySpecs **merge-by-code** after the run: **existing codes** keep their **previous file order**; **new** codes are moved to the **end** of each coded array (including nested BH/ME/FD/RL rows under the correct parent). **Append** new rows at the end while authoring.
+
 ## Task (for `{{LIST_TASK_DESCRIPTION}}`)
 
 Derive **entity-level** persistent/domain concepts from schema, migrations, ORM models, or types **only where they exist** in the worktree. Each entity row: **`code`**, **`name`**, **`slug`**, optional **`description`**, optional **`order`**, and **required** **`sourceReferences`** with **`minItems: 1`** (`path`, `startLine`, `endLine`, optional `note`). Any inline **`fields`** / **`relationships`** rows (if present) **must** also include non-empty **`sourceReferences`**. **`path`** is always a **single file**, never a folder.

package/resources/opencode-agents/agent-list-entity-fields.md

@@ -23,6 +23,10 @@ For **one entity** already fixed in `data-model-list.json`, emit all **fields**
 
 Coordination output is **JSON** (no markdown `##` headings in the artifact). Maintain an append-only root **`revisionLog`** array (see schema): each pass that **adds, merges, refines, or rewrites** field rows must **append** at least `{ "summary": "…" }` (optional `"at"` ISO-8601). **Never delete** prior `revisionLog` entries. Prefer emitting **`revisionLog`** once the file holds real content; keep it updated alongside **Incremental JSON** writes.
 
+## SRS-50 — Stable coordination writes
+
+EasySpecs **merge-by-code** after the run: **existing codes** keep their **previous file order**; **new** codes are moved to the **end** of each coded array (including nested BH/ME/FD/RL rows under the correct parent). **Append** new rows at the end while authoring.
+
 ## Task (for `{{LIST_TASK_DESCRIPTION}}`)
 
 The orchestrator fills the task line with the target **DM-** code and output basename. Enumerate attributes, columns, or properties for **that entity only**. Do not change **`entityCode`**.

package/resources/opencode-agents/agent-list-experiences.md

@@ -65,6 +65,10 @@ Assign stable **`code`** values per srs-4 Experience scope, fill **`sourceRefere
 
 Coordination output is **JSON** (no markdown `##` headings in the artifact). Maintain an append-only root **`revisionLog`** array (see schema): each pass that **adds, merges, refines, or rewrites** rows must **append** at least `{ "summary": "…" }` (optional `"at"` ISO-8601). **Never delete** prior `revisionLog` entries. Prefer emitting **`revisionLog`** once the file holds real content; keep it updated alongside **Incremental JSON** writes.
 
+## SRS-50 — Stable coordination writes
+
+EasySpecs **merge-by-code** after the run: **existing codes** keep their **previous file order**; **new** codes are moved to the **end** of each coded array (including nested BH/ME/FD/RL rows under the correct parent). **Append** new rows at the end while authoring.
+
 ## Task (for `{{LIST_TASK_DESCRIPTION}}`)
 
 Run the **reasoning workflow**, then discover **only** user-facing surfaces and interactions **evidenced in the repo**. Assign stable **`code`** values consistent with srs-4 Experience scope.

package/resources/opencode-agents/agent-list-features.md

@@ -23,6 +23,10 @@ Emit the **canonical registry of features**: stable **`code`** (`FE-01` …), hu
 
 Coordination output is **JSON** (no markdown `##` headings in the artifact). Maintain an append-only root **`revisionLog`** array (see schema): each pass that **adds, merges, refines, or rewrites** rows must **append** at least `{ "summary": "…" }` (optional `"at"` ISO-8601). **Never delete** prior `revisionLog` entries. Prefer emitting **`revisionLog`** once the file holds real content; keep it updated alongside **Incremental JSON** writes.
 
+## SRS-50 — Stable coordination writes
+
+EasySpecs **merge-by-code** after the run: **existing codes** keep their **previous file order**; **new** codes are moved to the **end** of each coded array (including nested BH/ME/FD/RL rows under the correct parent). **Append** new rows at the end while authoring.
+
 ## Task (for `{{LIST_TASK_DESCRIPTION}}`)
 
 Produce **`features-list.json`** by **discovering every meaningful feature or capability** this repository implements—not a quick skim of `README.md`. Each row must be suitable for driving downstream use-case and scenario work. Do **not** write markdown lists; output **one JSON file** only.

package/resources/opencode-agents/agent-list-scenarios.md

@@ -25,6 +25,10 @@ For one **use case**, emit all **scenarios** (`SC-*`). Barrier for parallel **`F
 
 Coordination output is **JSON** (no markdown `##` headings in the artifact). Maintain an append-only root **`revisionLog`** array (see schema): each pass that **adds, merges, refines, or rewrites** rows must **append** at least `{ "summary": "…" }` (optional `"at"` ISO-8601). **Never delete** prior `revisionLog` entries. Prefer emitting **`revisionLog`** once the file holds real content; keep it updated alongside **Incremental JSON** writes.
 
+## SRS-50 — Stable coordination writes
+
+EasySpecs **merge-by-code** after the run: **existing codes** keep their **previous file order**; **new** codes are moved to the **end** of each coded array (including nested BH/ME/FD/RL rows under the correct parent). **Append** new rows at the end while authoring.
+
 ## Task (for `{{LIST_TASK_DESCRIPTION}}`)
 
 List concrete scenarios (flows, test-like paths, edge cases) for **feature {{FE_CODE}}**, **use case {{UC_CODE}}**. Do not alter parent codes. Aim for **multiple** scenarios when the implementation or tests support distinct paths (see **Cardinality** under Responsibility). Each scenario **must** include **`sourceReferences`** with **`minItems: 1`** (`path`, `startLine`, `endLine`, optional `note`). **`path`** is always one **file**, never a folder; split folder evidence across multiple entries.

package/resources/opencode-agents/agent-list-services.md

@@ -23,6 +23,10 @@ Emit **services** (`SV-*`) and **methods** (`ME-*`) as a structured list (method
 
 Coordination output is **JSON** (no markdown `##` headings in the artifact). Maintain an append-only root **`revisionLog`** array (see schema): each pass that **adds, merges, refines, or rewrites** rows must **append** at least `{ "summary": "…" }` (optional `"at"` ISO-8601). **Never delete** prior `revisionLog` entries. Prefer emitting **`revisionLog`** once the file holds real content; keep it updated alongside **Incremental JSON** writes.
 
+## SRS-50 — Stable coordination writes
+
+EasySpecs **merge-by-code** after the run: **existing codes** keep their **previous file order**; **new** codes are moved to the **end** of each coded array (including nested BH/ME/FD/RL rows under the correct parent). **Append** new rows at the end while authoring.
+
 ## Task (for `{{LIST_TASK_DESCRIPTION}}`)
 
 Identify bounded contexts, APIs, backend services, or modules that expose callable operations. Assign stable **`SV-*`** and **`ME-*`** codes and names. Each **service** and each **method** **must** include **`sourceReferences`** with **`minItems: 1`** (`path`, `startLine`, `endLine`, optional `note`). **`path`** must be a **file** path only, not a module directory; one array element per file.

package/resources/opencode-agents/agent-list-tech-stack.md

@@ -23,6 +23,10 @@ Emit **tools** (`TS-*`): languages, frameworks, infra, key libraries. Usually on
 
 Coordination output is **JSON** (no markdown `##` headings in the artifact). Maintain an append-only root **`revisionLog`** array (see schema): each pass that **adds, merges, refines, or rewrites** rows must **append** at least `{ "summary": "…" }` (optional `"at"` ISO-8601). **Never delete** prior `revisionLog` entries. Prefer emitting **`revisionLog`** once the file holds real content; keep it updated alongside **Incremental JSON** writes.
 
+## SRS-50 — Stable coordination writes
+
+EasySpecs **merge-by-code** after the run: **existing codes** keep their **previous file order**; **new** codes are moved to the **end** of each coded array (including nested BH/ME/FD/RL rows under the correct parent). **Append** new rows at the end while authoring.
+
 ## Task (for `{{LIST_TASK_DESCRIPTION}}`)
 
 Inventory the technology stack from manifest files, configs, and repo structure. Each tool gets a stable **`TS-<nn>`** code and **`name`**. Each tool **must** include **`sourceReferences`**: a non-empty array (`minItems: 1`) of `{ path, startLine, endLine, note? }` — **`path`** must name a **file** (e.g. `package.json`, `pnpm-lock.yaml`), never a directory; use several entries if evidence spans multiple files.

package/resources/opencode-agents/agent-list-use-cases.md

@@ -25,6 +25,10 @@ For a **single feature** already fixed in `features-list.json`, emit all **use c
 
 Coordination output is **JSON** (no markdown `##` headings in the artifact). Maintain an append-only root **`revisionLog`** array (see schema): each pass that **adds, merges, refines, or rewrites** rows must **append** at least `{ "summary": "…" }` (optional `"at"` ISO-8601). **Never delete** prior `revisionLog` entries. Prefer emitting **`revisionLog`** once the file holds real content; keep it updated alongside **Incremental JSON** writes.
 
+## SRS-50 — Stable coordination writes
+
+EasySpecs **merge-by-code** after the run: **existing codes** keep their **previous file order**; **new** codes are moved to the **end** of each coded array (including nested BH/ME/FD/RL rows under the correct parent). **Append** new rows at the end while authoring.
+
 ## Task (for `{{LIST_TASK_DESCRIPTION}}`)
 
 Enumerate goals or user journeys that belong to **feature {{FE_CODE}}** only. Do not change the feature code. Aim for **multiple** use cases whenever the codebase exposes more than one coherent goal or path under this feature (see **Cardinality** under Responsibility). Each use case row **must** include **`sourceReferences`** with **`minItems: 1`** (`path`, `startLine`, `endLine`, optional `note`). **`path`** must be a **single file** (never a directory); use multiple objects for multiple files under a folder.
@@ -176,4 +180,8 @@ Valid **`features-list.json`**; orchestration passes **`{{FE_CODE}}`** in the pa
 
 ## OpenCode wiring
 
+## Referenced implementation files
+- .gluecharm/context/architecture.md:1-136
+
+
 One JSON file per feature invocation. §3.5.2 with **`{{PARENT_CONTEXT_BLOCK}}`**.

package/resources/opencode-agents/agent-md-method-detail.md

@@ -70,6 +70,7 @@ Basename **`SV-<nn>_ME-<mm>-<slug>.md`**.
 
 ## Evidence index
 
+- `architecture.md:1-138`: Contains the overall application architecture, relevant for understanding method context.
 - <!-- At least one substantive bullet: `path:line` or honest grounding note per Non-empty chapters — never empty; never `readme.md` basenames. -->
 ```
 

package/resources/opencode-agents/agent-md-tool-detail.md

@@ -66,7 +66,8 @@ Basename **`TS-<nn>-<slug>.md`**.
 
 ## Evidence index
 
-- <!-- At least one substantive bullet: `path:line` or honest grounding note per Non-empty chapters — never empty; never `readme.md` basenames. -->
+- `.gluecharm/context/architecture.md:1-139`: Application architecture overview and component breakdown.
+- <!-- At least one substantive bullet: \`path:line\` or honest grounding note per Non-empty chapters — never empty; never \`readme.md\` basenames. -->
 ```
 
 ## Evidence (**R21**)

package/resources/opencode-agents/agent-review-data-model-list.md

@@ -17,6 +17,12 @@ mode: primary
 
 Read **data-model-list.json**. Normalize entity rows: duplicates, vague entities, split/merge; each **entity** (and any inline **fields** / **relationships** rows) **must** have **`sourceReferences`** with **`minItems: 1`**. Stable **DM-*** codes.
 
+## SRS-50 (stable coordination list writes)
+
+- **Append-only** — net-new `DM-*` and nested `FD-*` / `RL-*` only **after** existing rows; **do not reorder** survivors.
+- **Logged deletes** — **`revisionLog[].droppedCodes`** for every removed `code`.
+- **Slug rename auth** — **`revisionLog[].slugRenames`** when changing entity `slug` for a fixed `code`.
+
 ## Task
 
 Valid JSON at **`{{OUTPUT_FILE_ABSOLUTE}}`** per **`{{LIST_SCHEMA_REF}}`**.

package/resources/opencode-agents/agent-review-entity-fields-list.md

@@ -17,6 +17,12 @@ mode: primary
 
 Read **DM-*-fields-list.json**. Normalize FD rows: duplicates, false fields, split/merge; each row must keep valid **sourceReferences**; stable **FD-*** codes and slugs; **entityCode** must match.
 
+## SRS-50 (stable coordination list writes)
+
+- **Append-only** — net-new `FD-*` only **after** existing rows; **do not reorder** survivors.
+- **Logged deletes** — **`revisionLog[].droppedCodes`** for every removed `code`.
+- **Slug rename auth** — **`revisionLog[].slugRenames`** when changing `slug` for a fixed `code`.
+
 ## Task
 
 Valid JSON at **`{{OUTPUT_FILE_ABSOLUTE}}`** per **`{{LIST_SCHEMA_REF}}`**.

package/resources/opencode-agents/agent-review-experiences-list.md

@@ -19,6 +19,12 @@ Read the existing **experiences-list.json** (schema-valid from **listExperiences
 
 **Critical:** A **view** is any **user-facing surface** the product exposes for interaction—not only full graphical windows. Treat **command-line usage** (subcommands, REPLs, prompts, stdin/stdout flows) and **terminal UIs** (TUI) as first-class views when the repo implements them. **Do not assume** the project is a web app or a single-page stack.
 
+## SRS-50 (stable coordination list writes)
+
+- **Append-only** — net-new `XP-*` rows (and nested `BH-*`) only **after** existing rows at each level; **do not reorder** surviving rows.
+- **Logged deletes** — **`revisionLog[].droppedCodes`** must list every removed `code` (exact strings).
+- **Slug rename auth** — **`revisionLog[].slugRenames`** `{ code, from, to }` when changing `slug` without changing `code`.
+
 ## Reasoning workflow (mandatory order)
 
 Work through these steps **explicitly** (brief notes in your own trace are fine; the **deliverable** remains the JSON file only). Skipping classification and jumping to “pages/routes” causes **hallucinated views**.

package/resources/opencode-agents/agent-review-features-list.md

@@ -29,6 +29,14 @@ mode: primary
 8. **`sourceReferences`** — Every surviving feature row **must** have **`minItems: 1`** valid evidence; add from manifests/code if missing. Drop or fix entries that violate schema (no directories, no `.gluecharm/` paths, no `.opencode/` paths, no README basenames).
 9. **`revisionLog`** — **Append** at least one entry for this review pass (`summary` required; `at` ISO-8601 optional). **Never delete** prior `revisionLog` entries.
 
+## SRS-50 (stable coordination list writes)
+
+Prefer output that already respects EasySpecs merge rules (the extension post-processes the file):
+
+- **Append-only** — net-new `FE-*` rows only **after** all existing rows; **do not reorder** surviving rows.
+- **Logged deletes** — every removed `code` must appear in **`revisionLog[].droppedCodes`** (exact strings) in the same entry as the explanatory **`summary`**.
+- **Slug rename auth** — changing `slug` without changing `code` requires **`revisionLog[].slugRenames`** entries `{ "code", "from", "to" }`.
+
 ## Stable codes
 
 - When **merging** duplicates: keep **one** `FE-*` code (prefer the row with stronger evidence).

package/resources/opencode-agents/agent-review-scenarios-list.md

@@ -19,6 +19,11 @@ Read the scenarios list for the scoped feature/use case. Merge duplicates, remov
 
 **Cardinality:** After normalization, **one** remaining scenario is **suspicious** for a non-trivial use case—re-check that error paths, permission denials, boundary data, and alternate success paths were not folded into one overly broad SC. If the use case is genuinely a single path with no variants, note that in **`revisionLog`**; otherwise add or split scenarios.
 
+## SRS-50 (stable coordination list writes)
+
+- **Append-only** — net-new `SC-*` only **after** existing rows; **do not reorder** survivors.
+- **Logged deletes** — **`revisionLog[].droppedCodes`** for every removed `code`.
+
 ## Task
 
 Valid JSON at **`{{OUTPUT_FILE_ABSOLUTE}}`** per **`{{LIST_SCHEMA_REF}}`**.

package/resources/opencode-agents/agent-review-services-list.md

@@ -17,6 +17,12 @@ mode: primary
 
 Read **services-list.json** from **listServices**. Normalize: merge duplicate services/methods, remove false SV/ME rows, fix granularity; each **service** and **method** row **must** have **`sourceReferences`** with **`minItems: 1`**. Stable **SV-*** / **ME-*** codes. **revisionLog** if supported.
 
+## SRS-50 (stable coordination list writes)
+
+- **Append-only** — net-new `SV-*` / nested `ME-*` only **after** existing rows; **do not reorder** survivors.
+- **Logged deletes** — **`revisionLog[].droppedCodes`** for every removed `code`.
+- **Slug rename auth** — **`revisionLog[].slugRenames`** when changing `slug` for a fixed `code`.
+
 ## Task
 
 Output valid JSON at **`{{OUTPUT_FILE_ABSOLUTE}}`** per **`{{LIST_SCHEMA_REF}}`**.

package/resources/opencode-agents/agent-review-tech-stack-list.md

@@ -17,6 +17,12 @@ mode: primary
 
 Read **tech-stack-list.json**. Normalize tool rows: duplicates, false tools; stable **TS-*** codes and slugs. **Every** surviving tool **must** keep valid **`sourceReferences`** with **`minItems: 1`** (schema-required). **Drop** tools you cannot ground with at least one allowed file+line span, or **add** evidence from manifests/configs before writing — empty/missing **`sourceReferences`** fails validation.
 
+## SRS-50 (stable coordination list writes)
+
+- **Append-only** — net-new `TS-*` only **after** existing rows; **do not reorder** survivors.
+- **Logged deletes** — **`revisionLog[].droppedCodes`** for every removed `code`.
+- **Slug rename auth** — **`revisionLog[].slugRenames`** when changing `slug` for a fixed `code`.
+
 ## Task
 
 Valid JSON at **`{{OUTPUT_FILE_ABSOLUTE}}`** per **`{{LIST_SCHEMA_REF}}`**.

package/resources/opencode-agents/agent-review-use-cases-list.md

@@ -19,6 +19,12 @@ Read the use-cases list for the scoped feature. Merge duplicate UCs, remove fals
 
 **Cardinality:** After normalization, **one** remaining UC is **suspicious** for a non-trivial feature—re-check that distinct goals or entry paths were not over-merged. If the feature truly has a single linear journey, note that in **`revisionLog`**; otherwise split or add UCs so the list reflects multiple meaningful journeys.
 
+## SRS-50 (stable coordination list writes)
+
+- **Append-only** — net-new `UC-*` only **after** existing rows; **do not reorder** survivors.
+- **Logged deletes** — **`revisionLog[].droppedCodes`** for every removed `code`.
+- **Slug rename auth** — **`revisionLog[].slugRenames`** when changing `slug` for a fixed `code`.
+
 ## Task
 
 Valid JSON at **`{{OUTPUT_FILE_ABSOLUTE}}`** per **`{{LIST_SCHEMA_REF}}`**.

package/resources/schemas/context-lists/data-model-list.schema.json

@@ -149,6 +149,30 @@
             "minLength": 1,
             "maxLength": 2000,
             "description": "What was added, changed, or refined in this write."
+          },
+          "droppedCodes": {
+            "type": "array",
+            "description": "SRS-50: coordination row codes removed in this pass (explicit intent).",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "slugRenames": {
+            "type": "array",
+            "description": "SRS-50: authorized slug changes for stable detail markdown basenames.",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["code", "from", "to"],
+              "properties": {
+                "code": { "type": "string", "minLength": 1 },
+                "from": { "type": "string", "minLength": 1 },
+                "to": { "type": "string", "minLength": 1 }
+              }
+            }
+          },
+          "stableWriteDiff": {
+            "type": "object",
+            "description": "SRS-50: machine-readable summary of merge-by-code pass (EasySpecs extension).",
+            "additionalProperties": true
           }
         }
       }

package/resources/schemas/context-lists/entity-fields-list.schema.json

@@ -96,6 +96,30 @@
             "minLength": 1,
             "maxLength": 2000,
             "description": "What was added, changed, or refined in this write."
+          },
+          "droppedCodes": {
+            "type": "array",
+            "description": "SRS-50: coordination row codes removed in this pass (explicit intent).",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "slugRenames": {
+            "type": "array",
+            "description": "SRS-50: authorized slug changes for stable detail markdown basenames.",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["code", "from", "to"],
+              "properties": {
+                "code": { "type": "string", "minLength": 1 },
+                "from": { "type": "string", "minLength": 1 },
+                "to": { "type": "string", "minLength": 1 }
+              }
+            }
+          },
+          "stableWriteDiff": {
+            "type": "object",
+            "description": "SRS-50: machine-readable summary of merge-by-code pass (EasySpecs extension).",
+            "additionalProperties": true
           }
         }
       }

package/resources/schemas/context-lists/experiences-list.schema.json

@@ -124,6 +124,30 @@
             "minLength": 1,
             "maxLength": 2000,
             "description": "What was added, changed, or refined in this write."
+          },
+          "droppedCodes": {
+            "type": "array",
+            "description": "SRS-50: coordination row codes removed in this pass (explicit intent).",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "slugRenames": {
+            "type": "array",
+            "description": "SRS-50: authorized slug changes for stable detail markdown basenames.",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["code", "from", "to"],
+              "properties": {
+                "code": { "type": "string", "minLength": 1 },
+                "from": { "type": "string", "minLength": 1 },
+                "to": { "type": "string", "minLength": 1 }
+              }
+            }
+          },
+          "stableWriteDiff": {
+            "type": "object",
+            "description": "SRS-50: machine-readable summary of merge-by-code pass (EasySpecs extension).",
+            "additionalProperties": true
           }
         }
       }

package/resources/schemas/context-lists/features-list.schema.json

@@ -101,6 +101,30 @@
             "minLength": 1,
             "maxLength": 2000,
             "description": "What was added, changed, or refined in this write."
+          },
+          "droppedCodes": {
+            "type": "array",
+            "description": "SRS-50: coordination row codes removed in this pass (explicit intent).",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "slugRenames": {
+            "type": "array",
+            "description": "SRS-50: authorized slug changes for stable detail markdown basenames.",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["code", "from", "to"],
+              "properties": {
+                "code": { "type": "string", "minLength": 1 },
+                "from": { "type": "string", "minLength": 1 },
+                "to": { "type": "string", "minLength": 1 }
+              }
+            }
+          },
+          "stableWriteDiff": {
+            "type": "object",
+            "description": "SRS-50: machine-readable summary of merge-by-code pass (EasySpecs extension).",
+            "additionalProperties": true
           }
         }
       }

package/resources/schemas/context-lists/repo-surface-scan.schema.json

@@ -82,6 +82,30 @@
             "minLength": 1,
             "maxLength": 2000,
             "description": "What was added, changed, or refined in this write."
+          },
+          "droppedCodes": {
+            "type": "array",
+            "description": "SRS-50: coordination row codes removed in this pass (explicit intent).",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "slugRenames": {
+            "type": "array",
+            "description": "SRS-50: authorized slug changes for stable detail markdown basenames.",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["code", "from", "to"],
+              "properties": {
+                "code": { "type": "string", "minLength": 1 },
+                "from": { "type": "string", "minLength": 1 },
+                "to": { "type": "string", "minLength": 1 }
+              }
+            }
+          },
+          "stableWriteDiff": {
+            "type": "object",
+            "description": "SRS-50: machine-readable summary of merge-by-code pass (EasySpecs extension).",
+            "additionalProperties": true
           }
         }
       }

package/resources/schemas/context-lists/scenarios-list.schema.json

@@ -99,6 +99,30 @@
             "minLength": 1,
             "maxLength": 2000,
             "description": "What was added, changed, or refined in this write."
+          },
+          "droppedCodes": {
+            "type": "array",
+            "description": "SRS-50: coordination row codes removed in this pass (explicit intent).",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "slugRenames": {
+            "type": "array",
+            "description": "SRS-50: authorized slug changes for stable detail markdown basenames.",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["code", "from", "to"],
+              "properties": {
+                "code": { "type": "string", "minLength": 1 },
+                "from": { "type": "string", "minLength": 1 },
+                "to": { "type": "string", "minLength": 1 }
+              }
+            }
+          },
+          "stableWriteDiff": {
+            "type": "object",
+            "description": "SRS-50: machine-readable summary of merge-by-code pass (EasySpecs extension).",
+            "additionalProperties": true
           }
         }
       }

package/resources/schemas/context-lists/services-list.schema.json

@@ -124,6 +124,30 @@
             "minLength": 1,
             "maxLength": 2000,
             "description": "What was added, changed, or refined in this write."
+          },
+          "droppedCodes": {
+            "type": "array",
+            "description": "SRS-50: coordination row codes removed in this pass (explicit intent).",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "slugRenames": {
+            "type": "array",
+            "description": "SRS-50: authorized slug changes for stable detail markdown basenames.",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["code", "from", "to"],
+              "properties": {
+                "code": { "type": "string", "minLength": 1 },
+                "from": { "type": "string", "minLength": 1 },
+                "to": { "type": "string", "minLength": 1 }
+              }
+            }
+          },
+          "stableWriteDiff": {
+            "type": "object",
+            "description": "SRS-50: machine-readable summary of merge-by-code pass (EasySpecs extension).",
+            "additionalProperties": true
           }
         }
       }

package/resources/schemas/context-lists/tech-stack-list.schema.json

@@ -100,6 +100,30 @@
             "minLength": 1,
             "maxLength": 2000,
             "description": "What was added, changed, or refined in this write."
+          },
+          "droppedCodes": {
+            "type": "array",
+            "description": "SRS-50: coordination row codes removed in this pass (explicit intent).",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "slugRenames": {
+            "type": "array",
+            "description": "SRS-50: authorized slug changes for stable detail markdown basenames.",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["code", "from", "to"],
+              "properties": {
+                "code": { "type": "string", "minLength": 1 },
+                "from": { "type": "string", "minLength": 1 },
+                "to": { "type": "string", "minLength": 1 }
+              }
+            }
+          },
+          "stableWriteDiff": {
+            "type": "object",
+            "description": "SRS-50: machine-readable summary of merge-by-code pass (EasySpecs extension).",
+            "additionalProperties": true
           }
         }
       }

package/resources/schemas/context-lists/use-cases-list.schema.json

@@ -100,6 +100,30 @@
             "minLength": 1,
             "maxLength": 2000,
             "description": "What was added, changed, or refined in this write."
+          },
+          "droppedCodes": {
+            "type": "array",
+            "description": "SRS-50: coordination row codes removed in this pass (explicit intent).",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "slugRenames": {
+            "type": "array",
+            "description": "SRS-50: authorized slug changes for stable detail markdown basenames.",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["code", "from", "to"],
+              "properties": {
+                "code": { "type": "string", "minLength": 1 },
+                "from": { "type": "string", "minLength": 1 },
+                "to": { "type": "string", "minLength": 1 }
+              }
+            }
+          },
+          "stableWriteDiff": {
+            "type": "object",
+            "description": "SRS-50: machine-readable summary of merge-by-code pass (EasySpecs extension).",
+            "additionalProperties": true
           }
         }
       }

package/resources/schemas/srs-46-config.schema.json

@@ -20,6 +20,33 @@
         },
         "upload": {
           "$ref": "#/$defs/srs46Upload"
+        },
+        "factory": {
+          "type": "object",
+          "description": "SRS-53 optional canonical block; when `cloudContextAnalyzed` / `cloudContextAnalyzedAt` are set here they override the same keys under `analysis` after merge.",
+          "additionalProperties": true,
+          "properties": {
+            "debug": { "type": "boolean" },
+            "cloudContextAnalyzed": { "type": "boolean" },
+            "cloudContextAnalyzedAt": {
+              "oneOf": [{ "type": "null" }, { "type": "string", "format": "date-time", "minLength": 1 }]
+            },
+            "updateContext": {
+              "type": "object",
+              "additionalProperties": true,
+              "properties": {
+                "lastRunAt": { "type": "string", "format": "date-time", "minLength": 1 }
+              }
+            }
+          }
+        },
+        "workstations": {
+          "type": "object",
+          "additionalProperties": true
+        },
+        "pipelines": {
+          "type": "object",
+          "additionalProperties": true
         }
       }
     }