@voybio/ace-swarm 0.1.0

package/assets/agent-state/MODULES/schemas/SWARM_HANDOFF.schema.json

@@ -0,0 +1,138 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "ace://schemas/swarm-handoff/1.0.0",
+  "title": "ACE Swarm Handoff",
+  "type": "object",
+  "required": [
+    "handoff_id",
+    "timestamp_utc",
+    "router",
+    "task",
+    "context",
+    "acceptance_criteria",
+    "verification",
+    "return_payload_contract"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "handoff_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "timestamp_utc": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "router": {
+      "type": "object",
+      "required": [
+        "from",
+        "via",
+        "to"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "from": {"type": "string", "minLength": 1},
+        "via": {"type": "string", "minLength": 1},
+        "to": {"type": "string", "minLength": 1}
+      }
+    },
+    "task": {
+      "type": "object",
+      "required": [
+        "title",
+        "type",
+        "priority",
+        "owner",
+        "depends_on",
+        "scope"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "title": {"type": "string", "minLength": 1},
+        "type": {"type": "string", "enum": ["venture", "ux", "engineering", "mixed"]},
+        "priority": {"type": "string", "enum": ["P0", "P1", "P2"]},
+        "owner": {"type": "string", "minLength": 1},
+        "depends_on": {"type": "array", "items": {"type": "string"}},
+        "scope": {"type": "string", "minLength": 1}
+      }
+    },
+    "context": {
+      "type": "object",
+      "required": [
+        "business_requirement",
+        "design_constraint",
+        "engineering_constraint",
+        "directive"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "business_requirement": {"type": "string"},
+        "design_constraint": {"type": "string"},
+        "engineering_constraint": {"type": "string"},
+        "directive": {"type": "string", "minLength": 1}
+      }
+    },
+    "acceptance_criteria": {
+      "type": "array",
+      "minItems": 1,
+      "items": {"type": "string", "minLength": 1}
+    },
+    "deliverables": {
+      "type": "array",
+      "items": {"type": "string"}
+    },
+    "verification": {
+      "type": "object",
+      "required": [
+        "required_evidence",
+        "review_check",
+        "status"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "required_evidence": {
+          "type": "array",
+          "minItems": 1,
+          "items": {"type": "string", "minLength": 1}
+        },
+        "review_check": {"type": "string", "minLength": 1},
+        "status": {"type": "string", "enum": ["pending", "in_progress", "pass", "fail"]}
+      }
+    },
+    "risks": {
+      "type": "array",
+      "items": {"type": "string"}
+    },
+    "open_questions": {
+      "type": "array",
+      "items": {"type": "string"}
+    },
+    "lessons_hook": {
+      "type": "object",
+      "required": [
+        "on_correction_update",
+        "rule_format"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "on_correction_update": {"type": "string", "minLength": 1},
+        "rule_format": {"type": "string", "minLength": 1}
+      }
+    },
+    "return_payload_contract": {
+      "type": "object",
+      "required": [
+        "must_include"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "must_include": {
+          "type": "array",
+          "minItems": 1,
+          "items": {"type": "string", "minLength": 1}
+        }
+      }
+    }
+  }
+}

package/assets/agent-state/MODULES/schemas/TRACKER_SNAPSHOT.schema.json

@@ -0,0 +1,134 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "ace://schemas/tracker-snapshot/1.0.0",
+  "title": "ACE Tracker Snapshot",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "adapter_kind",
+    "updated_at",
+    "items",
+    "comments"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1
+    },
+    "adapter_kind": {
+      "type": "string",
+      "enum": [
+        "none",
+        "memory",
+        "external"
+      ]
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "items": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/item"
+      }
+    },
+    "comments": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/comment"
+      }
+    }
+  },
+  "$defs": {
+    "item": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "item_id",
+        "title",
+        "state",
+        "labels",
+        "updated_at",
+        "metadata"
+      ],
+      "properties": {
+        "item_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "external_id": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "body": {
+          "type": "string"
+        },
+        "state": {
+          "type": "string",
+          "minLength": 1
+        },
+        "labels": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "assignee": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        },
+        "updated_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "metadata": {
+          "type": "object"
+        }
+      }
+    },
+    "comment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "comment_id",
+        "item_id",
+        "body",
+        "author",
+        "created_at",
+        "metadata"
+      ],
+      "properties": {
+        "comment_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "item_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "body": {
+          "type": "string",
+          "minLength": 1
+        },
+        "author": {
+          "type": "string",
+          "minLength": 1
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "metadata": {
+          "type": "object"
+        }
+      }
+    }
+  }
+}

package/assets/agent-state/MODULES/schemas/VERICIFY_BRIDGE_SNAPSHOT.schema.json

@@ -0,0 +1,157 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "ace://schemas/vericify-bridge-snapshot/1.0.0",
+  "title": "Vericify Bridge Snapshot",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "generated_at",
+    "bridge_enabled",
+    "workspace_root",
+    "runtime_profile_path",
+    "bridge_path",
+    "process_post_path",
+    "sources",
+    "active_run_refs"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1
+    },
+    "generated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "bridge_enabled": {
+      "type": "boolean"
+    },
+    "workspace_root": {
+      "type": "string",
+      "minLength": 1
+    },
+    "runtime_profile_path": {
+      "type": "string",
+      "minLength": 1
+    },
+    "bridge_path": {
+      "type": "string",
+      "minLength": 1
+    },
+    "process_post_path": {
+      "type": "string",
+      "minLength": 1
+    },
+    "sources": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "handoff_registry",
+        "todo_state",
+        "run_ledger",
+        "status_events",
+        "runtime_workspaces",
+        "runtime_executor_sessions",
+        "tracker_snapshot",
+        "process_posts"
+      ],
+      "properties": {
+        "handoff_registry": { "$ref": "#/$defs/SourceState" },
+        "todo_state": { "$ref": "#/$defs/SourceState" },
+        "run_ledger": { "$ref": "#/$defs/SourceState" },
+        "status_events": { "$ref": "#/$defs/SourceState" },
+        "runtime_workspaces": { "$ref": "#/$defs/SourceState" },
+        "runtime_executor_sessions": { "$ref": "#/$defs/SourceState" },
+        "tracker_snapshot": { "$ref": "#/$defs/SourceState" },
+        "process_posts": { "$ref": "#/$defs/SourceState" }
+      }
+    },
+    "active_run_refs": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/ActiveRunRef" }
+    }
+  },
+  "$defs": {
+    "SourceState": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "exists",
+        "record_count",
+        "summary"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "exists": {
+          "type": "boolean"
+        },
+        "updated_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "record_count": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "summary": {
+          "type": "string",
+          "minLength": 1
+        }
+      }
+    },
+    "ActiveRunRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "run_id",
+        "branch_id",
+        "lane_id",
+        "session_id",
+        "status",
+        "workspace_path",
+        "updated_at"
+      ],
+      "properties": {
+        "run_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "branch_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "lane_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "session_id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "status": {
+          "type": "string",
+          "minLength": 1
+        },
+        "objective_id": {
+          "type": "string"
+        },
+        "tracker_item_id": {
+          "type": "string"
+        },
+        "workspace_path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "updated_at": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    }
+  }
+}

package/assets/agent-state/MODULES/schemas/VERICIFY_PROCESS_POST_LOG.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "ace://schemas/vericify-process-post-log/1.0.0",
+  "title": "Vericify Process Post Log",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "updated_at",
+    "posts"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "posts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "process_post_id",
+          "run_id",
+          "agent_id",
+          "kind",
+          "summary",
+          "timestamp",
+          "tool_refs",
+          "evidence_refs"
+        ],
+        "properties": {
+          "process_post_id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "run_id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "branch_id": {
+            "type": "string"
+          },
+          "lane_id": {
+            "type": "string"
+          },
+          "agent_id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "kind": {
+            "type": "string",
+            "enum": [
+              "intent",
+              "progress",
+              "blocker",
+              "handoff_note",
+              "stale_ack",
+              "completion"
+            ]
+          },
+          "summary": {
+            "type": "string",
+            "minLength": 1
+          },
+          "tool_refs": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "evidence_refs": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "checkpoint_ref": {
+            "type": "string"
+          },
+          "timestamp": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      }
+    }
+  }
+}

package/assets/agent-state/MODULES/schemas/WORKSPACE_SESSION_REGISTRY.schema.json

@@ -0,0 +1,133 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "ace://schemas/workspace-session-registry/1.0.0",
+  "title": "ACE Workspace Session Registry",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "updated_at",
+    "sessions"
+  ],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1
+    },
+    "updated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "sessions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "session_id",
+          "workspace_path",
+          "root_path",
+          "status",
+          "source",
+          "created_at",
+          "updated_at",
+          "hooks"
+        ],
+        "properties": {
+          "session_id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "workspace_path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "root_path": {
+            "type": "string",
+            "minLength": 1
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "active",
+              "archived",
+              "removed",
+              "failed"
+            ]
+          },
+          "source": {
+            "type": "string",
+            "enum": [
+              "manual",
+              "executor",
+              "test"
+            ]
+          },
+          "objective_id": {
+            "type": "string"
+          },
+          "tracker_item_id": {
+            "type": "string"
+          },
+          "last_error": {
+            "type": "string"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "hooks": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "after_create",
+              "before_run",
+              "after_run",
+              "before_remove"
+            ],
+            "properties": {
+              "after_create": {
+                "$ref": "#/$defs/hook_state"
+              },
+              "before_run": {
+                "$ref": "#/$defs/hook_state"
+              },
+              "after_run": {
+                "$ref": "#/$defs/hook_state"
+              },
+              "before_remove": {
+                "$ref": "#/$defs/hook_state"
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "hook_state": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status"
+      ],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "not_run",
+            "ok",
+            "failed"
+          ]
+        },
+        "detail": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

package/assets/agent-state/PROVENANCE_LOG.md

@@ -0,0 +1,28 @@
+# PROVENANCE LOG
+
+Append-only artifact provenance ledger. Every produced artifact must be recorded
+here and in `agent-state/ARTIFACT_MANIFEST.json`.
+
+## Required Fields
+
+- artifact_id
+- artifact_path
+- producer_module
+- spec_version
+- req_ids
+- checksum
+- confidence_level
+- evidence_ref
+- timestamp
+
+## Entry Template
+
+### <timestamp> — <artifact_id>
+- artifact_path:
+- producer_module:
+- spec_version:
+- req_ids:
+- checksum:
+- confidence_level:
+- evidence_ref:
+- timestamp:

package/assets/agent-state/QUALITY_GATES.md

@@ -0,0 +1,15 @@
+# QUALITY GATES
+
+## gate-completeness
+
+- Invariant: required artifacts exist and are non-empty.
+- Pass condition: all required files are present with required sections.
+- Fail condition: any missing required artifact or empty required section.
+- Evidence: file list + section checks in `EVIDENCE_LOG.md`.
+
+## gate-correctness
+
+- Invariant: behavior satisfies spec acceptance criteria.
+- Pass condition: mapped tests pass and no unresolved critical failures.
+- Fail condition: failing mapped test, unresolved regression, or invalid provenance.
+- Evidence: test output and verification report pointers.