ace-swarm 2.0.6 → 2.0.7

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,92 @@
+{
+  "$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",
+              "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/SKILL_CATALOG.md

@@ -0,0 +1,48 @@
+# SKILL_CATALOG
+
+## Objective
+Map role capabilities to reproducible, portable skills and verification checks.
+
+## Portable Skill Contract
+
+A skill is production-ready only if:
+
+1. `SKILL.md` is the canonical portable source of truth.
+2. Frontmatter description says what the skill does and when to use it.
+3. `SKILL.md` includes:
+   - canonical use cases
+   - Inputs
+   - Workflow/Steps
+   - Outputs/Artifacts
+   - Failure Policy/Troubleshooting
+4. The skill exposes a validation surface:
+   - trigger canaries
+   - at least one functional path with expected evidence
+5. Long or reference-heavy skills use `references/` for progressive disclosure.
+6. Any files under `agents/` are optional client overlays only.
+7. Client overlays must mirror the portable contract, not redefine it.
+
+## Building Blocks
+
+| Skill | Primary Role(s) | Entry Criteria | Output Contract |
+|---|---|---|---|
+| `problem-triage` | research, spec, ops | before creating or patching a skill | `PROBLEM_TRIAGE.md` route decision |
+| `skill-auditor` | skeptic, research, ops | before remediation or release of skill changes | `SKILL_AUDIT_REPORT.md` |
+| `state-auditor` | skeptic, ops | before/after each cycle | state coherence report |
+| `schema-forge` | spec, research | new/changed interface | semver schema + changelog |
+| `handoff-lint` | ops, qa | before handoff commit | pass/fail lint report |
+| `memory-curator` | memory | snapshot age > 24h or high drift | reconciled memory artifact |
+| `risk-quant` | skeptic, security | any new risk | probability-impact table + mitigation state |
+| `eval-harness` | eval, qa | release candidate or major changes | eval run output + regression diff |
+| `incident-commander` | observability, ops | SLO breach or gate storm | incident timeline + owner map |
+| `landing-review-watcher` | release, ops, qa | active review / CI / merge loop | `LANDING_REVIEW_WATCH.md` |
+| `release-sentry` | release | promotion request | release decision payload |
+
+## Audit Questions
+
+1. Does the skill still make sense with no `agents/*` overlay present?
+2. If overlays exist, are they clearly optional and parity-only?
+3. Does the description contain trigger language rather than generic capability labels?
+4. Are use cases concrete enough to distinguish this skill from adjacent ones?
+5. Does the skill expose validation evidence rather than pure prose?
+6. Should the skill be split into `references/` to stay lean?

package/assets/agent-state/runtime-executor-sessions.json

@@ -0,0 +1,5 @@
+{
+  "version": 1,
+  "updated_at": "1970-01-01T00:00:00.000Z",
+  "sessions": []
+}

package/assets/agent-state/runtime-tool-specs.json

@@ -0,0 +1,5 @@
+{
+  "version": 1,
+  "updated_at": "1970-01-01T00:00:00.000Z",
+  "tools": []
+}

package/assets/agent-state/runtime-workspaces.json

@@ -0,0 +1,5 @@
+{
+  "version": 1,
+  "updated_at": "1970-01-01T00:00:00.000Z",
+  "sessions": []
+}

package/assets/agent-state/tracker-snapshot.json

@@ -0,0 +1,7 @@
+{
+  "version": 1,
+  "adapter_kind": "none",
+  "updated_at": "1970-01-01T00:00:00.000Z",
+  "items": [],
+  "comments": []
+}

package/assets/agent-state/vericify/ace-bridge.json

@@ -0,0 +1,60 @@
+{
+  "version": 1,
+  "generated_at": "1970-01-01T00:00:00.000Z",
+  "bridge_enabled": false,
+  "workspace_root": ".",
+  "runtime_profile_path": "agent-state/ACE_WORKFLOW.md",
+  "bridge_path": "agent-state/vericify/ace-bridge.json",
+  "process_post_path": "agent-state/vericify/process-posts.json",
+  "sources": {
+    "handoff_registry": {
+      "path": "agent-state/handoff-registry.json",
+      "exists": false,
+      "record_count": 0,
+      "summary": "missing"
+    },
+    "todo_state": {
+      "path": "agent-state/todo-state.json",
+      "exists": false,
+      "record_count": 0,
+      "summary": "missing"
+    },
+    "run_ledger": {
+      "path": "agent-state/run-ledger.json",
+      "exists": false,
+      "record_count": 0,
+      "summary": "missing"
+    },
+    "status_events": {
+      "path": "agent-state/STATUS_EVENTS.ndjson",
+      "exists": false,
+      "record_count": 0,
+      "summary": "missing"
+    },
+    "runtime_workspaces": {
+      "path": "agent-state/runtime-workspaces.json",
+      "exists": false,
+      "record_count": 0,
+      "summary": "missing"
+    },
+    "runtime_executor_sessions": {
+      "path": "agent-state/runtime-executor-sessions.json",
+      "exists": false,
+      "record_count": 0,
+      "summary": "missing"
+    },
+    "tracker_snapshot": {
+      "path": "agent-state/tracker-snapshot.json",
+      "exists": false,
+      "record_count": 0,
+      "summary": "missing"
+    },
+    "process_posts": {
+      "path": "agent-state/vericify/process-posts.json",
+      "exists": false,
+      "record_count": 0,
+      "summary": "missing"
+    }
+  },
+  "active_run_refs": []
+}

package/assets/agent-state/vericify/process-posts.json

@@ -0,0 +1,5 @@
+{
+  "version": 1,
+  "updated_at": "1970-01-01T00:00:00.000Z",
+  "posts": []
+}