@mo7yw4ng/openape 1.0.0 → 1.0.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 MO7YW4NG
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 MO7YW4NG
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -12,9 +12,19 @@
 
 ## 安裝
 
-透過 npm 安裝（[Node.js v18+](https://nodejs.org/)）：
+透過 npm 安裝為全域指令（推薦，[Node.js](https://nodejs.org/) v18+）：
 ```bash
-npm install -g openape
+npm install -g @mo7yw4ng/openape
+```
+
+或用 npx 單次執行（不需安裝）：
+```bash
+npx @mo7yw4ng/openape --help
+```
+
+或透過 Deno/JSR 安裝：
+```bash
+deno install -A -g -n openape jsr:@openape/openape
 ```
 
 ## 核心指令
@@ -32,7 +42,7 @@ openape auth logout    # 登出並清除 session
 openape courses list               # 列出所有課程 (支援 --incomplete-only, --level)
 openape courses info <id>          # 顯示特定課程的詳細資訊
 openape courses progress <id>      # 顯示特定課程的進度
-openape courses syllabus <id>      # 顯示課程大綱
+openape courses syllabus <id>      # 顯示課程大綱 (從 CMAP 取得)
 ```
 
 ### 影片 (Videos)
@@ -73,7 +83,7 @@ openape skills install --all         # 自動偵測環境並安裝給所有支
 ```
 也可以透過 `npx skills` 安裝：
 ```bash
-npx skills add openape/openape
+npx skills add mo7yw4ng/openape
 ```
 
 ## 開發
@@ -94,4 +104,4 @@ deno task compile
 
 此專案之版權規範採用 **MIT License** - 至 [LICENSE](LICENSE) 查看更多相關聲明
 
-> **免責聲明**：本工具為非官方開放原始碼專案，與中原大學官方無關。請斟酌使用腳本輔助功能，避免不當操作（如短時間發送大量請求修改系統狀態）而違反學術倫理或導致帳號遭封鎖。
+> **免責聲明**：本工具為非官方開放原始碼專案，與中原大學官方無關。請斟酌使用腳本輔助功能，避免不當操作（如短時間發送大量請求修改系統狀態）而違反學術倫理或導致帳號遭封鎖。

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "@openape/openape",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "description": "CLI tool for CYCU i-Learning platform",
     "license": "MIT",
     "exports": "./src/index.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mo7yw4ng/openape",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "CLI tool for CYCU i-Learning platform",
   "keywords": [
     "ilearning",
@@ -12,7 +12,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/mo7yw4ng/openape.git"
+    "url": "https://github.com/MO7YW4NG/openape"
   },
   "license": "MIT",
   "bugs": {
@@ -25,7 +25,10 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@deno/shim-deno": "~0.18.0"
+    "@deno/shim-deno": "~0.18.0",
+    "commander": "^12.1.0",
+    "playwright-core": "^1.48.0",
+    "node-html-parser": "^6.1.13"
   },
   "devDependencies": {
     "@types/node": "^20.9.0"

package/script/deno.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = {
     "name": "@openape/openape",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "description": "CLI tool for CYCU i-Learning platform",
     "license": "MIT",
     "exports": "./src/index.ts",

package/skills/openape/SKILL.md

@@ -1,328 +1,331 @@
----
-name: openape
-description: How to use OpenApe CLI — automate CYCU iLearning (Moodle) tasks including course management, video progress tracking, quizzes, materials, grades, forums, announcements, and calendar
----
-
-# OpenApe CLI
-
-Use the `openape` command to access CYCU iLearning (Moodle) platform. OpenApe provides automation for course management, video progress completion, quiz tracking, material downloads, grade viewing, forum discussions, announcements, and calendar events.
-
-## Setup
-
-Install via npm:
-```bash
-npm install -g openape
-```
-
-Or clone and compile:
-```bash
-git clone https://github.com/mo7yw4ng/openape && cd openape
-deno task compile
-# Add dist/OpenApe.exe to your PATH
-```
-
-If not authenticated, run:
-```bash
-openape login
-```
-A browser will open for Microsoft OAuth SSO. Complete MFA login manually — no username/password input needed in the terminal.
-
-Session is saved to `.auth/storage-state.json` and persists between runs. If session expires, run `openape login` again.
-
-## Discovering Commands
-
-Every command supports `--help` for full option details:
-```bash
-openape --help
-openape courses --help
-openape videos complete --help
-```
-
-Add `--output json` to any command for machine-readable output. Use `--output csv` for spreadsheet format, `--output table` for human-readable tables, or `--output silent` to suppress output.
-
-## Course Commands
-
-### Listing courses
-
-```bash
-# List in-progress courses (default)
-openape courses list
-
-# List all courses including past and future
-openape courses list --level all
-
-# List only past courses
-openape courses list --level past
-
-# List only future courses
-openape courses list --level future
-```
-
-Course levels: `in_progress` (default), `past`, `future`, `all`.
-
-### Course information
-
-```bash
-# Get detailed course information
-openape courses info <course-id>
-
-# Get course progress percentage
-openape courses progress <course-id>
-
-# Get course syllabus from CMAP (18-week schedule)
-openape courses syllabus <course-id>
-```
-
-## Video Commands
-
-### Listing videos
-
-```bash
-# List all videos in a course
-openape videos list <course-id>
-
-# List only incomplete videos (browser mode only)
-openape videos list <course-id> --incomplete-only
-```
-
-### Completing videos
-
-```bash
-# Complete all incomplete videos in a course
-openape videos complete <course-id>
-
-# Dry-run: discover videos without completing
-openape videos complete <course-id> --dry-run
-
-# Complete all incomplete videos across all courses
-openape videos complete-all
-
-# Dry-run all courses
-openape videos complete-all --dry-run
-```
-
-**Note:** Video completion forges SuperVideo progress AJAX calls to simulate watching the entire video. The server accepts the progress but completion status may take time to update in the course state.
-
-### Downloading videos
-
-```bash
-# Download all videos from a course
-openape videos download <course-id>
-
-# Download only incomplete videos
-openape videos download <course-id> --incomplete-only
-
-# Specify output directory (default: ./downloads/videos)
-openape videos download <course-id> --output-dir ./my-videos
-```
-
-## Quiz Commands
-
-### Listing quizzes
-
-```bash
-# List quizzes in a specific course
-openape quizzes list <course-id>
-
-# List all quizzes across all courses
-openape quizzes list-all
-
-# List only in-progress course quizzes
-openape quizzes list-all --level in_progress
-```
-
-### Opening quizzes
-
-```bash
-# Open a quiz URL in browser (manual mode)
-openape quizzes open <quiz-url>
-```
-
-## Material Commands
-
-### Listing materials
-
-```bash
-# List all materials/resources across all courses
-openape materials list-all
-
-# List materials from in-progress courses only
-openape materials list-all --level in_progress
-```
-
-Materials include resources (PDFs, documents) and URLs (external links).
-
-### Downloading materials
-
-```bash
-# Download all materials from a specific course
-openape materials download <course-id>
-
-# Download all materials from all in-progress courses
-openape materials download-all
-
-# Download from all courses (including past)
-openape materials download-all --level all
-
-# Specify output directory (default: ./downloads)
-openape materials download-all --output-dir ./my-materials
-```
-
-## Grade Commands
-
-### Viewing grades
-
-```bash
-# Show grade summary across all courses
-openape grades summary
-
-# Show detailed grades for a specific course
-openape grades course <course-id>
-```
-
-## Forum Commands
-
-### Listing forums
-
-```bash
-# List forums from in-progress courses
-openape forums list
-
-# List all forums across all courses
-openape forums list-all
-
-# List forums from a specific course level
-openape forums list-all --level past
-```
-
-### Reading discussions
-
-```bash
-# List discussions in a forum (use cmid or instance ID)
-openape forums discussions <forum-id>
-
-# Show posts in a discussion
-openape forums posts <discussion-id>
-```
-
-## Announcement Commands
-
-### Listing announcements
-
-```bash
-# List all announcements across all courses
-openape announcements list-all
-
-# List only unread announcements
-openape announcements list-all --unread-only
-```
-
-### Reading announcements
-
-```bash
-# Read a specific announcement (shows full content)
-openape announcements read <announcement-id>
-```
-
-## Calendar Commands
-
-### Listing events
-
-```bash
-# List all calendar events
-openape calendar events
-
-# List events after a specific date
-openape calendar events --events-after 2026-03-01
-
-# List events before a specific date
-openape calendar events --events-before 2026-06-30
-
-# List events in a specific course
-openape calendar events --course-id <course-id>
-```
-
-### Exporting calendar
-
-```bash
-# Export calendar events to file
-openape calendar export
-
-# Specify output file (default: calendar_events.json)
-openape calendar export --output my-calendar.json
-
-# Export as ICS format for calendar apps
-openape calendar export --format ics --output my-calendar.ics
-```
-
-## Output Formats
-
-All commands support `--output` option:
-- `json` (default) - Machine-readable JSON
-- `csv` - Comma-separated values for spreadsheets
-- `table` - Human-readable table format
-- `silent` - Suppress output (useful for automation)
-
-Global options:
-- `--verbose` - Enable debug logging
-- `--silent` - Suppress all log output (JSON only)
-- `--headed` - Run browser in visible mode (for debugging)
-
-## Example Workflows
-
-**Check daily progress:** See what's due and what's incomplete.
-```bash
-openape courses list --level in_progress
-openape videos list <course-id>
-openape quizzes list-all
-openape announcements list-all --unread-only
-```
-
-**Auto-complete videos:** Complete all incomplete videos across courses.
-```bash
-# First, dry-run to see what will be completed
-openape videos complete-all --dry-run
-
-# Then actually complete them
-openape videos complete-all
-```
-
-**Download all materials:** Get all course materials for offline study.
-```bash
-openape materials download-all --output-dir ./semester-materials
-```
-
-**Check grades and progress:** See how you're doing in all courses.
-```bash
-openape grades summary
-openape courses progress <course-id>
-openape courses syllabus <course-id>
-```
-
-**Review discussions:** Catch up on forum activity.
-```bash
-openape forums list --level in_progress
-openape forums discussions <forum-id>
-openape forums posts <discussion-id>
-```
-
-**Plan your week:** Check upcoming events and deadlines.
-```bash
-openape calendar events --events-after 2026-03-21 --events-before 2026-03-28
-openape calendar export --format ics --output week.ics
-```
-
-**Bulk operations:** Complete videos and download materials across all courses.
-```bash
-openape videos complete-all
-openape materials download-all --level in_progress
-```
-
-## Tips
-
-- Use `--dry-run` with `videos complete` to preview what will be completed
-- Use `--level in_progress` (default) to focus on active courses
-- Use `--output json` for scripting and automation
-- Use `--output table` for human-readable output
-- Session persists after login, no need to re-authenticate
-- WS API mode is used by default for faster performance; browser mode is fallback
+---
+name: openape
+description: How to use OpenApe CLI — automate CYCU iLearning (Moodle) tasks including course management, video progress tracking, quizzes, materials, grades, forums, announcements, and calendar
+---
+
+# OpenApe CLI
+
+Use the `openape` command to access CYCU iLearning (Moodle) platform. OpenApe provides automation for course management, video progress completion, quiz tracking, material downloads, grade viewing, forum discussions, announcements, and calendar events.
+
+## Setup
+
+Install via npm:
+```bash
+npm install -g @mo7yw4ng/openape
+```
+
+Or run without installing:
+```bash
+npx @mo7yw4ng/openape --help
+```
+
+Or install via Deno/JSR:
+```bash
+deno install -A -g -n openape jsr:@openape/openape
+```
+
+If not authenticated, run:
+```bash
+openape login
+```
+A browser will open for Microsoft OAuth SSO. Complete MFA login manually — no username/password input needed in the terminal.
+
+Session is saved to `.auth/storage-state.json` and persists between runs. If session expires, run `openape login` again.
+
+## Discovering Commands
+
+Every command supports `--help` for full option details:
+```bash
+openape --help
+openape courses --help
+openape videos complete --help
+```
+
+Add `--output json` to any command for machine-readable output. Use `--output csv` for spreadsheet format, `--output table` for human-readable tables, or `--output silent` to suppress output.
+
+## Course Commands
+
+### Listing courses
+
+```bash
+# List in-progress courses (default)
+openape courses list
+
+# List all courses including past and future
+openape courses list --level all
+
+# List only past courses
+openape courses list --level past
+
+# List only future courses
+openape courses list --level future
+```
+
+Course levels: `in_progress` (default), `past`, `future`, `all`.
+
+### Course information
+
+```bash
+# Get detailed course information
+openape courses info <course-id>
+
+# Get course progress percentage
+openape courses progress <course-id>
+
+# Get course syllabus from CMAP (18-week schedule)
+openape courses syllabus <course-id>
+```
+
+## Video Commands
+
+### Listing videos
+
+```bash
+# List all videos in a course
+openape videos list <course-id>
+
+# List only incomplete videos (browser mode only)
+openape videos list <course-id> --incomplete-only
+```
+
+### Completing videos
+
+```bash
+# Complete all incomplete videos in a course
+openape videos complete <course-id>
+
+# Dry-run: discover videos without completing
+openape videos complete <course-id> --dry-run
+
+# Complete all incomplete videos across all courses
+openape videos complete-all
+
+# Dry-run all courses
+openape videos complete-all --dry-run
+```
+
+**Note:** Video completion forges SuperVideo progress AJAX calls to simulate watching the entire video. The server accepts the progress but completion status may take time to update in the course state.
+
+### Downloading videos
+
+```bash
+# Download all videos from a course
+openape videos download <course-id>
+
+# Download only incomplete videos
+openape videos download <course-id> --incomplete-only
+
+# Specify output directory (default: ./downloads/videos)
+openape videos download <course-id> --output-dir ./my-videos
+```
+
+## Quiz Commands
+
+### Listing quizzes
+
+```bash
+# List quizzes in a specific course
+openape quizzes list <course-id>
+
+# List all quizzes across all courses
+openape quizzes list-all
+
+# List only in-progress course quizzes
+openape quizzes list-all --level in_progress
+```
+
+### Opening quizzes
+
+```bash
+# Open a quiz URL in browser (manual mode)
+openape quizzes open <quiz-url>
+```
+
+## Material Commands
+
+### Listing materials
+
+```bash
+# List all materials/resources across all courses
+openape materials list-all
+
+# List materials from in-progress courses only
+openape materials list-all --level in_progress
+```
+
+Materials include resources (PDFs, documents) and URLs (external links).
+
+### Downloading materials
+
+```bash
+# Download all materials from a specific course
+openape materials download <course-id>
+
+# Download all materials from all in-progress courses
+openape materials download-all
+
+# Download from all courses (including past)
+openape materials download-all --level all
+
+# Specify output directory (default: ./downloads)
+openape materials download-all --output-dir ./my-materials
+```
+
+## Grade Commands
+
+### Viewing grades
+
+```bash
+# Show grade summary across all courses
+openape grades summary
+
+# Show detailed grades for a specific course
+openape grades course <course-id>
+```
+
+## Forum Commands
+
+### Listing forums
+
+```bash
+# List forums from in-progress courses
+openape forums list
+
+# List all forums across all courses
+openape forums list-all
+
+# List forums from a specific course level
+openape forums list-all --level past
+```
+
+### Reading discussions
+
+```bash
+# List discussions in a forum (use cmid or instance ID)
+openape forums discussions <forum-id>
+
+# Show posts in a discussion
+openape forums posts <discussion-id>
+```
+
+## Announcement Commands
+
+### Listing announcements
+
+```bash
+# List all announcements across all courses
+openape announcements list-all
+
+# List only unread announcements
+openape announcements list-all --unread-only
+```
+
+### Reading announcements
+
+```bash
+# Read a specific announcement (shows full content)
+openape announcements read <announcement-id>
+```
+
+## Calendar Commands
+
+### Listing events
+
+```bash
+# List all calendar events
+openape calendar events
+
+# List events after a specific date
+openape calendar events --events-after 2026-03-01
+
+# List events before a specific date
+openape calendar events --events-before 2026-06-30
+
+# List events in a specific course
+openape calendar events --course-id <course-id>
+```
+
+### Exporting calendar
+
+```bash
+# Export calendar events to file
+openape calendar export
+
+# Specify output file (default: calendar_events.json)
+openape calendar export --output my-calendar.json
+
+# Export as ICS format for calendar apps
+openape calendar export --format ics --output my-calendar.ics
+```
+
+## Output Formats
+
+All commands support `--output` option:
+- `json` (default) - Machine-readable JSON
+- `csv` - Comma-separated values for spreadsheets
+- `table` - Human-readable table format
+- `silent` - Suppress output (useful for automation)
+
+Global options:
+- `--verbose` - Enable debug logging
+- `--silent` - Suppress all log output (JSON only)
+- `--headed` - Run browser in visible mode (for debugging)
+
+## Example Workflows
+
+**Check daily progress:** See what's due and what's incomplete.
+```bash
+openape courses list --level in_progress
+openape videos list <course-id>
+openape quizzes list-all
+openape announcements list-all --unread-only
+```
+
+**Auto-complete videos:** Complete all incomplete videos across courses.
+```bash
+# First, dry-run to see what will be completed
+openape videos complete-all --dry-run
+
+# Then actually complete them
+openape videos complete-all
+```
+
+**Download all materials:** Get all course materials for offline study.
+```bash
+openape materials download-all --output-dir ./semester-materials
+```
+
+**Check grades and progress:** See how you're doing in all courses.
+```bash
+openape grades summary
+openape courses progress <course-id>
+openape courses syllabus <course-id>
+```
+
+**Review discussions:** Catch up on forum activity.
+```bash
+openape forums list --level in_progress
+openape forums discussions <forum-id>
+openape forums posts <discussion-id>
+```
+
+**Plan your week:** Check upcoming events and deadlines.
+```bash
+openape calendar events --events-after 2026-03-21 --events-before 2026-03-28
+openape calendar export --format ics --output week.ics
+```
+
+**Bulk operations:** Complete videos and download materials across all courses.
+```bash
+openape videos complete-all
+openape materials download-all --level in_progress
+```
+
+## Tips
+
+- Use `--dry-run` with `videos complete` to preview what will be completed
+- Use `--level in_progress` (default) to focus on active courses
+- Use `--output json` for scripting and automation
+- Use `--output table` for human-readable output
+- Session persists after login, no need to re-authenticate
+- WS API mode is used by default for faster performance; browser mode is fallback