@kitsy/coop 2.2.1 → 2.2.2

package/dist/index.js

@@ -1391,6 +1391,7 @@ import fs3 from "fs";
 import path3 from "path";
 import {
   effective_priority,
+  parseYamlFile as parseYamlFile2,
   parseDeliveryFile,
   parseIdeaFile as parseIdeaFile2,
   parseTaskFile as parseTaskFile4,
@@ -1399,6 +1400,76 @@ import {
   validateSemantic,
   writeTask as writeTask3
 } from "@kitsy/coop-core";
+function existingTrackMap(root) {
+  const map = /* @__PURE__ */ new Map();
+  for (const filePath of listTrackFiles(root)) {
+    const track = parseYamlFile2(filePath);
+    if (track.id?.trim()) {
+      map.set(track.id.trim().toLowerCase(), track.id.trim());
+    }
+  }
+  return map;
+}
+function existingDeliveryMap(root) {
+  const map = /* @__PURE__ */ new Map();
+  for (const filePath of listDeliveryFiles(root)) {
+    const delivery = parseDeliveryFile(filePath).delivery;
+    if (delivery.id?.trim()) {
+      map.set(delivery.id.trim().toLowerCase(), delivery.id.trim());
+    }
+  }
+  return map;
+}
+function resolveExistingTrackId(root, trackId) {
+  const normalized = trackId.trim().toLowerCase();
+  if (!normalized) return void 0;
+  if (normalized === "unassigned") return "unassigned";
+  return existingTrackMap(root).get(normalized);
+}
+function resolveExistingDeliveryId(root, deliveryId) {
+  const normalized = deliveryId.trim().toLowerCase();
+  if (!normalized) return void 0;
+  return existingDeliveryMap(root).get(normalized);
+}
+function assertExistingTrackId(root, trackId) {
+  const resolved = resolveExistingTrackId(root, trackId);
+  if (resolved) {
+    return resolved;
+  }
+  throw new Error(
+    `Unknown track '${trackId}'. Create it first with \`coop create track --id ${trackId} --name "${trackId}"\` or use \`unassigned\`.`
+  );
+}
+function assertExistingDeliveryId(root, deliveryId) {
+  const resolved = resolveExistingDeliveryId(root, deliveryId);
+  if (resolved) {
+    return resolved;
+  }
+  throw new Error(`Unknown delivery '${deliveryId}'. Create it first with \`coop create delivery --id ${deliveryId} --name "${deliveryId}"\`.`);
+}
+function unique(values) {
+  return Array.from(new Set(values));
+}
+function normalizeTaskReferences(root, task) {
+  const next = { ...task };
+  if (next.track?.trim()) {
+    next.track = assertExistingTrackId(root, next.track.trim());
+  }
+  if (next.delivery?.trim()) {
+    next.delivery = assertExistingDeliveryId(root, next.delivery.trim());
+  }
+  if (next.delivery_tracks?.length) {
+    next.delivery_tracks = unique(next.delivery_tracks.map((trackId) => assertExistingTrackId(root, trackId)));
+  }
+  if (next.priority_context && typeof next.priority_context === "object") {
+    const normalized = {};
+    for (const [trackId, priority] of Object.entries(next.priority_context)) {
+      normalized[assertExistingTrackId(root, trackId)] = priority;
+    }
+    next.priority_context = normalized;
+  }
+  return next;
+}
 function resolveTaskFile(root, idOrAlias) {
   const reference = resolveReference(root, idOrAlias, "task");
   return path3.join(root, ...reference.file.split("/"));
@@ -1419,17 +1490,19 @@ function writeIdeaFile(filePath, parsed, idea, body = parsed.body) {
   const output2 = stringifyFrontmatter2({ ...parsed.raw, ...idea }, body);
   fs3.writeFileSync(filePath, output2, "utf8");
 }
-function validateTaskForWrite(task, filePath) {
-  const structuralIssues = validateStructural2(task, { filePath });
-  const semanticIssues = validateSemantic(task);
+function validateTaskForWrite(root, task, filePath) {
+  const normalized = normalizeTaskReferences(root, task);
+  const structuralIssues = validateStructural2(normalized, { filePath });
+  const semanticIssues = validateSemantic(normalized);
   const errors = [...structuralIssues, ...semanticIssues].filter((issue) => issue.level === "error");
   if (errors.length > 0) {
     throw new Error(errors.map((issue) => `- ${issue.message}`).join("\n"));
   }
+  return normalized;
 }
-function writeTaskEntry(filePath, parsed, task, body = parsed.body) {
-  validateTaskForWrite(task, filePath);
-  writeTask3(task, {
+function writeTaskEntry(root, filePath, parsed, task, body = parsed.body) {
+  const normalized = validateTaskForWrite(root, task, filePath);
+  writeTask3(normalized, {
     body,
     raw: parsed.raw,
     filePath
@@ -1613,10 +1686,12 @@ function configDefaultVersion(root) {
 }
 function resolveSelectionOptions(root, options) {
   const context = readWorkingContext(root, resolveCoopHome());
+  const track = options.track?.trim() || context.track?.trim() || configDefaultTrack(root);
+  const delivery = options.delivery?.trim() || context.delivery?.trim() || configDefaultDelivery(root);
   return {
     ...options,
-    track: options.track?.trim() || context.track?.trim() || configDefaultTrack(root),
-    delivery: options.delivery?.trim() || context.delivery?.trim() || configDefaultDelivery(root),
+    track: track ? resolveExistingTrackId(root, track) ?? track : void 0,
+    delivery: delivery ? resolveExistingDeliveryId(root, delivery) ?? delivery : void 0,
     version: options.version?.trim() || context.version?.trim() || configDefaultVersion(root)
   };
 }
@@ -1885,7 +1960,7 @@ function registerCommentCommand(program) {
     const root = resolveRepoRoot();
     const { filePath, parsed } = loadTaskEntry(root, id);
     const task = appendTaskComment(parsed.task, options.author?.trim() || defaultCoopAuthor(root), options.message.trim());
-    writeTaskEntry(filePath, parsed, task);
+    writeTaskEntry(root, filePath, parsed, task);
     console.log(`Commented ${task.id}`);
   });
 }
@@ -2137,7 +2212,6 @@ import {
   parseTaskFile as parseTaskFile7,
   writeYamlFile as writeYamlFile3,
   stringifyFrontmatter as stringifyFrontmatter4,
-  validateStructural as validateStructural5,
   writeTask as writeTask6
 } from "@kitsy/coop-core";
 import { create_provider_idea_decomposer, decompose_idea_to_tasks } from "@kitsy/coop-ai";
@@ -2166,7 +2240,7 @@ function renderSelect(question, choices, selected) {
     process2.stdout.write(` ${prefix} ${choice.label}${hint}
 `);
   }
-  process2.stdout.write("\nUse \u2191/\u2193 to choose, Enter to confirm.\n");
+  process2.stdout.write("\nUse Up/Down arrows to choose, Enter to confirm.\n");
 }
 function moveCursorUp(lines) {
   if (lines <= 0) return;
@@ -2182,7 +2256,9 @@ async function select(question, choices, defaultIndex = 0) {
   }
   readline.emitKeypressEvents(process2.stdin);
   const previousRawMode = process2.stdin.isRaw;
+  const wasPaused = typeof process2.stdin.isPaused === "function" ? process2.stdin.isPaused() : false;
   process2.stdin.setRawMode(true);
+  process2.stdin.resume();
   let selected = Math.min(Math.max(defaultIndex, 0), choices.length - 1);
   const renderedLines = choices.length + 2;
   renderSelect(question, choices, selected);
@@ -2190,6 +2266,9 @@ async function select(question, choices, defaultIndex = 0) {
     const cleanup = () => {
       process2.stdin.off("keypress", onKeypress);
       process2.stdin.setRawMode(previousRawMode ?? false);
+      if (wasPaused) {
+        process2.stdin.pause();
+      }
       process2.stdout.write("\n");
     };
     const rerender = () => {
@@ -2631,7 +2710,7 @@ function plusDaysIso(days) {
   date.setUTCDate(date.getUTCDate() + days);
   return date.toISOString().slice(0, 10);
 }
-function unique(values) {
+function unique2(values) {
   return Array.from(new Set(values));
 }
 function resolveIdeaFile2(root, idOrAlias) {
@@ -2639,7 +2718,7 @@ function resolveIdeaFile2(root, idOrAlias) {
   return path8.join(root, ...target.file.split("/"));
 }
 function updateIdeaLinkedTasks(filePath, idea, raw, body, linked) {
-  const next = unique([...idea.linked_tasks ?? [], ...linked]).sort((a, b) => a.localeCompare(b));
+  const next = unique2([...idea.linked_tasks ?? [], ...linked]).sort((a, b) => a.localeCompare(b));
   const nextRaw = {
     ...raw,
     linked_tasks: next
@@ -2654,10 +2733,10 @@ function makeTaskDraft(input2) {
     track: input2.track,
     priority: input2.priority,
     body: input2.body,
-    acceptance: unique(input2.acceptance ?? []),
-    testsRequired: unique(input2.testsRequired ?? []),
-    authorityRefs: unique(input2.authorityRefs ?? []),
-    derivedRefs: unique(input2.derivedRefs ?? [])
+    acceptance: unique2(input2.acceptance ?? []),
+    testsRequired: unique2(input2.testsRequired ?? []),
+    authorityRefs: unique2(input2.authorityRefs ?? []),
+    derivedRefs: unique2(input2.derivedRefs ?? [])
   };
 }
 function registerCreateCommand(program) {
@@ -2691,10 +2770,10 @@ function registerCreateCommand(program) {
     const priority = options.priority?.trim() || (interactive ? await ask("Priority", "p2") : "p2");
     const delivery = options.delivery?.trim() || (interactive ? await ask("Delivery (optional)", "") : "");
     const body = options.body ?? (interactive ? await ask("Task body (optional)", "") : "");
-    const acceptance = options.acceptance && options.acceptance.length > 0 ? unique(options.acceptance) : interactive ? parseCsv(await ask("Acceptance criteria (comma-separated, optional)", "")) : [];
-    const testsRequired = options.testsRequired && options.testsRequired.length > 0 ? unique(options.testsRequired) : interactive ? parseCsv(await ask("Tests required (comma-separated, optional)", "")) : [];
-    const authorityRefs = options.authorityRef && options.authorityRef.length > 0 ? unique(options.authorityRef) : interactive ? parseCsv(await ask("Authority refs (comma-separated, optional)", "")) : [];
-    const derivedRefs = options.derivedRef && options.derivedRef.length > 0 ? unique(options.derivedRef) : interactive ? parseCsv(await ask("Derived refs (comma-separated, optional)", "")) : [];
+    const acceptance = options.acceptance && options.acceptance.length > 0 ? unique2(options.acceptance) : interactive ? parseCsv(await ask("Acceptance criteria (comma-separated, optional)", "")) : [];
+    const testsRequired = options.testsRequired && options.testsRequired.length > 0 ? unique2(options.testsRequired) : interactive ? parseCsv(await ask("Tests required (comma-separated, optional)", "")) : [];
+    const authorityRefs = options.authorityRef && options.authorityRef.length > 0 ? unique2(options.authorityRef) : interactive ? parseCsv(await ask("Authority refs (comma-separated, optional)", "")) : [];
+    const derivedRefs = options.derivedRef && options.derivedRef.length > 0 ? unique2(options.derivedRef) : interactive ? parseCsv(await ask("Derived refs (comma-separated, optional)", "")) : [];
     const date = todayIsoDate();
     const drafts = [];
     let sourceIdeaPath = null;
@@ -2810,13 +2889,8 @@ function registerCreateCommand(program) {
         } : void 0
       };
       const filePath = path8.join(coop, "tasks", `${id}.md`);
-      const structuralIssues = validateStructural5(task, { filePath });
-      if (structuralIssues.length > 0) {
-        const message = structuralIssues.map((issue) => `- ${issue.message}`).join("\n");
-        throw new Error(`Task failed structural validation:
-${message}`);
-      }
-      writeTask6(task, {
+      const normalizedTask = validateTaskForWrite(root, task, filePath);
+      writeTask6(normalizedTask, {
         body: draft.body,
         filePath
       });
@@ -2892,7 +2966,7 @@ ${message}`);
     const interactive = Boolean(options.interactive);
     const name = options.name?.trim() || nameArg?.trim() || await ask("Track name");
     if (!name) throw new Error("Track name is required.");
-    const capacityProfiles = unique(
+    const capacityProfiles = unique2(
       options.profiles ? parseCsv(options.profiles) : interactive ? parseCsv(await ask("Capacity profiles (comma-separated)", "backend_team")) : ["backend_team"]
     );
     const maxWipInput = options.maxWip?.trim() || (interactive ? await ask("Max concurrent tasks", "6") : "6");
@@ -2900,7 +2974,7 @@ ${message}`);
     if (typeof maxWip !== "number" || maxWip <= 0 || !Number.isInteger(maxWip)) {
       throw new Error("max-wip must be a positive integer.");
     }
-    const allowed = unique(
+    const allowed = unique2(
       options.allowedTypes ? parseCsv(options.allowedTypes).map((entry) => entry.toLowerCase()) : interactive ? parseCsv(await ask("Allowed types (comma-separated)", "feature,bug,chore,spike")).map(
         (entry) => entry.toLowerCase()
       ) : ["feature", "bug", "chore", "spike"]
@@ -2982,7 +3056,7 @@ ${message}`);
       options.budgetCost?.trim() || (interactive ? await ask("Budget cost USD (optional)", "") : void 0),
       "budget-cost"
     );
-    const capacityProfiles = unique(
+    const capacityProfiles = unique2(
       options.profiles ? parseCsv(options.profiles) : interactive ? parseCsv(await ask("Capacity profiles (comma-separated)", "backend_team")) : ["backend_team"]
     );
     const tasks = listTaskFiles(root).map((filePath2) => {
@@ -2995,12 +3069,12 @@ ${message}`);
         console.log(`- ${task.id}: ${task.title}`);
       }
     }
-    const scopeInclude = unique(
+    const scopeInclude = unique2(
       options.scope ? parseCsv(options.scope).map((value) => value.toUpperCase()) : interactive ? parseCsv(await ask("Scope include task IDs (comma-separated)", tasks.map((task) => task.id).join(","))).map(
         (value) => value.toUpperCase()
       ) : []
     );
-    const scopeExclude = unique(
+    const scopeExclude = unique2(
       options.exclude ? parseCsv(options.exclude).map((value) => value.toUpperCase()) : interactive ? parseCsv(await ask("Scope exclude task IDs (comma-separated)", "")).map((value) => value.toUpperCase()) : []
     );
     const knownTaskIds = new Set(tasks.map((task) => task.id));
@@ -3336,6 +3410,7 @@ var catalog = {
   selection_rules: [
     "Use `coop project show` first to confirm the active workspace and project.",
     "Use `coop use show` to inspect the current user-local working defaults for track, delivery, and version.",
+    "Before assigning `track` or `delivery` values to tasks, inspect or create named entities with `coop list tracks`, `coop list deliveries`, `coop create track`, and `coop create delivery`.",
     "Use `coop graph next --delivery <delivery>` or `coop next task` to choose work. Do not reprioritize outside COOP unless the user explicitly overrides it.",
     "Commands resolve selection scope from: explicit CLI arg, then `coop use` working context, then shared project defaults.",
     "Use `--track` for the workstream lens (home track or delivery_tracks). Use `--delivery` for release/scope membership.",
@@ -3393,6 +3468,8 @@ var catalog = {
         { usage: "coop use track <id>", purpose: "Set the default working track for commands that can infer scope." },
         { usage: "coop use delivery <id>", purpose: "Set the default working delivery for commands that need delivery scope." },
         { usage: "coop use version <id>", purpose: "Set the default working version for promotion and prompt generation." },
+        { usage: "coop list tracks", purpose: "List valid named tracks before assigning or updating task track values." },
+        { usage: "coop list deliveries", purpose: "List valid named deliveries before assigning or updating task delivery values." },
         { usage: "coop current", purpose: "Show the active project, working context, my active tasks, and the next ready task." },
         { usage: "coop naming", purpose: "Explain the current naming template, tokens, and examples." },
         { usage: 'coop naming preview "Natural-language COOP command recommender"', purpose: "Preview a semantic ID before creating an item." }
@@ -3407,6 +3484,7 @@ var catalog = {
         { usage: "cat idea.md | coop create idea --stdin", purpose: "Ingest an idea draft from stdin." },
         { usage: 'coop create task "Implement webhook pipeline"', purpose: "Create a task with defaults." },
         { usage: 'coop create task --title "Lock auth contract" --track MVP --delivery MVP', purpose: "Create a task directly inside a track and delivery scope." },
+        { usage: "coop create track --id mvp --name MVP", purpose: "Create a named track before tasks refer to it." },
         {
           usage: 'coop create task --title "Lock auth contract" --acceptance "Contract approved,Client mapping documented" --tests-required "Contract fixture test" --authority-ref docs/webapp-mvp-plan.md#auth',
           purpose: "Create a planning-grade task with acceptance, tests, and origin refs."
@@ -3450,6 +3528,8 @@ var catalog = {
       description: "Read backlog state, task details, and planning output.",
       commands: [
         { usage: "coop list tasks --status todo", purpose: "List tasks with filters." },
+        { usage: "coop list tracks", purpose: "List valid named tracks." },
+        { usage: "coop list deliveries", purpose: "List valid named deliveries." },
         { usage: "coop list tasks --track MVP --delivery MVP --ready --columns id,title,p,assignee,score", purpose: "List ready tasks with lean columns and score visible." },
         { usage: "coop list tasks --mine", purpose: "List tasks assigned to the current default COOP author." },
         { usage: 'coop search "auth and login form"', purpose: "Run deterministic non-AI search across tasks, ideas, and deliveries." },
@@ -3834,11 +3914,11 @@ function resolveHelpTopic(options) {
   if (options.naming) {
     requestedTopics.push("naming");
   }
-  const unique3 = [...new Set(requestedTopics)];
-  if (unique3.length > 1) {
-    throw new Error(`Specify only one focused help-ai topic at a time. Received: ${unique3.join(", ")}.`);
+  const unique4 = [...new Set(requestedTopics)];
+  if (unique4.length > 1) {
+    throw new Error(`Specify only one focused help-ai topic at a time. Received: ${unique4.join(", ")}.`);
   }
-  const topic = unique3[0];
+  const topic = unique4[0];
   if (topic !== void 0 && topic !== "state-transitions" && topic !== "artifacts" && topic !== "post-execution" && topic !== "selection" && topic !== "naming") {
     throw new Error(`Unsupported help-ai topic '${topic}'. Expected state-transitions|artifacts|post-execution|selection|naming.`);
   }
@@ -3904,7 +3984,7 @@ import { CURRENT_SCHEMA_VERSION, write_schema_version } from "@kitsy/coop-core";
 import fs8 from "fs";
 import path11 from "path";
 import { spawnSync as spawnSync3 } from "child_process";
-import { detect_cycle, parseTaskContent, parseTaskFile as parseTaskFile8, validateStructural as validateStructural6 } from "@kitsy/coop-core";
+import { detect_cycle, parseTaskContent, parseTaskFile as parseTaskFile8, validateStructural as validateStructural5 } from "@kitsy/coop-core";
 var HOOK_BLOCK_START = "# COOP_PRE_COMMIT_START";
 var HOOK_BLOCK_END = "# COOP_PRE_COMMIT_END";
 function runGit(repoRoot, args, allowFailure = false) {
@@ -3988,7 +4068,7 @@ function parseStagedTasks(repoRoot, relativePaths) {
       errors.push(`[COOP] ${message}`);
       continue;
     }
-    const issues = validateStructural6(task, { filePath: absolutePath });
+    const issues = validateStructural5(task, { filePath: absolutePath });
     for (const issue of issues) {
       errors.push(`[COOP] ${relativePath}: ${issue.message}`);
     }
@@ -4643,9 +4723,48 @@ import {
   parseDeliveryFile as parseDeliveryFile2,
   parseIdeaFile as parseIdeaFile4,
   parseTaskFile as parseTaskFile10,
+  parseYamlFile as parseYamlFile3,
   schedule_next as schedule_next3
 } from "@kitsy/coop-core";
 import chalk2 from "chalk";
+var TASK_COLUMN_WIDTHS = {
+  id: 24,
+  title: 30,
+  status: 12,
+  priority: 4,
+  assignee: 16,
+  track: 16,
+  delivery: 16,
+  score: 6,
+  file: 30
+};
+var IDEA_COLUMN_WIDTHS = {
+  id: 24,
+  title: 30,
+  status: 12,
+  file: 30
+};
+function truncateCell(value, maxWidth) {
+  if (maxWidth <= 0 || value.length <= maxWidth) {
+    return value;
+  }
+  if (maxWidth <= 3) {
+    return value.slice(0, maxWidth);
+  }
+  return `${value.slice(0, maxWidth - 3)}...`;
+}
+function truncateMiddleCell(value, maxWidth) {
+  if (maxWidth <= 0 || value.length <= maxWidth) {
+    return value;
+  }
+  if (maxWidth <= 3) {
+    return value.slice(0, maxWidth);
+  }
+  const available = maxWidth - 3;
+  const head = Math.ceil(available / 2);
+  const tail = Math.floor(available / 2);
+  return `${value.slice(0, head)}...${value.slice(value.length - tail)}`;
+}
 function statusColor(status) {
   switch (status) {
     case "done":
@@ -4884,8 +5003,16 @@ function listTasks(options) {
   ensureCoopInitialized(root);
   const context = readWorkingContext(root, resolveCoopHome());
   const graph = load_graph6(coopDir(root));
-  const resolvedTrack = resolveContextValueWithSource(options.track, context.track);
-  const resolvedDelivery = resolveContextValueWithSource(options.delivery, context.delivery);
+  const rawResolvedTrack = resolveContextValueWithSource(options.track, context.track);
+  const rawResolvedDelivery = resolveContextValueWithSource(options.delivery, context.delivery);
+  const resolvedTrack = {
+    ...rawResolvedTrack,
+    value: rawResolvedTrack.value ? resolveExistingTrackId(root, rawResolvedTrack.value) ?? rawResolvedTrack.value : void 0
+  };
+  const resolvedDelivery = {
+    ...rawResolvedDelivery,
+    value: rawResolvedDelivery.value ? resolveExistingDeliveryId(root, rawResolvedDelivery.value) ?? rawResolvedDelivery.value : void 0
+  };
   const resolvedVersion = resolveContextValueWithSource(options.version, context.version);
   const assignee = options.mine ? defaultCoopAuthor(root) : options.assignee?.trim();
   const deliveryScope = resolvedDelivery.value ? new Set(graph.deliveries.get(resolvedDelivery.value)?.scope.include ?? []) : null;
@@ -4942,27 +5069,30 @@ function listTasks(options) {
       columns.map(taskColumnHeader),
       sorted.map(
         (entry) => columns.map((column) => {
-          switch (column) {
-            case "title":
-              return entry.title;
-            case "status":
-              return statusColor(entry.status);
-            case "priority":
-              return entry.priority;
-            case "assignee":
-              return entry.assignee;
-            case "track":
-              return entry.track;
-            case "delivery":
-              return entry.delivery;
-            case "score":
-              return scoreMap.has(entry.id) ? scoreMap.get(entry.id).toFixed(1) : "-";
-            case "file":
-              return path15.relative(root, entry.filePath);
-            case "id":
-            default:
-              return entry.id;
-          }
+          const rawValue = (() => {
+            switch (column) {
+              case "title":
+                return entry.title;
+              case "status":
+                return statusColor(entry.status);
+              case "priority":
+                return entry.priority;
+              case "assignee":
+                return entry.assignee;
+              case "track":
+                return entry.track;
+              case "delivery":
+                return entry.delivery;
+              case "score":
+                return scoreMap.has(entry.id) ? scoreMap.get(entry.id).toFixed(1) : "-";
+              case "file":
+                return path15.relative(root, entry.filePath);
+              case "id":
+              default:
+                return entry.id;
+            }
+          })();
+          return column === "file" ? truncateMiddleCell(rawValue, TASK_COLUMN_WIDTHS[column]) : truncateCell(rawValue, TASK_COLUMN_WIDTHS[column]);
         })
       )
     )
@@ -5012,17 +5142,8 @@ function listIdeas(options) {
       columns.map(ideaColumnHeader),
       sorted.map(
         (entry) => columns.map((column) => {
-          switch (column) {
-            case "title":
-              return entry.title;
-            case "status":
-              return statusColor(entry.status);
-            case "file":
-              return path15.relative(root, entry.filePath);
-            case "id":
-            default:
-              return entry.id;
-          }
+          const rawValue = column === "title" ? entry.title : column === "status" ? statusColor(entry.status) : column === "file" ? path15.relative(root, entry.filePath) : entry.id;
+          return column === "file" ? truncateMiddleCell(rawValue, IDEA_COLUMN_WIDTHS[column]) : truncateCell(rawValue, IDEA_COLUMN_WIDTHS[column]);
         })
       )
     )
@@ -5033,11 +5154,11 @@ Total ideas: ${sorted.length}`);
 function listDeliveries() {
   const root = resolveRepoRoot();
   const rows = listDeliveryFiles(root).map((filePath) => ({ delivery: parseDeliveryFile2(filePath).delivery, filePath })).map(({ delivery, filePath }) => [
-    delivery.id,
-    delivery.name,
-    statusColor(delivery.status),
-    delivery.target_date ?? "-",
-    path15.relative(root, filePath)
+    truncateCell(delivery.id, 24),
+    truncateCell(delivery.name, 30),
+    truncateCell(statusColor(delivery.status), 12),
+    truncateCell(delivery.target_date ?? "-", 16),
+    truncateMiddleCell(path15.relative(root, filePath), 30)
   ]);
   if (rows.length === 0) {
     console.log("No deliveries found.");
@@ -5045,6 +5166,21 @@ function listDeliveries() {
   }
   console.log(formatTable(["ID", "Name", "Status", "Target", "File"], rows));
 }
+function listTracks() {
+  const root = resolveRepoRoot();
+  const rows = listTrackFiles(root).map((filePath) => ({ track: parseYamlFile3(filePath), filePath })).sort((a, b) => a.track.id.localeCompare(b.track.id)).map(({ track, filePath }) => [
+    truncateCell(track.id, 24),
+    truncateCell(track.name, 30),
+    truncateCell((track.capacity_profiles ?? []).join(", ") || "-", 24),
+    truncateCell(String(track.constraints?.max_concurrent_tasks ?? "-"), 8),
+    truncateMiddleCell(path15.relative(root, filePath), 30)
+  ]);
+  if (rows.length === 0) {
+    console.log("No tracks found.");
+    return;
+  }
+  console.log(formatTable(["ID", "Name", "Profiles", "Max WIP", "File"], rows));
+}
 function registerListCommand(program) {
   const list = program.command("list").description("List COOP entities");
   list.command("tasks").description("List tasks").option("--status <status>", "Filter by status").option("--track <track>", "Filter by home/contributing track lens, using `coop use track` if omitted").option("--delivery <delivery>", "Filter by delivery membership, using `coop use delivery` if omitted").option("--priority <priority>", "Filter by effective priority").option("--assignee <assignee>", "Filter by assignee").option("--version <version>", "Filter by fix/released version, using `coop use version` if omitted").option("--mine", "Filter to the current default COOP author").option("--ready", "Only list ready tasks in scored order").option("--sort <sort>", "Sort by id|priority|status|title|updated|created|score").option("--columns <columns>", "Columns: id,title,status,priority,assignee,track,delivery,score,file or all").action((options) => {
@@ -5056,7 +5192,10 @@ function registerListCommand(program) {
   list.command("alias").description("List aliases").argument("[pattern]", "Wildcard pattern, e.g. PAY*").action((pattern) => {
     listAliasRows(pattern);
   });
-  list.command("deliveries").description("List deliveries").action(() => {
+  list.command("tracks").alias("track").description("List tracks").action(() => {
+    listTracks();
+  });
+  list.command("deliveries").alias("delivery").description("List deliveries").action(() => {
     listDeliveries();
   });
 }
@@ -5191,7 +5330,7 @@ function registerLogTimeCommand(program) {
       hours,
       options.note?.trim() || void 0
     );
-    writeTaskEntry(filePath, parsed, task);
+    writeTaskEntry(root, filePath, parsed, task);
     console.log(`Logged ${hours}h ${options.kind} on ${task.id}`);
   });
 }
@@ -5201,7 +5340,7 @@ import fs12 from "fs";
 import path17 from "path";
 import { createInterface } from "readline/promises";
 import { stdin as input, stdout as output } from "process";
-import { CURRENT_SCHEMA_VERSION as CURRENT_SCHEMA_VERSION2, IndexManager as IndexManager3, migrate_repository, parseYamlFile as parseYamlFile2, writeYamlFile as writeYamlFile4 } from "@kitsy/coop-core";
+import { CURRENT_SCHEMA_VERSION as CURRENT_SCHEMA_VERSION2, IndexManager as IndexManager3, migrate_repository, parseYamlFile as parseYamlFile4, writeYamlFile as writeYamlFile4 } from "@kitsy/coop-core";
 var COOP_IGNORE_TEMPLATE2 = `.index/
 logs/
 tmp/
@@ -5368,7 +5507,7 @@ async function migrateWorkspaceLayout(root, options) {
   }
   const movedConfigPath = path17.join(projectRoot, "config.yml");
   if (fs12.existsSync(movedConfigPath)) {
-    const movedConfig = parseYamlFile2(movedConfigPath);
+    const movedConfig = parseYamlFile4(movedConfigPath);
     const nextProject = typeof movedConfig.project === "object" && movedConfig.project !== null ? { ...movedConfig.project } : {};
     nextProject.name = identity.projectName;
     nextProject.id = projectId;
@@ -5763,7 +5902,7 @@ function registerPromoteCommand(program) {
       track: resolvedTrack.value,
       version: resolvedVersion.value
     });
-    writeTaskEntry(filePath, parsed, task);
+    writeTaskEntry(root, filePath, parsed, task);
     console.log(`Promoted ${task.id}`);
   });
 }
@@ -7012,7 +7151,7 @@ function maybePromote(root, taskId, options) {
     track: options.track ?? context.track,
     version: options.version ?? context.version
   });
-  writeTaskEntry(filePath, parsed, promoted);
+  writeTaskEntry(root, filePath, parsed, promoted);
   console.log(`Promoted ${promoted.id}`);
 }
 function printResolvedSelectionContext(root, options) {
@@ -7224,7 +7363,7 @@ import { IdeaStatus as IdeaStatus3, TaskPriority as TaskPriority3, TaskStatus as
 function collect(value, previous = []) {
   return [...previous, value];
 }
-function unique2(items) {
+function unique3(items) {
   return [...new Set(items.map((item) => item.trim()).filter(Boolean))];
 }
 function removeValues(source, values) {
@@ -7234,7 +7373,7 @@ function removeValues(source, values) {
   return next.length > 0 ? next : void 0;
 }
 function addValues(source, values) {
-  const next = unique2([...source ?? [], ...values ?? []]);
+  const next = unique3([...source ?? [], ...values ?? []]);
   return next.length > 0 ? next : void 0;
 }
 function loadBody(options) {
@@ -7316,13 +7455,13 @@ function updateTask(id, options) {
     tests_required: addValues(removeValues(next.tests_required, options.testsRemove), options.testsAdd)
   };
   next = clearTrackPriorityOverrides(applyTrackPriorityOverrides(next, options.priorityIn), options.clearPriorityIn);
-  validateTaskForWrite(next, filePath);
+  next = validateTaskForWrite(root, next, filePath);
   const nextBody = loadBody(options) ?? parsed.body;
   if (options.dryRun) {
     console.log(renderTaskPreview(next, nextBody).trimEnd());
     return;
   }
-  writeTaskEntry(filePath, parsed, next, nextBody);
+  writeTaskEntry(root, filePath, parsed, next, nextBody);
   console.log(`Updated ${next.id}`);
 }
 function updateIdea(id, options) {
@@ -7392,11 +7531,19 @@ function registerUseCommand(program) {
   });
   use.command("track").description("Set the default working track").argument("<id>", "Track id").action((id) => {
     const root = resolveRepoRoot();
-    printContext(updateWorkingContext(root, resolveCoopHome(), { track: id }));
+    const trackId = resolveExistingTrackId(root, id);
+    if (!trackId) {
+      throw new Error(`Unknown track '${id}'. Create it first with \`coop create track --id ${id} --name "${id}"\` or use \`unassigned\`.`);
+    }
+    printContext(updateWorkingContext(root, resolveCoopHome(), { track: trackId }));
   });
   use.command("delivery").description("Set the default working delivery").argument("<id>", "Delivery id").action((id) => {
     const root = resolveRepoRoot();
-    printContext(updateWorkingContext(root, resolveCoopHome(), { delivery: id }));
+    const deliveryId = resolveExistingDeliveryId(root, id);
+    if (!deliveryId) {
+      throw new Error(`Unknown delivery '${id}'. Create it first with \`coop create delivery --id ${id} --name "${id}"\`.`);
+    }
+    printContext(updateWorkingContext(root, resolveCoopHome(), { delivery: deliveryId }));
   });
   use.command("version").description("Set the default working version").argument("<id>", "Version label").action((id) => {
     const root = resolveRepoRoot();
@@ -7887,6 +8034,7 @@ function renderBasicHelp() {
     "Day-to-day commands:",
     "- `coop current`: show working context, active work, and the next ready task",
     "- `coop use track <id>` / `coop use delivery <id>`: set working scope defaults",
+    "- `coop list tracks` / `coop list deliveries`: inspect valid named values before assigning them",
     "- `coop next task` or `coop pick task`: choose work from COOP",
     "- `coop show <id>`: inspect a task, idea, or delivery",
     "- `coop list tasks --track <id>`: browse scoped work",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kitsy/coop",
   "description": "COOP command-line interface.",
-  "version": "2.2.1",
+  "version": "2.2.2",
   "license": "MIT",
   "type": "module",
   "publishConfig": {
@@ -39,9 +39,9 @@
     "chalk": "^5.6.2",
     "commander": "^14.0.0",
     "octokit": "^5.0.5",
-    "@kitsy/coop-ai": "2.2.1",
-    "@kitsy/coop-ui": "^2.2.1",
-    "@kitsy/coop-core": "2.2.1"
+    "@kitsy/coop-core": "2.2.2",
+    "@kitsy/coop-ai": "2.2.2",
+    "@kitsy/coop-ui": "^2.2.2"
   },
   "devDependencies": {
     "@types/node": "^24.12.0",