@kylecheng3146/agent-ops 0.0.1

package/schemas/config.schema.json

@@ -0,0 +1,231 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/kylecheng3146/agent-ops/schemas/config.schema.json",
+  "title": "Agent Ops configuration",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "profiles",
+    "verification",
+    "pathMappings",
+    "securityExceptions"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "profiles": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "enum": ["core", "advisory", "guardrails"]
+      }
+    },
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["commands"],
+      "properties": {
+        "commands": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              {
+                "$ref": "#/$defs/directCommand"
+              },
+              {
+                "$ref": "#/$defs/shellCommand"
+              }
+            ]
+          }
+        }
+      }
+    },
+    "pathMappings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "verifierIds"],
+        "properties": {
+          "path": {
+            "$ref": "#/$defs/relativePath"
+          },
+          "verifierIds": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "$ref": "#/$defs/id"
+            }
+          }
+        }
+      }
+    },
+    "securityExceptions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["ruleId", "scope", "expiresAt", "reason"],
+        "properties": {
+          "ruleId": {
+            "$ref": "#/$defs/id"
+          },
+          "scope": {
+            "allOf": [
+              {
+                "$ref": "#/$defs/relativePath"
+              },
+              {
+                "not": {
+                  "const": "."
+                }
+              }
+            ]
+          },
+          "expiresAt": {
+            "$ref": "#/$defs/timestamp"
+          },
+          "reason": {
+            "$ref": "#/$defs/nonEmptyString"
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{0,127}$"
+    },
+    "nonEmptyString": {
+      "type": "string",
+      "pattern": "[^\\s\\u0000]",
+      "not": {
+        "pattern": "\\u0000"
+      }
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?!0000-)\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:[0-5]\\d(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$",
+      "$comment": "Runtime uses a case-sensitive RFC 3339 subset with years 0001-9999 and seconds 00-59; leap seconds are intentionally unsupported."
+    },
+    "relativePath": {
+      "type": "string",
+      "pattern": "^(?:\\.|(?![A-Za-z]:)(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.{1,2}(?:/|$))[A-Za-z0-9._-]+(?:/[A-Za-z0-9._-]+)*)$",
+      "allOf": [
+        {
+          "not": {
+            "pattern": "(?:^|/)(?:[Aa][Uu][Xx]|[Cc][Oo][Mm][1-9]|[Cc][Oo][Nn]|[Ll][Pp][Tt][1-9]|[Nn][Uu][Ll]|[Pp][Rr][Nn])(?:\\.[A-Za-z0-9._-]*)?(?:/|$)"
+          }
+        },
+        {
+          "not": {
+            "pattern": "(?:^|/)[^/]+\\.(?:/|$)"
+          }
+        }
+      ]
+    },
+    "evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind"],
+      "properties": {
+        "kind": {
+          "enum": ["exit-code", "test-count", "file"]
+        },
+        "minimum": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 9007199254740991
+        }
+      }
+    },
+    "commandFields": {
+      "type": "object",
+      "required": ["id", "command", "args", "cwd", "required", "evidence"],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/id"
+        },
+        "command": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "args": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[^\\u0000]*$"
+          }
+        },
+        "cwd": {
+          "$ref": "#/$defs/relativePath"
+        },
+        "required": {
+          "type": "boolean"
+        },
+        "timeoutMs": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 2147483647
+        },
+        "evidence": {
+          "$ref": "#/$defs/evidence"
+        }
+      }
+    },
+    "directCommand": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/commandFields"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "id": true,
+            "command": true,
+            "args": true,
+            "cwd": true,
+            "required": true,
+            "timeoutMs": true,
+            "evidence": true,
+            "shell": {
+              "const": false
+            }
+          }
+        }
+      ]
+    },
+    "shellCommand": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/commandFields"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["shell", "acknowledgeRisk"],
+          "properties": {
+            "id": true,
+            "command": true,
+            "args": true,
+            "cwd": true,
+            "required": true,
+            "timeoutMs": true,
+            "evidence": true,
+            "shell": {
+              "const": true
+            },
+            "acknowledgeRisk": {
+              "const": true
+            }
+          }
+        }
+      ]
+    }
+  },
+  "$comment": "Duplicate IDs and verifier reference resolution are semantic constraints enforced by runtime validation."
+}

package/schemas/evidence.schema.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/kylecheng3146/agent-ops/schemas/evidence.schema.json",
+  "title": "Agent Ops verification evidence",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "taskId",
+    "criterionId",
+    "commandId",
+    "argv",
+    "cwd",
+    "scope",
+    "startedAt",
+    "finishedAt",
+    "exitCode",
+    "testCount",
+    "toolVersions",
+    "configHash"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "taskId": {
+      "$ref": "#/$defs/id"
+    },
+    "criterionId": {
+      "$ref": "#/$defs/id"
+    },
+    "commandId": {
+      "$ref": "#/$defs/id"
+    },
+    "argv": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "pattern": "^[^\\u0000]*$"
+      }
+    },
+    "cwd": {
+      "$ref": "#/$defs/relativePath"
+    },
+    "scope": {
+      "enum": ["project", "user"]
+    },
+    "startedAt": {
+      "$ref": "#/$defs/timestamp"
+    },
+    "finishedAt": {
+      "$ref": "#/$defs/timestamp"
+    },
+    "exitCode": {
+      "type": ["integer", "null"],
+      "minimum": 0,
+      "maximum": 4294967295
+    },
+    "testCount": {
+      "type": ["integer", "null"],
+      "minimum": 0,
+      "maximum": 9007199254740991
+    },
+    "toolVersions": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/$defs/nonEmptyString"
+      }
+    },
+    "configHash": {
+      "$ref": "#/$defs/hash"
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{0,127}$"
+    },
+    "hash": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "nonEmptyString": {
+      "type": "string",
+      "pattern": "[^\\s\\u0000]",
+      "not": {
+        "pattern": "\\u0000"
+      }
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "pattern": "^(?!0000-)\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:[0-5]\\d(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})$",
+      "$comment": "Runtime uses a case-sensitive RFC 3339 subset with years 0001-9999 and seconds 00-59; leap seconds are intentionally unsupported."
+    },
+    "relativePath": {
+      "type": "string",
+      "pattern": "^(?:\\.|(?![A-Za-z]:)(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.{1,2}(?:/|$))[A-Za-z0-9._-]+(?:/[A-Za-z0-9._-]+)*)$",
+      "allOf": [
+        {
+          "not": {
+            "pattern": "(?:^|/)(?:[Aa][Uu][Xx]|[Cc][Oo][Mm][1-9]|[Cc][Oo][Nn]|[Ll][Pp][Tt][1-9]|[Nn][Uu][Ll]|[Pp][Rr][Nn])(?:\\.[A-Za-z0-9._-]*)?(?:/|$)"
+          }
+        },
+        {
+          "not": {
+            "pattern": "(?:^|/)[^/]+\\.(?:/|$)"
+          }
+        }
+      ]
+    }
+  },
+  "$comment": "Timestamp ordering is a semantic constraint enforced by runtime validation."
+}

package/schemas/manifest.schema.json

@@ -0,0 +1,116 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/kylecheng3146/agent-ops/schemas/manifest.schema.json",
+  "title": "Agent Ops installation manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "scope", "harness", "artifacts", "markers"],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "scope": {
+      "enum": ["project", "user"]
+    },
+    "harness": {
+      "enum": ["codex", "claude", "both"]
+    },
+    "artifacts": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/managedPath"
+      }
+    },
+    "markers": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/managedMarker"
+      }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{0,127}$"
+    },
+    "hash": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "relativePath": {
+      "type": "string",
+      "pattern": "^(?!\\.$)(?![A-Za-z]:)(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.{1,2}(?:/|$))[A-Za-z0-9._-]+(?:/[A-Za-z0-9._-]+)*$",
+      "allOf": [
+        {
+          "not": {
+            "pattern": "(?:^|/)(?:[Aa][Uu][Xx]|[Cc][Oo][Mm][1-9]|[Cc][Oo][Nn]|[Ll][Pp][Tt][1-9]|[Nn][Uu][Ll]|[Pp][Rr][Nn])(?:\\.[A-Za-z0-9._-]*)?(?:/|$)"
+          }
+        },
+        {
+          "not": {
+            "pattern": "(?:^|/)[^/]+\\.(?:/|$)"
+          }
+        }
+      ]
+    },
+    "managedPath": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "hash", "owner"],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/id"
+        },
+        "path": {
+          "$ref": "#/$defs/relativePath"
+        },
+        "hash": {
+          "$ref": "#/$defs/hash"
+        },
+        "owner": {
+          "const": "agent-ops"
+        }
+      }
+    },
+    "managedMarker": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "path",
+        "hash",
+        "owner",
+        "startMarker",
+        "endMarker"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/id"
+        },
+        "path": {
+          "$ref": "#/$defs/relativePath"
+        },
+        "hash": {
+          "$ref": "#/$defs/hash"
+        },
+        "owner": {
+          "const": "agent-ops"
+        },
+        "startMarker": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "endMarker": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      }
+    },
+    "nonEmptyString": {
+      "type": "string",
+      "pattern": "[^\\s\\u0000]",
+      "not": {
+        "pattern": "\\u0000"
+      }
+    }
+  },
+  "$comment": "Cross-collection path ownership uniqueness is a semantic constraint enforced by runtime validation."
+}

package/schemas/task.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/kylecheng3146/agent-ops/schemas/task.schema.json",
+  "title": "Agent Ops task",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "title", "criteria"],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "id": {
+      "$ref": "#/$defs/id"
+    },
+    "title": {
+      "$ref": "#/$defs/nonEmptyString"
+    },
+    "criteria": {
+      "type": "array",
+      "minItems": 2,
+      "maxItems": 5,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "description", "verifierIds"],
+        "properties": {
+          "id": {
+            "$ref": "#/$defs/id"
+          },
+          "description": {
+            "$ref": "#/$defs/nonEmptyString"
+          },
+          "verifierIds": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": {
+              "$ref": "#/$defs/id"
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{0,127}$"
+    },
+    "nonEmptyString": {
+      "type": "string",
+      "pattern": "[^\\s\\u0000]",
+      "not": {
+        "pattern": "\\u0000"
+      }
+    }
+  },
+  "$comment": "Criterion ID uniqueness is a semantic constraint enforced by runtime validation."
+}

package/templates/common/AGENTS.block.md

@@ -0,0 +1,3 @@
+## Loop Engineering
+
+Use `.agent-ops/AGENTS.md` as the canonical Loop Engineering specification for this project.

package/templates/common/CLAUDE.block.md

@@ -0,0 +1,3 @@
+## Loop Engineering
+
+Use `.agent-ops/CLAUDE.md` as the canonical Loop Engineering specification for this project.