e3cli 1.0.6__tar.gz → 1.0.7__tar.gz

{e3cli-1.0.6 → e3cli-1.0.7}/CLAUDE.md

@@ -66,13 +66,12 @@ e3cli skill uninstall              # remove
 
 ## Workflow: When a New Assignment is Detected
 
-1. `e3cli sync` — pull latest materials and assignment status
-2. `e3cli assignments` — see what's new/urgent (sorted by deadline)
-3. `e3cli assignments --detail <ID>` — read the full description and check attachments
-4. Downloaded materials are in the download directory (check `e3cli sync` output for path)
-5. Work on the assignment
-6. `e3cli submit <ID> <file>` — submit when ready
-7. **Always confirm with the user before submitting**
+1. `e3cli assignments` — see what's new/urgent (sorted by deadline). **No sync needed** — this hits the live API.
+2. `e3cli assignments --detail <ID>` — read the full description and check attachments. Also live.
+3. **Only if** the user mentions / asks about a specific course's materials: `e3cli download --course "<name>"` or `e3cli sync --course "<name>"`. Avoid blanket `e3cli sync` / `e3cli download` — they pull every file including large media (mp4 lectures, recordings).
+4. Work on the assignment
+5. `e3cli submit <ID> <file>` — submit when ready
+6. **Always confirm with the user before submitting**
 
 ## Reading Assignment Details
 

{e3cli-1.0.6 → e3cli-1.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: e3cli
-Version: 1.0.6
+Version: 1.0.7
 Summary: NYCU E3 Moodle automation CLI — sync courses, download materials, submit assignments.
 Project-URL: Homepage, https://github.com/junlinwk/e3cli
 Project-URL: Repository, https://github.com/junlinwk/e3cli

{e3cli-1.0.6 → e3cli-1.0.7}/e3cli/__init__.py

@@ -1,3 +1,3 @@
 """E3CLI — NYCU E3 Moodle Automation CLI Tool"""
 
-__version__ = "1.0.6"
+__version__ = "1.0.7"

{e3cli-1.0.6 → e3cli-1.0.7}/e3cli/agent_prompt.md

@@ -18,33 +18,38 @@ e3cli is a CLI tool for interacting with NYCU's E3 Moodle platform. The agent ca
 
 ## Workflow
 
-### Step 1: Check for new assignments
+### Step 1: Check for new assignments (live, no sync)
 
-```bash
-# Sync current semester (downloads new materials + checks assignments)
-e3cli sync
+`assignments` hits the live Moodle API — do NOT prefix it with `e3cli sync`.
 
+```bash
 # List assignments with deadlines
 e3cli assignments
 
 # Show only assignments due within 7 days
 e3cli assignments --due-soon 7
+
+# Full description + attachment URLs for one assignment (also live)
+e3cli assignments --detail <ID>
 ```
 
-### Step 2: Read assignment details
+### Step 2: Pull supporting materials — only what the user asked about
 
-Assignments are synced to the local SQLite database. Course materials (including assignment PDFs) are downloaded to `~/e3-downloads/`.
+Course materials may include large media (mp4 lectures, recordings). Scope downloads to the specific course the user mentioned. A blanket `e3cli sync` / `e3cli download` will pull everything for every course and waste bandwidth/time.
 
 ```bash
-# Download materials for a specific course
+# Materials for one course (download only)
 e3cli download --course "OS"
 
-# Find downloaded assignment files
-find ~/e3-downloads/ -name "*.pdf" -newer ~/.e3cli/data/e3cli.db
+# Materials + assignment status refresh for one course
+e3cli sync --course "OS"
+
+# Find downloaded files for that course
+find ~/e3-downloads/<course>/ -type f
 ```
 
 The agent should:
-- Read the assignment PDF/description
+- Read the assignment PDF/description (use `--detail` and the attachment URLs)
 - Check `~/e3-downloads/<course>/` for relevant lecture materials
 - Understand the requirements before starting work
 

{e3cli-1.0.6 → e3cli-1.0.7}/e3cli/skills/e3cli/SKILL.md

@@ -24,33 +24,34 @@ e3cli courses      # if this errors with "auth"/"token" → user must run: e3cli
 
 ## Core workflow
 
-### 1. Sync first
-Always start with sync so subsequent reads are fresh:
-```bash
-e3cli sync
-```
-The output prints the materials download directory — remember it for step 4.
-
-### 2. Find the right assignment
+### 1. Find the right assignment (no sync needed)
+List and detail commands hit the live Moodle API directly — they do **not** require a prior `e3cli sync`.
 ```bash
 e3cli assignments                  # current semester, sorted by deadline
 e3cli assignments --due-soon 7     # due within 7 days only
 ```
 Each row shows an assignment ID. You need that ID for everything that follows.
 
-### 3. Read the full description
+### 2. Read the full description (no sync needed)
 ```bash
 e3cli assignments --detail <ID>
 ```
 Prints the full description (HTML→text), attachment URLs, submission status, and due date. **Always read this before working** — the one-line summary in `e3cli assignments` is not enough to write a correct submission.
 
-### 4. Pull supporting materials
+### 3. Pull supporting materials — **targeted only**
+Materials may include large media files (mp4 lectures, recordings, slide PDFs). **Never run a blanket sync** unless the user explicitly asks for "sync everything" / "下載全部". Always scope to what the user mentioned.
 ```bash
-e3cli download                     # all current-semester materials
-e3cli download --course "OS"       # specific course (fuzzy match on name)
+# ✓ User mentioned course "OS" or a specific assignment in that course
+e3cli download --course "OS"       # download-only, single course (fuzzy match)
+e3cli sync --course "OS"           # download + refresh assignment status, single course
+
+# ✗ Avoid these unless user explicitly says "all" / "everything" / "全部"
+e3cli sync                         # blanket: every current-semester course
+e3cli download                     # blanket download
 ```
+The output prints the download directory — read the relevant files from there.
 
-### 5. Submit (only after explicit user confirmation)
+### 4. Submit (only after explicit user confirmation)
 ```bash
 e3cli submit <ID> <file>
 e3cli submit <ID> <file1> <file2>          # multiple files

{e3cli-1.0.6 → e3cli-1.0.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "e3cli"
-version = "1.0.6"
+version = "1.0.7"
 description = "NYCU E3 Moodle automation CLI — sync courses, download materials, submit assignments."
 readme = "README.md"
 license = "MIT"