@aipper/aiws 0.0.19 → 0.0.21

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@aipper/aiws",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "description": "AI Workspace CLI (init/update/validate) for Claude Code / OpenCode / Codex / iFlow.",
   "type": "module",
   "bin": {
     "aiws": "./bin/aiws.js"
   },
   "dependencies": {
-    "@aipper/aiws-spec": "0.0.19"
+    "@aipper/aiws-spec": "0.0.21"
   },
   "files": [
     "bin",

package/src/cli.js

@@ -17,16 +17,19 @@ import { hooksStatusCommand } from "./commands/hooks-status.js";
 import { dashboardServeCommand } from "./commands/dashboard.js";
 import {
   changeArchiveCommand,
+  changeEvidenceCommand,
   changeFinishCommand,
   changeListCommand,
   changeNewCommand,
   changeNextCommand,
+  changeStateCommand,
   changeStartCommand,
   changeStatusCommand,
   changeSyncCommand,
   changeTemplatesInitCommand,
   changeTemplatesWhichCommand,
   changeValidateCommand,
+  metricsSummaryCommand,
 } from "./commands/change.js";
 
 /**
@@ -51,6 +54,10 @@ export async function cliMain(argv) {
     printChangeHelp();
     return 0;
   }
+  if (args[0] === "metrics" && (args.includes("-h") || args.includes("--help"))) {
+    printMetricsHelp();
+    return 0;
+  }
   if (args.length === 0 || args.includes("-h") || args.includes("--help") || args[0] === "help") {
     printHelp();
     return 0;
@@ -306,15 +313,38 @@ export async function cliMain(argv) {
           const { positionals, options } = parseArgs(args, {
             strict: { type: "boolean" },
             "allow-truth-drift": { type: "boolean" },
+            "check-evidence": { type: "boolean" },
+            "check-scope": { type: "boolean" },
           });
           const changeId = positionals[0];
           await changeValidateCommand({
             changeId,
             strict: options.strict === true,
             allowTruthDrift: options["allow-truth-drift"] === true,
+            checkEvidence: options["check-evidence"] === true,
+            checkScope: options["check-scope"] === true,
           });
           return 0;
         }
+        case "evidence": {
+          const { positionals, options } = parseArgs(args, {
+            "no-validate": { type: "boolean" },
+            "allow-fail": { type: "boolean" },
+          });
+          const changeId = positionals[0];
+          await changeEvidenceCommand({
+            changeId,
+            noValidate: options["no-validate"] === true,
+            allowFail: options["allow-fail"] === true,
+          });
+          return 0;
+        }
+        case "state": {
+          const { positionals, options } = parseArgs(args, { write: { type: "boolean" } });
+          const changeId = positionals[0];
+          await changeStateCommand({ changeId, write: options.write === true });
+          return 0;
+        }
         case "sync": {
           const { positionals } = parseArgs(args, {});
           const changeId = positionals[0];
@@ -368,6 +398,19 @@ export async function cliMain(argv) {
           throw new UserError(`Unknown change subcommand: ${sub}`, { details: "Use `aiws change --help` to see available subcommands." });
       }
     }
+    case "metrics": {
+      const sub = args.shift();
+      if (!sub || sub === "help" || sub === "--help" || sub === "-h") {
+        printMetricsHelp();
+        return 0;
+      }
+      if (sub === "summary") {
+        const { options } = parseArgs(args, { since: { type: "string" } });
+        await metricsSummaryCommand({ since: options.since });
+        return 0;
+      }
+      throw new UserError(`Unknown metrics subcommand: ${sub}`, { details: "Use `aiws metrics --help` to see available subcommands." });
+    }
     default:
       throw new UserError(`Unknown command: ${cmd}`, { details: "Use --help to see available commands." });
   }
@@ -382,6 +425,7 @@ Usage:
   aiws validate [path] [--stamp]
   aiws rollback [path] <timestamp|latest>
   aiws change <subcommand>
+  aiws metrics <subcommand>
   aiws dashboard <subcommand>
   aiws codex <subcommand>
   aiws hooks <subcommand>
@@ -451,7 +495,9 @@ Usage:
   aiws change new <change-id> [--title <title>] [--no-design]
   aiws change status [change-id]
   aiws change next [change-id]
-  aiws change validate [change-id] [--strict] [--allow-truth-drift]
+  aiws change validate [change-id] [--strict] [--allow-truth-drift] [--check-evidence] [--check-scope]
+  aiws change evidence [change-id] [--no-validate] [--allow-fail]
+  aiws change state [change-id] [--write]
   aiws change sync [change-id]
   aiws change archive [change-id] [--date YYYY-MM-DD] [--force]
   aiws change templates which
@@ -471,6 +517,17 @@ Notes:
 `);
 }
 
+function printMetricsHelp() {
+  console.log(`aiws metrics
+
+Usage:
+  aiws metrics summary [--since YYYY-MM-DD]
+
+Notes:
+  - Reads changes/*/metrics.json (and changes/archive/*/metrics.json) and prints a best-effort summary.
+`);
+}
+
 /**
  * Minimal argv parser:
  * - supports: --k=v, --k v