@zonease/aiworker-cli 0.12.2 → 0.13.0

package/official-apps/aiworker-qa/migrations/0001_qa.sql

@@ -0,0 +1,2 @@
+-- AIWorker QA app-local migration: qa-initial
+-- App-owned storage is brokered by Host in mounted mode and local in standalone mode.

package/official-apps/aiworker-qa/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@zonease/aiworker-qa",
+  "type": "module",
+  "private": true,
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    }
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "scripts": {
+    "build": "bun build src/index.ts src/standalone.ts src/host-mounted.ts --outdir dist --target bun",
+    "dev": "bun src/standalone.ts --serve",
+    "serve": "bun src/host-mounted.ts",
+    "smoke": "bun ../../apps/cli/src/aiworker.ts app smoke .",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "validate": "bun ../../apps/cli/src/aiworker.ts app validate ."
+  },
+  "dependencies": {
+    "@zonease/aiworker-soul-app-sdk": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.2.13",
+    "@zonease/aiworker-soul-app-runtime": "workspace:*",
+    "typescript": "^5.8.3"
+  }
+}

package/official-apps/aiworker-qa/packs/qa-reviewer/SOUL.md

@@ -0,0 +1,7 @@
+# AIWorker QA Soul Pack
+
+This pack anchors QA work in app-owned domain guidance.
+
+- Stay inside the app workspace.
+- Produce reviewable artifacts.
+- Use Host broker only for shared resources.

package/official-apps/aiworker-qa/review/regression-matrix.md

@@ -0,0 +1,5 @@
+# Regression Matrix Review Policy
+
+- Verify source evidence is explicit.
+- Mark missing facts before promotion.
+- Keep human review notes separate from generated summary.

package/official-apps/aiworker-qa/review/release-gate.md

@@ -0,0 +1,5 @@
+# Release Gate Review Policy
+
+- Verify source evidence is explicit.
+- Mark missing facts before promotion.
+- Keep human review notes separate from generated summary.

package/official-apps/aiworker-qa/schemas/regression-matrix.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "AIWorker QA Regression Matrix",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "title",
+    "summary",
+    "evidence"
+  ],
+  "properties": {
+    "title": {
+      "type": "string"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": [
+          "source",
+          "summary"
+        ],
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "risks": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "nextActions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}

package/official-apps/aiworker-qa/schemas/release-gate.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "AIWorker QA Release Gate",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "title",
+    "summary",
+    "evidence"
+  ],
+  "properties": {
+    "title": {
+      "type": "string"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": [
+          "source",
+          "summary"
+        ],
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "risks": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "nextActions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}

package/official-apps/aiworker-qa/soul-app.manifest.json

@@ -0,0 +1,356 @@
+{
+  "api": {
+    "entry": "./src/api.ts",
+    "localService": {
+      "command": [
+        "bun",
+        "dist/host-mounted.js"
+      ],
+      "healthPath": "/health"
+    },
+    "routePrefix": "/api/local/apps/aiworker-qa"
+  },
+  "artifactTypes": [
+    {
+      "description": "Coverage matrix mapped to release risk.",
+      "id": "regression-matrix",
+      "name": "Regression Matrix",
+      "previewRef": "./src/ui/regression-matrix-preview.tsx",
+      "reviewPolicyRef": "./review/regression-matrix.md",
+      "schemaRef": "./schemas/regression-matrix.schema.json",
+      "schemaSha256": "6a4f3494764431e8785a82865215eabc4c4678dfb4e447eda4d4684f341892a0",
+      "version": "0.1.0"
+    },
+    {
+      "description": "Go/no-go release readiness artifact.",
+      "id": "release-gate",
+      "name": "Release Gate",
+      "previewRef": "./src/ui/release-gate-preview.tsx",
+      "reviewPolicyRef": "./review/release-gate.md",
+      "schemaRef": "./schemas/release-gate.schema.json",
+      "schemaSha256": "0c953a3453ff235c419600073c70c1f155976f448c4567711b511d83668a09e4",
+      "version": "0.1.0"
+    }
+  ],
+  "capabilities": [
+    {
+      "artifactTypes": [
+        "regression-matrix"
+      ],
+      "description": "Build regression coverage from change and test evidence.",
+      "id": "regression-matrix",
+      "name": "Regression Matrix",
+      "outputKind": "regression-matrix",
+      "packRefs": [],
+      "promptRef": "./capabilities/regression-matrix/prompt.md",
+      "reviewRubricRef": "./capabilities/regression-matrix/review.md",
+      "version": "0.1.0",
+      "workspaceTypes": [
+        "release",
+        "test-suite"
+      ]
+    },
+    {
+      "artifactTypes": [
+        "release-gate"
+      ],
+      "description": "Summarize release blockers, residual risk, and go/no-go recommendation.",
+      "id": "release-gate",
+      "name": "Release Gate",
+      "outputKind": "release-gate",
+      "packRefs": [],
+      "promptRef": "./capabilities/release-gate/prompt.md",
+      "reviewRubricRef": "./capabilities/release-gate/review.md",
+      "version": "0.1.0",
+      "workspaceTypes": [
+        "release"
+      ]
+    }
+  ],
+  "compatibility": {
+    "host": {
+      "minVersion": "0.12.0"
+    },
+    "sdk": {
+      "minVersion": "0.1.0"
+    }
+  },
+  "connectors": {
+    "optional": [
+      {
+        "access": [
+          "read"
+        ],
+        "id": "issue-tracker",
+        "reason": "Read defect evidence through Host connector broker.",
+        "scopes": [
+          "issues.read"
+        ]
+      }
+    ],
+    "required": [
+      {
+        "access": [
+          "read"
+        ],
+        "id": "ci",
+        "reason": "Read CI and test evidence through Host connector broker.",
+        "scopes": [
+          "runs.read",
+          "artifacts.read"
+        ]
+      }
+    ]
+  },
+  "description": "Quality Soul App for release workspaces, regression evidence, defect triage, and release gate review.",
+  "exports": {
+    "artifact": "./src/protocol/artifact.ts",
+    "connector": "./src/protocol/connectors.ts",
+    "lifecycle": "./src/protocol/lifecycle.ts",
+    "review": "./src/protocol/review.ts",
+    "runtime": "./src/protocol/runtime.ts",
+    "ui": "./src/protocol/ui.ts"
+  },
+  "healthcheck": {
+    "kind": "protocol-handler",
+    "ref": "healthcheck",
+    "timeoutMs": 5000
+  },
+  "id": "aiworker-qa",
+  "memory": {
+    "admissionPolicy": "manual-review",
+    "namespace": "aiworker-qa"
+  },
+  "modes": {
+    "hostMounted": {
+      "entry": "./dist/host-mounted.js",
+      "supported": true
+    },
+    "standalone": {
+      "entry": "./dist/standalone.js",
+      "supported": true
+    }
+  },
+  "name": "AIWorker QA",
+  "pack": {
+    "refs": [
+      {
+        "id": "qa-reviewer",
+        "ref": "packs/qa-reviewer/SOUL.md",
+        "source": "embedded",
+        "version": "0.1.0"
+      }
+    ]
+  },
+  "permissions": [
+    {
+      "action": "read",
+      "kind": "storage",
+      "reason": "Read app-scoped QA domain metadata.",
+      "target": "aiworker-qa"
+    },
+    {
+      "action": "write",
+      "kind": "storage",
+      "reason": "Write app-scoped QA domain metadata.",
+      "target": "aiworker-qa"
+    },
+    {
+      "action": "read",
+      "kind": "search",
+      "reason": "Read app-owned QA search descriptors.",
+      "target": "aiworker-qa"
+    },
+    {
+      "action": "write",
+      "kind": "search",
+      "reason": "Publish app-owned QA search descriptors.",
+      "target": "aiworker-qa"
+    },
+    {
+      "action": "read",
+      "kind": "connector",
+      "reason": "Read CI evidence through Host connector broker.",
+      "target": "ci"
+    },
+    {
+      "action": "write",
+      "kind": "artifact",
+      "reason": "Create reviewable QA release artifacts.",
+      "target": "release-gate"
+    },
+    {
+      "action": "create",
+      "kind": "review",
+      "reason": "Create QA review rubrics and findings.",
+      "target": "qa-review"
+    },
+    {
+      "action": "propose",
+      "kind": "memory",
+      "reason": "Propose reviewed QA lessons into the app namespace.",
+      "target": "aiworker-qa"
+    },
+    {
+      "action": "mount",
+      "kind": "ui",
+      "reason": "Mount QA workbench contributions.",
+      "target": "qa-workbench"
+    },
+    {
+      "action": "serve",
+      "kind": "api",
+      "reason": "Serve QA scoped API routes.",
+      "target": "/api/local/apps/aiworker-qa"
+    }
+  ],
+  "protocol": "soul-app/v1",
+  "soul": {
+    "description": "QA Soul for release evidence, regression coverage, defect triage, and release readiness review.",
+    "domain": "quality-assurance",
+    "id": "qa",
+    "name": "QA",
+    "version": "0.1.0"
+  },
+  "storage": {
+    "migrations": [
+      {
+        "id": "qa-initial",
+        "path": "./migrations/0001_qa.sql"
+      }
+    ],
+    "namespace": "aiworker-qa"
+  },
+  "ui": {
+    "artifactPreviews": [
+      {
+        "entry": "./src/ui/release-gate-preview.tsx",
+        "id": "release-gate-preview",
+        "label": "Release gate preview",
+        "slot": "artifact-preview",
+        "target": "release-gate"
+      }
+    ],
+    "panels": [
+      {
+        "entry": "./src/ui/release-panel.tsx",
+        "id": "qa-release-panel",
+        "label": "Release panel",
+        "slot": "panel",
+        "surface": {
+          "entry": "/surfaces/panels/qa-release-panel",
+          "renderer": "host-descriptor",
+          "requiredPermissions": [
+            "storage:read:aiworker-qa"
+          ],
+          "scope": "workspace"
+        }
+      }
+    ],
+    "reviewPanels": [
+      {
+        "entry": "./src/ui/review-panel.tsx",
+        "id": "qa-review-panel",
+        "label": "QA review panel",
+        "slot": "review-panel"
+      }
+    ],
+    "routes": [
+      {
+        "entry": "./src/ui/qa-route.tsx",
+        "id": "qa-home",
+        "label": "QA",
+        "path": "/qa",
+        "surface": {
+          "entry": "/surfaces/routes/qa-home",
+          "renderer": "host-descriptor",
+          "requiredPermissions": [
+            "ui:mount:qa-workbench"
+          ],
+          "scope": "app"
+        }
+      }
+    ],
+    "shell": {
+      "actions": [
+        {
+          "id": "refresh-release",
+          "label": "Refresh",
+          "protocolAction": "release.refresh",
+          "requiredPermissions": [
+            "storage:read:aiworker-qa"
+          ],
+          "slot": "refresh"
+        }
+      ],
+      "primaryAction": {
+        "id": "create-release-gate",
+        "label": "New release gate",
+        "protocolAction": "releaseGates.create",
+        "requiredPermissions": [
+          "storage:write:aiworker-qa",
+          "search:write:aiworker-qa"
+        ],
+        "slot": "primary"
+      },
+      "search": {
+        "id": "release-search",
+        "label": "Search releases",
+        "placeholder": "Search releases",
+        "protocolProvider": "releases.search",
+        "requiredPermissions": [
+          "search:read:aiworker-qa"
+        ]
+      },
+      "settings": {
+        "id": "qa-settings",
+        "label": "QA settings",
+        "protocolAction": "settings.open",
+        "requiredPermissions": [
+          "api:serve:/api/local/apps/aiworker-qa"
+        ]
+      }
+    },
+    "workspaceWidgets": [
+      {
+        "entry": "./src/ui/release-widget.tsx",
+        "id": "qa-release-widget",
+        "label": "Release widget",
+        "slot": "workspace-widget",
+        "surface": {
+          "entry": "/frames/widgets/qa-release-widget",
+          "renderer": "sandboxed-frame",
+          "scope": "workspace"
+        },
+        "target": "release"
+      }
+    ]
+  },
+  "version": "0.1.0",
+  "workspaceTypes": [
+    {
+      "artifactTypes": [
+        "regression-matrix",
+        "release-gate"
+      ],
+      "defaultCapabilityIds": [
+        "regression-matrix",
+        "release-gate"
+      ],
+      "description": "Release readiness workspace with test and defect evidence.",
+      "id": "release",
+      "name": "Release"
+    },
+    {
+      "artifactTypes": [
+        "regression-matrix"
+      ],
+      "defaultCapabilityIds": [
+        "regression-matrix"
+      ],
+      "description": "Focused test suite coverage workspace.",
+      "id": "test-suite",
+      "name": "Test Suite"
+    }
+  ]
+}

package/official-apps/aiworker-qa/src/api.ts

@@ -0,0 +1 @@
+export { qaReferenceSoulApp as soulApp } from './index'