ai-todo-cli 0.1.2 → 0.4.2

package/README.md

@@ -36,6 +36,17 @@ ai-todo spaces:list
 
 Run `ai-todo --help` to see all available commands (fetched from server).
 
+## Release
+
+This package is published to npm via GitHub Actions when a tag like `v0.1.3` is pushed.
+
+```bash
+npm version patch
+git push origin main --follow-tags
+```
+
+The workflow will verify that the Git tag matches `package.json` before publishing.
+
 ## For AI Agents
 
 This CLI is designed for AI agent integration. Key features:

package/dist/index.js

@@ -2,6 +2,7 @@
 
 // src/index.ts
 import { Command } from "commander";
+import { createRequire } from "module";
 
 // src/auth.ts
 import { createServer } from "http";
@@ -78,6 +79,7 @@ async function login(tokenDirect) {
             }
             saveCredentials({
               access_token: data.access_token,
+              session_token: data.session_token,
               user_id: data.user_id,
               email: data.email
             });
@@ -142,14 +144,14 @@ async function fetchManifest() {
 }
 
 // src/client.ts
-async function apiRequest(method, pathTemplate, pathParams, queryParams, bodyParams, fixedBody) {
+async function apiRequest(method, pathTemplate, pathParams2, queryParams, bodyParams, fixedBody) {
   const creds = loadCredentials();
   if (!creds) {
     console.log(JSON.stringify({ error: "Not logged in. Run: ai-todo login" }));
     process.exit(2);
   }
   let path = pathTemplate;
-  for (const [key, value] of Object.entries(pathParams)) {
+  for (const [key, value] of Object.entries(pathParams2)) {
     path = path.replace(`:${key}`, encodeURIComponent(value));
   }
   const url = new URL(path, API_BASE_URL);
@@ -159,7 +161,7 @@ async function apiRequest(method, pathTemplate, pathParams, queryParams, bodyPar
     }
   }
   const headers = {
-    Authorization: `Bearer ${creds.access_token}`
+    Authorization: `Bearer ${creds.session_token || creds.access_token}`
   };
   let body;
   const mergedBody = { ...bodyParams, ...fixedBody };
@@ -184,20 +186,62 @@ async function apiRequest(method, pathTemplate, pathParams, queryParams, bodyPar
 }
 
 // src/commands.ts
+function toCamelCase(s) {
+  return s.replace(/[-_]([a-z])/g, (_, c) => c.toUpperCase());
+}
 function registerDynamicCommands(program2, operations) {
   for (const op of operations) {
     const cmd = program2.command(op.name).description(op.description);
+    if (op.aliases?.length) {
+      cmd.aliases(op.aliases);
+    }
+    const paramAliasMap = {};
+    const requiredParamsWithAliases = /* @__PURE__ */ new Set();
     for (const param of op.params) {
       const flag = `--${param.name} <value>`;
       const desc = buildParamDesc(param.description, param.enum);
-      if (param.required) {
+      if (param.required && !param.aliases?.length) {
         cmd.requiredOption(flag, desc);
       } else {
         cmd.option(flag, desc);
+        if (param.required && param.aliases?.length) {
+          requiredParamsWithAliases.add(param.name);
+        }
       }
+      if (param.aliases?.length) {
+        for (const alias of param.aliases) {
+          cmd.option(`--${alias} <value>`);
+          const camelAlias = toCamelCase(alias);
+          paramAliasMap[camelAlias] = param.name;
+          if (camelAlias !== alias) {
+            paramAliasMap[alias] = param.name;
+          }
+        }
+      }
+    }
+    if (Object.keys(paramAliasMap).length > 0 || requiredParamsWithAliases.size > 0) {
+      cmd.hook("preAction", (thisCommand) => {
+        const opts = thisCommand.opts();
+        for (const [alias, original] of Object.entries(paramAliasMap)) {
+          if (opts[alias] !== void 0 && opts[original] === void 0) {
+            thisCommand.setOptionValue(original, opts[alias]);
+          }
+        }
+        const updatedOpts = thisCommand.opts();
+        for (const name of requiredParamsWithAliases) {
+          if (updatedOpts[name] === void 0) {
+            const param = op.params.find((p) => p.name === name);
+            const aliasList = param?.aliases?.map((a) => `--${a}`).join(", ") ?? "";
+            console.log(JSON.stringify({
+              error: `Missing required option: --${name}`,
+              aliases: aliasList ? `Also accepts: ${aliasList}` : void 0
+            }));
+            process.exit(1);
+          }
+        }
+      });
     }
     cmd.action(async (opts) => {
-      const pathParams = {};
       const queryParams = {};
       const bodyParams = {};
       for (const param of op.params) {
@@ -219,7 +263,11 @@ function registerDynamicCommands(program2, operations) {
         bodyParams,
         op.fixed_body
       );
-      console.log(JSON.stringify(data, null, 2));
+      if (op.format === "text" && typeof data === "object" && data !== null && "output" in data) {
+        console.log(data.output);
+      } else {
+        console.log(JSON.stringify(data, null, 2));
+      }
     });
   }
 }
@@ -230,6 +278,31 @@ function buildParamDesc(desc, enumValues) {
   }
   return desc;
 }
+function levenshtein(a, b) {
+  const m = a.length, n = b.length;
+  const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+  for (let i = 0; i <= m; i++) dp[i][0] = i;
+  for (let j = 0; j <= n; j++) dp[0][j] = j;
+  for (let i = 1; i <= m; i++) {
+    for (let j = 1; j <= n; j++) {
+      dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+    }
+  }
+  return dp[m][n];
+}
+function findClosestCommand(input, candidates) {
+  let best = "";
+  let bestDist = Infinity;
+  for (const candidate of candidates) {
+    const dist = levenshtein(input.toLowerCase(), candidate.toLowerCase());
+    if (dist < bestDist) {
+      bestDist = dist;
+      best = candidate;
+    }
+  }
+  const threshold = Math.min(Math.ceil(input.length / 2), 3);
+  return bestDist <= threshold ? best : null;
+}
 function coerceValue(value, type) {
   if (type === "number") {
     const n = Number(value);
@@ -242,8 +315,10 @@ function coerceValue(value, type) {
 }
 
 // src/index.ts
+var require2 = createRequire(import.meta.url);
+var { version } = require2("../package.json");
 var program = new Command();
-program.name("ai-todo").description("CLI for AI agents to interact with ai-todo").version("0.1.0");
+program.name("ai-todo").description("CLI for AI agents to interact with ai-todo").version(version);
 program.command("login").description("Authenticate with ai-todo via browser").option("--token <jwt>", "Directly provide a JWT token (for headless environments)").action(async (opts) => {
   await login(opts.token);
 });
@@ -262,6 +337,27 @@ program.command("whoami").description("Show current authenticated user").action(
     email: creds.email
   }));
 });
+function setupUnknownCommandHandler(operations) {
+  program.on("command:*", (operands) => {
+    const unknown = operands[0];
+    const allNames = [];
+    for (const op of operations) {
+      allNames.push(op.name);
+      if (op.aliases) allNames.push(...op.aliases);
+    }
+    allNames.push("login", "logout", "whoami");
+    const suggestion = findClosestCommand(unknown, allNames);
+    const result = {
+      error: `Unknown command: ${unknown}`
+    };
+    if (suggestion) {
+      result.suggestion = `Did you mean: ai-todo ${suggestion}`;
+    }
+    result.hint = "Run 'ai-todo --help' to see all available commands";
+    console.log(JSON.stringify(result));
+    process.exit(1);
+  });
+}
 async function main() {
   const firstArg = process.argv[2];
   const skipCommands = ["login", "logout", "whoami"];
@@ -271,6 +367,7 @@ async function main() {
     try {
       const manifest = await fetchManifest();
       registerDynamicCommands(program, manifest.operations);
+      setupUnknownCommandHandler(manifest.operations);
     } catch {
       const isHelpOrEmpty = !firstArg || ["help", "--help", "-h"].includes(firstArg);
       if (!isHelpOrEmpty) {

package/package.json

@@ -1,26 +1,37 @@
 {
   "name": "ai-todo-cli",
-  "version": "0.1.2",
+  "version": "0.4.2",
   "description": "CLI tool for AI agents to interact with ai-todo",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/strzhao/ai-todo-cli.git"
+  },
+  "homepage": "https://github.com/strzhao/ai-todo-cli#readme",
+  "bugs": {
+    "url": "https://github.com/strzhao/ai-todo-cli/issues"
+  },
   "bin": {
-    "ai-todo": "./dist/index.js"
+    "ai-todo": "dist/index.js"
   },
   "files": [
     "dist"
   ],
   "scripts": {
     "build": "tsup",
-    "dev": "tsup --watch"
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "dependencies": {
     "commander": "^13.0.0",
     "open": "^10.0.0"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.9.0",
-    "@types/node": "^22.0.0"
+    "vitest": "^4.1.0"
   },
   "engines": {
     "node": ">=18"