@kitsy/coop 2.2.3 → 2.2.4

package/dist/index.js

@@ -44,8 +44,6 @@ var BUILT_IN_NAMING_TOKENS = /* @__PURE__ */ new Set([
   "TYPE",
   "ENTITY",
   "TITLE",
-  "TITLE16",
-  "TITLE24",
   "TRACK",
   "STATUS",
   "TASK_TYPE",
@@ -57,6 +55,10 @@ var BUILT_IN_NAMING_TOKENS = /* @__PURE__ */ new Set([
   "NAME",
   "NAME_SLUG"
 ]);
+function isBuiltInNamingToken(token) {
+  const upper = token.toUpperCase();
+  return BUILT_IN_NAMING_TOKENS.has(upper) || /^TITLE\d{1,2}$/.test(upper);
+}
 var SEMANTIC_STOP_WORDS = /* @__PURE__ */ new Set([
   "A",
   "AN",
@@ -400,7 +402,7 @@ function semanticTitleToken(input2, maxLength = DEFAULT_TITLE_TOKEN_LENGTH) {
   const segments = [];
   let used = 0;
   for (const word of words) {
-    const remaining = safeMaxLength - used - (segments.length > 0 ? 1 : 0);
+    const remaining = safeMaxLength - used;
     if (remaining < 2) {
       break;
     }
@@ -409,7 +411,7 @@ function semanticTitleToken(input2, maxLength = DEFAULT_TITLE_TOKEN_LENGTH) {
       continue;
     }
     segments.push(segment);
-    used += segment.length + (segments.length > 1 ? 1 : 0);
+    used += segment.length;
   }
   if (segments.length > 0) {
     return segments.join("-");
@@ -466,6 +468,7 @@ function buildIdContext(root, config, context) {
     ENTITY: sanitizeTemplateValue(entityType, entityType),
     USER: normalizeIdPart(actor, "USER", 16),
     YYMMDD: shortDateToken(now),
+    TITLE_SOURCE: title,
     TITLE: semanticTitleToken(title, DEFAULT_TITLE_TOKEN_LENGTH),
     TITLE16: semanticTitleToken(title, 16),
     TITLE24: semanticTitleToken(title, 24),
@@ -505,7 +508,11 @@ function replaceTemplateToken(token, contextMap) {
   if (upper === "TYPE" || upper === "ENTITY") return contextMap.TYPE;
   if (upper === "TITLE") return contextMap.TITLE;
   if (/^TITLE\d+$/.test(upper)) {
-    return contextMap[upper] || contextMap.TITLE;
+    const parsed = Number(upper.slice("TITLE".length));
+    if (Number.isInteger(parsed) && parsed > 0) {
+      return semanticTitleToken(contextMap.TITLE_SOURCE ?? "", parsed);
+    }
+    return contextMap.TITLE;
   }
   if (upper === "TRACK") return contextMap.TRACK;
   if (upper === "TASK_TYPE") return contextMap.TASK_TYPE;
@@ -539,6 +546,11 @@ function namingTemplatesForRoot(root) {
 function namingTokensForRoot(root) {
   return readCoopConfig(root).idTokens;
 }
+function requiredCustomNamingTokens(root, entityType) {
+  const config = readCoopConfig(root);
+  const template = config.idNamingTemplates[entityType];
+  return extractTemplateTokens(template).filter((token) => !isBuiltInNamingToken(token)).map((token) => token.toLowerCase());
+}
 function generateStableShortId(root, entityType, primaryId, existingShortIds = []) {
   const config = readCoopConfig(root);
   const digest = crypto.createHash("sha256").update(`${config.projectId}:${entityType}:${primaryId}`).digest("hex").toLowerCase();
@@ -594,7 +606,7 @@ function previewNamingTemplate(template, context, root = process.cwd()) {
   const usedTemplate = template.trim().length > 0 ? template : config.idNamingTemplates[context.entityType];
   const referencedTokens = extractTemplateTokens(usedTemplate);
   for (const token of referencedTokens) {
-    if (!BUILT_IN_NAMING_TOKENS.has(token) && !config.idTokens[token.toLowerCase()]) {
+    if (!isBuiltInNamingToken(token) && !config.idTokens[token.toLowerCase()]) {
       throw new Error(`Naming template references unknown token <${token}>.`);
     }
   }
@@ -612,7 +624,7 @@ function generateConfiguredId(root, existingIds, context) {
   const template = config.idNamingTemplates[context.entityType];
   const referencedTokens = extractTemplateTokens(template);
   for (const token of referencedTokens) {
-    if (BUILT_IN_NAMING_TOKENS.has(token)) {
+    if (isBuiltInNamingToken(token)) {
       continue;
     }
     if (!config.idTokens[token.toLowerCase()]) {
@@ -1037,7 +1049,7 @@ function registerAliasCommand(program) {
     const suffix = result.added.length > 0 ? result.added.join(", ") : "no new aliases";
     console.log(`Updated ${result.target.type} ${result.target.id}: ${suffix}`);
   });
-  alias.command("rm").description("Remove aliases from an item").argument("<idOrAlias>", "Target item id or alias").argument("<aliases...>", "Aliases to remove").action((idOrAlias, aliases) => {
+  alias.command("rm").alias("remove").description("Remove aliases from an item").argument("<idOrAlias>", "Target item id or alias").argument("<aliases...>", "Aliases to remove").action((idOrAlias, aliases) => {
     const root = resolveRepoRoot();
     const result = removeAliases(root, idOrAlias, aliases);
     const suffix = result.removed.length > 0 ? result.removed.join(", ") : "no aliases removed";
@@ -3089,6 +3101,30 @@ function assertKnownDynamicFields(root, fields) {
     }
   }
 }
+async function collectRequiredNamingFields(root, entityType, fields) {
+  const next = { ...fields };
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return next;
+  }
+  const tokens = namingTokensForRoot(root);
+  for (const token of requiredCustomNamingTokens(root, entityType)) {
+    const existing = next[token]?.trim();
+    if (existing) {
+      continue;
+    }
+    const definition = tokens[token];
+    if (definition && definition.values.length > 0) {
+      const choice = await select(
+        `Naming token ${token}`,
+        definition.values.map((value) => ({ label: value, value }))
+      );
+      next[token] = choice;
+      continue;
+    }
+    next[token] = await ask(`Naming token ${token}`);
+  }
+  return next;
+}
 function resolveIdeaFile2(root, idOrAlias) {
   const target = resolveReference(root, idOrAlias, "idea");
   return path8.join(root, ...target.file.split("/"));
@@ -3121,7 +3157,7 @@ function registerCreateCommand(program) {
     const root = resolveRepoRoot();
     const coop = ensureCoopInitialized(root);
     const interactive = Boolean(options.interactive);
-    const dynamicFields = extractDynamicTokenFlags(
+    let dynamicFields = extractDynamicTokenFlags(
       ["create", "task"],
       [
         "id",
@@ -3144,6 +3180,7 @@ function registerCreateCommand(program) {
       ]
     );
     assertKnownDynamicFields(root, dynamicFields);
+    dynamicFields = await collectRequiredNamingFields(root, "task", dynamicFields);
     if (options.fromFile?.trim() || options.stdin) {
       if (options.id || options.from || options.ai || options.title || titleArg || options.type || options.status || options.track || options.delivery || options.priority || options.body || (options.acceptance?.length ?? 0) > 0 || (options.testsRequired?.length ?? 0) > 0 || (options.authorityRef?.length ?? 0) > 0 || (options.derivedRef?.length ?? 0) > 0) {
         throw new Error("Cannot combine --from-file/--stdin with direct task field flags. Use one input mode.");
@@ -3319,11 +3356,12 @@ function registerCreateCommand(program) {
     const root = resolveRepoRoot();
     const coop = ensureCoopInitialized(root);
     const interactive = Boolean(options.interactive);
-    const dynamicFields = extractDynamicTokenFlags(
+    let dynamicFields = extractDynamicTokenFlags(
       ["create", "idea"],
       ["id", "title", "author", "source", "status", "tags", "body", "from-file", "stdin", "interactive"]
     );
     assertKnownDynamicFields(root, dynamicFields);
+    dynamicFields = await collectRequiredNamingFields(root, "idea", dynamicFields);
     if (options.fromFile?.trim() || options.stdin) {
       if (options.id || options.title || titleArg || options.author || options.source || options.status || options.tags || options.body) {
         throw new Error("Cannot combine --from-file/--stdin with direct idea field flags. Use one input mode.");
@@ -3380,11 +3418,12 @@ function registerCreateCommand(program) {
     const root = resolveRepoRoot();
     const coop = ensureCoopInitialized(root);
     const interactive = Boolean(options.interactive);
-    const dynamicFields = extractDynamicTokenFlags(
+    let dynamicFields = extractDynamicTokenFlags(
       ["create", "track"],
       ["id", "name", "profiles", "max-wip", "allowed-types", "interactive"]
     );
     assertKnownDynamicFields(root, dynamicFields);
+    dynamicFields = await collectRequiredNamingFields(root, "track", dynamicFields);
     const name = options.name?.trim() || nameArg?.trim() || await ask("Track name");
     if (!name) throw new Error("Track name is required.");
     const capacityProfiles = unique2(
@@ -3436,7 +3475,7 @@ function registerCreateCommand(program) {
     const root = resolveRepoRoot();
     const coop = ensureCoopInitialized(root);
     const interactive = Boolean(options.interactive);
-    const dynamicFields = extractDynamicTokenFlags(
+    let dynamicFields = extractDynamicTokenFlags(
       ["create", "delivery"],
       [
         "id",
@@ -3455,6 +3494,7 @@ function registerCreateCommand(program) {
       ]
     );
     assertKnownDynamicFields(root, dynamicFields);
+    dynamicFields = await collectRequiredNamingFields(root, "delivery", dynamicFields);
     const user = options.user?.trim() || defaultCoopAuthor(root);
     const config = readCoopConfig(root);
     const auth = load_auth_config2(config.raw);
@@ -3912,14 +3952,18 @@ 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 use reset", purpose: "Clear the user-local working track, delivery, and version defaults." },
         { 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 effective per-entity naming rules, custom tokens, and examples." },
         { usage: 'coop naming preview "Natural-language COOP command recommender" --entity task', purpose: "Preview the generated ID before creating an item." },
-        { usage: "coop naming set task <TYPE>-<TITLE16>-<SEQ>", purpose: "Set one entity's naming template without editing config by hand." },
+        { usage: "coop naming set task <TYPE>-<TITLE8>-<SEQ>", purpose: "Set one entity's naming template without editing config by hand; `TITLE##` supports arbitrary 1-2 digit caps." },
+        { usage: "coop naming reset task", purpose: "Reset one entity's naming template back to the default." },
         { usage: "coop naming token create proj", purpose: "Create a custom naming token." },
-        { usage: "coop naming token value add proj UX", purpose: "Register an allowed value for a naming token." }
+        { usage: "coop naming token remove proj", purpose: "Delete a custom naming token." },
+        { usage: "coop naming token value add proj UX", purpose: "Register an allowed value for a naming token." },
+        { usage: "coop naming token value remove proj UX", purpose: "Remove an allowed value from a naming token." }
       ]
     },
     {
@@ -3994,6 +4038,7 @@ var catalog = {
         { usage: "coop update PM-101 --priority p1 --add-fix-version v2", purpose: "Update task metadata without editing `.coop` files directly." },
         { usage: 'coop comment PM-101 --message "Needs API review"', purpose: "Append a comment to a task." },
         { usage: 'coop log-time PM-101 --hours 2 --kind worked --note "pairing"', purpose: "Append a planned or worked time log to a task." },
+        { usage: "coop alias remove PM-101 PAY.UPI", purpose: "Remove an alias from a task or idea." },
         { usage: "coop plan delivery MVP", purpose: "Run delivery feasibility analysis." },
         { usage: "coop plan delivery MVP --monte-carlo --iterations 5000", purpose: "Run probabilistic delivery forecasting." },
         { usage: "coop view velocity", purpose: "Show historical throughput." },
@@ -4080,7 +4125,9 @@ function renderTopicPayload(topic) {
       "Use `coop naming` to inspect per-entity templates, custom tokens, and examples.",
       'Use `coop naming preview "<title>" --entity <entity>` before creating a new item if predictable IDs matter.',
       "Use `coop naming set <entity> <template>` to update one entity's naming rule.",
-      "Use `coop naming token create <token>` and `coop naming token value add <token> <value>` before passing custom token flags like `--proj UX`."
+      "Built-in title tokens support `TITLE##` with a 1-2 digit cap, such as `TITLE18`, `TITLE12`, `TITLE8`, `TITLE08`, `TITLE4`, or `TITLE02`.",
+      "Use `coop naming reset <entity>` to revert one entity back to the default naming template.",
+      "Use `coop naming token create <token>`, `coop naming token remove <token>`, and `coop naming token value add|remove <token> <value>` before passing custom token flags like `--proj UX`."
     ]
   };
 }
@@ -6071,8 +6118,7 @@ function printNamingOverview() {
   console.log("Built-in tokens:");
   console.log("  <TYPE>     entity type such as IDEA, TASK, DELIVERY");
   console.log("  <TITLE>    semantic title token (defaults to TITLE16)");
-  console.log("  <TITLE16>  semantic title token capped to 16 chars");
-  console.log("  <TITLE24>  semantic title token capped to 24 chars");
+  console.log("  <TITLE##>  semantic title token capped to the numeric suffix, e.g. TITLE18, TITLE8, or TITLE08");
   console.log("  <TRACK>    task track");
   console.log("  <NAME>     entity name/title");
   console.log("  <NAME_SLUG> lower-case slug of the entity name");
@@ -6107,7 +6153,7 @@ function printNamingOverview() {
   }, root)}`);
   console.log("Try:");
   console.log(`  coop naming preview "${sampleTitle}"`);
-  console.log("  coop naming set task <TYPE>-<TITLE24>-<SEQ>");
+  console.log("  coop naming set task <TYPE>-<TITLE8>-<SEQ>");
   console.log("  coop naming token create proj");
   console.log("  coop naming token value add proj UX");
 }
@@ -6126,6 +6172,17 @@ function setEntityNamingTemplate(root, entity, template) {
     return next;
   });
 }
+function resetEntityNamingTemplate(root, entity) {
+  writeNamingConfig(root, (config) => {
+    const next = { ...config };
+    const idRaw = typeof next.id === "object" && next.id !== null ? { ...next.id } : {};
+    const namingRaw = typeof idRaw.naming === "object" && idRaw.naming !== null ? { ...idRaw.naming } : typeof idRaw.naming === "string" ? { task: idRaw.naming, idea: idRaw.naming } : {};
+    namingRaw[entity] = DEFAULT_NAMING_TEMPLATES[entity];
+    idRaw.naming = namingRaw;
+    next.id = idRaw;
+    return next;
+  });
+}
 function ensureTokenRecord(config) {
   const next = { ...config };
   const idRaw = typeof next.id === "object" && next.id !== null ? { ...next.id } : {};
@@ -6187,6 +6244,12 @@ function registerNamingCommand(program) {
     setEntityNamingTemplate(root, assertNamingEntity(entity), template);
     console.log(`${assertNamingEntity(entity)}=${namingTemplatesForRoot(root)[assertNamingEntity(entity)]}`);
   });
+  naming.command("reset").description("Reset the naming template for one entity type to the default").argument("<entity>", "Entity: task|idea|track|delivery|run").action((entity) => {
+    const root = resolveRepoRoot();
+    const resolved = assertNamingEntity(entity);
+    resetEntityNamingTemplate(root, resolved);
+    console.log(`${resolved}=${namingTemplatesForRoot(root)[resolved]}`);
+  });
   const token = naming.command("token").description("Manage custom naming tokens");
   token.command("list").description("List naming tokens").action(() => {
     listTokens();
@@ -6223,7 +6286,7 @@ function registerNamingCommand(program) {
     });
     console.log(`Renamed naming token: ${normalizedToken} -> ${normalizedNext}`);
   });
-  token.command("delete").description("Delete a custom naming token").argument("<token>", "Token name").action((tokenName) => {
+  token.command("delete").alias("remove").alias("rm").description("Delete a custom naming token").argument("<token>", "Token name").action((tokenName) => {
     const root = resolveRepoRoot();
     const normalizedToken = normalizeNamingTokenName(tokenName);
     writeNamingConfig(root, (config) => {
@@ -8731,16 +8794,18 @@ 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 use track <id>` / `coop use delivery <id>` / `coop use reset`: manage working scope defaults",
     "- `coop list tracks` / `coop list deliveries`: inspect valid named values before assigning them",
     "- `coop naming`: inspect per-entity ID rules and naming tokens",
-    '- `coop naming preview "Title" --entity task`: preview the generated ID before creating an item',
+    '- `coop naming preview "Title" --entity task`: preview the generated ID before creating an item; templates support `TITLE##` like `TITLE18`, `TITLE8`, or `TITLE08`',
+    "- `coop naming reset task`: reset one entity's naming template to the default",
     "- `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",
     "- `coop update <id> --track <id> --delivery <id>`: update task metadata",
     '- `coop comment <id> --message "..."`: append a task comment',
     "- `coop log-time <id> --hours 2 --kind worked`: append time spent",
+    "- `coop alias remove <id> <alias>`: remove a shorthand alias from a task or idea",
     "- `coop review task <id>` / `coop complete task <id>`: move work through lifecycle",
     "- `coop help-ai --initial-prompt --strict --repo C:/path/to/repo --delivery MVP --command coop.cmd`: hand off COOP context to an agent",
     "",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kitsy/coop",
   "description": "COOP command-line interface.",
-  "version": "2.2.3",
+  "version": "2.2.4",
   "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.3",
-    "@kitsy/coop-ui": "^2.2.3",
-    "@kitsy/coop-core": "2.2.3"
+    "@kitsy/coop-ai": "2.2.4",
+    "@kitsy/coop-core": "2.2.4",
+    "@kitsy/coop-ui": "^2.2.4"
   },
   "devDependencies": {
     "@types/node": "^24.12.0",