@mnstry/atelier 0.2.0-alpha.5 → 0.2.0-alpha.8

package/fixtures/obsidian/contracts/oracles/scope-cases.json

@@ -0,0 +1,412 @@
+{
+  "schema": "atelier-obsidian-scope-oracles/v1",
+  "profileFixture": "fixtures/obsidian/contracts/corpus-profile/valid/three-repositories.v1.json",
+  "nodes": [
+    {
+      "id": "a",
+      "repo": "north",
+      "path": "plans/one.md",
+      "tags": [
+        "topic"
+      ],
+      "type": "md",
+      "title": "Shared concept",
+      "eligible": true
+    },
+    {
+      "id": "b",
+      "repo": "south",
+      "path": "notes/two.json",
+      "tags": [
+        "other"
+      ],
+      "type": "json",
+      "title": "Second concept",
+      "eligible": true
+    },
+    {
+      "id": "c",
+      "repo": "west",
+      "path": "notes/three.html",
+      "tags": [
+        "topic"
+      ],
+      "type": "html",
+      "title": "Third concept",
+      "eligible": true
+    },
+    {
+      "id": "d",
+      "repo": "north",
+      "path": "notes/four.md",
+      "tags": [],
+      "type": "md",
+      "title": "Shared concept",
+      "eligible": true
+    },
+    {
+      "id": "x",
+      "repo": "north",
+      "path": "private/five.md",
+      "tags": [
+        "topic"
+      ],
+      "type": "md",
+      "title": "Withheld",
+      "eligible": false
+    }
+  ],
+  "edges": [
+    {
+      "id": "e1",
+      "source": "a",
+      "target": "b",
+      "type": "related",
+      "origin": "declared"
+    },
+    {
+      "id": "e2",
+      "source": "b",
+      "target": "c",
+      "type": "supports",
+      "origin": "declared"
+    },
+    {
+      "id": "e3",
+      "source": "c",
+      "target": "a",
+      "type": "contradicts",
+      "origin": "declared"
+    },
+    {
+      "id": "e4",
+      "source": "d",
+      "target": "a",
+      "type": "links_to",
+      "origin": "markdown"
+    },
+    {
+      "id": "e5",
+      "source": "a",
+      "target": "d",
+      "type": "supersedes",
+      "origin": "declared"
+    },
+    {
+      "id": "e6",
+      "source": "a",
+      "target": "c",
+      "type": "implements",
+      "origin": "declared"
+    },
+    {
+      "id": "e7",
+      "source": "d",
+      "target": "b",
+      "type": "depends_on",
+      "origin": "declared"
+    },
+    {
+      "id": "e8",
+      "source": "c",
+      "target": "d",
+      "type": "evidences",
+      "origin": "declared"
+    },
+    {
+      "id": "e9",
+      "source": "b",
+      "target": "d",
+      "type": "belongs_to",
+      "origin": "declared"
+    },
+    {
+      "id": "e10",
+      "source": "a",
+      "target": "x",
+      "type": "related",
+      "origin": "declared"
+    }
+  ],
+  "cases": [
+    {
+      "name": "full",
+      "selector": {
+        "all": true
+      },
+      "expectedNodes": [
+        "a",
+        "b",
+        "c",
+        "d"
+      ],
+      "expectedEdges": [
+        "e1",
+        "e2",
+        "e3",
+        "e4",
+        "e5",
+        "e6",
+        "e7",
+        "e8",
+        "e9"
+      ]
+    },
+    {
+      "name": "explicit-cross-repository",
+      "selector": {
+        "ids": [
+          "a",
+          "b"
+        ]
+      },
+      "expectedNodes": [
+        "a",
+        "b"
+      ],
+      "expectedEdges": [
+        "e1"
+      ]
+    },
+    {
+      "name": "repo",
+      "selector": {
+        "repo": "north"
+      },
+      "expectedNodes": [
+        "a",
+        "d"
+      ],
+      "expectedEdges": [
+        "e4",
+        "e5"
+      ]
+    },
+    {
+      "name": "path",
+      "selector": {
+        "repo": "north",
+        "pathPrefix": "plans/"
+      },
+      "expectedNodes": [
+        "a"
+      ],
+      "expectedEdges": []
+    },
+    {
+      "name": "tag",
+      "selector": {
+        "tag": "topic"
+      },
+      "expectedNodes": [
+        "a",
+        "c"
+      ],
+      "expectedEdges": [
+        "e3",
+        "e6"
+      ]
+    },
+    {
+      "name": "type",
+      "selector": {
+        "type": "html"
+      },
+      "expectedNodes": [
+        "c"
+      ],
+      "expectedEdges": []
+    },
+    {
+      "name": "union",
+      "selector": {
+        "union": [
+          {
+            "repo": "north"
+          },
+          {
+            "ids": [
+              "b"
+            ]
+          }
+        ]
+      },
+      "expectedNodes": [
+        "a",
+        "b",
+        "d"
+      ],
+      "expectedEdges": [
+        "e1",
+        "e4",
+        "e5",
+        "e7",
+        "e9"
+      ]
+    },
+    {
+      "name": "intersection",
+      "selector": {
+        "intersection": [
+          {
+            "repo": "north"
+          },
+          {
+            "tag": "topic"
+          }
+        ]
+      },
+      "expectedNodes": [
+        "a"
+      ],
+      "expectedEdges": []
+    },
+    {
+      "name": "exclude",
+      "selector": {
+        "exclude": [
+          {
+            "all": true
+          },
+          {
+            "repo": "north"
+          }
+        ]
+      },
+      "expectedNodes": [
+        "b",
+        "c"
+      ],
+      "expectedEdges": [
+        "e2"
+      ]
+    },
+    {
+      "name": "empty",
+      "selector": {
+        "ids": []
+      },
+      "expectedNodes": [],
+      "expectedEdges": []
+    },
+    {
+      "name": "withheld",
+      "selector": {
+        "ids": [
+          "x"
+        ]
+      },
+      "expectedNodes": [],
+      "expectedEdges": [],
+      "diagnostic": "selection-has-no-visible-members"
+    },
+    {
+      "name": "focus",
+      "selector": {
+        "ids": [
+          "a",
+          "b"
+        ]
+      },
+      "expectedNodes": [
+        "a",
+        "b"
+      ],
+      "expectedEdges": [
+        "e1"
+      ],
+      "mode": "focus",
+      "expectedVaultNodes": [
+        "a",
+        "b",
+        "c",
+        "d"
+      ],
+      "expectedFilterPaths": [
+        "notes/Shared concept--82f6d012eaad.md",
+        "notes/Second concept--242ab15f42c6.md"
+      ]
+    },
+    {
+      "name": "bounded-expand",
+      "selector": {
+        "ids": [
+          "a"
+        ]
+      },
+      "expectedNodes": [
+        "a",
+        "b",
+        "c"
+      ],
+      "expectedEdges": [
+        "e1",
+        "e2",
+        "e3",
+        "e6"
+      ],
+      "truncated": true,
+      "expansion": {
+        "depth": 1,
+        "maxNodes": 3,
+        "direction": "outgoing",
+        "order": "canonical-id"
+      }
+    },
+    {
+      "name": "duplicate-titles-allowed",
+      "selector": {
+        "ids": [
+          "a",
+          "d"
+        ]
+      },
+      "expectedNodes": [
+        "a",
+        "d"
+      ],
+      "expectedEdges": [
+        "e4",
+        "e5"
+      ],
+      "expectedDistinctPaths": true
+    }
+  ],
+  "refusals": [
+    {
+      "name": "duplicate-identity",
+      "mutation": "append a second node with canonical identity a",
+      "expectedError": "duplicate-identity"
+    },
+    {
+      "name": "ambiguous-title-link",
+      "input": "[[Shared concept]]",
+      "expectedError": "ambiguous-target"
+    },
+    {
+      "name": "unknown-selector",
+      "selector": {
+        "run": "anything"
+      },
+      "expectedError": "unknown-selector"
+    },
+    {
+      "name": "unbounded-expansion",
+      "selector": {
+        "ids": [
+          "a"
+        ]
+      },
+      "expectedError": "missing-expansion-budget",
+      "expansion": {
+        "depth": 1
+      }
+    }
+  ],
+  "pathRegistry": {
+    "a": "notes/Shared concept--82f6d012eaad.md",
+    "b": "notes/Second concept--242ab15f42c6.md",
+    "c": "notes/Third concept--15d5bedaa8ca.md",
+    "d": "notes/Shared concept--4cbaa6562753.md"
+  }
+}

package/fixtures/obsidian/contracts/proposal-receipt/invalid/accepted-without-proposal-id.v1.json

@@ -0,0 +1,12 @@
+{
+  "schema": "atelier-obsidian-proposal-receipt/v1",
+  "receiptId": "receipt-0001",
+  "repoId": "north",
+  "storeId": "store-north",
+  "adapterOperationId": "adapter-op-edit-0002",
+  "editId": "edit-0002",
+  "proposalId": null,
+  "dedupe": "new",
+  "backpressure": "accepted",
+  "recordedAt": "2026-01-05T10:06:00Z"
+}

package/fixtures/obsidian/contracts/proposal-receipt/invalid/missing-adapter-operation-id.v1.json

@@ -0,0 +1,11 @@
+{
+  "schema": "atelier-obsidian-proposal-receipt/v1",
+  "receiptId": "receipt-0001",
+  "repoId": "north",
+  "storeId": "store-north",
+  "editId": "edit-0002",
+  "proposalId": "proposal-0001",
+  "dedupe": "new",
+  "backpressure": "accepted",
+  "recordedAt": "2026-01-05T10:06:00Z"
+}

package/fixtures/obsidian/contracts/proposal-receipt/invalid/unknown-backpressure-outcome.v1.json

@@ -0,0 +1,12 @@
+{
+  "schema": "atelier-obsidian-proposal-receipt/v1",
+  "receiptId": "receipt-0001",
+  "repoId": "north",
+  "storeId": "store-north",
+  "adapterOperationId": "adapter-op-edit-0002",
+  "editId": "edit-0002",
+  "proposalId": "proposal-0001",
+  "dedupe": "new",
+  "backpressure": "dropped",
+  "recordedAt": "2026-01-05T10:06:00Z"
+}

package/fixtures/obsidian/contracts/proposal-receipt/invalid/unknown-top-level-field.v1.json

@@ -0,0 +1,13 @@
+{
+  "schema": "atelier-obsidian-proposal-receipt/v1",
+  "receiptId": "receipt-0001",
+  "repoId": "north",
+  "storeId": "store-north",
+  "adapterOperationId": "adapter-op-edit-0002",
+  "editId": "edit-0002",
+  "proposalId": "proposal-0001",
+  "dedupe": "new",
+  "backpressure": "accepted",
+  "recordedAt": "2026-01-05T10:06:00Z",
+  "sourceApplyAuthority": true
+}

package/fixtures/obsidian/contracts/proposal-receipt/valid/accepted-new.v1.json

@@ -0,0 +1,12 @@
+{
+  "schema": "atelier-obsidian-proposal-receipt/v1",
+  "receiptId": "receipt-0001",
+  "repoId": "north",
+  "storeId": "store-north",
+  "adapterOperationId": "adapter-op-edit-0002",
+  "editId": "edit-0002",
+  "proposalId": "proposal-0001",
+  "dedupe": "new",
+  "backpressure": "accepted",
+  "recordedAt": "2026-01-05T10:06:00Z"
+}

package/fixtures/obsidian/contracts/proposal-receipt/valid/deferred.v1.json

@@ -0,0 +1,12 @@
+{
+  "schema": "atelier-obsidian-proposal-receipt/v1",
+  "receiptId": "receipt-0002",
+  "repoId": "south",
+  "storeId": "store-south",
+  "adapterOperationId": "adapter-op-edit-0003",
+  "editId": "edit-0003",
+  "proposalId": null,
+  "dedupe": "new",
+  "backpressure": "deferred",
+  "recordedAt": "2026-01-05T10:07:00Z"
+}

package/fixtures/obsidian/contracts/publication-journal/invalid/absolute-recovery-ref.v1.json

@@ -0,0 +1,47 @@
+{
+  "schema": "atelier-obsidian-publication-journal/v1",
+  "journalId": "journal-0001",
+  "workspaceId": "ws-synthetic-0001",
+  "scopeId": "scope-topic",
+  "protocolId": "obsidian-cli-critical-section/v1-prototype",
+  "expectedGeneration": null,
+  "targetGeneration": "gen-0001",
+  "state": "committed",
+  "entries": [
+    {
+      "seq": 0,
+      "at": "2026-01-05T10:00:01Z",
+      "step": "capture",
+      "outcome": "ok",
+      "notePath": "notes/Shared concept--82f6d012eaad.md",
+      "beforeDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+      "recoveryRef": "/srv/example/recovery/edit-0001/observed.bin"
+    },
+    {
+      "seq": 1,
+      "at": "2026-01-05T10:00:02Z",
+      "step": "conditional-update",
+      "outcome": "ok",
+      "notePath": "notes/Shared concept--82f6d012eaad.md",
+      "beforeDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+      "afterDigest": "sha256:8888888888888888888888888888888888888888888888888888888888888888"
+    },
+    {
+      "seq": 2,
+      "at": "2026-01-05T10:00:03Z",
+      "step": "verify",
+      "outcome": "ok",
+      "notePath": "notes/Shared concept--82f6d012eaad.md",
+      "afterDigest": "sha256:8888888888888888888888888888888888888888888888888888888888888888"
+    },
+    {
+      "seq": 3,
+      "at": "2026-01-05T10:00:04Z",
+      "step": "manifest-commit",
+      "outcome": "ok"
+    }
+  ],
+  "restart": {
+    "count": 0
+  }
+}

package/fixtures/obsidian/contracts/publication-journal/invalid/duplicate-sequence.v1.json

@@ -0,0 +1,47 @@
+{
+  "schema": "atelier-obsidian-publication-journal/v1",
+  "journalId": "journal-0001",
+  "workspaceId": "ws-synthetic-0001",
+  "scopeId": "scope-topic",
+  "protocolId": "obsidian-cli-critical-section/v1-prototype",
+  "expectedGeneration": null,
+  "targetGeneration": "gen-0001",
+  "state": "committed",
+  "entries": [
+    {
+      "seq": 0,
+      "at": "2026-01-05T10:00:01Z",
+      "step": "capture",
+      "outcome": "ok",
+      "notePath": "notes/Shared concept--82f6d012eaad.md",
+      "beforeDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+      "recoveryRef": "recovery/edit-0001/observed.bin"
+    },
+    {
+      "seq": 1,
+      "at": "2026-01-05T10:00:02Z",
+      "step": "conditional-update",
+      "outcome": "ok",
+      "notePath": "notes/Shared concept--82f6d012eaad.md",
+      "beforeDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+      "afterDigest": "sha256:8888888888888888888888888888888888888888888888888888888888888888"
+    },
+    {
+      "seq": 1,
+      "at": "2026-01-05T10:00:03Z",
+      "step": "verify",
+      "outcome": "ok",
+      "notePath": "notes/Shared concept--82f6d012eaad.md",
+      "afterDigest": "sha256:8888888888888888888888888888888888888888888888888888888888888888"
+    },
+    {
+      "seq": 3,
+      "at": "2026-01-05T10:00:04Z",
+      "step": "manifest-commit",
+      "outcome": "ok"
+    }
+  ],
+  "restart": {
+    "count": 0
+  }
+}

package/fixtures/obsidian/contracts/publication-journal/invalid/empty-protocol-id.v1.json

@@ -0,0 +1,47 @@
+{
+  "schema": "atelier-obsidian-publication-journal/v1",
+  "journalId": "journal-0001",
+  "workspaceId": "ws-synthetic-0001",
+  "scopeId": "scope-topic",
+  "protocolId": "",
+  "expectedGeneration": null,
+  "targetGeneration": "gen-0001",
+  "state": "committed",
+  "entries": [
+    {
+      "seq": 0,
+      "at": "2026-01-05T10:00:01Z",
+      "step": "capture",
+      "outcome": "ok",
+      "notePath": "notes/Shared concept--82f6d012eaad.md",
+      "beforeDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+      "recoveryRef": "recovery/edit-0001/observed.bin"
+    },
+    {
+      "seq": 1,
+      "at": "2026-01-05T10:00:02Z",
+      "step": "conditional-update",
+      "outcome": "ok",
+      "notePath": "notes/Shared concept--82f6d012eaad.md",
+      "beforeDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+      "afterDigest": "sha256:8888888888888888888888888888888888888888888888888888888888888888"
+    },
+    {
+      "seq": 2,
+      "at": "2026-01-05T10:00:03Z",
+      "step": "verify",
+      "outcome": "ok",
+      "notePath": "notes/Shared concept--82f6d012eaad.md",
+      "afterDigest": "sha256:8888888888888888888888888888888888888888888888888888888888888888"
+    },
+    {
+      "seq": 3,
+      "at": "2026-01-05T10:00:04Z",
+      "step": "manifest-commit",
+      "outcome": "ok"
+    }
+  ],
+  "restart": {
+    "count": 0
+  }
+}

package/fixtures/obsidian/contracts/publication-journal/invalid/missing-protocol-id.v1.json

@@ -0,0 +1,46 @@
+{
+  "schema": "atelier-obsidian-publication-journal/v1",
+  "journalId": "journal-0001",
+  "workspaceId": "ws-synthetic-0001",
+  "scopeId": "scope-topic",
+  "expectedGeneration": null,
+  "targetGeneration": "gen-0001",
+  "state": "committed",
+  "entries": [
+    {
+      "seq": 0,
+      "at": "2026-01-05T10:00:01Z",
+      "step": "capture",
+      "outcome": "ok",
+      "notePath": "notes/Shared concept--82f6d012eaad.md",
+      "beforeDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+      "recoveryRef": "recovery/edit-0001/observed.bin"
+    },
+    {
+      "seq": 1,
+      "at": "2026-01-05T10:00:02Z",
+      "step": "conditional-update",
+      "outcome": "ok",
+      "notePath": "notes/Shared concept--82f6d012eaad.md",
+      "beforeDigest": "sha256:5555555555555555555555555555555555555555555555555555555555555555",
+      "afterDigest": "sha256:8888888888888888888888888888888888888888888888888888888888888888"
+    },
+    {
+      "seq": 2,
+      "at": "2026-01-05T10:00:03Z",
+      "step": "verify",
+      "outcome": "ok",
+      "notePath": "notes/Shared concept--82f6d012eaad.md",
+      "afterDigest": "sha256:8888888888888888888888888888888888888888888888888888888888888888"
+    },
+    {
+      "seq": 3,
+      "at": "2026-01-05T10:00:04Z",
+      "step": "manifest-commit",
+      "outcome": "ok"
+    }
+  ],
+  "restart": {
+    "count": 0
+  }
+}