@piagent/platform 1.0.0

package/docs-site/vercel.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://openapi.vercel.sh/vercel.json",
+  "cleanUrls": true,
+  "trailingSlash": false,
+  "headers": [
+    {
+      "source": "/(.*)",
+      "headers": [
+        {
+          "key": "X-Content-Type-Options",
+          "value": "nosniff"
+        },
+        {
+          "key": "Referrer-Policy",
+          "value": "strict-origin-when-cross-origin"
+        },
+        {
+          "key": "Permissions-Policy",
+          "value": "camera=(), microphone=(), geolocation=()"
+        }
+      ]
+    }
+  ]
+}

package/evals/fixtures/action-proposal.invalid.json

@@ -0,0 +1,34 @@
+{
+  "apiVersion": "piagent/v1",
+  "kind": "ExternalActionProposal",
+  "metadata": {
+    "name": "publish-release",
+    "createdAt": "{{now}}",
+    "expiresAt": "{{now+1h}}"
+  },
+  "spec": {
+    "actionType": "git-push",
+    "target": {
+      "provider": "github",
+      "resource": "Vt-mmm/piagent",
+      "environment": "production"
+    },
+    "summary": "Push the reviewed release branch for human confirmation.",
+    "riskLane": "high-risk",
+    "requestedPermissions": [
+      "git:push"
+    ],
+    "artifacts": [
+      {
+        "path": "CHANGELOG.md",
+        "digest": "sha256:48b1a29e44eeff814abc6250e43395bf8ac81827f5791261378cb13b6699e37f",
+        "mediaType": "text/markdown",
+        "byteSize": 14
+      }
+    ],
+    "dryRun": true,
+    "security": {
+      "containsSecrets": true
+    }
+  }
+}

package/evals/fixtures/action-proposal.valid.json

@@ -0,0 +1,34 @@
+{
+  "apiVersion": "piagent/v1",
+  "kind": "ExternalActionProposal",
+  "metadata": {
+    "name": "publish-release",
+    "createdAt": "{{now}}",
+    "expiresAt": "{{now+1h}}"
+  },
+  "spec": {
+    "actionType": "git-push",
+    "target": {
+      "provider": "github",
+      "resource": "Vt-mmm/piagent",
+      "environment": "production"
+    },
+    "summary": "Push the reviewed release branch for human confirmation.",
+    "riskLane": "high-risk",
+    "requestedPermissions": [
+      "git:push"
+    ],
+    "artifacts": [
+      {
+        "path": "CHANGELOG.md",
+        "digest": "sha256:48b1a29e44eeff814abc6250e43395bf8ac81827f5791261378cb13b6699e37f",
+        "mediaType": "text/markdown",
+        "byteSize": 14
+      }
+    ],
+    "dryRun": true,
+    "security": {
+      "containsSecrets": false
+    }
+  }
+}

package/evals/fixtures/capability-pack.invalid.json

@@ -0,0 +1,123 @@
+{
+  "apiVersion": "piagent/v0",
+  "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/evals/fixtures/capability-pack.valid.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/evals/fixtures/capability-recipe.invalid.json

@@ -0,0 +1,81 @@
+{
+  "apiVersion": "piagent/v1",
+  "kind": "CapabilityRecipe",
+  "metadata": {
+    "name": "bounded-change",
+    "version": "0.1.0",
+    "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/evals/fixtures/capability-recipe.valid.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/evals/fixtures/context-index.invalid.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 99,
+  "projectId": "replace-me",
+  "profileMode": "generic",
+  "source": "manual",
+  "summary": "Pending. Run /onboard-project after login/model selection to generate the compact project context index.",
+  "generatedAt": "not-configured",
+  "updatedAt": "not-configured",
+  "policy": {
+    "enabled": true,
+    "path": ".pi/context-index.json",
+    "writePolicy": "onboarding-record",
+    "requireCitations": true,
+    "maxNodes": 120,
+    "maxEdges": 240,
+    "includeTechStack": true,
+    "includeMemoryPointers": true
+  },
+  "nodes": [],
+  "edges": [],
+  "citations": [],
+  "warnings": [
+    "context index pending; run /onboard-project"
+  ]
+}

package/evals/fixtures/context-index.valid.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "projectId": "replace-me",
+  "profileMode": "generic",
+  "source": "manual",
+  "summary": "Pending. Run /onboard-project after login/model selection to generate the compact project context index.",
+  "generatedAt": "not-configured",
+  "updatedAt": "not-configured",
+  "policy": {
+    "enabled": true,
+    "path": ".pi/context-index.json",
+    "writePolicy": "onboarding-record",
+    "requireCitations": true,
+    "maxNodes": 120,
+    "maxEdges": 240,
+    "includeTechStack": true,
+    "includeMemoryPointers": true
+  },
+  "nodes": [],
+  "edges": [],
+  "citations": [],
+  "warnings": [
+    "context index pending; run /onboard-project"
+  ]
+}

package/evals/fixtures/eval-scenario.invalid.json

@@ -0,0 +1,40 @@
+{
+  "apiVersion": "piagent/v1",
+  "kind": "EvalScenario",
+  "metadata": {
+    "name": "capability-resolution",
+    "version": "0.1.0",
+    "owner": "platform-maintainers",
+    "lifecycle": "experimental",
+    "license": "MIT",
+    "description": "Validates deterministic capability resolution and protected output boundaries.",
+    "tags": [
+      "capabilities",
+      "security"
+    ]
+  },
+  "spec": {
+    "fixture": {
+      "path": "package.json"
+    },
+    "profile": "adapters/generic/profile.json",
+    "task": "Resolve the selected capability packs and validate lock stability without changing project files.",
+    "expected": {
+      "verifyCommands": [
+        "node scripts/capability-catalog.mjs doctor --profile adapters/generic/profile.json"
+      ],
+      "forbiddenPaths": [
+        ".git/**",
+        "**/.env",
+        "**/auth.json"
+      ],
+      "forbiddenActions": [
+        "external-provider-write",
+        "git-push"
+      ],
+      "requiredArtifacts": [
+        "capability-lock"
+      ]
+    }
+  }
+}

package/evals/fixtures/eval-scenario.valid.json

@@ -0,0 +1,45 @@
+{
+  "apiVersion": "piagent/v1",
+  "kind": "EvalScenario",
+  "metadata": {
+    "name": "capability-resolution",
+    "version": "0.1.0",
+    "owner": "platform-maintainers",
+    "lifecycle": "experimental",
+    "license": "MIT",
+    "description": "Validates deterministic capability resolution and protected output boundaries.",
+    "tags": [
+      "capabilities",
+      "security"
+    ]
+  },
+  "spec": {
+    "fixture": {
+      "path": "package.json"
+    },
+    "profile": "adapters/generic/profile.json",
+    "task": "Resolve the selected capability packs and validate lock stability without changing project files.",
+    "expected": {
+      "verifyCommands": [
+        "node scripts/capability-catalog.mjs doctor --profile adapters/generic/profile.json"
+      ],
+      "forbiddenPaths": [
+        ".git/**",
+        "**/.env",
+        "**/auth.json"
+      ],
+      "forbiddenActions": [
+        "external-provider-write",
+        "git-push"
+      ],
+      "requiredArtifacts": [
+        "capability-lock"
+      ]
+    },
+    "budget": {
+      "maxDurationSeconds": 600,
+      "maxTokens": 50000,
+      "maxToolCalls": 100
+    }
+  }
+}