@kb-labs/qa-entry 2.94.0 → 2.98.0

package/dist/cli/commands/flags.js

@@ -1,125 +1,111 @@
+import { defineFlags } from '@kb-labs/sdk';
+
 // src/cli/commands/flags.ts
-var JSON_FLAG_DESCRIPTION = "Output JSON format";
-var qaRunFlags = {
-  json: {
-    type: "boolean",
-    description: JSON_FLAG_DESCRIPTION,
-    default: false
-  },
-  "skip-check": {
-    type: "array",
-    description: "Skip specific check IDs (e.g. --skip-check build --skip-check lint)"
+var qaRunFlags = defineFlags({
+  tasks: {
+    type: "string",
+    description: "Comma-separated tasks to run (default: build,lint,type-check,test)"
   },
-  "no-cache": {
+  save: {
     type: "boolean",
-    description: "Disable caching (force full run)",
-    default: false
+    description: "Save snapshot to history",
+    default: true
   },
-  all: {
+  json: {
     type: "boolean",
-    description: "Run all packages, ignoring affected analysis",
+    description: "Output JSON",
     default: false
+  }
+});
+var qaCheckFlags = defineFlags({
+  save: {
+    type: "boolean",
+    description: "Save snapshot to history",
+    default: true
   },
-  package: {
-    type: "string",
-    description: "Filter by package name",
-    alias: "p"
-  },
-  repo: {
-    type: "string",
-    description: "Filter by repo name",
-    alias: "r"
-  },
-  scope: {
-    type: "string",
-    description: "Filter by npm scope",
-    alias: "s"
-  },
-  summary: {
+  json: {
     type: "boolean",
-    description: "Show summary-only report (legacy flat format)",
+    description: "Output JSON",
     default: false
   }
-};
-var qaSaveFlags = {
+});
+var qaStatsFlags = defineFlags({
+  save: {
+    type: "boolean",
+    description: "Save snapshot to history",
+    default: true
+  },
   json: {
     type: "boolean",
-    description: JSON_FLAG_DESCRIPTION,
+    description: "Output JSON",
     default: false
   }
-};
-var qaHistoryFlags = {
-  json: {
+});
+var qaGateFlags = defineFlags({
+  save: {
     type: "boolean",
-    description: JSON_FLAG_DESCRIPTION,
+    description: "Save snapshot to history",
     default: false
   },
+  json: {
+    type: "boolean",
+    description: "Output JSON",
+    default: false
+  }
+});
+var qaHistoryFlags = defineFlags({
   limit: {
     type: "number",
-    description: "Number of entries to show",
+    description: "Max entries to show",
     default: 20
-  }
-};
-var qaTrendsFlags = {
+  },
   json: {
     type: "boolean",
-    description: JSON_FLAG_DESCRIPTION,
+    description: "Output JSON",
     default: false
-  },
+  }
+});
+var qaTrendsFlags = defineFlags({
   window: {
     type: "number",
-    description: "Number of entries for trend window",
+    description: "Number of history entries to analyze",
     default: 10
-  }
-};
-var qaRegressionsFlags = {
+  },
   json: {
     type: "boolean",
-    description: JSON_FLAG_DESCRIPTION,
+    description: "Output JSON",
     default: false
   }
-};
-var baselineUpdateFlags = {
+});
+var qaRegressionsFlags = defineFlags({
   json: {
     type: "boolean",
-    description: JSON_FLAG_DESCRIPTION,
+    description: "Output JSON",
     default: false
   }
-};
-var baselineStatusFlags = {
+});
+var baselineUpdateFlags = defineFlags({
   json: {
     type: "boolean",
-    description: JSON_FLAG_DESCRIPTION,
+    description: "Output JSON",
     default: false
   }
-};
-var qaCheckFlags = {
-  id: {
-    type: "string",
-    description: "Check ID to run (must match a check in qa.checks config)",
-    demandOption: true
-  },
-  base: {
-    type: "string",
-    description: "Base branch/commit for diff strategies (diffOnly, newFiles). Default: main",
-    default: "main"
-  },
-  context: {
-    type: "string",
-    description: 'JSON context to attach to history entry (e.g. {"taskId":"123"})'
-  },
+});
+var baselineStatusFlags = defineFlags({
   json: {
     type: "boolean",
-    description: JSON_FLAG_DESCRIPTION,
+    description: "Output JSON",
     default: false
-  },
-  save: {
+  }
+});
+var baselineDiffFlags = defineFlags({
+  json: {
     type: "boolean",
-    description: "Save result to history after running (default: true)",
-    default: true
+    description: "Output JSON",
+    default: false
   }
-};
+});
 
-export { baselineStatusFlags, baselineUpdateFlags, qaCheckFlags, qaHistoryFlags, qaRegressionsFlags, qaRunFlags, qaSaveFlags, qaTrendsFlags };
+export { baselineDiffFlags, baselineStatusFlags, baselineUpdateFlags, qaCheckFlags, qaGateFlags, qaHistoryFlags, qaRegressionsFlags, qaRunFlags, qaStatsFlags, qaTrendsFlags };
 //# sourceMappingURL=flags.js.map
 //# sourceMappingURL=flags.js.map

package/dist/cli/commands/flags.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/cli/commands/flags.ts"],"names":[],"mappings":"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","file":"flags.js","sourcesContent":["/**\n * QA Plugin CLI flag definitions.\n * DRY: Define once, use in manifest and command handlers.\n */\n\nconst JSON_FLAG_DESCRIPTION = 'Output JSON format';\n\nexport const qaRunFlags = {\n  json: {\n    type: 'boolean',\n    description: JSON_FLAG_DESCRIPTION,\n    default: false,\n  },\n  'skip-check': {\n    type: 'array',\n    description: 'Skip specific check IDs (e.g. --skip-check build --skip-check lint)',\n  },\n  'no-cache': {\n    type: 'boolean',\n    description: 'Disable caching (force full run)',\n    default: false,\n  },\n  all: {\n    type: 'boolean',\n    description: 'Run all packages, ignoring affected analysis',\n    default: false,\n  },\n  package: {\n    type: 'string',\n    description: 'Filter by package name',\n    alias: 'p',\n  },\n  repo: {\n    type: 'string',\n    description: 'Filter by repo name',\n    alias: 'r',\n  },\n  scope: {\n    type: 'string',\n    description: 'Filter by npm scope',\n    alias: 's',\n  },\n  summary: {\n    type: 'boolean',\n    description: 'Show summary-only report (legacy flat format)',\n    default: false,\n  },\n} as const;\n\nexport type QARunFlags = typeof qaRunFlags;\n\nexport const qaSaveFlags = {\n  json: {\n    type: 'boolean',\n    description: JSON_FLAG_DESCRIPTION,\n    default: false,\n  },\n} as const;\n\nexport type QASaveFlags = typeof qaSaveFlags;\n\nexport const qaHistoryFlags = {\n  json: {\n    type: 'boolean',\n    description: JSON_FLAG_DESCRIPTION,\n    default: false,\n  },\n  limit: {\n    type: 'number',\n    description: 'Number of entries to show',\n    default: 20,\n  },\n} as const;\n\nexport type QAHistoryFlags = typeof qaHistoryFlags;\n\nexport const qaTrendsFlags = {\n  json: {\n    type: 'boolean',\n    description: JSON_FLAG_DESCRIPTION,\n    default: false,\n  },\n  window: {\n    type: 'number',\n    description: 'Number of entries for trend window',\n    default: 10,\n  },\n} as const;\n\nexport type QATrendsFlags = typeof qaTrendsFlags;\n\nexport const qaRegressionsFlags = {\n  json: {\n    type: 'boolean',\n    description: JSON_FLAG_DESCRIPTION,\n    default: false,\n  },\n} as const;\n\nexport type QARegressionsFlags = typeof qaRegressionsFlags;\n\nexport const baselineUpdateFlags = {\n  json: {\n    type: 'boolean',\n    description: JSON_FLAG_DESCRIPTION,\n    default: false,\n  },\n} as const;\n\nexport type BaselineUpdateFlags = typeof baselineUpdateFlags;\n\nexport const baselineStatusFlags = {\n  json: {\n    type: 'boolean',\n    description: JSON_FLAG_DESCRIPTION,\n    default: false,\n  },\n} as const;\n\nexport type BaselineStatusFlags = typeof baselineStatusFlags;\n\nexport const qaCheckFlags = {\n  id: {\n    type: 'string',\n    description: 'Check ID to run (must match a check in qa.checks config)',\n    demandOption: true,\n  },\n  base: {\n    type: 'string',\n    description: 'Base branch/commit for diff strategies (diffOnly, newFiles). Default: main',\n    default: 'main',\n  },\n  context: {\n    type: 'string',\n    description: 'JSON context to attach to history entry (e.g. {\"taskId\":\"123\"})',\n  },\n  json: {\n    type: 'boolean',\n    description: JSON_FLAG_DESCRIPTION,\n    default: false,\n  },\n  save: {\n    type: 'boolean',\n    description: 'Save result to history after running (default: true)',\n    default: true,\n  },\n} as const;\n\nexport type QACheckFlags = typeof qaCheckFlags;\n"]}
+{"version":3,"sources":["../../../src/cli/commands/flags.ts"],"names":[],"mappings":"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","file":"flags.js","sourcesContent":["import { defineFlags } from '@kb-labs/sdk';\n\nexport const qaRunFlags = defineFlags({\n  tasks: {\n    type: 'string',\n    description: 'Comma-separated tasks to run (default: build,lint,type-check,test)',\n  },\n  save: {\n    type: 'boolean',\n    description: 'Save snapshot to history',\n    default: true,\n  },\n  json: {\n    type: 'boolean',\n    description: 'Output JSON',\n    default: false,\n  },\n});\nexport type QaRunFlags = typeof qaRunFlags.infer;\n\nexport const qaCheckFlags = defineFlags({\n  save: {\n    type: 'boolean',\n    description: 'Save snapshot to history',\n    default: true,\n  },\n  json: {\n    type: 'boolean',\n    description: 'Output JSON',\n    default: false,\n  },\n});\nexport type QaCheckFlags = typeof qaCheckFlags.infer;\n\nexport const qaStatsFlags = defineFlags({\n  save: {\n    type: 'boolean',\n    description: 'Save snapshot to history',\n    default: true,\n  },\n  json: {\n    type: 'boolean',\n    description: 'Output JSON',\n    default: false,\n  },\n});\nexport type QaStatsFlags = typeof qaStatsFlags.infer;\n\nexport const qaGateFlags = defineFlags({\n  save: {\n    type: 'boolean',\n    description: 'Save snapshot to history',\n    default: false,\n  },\n  json: {\n    type: 'boolean',\n    description: 'Output JSON',\n    default: false,\n  },\n});\nexport type QaGateFlags = typeof qaGateFlags.infer;\n\nexport const qaHistoryFlags = defineFlags({\n  limit: {\n    type: 'number',\n    description: 'Max entries to show',\n    default: 20,\n  },\n  json: {\n    type: 'boolean',\n    description: 'Output JSON',\n    default: false,\n  },\n});\nexport type QaHistoryFlags = typeof qaHistoryFlags.infer;\n\nexport const qaTrendsFlags = defineFlags({\n  window: {\n    type: 'number',\n    description: 'Number of history entries to analyze',\n    default: 10,\n  },\n  json: {\n    type: 'boolean',\n    description: 'Output JSON',\n    default: false,\n  },\n});\nexport type QaTrendsFlags = typeof qaTrendsFlags.infer;\n\nexport const qaRegressionsFlags = defineFlags({\n  json: {\n    type: 'boolean',\n    description: 'Output JSON',\n    default: false,\n  },\n});\nexport type QaRegressionsFlags = typeof qaRegressionsFlags.infer;\n\nexport const baselineUpdateFlags = defineFlags({\n  json: {\n    type: 'boolean',\n    description: 'Output JSON',\n    default: false,\n  },\n});\nexport type BaselineUpdateFlags = typeof baselineUpdateFlags.infer;\n\nexport const baselineStatusFlags = defineFlags({\n  json: {\n    type: 'boolean',\n    description: 'Output JSON',\n    default: false,\n  },\n});\nexport type BaselineStatusFlags = typeof baselineStatusFlags.infer;\n\nexport const baselineDiffFlags = defineFlags({\n  json: {\n    type: 'boolean',\n    description: 'Output JSON',\n    default: false,\n  },\n});\nexport type BaselineDiffFlags = typeof baselineDiffFlags.infer;\n"]}

package/dist/cli/commands/qa-check.d.ts

@@ -1,40 +1,19 @@
 import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
 import { CLIInput } from '@kb-labs/sdk';
 
-interface QACheckFlags {
-    id: string;
-    base?: string;
-    context?: string;
-    json?: boolean;
-    save?: boolean;
-}
-declare const qaCheckFlags: {
-    readonly id: {
-        readonly type: "string";
-        readonly description: "Check ID to run (must match a check in qa.checks config)";
-        readonly demandOption: true;
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<_kb_labs_shared_command_kit.InferFlags<{
+    save: {
+        type: "boolean";
+        description: string;
+        default: true;
     };
-    readonly base: {
-        readonly type: "string";
-        readonly description: "Base branch/commit for diff strategies (diffOnly, newFiles). Default: main";
-        readonly default: "main";
+    json: {
+        type: "boolean";
+        description: string;
+        default: false;
     };
-    readonly context: {
-        readonly type: "string";
-        readonly description: "JSON context to attach to the history entry (e.g. {\"taskId\":\"123\",\"agentId\":\"claude\"})";
-    };
-    readonly json: {
-        readonly type: "boolean";
-        readonly description: "Output structured JSON report";
-        readonly default: false;
-    };
-    readonly save: {
-        readonly type: "boolean";
-        readonly description: "Save result to history after running";
-        readonly default: true;
-    };
-};
-type QACheckFlagsType = typeof qaCheckFlags;
-declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<QACheckFlags>, unknown>;
+}>>, {
+    exitCode: number;
+}>;
 
-export { type QACheckFlagsType, _default as default, qaCheckFlags };
+export { _default as default };

package/dist/cli/commands/qa-check.js

@@ -1,123 +1,43 @@
 import { defineCommand, useConfig } from '@kb-labs/sdk';
-import { getWorkspacePackages, runCustomChecks, createHistoryEntry, appendEntry, buildJsonReport } from '@kb-labs/qa-core';
+import { resolveDevkitBin, DevkitAdapter, SnapshotStore, captureGit, buildCheckJsonReport, buildCheckReport } from '@kb-labs/qa-core';
 
 // src/cli/commands/qa-check.ts
-var qaCheckFlags = {
-  id: {
-    type: "string",
-    description: "Check ID to run (must match a check in qa.checks config)",
-    demandOption: true
-  },
-  base: {
-    type: "string",
-    description: "Base branch/commit for diff strategies (diffOnly, newFiles). Default: main",
-    default: "main"
-  },
-  context: {
-    type: "string",
-    description: 'JSON context to attach to the history entry (e.g. {"taskId":"123","agentId":"claude"})'
-  },
-  json: {
-    type: "boolean",
-    description: "Output structured JSON report",
-    default: false
-  },
-  save: {
-    type: "boolean",
-    description: "Save result to history after running",
-    default: true
-  }
-};
 var qa_check_default = defineCommand({
   id: "qa:check",
-  description: "Run a single QA check atomically and optionally save to history",
+  description: "Run devkit structural checks",
   handler: {
     async execute(ctx, input) {
-      const { ui } = ctx;
       const { flags } = input;
-      const rootDir = ctx.cwd;
-      const checkId = flags.id;
-      const base = flags.base ?? "main";
-      const isJson = !!flags.json;
-      const shouldSave = flags.save !== false;
-      let config;
-      try {
-        config = await Promise.race([
-          useConfig(),
-          new Promise((resolve) => {
-            setTimeout(() => resolve(void 0), 3e3);
-          })
-        ]);
-      } catch {
-      }
-      const allChecks = config?.checks ?? [];
-      const checkConfig = allChecks.find((c) => c.id === checkId);
-      if (!checkConfig) {
-        const msg = `Check "${checkId}" not found in qa.checks config`;
-        if (isJson) {
-          ui?.json?.({ status: "error", message: msg });
-        } else {
-          ui?.error?.(msg, { title: "QA Check Error" });
-        }
-        return { exitCode: 1 };
-      }
-      let runContext;
-      if (flags.context) {
-        try {
-          runContext = JSON.parse(flags.context);
-        } catch {
-          const msg = `Invalid JSON in --context: ${flags.context}`;
-          if (isJson) {
-            ui?.json?.({ status: "error", message: msg });
-          } else {
-            ui?.error?.(msg, { title: "QA Check Error" });
-          }
-          return { exitCode: 1 };
-        }
-      }
-      const packages = getWorkspacePackages(rootDir, {}, config?.packages);
-      const results = runCustomChecks(
-        [checkConfig],
-        packages,
-        rootDir,
-        void 0,
-        base
-      );
-      const checkResult = results[checkId];
-      const hasFailed = checkResult ? checkResult.failed.length > 0 : false;
-      if (shouldSave) {
-        const entry = createHistoryEntry(results, rootDir, packages, runContext);
-        appendEntry(rootDir, entry, allChecks);
-      }
-      const severity = checkConfig.severity ?? "blocker";
-      const report = buildJsonReport(results, null, [checkConfig]);
-      if (isJson) {
-        ui?.json?.(report);
+      const config = await useConfig();
+      const cwd = ctx.cwd ?? process.cwd();
+      const binaryPath = resolveDevkitBin(cwd, config?.devkitPath);
+      const adapter = new DevkitAdapter({ binaryPath, cwd, shell: ctx.api.shell });
+      const store = new SnapshotStore(cwd, config?.historyMaxEntries);
+      const save = flags.save !== false;
+      const git = await captureGit(ctx.api.shell, cwd);
+      const start = Date.now();
+      const raw = await adapter.check();
+      const durationMs = Date.now() - start;
+      const snap = save ? store.saveCheck(raw, durationMs, git) : null;
+      const effective = snap ?? {
+        kind: "check",
+        id: "",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        durationMs,
+        raw
+      };
+      if (flags.json) {
+        ctx.ui?.json?.(buildCheckJsonReport(effective));
       } else {
-        if (hasFailed) {
-          const findings = severity === "warning" ? report.warnings : report.blockers;
-          const checkFindings = findings.find((f) => f.check === checkId);
-          if (checkFindings) {
-            ui?.error?.(`Check "${checkId}" failed`, {
-              title: `${severity === "warning" ? "\u26A0" : "\u2717"} ${checkId}`,
-              sections: [{
-                header: "",
-                items: checkFindings.items.map(
-                  (item) => `  ${item.target}: ${item.message}${item.fix ? ` \u2192 ${item.fix}` : ""}`
-                )
-              }]
-            });
-          }
-        } else {
-          ui?.success?.(`Check "${checkId}" passed`, { title: `\u2713 ${checkId}` });
+        for (const section of buildCheckReport(effective)) {
+          ctx.ui?.success?.(`${section.header}`, { sections: [{ items: section.lines }] });
         }
       }
-      const shouldFail = hasFailed && severity === "blocker";
-      return { exitCode: shouldFail ? 1 : 0 };
+      return { exitCode: raw.ok ? 0 : 1 };
     }
   }
 });
 
-export { qa_check_default as default, qaCheckFlags };
+export { qa_check_default as default };
 //# sourceMappingURL=qa-check.js.map
 //# sourceMappingURL=qa-check.js.map

package/dist/cli/commands/qa-check.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/cli/commands/qa-check.ts"],"names":[],"mappings":"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","file":"qa-check.js","sourcesContent":["import { defineCommand, type CLIInput, useConfig, type PluginContextV3 } from '@kb-labs/sdk';\nimport type { QAPluginConfig, QACheckConfig } from '@kb-labs/qa-contracts';\nimport {\n  getWorkspacePackages,\n  runCustomChecks,\n  createHistoryEntry,\n  appendEntry,\n  buildJsonReport,\n} from '@kb-labs/qa-core';\n\ninterface QACheckFlags {\n  id: string;\n  base?: string;\n  context?: string;\n  json?: boolean;\n  save?: boolean;\n}\n\nexport const qaCheckFlags = {\n  id: {\n    type: 'string',\n    description: 'Check ID to run (must match a check in qa.checks config)',\n    demandOption: true,\n  },\n  base: {\n    type: 'string',\n    description: 'Base branch/commit for diff strategies (diffOnly, newFiles). Default: main',\n    default: 'main',\n  },\n  context: {\n    type: 'string',\n    description: 'JSON context to attach to the history entry (e.g. {\"taskId\":\"123\",\"agentId\":\"claude\"})',\n  },\n  json: {\n    type: 'boolean',\n    description: 'Output structured JSON report',\n    default: false,\n  },\n  save: {\n    type: 'boolean',\n    description: 'Save result to history after running',\n    default: true,\n  },\n} as const;\n\nexport type QACheckFlagsType = typeof qaCheckFlags;\n\nexport default defineCommand({\n  id: 'qa:check',\n  description: 'Run a single QA check atomically and optionally save to history',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<QACheckFlags>) {\n      const { ui } = ctx;\n      const { flags } = input;\n      const rootDir = ctx.cwd;\n      const checkId = flags.id as string;\n      const base = (flags.base as string | undefined) ?? 'main';\n      const isJson = !!flags.json;\n      const shouldSave = flags.save !== false;\n\n      let config: QAPluginConfig | undefined;\n      try {\n        config = await Promise.race([\n          useConfig<QAPluginConfig>(),\n          new Promise<undefined>((resolve) => { setTimeout(() => resolve(undefined), 3000); }),\n        ]);\n      } catch {\n        // config not available\n      }\n\n      // Find the check config by id\n      const allChecks: QACheckConfig[] = config?.checks ?? [];\n      const checkConfig = allChecks.find(c => c.id === checkId);\n\n      if (!checkConfig) {\n        const msg = `Check \"${checkId}\" not found in qa.checks config`;\n        if (isJson) {\n          ui?.json?.({ status: 'error', message: msg });\n        } else {\n          ui?.error?.(msg, { title: 'QA Check Error' });\n        }\n        return { exitCode: 1 };\n      }\n\n      // Parse runContext from --context flag\n      let runContext: Record<string, unknown> | undefined;\n      if (flags.context) {\n        try {\n          runContext = JSON.parse(flags.context as string);\n        } catch {\n          const msg = `Invalid JSON in --context: ${flags.context}`;\n          if (isJson) {\n            ui?.json?.({ status: 'error', message: msg });\n          } else {\n            ui?.error?.(msg, { title: 'QA Check Error' });\n          }\n          return { exitCode: 1 };\n        }\n      }\n\n      const packages = getWorkspacePackages(rootDir, {}, config?.packages);\n\n      const results = runCustomChecks(\n        [checkConfig],\n        packages,\n        rootDir,\n        undefined,\n        base,\n      );\n\n      const checkResult = results[checkId];\n      const hasFailed = checkResult ? checkResult.failed.length > 0 : false;\n\n      // Save to history if requested\n      if (shouldSave) {\n        const entry = createHistoryEntry(results, rootDir, packages, runContext);\n        appendEntry(rootDir, entry, allChecks);\n      }\n\n      const severity = checkConfig.severity ?? 'blocker';\n      const report = buildJsonReport(results, null, [checkConfig]);\n\n      if (isJson) {\n        ui?.json?.(report);\n      } else {\n        if (hasFailed) {\n          const findings = severity === 'warning' ? report.warnings : report.blockers;\n          const checkFindings = findings.find(f => f.check === checkId);\n          if (checkFindings) {\n            ui?.error?.(`Check \"${checkId}\" failed`, {\n              title: `${severity === 'warning' ? '⚠' : '✗'} ${checkId}`,\n              sections: [{\n                header: '',\n                items: checkFindings.items.map(item =>\n                  `  ${item.target}: ${item.message}${item.fix ? ` → ${item.fix}` : ''}`\n                ),\n              }],\n            });\n          }\n        } else {\n          ui?.success?.(`Check \"${checkId}\" passed`, { title: `✓ ${checkId}` });\n        }\n      }\n\n      // Exit code: blockers fail, warnings pass, info always pass\n      const shouldFail = hasFailed && severity === 'blocker';\n      return { exitCode: shouldFail ? 1 : 0 };\n    },\n  },\n});\n"]}
+{"version":3,"sources":["../../../src/cli/commands/qa-check.ts"],"names":[],"mappings":";;;;AAiBA,IAAO,mBAAQ,aAAA,CAAqE;AAAA,EAClF,EAAA,EAAI,UAAA;AAAA,EACJ,WAAA,EAAa,8BAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAA8D;AAChG,MAAA,MAAM,EAAE,OAAM,GAAI,KAAA;AAClB,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAA0B;AAC/C,MAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AAEnC,MAAA,MAAM,UAAA,GAAa,gBAAA,CAAiB,GAAA,EAAK,MAAA,EAAQ,UAAU,CAAA;AAC3D,MAAA,MAAM,OAAA,GAAU,IAAI,aAAA,CAAc,EAAE,UAAA,EAAY,KAAK,KAAA,EAAO,GAAA,CAAI,GAAA,CAAI,KAAA,EAAO,CAAA;AAC3E,MAAA,MAAM,KAAA,GAAQ,IAAI,aAAA,CAAc,GAAA,EAAK,QAAQ,iBAAiB,CAAA;AAE9D,MAAA,MAAM,IAAA,GAAO,MAAM,IAAA,KAAS,KAAA;AAC5B,MAAA,MAAM,MAAM,MAAM,UAAA,CAAW,GAAA,CAAI,GAAA,CAAI,OAAO,GAAG,CAAA;AAE/C,MAAA,MAAM,KAAA,GAAQ,KAAK,GAAA,EAAI;AACvB,MAAA,MAAM,GAAA,GAAM,MAAM,OAAA,CAAQ,KAAA,EAAM;AAChC,MAAA,MAAM,UAAA,GAAa,IAAA,CAAK,GAAA,EAAI,GAAI,KAAA;AAEhC,MAAA,MAAM,OAAO,IAAA,GAAO,KAAA,CAAM,UAAU,GAAA,EAAK,UAAA,EAAY,GAAG,CAAA,GAAI,IAAA;AAC5D,MAAA,MAAM,YAA2D,IAAA,IAAQ;AAAA,QACvE,IAAA,EAAM,OAAA;AAAA,QAAS,EAAA,EAAI,EAAA;AAAA,QAAI,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAAA,QAAG,UAAA;AAAA,QAAY;AAAA,OAC1E;AAEA,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,GAAA,CAAI,EAAA,EAAI,IAAA,GAAO,oBAAA,CAAqB,SAAS,CAAC,CAAA;AAAA,MAChD,CAAA,MAAO;AACL,QAAA,KAAA,MAAW,OAAA,IAAW,gBAAA,CAAiB,SAAS,CAAA,EAAG;AACjD,UAAA,GAAA,CAAI,EAAA,EAAI,OAAA,GAAU,CAAA,EAAG,OAAA,CAAQ,MAAM,CAAA,CAAA,EAAI,EAAE,QAAA,EAAU,CAAC,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA,EAAO,GAAG,CAAA;AAAA,QACjF;AAAA,MACF;AAEA,MAAA,OAAO,EAAE,QAAA,EAAU,GAAA,CAAI,EAAA,GAAK,IAAI,CAAA,EAAE;AAAA,IACpC;AAAA;AAEJ,CAAC","file":"qa-check.js","sourcesContent":["import {\n  defineCommand,\n  useConfig,\n  type CLIInput,\n  type PluginContextV3,\n} from '@kb-labs/sdk';\nimport {\n  DevkitAdapter,\n  SnapshotStore,\n  resolveDevkitBin,\n  captureGit,\n  buildCheckReport,\n  buildCheckJsonReport,\n} from '@kb-labs/qa-core';\nimport { type QAPluginConfig } from '@kb-labs/qa-contracts';\nimport type { QaCheckFlags } from './flags.js';\n\nexport default defineCommand<unknown, CLIInput<QaCheckFlags>, { exitCode: number }>({\n  id: 'qa:check',\n  description: 'Run devkit structural checks',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<QaCheckFlags>): Promise<{ exitCode: number }> {\n      const { flags } = input;\n      const config = await useConfig<QAPluginConfig>();\n      const cwd = ctx.cwd ?? process.cwd();\n\n      const binaryPath = resolveDevkitBin(cwd, config?.devkitPath);\n      const adapter = new DevkitAdapter({ binaryPath, cwd, shell: ctx.api.shell });\n      const store = new SnapshotStore(cwd, config?.historyMaxEntries);\n\n      const save = flags.save !== false;\n      const git = await captureGit(ctx.api.shell, cwd);\n\n      const start = Date.now();\n      const raw = await adapter.check();\n      const durationMs = Date.now() - start;\n\n      const snap = save ? store.saveCheck(raw, durationMs, git) : null;\n      const effective: import('@kb-labs/qa-contracts').CheckSnapshot = snap ?? {\n        kind: 'check', id: '', timestamp: new Date().toISOString(), durationMs, raw,\n      };\n\n      if (flags.json) {\n        ctx.ui?.json?.(buildCheckJsonReport(effective));\n      } else {\n        for (const section of buildCheckReport(effective)) {\n          ctx.ui?.success?.(`${section.header}`, { sections: [{ items: section.lines }] });\n        }\n      }\n\n      return { exitCode: raw.ok ? 0 : 1 };\n    },\n  },\n});\n"]}

package/dist/cli/commands/qa-gate.d.ts

@@ -0,0 +1,19 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { CLIInput } from '@kb-labs/sdk';
+
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<_kb_labs_shared_command_kit.InferFlags<{
+    save: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    json: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>>, {
+    exitCode: number;
+}>;
+
+export { _default as default };

package/dist/cli/commands/qa-gate.js

@@ -0,0 +1,36 @@
+import { defineCommand, useConfig } from '@kb-labs/sdk';
+import { resolveDevkitBin, DevkitAdapter, SnapshotStore, captureGit } from '@kb-labs/qa-core';
+
+// src/cli/commands/qa-gate.ts
+var qa_gate_default = defineCommand({
+  id: "qa:gate",
+  description: "Run pre-commit gate check (exits 1 if violations found)",
+  handler: {
+    async execute(ctx, input) {
+      const { flags } = input;
+      const config = await useConfig();
+      const cwd = ctx.cwd ?? process.cwd();
+      const binaryPath = resolveDevkitBin(cwd, config?.devkitPath);
+      const adapter = new DevkitAdapter({ binaryPath, cwd, shell: ctx.api.shell });
+      const store = new SnapshotStore(cwd, config?.historyMaxEntries);
+      const git = await captureGit(ctx.api.shell, cwd);
+      const start = Date.now();
+      const raw = await adapter.gate();
+      const durationMs = Date.now() - start;
+      if (flags.save) store.saveGate(raw, durationMs, git);
+      if (flags.json) {
+        ctx.ui?.json?.(raw);
+      } else if (raw.ok) {
+        ctx.ui?.success?.(`Gate passed. ${raw.staged_files} staged file(s), no violations.`);
+      } else {
+        const items = raw.violations.map((v) => `[${v.severity}] ${v.package}  ${v.check}: ${v.message}`);
+        ctx.ui?.error?.("Gate failed", { sections: [{ header: "Violations", items }] });
+      }
+      return { exitCode: raw.ok ? 0 : 1 };
+    }
+  }
+});
+
+export { qa_gate_default as default };
+//# sourceMappingURL=qa-gate.js.map
+//# sourceMappingURL=qa-gate.js.map

package/dist/cli/commands/qa-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/qa-gate.ts"],"names":[],"mappings":";;;;AAeA,IAAO,kBAAQ,aAAA,CAAoE;AAAA,EACjF,EAAA,EAAI,SAAA;AAAA,EACJ,WAAA,EAAa,yDAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAA6D;AAC/F,MAAA,MAAM,EAAE,OAAM,GAAI,KAAA;AAClB,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAA0B;AAC/C,MAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AAEnC,MAAA,MAAM,UAAA,GAAa,gBAAA,CAAiB,GAAA,EAAK,MAAA,EAAQ,UAAU,CAAA;AAC3D,MAAA,MAAM,OAAA,GAAU,IAAI,aAAA,CAAc,EAAE,UAAA,EAAY,KAAK,KAAA,EAAO,GAAA,CAAI,GAAA,CAAI,KAAA,EAAO,CAAA;AAC3E,MAAA,MAAM,KAAA,GAAQ,IAAI,aAAA,CAAc,GAAA,EAAK,QAAQ,iBAAiB,CAAA;AAE9D,MAAA,MAAM,MAAM,MAAM,UAAA,CAAW,GAAA,CAAI,GAAA,CAAI,OAAO,GAAG,CAAA;AAE/C,MAAA,MAAM,KAAA,GAAQ,KAAK,GAAA,EAAI;AACvB,MAAA,MAAM,GAAA,GAAM,MAAM,OAAA,CAAQ,IAAA,EAAK;AAC/B,MAAA,MAAM,UAAA,GAAa,IAAA,CAAK,GAAA,EAAI,GAAI,KAAA;AAEhC,MAAA,IAAI,MAAM,IAAA,EAAM,KAAA,CAAM,QAAA,CAAS,GAAA,EAAK,YAAY,GAAG,CAAA;AAEnD,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,GAAA,CAAI,EAAA,EAAI,OAAO,GAAG,CAAA;AAAA,MACpB,CAAA,MAAA,IAAW,IAAI,EAAA,EAAI;AACjB,QAAA,GAAA,CAAI,EAAA,EAAI,OAAA,GAAU,CAAA,aAAA,EAAgB,GAAA,CAAI,YAAY,CAAA,+BAAA,CAAiC,CAAA;AAAA,MACrF,CAAA,MAAO;AACL,QAAA,MAAM,QAAQ,GAAA,CAAI,UAAA,CAAW,GAAA,CAAI,CAAA,CAAA,KAAK,IAAI,CAAA,CAAE,QAAQ,CAAA,EAAA,EAAK,CAAA,CAAE,OAAO,CAAA,EAAA,EAAK,CAAA,CAAE,KAAK,CAAA,EAAA,EAAK,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA;AAC9F,QAAA,GAAA,CAAI,EAAA,EAAI,KAAA,GAAQ,aAAA,EAAe,EAAE,QAAA,EAAU,CAAC,EAAE,MAAA,EAAQ,YAAA,EAAc,KAAA,EAAO,CAAA,EAAG,CAAA;AAAA,MAChF;AAEA,MAAA,OAAO,EAAE,QAAA,EAAU,GAAA,CAAI,EAAA,GAAK,IAAI,CAAA,EAAE;AAAA,IACpC;AAAA;AAEJ,CAAC","file":"qa-gate.js","sourcesContent":["import {\n  defineCommand,\n  useConfig,\n  type CLIInput,\n  type PluginContextV3,\n} from '@kb-labs/sdk';\nimport {\n  DevkitAdapter,\n  SnapshotStore,\n  resolveDevkitBin,\n  captureGit,\n} from '@kb-labs/qa-core';\nimport { type QAPluginConfig } from '@kb-labs/qa-contracts';\nimport type { QaGateFlags } from './flags.js';\n\nexport default defineCommand<unknown, CLIInput<QaGateFlags>, { exitCode: number }>({\n  id: 'qa:gate',\n  description: 'Run pre-commit gate check (exits 1 if violations found)',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<QaGateFlags>): Promise<{ exitCode: number }> {\n      const { flags } = input;\n      const config = await useConfig<QAPluginConfig>();\n      const cwd = ctx.cwd ?? process.cwd();\n\n      const binaryPath = resolveDevkitBin(cwd, config?.devkitPath);\n      const adapter = new DevkitAdapter({ binaryPath, cwd, shell: ctx.api.shell });\n      const store = new SnapshotStore(cwd, config?.historyMaxEntries);\n\n      const git = await captureGit(ctx.api.shell, cwd);\n\n      const start = Date.now();\n      const raw = await adapter.gate();\n      const durationMs = Date.now() - start;\n\n      if (flags.save) store.saveGate(raw, durationMs, git);\n\n      if (flags.json) {\n        ctx.ui?.json?.(raw);\n      } else if (raw.ok) {\n        ctx.ui?.success?.(`Gate passed. ${raw.staged_files} staged file(s), no violations.`);\n      } else {\n        const items = raw.violations.map(v => `[${v.severity}] ${v.package}  ${v.check}: ${v.message}`);\n        ctx.ui?.error?.('Gate failed', { sections: [{ header: 'Violations', items }] });\n      }\n\n      return { exitCode: raw.ok ? 0 : 1 };\n    },\n  },\n});\n"]}

package/dist/cli/commands/qa-history.d.ts

@@ -1,9 +1,19 @@
 import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
-import { QAHistoryFlags } from './flags.js';
+import { CLIInput } from '@kb-labs/sdk';
 
-type QAHistoryInput = QAHistoryFlags & {
-    argv?: string[];
-};
-declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, QAHistoryInput, unknown>;
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, CLIInput<_kb_labs_shared_command_kit.InferFlags<{
+    limit: {
+        type: "number";
+        description: string;
+        default: number;
+    };
+    json: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+}>>, {
+    exitCode: number;
+}>;
 
 export { _default as default };

package/dist/cli/commands/qa-history.js

@@ -1,5 +1,5 @@
-import { defineCommand } from '@kb-labs/sdk';
-import { loadHistory, buildHistoryTable } from '@kb-labs/qa-core';
+import { defineCommand, useConfig } from '@kb-labs/sdk';
+import { SnapshotStore, buildHistoryTable } from '@kb-labs/qa-core';
 
 // src/cli/commands/qa-history.ts
 var qa_history_default = defineCommand({
@@ -7,29 +7,18 @@ var qa_history_default = defineCommand({
   description: "Show QA run history",
   handler: {
     async execute(ctx, input) {
-      const { ui } = ctx;
-      const flags = "flags" in input && typeof input.flags === "object" && input.flags !== null ? input.flags : input;
-      const rootDir = ctx.cwd;
-      const history = loadHistory(rootDir);
-      if (history.length === 0) {
-        if (flags.json) {
-          ui?.json?.([]);
-          return { exitCode: 0 };
-        }
-        ui?.success?.("No QA history found. Run qa:save first.", {});
-        return { exitCode: 0 };
-      }
-      const limit = typeof flags.limit === "number" ? flags.limit : 20;
+      const { flags } = input;
+      const config = await useConfig();
+      const cwd = ctx.cwd ?? process.cwd();
+      const store = new SnapshotStore(cwd, config?.historyMaxEntries);
+      const limit = flags.limit ?? 20;
+      const history = store.loadRunHistory();
       if (flags.json) {
-        ui?.json?.(history.slice(-limit));
-        return { exitCode: 0 };
-      }
-      const sections = buildHistoryTable(history, limit);
-      for (const section of sections) {
-        ui?.success?.(section.header, {
-          title: section.header,
-          sections: [{ header: "", items: section.lines }]
-        });
+        ctx.ui?.json?.([...history].reverse().slice(0, limit));
+      } else {
+        for (const section of buildHistoryTable(history, limit)) {
+          ctx.ui?.success?.(`${section.header}`, { sections: [{ items: section.lines }] });
+        }
       }
       return { exitCode: 0 };
     }

package/dist/cli/commands/qa-history.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/cli/commands/qa-history.ts"],"names":[],"mappings":";;;;AAMA,IAAO,qBAAQ,aAAA,CAAc;AAAA,EAC3B,EAAA,EAAI,YAAA;AAAA,EACJ,WAAA,EAAa,qBAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAAuB;AACzD,MAAA,MAAM,EAAE,IAAG,GAAI,GAAA;AACf,MAAA,MAAM,KAAA,GAAS,OAAA,IAAW,KAAA,IAAS,OAAQ,KAAA,CAA8B,KAAA,KAAU,QAAA,IAAa,KAAA,CAA8B,KAAA,KAAU,IAAA,GACnI,KAAA,CAAoC,KAAA,GACrC,KAAA;AACJ,MAAA,MAAM,UAAU,GAAA,CAAI,GAAA;AAEpB,MAAA,MAAM,OAAA,GAAU,YAAY,OAAO,CAAA;AAEnC,MAAA,IAAI,OAAA,CAAQ,WAAW,CAAA,EAAG;AACxB,QAAA,IAAI,MAAM,IAAA,EAAM;AACd,UAAA,EAAA,EAAI,IAAA,GAAO,EAAE,CAAA;AACb,UAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,QACvB;AACA,QAAA,EAAA,EAAI,OAAA,GAAU,yCAAA,EAA2C,EAAE,CAAA;AAC3D,QAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,MACvB;AAEA,MAAA,MAAM,QAAQ,OAAO,KAAA,CAAM,KAAA,KAAU,QAAA,GAAW,MAAM,KAAA,GAAQ,EAAA;AAE9D,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,EAAA,EAAI,IAAA,GAAO,OAAA,CAAQ,KAAA,CAAM,CAAC,KAAK,CAAC,CAAA;AAChC,QAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,MACvB;AAEA,MAAA,MAAM,QAAA,GAAW,iBAAA,CAAkB,OAAA,EAAS,KAAK,CAAA;AACjD,MAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,QAAA,EAAA,EAAI,OAAA,GAAU,QAAQ,MAAA,EAAQ;AAAA,UAC5B,OAAO,OAAA,CAAQ,MAAA;AAAA,UACf,QAAA,EAAU,CAAC,EAAE,MAAA,EAAQ,IAAI,KAAA,EAAO,OAAA,CAAQ,OAAO;AAAA,SAChD,CAAA;AAAA,MACH;AAEA,MAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,IACvB;AAAA;AAEJ,CAAC","file":"qa-history.js","sourcesContent":["import { defineCommand, type PluginContextV3 } from '@kb-labs/sdk';\nimport { loadHistory, buildHistoryTable } from '@kb-labs/qa-core';\nimport type { QAHistoryFlags } from './flags.js';\n\ntype QAHistoryInput = QAHistoryFlags & { argv?: string[] };\n\nexport default defineCommand({\n  id: 'qa:history',\n  description: 'Show QA run history',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: QAHistoryInput) {\n      const { ui } = ctx;\n      const flags = ('flags' in input && typeof (input as { flags?: unknown }).flags === 'object' && (input as { flags?: unknown }).flags !== null)\n        ? (input as { flags: QAHistoryInput }).flags\n        : input;\n      const rootDir = ctx.cwd;\n\n      const history = loadHistory(rootDir);\n\n      if (history.length === 0) {\n        if (flags.json) {\n          ui?.json?.([]);\n          return { exitCode: 0 };\n        }\n        ui?.success?.('No QA history found. Run qa:save first.', {});\n        return { exitCode: 0 };\n      }\n\n      const limit = typeof flags.limit === 'number' ? flags.limit : 20;\n\n      if (flags.json) {\n        ui?.json?.(history.slice(-limit));\n        return { exitCode: 0 };\n      }\n\n      const sections = buildHistoryTable(history, limit);\n      for (const section of sections) {\n        ui?.success?.(section.header, {\n          title: section.header,\n          sections: [{ header: '', items: section.lines }],\n        });\n      }\n\n      return { exitCode: 0 };\n    },\n  },\n});\n"]}
+{"version":3,"sources":["../../../src/cli/commands/qa-history.ts"],"names":[],"mappings":";;;;AAaA,IAAO,qBAAQ,aAAA,CAAuE;AAAA,EACpF,EAAA,EAAI,YAAA;AAAA,EACJ,WAAA,EAAa,qBAAA;AAAA,EAEb,OAAA,EAAS;AAAA,IACP,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAAgE;AAClG,MAAA,MAAM,EAAE,OAAM,GAAI,KAAA;AAClB,MAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAA0B;AAC/C,MAAA,MAAM,GAAA,GAAM,GAAA,CAAI,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AAEnC,MAAA,MAAM,KAAA,GAAQ,IAAI,aAAA,CAAc,GAAA,EAAK,QAAQ,iBAAiB,CAAA;AAC9D,MAAA,MAAM,KAAA,GAAQ,MAAM,KAAA,IAAS,EAAA;AAC7B,MAAA,MAAM,OAAA,GAAU,MAAM,cAAA,EAAe;AAErC,MAAA,IAAI,MAAM,IAAA,EAAM;AACd,QAAA,GAAA,CAAI,EAAA,EAAI,IAAA,GAAO,CAAC,GAAG,OAAO,CAAA,CAAE,OAAA,EAAQ,CAAE,KAAA,CAAM,CAAA,EAAG,KAAK,CAAC,CAAA;AAAA,MACvD,CAAA,MAAO;AACL,QAAA,KAAA,MAAW,OAAA,IAAW,iBAAA,CAAkB,OAAA,EAAS,KAAK,CAAA,EAAG;AACvD,UAAA,GAAA,CAAI,EAAA,EAAI,OAAA,GAAU,CAAA,EAAG,OAAA,CAAQ,MAAM,CAAA,CAAA,EAAI,EAAE,QAAA,EAAU,CAAC,EAAE,KAAA,EAAO,OAAA,CAAQ,KAAA,EAAO,GAAG,CAAA;AAAA,QACjF;AAAA,MACF;AAEA,MAAA,OAAO,EAAE,UAAU,CAAA,EAAE;AAAA,IACvB;AAAA;AAEJ,CAAC","file":"qa-history.js","sourcesContent":["import {\n  defineCommand,\n  useConfig,\n  type CLIInput,\n  type PluginContextV3,\n} from '@kb-labs/sdk';\nimport {\n  SnapshotStore,\n  buildHistoryTable,\n} from '@kb-labs/qa-core';\nimport { type QAPluginConfig } from '@kb-labs/qa-contracts';\nimport type { QaHistoryFlags } from './flags.js';\n\nexport default defineCommand<unknown, CLIInput<QaHistoryFlags>, { exitCode: number }>({\n  id: 'qa:history',\n  description: 'Show QA run history',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: CLIInput<QaHistoryFlags>): Promise<{ exitCode: number }> {\n      const { flags } = input;\n      const config = await useConfig<QAPluginConfig>();\n      const cwd = ctx.cwd ?? process.cwd();\n\n      const store = new SnapshotStore(cwd, config?.historyMaxEntries);\n      const limit = flags.limit ?? 20;\n      const history = store.loadRunHistory();\n\n      if (flags.json) {\n        ctx.ui?.json?.([...history].reverse().slice(0, limit));\n      } else {\n        for (const section of buildHistoryTable(history, limit)) {\n          ctx.ui?.success?.(`${section.header}`, { sections: [{ items: section.lines }] });\n        }\n      }\n\n      return { exitCode: 0 };\n    },\n  },\n});\n"]}