moodle-cli 0.8.0 → 0.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moodle-cli",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "Terminal-first CLI for Moodle LMS",
   "license": "MIT",
   "type": "module",
@@ -34,7 +34,7 @@
     "measure:mcp": "node scripts/measure-mcp.mjs"
   },
   "dependencies": {
-    "@bunizao/cli-kit": "^0.2.0",
+    "@bunizao/cli-kit": "^0.5.0",
     "@steipete/sweet-cookie": "^0.4.0",
     "commander": "^13.1.0",
     "node-html-parser": "^7.0.1",

package/references/command-reference.md

@@ -5,6 +5,9 @@ Generated from the live command tree. UNIT is a code/name, id or URL from `moodl
 Resources and folders return `files` with names and URLs. Pass a selected file URL to
 `moodle get URL --to DIR`. Validate the receipt: path, byte count and content type.
 `moodle download SOURCE --dest PATH --force` retains the exact-path replacement flow.
+`moodle submit "UNIT TASK" FILE... --dry-run` shows the upload plan; without `--dry-run` it
+asks for confirmation (`--yes` skips it) and prints the receipt Moodle shows afterwards.
+`--final` also submits for grading, which Moodle does not let anyone undo.
 
 | Command | Description | Arguments | Flags |
 | --- | --- | --- | --- |
@@ -17,7 +20,7 @@ Resources and folders return `files` with names and URLs. Pass a selected file U
 | moodle auth keepalive install | Install a macOS launch agent that renews the session periodically. |  | --interval (value required)<br>--pretty<br>--json<br>--yaml<br>--table<br>--fields (value required) |
 | moodle auth keepalive status | Show whether the keepalive launch agent is installed. |  | --pretty<br>--json<br>--yaml<br>--table<br>--fields (value required) |
 | moodle auth keepalive uninstall | Remove the keepalive launch agent. |  | --pretty<br>--json<br>--yaml<br>--table<br>--fields (value required) |
-| moodle auth login | Extract a fresh session, opening the browser when needed. |  | --pretty<br>--json<br>--yaml<br>--table<br>--fields (value required) |
+| moodle auth login | Sign in through a browser the CLI controls, then capture the session. |  | --paste<br>--pretty<br>--json<br>--yaml<br>--table<br>--fields (value required) |
 | moodle auth status | Show cached session freshness and keepalive state. |  | --pretty<br>--json<br>--yaml<br>--table<br>--fields (value required) |
 | moodle commands | Describe the complete command tree. |  | --pretty<br>--json<br>--yaml<br>--table<br>--fields (value required) |
 | moodle completion | Print shell completion for zsh, bash or fish. | <shell> |  |
@@ -53,6 +56,7 @@ Resources and folders return `files` with names and URLs. Pass a selected file U
 | moodle skills | Show skill metadata or delegate to the shared skills CLI. |  |  |
 | moodle skills add | Install the published skill through npx skills add. |  |  |
 | moodle skills generate | Regenerate the agent skill bundle from the CLI command tree. |  |  |
+| moodle submit | Upload local files into an assignment; returns the receipt Moodle shows afterwards. | <ref> [files...] | --pretty<br>--json<br>--yaml<br>--table<br>--fields (value required)<br>--final<br>--replace<br>--accept-statement |
 | moodle threads | Inspect forum discussion threads. |  |  |
 | moodle threads show | Show posts in a forum discussion. | <discussion> | --pretty<br>--json<br>--yaml<br>--table<br>--fields (value required)<br>--limit (value required)<br>--offset (value required)<br>--post (value required)<br>--body |
 | moodle todo | List upcoming actionable timeline items. |  | --pretty<br>--json<br>--yaml<br>--table<br>--fields (value required)<br>--limit (value required)<br>--days (value required) |
@@ -84,7 +88,8 @@ Exit codes:
 | 5 | Moodle rejected a well-formed request |
 
 MCP 0.8 discovers home, due, units, unit, find, item, grades, news, thread,
-search_forums and file. Legacy names remain callable for one minor version and return
+search_forums and file; a local server also lists submit, the only tool that writes.
+Legacy names remain callable for one minor version and return
 compact v2 envelopes. They are deprecated and omitted from default discovery.
 Unit results contain a section index; supply section for activity details.
 List activity URLs follow `{siteurl}/mod/{type}/view.php?id={id}`; use item for the actual URL.