@uoyo/mvtt 2.0.0-beta.6 → 2.1.0

package/dist/scripts/plan-update.md

@@ -0,0 +1,59 @@
+# Plan Update Script — Full Reference
+
+> **This file is the authoritative usage reference for `plan-update.cjs`.**
+> Read this file before calling the script. Do NOT read the `.cjs` or `.js` source to learn flag names or semantics.
+
+## Command
+
+```bash
+node .ai-agents/scripts/plan-update.cjs \
+  --plan "<active_change.plan_path>" \
+  --task <task_id> \
+  --projects "<comma,separated,project,names>" \
+  [--status <pending|in_progress|done|blocked|skipped>] \
+  [--artifacts "<comma,separated,paths>"] \
+  [--notes "<free-form text>"] \
+  [--deliverables-pointer current] \
+  [--mark-deliverable-stale <task_id>[,task_id2,...]]
+```
+
+Include `--artifacts`, `--notes`, `--deliverables-pointer`, and `--mark-deliverable-stale` only when the skill's logic determines they apply; omit each flag otherwise.
+
+## Argument values
+
+| Argument | Value source | Example |
+|----------|-------------|---------|
+| `--plan` | `active_change.plan_path` resolved from session.yaml | `".ai-agents/workspace/artifacts/chg-001/plan.yaml"` |
+| `--task` | the `task_id` being updated (resolved by the skill's Step 1) | `t1` |
+| `--status` | optional; the new status: `pending` / `in_progress` / `done` / `blocked` / `skipped` | `done` |
+| `--projects` | comma-separated project names from `project-context.yaml > projects[].name` (single-project: the sole project name) | `"web,api"` |
+| `--artifacts` | optional; comma-separated paths to append (the script de-duplicates) | `"src/auth.ts,src/auth.test.ts"` |
+| `--notes` | optional; overwrites the task's `notes` | `"blocked on API spec"` |
+| `--deliverables-pointer` | optional; set to `current` to record that this task's deliverables section is written | `current` |
+| `--mark-deliverable-stale` | optional; comma-separated downstream task ids whose deliverables are now stale | `"t3,t4"` |
+
+## Parameter semantics
+
+| Argument | When to use | Effect on `plan.yaml` |
+|----------|-------------|------------------------|
+| `--task` + optional `--status` | Use `--status` for status transitions; omit it for metadata-only updates such as deliverables freshness | When present, sets the task status; sets `completed_at` to now when `done`, else `null`; refreshes `plan.updated_at`. When omitted, status, `completed_at`, DAG advancement, and `current_tasks` are left unchanged. |
+| `--projects` | Always (per-project validation) | Drives per-project DAG advancement of `current_tasks` and per-project validation. Required for correct multi-project plans. |
+| `--artifacts` | Task produced or touched files | Appends + de-duplicates paths into the task's `artifacts.files`; handles `artifacts: null`. |
+| `--notes` | Task needs a free-form note | Overwrites the task's existing `notes`. |
+| `--deliverables-pointer` + `--mark-deliverable-stale` | Task wrote its deliverables section (e.g. `/mvt-implement` Step 8) | Records the deliverables pointer on the task; marks the listed downstream tasks' deliverables as stale so `/mvt-resume` and `/mvt-status` surface a warning. Use both flags together in a single invocation. |
+
+## What the script does (deterministically)
+
+1. **Apply**: when `--status` is present, sets the task status and `completed_at`; appends + de-duplicates `--artifacts`; overwrites `--notes`; refreshes `plan.updated_at`.
+2. **Recompute `current_tasks`** only when `--status` is present (per-project independent advancement): for each project, finds the `in_progress` task or advances the first `pending` task whose `depends_on` are all in `resolvedIds` (done + skipped; blocked does NOT satisfy). Detects `project_switch` when advancement crosses a project boundary. Plan done -> `current_tasks = {}`.
+3. **Validate** the mutated plan (unique ids, valid `depends_on` references, DAG/no-cycle per project, one `in_progress` per project, every task has acceptance, `completed_at` consistency, `current_tasks` validity, project naming constraint, task project membership).
+4. **Write atomically** (temp + rename) only if validation passes.
+
+## Output interpretation
+
+- **Exit 0**: success. stdout is a single-line JSON object, e.g.:
+  ```json
+  {"ok":true,"task":{"id":"t1","title":"...","old_status":"in_progress","new_status":"done"},"current_tasks":{"default":"t2"},"plan_status":"in_progress","progress":{"done":1,"total":4},"warning":null,"project_switch":null}
+  ```
+  Use these fields directly to render output. The file is already written — do NOT read it back to verify. If `warning` is non-null, surface it. If `project_switch` is non-null, note the project boundary crossing.
+- **Exit 1**: failure. stderr carries the error (invalid status, task not found, validation failure, parse/write error). The file was **not** modified. Report the error to the user and do not fabricate a success summary.

package/dist/scripts/session-update.cjs

@@ -7,7 +7,11 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  try {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  } catch (e) {
+    throw mod = 0, e;
+  }
 };
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
@@ -30,13 +34,13 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var require_identity = __commonJS({
   "node_modules/yaml/dist/nodes/identity.js"(exports2) {
     "use strict";
-    var ALIAS = Symbol.for("yaml.alias");
-    var DOC = Symbol.for("yaml.document");
-    var MAP = Symbol.for("yaml.map");
-    var PAIR = Symbol.for("yaml.pair");
-    var SCALAR = Symbol.for("yaml.scalar");
-    var SEQ = Symbol.for("yaml.seq");
-    var NODE_TYPE = Symbol.for("yaml.node.type");
+    var ALIAS = /* @__PURE__ */ Symbol.for("yaml.alias");
+    var DOC = /* @__PURE__ */ Symbol.for("yaml.document");
+    var MAP = /* @__PURE__ */ Symbol.for("yaml.map");
+    var PAIR = /* @__PURE__ */ Symbol.for("yaml.pair");
+    var SCALAR = /* @__PURE__ */ Symbol.for("yaml.scalar");
+    var SEQ = /* @__PURE__ */ Symbol.for("yaml.seq");
+    var NODE_TYPE = /* @__PURE__ */ Symbol.for("yaml.node.type");
     var isAlias = (node) => !!node && typeof node === "object" && node[NODE_TYPE] === ALIAS;
     var isDocument = (node) => !!node && typeof node === "object" && node[NODE_TYPE] === DOC;
     var isMap = (node) => !!node && typeof node === "object" && node[NODE_TYPE] === MAP;
@@ -88,9 +92,9 @@ var require_visit = __commonJS({
   "node_modules/yaml/dist/visit.js"(exports2) {
     "use strict";
     var identity = require_identity();
-    var BREAK = Symbol("break visit");
-    var SKIP = Symbol("skip children");
-    var REMOVE = Symbol("remove node");
+    var BREAK = /* @__PURE__ */ Symbol("break visit");
+    var SKIP = /* @__PURE__ */ Symbol("skip children");
+    var REMOVE = /* @__PURE__ */ Symbol("remove node");
     function visit(node, visitor) {
       const visitor_ = initVisitor(visitor);
       if (identity.isDocument(node)) {
@@ -3856,6 +3860,7 @@ var require_resolve_props = __commonJS({
               hasSpace = false;
               break;
             }
+          // else fallthrough
           default:
             onError(token, "UNEXPECTED_TOKEN", `Unexpected ${token.type} token`);
             atNewline = false;
@@ -4564,6 +4569,7 @@ var require_resolve_block_scalar = __commonJS({
         switch (token.type) {
           case "space":
             hasSpace = true;
+          // fallthrough
           case "newline":
             length += token.source.length;
             break;
@@ -4579,6 +4585,7 @@ var require_resolve_block_scalar = __commonJS({
             onError(token, "UNEXPECTED_TOKEN", token.message);
             length += token.source.length;
             break;
+          /* istanbul ignore next should not happen */
           default: {
             const message = `Unexpected token in block scalar header: ${token.type}`;
             onError(token, "UNEXPECTED_TOKEN", message);
@@ -4628,6 +4635,7 @@ var require_resolve_flow_scalar = __commonJS({
           _type = Scalar.Scalar.QUOTE_DOUBLE;
           value = doubleQuotedValue(source, _onError);
           break;
+        /* istanbul ignore next should not happen */
         default:
           onError(scalar, "UNEXPECTED_TOKEN", `Expected a flow scalar value, but found: ${type}`);
           return {
@@ -4649,6 +4657,7 @@ var require_resolve_flow_scalar = __commonJS({
     function plainValue(source, onError) {
       let badChar = "";
       switch (source[0]) {
+        /* istanbul ignore next should not happen */
         case "	":
           badChar = "a tab character";
           break;
@@ -5537,9 +5546,9 @@ var require_cst_stringify = __commonJS({
 var require_cst_visit = __commonJS({
   "node_modules/yaml/dist/parse/cst-visit.js"(exports2) {
     "use strict";
-    var BREAK = Symbol("break visit");
-    var SKIP = Symbol("skip children");
-    var REMOVE = Symbol("remove item");
+    var BREAK = /* @__PURE__ */ Symbol("break visit");
+    var SKIP = /* @__PURE__ */ Symbol("skip children");
+    var REMOVE = /* @__PURE__ */ Symbol("remove item");
     function visit(cst, visitor) {
       if ("type" in cst && cst.type === "document")
         cst = { start: cst.start, value: cst.value };
@@ -5912,6 +5921,7 @@ var require_lexer = __commonJS({
         switch (line[n]) {
           case "#":
             yield* this.pushCount(line.length - n);
+          // fallthrough
           case void 0:
             yield* this.pushNewline();
             return yield* this.parseLineStart();
@@ -6007,6 +6017,7 @@ var require_lexer = __commonJS({
               return "flow";
             }
           }
+          // fallthrough
           default:
             this.flowKey = false;
             return yield* this.parsePlainScalar();
@@ -6084,6 +6095,7 @@ var require_lexer = __commonJS({
               if (next === "\n")
                 break;
             }
+            // fallthrough
             default:
               break loop;
           }
@@ -6201,7 +6213,9 @@ var require_lexer = __commonJS({
           case "&":
             return (yield* this.pushUntil(isNotAnchorChar)) + (yield* this.pushSpaces(true)) + (yield* this.pushIndicators());
           case "-":
+          // this is an error
           case "?":
+          // this is an error outside flow collections
           case ":": {
             const inFlow = this.flowLevel > 0;
             const ch1 = this.charAt(1);
@@ -6350,6 +6364,7 @@ var require_parser = __commonJS({
         }
         case "block-seq":
           return parent.items[parent.items.length - 1].start;
+        /* istanbul ignore next should not happen */
         default:
           return [];
       }
@@ -6583,6 +6598,7 @@ var require_parser = __commonJS({
                 Object.assign(it, { key: token, sep: [] });
               return;
             }
+            /* istanbul ignore next should not happen */
             default:
               yield* this.pop();
               yield* this.pop(token);
@@ -6704,6 +6720,7 @@ var require_parser = __commonJS({
             }
             yield* this.pop();
             break;
+          /* istanbul ignore next should not happen */
           default:
             yield* this.pop();
             yield* this.step();
@@ -7149,6 +7166,7 @@ var require_parser = __commonJS({
             break;
           case "newline":
             this.onKeyLine = false;
+          // fallthrough
           case "space":
           case "comment":
           default:
@@ -7460,11 +7478,12 @@ function main() {
         session.changes = session.changes.slice(-limits.changes);
       }
     }
+    const isSameChange = session.active_change.id === args["change-id"];
     session.active_change.id = args["change-id"];
     session.active_change.title = args["new-change"];
-    session.active_change.created_at = now;
-    session.active_change.plan_path = "";
-    session.active_change.epic_id = args["epic-id"] || "";
+    session.active_change.created_at = isSameChange ? session.active_change.created_at || now : now;
+    session.active_change.plan_path = isSameChange ? session.active_change.plan_path || "" : "";
+    session.active_change.epic_id = args["epic-id"] || session.active_change.epic_id || "";
   }
   if (args["set-initialized"]) {
     session.session = session.session || {};

package/dist/types/platform.d.ts

@@ -1,4 +1,4 @@
-export type PlatformId = "claude" | "qoder";
+export type PlatformId = "claude" | "qoder" | "cursor" | "opencode";
 export interface PlatformDef {
     id: PlatformId;
     dir: string;

package/dist/types/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,UAAU,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,SAAS,EAAE,WAAW,EAalC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,UAAU,EAAe,CAAC;AAE1D,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,CAIlE"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,UAAU,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,SAAS,EAAE,WAAW,EAyBlC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,UAAU,EAAe,CAAC;AAE1D,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,CAIlE"}

package/dist/types/platform.js

@@ -11,6 +11,18 @@ export const PLATFORMS = [
         skillDir: ".qoder/skills",
         description: "Qoder IDE",
     },
+    {
+        id: "cursor",
+        dir: ".cursor",
+        skillDir: ".cursor/skills",
+        description: "Cursor IDE",
+    },
+    {
+        id: "opencode",
+        dir: ".opencode",
+        skillDir: ".opencode/skills",
+        description: "Opencode CLI",
+    },
 ];
 export const DEFAULT_PLATFORMS = ["claude"];
 export function getPlatformById(id) {

package/dist/types/platform.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,SAAS,GAAkB;IACtC;QACE,EAAE,EAAE,QAAQ;QACZ,GAAG,EAAE,SAAS;QACd,QAAQ,EAAE,gBAAgB;QAC1B,WAAW,EAAE,+CAA+C;KAC7D;IACD;QACE,EAAE,EAAE,OAAO;QACX,GAAG,EAAE,QAAQ;QACb,QAAQ,EAAE,eAAe;QACzB,WAAW,EAAE,WAAW;KACzB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAiB,CAAC,QAAQ,CAAC,CAAC;AAE1D,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,OAAO,GAAG;SACP,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,SAAS,GAAkB;IACtC;QACE,EAAE,EAAE,QAAQ;QACZ,GAAG,EAAE,SAAS;QACd,QAAQ,EAAE,gBAAgB;QAC1B,WAAW,EAAE,+CAA+C;KAC7D;IACD;QACE,EAAE,EAAE,OAAO;QACX,GAAG,EAAE,QAAQ;QACb,QAAQ,EAAE,eAAe;QACzB,WAAW,EAAE,WAAW;KACzB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,GAAG,EAAE,SAAS;QACd,QAAQ,EAAE,gBAAgB;QAC1B,WAAW,EAAE,YAAY;KAC1B;IACD;QACE,EAAE,EAAE,UAAU;QACd,GAAG,EAAE,WAAW;QAChB,QAAQ,EAAE,kBAAkB;QAC5B,WAAW,EAAE,cAAc;KAC5B;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAiB,CAAC,QAAQ,CAAC,CAAC;AAE1D,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,OAAO,GAAG;SACP,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;AACtD,CAAC"}

package/dist/util/bilingual.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Combine an English string with its Chinese translation into a single
+ * bilingual message. The English text always comes first, separated from the
+ * Chinese text by " / ".
+ *
+ * @example
+ *   bilingual("Install complete", "安装完成") // "Install complete / 安装完成"
+ */
+export declare function bilingual(en: string, zh: string): string;
+//# sourceMappingURL=bilingual.d.ts.map

package/dist/util/bilingual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bilingual.d.ts","sourceRoot":"","sources":["../../src/util/bilingual.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAGxD"}

package/dist/util/bilingual.js

@@ -0,0 +1,14 @@
+/**
+ * Combine an English string with its Chinese translation into a single
+ * bilingual message. The English text always comes first, separated from the
+ * Chinese text by " / ".
+ *
+ * @example
+ *   bilingual("Install complete", "安装完成") // "Install complete / 安装完成"
+ */
+export function bilingual(en, zh) {
+    if (en === zh)
+        return en; // Avoid redundancy when both languages are the same
+    return `${en} / ${zh}`;
+}
+//# sourceMappingURL=bilingual.js.map

package/dist/util/bilingual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bilingual.js","sourceRoot":"","sources":["../../src/util/bilingual.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,EAAU;IAC9C,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC,CAAC,oDAAoD;IAC9E,OAAO,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;AACzB,CAAC"}

package/dist/util/cancel.d.ts

@@ -0,0 +1,2 @@
+export declare function cancelled(): never;
+//# sourceMappingURL=cancel.d.ts.map

package/dist/util/cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../src/util/cancel.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,IAAI,KAAK,CAGjC"}

package/dist/util/cancel.js

@@ -0,0 +1,6 @@
+import * as p from "@clack/prompts";
+export function cancelled() {
+    p.cancel("Cancelled.");
+    throw new Error("Cancelled");
+}
+//# sourceMappingURL=cancel.js.map

package/dist/util/cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.js","sourceRoot":"","sources":["../../src/util/cancel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAEpC,MAAM,UAAU,SAAS;IACvB,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACvB,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;AAC/B,CAAC"}

package/dist/util/color.d.ts

@@ -1,9 +1,12 @@
 export declare const color: {
-    green: (s: string) => string;
-    yellow: (s: string) => string;
-    red: (s: string) => string;
-    cyan: (s: string) => string;
-    gray: (s: string) => string;
-    bold: (s: string) => string;
+    green: import("picocolors/types.js").Formatter;
+    yellow: import("picocolors/types.js").Formatter;
+    red: import("picocolors/types.js").Formatter;
+    cyan: import("picocolors/types.js").Formatter;
+    gray: import("picocolors/types.js").Formatter;
+    bold: import("picocolors/types.js").Formatter;
+    dim: import("picocolors/types.js").Formatter;
+    magenta: import("picocolors/types.js").Formatter;
+    blue: import("picocolors/types.js").Formatter;
 };
 //# sourceMappingURL=color.d.ts.map

package/dist/util/color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/util/color.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,KAAK;eACL,MAAM;gBACL,MAAM;aACT,MAAM;cACL,MAAM;cACN,MAAM;cACN,MAAM;CACjB,CAAC"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/util/color.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK;;;;;;;;;;CAUjB,CAAC"}

package/dist/util/color.js

@@ -1,13 +1,13 @@
-const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
-function wrap(code, text) {
-    return useColor ? `\x1b[${code}m${text}\x1b[0m` : text;
-}
+import pc from "picocolors";
 export const color = {
-    green: (s) => wrap(32, s),
-    yellow: (s) => wrap(33, s),
-    red: (s) => wrap(31, s),
-    cyan: (s) => wrap(36, s),
-    gray: (s) => wrap(90, s),
-    bold: (s) => wrap(1, s),
+    green: pc.green,
+    yellow: pc.yellow,
+    red: pc.red,
+    cyan: pc.cyan,
+    gray: pc.gray,
+    bold: pc.bold,
+    dim: pc.dim,
+    magenta: pc.magenta,
+    blue: pc.blue,
 };
 //# sourceMappingURL=color.js.map

package/dist/util/color.js.map

@@ -1 +1 @@
-{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/util/color.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;AAE/D,SAAS,IAAI,CAAC,IAAY,EAAE,IAAY;IACtC,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAClC,GAAG,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;CAChC,CAAC"}
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/util/color.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,EAAE,CAAC,KAAK;IACf,MAAM,EAAE,EAAE,CAAC,MAAM;IACjB,GAAG,EAAE,EAAE,CAAC,GAAG;IACX,IAAI,EAAE,EAAE,CAAC,IAAI;IACb,IAAI,EAAE,EAAE,CAAC,IAAI;IACb,IAAI,EAAE,EAAE,CAAC,IAAI;IACb,GAAG,EAAE,EAAE,CAAC,GAAG;IACX,OAAO,EAAE,EAAE,CAAC,OAAO;IACnB,IAAI,EAAE,EAAE,CAAC,IAAI;CACd,CAAC"}

package/dist/util/spinner.d.ts

@@ -0,0 +1,8 @@
+import { type Ora } from "ora";
+export type SpinnerHandle = Ora;
+export declare function startSpinner(text: string): SpinnerHandle;
+export declare function withSpinner<T>(text: string, fn: () => Promise<T> | T, options?: {
+    successText?: string;
+    failText?: string;
+}): Promise<T>;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/util/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/util/spinner.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC;AAEhC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAExD;AAED,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,GACL,OAAO,CAAC,CAAC,CAAC,CAUZ"}

package/dist/util/spinner.js

@@ -0,0 +1,17 @@
+import ora from "ora";
+export function startSpinner(text) {
+    return ora({ text, color: "cyan" }).start();
+}
+export async function withSpinner(text, fn, options = {}) {
+    const spinner = startSpinner(text);
+    try {
+        const result = await fn();
+        spinner.succeed(options.successText ?? text);
+        return result;
+    }
+    catch (err) {
+        spinner.fail(options.failText ?? text);
+        throw err;
+    }
+}
+//# sourceMappingURL=spinner.js.map

package/dist/util/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/util/spinner.ts"],"names":[],"mappings":"AAAA,OAAO,GAAiB,MAAM,KAAK,CAAC;AAIpC,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,EAAwB,EACxB,UAGI,EAAE;IAEN,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;QACvC,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/install-manifest.yaml

@@ -17,6 +17,10 @@ generated:
     source: "bundle:sources/scripts/plan-update.js"
   - pattern: ".ai-agents/scripts/epic-update.cjs"
     source: "bundle:sources/scripts/epic-update.js"
+  - pattern: ".ai-agents/scripts/plan-update.md"
+    source: "copy:sources/scripts/plan-update.md"
+  - pattern: ".ai-agents/scripts/epic-update.md"
+    source: "copy:sources/scripts/epic-update.md"
 
 create_once:
   - path: ".ai-agents/config.yaml"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uoyo/mvtt",
-  "version": "2.0.0-beta.6",
+  "version": "2.1.0",
   "description": "My Virtual Tech Team - AI-guided prompt orchestration framework",
   "type": "module",
   "bin": {
@@ -43,15 +43,16 @@
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
-    "@types/prompts": "^2.4.9",
     "@vitest/coverage-v8": "^2.1.9",
     "esbuild": "^0.28.0",
     "typescript": "^5.4.0",
     "vitest": "^2.0.0"
   },
   "dependencies": {
+    "@clack/prompts": "^1.5.1",
     "commander": "^14.0.3",
-    "prompts": "^2.4.2",
+    "ora": "^9.4.0",
+    "picocolors": "^1.1.1",
     "yaml": "^2.4.0"
   },
   "license": "MIT"

package/registry.yaml

@@ -1,72 +1,72 @@
-last_updated: "2026-05-23"
-
-# ============================================================
-# Knowledge
-# Project-keyed map. Each key is a project name;
-# "_all" is the reserved key for entries loaded by all projects and all skills.
-# ============================================================
-knowledge:
-  # _all:
-  #   - id: "core"
-  #     source: "knowledge/core/"
-  #     files_from_manifest: true
-
-# ============================================================
-# Skills
-# ============================================================
-skills:
-  mvt-init:
-    description: "Initialize or refresh a project: scan structure, detect tech stack, infer project type."
-  mvt-status:
-    description: "Display current project and workflow status: skill history, active changes, session state."
-  mvt-config:
-    description: "Manage framework configuration: language, output format, and other settings."
-  mvt-sync-context:
-    description: "Synchronize workspace context with code after manual edits or git operations."
-  mvt-cleanup:
-    description: "Clean up workspace artifacts, summarize completed changes, and archive change records."
-  mvt-analyze:
-    description: "Analyze requirements and extract domain concepts, features, and business rules."
-    template: .ai-agents/skills/_templates/analyze-output.md
-  mvt-analyze-code:
-    description: "Reverse-analyze existing code into project-context.md (terms, modules, layers, rules)."
-    template: .ai-agents/skills/_templates/project-context.md
-  mvt-decompose:
-    description: "Decompose epic-scale requirements into right-sized sub-changes with DAG dependencies."
-    template: .ai-agents/skills/_templates/decompose-output.md
-  mvt-design:
-    description: "Create architecture design from analyzed requirements."
-    template: .ai-agents/skills/_templates/design-output.md
-  mvt-plan-dev:
-    description: "Generate a tracked development plan (plan.yaml) for a large change."
-  mvt-update-plan:
-    description: "Update one task in the active plan.yaml: status, artifacts, notes; auto-advance current_task."
-  mvt-bug-detect:
-    description: "Diagnose a bug (root cause, severity, impact scope) without applying fixes."
-  mvt-implement:
-    description: "Implement features from architecture design; write production code."
-    template: .ai-agents/skills/_templates/implement-output.md
-  mvt-fix:
-    description: "Diagnose and fix bugs or errors in the codebase."
-  mvt-refactor:
-    description: "Refactor existing code while preserving behavior."
-  mvt-quick-dev:
-    description: "Quickly implement small, well-scoped changes (1-3 files) without the full workflow."
-  mvt-review:
-    description: "Review code for quality, standards compliance, and best practices."
-    template: .ai-agents/skills/_templates/review-output.md
-  mvt-test:
-    description: "Generate and design tests to validate implementations."
-    template: .ai-agents/skills/_templates/test-output.md
-  mvt-help:
-    description: "Show available skills, project status, and workflow guidance."
-  mvt-resume:
-    description: "Resume an in-progress task in a new conversation from session.yaml and recent artifacts."
-  mvt-create-skill:
-    description: "Create custom MVTT skills through an interactive guided workflow."
-  mvt-manage-context:
-    description: "Manage knowledge and registry: add (with AI routing), remove, move, rename, list."
-  mvt-check-context:
-    description: "Analyze context token load and provide optimization recommendations."
-  mvt-template:
-    description: "View, customize, and manage output templates for MVTT skills."
+last_updated: "2026-05-23"
+
+# ============================================================
+# Knowledge
+# Project-keyed map. Each key is a project name;
+# "_all" is the reserved key for entries loaded by all projects and all skills.
+# ============================================================
+knowledge:
+  # _all:
+  #   - id: "core"
+  #     source: "knowledge/core/"
+  #     files_from_manifest: true
+
+# ============================================================
+# Skills
+# ============================================================
+skills:
+  mvt-init:
+    description: "Initialize or refresh a project: scan structure, detect tech stack, infer project type."
+  mvt-status:
+    description: "Display current project and workflow status: skill history, active changes, session state."
+  mvt-config:
+    description: "Manage framework configuration: language, output format, and other settings."
+  mvt-sync-context:
+    description: "Synchronize workspace context with code after manual edits or git operations."
+  mvt-cleanup:
+    description: "Clean up workspace artifacts, summarize completed changes, and archive change records."
+  mvt-analyze:
+    description: "Analyze requirements and extract domain concepts, features, and business rules."
+    template: .ai-agents/skills/_templates/analyze-output.md
+  mvt-analyze-code:
+    description: "Reverse-analyze existing code into project-context.md (terms, modules, layers, rules)."
+    template: .ai-agents/skills/_templates/project-context.md
+  mvt-decompose:
+    description: "Decompose epic-scale requirements into right-sized sub-changes with DAG dependencies."
+    template: .ai-agents/skills/_templates/decompose-output.md
+  mvt-design:
+    description: "Create architecture design from analyzed requirements."
+    template: .ai-agents/skills/_templates/design-output.md
+  mvt-plan-dev:
+    description: "Generate a tracked development plan (plan.yaml) for a large change."
+  mvt-update-plan:
+    description: "Update one task in the active plan.yaml: status, artifacts, notes; auto-advance current_task."
+  mvt-bug-detect:
+    description: "Diagnose a bug (root cause, severity, impact scope) without applying fixes."
+  mvt-implement:
+    description: "Implement features from architecture design; write production code."
+    template: .ai-agents/skills/_templates/implement-output.md
+  mvt-fix:
+    description: "Diagnose and fix bugs or errors in the codebase."
+  mvt-refactor:
+    description: "Refactor existing code while preserving behavior."
+  mvt-quick-dev:
+    description: "Quickly implement small, well-scoped changes (1-3 files) without the full workflow."
+  mvt-review:
+    description: "Review code for quality, standards compliance, and best practices."
+    template: .ai-agents/skills/_templates/review-output.md
+  mvt-test:
+    description: "Generate and design tests to validate implementations."
+    template: .ai-agents/skills/_templates/test-output.md
+  mvt-help:
+    description: "Show available skills, project status, and workflow guidance."
+  mvt-resume:
+    description: "Resume an in-progress task in a new conversation from session.yaml and recent artifacts."
+  mvt-create-skill:
+    description: "Create custom MVTT skills through an interactive guided workflow."
+  mvt-manage-context:
+    description: "Manage knowledge and registry: add (with AI routing), remove, move, rename, list."
+  mvt-check-context:
+    description: "Analyze context token load and provide optimization recommendations."
+  mvt-template:
+    description: "View, customize, and manage output templates for MVTT skills."

package/sources/defaults/config.yaml

@@ -20,3 +20,8 @@ preferences:
   history_limits:
     history: 10
     changes: 10
+
+  # Planning granularity for /mvt-plan-dev
+  # Options: coarse (fewer, larger tasks) | medium (balanced) | fine (more, smaller tasks)
+  planning:
+    granularity: medium