ai-todo-cli 0.3.0 → 0.4.3

package/dist/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command } from "commander";
 import { createRequire } from "module";
+import { Command } from "commander";
 
 // src/auth.ts
-import { createServer } from "http";
 import { randomUUID } from "crypto";
+import { createServer } from "http";
 import open from "open";
 
 // src/config.ts
@@ -17,7 +17,7 @@ var CONFIG_DIR = join(homedir(), ".config", "ai-todo");
 var CREDENTIALS_PATH = join(CONFIG_DIR, "credentials.json");
 
 // src/credentials.ts
-import { readFileSync, writeFileSync, mkdirSync, unlinkSync } from "fs";
+import { mkdirSync, readFileSync, unlinkSync, writeFileSync } from "fs";
 import { dirname } from "path";
 function loadCredentials() {
   try {
@@ -79,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
             });
@@ -87,11 +88,13 @@ async function login(tokenDirect) {
               "Access-Control-Allow-Origin": new URL(API_BASE_URL).origin
             });
             res.end(JSON.stringify({ success: true }));
-            console.log(JSON.stringify({
-              success: true,
-              email: data.email,
-              message: "Login successful"
-            }));
+            console.log(
+              JSON.stringify({
+                success: true,
+                email: data.email,
+                message: "Login successful"
+              })
+            );
             server.close();
             resolve();
           } catch {
@@ -112,15 +115,19 @@ async function login(tokenDirect) {
       }
       const port = addr.port;
       const authUrl = `${API_BASE_URL}/auth/cli?port=${port}&state=${state}`;
-      console.log(JSON.stringify({
-        message: "Opening browser for login...",
-        url: authUrl
-      }));
-      open(authUrl).catch(() => {
-        console.log(JSON.stringify({
-          message: "Could not open browser. Please visit this URL manually:",
+      console.log(
+        JSON.stringify({
+          message: "Opening browser for login...",
           url: authUrl
-        }));
+        })
+      );
+      open(authUrl).catch(() => {
+        console.log(
+          JSON.stringify({
+            message: "Could not open browser. Please visit this URL manually:",
+            url: authUrl
+          })
+        );
       });
     });
     const timer = setTimeout(() => {
@@ -132,16 +139,6 @@ async function login(tokenDirect) {
   });
 }
 
-// src/manifest.ts
-async function fetchManifest() {
-  const res = await fetch(`${API_BASE_URL}/api/manifest`);
-  if (!res.ok) {
-    console.log(JSON.stringify({ error: "Failed to fetch manifest", status: res.status }));
-    process.exit(1);
-  }
-  return res.json();
-}
-
 // src/client.ts
 async function apiRequest(method, pathTemplate, pathParams, queryParams, bodyParams, fixedBody) {
   const creds = loadCredentials();
@@ -160,7 +157,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 };
@@ -178,25 +175,75 @@ async function apiRequest(method, pathTemplate, pathParams, queryParams, bodyPar
   }
   const data = await res.json().catch(() => ({}));
   if (!res.ok) {
-    console.log(JSON.stringify({ error: data.error ?? "Request failed", status: res.status }));
+    console.log(
+      JSON.stringify({
+        error: data.error ?? "Request failed",
+        status: res.status
+      })
+    );
     process.exit(1);
   }
   return { data, status: res.status };
 }
 
 // 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 = {};
@@ -235,6 +282,34 @@ 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);
@@ -246,12 +321,27 @@ function coerceValue(value, type) {
   return value;
 }
 
+// src/manifest.ts
+async function fetchManifest() {
+  const res = await fetch(`${API_BASE_URL}/api/manifest`);
+  if (!res.ok) {
+    console.log(
+      JSON.stringify({ error: "Failed to fetch manifest", status: res.status })
+    );
+    process.exit(1);
+  }
+  return res.json();
+}
+
 // 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(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) => {
+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);
 });
 program.command("logout").description("Clear stored credentials").action(() => {
@@ -261,14 +351,39 @@ program.command("logout").description("Clear stored credentials").action(() => {
 program.command("whoami").description("Show current authenticated user").action(() => {
   const creds = loadCredentials();
   if (!creds) {
-    console.log(JSON.stringify({ error: "Not logged in. Run: ai-todo login" }));
+    console.log(
+      JSON.stringify({ error: "Not logged in. Run: ai-todo login" })
+    );
     process.exit(2);
   }
-  console.log(JSON.stringify({
-    user_id: creds.user_id,
-    email: creds.email
-  }));
+  console.log(
+    JSON.stringify({
+      user_id: creds.user_id,
+      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"];
@@ -278,10 +393,13 @@ 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) {
-        console.log(JSON.stringify({ error: "Failed to load commands from server" }));
+        console.log(
+          JSON.stringify({ error: "Failed to load commands from server" })
+        );
         process.exit(1);
       }
     }
@@ -289,6 +407,10 @@ async function main() {
   await program.parseAsync(process.argv);
 }
 main().catch((err) => {
-  console.log(JSON.stringify({ error: err instanceof Error ? err.message : "Unknown error" }));
+  console.log(
+    JSON.stringify({
+      error: err instanceof Error ? err.message : "Unknown error"
+    })
+  );
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-todo-cli",
-  "version": "0.3.0",
+  "version": "0.4.3",
   "description": "CLI tool for AI agents to interact with ai-todo",
   "type": "module",
   "repository": {
@@ -19,19 +19,37 @@
   ],
   "scripts": {
     "build": "tsup",
-    "dev": "tsup --watch"
+    "dev": "tsup --watch",
+    "lint": "biome check src/",
+    "lint:fix": "biome check --fix src/",
+    "format": "biome format --write src/",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepare": "husky"
   },
   "dependencies": {
     "commander": "^13.0.0",
     "open": "^10.0.0"
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.4.8",
     "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^4.1.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
     "tsup": "^8.0.0",
-    "typescript": "^5.9.0"
+    "typescript": "^5.9.0",
+    "vitest": "^4.1.0"
   },
   "engines": {
     "node": ">=18"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "lint-staged": {
+    "src/**/*.ts": [
+      "biome check --fix",
+      "biome format --write"
+    ]
+  }
 }