@kb-labs/qa-entry 2.109.0 → 2.111.0

package/dist/manifest.json

@@ -31,6 +31,14 @@
       {
         "path": "qa baseline",
         "describe": "Baseline management"
+      },
+      {
+        "path": "qa ci",
+        "describe": "CI evidence and reliability analysis"
+      },
+      {
+        "path": "qa ci evidence",
+        "describe": "Immutable CI evidence capture"
       }
     ],
     "commands": [
@@ -83,7 +91,8 @@
           "shell": {
             "allow": [
               "kb-devkit",
-              "git"
+              "git",
+              "gh"
             ]
           },
           "platform": {
@@ -139,7 +148,8 @@
           "shell": {
             "allow": [
               "kb-devkit",
-              "git"
+              "git",
+              "gh"
             ]
           },
           "platform": {
@@ -195,7 +205,8 @@
           "shell": {
             "allow": [
               "kb-devkit",
-              "git"
+              "git",
+              "gh"
             ]
           },
           "platform": {
@@ -251,7 +262,8 @@
           "shell": {
             "allow": [
               "kb-devkit",
-              "git"
+              "git",
+              "gh"
             ]
           },
           "platform": {
@@ -307,7 +319,8 @@
           "shell": {
             "allow": [
               "kb-devkit",
-              "git"
+              "git",
+              "gh"
             ]
           },
           "platform": {
@@ -363,7 +376,8 @@
           "shell": {
             "allow": [
               "kb-devkit",
-              "git"
+              "git",
+              "gh"
             ]
           },
           "platform": {
@@ -441,7 +455,216 @@
           "shell": {
             "allow": [
               "kb-devkit",
-              "git"
+              "git",
+              "gh"
+            ]
+          },
+          "platform": {
+            "analytics": true
+          },
+          "quotas": {
+            "timeoutMs": 600000,
+            "memoryMb": 512
+          }
+        }
+      },
+      {
+        "path": "qa ci evidence capture",
+        "category": "CI",
+        "describe": "Capture a GitHub Actions run dossier (CI producer command)",
+        "operationType": "execute",
+        "handler": "./cli/commands/qa-ci-evidence-capture.js#default",
+        "flags": [
+          {
+            "name": "runId",
+            "type": "string",
+            "description": "GitHub Actions run ID (defaults to GITHUB_RUN_ID)"
+          },
+          {
+            "name": "repository",
+            "type": "string",
+            "description": "GitHub repository in owner/name form (defaults to GITHUB_REPOSITORY)"
+          },
+          {
+            "name": "output",
+            "type": "string",
+            "default": ".kb/qa/ci/dossier.json",
+            "description": "Path for the immutable dossier JSON"
+          },
+          {
+            "name": "excludeJob",
+            "type": "string",
+            "description": "Comma-separated job names to exclude from evidence (for example, the collector job itself)"
+          },
+          {
+            "name": "json",
+            "type": "boolean",
+            "default": false,
+            "description": "Output the captured dossier as JSON"
+          }
+        ],
+        "permissions": {
+          "fs": {
+            "read": [
+              ".kb/**",
+              "**"
+            ],
+            "write": [
+              ".kb/**",
+              "**"
+            ]
+          },
+          "env": {
+            "read": [
+              "HOME",
+              "USER",
+              "PATH",
+              "TMPDIR",
+              "NODE_ENV",
+              "KB_*"
+            ]
+          },
+          "shell": {
+            "allow": [
+              "kb-devkit",
+              "git",
+              "gh"
+            ]
+          },
+          "platform": {
+            "analytics": true
+          },
+          "quotas": {
+            "timeoutMs": 600000,
+            "memoryMb": 512
+          }
+        }
+      },
+      {
+        "path": "qa ci evidence sync",
+        "category": "CI",
+        "describe": "Download new CI evidence artifacts into a local cache",
+        "operationType": "execute",
+        "handler": "./cli/commands/qa-ci-evidence-sync.js#default",
+        "flags": [
+          {
+            "name": "repository",
+            "type": "string",
+            "description": "GitHub repository in owner/name form (defaults to config or GITHUB_REPOSITORY)"
+          },
+          {
+            "name": "workflow",
+            "type": "string",
+            "default": "e2e-platform.yml",
+            "description": "GitHub Actions workflow file or name"
+          },
+          {
+            "name": "limit",
+            "type": "number",
+            "default": 50,
+            "description": "Recent workflow runs to inspect for evidence artifacts"
+          },
+          {
+            "name": "output",
+            "type": "string",
+            "default": ".kb/qa/ci/evidence",
+            "description": "Local evidence cache directory"
+          },
+          {
+            "name": "json",
+            "type": "boolean",
+            "default": false,
+            "description": "Output sync details as JSON"
+          }
+        ],
+        "permissions": {
+          "fs": {
+            "read": [
+              ".kb/**",
+              "**"
+            ],
+            "write": [
+              ".kb/**",
+              "**"
+            ]
+          },
+          "env": {
+            "read": [
+              "HOME",
+              "USER",
+              "PATH",
+              "TMPDIR",
+              "NODE_ENV",
+              "KB_*"
+            ]
+          },
+          "shell": {
+            "allow": [
+              "kb-devkit",
+              "git",
+              "gh"
+            ]
+          },
+          "platform": {
+            "analytics": true
+          },
+          "quotas": {
+            "timeoutMs": 600000,
+            "memoryMb": 512
+          }
+        }
+      },
+      {
+        "path": "qa ci overview",
+        "category": "CI",
+        "describe": "Show a compact CI reliability overview",
+        "operationType": "read",
+        "handler": "./cli/commands/qa-ci-overview.js#default",
+        "flags": [
+          {
+            "name": "input",
+            "type": "string",
+            "default": ".kb/qa/ci",
+            "description": "Dossier JSON file or directory containing dossier.json files"
+          },
+          {
+            "name": "output",
+            "type": "string",
+            "description": "Optional file to receive the compact agent-ready JSON overview"
+          },
+          {
+            "name": "json",
+            "type": "boolean",
+            "default": false,
+            "description": "Output the agent-ready reliability overview as JSON"
+          }
+        ],
+        "permissions": {
+          "fs": {
+            "read": [
+              ".kb/**",
+              "**"
+            ],
+            "write": [
+              ".kb/**",
+              "**"
+            ]
+          },
+          "env": {
+            "read": [
+              "HOME",
+              "USER",
+              "PATH",
+              "TMPDIR",
+              "NODE_ENV",
+              "KB_*"
+            ]
+          },
+          "shell": {
+            "allow": [
+              "kb-devkit",
+              "git",
+              "gh"
             ]
           },
           "platform": {
@@ -491,7 +714,8 @@
           "shell": {
             "allow": [
               "kb-devkit",
-              "git"
+              "git",
+              "gh"
             ]
           },
           "platform": {
@@ -541,7 +765,8 @@
           "shell": {
             "allow": [
               "kb-devkit",
-              "git"
+              "git",
+              "gh"
             ]
           },
           "platform": {
@@ -591,7 +816,8 @@
           "shell": {
             "allow": [
               "kb-devkit",
-              "git"
+              "git",
+              "gh"
             ]
           },
           "platform": {
@@ -641,7 +867,8 @@
           "shell": {
             "allow": [
               "kb-devkit",
-              "git"
+              "git",
+              "gh"
             ]
           },
           "platform": {
@@ -722,6 +949,11 @@
         "method": "GET",
         "path": "/tasks",
         "handler": "./rest/handlers/tasks-handler.js#default"
+      },
+      {
+        "method": "GET",
+        "path": "/ci/overview",
+        "handler": "./rest/handlers/ci-overview-handler.js#default"
       }
     ]
   },
@@ -772,7 +1004,8 @@
     "shell": {
       "allow": [
         "kb-devkit",
-        "git"
+        "git",
+        "gh"
       ]
     },
     "platform": {

package/dist/rest/handlers/ci-overview-handler.d.ts

@@ -0,0 +1,7 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import * as _kb_labs_qa_contracts from '@kb-labs/qa-contracts';
+
+/** Read-only agent surface. It intentionally returns findings, not raw GitHub logs. */
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, unknown, _kb_labs_qa_contracts.CiReliabilityOverview>;
+
+export { _default as default };

package/dist/rest/handlers/ci-overview-handler.js

@@ -0,0 +1,19 @@
+import { join } from 'path';
+import { defineHandler, rethrowForRest } from '@kb-labs/sdk';
+import { analyzeCiReliability, loadCiDossiers } from '@kb-labs/qa-core';
+
+// src/rest/handlers/ci-overview-handler.ts
+var ci_overview_handler_default = defineHandler({
+  async execute(ctx) {
+    try {
+      const cwd = ctx.cwd ?? process.cwd();
+      return analyzeCiReliability(loadCiDossiers(join(cwd, ".kb/qa/ci/evidence")));
+    } catch (error) {
+      rethrowForRest(error);
+    }
+  }
+});
+
+export { ci_overview_handler_default as default };
+//# sourceMappingURL=ci-overview-handler.js.map
+//# sourceMappingURL=ci-overview-handler.js.map

package/dist/rest/handlers/ci-overview-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/ci-overview-handler.ts"],"names":[],"mappings":";;;;;AAKA,IAAO,8BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,QAAQ,GAAA,EAAsB;AAClC,IAAA,IAAI;AACF,MAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AACnC,MAAA,OAAO,qBAAqB,cAAA,CAAe,IAAA,CAAK,GAAA,EAAK,oBAAoB,CAAC,CAAC,CAAA;AAAA,IAC7E,SAAS,KAAA,EAAO;AACd,MAAA,cAAA,CAAe,KAAK,CAAA;AAAA,IACtB;AAAA,EACF;AACF,CAAC","file":"ci-overview-handler.js","sourcesContent":["import { join } from 'node:path';\nimport { defineHandler, rethrowForRest, type PluginContextV3 } from '@kb-labs/sdk';\nimport { analyzeCiReliability, loadCiDossiers } from '@kb-labs/qa-core';\n\n/** Read-only agent surface. It intentionally returns findings, not raw GitHub logs. */\nexport default defineHandler({\n  async execute(ctx: PluginContextV3) {\n    try {\n      const cwd = ctx.cwd ?? process.cwd();\n      return analyzeCiReliability(loadCiDossiers(join(cwd, '.kb/qa/ci/evidence')));\n    } catch (error) {\n      rethrowForRest(error);\n    }\n  },\n});\n"]}