moodle-cli 0.8.0 → 0.9.0

package/README.md

@@ -96,7 +96,7 @@ moodle news UNIT
 ```
 
 Ambiguous references list candidates. JSON callers receive `error.code: "ambiguous"`;
-TTY users can select a numbered match. A bare number in a section reference matches
+At a terminal you pick the match from a list (arrow keys, or type to filter a long one). A bare number in a section reference matches
 that number in the site's section name, so 7 never matches 17.
 
 #### Paste Moodle links directly
@@ -115,6 +115,24 @@ You can paste the same links into your agent and ask it to inspect the page, fin
 
 `moodle download` accepts an activity ID or an authenticated Moodle URL. `--dest` sets the exact local path, and `--force` replaces an existing file after the download completes. Folder activities expose `files` so you can choose which files to save.
 
+#### Submit assignment files
+
+`moodle submit` uploads local files into an assignment through the same pages a browser
+uses, then prints the receipt Moodle shows afterwards: status, files, due date and the
+time it was checked. It is the only command that writes to Moodle.
+
+```bash
+moodle submit "UNIT TASK" essay.pdf --dry-run          # plan only: limits, statement, existing files
+moodle submit "UNIT TASK" essay.pdf                    # upload; Moodle keeps a draft where drafts are allowed
+moodle submit "UNIT TASK" --final --accept-statement   # submit the draft for grading (cannot be undone)
+```
+
+Every run plans first and asks for confirmation; `--yes` skips the prompt for scripts.
+`--replace` removes the files already in the submission, `--accept-statement` agrees to
+the site's submission statement when one is required, and a file that is too large or of
+the wrong type is refused before anything is uploaded. Assignments without drafts submit
+on save; the receipt reports what the site did.
+
 ### Remote MCP for web AI
 
 A private remote MCP server lets a supported web AI client use Moodle when it cannot run the local CLI. You need a Cloudflare account.
@@ -128,6 +146,8 @@ moodle mcp status
 
 The MCP `get_file` tool accepts a resource activity ID, resource URL, or `pluginfile.php` URL and returns files up to 16 MiB directly as an embedded MCP resource. The Moodle session stays inside the local server or private Worker; clients do not need to fetch an authenticated Moodle URL themselves.
 
+The remote server is read-only. The local server (`moodle mcp serve`) also offers `submit`, which needs the files on the same machine. It defaults to `dry_run: true`, so an agent has to show the plan and run it again with `dry_run: false` to upload; `final: true` submits for grading.
+
 ### Update
 
 ```bash
@@ -154,7 +174,7 @@ Commands support:
 - `--fields units,total` to select envelope fields
 - `-o, --output FILE` to write command output or a download receipt
 
-The CLI prints tables in an interactive terminal and JSON when stdout goes to a pipe or file. Structured errors use one JSON object on stderr:
+The CLI prints tables in an interactive terminal and JSON when stdout goes to a pipe or file. In a terminal, a command missing its unit asks for it with a picker (`moodle activities` lists your units); pipes, `--json` and agent shells get the usage error with the usage line instead. Structured errors use one JSON object on stderr:
 
 ```json
 {"ok":false,"error":{"code":"auth","message":"...","hint":"..."},"exit_code":3}
@@ -298,7 +318,8 @@ and `name`. Dates include ISO offsets and epoch seconds. Unit detail defaults to
 section index; pass a section for activities. `--fields` selects envelope keys.
 
 The 11 default MCP tools are home, due, units, unit, find, item, grades, news, thread,
-search_forums and file. Old names remain callable through 0.8 with the new envelopes;
+search_forums and file; a local server adds submit, whose `submission` envelope is the
+upload receipt. Old names remain callable through 0.8 with the new envelopes;
 they are deprecated and omitted from default discovery to avoid duplicate catalog cost.
 The local command tree remains available, including courses as an alias for units.
 The unused projects/quiet aliases were removed. `--verbose` (`-v`) prints sanitized

package/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: moodle-cli
-description: Read Moodle units, deadlines, grades, announcements and files; diagnose sign-in and manage a private MCP server.
+description: Read Moodle units, deadlines, grades, announcements and files; submit assignment files; diagnose sign-in and manage a private MCP server.
 ---
 
 # Moodle CLI
 
-Read-only Moodle data. UNIT is a site code/name, id or URL; SECTION is a number or name.
+Reads Moodle; only `submit` writes. UNIT is a site code/name, id or URL; SECTION is a number or name.
 Never assume code patterns or ask for ids. `moodle units` shows the site's vocabulary.
 
 | Intent | Run |
@@ -19,12 +19,13 @@ Never assume code patterns or ask for ids. `moodle units` shows the site's vocab
 | my grades | moodle grades [UNIT] |
 | announcements | moodle news [UNIT] |
 | forum post text | moodle forums search "QUERY" --unit UNIT |
+| upload assignment files | moodle submit "UNIT TASK" FILE... [--final] |
 | download a file | moodle get "UNIT TASK" --to DIR |
 
 Pipes emit compact JSON; `--json` forces it, `--pretty` indents it.
 Ambiguity returns `candidates`: pick or refine, never guess.
 Lists report `total`; narrow or page when more exist. Quote ISO dates with offsets.
-Never expose cookies or tokens. Only download when requested.
+Never expose cookies or tokens. Download or submit only when asked; dry-run submit first. `--final` cannot be undone.
 Sign-in trouble: `moodle doctor`; remote expiry: `moodle mcp login`.
 Exact syntax: `moodle commands --json` or [reference](references/command-reference.md).
 Setup, MCP and removal: [guide](references/setup-and-auth.md).

package/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "Moodle CLI"
-  short_description: "Inspect Moodle and retrieve authenticated course files"
+  short_description: "Inspect Moodle, retrieve authenticated course files and submit assignment files"
   default_prompt: "Use $moodle-cli to inspect my Moodle data, retrieve a file through MCP, or download selected files locally with the narrowest relevant operation."