wowbagger 0.1.0-alpha.9 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wowbagger",
-  "version": "0.1.0-alpha.9",
+  "version": "0.5.0",
   "description": "Git-native work ledger for coding agents: deterministic ready queues, guarded CAS mutations, claims and fencing, and self-contained HTML reports.",
   "type": "module",
   "license": "MIT",
@@ -30,7 +30,7 @@
     "cli"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=24"
   },
   "bin": {
     "wowbagger": "bin/wowbagger.js"

package/schemas/core-capabilities-response.json

@@ -232,7 +232,7 @@
                   "type": "boolean"
                 },
                 "api_version": {
-                  "const": 2
+                  "const": 3
                 },
                 "mode": {
                   "const": "advisory"

package/schemas/core-envelope.json

@@ -25,7 +25,8 @@
             "inspect",
             "list",
             "mint-id",
-            "report"
+            "report",
+            "version-drift"
           ]
         },
         "contract_version": {
@@ -55,8 +56,8 @@
             "capabilities",
             "inspect",
             "list",
-            "mint-id",
-            "report"
+            "report",
+            "version-drift"
           ]
         },
         "contract_version": {

package/schemas/index.json

@@ -92,6 +92,24 @@
       "version": 1,
       "summary": "Legacy-write fence refusals in the ledger-mutation namespace."
     },
+    {
+      "file": "ledger-repair-proposal.json",
+      "domain": "ledger-repair",
+      "version": 1,
+      "summary": "The read-only duplicate-number repair proposal result."
+    },
+    {
+      "file": "ledger-repair-request.json",
+      "domain": "ledger-repair",
+      "version": 1,
+      "summary": "The strict number-repair request, covering the complete duplicate set."
+    },
+    {
+      "file": "ledger-repair-response.json",
+      "domain": "ledger-repair",
+      "version": 1,
+      "summary": "Every ledger-repair response: the proposal and apply envelopes at repair version 1."
+    },
     {
       "file": "report-config-v1.json",
       "domain": "report-config",

package/schemas/ledger-repair-proposal.json

@@ -0,0 +1,170 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/lstutzman/wowbagger/schemas/ledger-repair-proposal.json",
+  "title": "number-repair-proposal result, ledger-repair version 1",
+  "description": "The `result` member of a successful `number-repair-proposal` response. The proposal is read-only: it reads the raw items of a ledger whose complete error set is duplicate numbers and computes the mapping that would repair it, writing nothing. The caller confirms or replaces `suggested_changes` and submits them as a `number-repair` request, which validates every witness again under the repair lock.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "ledger_snapshot_revision",
+    "duplicate_groups",
+    "items",
+    "suggested_changes",
+    "preserved_items",
+    "validation_errors"
+  ],
+  "properties": {
+    "ledger_snapshot_revision": {
+      "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/revision",
+      "description": "The digest over the complete relevant source bytes this proposal was computed from. A repair request replays it so a changed ledger is a conflict rather than a surprise."
+    },
+    "duplicate_groups": {
+      "type": "array",
+      "minItems": 1,
+      "description": "One entry per duplicated number, naming every item that carries it. A repair request must resolve every group.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "number",
+          "item_ids"
+        ],
+        "properties": {
+          "number": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "item_ids": {
+            "type": "array",
+            "minItems": 2,
+            "uniqueItems": true,
+            "items": {
+              "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/itemId"
+            }
+          }
+        }
+      }
+    },
+    "items": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Every item in a duplicate group, with the configured path and exact source revision a repair request witnesses.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "item_id",
+          "path",
+          "revision",
+          "number"
+        ],
+        "properties": {
+          "item_id": {
+            "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/itemId"
+          },
+          "path": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The item's configured path, relative to the ledger directory."
+          },
+          "revision": {
+            "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/revision"
+          },
+          "number": {
+            "type": "integer",
+            "minimum": 1
+          }
+        }
+      }
+    },
+    "suggested_changes": {
+      "type": "array",
+      "minItems": 1,
+      "description": "The computed mapping, in the exact shape of the `changes` member of a number-repair request. Each group keeps the number on its lexicographically smallest ULID and moves the rest above the current maximum number.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "item_id",
+          "expected_revision",
+          "expected_number",
+          "replacement_number"
+        ],
+        "properties": {
+          "item_id": {
+            "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/itemId"
+          },
+          "expected_revision": {
+            "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/revision"
+          },
+          "expected_number": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "replacement_number": {
+            "type": "integer",
+            "minimum": 1
+          }
+        }
+      }
+    },
+    "preserved_items": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Item IDs the proposal keeps at their current number.",
+      "uniqueItems": true,
+      "items": {
+        "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/itemId"
+      }
+    },
+    "references": {
+      "type": "array",
+      "description": "The affected items' relations, exactly as the source carries them. Relations are ULIDs, so a number repair preserves them; they are reported so a caller can confirm that nothing identity-bearing is being rewritten.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "item_id",
+          "depends_on",
+          "related",
+          "parent"
+        ],
+        "properties": {
+          "item_id": {
+            "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/itemId"
+          },
+          "depends_on": {
+            "type": "array",
+            "items": {
+              "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/itemId"
+            }
+          },
+          "related": {
+            "type": "array",
+            "items": {
+              "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/itemId"
+            }
+          },
+          "parent": {
+            "oneOf": [
+              {
+                "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/itemId"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        }
+      }
+    },
+    "validation_errors": {
+      "type": "array",
+      "minItems": 1,
+      "description": "The complete current validation errors. A proposal is produced only when every one of them is a duplicate-number error; any other error returns ledger-repair-not-applicable instead.",
+      "items": {
+        "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/validationError"
+      }
+    }
+  }
+}

package/schemas/ledger-repair-request.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/lstutzman/wowbagger/schemas/ledger-repair-request.json",
+  "title": "number-repair request, ledger-repair version 1",
+  "description": "The strict JSON request `number-repair` reads from stdin or a host-created request file. One request covers the complete duplicate set: a partial mapping is refused, because moving one group cannot produce a valid complete ledger while another group remains. Each change carries the witnesses the apply path compares under the repair lock. `ledger-repair` is its own contract version, separate from the core contract version and the work-claim contract version.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "repair_id",
+    "ledger_snapshot_revision",
+    "date",
+    "changes"
+  ],
+  "properties": {
+    "repair_id": {
+      "type": "string",
+      "pattern": "^nr_[0-9]{8}_[0-9]{4}$",
+      "description": "The bounded recovery key: `nr_`, the repair date, and a four-digit sequence within that date. An interrupted apply is resumed by this ID rather than retried blindly."
+    },
+    "ledger_snapshot_revision": {
+      "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/revision",
+      "description": "The complete-snapshot witness the proposal was computed against. A changed snapshot is a conflict, never a repair applied to bytes the caller never read."
+    },
+    "date": {
+      "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/isoDate"
+    },
+    "changes": {
+      "type": "array",
+      "minItems": 1,
+      "description": "One entry per moved item. No `item_id` repeats, because an item moves once, and no `replacement_number` repeats, because two items cannot land on one number. An empty list is an invalid request rather than a no-op.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "item_id",
+          "expected_revision",
+          "expected_number",
+          "replacement_number"
+        ],
+        "properties": {
+          "item_id": {
+            "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/itemId"
+          },
+          "expected_revision": {
+            "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/revision"
+          },
+          "expected_number": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The number the item carries now, compared as an integer. It is a witness, not a label."
+          },
+          "replacement_number": {
+            "type": "integer",
+            "minimum": 1,
+            "description": "The number the item is moved to. The apply path refuses a collision with any item that is not being moved."
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/ledger-repair-response.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/lstutzman/wowbagger/schemas/ledger-repair-response.json",
+  "title": "ledger-repair responses, contract version 1",
+  "description": "Every `number-repair-proposal` and `number-repair` --json response. The root carries a `namespace` member: dispatch on `namespace` before reading any version field. `contract_version` is the repair domain's own version 1 — the core contract version and the work-claim contract version are separate and unchanged by it. A future change to the request or the repaired source shape requires a new repair contract version rather than a silent reinterpretation of version 1.",
+  "type": "object",
+  "oneOf": [
+    {
+      "title": "repair success",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ok",
+        "namespace",
+        "command",
+        "contract_version",
+        "state",
+        "result"
+      ],
+      "properties": {
+        "ok": {
+          "const": true
+        },
+        "namespace": {
+          "const": "ledger-repair"
+        },
+        "command": {
+          "enum": [
+            "number-repair-proposal",
+            "number-repair"
+          ]
+        },
+        "contract_version": {
+          "const": 1
+        },
+        "state": {
+          "enum": [
+            "unchanged",
+            "committed"
+          ],
+          "description": "A proposal changes nothing, so it is always `unchanged`. An applied repair is `committed`."
+        },
+        "result": {
+          "type": "object",
+          "description": "The proposal result is the ledger-repair-proposal schema. The apply result names the repair ID, the snapshot it was applied against, the changed items, and the Git commit when one was established."
+        }
+      }
+    },
+    {
+      "title": "repair refusal",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "ok",
+        "namespace",
+        "command",
+        "contract_version",
+        "state",
+        "error"
+      ],
+      "properties": {
+        "ok": {
+          "const": false
+        },
+        "namespace": {
+          "const": "ledger-repair"
+        },
+        "command": {
+          "enum": [
+            "number-repair-proposal",
+            "number-repair"
+          ]
+        },
+        "contract_version": {
+          "const": 1
+        },
+        "state": {
+          "enum": [
+            "unchanged",
+            "unknown"
+          ],
+          "description": "`unchanged` states that no ledger byte was written. `unknown` is reserved for an outcome this core could not resolve; it never accompanies a refusal raised before any write was attempted."
+        },
+        "error": {
+          "$ref": "https://github.com/lstutzman/wowbagger/schemas/common.json#/$defs/error"
+        }
+      }
+    }
+  ]
+}

package/schemas/report-config-v1.json

@@ -45,6 +45,10 @@
           "type": "string",
           "pattern": "^(/([^/~]|~[01])*)*$"
         },
+        "tags": {
+          "type": "string",
+          "pattern": "^(/([^/~]|~[01])*)*$"
+        },
         "class": {
           "type": "string",
           "pattern": "^(/([^/~]|~[01])*)*$"

package/schemas/report-config-v2.json

@@ -45,6 +45,10 @@
           "type": "string",
           "pattern": "^(/([^/~]|~[01])*)*$"
         },
+        "tags": {
+          "type": "string",
+          "pattern": "^(/([^/~]|~[01])*)*$"
+        },
         "class": {
           "type": "string",
           "pattern": "^(/([^/~]|~[01])*)*$"
@@ -189,6 +193,7 @@
                   "propertyNames": {
                     "enum": [
                       "area",
+                      "tags",
                       "class",
                       "due",
                       "rank",