@lukeguo12210/canvas-cli 0.0.3 → 0.0.5

package/README.md

@@ -8,6 +8,10 @@ Connect Canvas courses to AI agents.
 
 [Install](#installation--quick-start) · [Agent Skills](#agent-skills) · [Auth](#authentication) · [Commands](#command-system) · [Security](#security--privacy) · [License](#license) · [Roadmap](#roadmap)
 
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=lukeguo12210/canvas-cli&type=Date)](https://www.star-history.com/#lukeguo12210/canvas-cli&Date)
+
 ## Why @lukeguo12210/canvas-cli?
 
 - **Built for technical students** — bring Canvas into your terminal, scripts, and AI workflow.
@@ -74,6 +78,10 @@ npm install -g @lukeguo12210/canvas-cli
 # 1. Authenticate with your Canvas school
 canvas auth login
 
+# Agent/non-interactive auth
+canvas auth schools search "Columbia"
+canvas auth login --school "Columbia" --token-env CANVAS_TOKEN
+
 # 2. List courses
 canvas courses list
 
@@ -86,6 +94,12 @@ canvas review pack --course-id <course-id> --out ./review/<course>
 
 ### Install Agent Skills
 
+```bash
+canvas skills install
+```
+
+Equivalent direct installer command:
+
 ```bash
 npx skills add lukeguo12210/canvas-cli -g --skill "*" -y
 ```
@@ -137,6 +151,9 @@ canvas review pack --course-id <course-id> --out ./review/<course> --include-all
 
 ```bash
 canvas auth login
+canvas auth login --school "Columbia" --token-env CANVAS_TOKEN
+canvas auth login --school-url https://courseworks2.columbia.edu --school-name "Columbia University (CourseWorks)" --token "paste-token-here"
+canvas auth schools search "Columbia"
 canvas auth status
 canvas auth logout
 canvas config show
@@ -174,6 +191,10 @@ canvas review pack --course-id <course-id> --out ./review/<course> --include-all
 
 canvas api get /api/v1/courses
 canvas api get /api/v1/courses/<course-id>/modules --params '{"include":["items"]}'
+
+canvas skills install
+canvas skills command
+canvas skills status
 ```
 
 MVP raw API access is GET-only.

package/dist/bin/canvas.js

@@ -519,16 +519,112 @@ async function runPostLoginBootstrap() {
   };
 }
 
+// src/commands/shared.ts
+async function activeCanvas() {
+  const profile = await new ConfigStore().activeProfile();
+  return {
+    profile,
+    client: new CanvasClient({
+      baseUrl: profile.baseUrl,
+      token: profile.token
+    })
+  };
+}
+function flagValue(argv, flag) {
+  const index = argv.indexOf(flag);
+  if (index === -1) {
+    return void 0;
+  }
+  return argv[index + 1];
+}
+function requiredFlag(argv, flag, usage) {
+  const value = flagValue(argv, flag);
+  if (!value) {
+    throw new Error(usage);
+  }
+  return value;
+}
+function hasFlag(argv, flag) {
+  return argv.includes(flag);
+}
+function csvFlag(argv, flag) {
+  const raw = flagValue(argv, flag);
+  if (!raw) {
+    return void 0;
+  }
+  const values = raw.split(",").map((value) => value.trim()).filter(Boolean);
+  return values.length > 0 ? values : void 0;
+}
+function pageOptions(argv) {
+  const pageLimitRaw = flagValue(argv, "--page-limit");
+  return {
+    pageAll: hasFlag(argv, "--page-all"),
+    pageLimit: pageLimitRaw ? Number.parseInt(pageLimitRaw, 10) : void 0
+  };
+}
+function positionalArgs(argv) {
+  const valueFlags = /* @__PURE__ */ new Set([
+    "--course-id",
+    "--module-id",
+    "--item-id",
+    "--assignment-id",
+    "--quiz-id",
+    "--topic-id",
+    "--page",
+    "--path",
+    "--out",
+    "--format",
+    "--page-limit",
+    "--page-size",
+    "--page-delay",
+    "--enrollment-state",
+    "--state",
+    "--include",
+    "--params",
+    "--bucket",
+    "--search",
+    "--order-by",
+    "--sort",
+    "--file-id",
+    "--folder-id",
+    "--group-id",
+    "--content-type",
+    "--school",
+    "--school-query",
+    "--school-url",
+    "--url",
+    "--school-name",
+    "--name",
+    "--token",
+    "--token-env"
+  ]);
+  const values = [];
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg.startsWith("--")) {
+      if (valueFlags.has(arg)) {
+        index += 1;
+      }
+      continue;
+    }
+    values.push(arg);
+  }
+  return values;
+}
+
 // src/commands/auth.ts
 var TOKEN_PURPOSE = "Hyperknow";
 async function handleAuthCommand(argv, options) {
   const [subcommand] = argv;
   if (subcommand === "login") {
-    return authLogin(options);
+    return authLogin(argv.slice(1), options);
   }
   if (subcommand === "status") {
     return authStatus(options);
   }
+  if (subcommand === "schools") {
+    return authSchools(argv.slice(1), options);
+  }
   if (subcommand === "logout") {
     return authLogout(options);
   }
@@ -545,16 +641,21 @@ async function handleAuthCommand(argv, options) {
   );
   return 1;
 }
-async function authLogin(options) {
+async function authLogin(argv, options) {
   const io = createPrompt();
   try {
-    const school = await chooseSchool(io);
+    const nonInteractive = hasNonInteractiveLoginArgs(argv);
+    const school = nonInteractive ? resolveSchoolFromArgs(argv) : await chooseSchool(io);
     const settingsUrl = `${school.url}/profile/settings`;
-    process.stdout.write(tokenInstructions(school, settingsUrl));
-    await io.question("Press Enter to open Canvas settings in your browser...");
-    await openBrowser(settingsUrl);
-    process.stdout.write("\nWaiting for your Canvas personal access token.\n");
-    const token = await promptHidden("Paste token: ");
+    const providedToken = await tokenFromArgs(argv);
+    let token = providedToken;
+    if (!token) {
+      process.stdout.write(tokenInstructions(school, settingsUrl));
+      await io.question("Press Enter to open Canvas settings in your browser...");
+      await openBrowser(settingsUrl);
+      process.stdout.write("\nWaiting for your Canvas personal access token.\n");
+      token = await promptHidden("Paste token: ");
+    }
     if (!token) {
       throw new CanvasCliError("EMPTY_TOKEN", "No token entered.");
     }
@@ -588,7 +689,7 @@ async function authLogin(options) {
           },
           user,
           contextBootstrap: bootstrap,
-          next: "canvas context show"
+          next: "canvas courses list --active --page-all"
         },
         meta: {
           command: "auth login"
@@ -604,6 +705,25 @@ async function authLogin(options) {
     io.close();
   }
 }
+async function authSchools(argv, options) {
+  const [subcommand] = argv;
+  const query = subcommand === "search" ? positionalArgs(argv.slice(1)).join(" ") : flagValue(argv, "--query") ?? positionalArgs(argv).join(" ");
+  await writeOutput(
+    {
+      ok: true,
+      data: searchSchools(query).map((school) => ({
+        name: school.name,
+        baseUrl: school.url
+      })),
+      meta: {
+        command: "auth schools",
+        query
+      }
+    },
+    options
+  );
+  return 0;
+}
 async function authStatus(options) {
   const store = new ConfigStore();
   const config = await store.readRedacted();
@@ -694,11 +814,77 @@ async function chooseSchool(io, write = (message) => process.stdout.write(messag
     url: normalizeBaseUrl(school.url)
   };
 }
+function resolveSchoolFromArgs(argv) {
+  const schoolUrl = flagValue(argv, "--school-url") ?? flagValue(argv, "--url");
+  if (schoolUrl) {
+    return makeCustomSchool(flagValue(argv, "--school-name") ?? flagValue(argv, "--name") ?? "Custom Canvas School", schoolUrl);
+  }
+  const schoolQuery = flagValue(argv, "--school") ?? flagValue(argv, "--school-query");
+  if (!schoolQuery) {
+    throw new CanvasCliError(
+      "MISSING_SCHOOL",
+      "Non-interactive auth requires --school <query> or --school-url <url>."
+    );
+  }
+  const matches = searchSchools(schoolQuery, 20);
+  if (matches.length === 0) {
+    throw new CanvasCliError(
+      "SCHOOL_NOT_FOUND",
+      `No Canvas school matched "${schoolQuery}". Use --school-url <url> for a custom Canvas URL.`
+    );
+  }
+  const exact = matches.find((school) => {
+    return school.name.toLowerCase() === schoolQuery.toLowerCase() || school.url.toLowerCase() === schoolQuery.toLowerCase();
+  });
+  if (exact) {
+    return {
+      name: exact.name,
+      url: normalizeBaseUrl(exact.url)
+    };
+  }
+  if (matches.length === 1) {
+    const school = matches[0];
+    return {
+      name: school.name,
+      url: normalizeBaseUrl(school.url)
+    };
+  }
+  throw new CanvasCliError(
+    "AMBIGUOUS_SCHOOL",
+    `Multiple schools matched "${schoolQuery}": ${matches.map((school) => `${school.name} (${school.url})`).join("; ")}. Use a more specific --school value or --school-url.`
+  );
+}
+async function tokenFromArgs(argv) {
+  const directToken = flagValue(argv, "--token");
+  if (directToken) {
+    return directToken.trim();
+  }
+  const envName = flagValue(argv, "--token-env");
+  if (envName) {
+    return process.env[envName]?.trim();
+  }
+  if (argv.includes("--token-stdin")) {
+    return readStdin().then((value) => value.trim());
+  }
+  return void 0;
+}
 async function promptCustomSchool(io) {
   const name = await io.question("School display name: ");
   const url = await io.question("Canvas base URL: ");
   return makeCustomSchool(name, url);
 }
+function hasNonInteractiveLoginArgs(argv) {
+  return Boolean(
+    flagValue(argv, "--school") || flagValue(argv, "--school-query") || flagValue(argv, "--school-url") || flagValue(argv, "--url")
+  );
+}
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
 function tokenInstructions(school, settingsUrl) {
   return `
 Canvas token setup for ${school.name}
@@ -730,91 +916,6 @@ async function validateToken(client) {
   }
 }
 
-// src/commands/shared.ts
-async function activeCanvas() {
-  const profile = await new ConfigStore().activeProfile();
-  return {
-    profile,
-    client: new CanvasClient({
-      baseUrl: profile.baseUrl,
-      token: profile.token
-    })
-  };
-}
-function flagValue(argv, flag) {
-  const index = argv.indexOf(flag);
-  if (index === -1) {
-    return void 0;
-  }
-  return argv[index + 1];
-}
-function requiredFlag(argv, flag, usage) {
-  const value = flagValue(argv, flag);
-  if (!value) {
-    throw new Error(usage);
-  }
-  return value;
-}
-function hasFlag(argv, flag) {
-  return argv.includes(flag);
-}
-function csvFlag(argv, flag) {
-  const raw = flagValue(argv, flag);
-  if (!raw) {
-    return void 0;
-  }
-  const values = raw.split(",").map((value) => value.trim()).filter(Boolean);
-  return values.length > 0 ? values : void 0;
-}
-function pageOptions(argv) {
-  const pageLimitRaw = flagValue(argv, "--page-limit");
-  return {
-    pageAll: hasFlag(argv, "--page-all"),
-    pageLimit: pageLimitRaw ? Number.parseInt(pageLimitRaw, 10) : void 0
-  };
-}
-function positionalArgs(argv) {
-  const valueFlags = /* @__PURE__ */ new Set([
-    "--course-id",
-    "--module-id",
-    "--item-id",
-    "--assignment-id",
-    "--quiz-id",
-    "--topic-id",
-    "--page",
-    "--path",
-    "--out",
-    "--format",
-    "--page-limit",
-    "--page-size",
-    "--page-delay",
-    "--enrollment-state",
-    "--state",
-    "--include",
-    "--params",
-    "--bucket",
-    "--search",
-    "--order-by",
-    "--sort",
-    "--file-id",
-    "--folder-id",
-    "--group-id",
-    "--content-type"
-  ]);
-  const values = [];
-  for (let index = 0; index < argv.length; index += 1) {
-    const arg = argv[index];
-    if (arg.startsWith("--")) {
-      if (valueFlags.has(arg)) {
-        index += 1;
-      }
-      continue;
-    }
-    values.push(arg);
-  }
-  return values;
-}
-
 // src/commands/api.ts
 async function handleApiCommand(argv, options) {
   const [subcommand] = argv;
@@ -2153,8 +2254,137 @@ async function reviewPack(argv, options) {
   return 0;
 }
 
+// src/commands/skills.ts
+import { spawn as spawn2 } from "child_process";
+var SKILLS_INSTALL_COMMAND = [
+  "npx",
+  "skills",
+  "add",
+  "lukeguo12210/canvas-cli",
+  "-g",
+  "--skill",
+  "*",
+  "-y"
+];
+var SKILLS_INSTALL_DISPLAY_COMMAND = 'npx skills add lukeguo12210/canvas-cli -g --skill "*" -y';
+async function handleSkillsCommand(argv, options) {
+  const [subcommand] = argv;
+  try {
+    if (subcommand === "install") {
+      return await installSkills(argv.slice(1), options);
+    }
+    if (subcommand === "command") {
+      return await printSkillsCommand(options);
+    }
+    if (subcommand === "status") {
+      return await skillsStatus(options);
+    }
+    await writeOutput(
+      {
+        ok: false,
+        error: {
+          code: "UNKNOWN_COMMAND",
+          message: `Unknown skills command: ${argv.join(" ")}`,
+          retryable: false
+        }
+      },
+      options
+    );
+    return 1;
+  } catch (error) {
+    await writeOutput(toErrorEnvelope(error), options);
+    return 1;
+  }
+}
+async function installSkills(argv, options) {
+  if (hasFlag(argv, "--dry-run") || hasFlag(argv, "--print")) {
+    return printSkillsCommand(options);
+  }
+  const code = await run(SKILLS_INSTALL_COMMAND[0], SKILLS_INSTALL_COMMAND.slice(1));
+  if (code !== 0) {
+    await writeOutput(
+      {
+        ok: false,
+        error: {
+          code: "SKILLS_INSTALL_FAILED",
+          message: `Skills installer exited with code ${code}. Try: ${SKILLS_INSTALL_DISPLAY_COMMAND}`,
+          retryable: true
+        }
+      },
+      options
+    );
+    return code;
+  }
+  await writeOutput(
+    {
+      ok: true,
+      data: {
+        installed: true,
+        command: SKILLS_INSTALL_DISPLAY_COMMAND,
+        next: "Restart or reload your agent so it can discover the updated Canvas skills."
+      },
+      meta: {
+        command: "skills install"
+      }
+    },
+    options
+  );
+  return 0;
+}
+async function printSkillsCommand(options) {
+  await writeOutput(
+    {
+      ok: true,
+      data: {
+        command: SKILLS_INSTALL_DISPLAY_COMMAND,
+        note: "Run this to install or update all Canvas agent skills from GitHub."
+      },
+      meta: {
+        command: "skills command"
+      }
+    },
+    options
+  );
+  return 0;
+}
+async function skillsStatus(options) {
+  await writeOutput(
+    {
+      ok: true,
+      data: {
+        installCommand: SKILLS_INSTALL_DISPLAY_COMMAND,
+        skills: [
+          "canvas-shared",
+          "canvas-courses",
+          "canvas-modules",
+          "canvas-pages",
+          "canvas-files",
+          "canvas-assignments",
+          "canvas-review"
+        ],
+        note: "Use canvas skills install to install/update these skills."
+      },
+      meta: {
+        command: "skills status"
+      }
+    },
+    options
+  );
+  return 0;
+}
+function run(command, args) {
+  return new Promise((resolve2) => {
+    const child = spawn2(command, [...args], {
+      stdio: "inherit",
+      shell: process.platform === "win32"
+    });
+    child.on("close", (code) => resolve2(code ?? 1));
+    child.on("error", () => resolve2(1));
+  });
+}
+
 // src/bin/canvas.ts
-var VERSION = "0.0.3";
+var VERSION = "0.0.6";
 function helpText() {
   return `canvas \u2014 Canvas LMS CLI for students and agents.
 
@@ -2164,6 +2394,7 @@ USAGE:
 COMMANDS:
   auth login        Interactive Canvas PAT setup
   auth status       Show redacted auth status
+  auth schools      Search supported Canvas school URLs
   auth logout       Remove local Canvas auth config
   config show       Show redacted local config
   me                Show current Canvas user profile
@@ -2178,6 +2409,7 @@ COMMANDS:
   folders list      List course folders
   review pack       Create a local course review pack
   api get           Raw read-only Canvas API GET
+  skills install    Install/update bundled agent skills
   version           Print CLI version
 
 FLAGS:
@@ -2243,6 +2475,9 @@ async function main(argv) {
   if (command === "api") {
     return handleApiCommand(parsed.argv.slice(1), { format: parsed.format });
   }
+  if (command === "skills") {
+    return handleSkillsCommand(parsed.argv.slice(1), { format: parsed.format });
+  }
   await writeOutput(
     {
       ok: false,