@mosse-ai/cli 0.1.1 → 0.1.3

package/dist/index.js

@@ -21397,7 +21397,7 @@ var BoardUpdateTask = defineCapability({
   id: "board.update_task",
   summary: "Update task fields.",
   usageRules: [
-    "expectedUpdatedAt guards status/assignee/reviewer/dueDate/todos; always pass it. Others: last-write-wins, reread first. todos/acceptanceChecks REPLACE the whole list (max 50 each): read full/fields; retain items with IDs, new items without IDs; omissions delete. Tick via {{board.check_todo}}. Unchecked todos block review/done. Project completion/review rules apply. Done: {{board.reopen_task}} first.",
+    "expectedUpdatedAt guards status/assignee/reviewer/due fields; always pass it. Others: last-write-wins, reread first. todos/acceptanceChecks REPLACE the whole list (max 50 each): read full/fields; retain items with IDs, new items without IDs; omissions delete. Tick via {{board.check_todo}}. Unchecked todos block review/done. Project completion/review rules apply. Done: {{board.reopen_task}} first. Scheduling: dueTime needs dueDate; durationMin needs dueTime; clearing dueDate clears both.",
     { text: "A project admin other than the assignee can override designated review.", principal: "human" },
     { text: "Cannot mark your assigned task done; a person confirms.", principal: "agent" }
   ],
@@ -21411,6 +21411,18 @@ var BoardUpdateTask = defineCapability({
     assignee: memberRef.nullable().optional(),
     reviewer: memberRef.nullable().optional(),
     dueDate: external_exports.string().nullable().optional(),
+    /** 钟点 "HH:MM"(本地墙上时间;要求 dueDate 非空)。 */
+    dueTime: external_exports.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/).nullable().optional(),
+    /** 预计时长(分钟,1–10080;要求 dueTime 非空)。 */
+    durationMin: external_exports.number().int().min(1).max(10080).nullable().optional(),
+    /** 重复预设:完成时生成下一次(同一套 task,不另建实体)。 */
+    recurrence: external_exports.enum(["daily", "weekly", "monthly"]).nullable().optional(),
+    /** 重复结束日期(YYYY-MM-DD,含当天)。 */
+    recurrenceUntil: external_exports.string().date().nullable().optional(),
+    /** 到点提醒提前量(分钟;0 = 准点,5/10/15/30/60/120)。 */
+    reminderLeadMin: external_exports.union([external_exports.literal(0), external_exports.literal(5), external_exports.literal(10), external_exports.literal(15), external_exports.literal(30), external_exports.literal(60), external_exports.literal(120)]).optional(),
+    /** 跳过一次重复:当前任务置 canceled 并生成下一次(不能与 status 同时给)。 */
+    skipOccurrence: external_exports.boolean().optional(),
     todos: todoItems.optional(),
     acceptanceChecks: acceptanceCheckItems.optional(),
     /** 管理员绕过(完成规则 v2 §3:档 3 只绕过「只有审阅人能通过」;项目管理员、本人不是负责人;原因选填)。Agent 一律拒(策略表)。 */
@@ -21476,7 +21488,7 @@ var BoardCreateTask = defineCapability({
   id: "board.create_task",
   summary: "Create one backlog/todo task.",
   usageRules: [
-    "Reuse clientId. parentTaskId: same-project parent ID, one level. Add todos/checks afterward via {{board.update_task}}; labels/links/dependencies use their actions.",
+    "Reuse clientId. parentTaskId: same-project, one level. Scheduling: dueTime needs dueDate; durationMin needs dueTime; recurrence (daily/weekly/monthly) spawns next on completion; recurrenceUntil caps. Todos/checks/labels/links/deps via their actions.",
     {
       text: "Prefer {{board.create_tasks}} for discussed work; partner confirms.",
       principal: "agent"
@@ -21491,6 +21503,18 @@ var BoardCreateTask = defineCapability({
     reviewer: memberRef.nullable().optional(),
     priority: external_exports.enum(TASK_PRIORITIES).optional(),
     dueDate: external_exports.string().nullable().optional(),
+    /** 钟点 "HH:MM"(本地墙上时间;要求 dueDate 非空)。 */
+    dueTime: external_exports.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/).nullable().optional(),
+    /** 预计时长(分钟,1–10080;要求 dueTime 非空)。 */
+    durationMin: external_exports.number().int().min(1).max(10080).nullable().optional(),
+    /** 重复预设(MD-512 P3):daily / weekly / monthly;完成时生成下一次。 */
+    recurrence: external_exports.enum(["daily", "weekly", "monthly"]).nullable().optional(),
+    /** 重复结束日期(YYYY-MM-DD,含当天)。 */
+    recurrenceUntil: external_exports.string().date().nullable().optional(),
+    /** 到点提醒提前量(分钟;0 = 准点)。 */
+    reminderLeadMin: external_exports.union([external_exports.literal(0), external_exports.literal(5), external_exports.literal(10), external_exports.literal(15), external_exports.literal(30), external_exports.literal(60), external_exports.literal(120)]).optional(),
+    /** 跳过一次重复(当前任务置 canceled 并生成下一次;不能与 status 同时给)。 */
+    skipOccurrence: external_exports.boolean().optional(),
     parentTaskId: uuid8.nullable().optional(),
     clientId: external_exports.string().max(200).nullable().optional(),
     /** 来源消息(任务回链到它,进展回到它的 thread)。系统内 Agent 不给,由会话派生(与 create_tasks 同一规则)。 */
@@ -21536,6 +21560,21 @@ var BoardCreateTasks = defineCapability({
       title: external_exports.string(),
       description: external_exports.string().optional(),
       priority: external_exports.enum(TASK_PRIORITIES).optional(),
+      /** 每张任务各自的时间(与 create_task 同一套字段/约束)。 */
+      dueDate: external_exports.string().nullable().optional(),
+      dueTime: external_exports.string().regex(/^([01]\d|2[0-3]):[0-5]\d$/).nullable().optional(),
+      durationMin: external_exports.number().int().min(1).max(10080).nullable().optional(),
+      recurrence: external_exports.enum(["daily", "weekly", "monthly"]).nullable().optional(),
+      recurrenceUntil: external_exports.string().date().nullable().optional(),
+      reminderLeadMin: external_exports.union([
+        external_exports.literal(0),
+        external_exports.literal(5),
+        external_exports.literal(10),
+        external_exports.literal(15),
+        external_exports.literal(30),
+        external_exports.literal(60),
+        external_exports.literal(120)
+      ]).optional(),
       todos: external_exports.array(external_exports.strictObject({ text: external_exports.string() })).optional(),
       acceptanceChecks: external_exports.array(external_exports.strictObject({ desc: external_exports.string() })).optional(),
       dependsOn: external_exports.array(external_exports.number().int().min(0)).optional(),
@@ -22562,6 +22601,84 @@ var ChatSetPinBarVisibility = defineCapability({
   effect: "write",
   idempotent: true
 });
+var ChatListChannels = defineCapability({
+  id: "chat.list_channels",
+  summary: "List the channels and one-to-one DMs you belong to, with unread counts, last activity and your role. Start here when you need a channelId for reading or sending messages.",
+  input: external_exports.strictObject({}),
+  effect: "read",
+  idempotent: true,
+  cli: { path: ["chat", "channels"] }
+});
+var ChatListMessages = defineCapability({
+  id: "chat.list_messages",
+  summary: "Read a page of messages in a conversation you belong to (oldest first). Page backwards with beforeSeq or catch up with afterSeq; excludeDeleted drops tombstones, topLevelOnly hides thread replies.",
+  input: external_exports.strictObject({
+    channelId: channelId2,
+    beforeSeq: external_exports.number().int().min(0).optional(),
+    afterSeq: external_exports.number().int().min(0).optional(),
+    limit: external_exports.number().int().min(1).max(200).optional(),
+    topLevelOnly: external_exports.boolean().optional()
+  }),
+  effect: "read",
+  idempotent: true,
+  cli: { path: ["chat", "messages", "list"] }
+});
+var ChatSearchMessages = defineCapability({
+  id: "chat.search_messages",
+  summary: "Search message text across channels you belong to (optionally limited to one channel). Only messages visible to you are returned; deleted messages are excluded.",
+  input: external_exports.strictObject({
+    q: external_exports.string().trim().min(1).max(200),
+    channelId: channelId2.optional(),
+    limit: external_exports.number().int().min(1).max(100).optional()
+  }),
+  effect: "read",
+  idempotent: true,
+  cli: { path: ["chat", "messages", "search"] }
+});
+var ChatSendMessage = defineCapability({
+  id: "chat.send_message",
+  summary: "Send a text message to a conversation you belong to, as the token owner (or as the in-product Agent). Use replyToId to quote a message and threadRootId to reply in a thread. Reuse clientId after an unknown result so a retry does not post twice.",
+  input: external_exports.strictObject({
+    channelId: channelId2,
+    text: external_exports.string().trim().min(1).max(2e4),
+    replyToId: messageId.optional(),
+    threadRootId: messageId.optional(),
+    clientId: external_exports.uuid().optional()
+  }),
+  effect: "write",
+  idempotent: true,
+  cli: { path: ["chat", "messages", "send"] }
+});
+var ChatThreadList = defineCapability({
+  id: "chat.thread_list",
+  summary: "Read the replies of a message thread you can see, oldest first. Page with beforeSeq / afterSeq; the thread root message is included.",
+  input: external_exports.strictObject({
+    messageId,
+    beforeSeq: external_exports.number().int().min(0).optional(),
+    afterSeq: external_exports.number().int().min(0).optional(),
+    limit: external_exports.number().int().min(1).max(200).optional(),
+    newestFirst: external_exports.boolean().optional()
+  }),
+  effect: "read",
+  idempotent: true,
+  cli: { path: ["chat", "thread", "list"] }
+});
+var ChatAddReaction = defineCapability({
+  id: "chat.add_reaction",
+  summary: "Add an emoji reaction to a visible message as the token owner. Repeating the same reaction is a no-op.",
+  input: external_exports.strictObject({ messageId, emoji: external_exports.string().trim().min(1).max(32) }),
+  effect: "write",
+  idempotent: true,
+  cli: { path: ["chat", "reaction", "add"] }
+});
+var ChatRemoveReaction = defineCapability({
+  id: "chat.remove_reaction",
+  summary: "Remove your own emoji reaction from a visible message.",
+  input: external_exports.strictObject({ messageId, emoji: external_exports.string().trim().min(1).max(32) }),
+  effect: "write",
+  idempotent: true,
+  cli: { path: ["chat", "reaction", "remove"] }
+});
 var ChatResolveMessageContext = defineCapability({
   id: "chat.resolve_message_context",
   summary: "Locate a visible message in a bounded context window (at most 100 messages), including old thread replies. The server resolves its conversation stream and thread root. Follow direction/cursor to extend before or after; never scan every old history page to find the target.",
@@ -22577,6 +22694,13 @@ var ChatResolveMessageContext = defineCapability({
   idempotent: true
 });
 var CHAT_CAPABILITIES = [
+  ChatListChannels,
+  ChatListMessages,
+  ChatSearchMessages,
+  ChatSendMessage,
+  ChatThreadList,
+  ChatAddReaction,
+  ChatRemoveReaction,
   ChatListPins,
   ChatPinMessage,
   ChatUnpinMessage,
@@ -23159,7 +23283,7 @@ function buildCommandTree(options = {}) {
 }
 
 // src/api.ts
-var CLI_VERSION = true ? "0.1.1" : "0.0.0";
+var CLI_VERSION = true ? "0.1.3" : "0.0.0";
 var CLI_USER_AGENT = `mosse-cli/${CLI_VERSION}`;
 async function callApi(request) {
   const headers = {
@@ -23564,7 +23688,13 @@ var SKILL_COMMAND_PATHS = [
   ["board", "task", "dependency-remove"],
   ["board", "task", "link-add"],
   ["board", "activity", "list"],
-  ["knowledge", "search"]
+  ["knowledge", "search"],
+  ["chat", "channels"],
+  ["chat", "messages", "list"],
+  ["chat", "messages", "search"],
+  ["chat", "messages", "send"],
+  ["chat", "thread", "list"],
+  ["chat", "reaction", "add"]
 ];
 function renderSkill(tree) {
   const line = (path, suffix) => {
@@ -23596,7 +23726,7 @@ function renderSkill(tree) {
     ...missing.length ? ["", `[warn] skill references missing commands: ${missing.map((p) => p.join(" ")).join(", ")}`] : []
   ].join("\n");
 }
-var SKILL_DESCRIPTION = "Use the Mosse CLI (mosse) to read and write Mosse boards: tasks and checklists, dependencies, links, activity, projects, and knowledge search. Use when the user asks about Mosse tasks or projects, or when a mosse command is needed.";
+var SKILL_DESCRIPTION = "Use the Mosse CLI (mosse) to read and write Mosse boards and chat: tasks and checklists, dependencies, links, activity, projects, sending and searching messages, reactions and threads, and knowledge search. Use when the user asks about Mosse tasks, projects, channels or messages, or when a mosse command is needed.";
 var skillVersionMark = (version3) => `<!-- mosse-skill-version: ${version3} -->`;
 function renderSkillMd(tree, version3 = CLI_VERSION) {
   return [
@@ -23629,6 +23759,8 @@ var LOCAL_COMMANDS = [
   "skill upgrade",
   "doctor",
   "completions",
+  "update",
+  "help",
   "inbox list",
   "inbox read",
   "workspace list"
@@ -23747,6 +23879,42 @@ function renderCompletions(tree, shell) {
   return fishScript(words);
 }
 
+// src/help.ts
+function editDistance(a, b) {
+  const rows = a.length + 1;
+  const cols = b.length + 1;
+  let prev = Array.from({ length: cols }, (_, i) => i);
+  for (let i = 1; i < rows; i += 1) {
+    const next = [i];
+    for (let j = 1; j < cols; j += 1) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      next[j] = Math.min(prev[j] + 1, next[j - 1] + 1, prev[j - 1] + cost);
+    }
+    prev = next;
+  }
+  return prev[b.length];
+}
+function suggestCommands(tree, tokens, limit2 = 3) {
+  const typed = tokens.join(" ");
+  if (!typed) return [];
+  const typedTokens = new Set(tokens);
+  const scored = tree.commands.map((command) => {
+    const path = command.path.join(" ");
+    const overlap = command.path.filter((segment) => typedTokens.has(segment)).length;
+    const distance = editDistance(typed, path);
+    const startsWith = path.startsWith(typed) ? 1 : 0;
+    return { command, score: distance - overlap * 2 - startsWith * 2 };
+  }).filter((entry) => entry.score <= 4).sort((a, b) => a.score - b.score || a.command.path.length - b.command.path.length);
+  return scored.slice(0, limit2).map((entry) => entry.command);
+}
+function searchCommands(tree, query) {
+  const q = query.trim().toLowerCase();
+  if (!q) return [];
+  return tree.commands.filter(
+    (command) => command.path.join(" ").includes(q) || command.summary.toLowerCase().includes(q)
+  );
+}
+
 // src/cli.ts
 var EXIT_USAGE = 2;
 var EXIT_AUTH = 3;
@@ -23850,12 +24018,12 @@ function suggestFlag(name, flags) {
   let best = null;
   for (const flag of flags) {
     const candidate = flag.name.replace(/^--/, "").replace(/-/g, "");
-    const distance = editDistance(target, candidate);
+    const distance = editDistance2(target, candidate);
     if (distance <= 2 && (!best || distance < best.distance)) best = { name: flag.name, distance };
   }
   return best ? `; did you mean ${best.name}?` : "";
 }
-function editDistance(a, b) {
+function editDistance2(a, b) {
   const rows = a.length + 1;
   const cols = b.length + 1;
   let prev = Array.from({ length: cols }, (_, j) => j);
@@ -24038,18 +24206,24 @@ async function runCli(argv, deps) {
     return 0;
   }
   const { head, tail } = splitHead(effective);
-  if (!head.length) {
-    deps.stdout(`${tree.rootHelp}
+  const rootHelp = () => `${tree.rootHelp}
 Local commands:
   auth <login|logout|status|token>  credentials (not part of the tool surface)
   skill [install|status|upgrade]    agent cheatsheet (mosse skill for the one-pager)
   doctor                            local environment check
   completions <bash|zsh|fish>       shell completion script
   workspace list                    list workspaces (alias of auth whoami)
-`);
+  inbox wait [--timeout-ms <ms>]    long-poll one inbox notification (exit 4 on timeout)
+  update                            check npm for a newer @mosse-ai/cli
+  help [query]                      search commands by path / description
+`;
+  if (!head.length) {
+    deps.stdout(rootHelp());
     return 0;
   }
   if (head[0] === "inbox" && head[1] === "wait") return handleInboxWait(rest.slice(2), deps, config2, globals);
+  if (head[0] === "update") return handleUpdate(rest.slice(1), deps, globals);
+  if (head[0] === "help") return handleHelpSearch(rest.slice(1), deps, tree, rootHelp());
   if (head[0] === "completions") return handleCompletions(rest.slice(1), deps, tree, globals);
   if (head[0] === "skill") return handleSkill(rest.slice(1), deps, configPath, config2, tree, globals);
   if (head[0] === "doctor") return handleDoctor(deps, config2, globals);
@@ -24061,7 +24235,11 @@ Local commands:
       deps.stdout(renderGroupHelp(tree.commands, head));
       return 0;
     }
-    deps.stderr(structuredError(globals, EXIT_USAGE, "unknown_command", `no such command: mosse ${head.join(" ")}`));
+    const suggestions = suggestCommands(tree, head);
+    const hint = suggestions.length ? `; did you mean: ${suggestions.map((item) => `mosse ${item.path.join(" ")}`).join(", ")}` : "";
+    deps.stderr(
+      structuredError(globals, EXIT_USAGE, "unknown_command", `no such command: mosse ${head.join(" ")}${hint}`)
+    );
     deps.stderr(tree.rootHelp);
     return EXIT_USAGE;
   }
@@ -24224,6 +24402,66 @@ function sessionPath(tool, input2) {
     return encodeURIComponent(String(value));
   });
 }
+async function handleUpdate(args, deps, globals) {
+  if (args[0] === "--help" || args[0] === "-h") {
+    deps.stdout("mosse update\n\n\u68C0\u67E5 npm \u4E0A\u7684\u6700\u65B0\u7248;\u4E0D\u81EA\u52A8\u5B89\u88C5,\u53EA\u6253\u5370\u5347\u7EA7\u547D\u4EE4\u3002\n");
+    return 0;
+  }
+  const registry2 = "https://registry.npmjs.org/@mosse-ai/cli/latest";
+  let latest;
+  try {
+    const response = await deps.fetch(registry2, { headers: { accept: "application/json" } });
+    if (!response.ok) throw new Error(`registry responded ${response.status}`);
+    const body = await response.json();
+    if (!body.version) throw new Error("registry response has no version");
+    latest = body.version;
+  } catch (error62) {
+    deps.stderr(
+      structuredError(
+        globals,
+        1,
+        "update_check_failed",
+        `could not check the npm registry: ${error62.message}`
+      )
+    );
+    return 1;
+  }
+  const upToDate = compareVersions(latest, CLI_VERSION) <= 0;
+  if (globals.json !== void 0) {
+    deps.stdout(renderOutput({ current: CLI_VERSION, latest, upToDate }, outputOptions(globals)));
+  } else {
+    deps.stdout(
+      upToDate ? `mosse ${CLI_VERSION} is up to date (latest ${latest})` : `mosse ${CLI_VERSION} \u2192 ${latest} available
+  npm i -g @mosse-ai/cli@${latest}
+  # or: npx @mosse-ai/cli@latest <command>`
+    );
+  }
+  return 0;
+}
+function compareVersions(a, b) {
+  const pa = a.split(".").map((part) => Number(part) || 0);
+  const pb = b.split(".").map((part) => Number(part) || 0);
+  for (let i = 0; i < Math.max(pa.length, pb.length); i += 1) {
+    const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+    if (diff !== 0) return diff;
+  }
+  return 0;
+}
+async function handleHelpSearch(args, deps, tree, root) {
+  const query = args.filter((arg) => !arg.startsWith("-")).join(" ").trim();
+  if (!query) {
+    deps.stdout(root);
+    return 0;
+  }
+  const matches = searchCommands(tree, query);
+  if (!matches.length) {
+    deps.stderr(`no commands match "${query}" (try \`mosse --help\`)`);
+    return 0;
+  }
+  deps.stdout(matches.map((command) => `mosse ${command.path.join(" ")}
+    ${command.summary}`).join("\n\n"));
+  return 0;
+}
 async function handleInboxWait(args, deps, config2, globals) {
   if (args[0] === "--help" || args[0] === "-h") {
     deps.stdout(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mosse-ai/cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "bin": {
     "mosse": "./dist/index.js"

package/skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mosse
-description: "Use the Mosse CLI (mosse) to read and write Mosse boards: tasks and checklists, dependencies, links, activity, projects, and knowledge search. Use when the user asks about Mosse tasks or projects, or when a mosse command is needed."
+description: "Use the Mosse CLI (mosse) to read and write Mosse boards and chat: tasks and checklists, dependencies, links, activity, projects, sending and searching messages, reactions and threads, and knowledge search. Use when the user asks about Mosse tasks, projects, channels or messages, or when a mosse command is needed."
 ---
 
 <!-- mosse-skill-version: 0.0.0 -->