@uoyo/mvtt 2.0.0-beta.4 → 2.0.0-beta.6

package/dist/scripts/plan-update.cjs

@@ -7316,9 +7316,36 @@ var require_dist = __commonJS({
 
 // sources/scripts/plan-update.js
 var import_node_fs = require("node:fs");
+var import_node_path = require("node:path");
 var import_yaml = __toESM(require_dist(), 1);
+function findProjectRootFromPath(filePath) {
+  let dir = (0, import_node_path.resolve)((0, import_node_path.dirname)(filePath));
+  while (true) {
+    if ((0, import_node_fs.existsSync)((0, import_node_path.join)(dir, ".ai-agents"))) return dir;
+    const parent = (0, import_node_path.dirname)(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+function loadSoleProject(projectRoot) {
+  if (!projectRoot) return null;
+  const ctxPath = (0, import_node_path.join)(projectRoot, ".ai-agents/workspace/project-context.yaml");
+  if (!(0, import_node_fs.existsSync)(ctxPath)) return null;
+  try {
+    const ctx = (0, import_yaml.parse)((0, import_node_fs.readFileSync)(ctxPath, "utf-8"));
+    const projects = ctx?.projects;
+    if (!Array.isArray(projects) || projects.length !== 1) return null;
+    const name = projects[0]?.name;
+    if (typeof name !== "string" || name === "") return null;
+    return [name];
+  } catch {
+    return null;
+  }
+}
 var VALID_STATUSES = ["pending", "in_progress", "done", "blocked", "skipped"];
 var TERMINAL_STATUSES = ["done", "blocked", "skipped"];
+var PROJECT_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9_-]*$/;
+var VALID_FRESHNESS = ["current", "stale"];
 var ERRORS = {
   MISSING_PLAN: () => "Missing required argument: --plan",
   MISSING_TASK: () => "Missing required argument: --task",
@@ -7329,37 +7356,42 @@ var ERRORS = {
   TASK_NOT_FOUND: (id, valid) => `Task "${id}" not found. Valid task ids: ${valid.length ? valid.join(", ") : "(none)"}.`,
   VALIDATION_FAILED: (errs) => `Plan validation failed; file not written:
   - ${errs.join("\n  - ")}`,
-  PLAN_WRITE_FAILED: (detail) => `Failed to write plan.yaml: ${detail}`
+  PLAN_WRITE_FAILED: (detail) => `Failed to write plan.yaml: ${detail}`,
+  INVALID_PROJECT_NAME: (name) => `Invalid project name "${name}". Must match ${PROJECT_NAME_RE.source} (no leading underscore).`,
+  INVALID_TASK_PROJECT: (taskId, proj, valid) => `Task "${taskId}" has project "${proj}" not in --projects list: ${valid.join(", ")}.`,
+  INVALID_FRESHNESS: (taskId, val) => `Task "${taskId}" has invalid deliverables.freshness "${val}". Must be one of: ${VALID_FRESHNESS.join(", ")}.`,
+  STALE_TASK_NOT_FOUND: (id, valid) => `--mark-deliverable-stale task "${id}" not found. Valid task ids: ${valid.length ? valid.join(", ") : "(none)"}.`,
+  INVALID_DELIVERABLES_POINTER: (val) => `Invalid --deliverables-pointer "${val}". Only "current" is supported.`
 };
 function parseArgs(argv) {
-  const args = {};
+  const args2 = {};
   for (let i = 2; i < argv.length; i++) {
     if (argv[i].startsWith("--")) {
       const key = argv[i].slice(2);
       const next = argv[i + 1];
       if (next && !next.startsWith("--")) {
-        args[key] = next;
+        args2[key] = next;
         i++;
       } else {
-        args[key] = true;
+        args2[key] = true;
       }
     }
   }
-  return args;
+  return args2;
 }
-function validateArgs(args) {
-  if (!args.plan || args.plan === true) return ERRORS.MISSING_PLAN();
-  if (!args.task || args.task === true) return ERRORS.MISSING_TASK();
-  if (!args.status || args.status === true) return ERRORS.MISSING_STATUS();
-  if (!VALID_STATUSES.includes(args.status)) return ERRORS.INVALID_STATUS(args.status);
+function validateArgs(args2) {
+  if (!args2.plan || args2.plan === true) return ERRORS.MISSING_PLAN();
+  if (!args2.task || args2.task === true) return ERRORS.MISSING_TASK();
+  if (!args2.status || args2.status === true) return ERRORS.MISSING_STATUS();
+  if (!VALID_STATUSES.includes(args2.status)) return ERRORS.INVALID_STATUS(args2.status);
   return null;
 }
-function applyUpdate(plan, args, now) {
-  const task = plan.tasks.find((t) => t.id === args.task);
+function applyUpdate(plan, args2, now) {
+  const task = plan.tasks.find((t) => t.id === args2.task);
   const oldStatus = task.status;
-  task.status = args.status;
-  if (args.artifacts && args.artifacts !== true) {
-    const incoming = args.artifacts.split(",").map((s) => s.trim()).filter(Boolean);
+  task.status = args2.status;
+  if (args2.artifacts && args2.artifacts !== true) {
+    const incoming = args2.artifacts.split(",").map((s) => s.trim()).filter(Boolean);
     if (incoming.length) {
       if (!task.artifacts || typeof task.artifacts !== "object") {
         task.artifacts = { files: [] };
@@ -7376,48 +7408,110 @@ function applyUpdate(plan, args, now) {
       }
     }
   }
-  if (args.notes && args.notes !== true) {
-    task.notes = args.notes;
+  if (args2.notes && args2.notes !== true) {
+    task.notes = args2.notes;
+  }
+  if (args2.status === "done" && !task.completed_at) {
+    task.completed_at = now;
+  } else if (args2.status !== "done") {
+    task.completed_at = null;
+  }
+  if (args2["deliverables-pointer"] && args2["deliverables-pointer"] !== true) {
+    if (args2["deliverables-pointer"] !== "current") {
+      return { error: ERRORS.INVALID_DELIVERABLES_POINTER(args2["deliverables-pointer"]) };
+    }
+    task.deliverables = { freshness: "current" };
+  }
+  if (args2["mark-deliverable-stale"] && args2["mark-deliverable-stale"] !== true) {
+    const staleIds = args2["mark-deliverable-stale"].split(",").map((s) => s.trim()).filter(Boolean);
+    for (const staleTaskId of staleIds) {
+      const staleTask = plan.tasks.find((t) => t.id === staleTaskId);
+      if (staleTask) {
+        if (!staleTask.deliverables || typeof staleTask.deliverables !== "object") {
+          staleTask.deliverables = { freshness: "stale" };
+        } else {
+          staleTask.deliverables.freshness = "stale";
+        }
+      }
+    }
   }
-  task.completed_at = args.status === "done" ? now : null;
   plan.updated_at = now;
-  return { id: task.id, title: task.title || "", old_status: oldStatus, new_status: args.status };
+  return { id: task.id, title: task.title || "", old_status: oldStatus, new_status: args2.status };
 }
-function recomputeCurrentTask(plan, changedTaskId) {
+function recomputeCurrentTasks(plan, changedTaskId, projectList) {
   let warning = null;
   const changedTask = plan.tasks.find((t) => t.id === changedTaskId);
   const changedToTerminal = changedTask && TERMINAL_STATUSES.includes(changedTask.status);
-  const activeInProgress = plan.tasks.find(
-    (t) => t.status === "in_progress" && !(t.id === changedTaskId && changedToTerminal)
-  );
-  if (activeInProgress) {
-    plan.current_task = activeInProgress.id;
-    plan.status = "in_progress";
-    return { warning };
-  }
-  const doneIds = new Set(
-    plan.tasks.filter((t) => t.status === "done").map((t) => t.id)
+  const priorActiveProjects = new Set(
+    Object.keys(plan.current_tasks || {})
   );
-  const nextPending = plan.tasks.find(
-    (t) => t.status === "pending" && (t.depends_on || []).every((d) => doneIds.has(d))
+  const resolvedIds = new Set(
+    plan.tasks.filter((t) => t.status === "done" || t.status === "skipped").map((t) => t.id)
   );
-  if (nextPending) {
-    nextPending.status = "in_progress";
-    plan.current_task = nextPending.id;
-    plan.status = "in_progress";
-    return { warning };
+  const projects = projectList && projectList.length > 0 ? projectList : loadSoleProject(findProjectRootFromPath(args.plan)) || ["default"];
+  const currentTasks = {};
+  for (const proj of projects) {
+    const inProgressForProject = plan.tasks.filter(
+      (t) => t.status === "in_progress" && getTaskProjects(t).includes(proj)
+    );
+    if (inProgressForProject.length > 0) {
+      currentTasks[proj] = inProgressForProject[0].id;
+      continue;
+    }
+    const nextPending = plan.tasks.find(
+      (t) => t.status === "pending" && getTaskProjects(t).includes(proj) && (t.depends_on || []).every((d) => resolvedIds.has(d))
+    );
+    if (nextPending) {
+      nextPending.status = "in_progress";
+      currentTasks[proj] = nextPending.id;
+    }
   }
-  if (plan.tasks.every((t) => t.status === "done")) {
+  let switchNotification = null;
+  if (changedToTerminal && changedTask) {
+    const newActiveProjects = new Set(Object.keys(currentTasks));
+    const newlyActive = [...newActiveProjects].filter((p) => !priorActiveProjects.has(p));
+    if (newlyActive.length > 0) {
+      switchNotification = {
+        project_switch: {
+          from: [...priorActiveProjects].filter((p) => !newActiveProjects.has(p)),
+          to: newlyActive
+        }
+      };
+    }
+  }
+  const allDone = plan.tasks.every((t) => t.status === "done");
+  const anyInProgress = plan.tasks.some((t) => t.status === "in_progress");
+  const anyPending = plan.tasks.some((t) => t.status === "pending");
+  if (allDone) {
     plan.status = "done";
-    plan.current_task = null;
-    return { warning };
+    plan.current_tasks = {};
+  } else {
+    plan.current_tasks = currentTasks;
+    if (anyInProgress || Object.keys(currentTasks).length > 0) {
+      plan.status = "in_progress";
+    } else if (anyPending) {
+      plan.status = "in_progress";
+      warning = "All remaining tasks are blocked by dependencies; resolve a blocker before continuing.";
+    }
   }
-  plan.current_task = null;
-  plan.status = "in_progress";
-  warning = "All remaining tasks are blocked by dependencies; resolve a blocker before continuing.";
-  return { warning };
+  return { warning, project_switch: switchNotification };
 }
-function validatePlan(plan) {
+function getTaskProjects(task) {
+  if (Array.isArray(task.project) && task.project.length > 0) {
+    return task.project;
+  }
+  return ["default"];
+}
+function deriveProjectList(tasks) {
+  const projects = /* @__PURE__ */ new Set();
+  for (const t of tasks) {
+    for (const p of getTaskProjects(t)) {
+      projects.add(p);
+    }
+  }
+  return [...projects];
+}
+function validatePlan(plan, projectList) {
   const errors = [];
   const tasks = Array.isArray(plan.tasks) ? plan.tasks : [];
   const ids = tasks.map((t) => t.id);
@@ -7433,15 +7527,38 @@ function validatePlan(plan) {
       }
     }
   }
-  const cycle = findCycle(tasks);
+  const cycle = findCycle(tasks, projectList);
   if (cycle) {
     errors.push(`Dependency cycle detected: ${cycle.join(" -> ")}`);
   }
-  const inProgress = tasks.filter((t) => t.status === "in_progress");
-  if (inProgress.length > 1) {
-    errors.push(
-      `More than one task is in_progress: ${inProgress.map((t) => t.id).join(", ")}`
+  const projects = projectList && projectList.length > 0 ? projectList : loadSoleProject(findProjectRootFromPath(args.plan)) || ["default"];
+  for (const proj of projects) {
+    const inProgressForProject = tasks.filter(
+      (t) => t.status === "in_progress" && getTaskProjects(t).includes(proj)
     );
+    if (inProgressForProject.length > 1) {
+      errors.push(
+        `More than one task is in_progress for project "${proj}": ${inProgressForProject.map((t) => t.id).join(", ")}`
+      );
+    }
+  }
+  if (projectList && projectList.length > 0) {
+    for (const t of tasks) {
+      if (Array.isArray(t.project)) {
+        for (const p of t.project) {
+          if (!projectList.includes(p)) {
+            errors.push(ERRORS.INVALID_TASK_PROJECT(t.id, p, projectList));
+          }
+        }
+      }
+    }
+  }
+  if (projectList && projectList.length > 0) {
+    for (const p of projectList) {
+      if (!PROJECT_NAME_RE.test(p)) {
+        errors.push(ERRORS.INVALID_PROJECT_NAME(p));
+      }
+    }
   }
   for (const t of tasks) {
     if (!Array.isArray(t.acceptance) || t.acceptance.length === 0) {
@@ -7453,27 +7570,63 @@ function validatePlan(plan) {
       errors.push(`Task "${t.id}" is not done but has completed_at set`);
     }
   }
+  for (const t of tasks) {
+    if (t.deliverables && typeof t.deliverables === "object") {
+      if (!VALID_FRESHNESS.includes(t.deliverables.freshness)) {
+        errors.push(ERRORS.INVALID_FRESHNESS(t.id, t.deliverables.freshness));
+      }
+    }
+  }
   if (plan.status === "done") {
-    if (plan.current_task != null) {
-      errors.push("plan.status is done but current_task is not null");
-    }
-  } else if (plan.current_task != null) {
-    const ct = tasks.find((t) => t.id === plan.current_task);
-    if (!ct) {
-      errors.push(`current_task "${plan.current_task}" does not reference a task`);
-    } else if (ct.status !== "pending" && ct.status !== "in_progress") {
-      errors.push(
-        `current_task "${plan.current_task}" has status "${ct.status}" (must be pending or in_progress)`
-      );
+    if (plan.current_tasks && Object.keys(plan.current_tasks).length > 0) {
+      errors.push("plan.status is done but current_tasks is not empty");
+    }
+  } else if (plan.current_tasks && typeof plan.current_tasks === "object") {
+    for (const [proj, taskId] of Object.entries(plan.current_tasks)) {
+      const ct = tasks.find((t) => t.id === taskId);
+      if (!ct) {
+        errors.push(`current_tasks["${proj}"] = "${taskId}" does not reference a task`);
+      } else if (ct.status !== "pending" && ct.status !== "in_progress") {
+        errors.push(
+          `current_tasks["${proj}"] = "${taskId}" has status "${ct.status}" (must be pending or in_progress)`
+        );
+      }
     }
   }
   return errors;
 }
-function findCycle(tasks) {
+function findCycle(tasks, projectList) {
+  if (!projectList || projectList.length <= 1) {
+    return findCycleInSubgraph(tasks, tasks.map((t) => t.id));
+  }
+  const taskMap = new Map(tasks.map((t) => [t.id, t]));
+  for (const proj of projectList) {
+    const idSet = new Set(
+      tasks.filter((t) => getTaskProjects(t).includes(proj)).map((t) => t.id)
+    );
+    const queue = [...idSet];
+    for (const id of queue) {
+      for (const dep of taskMap.get(id)?.depends_on || []) {
+        if (!idSet.has(dep)) {
+          idSet.add(dep);
+          queue.push(dep);
+        }
+      }
+    }
+    const cycle = findCycleInSubgraph(tasks, [...idSet]);
+    if (cycle) return cycle;
+  }
+  return null;
+}
+function findCycleInSubgraph(tasks, taskIds) {
+  const idSet = new Set(taskIds);
   const adj = /* @__PURE__ */ new Map();
-  for (const t of tasks) adj.set(t.id, t.depends_on || []);
+  for (const t of tasks) {
+    if (!idSet.has(t.id)) continue;
+    adj.set(t.id, (t.depends_on || []).filter((d) => idSet.has(d)));
+  }
   const WHITE = 0, GRAY = 1, BLACK = 2;
-  const color = new Map(tasks.map((t) => [t.id, WHITE]));
+  const color = new Map(taskIds.map((id) => [id, WHITE]));
   const stack = [];
   function dfs(node) {
     color.set(node, GRAY);
@@ -7493,28 +7646,28 @@ function findCycle(tasks) {
     color.set(node, BLACK);
     return null;
   }
-  for (const t of tasks) {
-    if (color.get(t.id) === WHITE) {
-      const found = dfs(t.id);
+  for (const id of taskIds) {
+    if (color.get(id) === WHITE) {
+      const found = dfs(id);
       if (found) return found;
     }
   }
   return null;
 }
 function main() {
-  const args = parseArgs(process.argv);
-  const argErr = validateArgs(args);
+  const args2 = parseArgs(process.argv);
+  const argErr = validateArgs(args2);
   if (argErr) {
     process.stderr.write(argErr + "\n");
     process.exit(1);
   }
-  if (!(0, import_node_fs.existsSync)(args.plan)) {
-    process.stderr.write(ERRORS.PLAN_NOT_FOUND(args.plan) + "\n");
+  if (!(0, import_node_fs.existsSync)(args2.plan)) {
+    process.stderr.write(ERRORS.PLAN_NOT_FOUND(args2.plan) + "\n");
     process.exit(1);
   }
   let plan;
   try {
-    plan = (0, import_yaml.parse)((0, import_node_fs.readFileSync)(args.plan, "utf-8"));
+    plan = (0, import_yaml.parse)((0, import_node_fs.readFileSync)(args2.plan, "utf-8"));
   } catch (e) {
     process.stderr.write(ERRORS.PLAN_PARSE_FAILED(e.message) + "\n");
     process.exit(1);
@@ -7523,24 +7676,43 @@ function main() {
     process.stderr.write(ERRORS.PLAN_PARSE_FAILED("missing tasks[]") + "\n");
     process.exit(1);
   }
-  if (!plan.tasks.some((t) => t.id === args.task)) {
+  if (!plan.tasks.some((t) => t.id === args2.task)) {
     process.stderr.write(
-      ERRORS.TASK_NOT_FOUND(args.task, plan.tasks.map((t) => t.id)) + "\n"
+      ERRORS.TASK_NOT_FOUND(args2.task, plan.tasks.map((t) => t.id)) + "\n"
     );
     process.exit(1);
   }
+  let projectList = null;
+  if (args2.projects && args2.projects !== true) {
+    projectList = args2.projects.split(",").map((s) => s.trim()).filter(Boolean);
+  } else {
+    projectList = deriveProjectList(plan.tasks);
+  }
+  if (plan.current_task != null && (!plan.current_tasks || typeof plan.current_tasks !== "object")) {
+    plan.current_tasks = { default: plan.current_task };
+  }
+  if ("current_task" in plan) {
+    delete plan.current_task;
+  }
+  if (!plan.current_tasks) {
+    plan.current_tasks = {};
+  }
   const now = (/* @__PURE__ */ new Date()).toISOString();
-  const taskChange = applyUpdate(plan, args, now);
-  const { warning } = recomputeCurrentTask(plan, args.task);
-  const validationErrors = validatePlan(plan);
+  const taskChange = applyUpdate(plan, args2, now);
+  if (taskChange.error) {
+    process.stderr.write(taskChange.error + "\n");
+    process.exit(1);
+  }
+  const { warning, project_switch: switchNotif } = recomputeCurrentTasks(plan, args2.task, projectList);
+  const validationErrors = validatePlan(plan, projectList);
   if (validationErrors.length) {
     process.stderr.write(ERRORS.VALIDATION_FAILED(validationErrors) + "\n");
     process.exit(1);
   }
-  const tmpPath = args.plan + ".tmp";
+  const tmpPath = args2.plan + ".tmp";
   try {
-    (0, import_node_fs.writeFileSync)(tmpPath, (0, import_yaml.stringify)(plan), "utf-8");
-    (0, import_node_fs.renameSync)(tmpPath, args.plan);
+    (0, import_node_fs.writeFileSync)(tmpPath, (0, import_yaml.stringify)(plan, { lineWidth: 200 }), "utf-8");
+    (0, import_node_fs.renameSync)(tmpPath, args2.plan);
   } catch (e) {
     try {
       if ((0, import_node_fs.existsSync)(tmpPath)) (0, import_node_fs.unlinkSync)(tmpPath);
@@ -7553,10 +7725,11 @@ function main() {
   const result = {
     ok: true,
     task: taskChange,
-    current_task: plan.current_task ?? null,
+    current_tasks: plan.current_tasks,
     plan_status: plan.status,
     progress: { done: doneCount, total: plan.tasks.length },
-    warning
+    ...warning ? { warning } : {},
+    ...switchNotif ? switchNotif : {}
   };
   process.stdout.write(JSON.stringify(result) + "\n");
 }

package/dist/scripts/session-update.cjs

@@ -7326,7 +7326,11 @@ var ERRORS = {
   NO_SESSION_YAML: () => "session.yaml not found. Run /mvt-init first to initialize the project.",
   SESSION_PARSE_FAILED: (detail) => `Failed to parse session.yaml: ${detail}. Check the file for syntax errors.`,
   SESSION_WRITE_FAILED: (detail) => `Failed to write session.yaml: ${detail}`,
-  CONFIG_LIMIT_INVALID: (key, val, min, max, fallback) => `Warning: config history_limits.${key} value "${val}" is invalid (must be integer ${min}-${max}). Using default ${fallback}.`
+  CONFIG_LIMIT_INVALID: (key, val, min, max, fallback) => `Warning: config history_limits.${key} value "${val}" is invalid (must be integer ${min}-${max}). Using default ${fallback}.`,
+  EPIC_ID_REQUIRED: () => "--new-epic requires --epic-id",
+  CLOSE_NEW_EPIC_CONFLICT: () => "--close-epic and --new-epic are mutually exclusive",
+  NO_ACTIVE_EPIC: (flag) => `${flag} requires an active epic (active_epic.id is empty)`,
+  EPIC_ID_ORPHAN: () => "--epic-id (for sub-change) requires --new-change"
 };
 var DEFAULT_LIMITS = {
   history: 20,
@@ -7388,6 +7392,9 @@ function validate(args) {
   if (!args.skill) return ERRORS.MISSING_SKILL();
   if (!args.summary) return ERRORS.MISSING_SUMMARY();
   if (args["new-change"] && !args["change-id"]) return ERRORS.CHANGE_ID_REQUIRED();
+  if (args["new-epic"] && !args["epic-id"]) return ERRORS.EPIC_ID_REQUIRED();
+  if (args["close-epic"] && args["new-epic"]) return ERRORS.CLOSE_NEW_EPIC_CONFLICT();
+  if (args["epic-id"] && !args["new-change"] && !args["new-epic"]) return ERRORS.EPIC_ID_ORPHAN();
   return null;
 }
 function main() {
@@ -7440,7 +7447,8 @@ function main() {
         title: session.active_change.title || "",
         plan_path: session.active_change.plan_path || "",
         status: "active",
-        updated_at: now
+        updated_at: now,
+        epic_id: session.active_change.epic_id || ""
       };
       if (existingIdx >= 0) {
         session.changes[existingIdx] = snapshotEntry;
@@ -7456,6 +7464,7 @@ function main() {
     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"] || "";
   }
   if (args["set-initialized"]) {
     session.session = session.session || {};
@@ -7482,7 +7491,8 @@ function main() {
       title: ac.title || "",
       plan_path: ac.plan_path || "",
       status: "active",
-      updated_at: now
+      updated_at: now,
+      epic_id: ac.epic_id || ""
     };
     if (existingIdx >= 0) {
       session.changes[existingIdx] = entry;
@@ -7508,7 +7518,8 @@ function main() {
         title: ac.title || "",
         plan_path: ac.plan_path || "",
         status: "done",
-        updated_at: now
+        updated_at: now,
+        epic_id: ac.epic_id || ""
       };
       if (existingIdx >= 0) {
         session.changes[existingIdx] = entry;
@@ -7526,7 +7537,8 @@ function main() {
       id: "",
       title: "",
       created_at: "",
-      plan_path: ""
+      plan_path: "",
+      epic_id: ""
     };
   }
   if (args["set-change-status"]) {
@@ -7551,9 +7563,75 @@ function main() {
       }
     }
   }
+  if (args["new-epic"]) {
+    session.active_epic = session.active_epic || {};
+    if (session.active_epic.id) {
+      session.epics = session.epics || [];
+      const existingIdx = session.epics.findIndex(
+        (e) => e.id === session.active_epic.id
+      );
+      const snapshotEntry = {
+        id: session.active_epic.id,
+        title: session.active_epic.title || "",
+        epic_path: session.active_epic.epic_path || "",
+        status: "active",
+        updated_at: now
+      };
+      if (existingIdx >= 0) {
+        session.epics[existingIdx] = snapshotEntry;
+      } else {
+        session.epics.push(snapshotEntry);
+      }
+    }
+    session.active_epic.id = args["epic-id"];
+    session.active_epic.title = args["new-epic"];
+    session.active_epic.created_at = now;
+    session.active_epic.epic_path = "";
+  }
+  if (args["set-epic-path"]) {
+    session.active_epic = session.active_epic || {};
+    if (!session.active_epic.id && !args["new-epic"]) {
+      process.stderr.write(ERRORS.NO_ACTIVE_EPIC("--set-epic-path") + "\n");
+      process.exit(1);
+    }
+    session.active_epic.epic_path = args["set-epic-path"];
+  }
+  if (args["set-epic-status"]) {
+    session.active_epic = session.active_epic || {};
+    if (!session.active_epic.id && !args["new-epic"]) {
+      process.stderr.write(ERRORS.NO_ACTIVE_EPIC("--set-epic-status") + "\n");
+      process.exit(1);
+    }
+    session.epics = session.epics || [];
+    const epicIdx = session.epics.findIndex(
+      (e) => e.id === session.active_epic.id
+    );
+    if (epicIdx >= 0) {
+      session.epics[epicIdx].status = args["set-epic-status"];
+      session.epics[epicIdx].updated_at = now;
+    }
+  }
+  if (args["close-epic"]) {
+    session.epics = session.epics || [];
+    session.active_epic = session.active_epic || {};
+    const aeId = session.active_epic.id;
+    if (aeId) {
+      const epicIdx = session.epics.findIndex((e) => e.id === aeId);
+      if (epicIdx >= 0) {
+        session.epics[epicIdx].status = "done";
+        session.epics[epicIdx].updated_at = now;
+      }
+    }
+    session.active_epic = {
+      id: "",
+      title: "",
+      created_at: "",
+      epic_path: ""
+    };
+  }
   const tmpPath = sessionPath + ".tmp";
   try {
-    (0, import_node_fs.writeFileSync)(tmpPath, (0, import_yaml.stringify)(session), "utf-8");
+    (0, import_node_fs.writeFileSync)(tmpPath, (0, import_yaml.stringify)(session, { lineWidth: 200 }), "utf-8");
     (0, import_node_fs.renameSync)(tmpPath, sessionPath);
   } catch (e) {
     try {

package/dist/types/platform.d.ts

@@ -0,0 +1,12 @@
+export type PlatformId = "claude" | "qoder";
+export interface PlatformDef {
+    id: PlatformId;
+    dir: string;
+    skillDir: string;
+    description: string;
+}
+export declare const PLATFORMS: PlatformDef[];
+export declare const DEFAULT_PLATFORMS: PlatformId[];
+export declare function getPlatformById(id: string): PlatformDef | undefined;
+export declare function getPlatformsByIds(ids: PlatformId[]): PlatformDef[];
+//# sourceMappingURL=platform.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/platform.js

@@ -0,0 +1,24 @@
+export const PLATFORMS = [
+    {
+        id: "claude",
+        dir: ".claude",
+        skillDir: ".claude/skills",
+        description: "Claude Code / Claude Desktop / Github Copilot",
+    },
+    {
+        id: "qoder",
+        dir: ".qoder",
+        skillDir: ".qoder/skills",
+        description: "Qoder IDE",
+    },
+];
+export const DEFAULT_PLATFORMS = ["claude"];
+export function getPlatformById(id) {
+    return PLATFORMS.find((p) => p.id === id);
+}
+export function getPlatformsByIds(ids) {
+    return ids
+        .map((id) => getPlatformById(id))
+        .filter((p) => p !== undefined);
+}
+//# sourceMappingURL=platform.js.map

package/dist/types/platform.js.map

@@ -0,0 +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"}