@kaname-tasks/kaname 0.1.0 → 0.2.0

package/README.md

@@ -5,7 +5,19 @@ Command-line client for Kaname. See `docs/cli-plan.md` for the design.
 The package ships two binaries: `kaname` (the CLI) and `kaname-mcp` (an MCP
 server exposing the same operations as tools — see [MCP server](#mcp-server)).
 
-## Install (from the monorepo)
+## Install
+
+```bash
+npm install -g @kaname-tasks/kaname   # installs the `kaname` and `kaname-mcp` binaries
+# or run without installing:
+npx @kaname-tasks/kaname ls
+```
+
+Requires Node.js >= 20. The CLI talks to the hosted backend
+(`https://kaname-api-p0su.onrender.com`) by default — no configuration needed.
+Point it elsewhere with `KANAME_API_URL` or `kaname login --api-url ...`.
+
+### Install from the monorepo (for development)
 
 ```bash
 cd cli
@@ -14,6 +26,12 @@ npm run build
 npm link        # makes `kaname` and `kaname-mcp` available on your PATH
 ```
 
+For local development against a backend on your machine, override the default:
+
+```bash
+export KANAME_API_URL=http://localhost:8000
+```
+
 ## Login
 
 ```bash
@@ -43,15 +61,15 @@ kaname ls --all
 kaname ls --list groceries
 kaname ls --smart errands
 
-kaname show 1            # #-indexes refer to the last `kaname ls` output
-kaname done 1 2          # complete several at once
-kaname undone 2
-kaname edit 1 --when tomorrow --list none
-kaname rm 1              # asks for confirmation (or --force)
+kaname show 4f2a1c        # short ids are shown by `kaname ls` and never change
+kaname done 4f2a1c 9bd003  # complete several at once
+kaname undone 9bd003
+kaname edit 4f2a1c --when tomorrow --list none
+kaname rm 4f2a1c           # asks for confirmation (or --force)
 
-kaname subtask add 1 whole milk
-kaname subtask done 1 1
-kaname subtask rm 1 2
+kaname subtask add 4f2a1c whole milk
+kaname subtask done 4f2a1c 1
+kaname subtask rm 4f2a1c 2
 
 kaname list ls
 kaname list add groceries --color '#22c55e'
@@ -65,6 +83,17 @@ kaname logout
 Dates accept `today`, `tomorrow`, weekday names (`fri`), offsets (`+3d`), ISO
 (`2026-07-10`), and `none` to clear a date in `edit`.
 
+Any command taking a todo accepts three ways to name one:
+
+| Form | Example | Notes |
+|---|---|---|
+| short id | `4f2a1c` | Shown by `ls`; the leading chars of the todo's uuid, so it never changes |
+| `#`-index | `#2` or `2` | Position in the **last** `ls` output — convenient, but shifts whenever you re-list |
+| full uuid | `4f2a1c…` | What `--json` and `--plain` print |
+
+Prefer the short id: an index means whatever the most recent `ls` in *any* shell
+put in that row, so it goes stale the moment you list something else.
+
 Every read command takes `--json` (raw API response, for `jq`/scripts) and
 `--plain` (tab-separated, no color). Exit codes: `1` for errors, `2` for
 "not logged in / session expired".

package/dist/{chunk-T7KF3F3M.js → chunk-FR675V3R.js}

@@ -36,6 +36,11 @@ function saveConfig(config) {
   writeJson(configFile(), config);
 }
 var DEFAULT_API_URL = "https://kaname-api-p0su.onrender.com";
+var DEFAULT_GOOGLE_CLIENT_ID = "191990914988-0hmfjva1fe1adq6p8bi7qd713jskb5hv.apps.googleusercontent.com";
+var DEFAULT_GOOGLE_CLIENT_SECRET = Buffer.from(
+  "R09DU1BYLVlHdlFYeWpseUYzZEUwMzQwbUZhaU9pZWdYbUE=",
+  "base64"
+).toString("utf8");
 function apiUrl() {
   return process.env.KANAME_API_URL || loadConfig().apiUrl || DEFAULT_API_URL;
 }
@@ -194,6 +199,50 @@ async function confirmOrFail(message) {
 
 // src/util/output.ts
 import pc from "picocolors";
+
+// src/util/ids.ts
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var SHORT_ID_LEN = 6;
+function shortId(id) {
+  return id.slice(0, SHORT_ID_LEN);
+}
+function matchPrefix(ids, prefix) {
+  const lower = prefix.toLowerCase();
+  return ids.filter((id) => id.toLowerCase().startsWith(lower));
+}
+function ambiguous(token, count) {
+  return new Error(`Ambiguous id "${token}" (${count} matches) \u2014 use more characters.`);
+}
+async function resolveTodoId(token) {
+  const indexMatch = token.match(/^#?(\d{1,4})$/);
+  if (indexMatch) {
+    const ids = loadLastView();
+    const index = Number(indexMatch[1]);
+    if (index < 1 || index > ids.length) {
+      throw new Error(
+        ids.length === 0 ? `No cached listing \u2014 run \`kaname ls\` first, or pass a short id.` : `#${index} is out of range (last listing had ${ids.length} items).`
+      );
+    }
+    return ids[index - 1];
+  }
+  if (UUID_RE.test(token)) return token;
+  if (/^[0-9a-f]{4,}$/i.test(token)) {
+    const cached = matchPrefix(loadLastView(), token);
+    if (cached.length === 1) return cached[0];
+    if (cached.length > 1) throw ambiguous(token, cached.length);
+    const todos = await api.get("/todos?all=true");
+    const matches = matchPrefix(
+      todos.map((t) => t.id),
+      token
+    );
+    if (matches.length === 1) return matches[0];
+    if (matches.length > 1) throw ambiguous(token, matches.length);
+    throw new Error(`No todo has id "${token}".`);
+  }
+  throw new Error(`"${token}" is not a #index, short id, or UUID.`);
+}
+
+// src/util/output.ts
 function printJson(data) {
   console.log(JSON.stringify(data, null, 2));
 }
@@ -237,7 +286,7 @@ function printTodos(todos, opts, listNames) {
     const index = pc.dim(`#${i + 1}`.padStart(indexWidth + 1));
     const mark = t.completed ? pc.green("\u2713") : "\u25CB";
     const title = t.completed ? pc.dim(t.title) : t.title;
-    const parts = [index, mark, title];
+    const parts = [index, pc.dim(shortId(t.id)), mark, title];
     const when = colorDate(dateLabel(t.when_date, t.when_time), t.when_date, t.completed);
     if (when) parts.push(when);
     if (t.due_date) {
@@ -257,7 +306,7 @@ function printTodoDetail(todo, opts) {
     return;
   }
   console.log(`${todo.completed ? pc.green("\u2713") : "\u25CB"} ${pc.bold(todo.title)}`);
-  console.log(pc.dim(`  id: ${todo.id}`));
+  console.log(pc.dim(`  id: ${shortId(todo.id)}  (${todo.id})`));
   if (todo.description) console.log(`  ${todo.description}`);
   if (todo.when_date) console.log(`  when: ${colorDate(dateLabel(todo.when_date, todo.when_time), todo.when_date, todo.completed)}`);
   if (todo.due_date) console.log(`  due:  ${colorDate(dateLabel(todo.due_date, todo.due_time), todo.due_date, todo.completed)}`);
@@ -359,18 +408,21 @@ function registerListCommands(program) {
 export {
   loadConfig,
   saveConfig,
+  DEFAULT_GOOGLE_CLIENT_ID,
+  DEFAULT_GOOGLE_CLIENT_SECRET,
   apiUrl,
   loadCredentials,
   saveCredentials,
   clearCredentials,
   saveLastView,
-  loadLastView,
   ApiError,
   AuthError,
   api,
   confirmOrFail,
   localToday,
   parseDateArg,
+  shortId,
+  resolveTodoId,
   printJson,
   printTodos,
   printTodoDetail,

package/dist/index.js

@@ -2,6 +2,8 @@
 import {
   ApiError,
   AuthError,
+  DEFAULT_GOOGLE_CLIENT_ID,
+  DEFAULT_GOOGLE_CLIENT_SECRET,
   api,
   apiUrl,
   clearCredentials,
@@ -9,7 +11,6 @@ import {
   fetchLists,
   listNameMap,
   loadConfig,
-  loadLastView,
   localToday,
   parseDateArg,
   printJson,
@@ -17,10 +18,12 @@ import {
   printTodos,
   registerListCommands,
   resolveList,
+  resolveTodoId,
   saveConfig,
   saveCredentials,
-  saveLastView
-} from "./chunk-T7KF3F3M.js";
+  saveLastView,
+  shortId
+} from "./chunk-FR675V3R.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -45,8 +48,8 @@ function openBrowser(url) {
 }
 function googleOAuthConfig() {
   const config = loadConfig();
-  const clientId = process.env.KANAME_GOOGLE_CLIENT_ID || config.googleClientId;
-  const clientSecret = process.env.KANAME_GOOGLE_CLIENT_SECRET || config.googleClientSecret;
+  const clientId = process.env.KANAME_GOOGLE_CLIENT_ID || config.googleClientId || DEFAULT_GOOGLE_CLIENT_ID;
+  const clientSecret = process.env.KANAME_GOOGLE_CLIENT_SECRET || config.googleClientSecret || DEFAULT_GOOGLE_CLIENT_SECRET;
   if (!clientId || !clientSecret) {
     throw new Error(
       'Google OAuth is not configured. Set KANAME_GOOGLE_CLIENT_ID / KANAME_GOOGLE_CLIENT_SECRET (a "Desktop app" OAuth client), or use `kaname login --password`.'
@@ -183,32 +186,6 @@ function registerAuthCommands(program2) {
 
 // src/commands/todos.ts
 import pc2 from "picocolors";
-
-// src/util/ids.ts
-var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-function resolveTodoId(token) {
-  const indexMatch = token.match(/^#?(\d{1,4})$/);
-  if (indexMatch) {
-    const ids = loadLastView();
-    const index = Number(indexMatch[1]);
-    if (index < 1 || index > ids.length) {
-      throw new Error(
-        ids.length === 0 ? `No cached listing \u2014 run \`kaname ls\` first, or pass a UUID.` : `#${index} is out of range (last listing had ${ids.length} items).`
-      );
-    }
-    return ids[index - 1];
-  }
-  if (UUID_RE.test(token)) return token;
-  if (/^[0-9a-f]{4,}$/i.test(token)) {
-    const matches = loadLastView().filter((id) => id.toLowerCase().startsWith(token.toLowerCase()));
-    if (matches.length === 1) return matches[0];
-    if (matches.length > 1) throw new Error(`Ambiguous id prefix "${token}" (${matches.length} matches).`);
-    throw new Error(`No todo in the last listing matches "${token}" \u2014 run \`kaname ls\` or pass a full UUID.`);
-  }
-  throw new Error(`"${token}" is not a #index, UUID, or UUID prefix.`);
-}
-
-// src/commands/todos.ts
 async function buildEditPayload(opts) {
   const payload = {};
   if (opts.title !== void 0) payload.title = opts.title;
@@ -230,7 +207,7 @@ function registerTodoCommands(program2) {
     const todo = await api.post("/todos", payload);
     const globalOpts = program2.opts();
     if (globalOpts.json) printJson(todo);
-    else console.log(pc2.green("Added:") + ` ${todo.title} ${pc2.dim(todo.id)}`);
+    else console.log(pc2.green("Added:") + ` ${todo.title} ${pc2.dim(shortId(todo.id))}`);
   });
   program2.command("ls").description("List todos (default: today view)").option("-t, --today", "todos scheduled for today (default)").option("-i, --inbox", "todos with no list").option("-a, --all", "all todos").option("-l, --list <list>", "todos in a list").option("-s, --smart <name>", "todos in a smart list").option("--status <status>", "filter by completion: open, done, or all", "all").action(
     async (opts) => {
@@ -271,18 +248,18 @@ function registerTodoCommands(program2) {
     }
   );
   program2.command("show <id>").description("Show a todo with its subtasks").action(async (idToken) => {
-    const todo = await api.get(`/todos/${resolveTodoId(idToken)}`);
+    const todo = await api.get(`/todos/${await resolveTodoId(idToken)}`);
     printTodoDetail(todo, program2.opts());
   });
   program2.command("done <ids...>").description("Complete one or more todos").action(async (idTokens) => {
     for (const token of idTokens) {
-      const todo = await api.put(`/todos/${resolveTodoId(token)}`, { completed: true });
+      const todo = await api.put(`/todos/${await resolveTodoId(token)}`, { completed: true });
       console.log(`${pc2.green("\u2713")} ${todo.title}`);
     }
   });
   program2.command("undone <ids...>").description("Reopen one or more completed todos").action(async (idTokens) => {
     for (const token of idTokens) {
-      const todo = await api.put(`/todos/${resolveTodoId(token)}`, { completed: false });
+      const todo = await api.put(`/todos/${await resolveTodoId(token)}`, { completed: false });
       console.log(`\u25CB ${todo.title}`);
     }
   });
@@ -291,11 +268,11 @@ function registerTodoCommands(program2) {
     if (Object.keys(payload).length === 0) {
       throw new Error("Nothing to change \u2014 pass at least one of --title/--notes/--when/--due/--list.");
     }
-    const todo = await api.put(`/todos/${resolveTodoId(idToken)}`, payload);
+    const todo = await api.put(`/todos/${await resolveTodoId(idToken)}`, payload);
     printTodoDetail(todo, program2.opts());
   });
   program2.command("rm <id>").description("Delete a todo").option("-f, --force", "skip confirmation").action(async (idToken, opts) => {
-    const id = resolveTodoId(idToken);
+    const id = await resolveTodoId(idToken);
     const todo = await api.get(`/todos/${id}`);
     if (!opts.force && !await confirmOrFail(`Delete "${todo.title}"?`)) return;
     await api.del(`/todos/${id}`);
@@ -304,13 +281,13 @@ function registerTodoCommands(program2) {
   const subtask = program2.command("subtask").description("Manage subtasks of a todo");
   subtask.command("add <id> <title...>").description("Add a subtask").action(async (idToken, titleWords) => {
     const created = await api.post(
-      `/todos/${resolveTodoId(idToken)}/subtasks`,
+      `/todos/${await resolveTodoId(idToken)}/subtasks`,
       { title: titleWords.join(" ") }
     );
     console.log(pc2.green("Added subtask:") + ` ${created.title}`);
   });
   const resolveSubtask = async (idToken, indexArg) => {
-    const todoId = resolveTodoId(idToken);
+    const todoId = await resolveTodoId(idToken);
     const todo = await api.get(`/todos/${todoId}`);
     const subtasks = todo.subtasks ?? [];
     const index = Number(indexArg);

package/dist/mcp.js

@@ -9,7 +9,7 @@ import {
   localToday,
   parseDateArg,
   resolveList
-} from "./chunk-T7KF3F3M.js";
+} from "./chunk-FR675V3R.js";
 
 // src/mcp.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaname-tasks/kaname",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Command-line client for Kaname",
   "type": "module",
   "bin": {