@aipper/aiws 0.0.20 → 0.0.23

package/README.md

@@ -47,7 +47,7 @@ aiws codex <install-skills|status-skills|uninstall-skills|install-prompts|status
 
 ## Codex（repo skills 优先）
 
-- `aiws init .` 会生成 `.agents/skills/`（随仓库共享），在 Codex 中可显式调用（示例）：`$ws-preflight` / `$ws-plan` / `$ws-dev` / `$ws-review` / `$ws-commit`
+- `aiws init .` 会生成 `.agents/skills/`（随仓库共享），在 Codex 中可显式调用（示例）：`$ws-preflight` / `$ws-plan` / `$p-tasks-plan` / `$ws-handoff` / `$ws-dev` / `$ws-review` / `$ws-commit`
 - 交付收尾（submodules+superproject 分步提交 + 安全合并）：`$ws-deliver`
 - 收尾（安全合并回目标分支）：`$ws-finish`（底层调用 `aiws change finish`，默认 fast-forward）
 - 可选：安装全局 skills 到 `~/.codex/skills/`（或 `$CODEX_HOME/skills`）：

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@aipper/aiws",
-  "version": "0.0.20",
+  "version": "0.0.23",
   "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.20"
+    "@aipper/aiws-spec": "0.0.23"
   },
   "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;
@@ -253,6 +260,7 @@ export async function cliMain(argv) {
             hooks: { type: "boolean" },
             "no-switch": { type: "boolean" },
             switch: { type: "boolean" },
+            "allow-dirty": { type: "boolean" },
             worktree: { type: "boolean" },
             "worktree-dir": { type: "string" },
             submodules: { type: "boolean" },
@@ -261,7 +269,7 @@ export async function cliMain(argv) {
           if (!changeId)
             throw new UserError("change start requires <change-id>", {
               details:
-                "Usage: aiws change start <change-id> [--title <title>] [--no-design] [--hooks] [--no-switch] [--switch] [--worktree] [--worktree-dir <path>] [--submodules]",
+                "Usage: aiws change start <change-id> [--title <title>] [--no-design] [--hooks] [--no-switch] [--switch] [--allow-dirty] [--worktree] [--worktree-dir <path>] [--submodules]",
             });
           await changeStartCommand({
             changeId,
@@ -270,6 +278,7 @@ export async function cliMain(argv) {
             enableHooks: options.hooks === true,
             noSwitch: options["no-switch"] === true,
             forceSwitch: options.switch === true,
+            allowDirty: options["allow-dirty"] === true,
             worktree: options.worktree === true,
             worktreeDir: options["worktree-dir"],
             submodules: options.submodules === true,
@@ -306,15 +315,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 +400,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 +427,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>
@@ -446,12 +492,14 @@ function printChangeHelp() {
 
 Usage:
   aiws change list
-  aiws change start <change-id> [--title <title>] [--no-design] [--hooks] [--no-switch] [--switch] [--worktree] [--worktree-dir <path>] [--submodules]
+  aiws change start <change-id> [--title <title>] [--no-design] [--hooks] [--no-switch] [--switch] [--allow-dirty] [--worktree] [--worktree-dir <path>]
   aiws change finish [change-id] [--into <branch> | --base <branch>]
   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
@@ -464,6 +512,7 @@ Notes:
   - Execution quality gate first: aiws change validate [change-id] --strict
     (equivalent to running $ws-plan-verify in AI tools).
   - status/next now prioritize quality-gate guidance before coding ($ws-dev).
+  - start refuses to switch/create worktree with a dirty working tree (unless --allow-dirty).
   - If .gitmodules exists and you didn't specify --switch/--no-switch/--worktree,
     start will prefer --worktree (fallback: --no-switch) to avoid switching the superproject branch.
   - archive runs strict validation and (by default) requires all tasks checked.
@@ -471,6 +520,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