@piagent/platform 1.0.0

package/packs/engineering-base/pack.json

@@ -0,0 +1,123 @@
+{
+  "apiVersion": "piagent/v1",
+  "kind": "CapabilityPack",
+  "metadata": {
+    "name": "engineering-base",
+    "version": "0.1.1",
+    "owner": "platform-maintainers",
+    "lifecycle": "experimental",
+    "license": "MIT",
+    "description": "Core engineering workflow, policy, verification, and task coordination capabilities.",
+    "tags": [
+      "engineering",
+      "governance"
+    ]
+  },
+  "spec": {
+    "coreApiVersion": 1,
+    "requires": {
+      "packs": []
+    },
+    "provides": {
+      "prompts": [
+        {
+          "id": "task",
+          "path": "packages/piagent-core/prompts/task.md"
+        },
+        {
+          "id": "plan",
+          "path": "packages/piagent-core/prompts/plan.md"
+        },
+        {
+          "id": "review",
+          "path": "packages/piagent-core/prompts/review.md"
+        },
+        {
+          "id": "commit",
+          "path": "packages/piagent-core/prompts/commit.md"
+        },
+        {
+          "id": "pr",
+          "path": "packages/piagent-core/prompts/pr.md"
+        }
+      ],
+      "skills": [
+        {
+          "id": "piagent-ops",
+          "path": "packages/piagent-core/skills/piagent-ops/SKILL.md"
+        }
+      ],
+      "subagents": [
+        {
+          "id": "piagent-scout",
+          "path": "packages/piagent-core/subagents/piagent-scout.md"
+        },
+        {
+          "id": "piagent-planner",
+          "path": "packages/piagent-core/subagents/piagent-planner.md"
+        },
+        {
+          "id": "piagent-worker",
+          "path": "packages/piagent-core/subagents/piagent-worker.md"
+        },
+        {
+          "id": "piagent-reviewer",
+          "path": "packages/piagent-core/subagents/piagent-reviewer.md"
+        }
+      ],
+      "policies": [
+        {
+          "id": "base-policy",
+          "path": "packages/piagent-core/policies/base-policy.json"
+        }
+      ],
+      "adapters": [
+        {
+          "id": "generic",
+          "path": "adapters/generic/profile.json"
+        }
+      ],
+      "recipes": [
+        {
+          "id": "bounded-change",
+          "path": "packs/engineering-base/recipes/bounded-change.json"
+        }
+      ],
+      "evals": [
+        {
+          "id": "capability-resolution",
+          "path": "evals/scenarios/capability-resolution.json"
+        }
+      ]
+    },
+    "permissions": {
+      "capabilities": [
+        "filesystem-readonly",
+        "filesystem-write",
+        "memory",
+        "shell"
+      ],
+      "filesystemRead": [
+        "**/*"
+      ],
+      "filesystemWrite": [
+        "**/*"
+      ],
+      "networkDomains": [],
+      "externalActions": []
+    },
+    "activation": {
+      "mode": "profile",
+      "profiles": [
+        "generic",
+        "platform-development"
+      ],
+      "triggers": []
+    },
+    "verification": {
+      "evalScenarios": [
+        "capability-resolution"
+      ]
+    }
+  }
+}

package/packs/engineering-base/recipes/bounded-change.json

@@ -0,0 +1,82 @@
+{
+  "apiVersion": "piagent/v1",
+  "kind": "CapabilityRecipe",
+  "metadata": {
+    "name": "bounded-change",
+    "version": "0.1.0",
+    "owner": "platform-maintainers",
+    "lifecycle": "experimental",
+    "license": "MIT",
+    "description": "A governed workflow for a bounded repository change with observed verification.",
+    "tags": [
+      "engineering",
+      "verification"
+    ]
+  },
+  "spec": {
+    "inputs": [
+      {
+        "name": "task",
+        "description": "Expected outcome and acceptance criteria.",
+        "required": true
+      }
+    ],
+    "steps": [
+      {
+        "id": "context",
+        "uses": "capability:piagent-context",
+        "mode": "read-only",
+        "needs": [],
+        "timeoutSeconds": 300,
+        "retries": 0,
+        "outputs": [
+          "context-manifest"
+        ]
+      },
+      {
+        "id": "plan",
+        "uses": "capability:piagent-planner",
+        "mode": "read-only",
+        "needs": [
+          "context"
+        ],
+        "timeoutSeconds": 600,
+        "retries": 0,
+        "outputs": [
+          "implementation-plan"
+        ]
+      },
+      {
+        "id": "implement",
+        "uses": "capability:piagent-worker",
+        "mode": "workspace-write",
+        "needs": [
+          "plan"
+        ],
+        "timeoutSeconds": 1800,
+        "retries": 1,
+        "outputs": [
+          "workspace-diff"
+        ]
+      },
+      {
+        "id": "verify",
+        "uses": "capability:piagent-reviewer",
+        "mode": "read-only",
+        "needs": [
+          "implement"
+        ],
+        "timeoutSeconds": 900,
+        "retries": 1,
+        "outputs": [
+          "verification-evidence"
+        ]
+      }
+    ],
+    "gates": {
+      "context": true,
+      "verification": true,
+      "humanApproval": false
+    }
+  }
+}

package/packs/web-delivery/pack.json

@@ -0,0 +1,72 @@
+{
+  "apiVersion": "piagent/v1",
+  "kind": "CapabilityPack",
+  "metadata": {
+    "name": "web-delivery",
+    "version": "0.1.1",
+    "owner": "platform-maintainers",
+    "lifecycle": "experimental",
+    "license": "MIT",
+    "description": "Web application delivery capabilities with browser-assisted verification.",
+    "tags": [
+      "frontend",
+      "web"
+    ]
+  },
+  "spec": {
+    "coreApiVersion": 1,
+    "requires": {
+      "packs": [
+        {
+          "name": "engineering-base",
+          "version": "0.1.1"
+        }
+      ]
+    },
+    "provides": {
+      "prompts": [],
+      "skills": [],
+      "subagents": [],
+      "policies": [],
+      "adapters": [
+        {
+          "id": "web-frontend",
+          "path": "adapters/web-frontend/profile.json"
+        }
+      ],
+      "recipes": [
+        {
+          "id": "verified-web-change",
+          "path": "packs/web-delivery/recipes/verified-web-change.json"
+        }
+      ],
+      "evals": []
+    },
+    "permissions": {
+      "capabilities": [
+        "browser",
+        "filesystem-readonly",
+        "filesystem-write",
+        "shell"
+      ],
+      "filesystemRead": [
+        "**/*"
+      ],
+      "filesystemWrite": [
+        "**/*"
+      ],
+      "networkDomains": [],
+      "externalActions": []
+    },
+    "activation": {
+      "mode": "profile",
+      "profiles": [
+        "web-frontend"
+      ],
+      "triggers": []
+    },
+    "verification": {
+      "evalScenarios": []
+    }
+  }
+}

package/packs/web-delivery/recipes/verified-web-change.json

@@ -0,0 +1,57 @@
+{
+  "apiVersion": "piagent/v1",
+  "kind": "CapabilityRecipe",
+  "metadata": {
+    "name": "verified-web-change",
+    "version": "0.1.0",
+    "owner": "platform-maintainers",
+    "lifecycle": "experimental",
+    "license": "MIT",
+    "description": "A web change workflow with source verification and bounded browser inspection.",
+    "tags": [
+      "frontend",
+      "verification"
+    ]
+  },
+  "spec": {
+    "inputs": [
+      {
+        "name": "task",
+        "description": "Expected interface behavior and acceptance criteria.",
+        "required": true
+      }
+    ],
+    "steps": [
+      {
+        "id": "context",
+        "uses": "recipe:bounded-change",
+        "mode": "workspace-write",
+        "needs": [],
+        "timeoutSeconds": 2400,
+        "retries": 0,
+        "outputs": [
+          "workspace-diff",
+          "verification-evidence"
+        ]
+      },
+      {
+        "id": "browser-check",
+        "uses": "capability:browser-inspection",
+        "mode": "read-only",
+        "needs": [
+          "context"
+        ],
+        "timeoutSeconds": 900,
+        "retries": 1,
+        "outputs": [
+          "runtime-evidence"
+        ]
+      }
+    ],
+    "gates": {
+      "context": true,
+      "verification": true,
+      "humanApproval": false
+    }
+  }
+}

package/schemas/action-proposal.schema.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/Vt-mmm/piagent/schemas/action-proposal.schema.json",
+  "title": "Pi Agent External Action Proposal",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["apiVersion", "kind", "metadata", "spec"],
+  "properties": {
+    "apiVersion": { "const": "piagent/v1" },
+    "kind": { "const": "ExternalActionProposal" },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "createdAt", "expiresAt"],
+      "properties": {
+        "name": { "$ref": "capability-pack.schema.json#/$defs/name" },
+        "createdAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
+        },
+        "expiresAt": {
+          "type": "string",
+          "format": "date-time",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$"
+        }
+      }
+    },
+    "spec": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["actionType", "target", "summary", "riskLane", "requestedPermissions", "artifacts", "dryRun", "security"],
+      "properties": {
+        "actionType": { "$ref": "capability-pack.schema.json#/$defs/actionType" },
+        "target": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["provider", "resource"],
+          "properties": {
+            "provider": { "$ref": "capability-pack.schema.json#/$defs/name" },
+            "resource": { "type": "string", "minLength": 1, "maxLength": 256 },
+            "environment": { "$ref": "capability-pack.schema.json#/$defs/name" }
+          }
+        },
+        "summary": { "type": "string", "minLength": 1, "maxLength": 500 },
+        "riskLane": { "const": "high-risk" },
+        "requestedPermissions": {
+          "type": "array",
+          "maxItems": 32,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "pattern": "^[a-z0-9][a-z0-9:-]{0,127}$"
+          }
+        },
+        "artifacts": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["path", "digest", "mediaType", "byteSize"],
+            "properties": {
+              "path": { "$ref": "capability-pack.schema.json#/$defs/relativePath" },
+              "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+              "mediaType": {
+                "type": "string",
+                "minLength": 3,
+                "maxLength": 128,
+                "pattern": "^[a-zA-Z0-9][a-zA-Z0-9.+-]*\\/[a-zA-Z0-9][a-zA-Z0-9.+-]*$"
+              },
+              "byteSize": { "type": "integer", "minimum": 0, "maximum": 10485760 }
+            }
+          }
+        },
+        "dryRun": { "const": true },
+        "security": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["containsSecrets"],
+          "properties": {
+            "containsSecrets": { "const": false }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/capability-pack.schema.json

@@ -0,0 +1,190 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/Vt-mmm/piagent/schemas/capability-pack.schema.json",
+  "title": "Pi Agent Capability Pack",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["apiVersion", "kind", "metadata", "spec"],
+  "properties": {
+    "apiVersion": { "const": "piagent/v1" },
+    "kind": { "const": "CapabilityPack" },
+    "metadata": { "$ref": "#/$defs/metadata" },
+    "spec": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["coreApiVersion", "requires", "provides", "permissions", "activation", "verification"],
+      "properties": {
+        "coreApiVersion": { "const": 1 },
+        "requires": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["packs"],
+          "properties": {
+            "packs": {
+              "type": "array",
+              "maxItems": 64,
+              "uniqueItems": true,
+              "items": { "$ref": "#/$defs/packDependency" }
+            }
+          }
+        },
+        "provides": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["prompts", "skills", "subagents", "policies", "adapters", "recipes", "evals"],
+          "properties": {
+            "prompts": { "$ref": "#/$defs/artifacts" },
+            "skills": { "$ref": "#/$defs/artifacts" },
+            "subagents": { "$ref": "#/$defs/artifacts" },
+            "policies": { "$ref": "#/$defs/artifacts" },
+            "adapters": { "$ref": "#/$defs/artifacts" },
+            "recipes": { "$ref": "#/$defs/artifacts" },
+            "evals": { "$ref": "#/$defs/artifacts" }
+          }
+        },
+        "permissions": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["capabilities", "filesystemRead", "filesystemWrite", "networkDomains", "externalActions"],
+          "properties": {
+            "capabilities": { "$ref": "#/$defs/names" },
+            "filesystemRead": { "$ref": "#/$defs/pathPatterns" },
+            "filesystemWrite": { "$ref": "#/$defs/pathPatterns" },
+            "networkDomains": {
+              "type": "array",
+              "maxItems": 64,
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "maxLength": 253,
+                "pattern": "^(?:\\*\\.)?[a-z0-9](?:[a-z0-9.-]{0,251}[a-z0-9])?$"
+              }
+            },
+            "externalActions": {
+              "type": "array",
+              "maxItems": 32,
+              "uniqueItems": true,
+              "items": { "$ref": "#/$defs/actionType" }
+            }
+          }
+        },
+        "activation": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["mode", "profiles", "triggers"],
+          "properties": {
+            "mode": { "enum": ["explicit", "profile", "trigger"] },
+            "profiles": { "$ref": "#/$defs/names" },
+            "triggers": {
+              "type": "array",
+              "maxItems": 64,
+              "uniqueItems": true,
+              "items": { "type": "string", "minLength": 1, "maxLength": 256 }
+            }
+          },
+          "allOf": [
+            {
+              "if": { "properties": { "mode": { "const": "trigger" } } },
+              "then": { "properties": { "triggers": { "minItems": 1 } } }
+            }
+          ]
+        },
+        "verification": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["evalScenarios"],
+          "properties": {
+            "evalScenarios": {
+              "type": "array",
+              "maxItems": 64,
+              "uniqueItems": true,
+              "items": { "$ref": "#/$defs/identifier" }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 64,
+      "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
+    },
+    "identifier": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128,
+      "pattern": "^[a-z0-9][a-z0-9._/-]{0,127}$"
+    },
+    "version": {
+      "type": "string",
+      "maxLength": 64,
+      "pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)(?:-[0-9A-Za-z.-]+)?$"
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version", "owner", "lifecycle", "license", "description", "tags"],
+      "properties": {
+        "name": { "$ref": "#/$defs/name" },
+        "version": { "$ref": "#/$defs/version" },
+        "owner": { "$ref": "#/$defs/name" },
+        "lifecycle": { "enum": ["experimental", "stable", "deprecated"] },
+        "license": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "description": { "type": "string", "minLength": 1, "maxLength": 240 },
+        "tags": { "$ref": "#/$defs/names" }
+      }
+    },
+    "packDependency": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "version"],
+      "properties": {
+        "name": { "$ref": "#/$defs/name" },
+        "version": { "$ref": "#/$defs/version" }
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path"],
+      "properties": {
+        "id": { "$ref": "#/$defs/identifier" },
+        "path": { "$ref": "#/$defs/relativePath" }
+      }
+    },
+    "artifacts": {
+      "type": "array",
+      "maxItems": 128,
+      "items": { "$ref": "#/$defs/artifact" }
+    },
+    "names": {
+      "type": "array",
+      "maxItems": 64,
+      "uniqueItems": true,
+      "items": { "$ref": "#/$defs/name" }
+    },
+    "relativePath": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "pattern": "^(?!/)(?![A-Za-z]:)(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$))[^*?\\[\\]{}]+$"
+    },
+    "pathPatterns": {
+      "type": "array",
+      "maxItems": 128,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 512,
+        "pattern": "^(?!/)(?![A-Za-z]:)(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$)).+$"
+      }
+    },
+    "actionType": {
+      "enum": ["git-push", "github-pull-request", "github-issue", "release", "publish", "deploy", "database-change", "external-provider-write"]
+    }
+  }
+}

package/schemas/capability-recipe.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/Vt-mmm/piagent/schemas/capability-recipe.schema.json",
+  "title": "Pi Agent Capability Recipe",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["apiVersion", "kind", "metadata", "spec"],
+  "properties": {
+    "apiVersion": { "const": "piagent/v1" },
+    "kind": { "const": "CapabilityRecipe" },
+    "metadata": { "$ref": "capability-pack.schema.json#/$defs/metadata" },
+    "spec": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["inputs", "steps", "gates"],
+      "properties": {
+        "inputs": {
+          "type": "array",
+          "maxItems": 32,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "description", "required"],
+            "properties": {
+              "name": { "$ref": "capability-pack.schema.json#/$defs/name" },
+              "description": { "type": "string", "minLength": 1, "maxLength": 240 },
+              "required": { "type": "boolean" }
+            }
+          }
+        },
+        "steps": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 64,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "uses", "mode", "needs", "timeoutSeconds", "retries", "outputs"],
+            "properties": {
+              "id": { "$ref": "capability-pack.schema.json#/$defs/name" },
+              "uses": {
+                "type": "string",
+                "maxLength": 128,
+                "pattern": "^(?:capability|recipe):[a-z0-9][a-z0-9._/-]{0,111}$"
+              },
+              "mode": { "enum": ["read-only", "workspace-write", "action-proposal"] },
+              "needs": { "$ref": "capability-pack.schema.json#/$defs/names" },
+              "timeoutSeconds": { "type": "integer", "minimum": 1, "maximum": 3600 },
+              "retries": { "type": "integer", "minimum": 0, "maximum": 3 },
+              "outputs": {
+                "type": "array",
+                "maxItems": 32,
+                "uniqueItems": true,
+                "items": { "$ref": "capability-pack.schema.json#/$defs/identifier" }
+              }
+            }
+          }
+        },
+        "gates": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["context", "verification", "humanApproval"],
+          "properties": {
+            "context": { "type": "boolean" },
+            "verification": { "type": "boolean" },
+            "humanApproval": { "type": "boolean" }
+          }
+        }
+      }
+    }
+  }
+}