jazari 0.7.0 → 0.8.0

data/protocol/v1/fixtures/resolve-default/scenario.json

@@ -0,0 +1,7 @@
+{
+  "schema": "jazari-conformance/v1",
+  "recipes": [{"id":"fixture.v1","topic":"Fixture","checklist":[{"id":"first","text":"First"}]}],
+  "steps": [
+    {"request":{"protocol":"jazari/v1","request_id":"resolve","action":"get","target":{"kind":"queue","key":"fixture","recipe_id":"fixture.v1"},"arguments":{}},"expect":{"ok":true,"result":{"state":"default","topic":"Fixture","progress":{"done":0,"total":1,"percent":0}}}}
+  ]
+}

data/protocol/v1/fixtures/revision-conflict/scenario.json

@@ -0,0 +1,7 @@
+{
+  "schema": "jazari-conformance/v1",
+  "recipes": [{"id":"fixture.v1","topic":"Fixture","checklist":[{"id":"first","text":"First"}]}],
+  "steps": [
+    {"request":{"protocol":"jazari/v1","request_id":"stale","action":"set","target":{"kind":"anchor","scope_type":"local","scope_id":1,"key":"one","recipe_id":"fixture.v1"},"arguments":{"expected_revision":"default:stale","topic":"Changed","description":"","checklist":[]}},"expect":{"ok":false,"error":{"code":"revision_conflict"}}}
+  ]
+}

data/protocol/v1/fixtures/run-closed/scenario.json

@@ -0,0 +1,9 @@
+{
+  "schema": "jazari-conformance/v1",
+  "recipes": [{"id":"closed.v1","topic":"Closed","checklist":[{"id":"first","text":"First"}]}],
+  "steps": [
+    {"request":{"protocol":"jazari/v1","request_id":"open","action":"start","target":{"kind":"queue","key":"closed","recipe_id":"closed.v1"},"arguments":{"actor_ref":"agent:fixture"}},"expect":{"ok":true}},
+    {"request":{"protocol":"jazari/v1","request_id":"finish","action":"finish","target":{"kind":"queue","key":"closed","recipe_id":"closed.v1"},"arguments":{"run_id":"$0.result.run_id","expected_revision":"$0.result.revision","outcome":"completed"}},"expect":{"ok":true,"result":{"open":false,"outcome":"completed"}}},
+    {"request":{"protocol":"jazari/v1","request_id":"late","action":"tick","target":{"kind":"queue","key":"closed","recipe_id":"closed.v1"},"arguments":{"run_id":"$0.result.run_id","expected_revision":"$1.result.revision","item_id":"first","done":true}},"expect":{"ok":false,"error":{"code":"run_closed"}}}
+  ]
+}

data/protocol/v1/fixtures/run-snapshot/scenario.json

@@ -0,0 +1,9 @@
+{
+  "schema": "jazari-conformance/v1",
+  "recipes": [{"id":"snapshot.v1","topic":"Snapshot","checklist":[{"id":"first","text":"First"}]}],
+  "steps": [
+    {"request":{"protocol":"jazari/v1","request_id":"open","action":"start","target":{"kind":"queue","key":"snapshot","recipe_id":"snapshot.v1"},"arguments":{"actor_ref":"agent:fixture"}},"expect":{"ok":true}},
+    {"setup":{"replace_recipe":{"id":"snapshot.v1","topic":"Changed","checklist":[{"id":"later","text":"Later"}]} }},
+    {"request":{"protocol":"jazari/v1","request_id":"tick","action":"tick","target":{"kind":"queue","key":"snapshot","recipe_id":"snapshot.v1"},"arguments":{"run_id":"$0.result.run_id","expected_revision":"$0.result.revision","item_id":"first","done":true}},"expect":{"ok":true,"result":{"ticks":[{"id":"first","done":true,"actor_ref":"agent:fixture"}]}}}
+  ]
+}

data/protocol/v1/request.schema.json

@@ -0,0 +1,215 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/nauman/jazari/protocol/v1/request.schema.json",
+  "title": "Jazari v1 request",
+  "$defs": {
+    "requestId": { "type": "string", "minLength": 1 },
+    "revision": { "type": "string", "minLength": 1 },
+    "checklistItem": {
+      "type": "object",
+      "required": ["text"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,64}$" },
+        "text": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "done": { "type": "boolean" },
+        "required": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "target": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["kind", "key", "recipe_id"],
+          "properties": {
+            "kind": { "const": "queue" },
+            "key": { "type": "string", "minLength": 1 },
+            "recipe_id": { "type": "string", "minLength": 1 },
+            "public_reference": { "type": "object" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["kind", "scope_type", "scope_id", "key", "recipe_id"],
+          "properties": {
+            "kind": { "const": "anchor" },
+            "scope_type": { "type": "string", "minLength": 1 },
+            "scope_id": { "type": "integer" },
+            "key": { "type": "string", "minLength": 1 },
+            "recipe_id": { "type": "string", "minLength": 1 },
+            "public_reference": { "type": "object" }
+          },
+          "additionalProperties": false
+        }
+      ]
+    }
+  },
+  "type": "object",
+  "required": ["protocol", "request_id", "action", "arguments"],
+  "properties": {
+    "protocol": { "const": "jazari/v1" },
+    "request_id": { "$ref": "#/$defs/requestId" },
+    "action": { "type": "string" },
+    "target": { "$ref": "#/$defs/target" },
+    "arguments": { "type": "object" }
+  },
+  "additionalProperties": false,
+  "oneOf": [
+    {
+      "properties": {
+        "action": { "const": "capabilities" },
+        "arguments": { "type": "object", "maxProperties": 0, "additionalProperties": false }
+      },
+      "not": { "required": ["target"] }
+    },
+    {
+      "required": ["target"],
+      "properties": {
+        "action": { "enum": ["get", "last_run"] },
+        "arguments": { "type": "object", "maxProperties": 0, "additionalProperties": false }
+      }
+    },
+    {
+      "required": ["target"],
+      "properties": {
+        "action": { "const": "set" },
+        "arguments": {
+          "type": "object",
+          "required": ["expected_revision", "topic", "checklist"],
+          "properties": {
+            "expected_revision": { "$ref": "#/$defs/revision" },
+            "topic": { "type": "string", "minLength": 1, "maxLength": 120 },
+            "description": { "type": "string", "maxLength": 20000 },
+            "checklist": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/checklistItem" },
+              "description": "The normalized stored checklist must be at most 65536 bytes."
+            }
+          },
+          "additionalProperties": false
+        }
+      }
+    },
+    {
+      "required": ["target"],
+      "properties": {
+        "action": { "const": "add_item" },
+        "arguments": {
+          "type": "object", "required": ["expected_revision", "text"],
+          "properties": {
+            "expected_revision": { "$ref": "#/$defs/revision" },
+            "text": { "type": "string", "minLength": 1, "maxLength": 500 },
+            "required": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        }
+      }
+    },
+    {
+      "required": ["target"],
+      "properties": {
+        "action": { "const": "remove_item" },
+        "arguments": {
+          "type": "object", "required": ["expected_revision", "item_id"],
+          "properties": {
+            "expected_revision": { "$ref": "#/$defs/revision" },
+            "item_id": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        }
+      }
+    },
+    {
+      "required": ["target"],
+      "properties": {
+        "action": { "const": "check_item" },
+        "arguments": {
+          "type": "object", "required": ["expected_revision", "item_id", "done"],
+          "properties": {
+            "expected_revision": { "$ref": "#/$defs/revision" },
+            "item_id": { "type": "string", "minLength": 1 },
+            "done": { "type": "boolean" }
+          },
+          "additionalProperties": false
+        }
+      }
+    },
+    {
+      "required": ["target"],
+      "properties": {
+        "action": { "const": "reset" },
+        "arguments": {
+          "type": "object", "required": ["expected_revision", "confirm"],
+          "properties": {
+            "expected_revision": { "$ref": "#/$defs/revision" },
+            "confirm": { "type": "boolean", "const": true }
+          },
+          "additionalProperties": false
+        }
+      }
+    },
+    {
+      "required": ["target"],
+      "properties": {
+        "action": { "const": "start" },
+        "arguments": {
+          "type": "object", "required": ["actor_ref"],
+          "properties": { "actor_ref": { "type": "string", "minLength": 1 } },
+          "additionalProperties": false
+        }
+      }
+    },
+    {
+      "required": ["target"],
+      "properties": {
+        "action": { "const": "tick" },
+        "arguments": {
+          "type": "object", "required": ["run_id", "expected_revision", "item_id", "done"],
+          "properties": {
+            "run_id": { "type": "integer", "minimum": 1 },
+            "expected_revision": { "$ref": "#/$defs/revision" },
+            "item_id": { "type": "string", "minLength": 1 },
+            "done": { "type": "boolean" },
+            "actor_ref": { "type": "string", "minLength": 1 },
+            "note": { "type": "string", "maxLength": 500 }
+          },
+          "additionalProperties": false
+        }
+      }
+    },
+    {
+      "required": ["target"],
+      "properties": {
+        "action": { "const": "evidence" },
+        "arguments": {
+          "type": "object", "required": ["run_id", "expected_revision", "kind", "value"],
+          "properties": {
+            "run_id": { "type": "integer", "minimum": 1 },
+            "expected_revision": { "$ref": "#/$defs/revision" },
+            "item_id": { "type": "string", "minLength": 1 },
+            "kind": { "enum": ["output", "url", "sha", "count", "note"] },
+            "value": { "type": "string", "maxLength": 2000 },
+            "actor_ref": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        }
+      }
+    },
+    {
+      "required": ["target"],
+      "properties": {
+        "action": { "const": "finish" },
+        "arguments": {
+          "type": "object", "required": ["run_id", "expected_revision", "outcome"],
+          "properties": {
+            "run_id": { "type": "integer", "minimum": 1 },
+            "expected_revision": { "$ref": "#/$defs/revision" },
+            "outcome": { "enum": ["completed", "abandoned", "failed"] }
+          },
+          "additionalProperties": false
+        }
+      }
+    }
+  ]
+}

data/protocol/v1/response.schema.json

@@ -0,0 +1,124 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/nauman/jazari/protocol/v1/response.schema.json",
+  "title": "Jazari v1 response",
+  "$defs": {
+    "checklistItem": {
+      "type": "object",
+      "required": ["id", "text", "done", "required"],
+      "properties": {
+        "id": { "type": "string" }, "text": { "type": "string" },
+        "done": { "type": "boolean" }, "required": { "type": "boolean" },
+        "post_snapshot": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+    "lastRun": {
+      "type": ["object", "null"],
+      "properties": {
+        "id": { "type": "integer" },
+        "outcome": { "type": ["string", "null"] },
+        "started_at": { "type": "string" },
+        "finished_at": { "type": ["string", "null"] },
+        "open": { "type": "boolean" }
+      },
+      "required": ["id", "outcome", "started_at", "finished_at", "open"],
+      "additionalProperties": false
+    },
+    "resolved": {
+      "type": "object",
+      "required": ["state", "revision", "topic", "description", "checklist", "progress", "target_reference", "recipe", "last_run", "origin"],
+      "properties": {
+        "state": { "enum": ["default", "custom"] },
+        "revision": { "type": "string" },
+        "topic": { "type": "string" }, "description": { "type": "string" },
+        "checklist": { "type": "array", "items": { "$ref": "#/$defs/checklistItem" } },
+        "progress": {
+          "type": "object", "required": ["done", "total", "percent"],
+          "properties": { "done": { "type": "integer" }, "total": { "type": "integer" }, "percent": { "type": "integer" } },
+          "additionalProperties": false
+        },
+        "target_reference": { "type": "object" },
+        "recipe": {
+          "type": "object", "required": ["id", "version", "digest"],
+          "properties": { "id": { "type": "string" }, "version": { "type": "integer" }, "digest": { "type": "string" } },
+          "additionalProperties": false
+        },
+        "last_run": { "$ref": "#/$defs/lastRun" },
+        "origin": { "type": ["string", "null"] }
+      },
+      "additionalProperties": false
+    },
+    "run": {
+      "type": "object",
+      "required": ["run_id", "revision", "recipe", "started_at", "started_on", "finished_at", "outcome", "open", "ticks", "evidence"],
+      "properties": {
+        "run_id": { "type": "integer" }, "revision": { "type": "string" },
+        "recipe": { "type": "string" }, "started_at": { "type": "string" },
+        "started_on": { "type": "string", "format": "date" },
+        "finished_at": { "type": ["string", "null"] },
+        "outcome": { "type": ["string", "null"] }, "open": { "type": "boolean" },
+        "ticks": {
+          "type": "array",
+          "items": {
+            "type": "object", "required": ["id", "done", "at", "actor_ref", "note"],
+            "properties": {
+              "id": { "type": "string" }, "done": { "type": "boolean" },
+              "at": { "type": "string" }, "actor_ref": { "type": "string" },
+              "note": { "type": ["string", "null"] }, "post_snapshot": { "type": "boolean" }
+            },
+            "additionalProperties": false
+          }
+        },
+        "evidence": {
+          "type": "array",
+          "items": {
+            "type": "object", "required": ["item_id", "kind", "value", "at", "actor_ref"],
+            "properties": {
+              "item_id": { "type": ["string", "null"] },
+              "kind": { "enum": ["output", "url", "sha", "count", "note"] },
+              "value": { "type": "string", "maxLength": 2000 },
+              "at": { "type": "string" }, "actor_ref": { "type": "string" }
+            },
+            "additionalProperties": false
+          }
+        },
+        "created": { "type": "boolean" }, "idempotent_reuse": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "oneOf": [
+    {
+      "type": "object",
+      "required": ["protocol", "request_id", "action", "ok", "result"],
+      "properties": {
+        "protocol": { "const": "jazari/v1" }, "request_id": { "type": "string" },
+        "action": { "type": "string" }, "ok": { "const": true },
+        "result": {
+          "oneOf": [
+            { "$ref": "capability.schema.json" },
+            { "$ref": "#/$defs/resolved" },
+            { "$ref": "#/$defs/run" },
+            {
+              "type": "object", "required": ["last_run"],
+              "properties": { "last_run": { "type": "null" } },
+              "additionalProperties": false
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    {
+      "type": "object",
+      "required": ["protocol", "request_id", "action", "ok", "error"],
+      "properties": {
+        "protocol": { "const": "jazari/v1" }, "request_id": { "type": "string" },
+        "action": { "type": "string" }, "ok": { "const": false },
+        "error": { "$ref": "error.schema.json" }
+      },
+      "additionalProperties": false
+    }
+  ]
+}

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: jazari
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Nauman Tariq
-bindir: bin
+bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
@@ -37,12 +37,27 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.1'
 description: A procedure you can call instead of a document you hope someone reads.
   Recipes as data, per-subject overrides, stable queue names for rituals that outlive
   any record, and per-run evidence so "did last night's run complete?" is a query.
 email:
 - 90499+nauman@users.noreply.github.com
-executables: []
+executables:
+- jazari
 extensions: []
 extra_rdoc_files: []
 files:
@@ -54,6 +69,7 @@ files:
 - app/models/jazari/recipe_record.rb
 - app/models/jazari/run.rb
 - app/models/jazari/runbook.rb
+- exe/jazari
 - lib/generators/jazari/install/install_generator.rb
 - lib/generators/jazari/install/templates/create_jazari_tables.rb
 - lib/generators/jazari/upgrade/templates/add_jazari_runbook_origin.rb
@@ -64,20 +80,36 @@ files:
 - lib/jazari/errors.rb
 - lib/jazari/mcp/actions.rb
 - lib/jazari/mcp/handler.rb
+- lib/jazari/mcp/stdio_server.rb
 - lib/jazari/operations.rb
+- lib/jazari/protocol/dispatcher.rb
 - lib/jazari/railtie.rb
 - lib/jazari/recipe.rb
 - lib/jazari/recipe_files.rb
 - lib/jazari/recipe_registry.rb
 - lib/jazari/resolved_runbook.rb
 - lib/jazari/runs.rb
+- lib/jazari/standalone.rb
+- lib/jazari/standalone/database.rb
 - lib/jazari/targets.rb
 - lib/jazari/version.rb
-homepage: https://github.com/nauman/jazari
+- protocol/v1/capability.schema.json
+- protocol/v1/error.schema.json
+- protocol/v1/fixtures/actor-attribution/scenario.json
+- protocol/v1/fixtures/daily-idempotency/scenario.json
+- protocol/v1/fixtures/evidence/scenario.json
+- protocol/v1/fixtures/operator-edit-wins/scenario.json
+- protocol/v1/fixtures/resolve-default/scenario.json
+- protocol/v1/fixtures/revision-conflict/scenario.json
+- protocol/v1/fixtures/run-closed/scenario.json
+- protocol/v1/fixtures/run-snapshot/scenario.json
+- protocol/v1/request.schema.json
+- protocol/v1/response.schema.json
+homepage: https://nauman.github.io/jazari/
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/nauman/jazari
+  homepage_uri: https://nauman.github.io/jazari/
   source_code_uri: https://github.com/nauman/jazari
   changelog_uri: https://github.com/nauman/jazari/blob/main/CHANGELOG.md
 rdoc_options: []