felo-ai 0.2.30 → 0.2.31

package/felo-livedoc/README.md

@@ -11,6 +11,8 @@ Manage knowledge bases (LiveDocs) and their resources via the Felo API.
 - Semantic retrieval across knowledge base resources
 - Route relevant resources by query for targeted retrieval
 - Full CRUD for resources within a LiveDoc
+- Manage README content for each LiveDoc
+- Task management: create, update, delete tasks with comments and change history
 
 **When to use:**
 - Building or managing a knowledge base
@@ -87,8 +89,19 @@ felo livedoc route SHORT_ID --query "latest AI research" --max-resources 5
 | `add-urls <short_id>` | Add URL resources (max 10) |
 | `upload <short_id>` | Upload a file resource |
 | `remove-resource <short_id> <resource_id>` | Delete a resource |
+| `update-resource <short_id> <resource_id>` | Update resource title, snippet, or thumbnail |
 | `retrieve <short_id>` | Semantic retrieval (auto-routes if no `--resource-ids`) |
 | `route <short_id>` | Route relevant resource IDs by query |
+| `get-readme <short_id>` | Get README content |
+| `update-readme <short_id>` | Create or replace README |
+| `append-readme <short_id>` | Append content to README |
+| `delete-readme <short_id>` | Delete README |
+| `tasks <short_id>` | List tasks (filter by `--status`, `--labels`) |
+| `create-task <short_id>` | Create a task |
+| `update-task <short_id> <task_id>` | Partially update a task |
+| `delete-task <short_id> <task_id>` | Delete a task |
+| `task-records <short_id> <task_id>` | List task records (comments + change history) |
+| `add-task-comment <short_id> <task_id>` | Add a comment to a task |
 
 ---
 

package/felo-livedoc/SKILL.md

@@ -14,10 +14,12 @@ Trigger this skill when users want to:
 - **Semantic retrieval:** Search across knowledge base resources using natural language queries
 - **Route resources:** Find relevant resource IDs by query for targeted retrieval
 - **Resource management:** List, view, or delete resources within a LiveDoc
+- **README management:** Get, create, update, append, or delete a LiveDoc's README
+- **Task management:** Create, update, delete tasks; add comments; view change history
 
 **Trigger words:**
-- English: knowledge base, livedoc, live doc, upload document, add URL, semantic search, retrieve, knowledge retrieval, route resources
-- 简体中文: 知识库, 文档库, 上传文档, 添加链接, 语义检索, 知识检索
+- English: knowledge base, livedoc, live doc, upload document, add URL, semantic search, retrieve, knowledge retrieval, route resources, readme, task, task management, comment
+- 简体中文: 知识库, 文档库, 上传文档, 添加链接, 语义检索, 知识检索, 任务, 任务管理, 评论
 
 **Explicit commands:** `/felo-livedoc`, "livedoc", "felo livedoc"
 
@@ -111,6 +113,12 @@ node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs resource SHORT_ID RES
 node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs remove-resource SHORT_ID RESOURCE_ID
 ```
 
+**Update a resource (title/snippet/thumbnail):**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-resource SHORT_ID RESOURCE_ID --title "New Title"
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-resource SHORT_ID RESOURCE_ID --snippet "New summary" --thumbnail "https://example.com/thumb.png"
+```
+
 ### Semantic Retrieval
 
 **Route relevant resources by query:**
@@ -147,6 +155,67 @@ node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs content SHORT_ID RESO
 node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs ppt-retrieve SHORT_ID --resource-id RESOURCE_ID --page-number 3 --query "pricing information"
 node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs ppt-retrieve SHORT_ID --resource-id RESOURCE_ID --page-number 3 --query "pricing information" --max-chunk 5
 ```
+
+### README Management
+
+**Get README:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs get-readme SHORT_ID
+```
+
+**Create or replace README:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-readme SHORT_ID --content "# My KB\n\nThis is the README."
+```
+
+**Append to README:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs append-readme SHORT_ID --content "\n\n## New Section\n\nAdditional content."
+```
+
+**Delete README:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs delete-readme SHORT_ID
+```
+
+### Task Management
+
+**List tasks (with optional filters):**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs tasks SHORT_ID
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs tasks SHORT_ID --status 0
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs tasks SHORT_ID --labels "docs,priority-high"
+```
+
+**Create a task:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs create-task SHORT_ID --title "Write docs" --status 0 --sort 0
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs create-task SHORT_ID --title "Write docs" --status 0 --sort 0 --description "API docs" --labels "docs"
+```
+
+Task status values: `0`=TODO, `1`=IN_PROGRESS, `2`=DONE
+
+**Update a task (partial update):**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-task SHORT_ID TASK_ID --status 1
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-task SHORT_ID TASK_ID --title "New title" --labels "docs,done"
+```
+
+**Delete a task:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs delete-task SHORT_ID TASK_ID
+```
+
+**List task records (comments + change history):**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs task-records SHORT_ID TASK_ID
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs task-records SHORT_ID TASK_ID --record-type comment
+```
+
+**Add a comment to a task:**
+```bash
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-task-comment SHORT_ID TASK_ID --content "This is a comment."
+```
 ### Options
 
 All commands support:
@@ -194,6 +263,16 @@ The API returns JSON with this structure:
 - `LIVEDOC_RESOURCE_UPLOAD_FAILED` — File upload failed
 - `LIVEDOC_RESOURCE_ADD_URLS_FAILED` — URL addition failed
 - `LIVEDOC_RESOURCE_RETRIEVE_FAILED` — Semantic retrieval failed
+- `LIVEDOC_README_GET_FAILED` — Failed to get README
+- `LIVEDOC_README_UPDATE_FAILED` — Failed to create or update README
+- `LIVEDOC_README_DELETE_FAILED` — Failed to delete README
+- `LIVEDOC_TASK_LIST_FAILED` — Failed to list tasks
+- `LIVEDOC_TASK_CREATE_FAILED` — Failed to create task
+- `LIVEDOC_TASK_UPDATE_FAILED` — Failed to update task
+- `LIVEDOC_TASK_DELETE_FAILED` — Failed to delete task
+- `LIVEDOC_TASK_NOT_FOUND` — Task does not exist
+- `LIVEDOC_TASK_RECORD_LIST_FAILED` — Failed to list task records
+- `LIVEDOC_TASK_COMMENT_CREATE_FAILED` — Failed to add comment
 
 ### Missing API Key
 

package/felo-livedoc/scripts/run_livedoc.mjs

@@ -127,6 +127,28 @@ function formatRetrieveResult(r) {
   return out;
 }
 
+function formatTask(t) {
+  if (!t) return '';
+  let out = `### ${t.title || '(untitled)'}\n`;
+  out += `- Task ID: \`${t.id}\`\n`;
+  out += `- Status: ${t.status === 0 ? 'TODO' : t.status === 1 ? 'IN_PROGRESS' : t.status === 2 ? 'DONE' : t.status}\n`;
+  if (t.sort != null) out += `- Sort: ${t.sort}\n`;
+  if (t.description) out += `- Description: ${t.description}\n`;
+  if (t.labels?.length) out += `- Labels: ${t.labels.join(', ')}\n`;
+  if (t.created_at) out += `- Created: ${t.created_at}\n`;
+  out += '\n';
+  return out;
+}
+
+function formatTaskRecord(r) {
+  if (!r) return '';
+  let out = `- [${r.record_type}] `;
+  if (r.content) out += r.content;
+  else if (r.meta) out += JSON.stringify(r.meta);
+  out += `  (id: ${r.id}, ${r.created_at || ''})\n`;
+  return out;
+}
+
 // ── CLI ──
 
 function usage() {
@@ -144,11 +166,22 @@ function usage() {
     '  add-urls <short_id>   Add URLs (--urls required, comma-separated, max 10)',
     '  upload <short_id>     Upload file (--file required, --convert optional)',
     '  remove-resource <short_id> <resource_id>  Delete a resource',
+    '  update-resource <short_id> <resource_id>  Update resource title/snippet/thumbnail',
     '  retrieve <short_id>   Semantic search (--query required, --resource-ids optional)',
     '  route <short_id>      Route relevant resources by query (--query required)',
     '  download <short_id> <resource_id>  Download source file to disk',
     '  content <short_id> <resource_id>   Get text content of a resource',
     '  ppt-retrieve <short_id>  PPT page deep retrieval (--resource-id, --page-number, --query required)',
+    '  get-readme <short_id>    Get README content',
+    '  update-readme <short_id> Create or replace README (--content required)',
+    '  append-readme <short_id> Append to README (--content required)',
+    '  delete-readme <short_id> Delete README',
+    '  tasks <short_id>         List tasks (--status, --labels optional)',
+    '  create-task <short_id>   Create a task (--title, --status, --sort required)',
+    '  update-task <short_id> <task_id>  Partially update a task',
+    '  delete-task <short_id> <task_id>  Delete a task',
+    '  task-records <short_id> <task_id> List task records (comments + history)',
+    '  add-task-comment <short_id> <task_id>  Add a comment (--content required)',
     '',
     'Options:',
     '  --name <name>         LiveDoc name',
@@ -158,8 +191,8 @@ function usage() {
     '  --page <n>            Page number',
     '  --size <n>            Page size',
     '  --type <type>         Resource type filter',
-    '  --content <text>      Document content',
-    '  --title <title>       Document title',
+    '  --content <text>      Document/README/comment content',
+    '  --title <title>       Document/task title',
     '  --urls <urls>         Comma-separated URLs',
     '  --file <path>         File path to upload',
     '  --convert             Convert uploaded file to document',
@@ -171,6 +204,10 @@ function usage() {
     '  --max-chunk <n>       Max chunks to return (ppt-retrieve, default 3)',
     '  --expires-in <s>      Presigned URL expiry in seconds (download, default 3600)',
     '  --output <path>       Output file path (download, default: filename from response)',
+    '  --status <n>          Task status: 0=TODO, 1=IN_PROGRESS, 2=DONE',
+    '  --sort <n>            Task sort order (non-negative integer)',
+    '  --labels <labels>     Comma-separated labels (tasks)',
+    '  --record-type <type>  Record type filter: comment, edit, status_change',
     '  -j, --json            Output raw JSON',
     '  -t, --timeout <ms>    Timeout in ms (default: 60000)',
     '  --help                Show this help',
@@ -181,7 +218,8 @@ function parseArgs(argv) {
     action: '', positional: [], name: '', description: '', icon: '',
     keyword: '', page: '', size: '', type: '', content: '', title: '',
     urls: '', file: '', convert: false, query: '', resourceIds: '', maxResources: '',
-    resourceId: '', pageNumber: '', maxChunk: '', expiresIn: '',
+    resourceId: '', pageNumber: '', maxChunk: '', expiresIn: '', output: '',
+    status: '', sort: '', labels: '', recordType: '',
     json: false, timeoutMs: DEFAULT_TIMEOUT_MS, help: false,
   };
   const positional = [];
@@ -208,6 +246,11 @@ function parseArgs(argv) {
     else if (a === '--page-number') out.pageNumber = argv[++i] || '';
     else if (a === '--max-chunk') out.maxChunk = argv[++i] || '';
     else if (a === '--expires-in') out.expiresIn = argv[++i] || '';
+    else if (a === '--output') out.output = argv[++i] || '';
+    else if (a === '--status') out.status = argv[++i] || '';
+    else if (a === '--sort') out.sort = argv[++i] || '';
+    else if (a === '--labels') out.labels = argv[++i] || '';
+    else if (a === '--record-type') out.recordType = argv[++i] || '';
     else if (a === '-t' || a === '--timeout') {
       const n = parseInt(argv[++i] || '', 10);
       if (Number.isFinite(n) && n > 0) out.timeoutMs = n;
@@ -374,6 +417,19 @@ async function main() {
         code = 0;
         break;
       }
+      case 'update-resource': {
+        if (!shortId || !resourceId) { console.error('ERROR: short_id and resource_id are required'); break; }
+        spinnerId = startSpinner('Updating resource');
+        const body = {};
+        if (args.title !== undefined) body.title = args.title;
+        if (args.snippet !== undefined) body.snippet = args.snippet;
+        if (args.thumbnail !== undefined) body.thumbnail = args.thumbnail;
+        const payload = await apiRequest('PUT', `/livedocs/${shortId}/resources/${resourceId}`, body, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('Resource updated!\n\n'); process.stdout.write(formatResource(payload?.data)); }
+        code = 0;
+        break;
+      }
       case 'retrieve': {
         if (!shortId) { console.error('ERROR: short_id is required'); break; }
         if (!args.query) { console.error('ERROR: --query is required'); break; }
@@ -490,6 +546,140 @@ async function main() {
         code = 0;
         break;
       }
+      case 'get-readme': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        spinnerId = startSpinner('Fetching README');
+        const payload = await apiRequest('GET', `/livedocs/${shortId}/readme`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write(payload?.data?.content || '(empty)\n'); }
+        code = 0;
+        break;
+      }
+      case 'update-readme': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (args.content === undefined || args.content === '') { console.error('ERROR: --content is required'); break; }
+        spinnerId = startSpinner('Updating README');
+        await apiRequest('PUT', `/livedocs/${shortId}/readme`, { content: args.content }, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify({ status: 'ok' }, null, 2)); }
+        else { process.stdout.write('README updated.\n'); }
+        code = 0;
+        break;
+      }
+      case 'append-readme': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!args.content) { console.error('ERROR: --content is required'); break; }
+        spinnerId = startSpinner('Appending to README');
+        await apiRequest('POST', `/livedocs/${shortId}/readme/append`, { content: args.content }, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify({ status: 'ok' }, null, 2)); }
+        else { process.stdout.write('README appended.\n'); }
+        code = 0;
+        break;
+      }
+      case 'delete-readme': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        spinnerId = startSpinner('Deleting README');
+        await apiRequest('DELETE', `/livedocs/${shortId}/readme`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify({ status: 'ok' }, null, 2)); }
+        else { process.stdout.write('README deleted.\n'); }
+        code = 0;
+        break;
+      }
+      case 'tasks': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        spinnerId = startSpinner('Listing tasks');
+        const params = new URLSearchParams();
+        if (args.status !== '') params.set('status', args.status);
+        if (args.labels) args.labels.split(',').map(l => l.trim()).filter(Boolean).forEach(l => params.append('labels', l));
+        if (args.page) params.set('page', args.page);
+        if (args.size) params.set('size', args.size);
+        const qs = params.toString();
+        const payload = await apiRequest('GET', `/livedocs/${shortId}/tasks${qs ? `?${qs}` : ''}`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else {
+          const items = payload?.data?.items || [];
+          if (!items.length) { process.stderr.write('No tasks found.\n'); }
+          else {
+            process.stdout.write(`Found ${payload.data.total || items.length} task(s)\n\n`);
+            for (const t of items) process.stdout.write(formatTask(t));
+          }
+        }
+        code = 0;
+        break;
+      }
+      case 'create-task': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!args.title) { console.error('ERROR: --title is required'); break; }
+        if (args.status === '') { console.error('ERROR: --status is required'); break; }
+        if (args.sort === '') { console.error('ERROR: --sort is required'); break; }
+        spinnerId = startSpinner('Creating task');
+        const body = { title: args.title, status: parseInt(args.status, 10), sort: parseInt(args.sort, 10) };
+        if (args.description) body.description = args.description;
+        if (args.labels) body.labels = args.labels.split(',').map(l => l.trim()).filter(Boolean);
+        const payload = await apiRequest('POST', `/livedocs/${shortId}/tasks`, body, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('Task created!\n\n'); process.stdout.write(formatTask(payload?.data)); }
+        code = 0;
+        break;
+      }
+      case 'update-task': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!resourceId) { console.error('ERROR: task_id is required'); break; }
+        spinnerId = startSpinner('Updating task');
+        const body = {};
+        if (args.title) body.title = args.title;
+        if (args.description !== undefined) body.description = args.description;
+        if (args.status !== '') body.status = parseInt(args.status, 10);
+        if (args.sort !== '') body.sort = parseInt(args.sort, 10);
+        if (args.labels !== undefined) body.labels = args.labels.split(',').map(l => l.trim()).filter(Boolean);
+        const payload = await apiRequest('PATCH', `/livedocs/${shortId}/tasks/${resourceId}`, body, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('Task updated!\n\n'); process.stdout.write(formatTask(payload?.data)); }
+        code = 0;
+        break;
+      }
+      case 'delete-task': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!resourceId) { console.error('ERROR: task_id is required'); break; }
+        spinnerId = startSpinner('Deleting task');
+        await apiRequest('DELETE', `/livedocs/${shortId}/tasks/${resourceId}`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify({ status: 'ok' }, null, 2)); }
+        else { process.stdout.write(`Task \`${resourceId}\` deleted.\n`); }
+        code = 0;
+        break;
+      }
+      case 'task-records': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!resourceId) { console.error('ERROR: task_id is required'); break; }
+        spinnerId = startSpinner('Fetching task records');
+        const params = new URLSearchParams();
+        if (args.recordType) params.set('record_type', args.recordType);
+        if (args.page) params.set('page', args.page);
+        if (args.size) params.set('size', args.size);
+        const qs = params.toString();
+        const payload = await apiRequest('GET', `/livedocs/${shortId}/tasks/${resourceId}/records${qs ? `?${qs}` : ''}`, null, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else {
+          const items = payload?.data?.items || [];
+          if (!items.length) { process.stderr.write('No records found.\n'); }
+          else {
+            process.stdout.write(`Found ${payload.data.total || items.length} record(s)\n\n`);
+            for (const r of items) process.stdout.write(formatTaskRecord(r));
+          }
+        }
+        code = 0;
+        break;
+      }
+      case 'add-task-comment': {
+        if (!shortId) { console.error('ERROR: short_id is required'); break; }
+        if (!resourceId) { console.error('ERROR: task_id is required'); break; }
+        if (!args.content) { console.error('ERROR: --content is required'); break; }
+        spinnerId = startSpinner('Adding comment');
+        const payload = await apiRequest('POST', `/livedocs/${shortId}/tasks/${resourceId}/comments`, { content: args.content }, apiKey, apiBase, timeoutMs);
+        if (json) { console.log(JSON.stringify(payload, null, 2)); }
+        else { process.stdout.write('Comment added.\n'); process.stdout.write(formatTaskRecord(payload?.data)); }
+        code = 0;
+        break;
+      }
       default:
         console.error(`Unknown action: ${action}`);
         usage();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "felo-ai",
-  "version": "0.2.30",
+  "version": "0.2.31",
   "description": "Felo AI CLI - real-time search, PPT generation, SuperAgent conversation, LiveDoc management, web fetch, YouTube subtitles, LiveDoc knowledge base, and X (Twitter) search from the terminal",
   "type": "module",
   "main": "src/cli.js",

package/src/cli.js

@@ -673,6 +673,27 @@ livedocCmd
     flushStdioThenExit(code);
   });
 
+livedocCmd
+  .command("update-resource <short_id> <resource_id>")
+  .description("Update a resource's title, snippet, or thumbnail")
+  .option("--title <title>", "new resource title (max 500 characters)")
+  .option("--snippet <text>", "new resource summary (max 2000 characters)")
+  .option("--thumbnail <url>", "new thumbnail URL (max 2000 characters)")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, resourceId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.updateResource(shortId, resourceId, {
+      title: opts.title,
+      snippet: opts.snippet,
+      thumbnail: opts.thumbnail,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
 livedocCmd
   .command("retrieve <short_id>")
   .description("Semantic search across resources")
@@ -766,6 +787,200 @@ livedocCmd
     flushStdioThenExit(code);
   });
 
+// ── LiveDoc README ──
+
+livedocCmd
+  .command("get-readme <short_id>")
+  .description("Get the README of a LiveDoc")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.getReadme(shortId, {
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("update-readme <short_id>")
+  .description("Create or replace the README of a LiveDoc")
+  .requiredOption("--content <text>", "README content (Markdown)")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.upsertReadme(shortId, {
+      content: opts.content,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("append-readme <short_id>")
+  .description("Append content to the README of a LiveDoc")
+  .requiredOption("--content <text>", "content to append (Markdown)")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.appendReadme(shortId, {
+      content: opts.content,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("delete-readme <short_id>")
+  .description("Delete the README of a LiveDoc")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.deleteReadme(shortId, {
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+// ── LiveDoc Tasks ──
+
+livedocCmd
+  .command("tasks <short_id>")
+  .description("List tasks in a LiveDoc")
+  .option("--status <n>", "filter by status: 0=TODO, 1=IN_PROGRESS, 2=DONE")
+  .option("--labels <labels>", "filter by labels (comma-separated)")
+  .option("--page <n>", "page number")
+  .option("--size <n>", "page size")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.listTasks(shortId, {
+      status: opts.status,
+      labels: opts.labels,
+      page: opts.page,
+      size: opts.size,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("create-task <short_id>")
+  .description("Create a task in a LiveDoc")
+  .requiredOption("--title <title>", "task title")
+  .requiredOption("--status <n>", "task status: 0=TODO, 1=IN_PROGRESS, 2=DONE")
+  .requiredOption("--sort <n>", "sort order (non-negative integer)")
+  .option("--description <desc>", "task description")
+  .option("--labels <labels>", "comma-separated labels (max 10)")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.createTask(shortId, {
+      title: opts.title,
+      status: opts.status,
+      sort: opts.sort,
+      description: opts.description,
+      labels: opts.labels,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("update-task <short_id> <task_id>")
+  .description("Partially update a task (only provided fields are changed)")
+  .option("--title <title>", "new task title")
+  .option("--description <desc>", "new task description")
+  .option("--status <n>", "new status: 0=TODO, 1=IN_PROGRESS, 2=DONE")
+  .option("--sort <n>", "new sort order")
+  .option("--labels <labels>", "new comma-separated labels")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, taskId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.updateTask(shortId, taskId, {
+      title: opts.title,
+      description: opts.description,
+      status: opts.status,
+      sort: opts.sort,
+      labels: opts.labels,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("delete-task <short_id> <task_id>")
+  .description("Delete a task")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, taskId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.deleteTask(shortId, taskId, {
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("task-records <short_id> <task_id>")
+  .description("List records (comments + change history) for a task")
+  .option("--record-type <type>", "filter by type: comment, edit, status_change")
+  .option("--page <n>", "page number")
+  .option("--size <n>", "page size")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, taskId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.listTaskRecords(shortId, taskId, {
+      recordType: opts.recordType,
+      page: opts.page,
+      size: opts.size,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
+livedocCmd
+  .command("add-task-comment <short_id> <task_id>")
+  .description("Add a comment to a task")
+  .requiredOption("--content <text>", "comment content")
+  .option("-j, --json", "output raw JSON")
+  .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
+  .action(async (shortId, taskId, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await livedoc.createTaskComment(shortId, taskId, {
+      content: opts.content,
+      json: opts.json,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
 program
   .command("summarize")
   .description("Summarize text or URL (coming when API is available)")

package/src/livedoc.js

@@ -375,6 +375,31 @@ export async function removeResource(shortId, resourceId, opts = {}) {
   } finally { stopSpinner(spinnerId); }
 }
 
+export async function updateResource(shortId, resourceId, opts = {}) {
+  const apiKey = await getApiKey();
+  if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
+  if (!shortId || !resourceId) { process.stderr.write('ERROR: short_id and resource_id are required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Updating resource');
+
+  try {
+    const body = {};
+    if (opts.title !== undefined) body.title = opts.title;
+    if (opts.snippet !== undefined) body.snippet = opts.snippet;
+    if (opts.thumbnail !== undefined) body.thumbnail = opts.thumbnail;
+    const payload = await apiRequest('PUT', `/livedocs/${shortId}/resources/${resourceId}`, body, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify(payload, null, 2)); return 0; }
+    process.stdout.write('Resource updated!\n\n');
+    process.stdout.write(formatResource(payload?.data));
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to update resource: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
 export async function route(shortId, opts = {}) {
   const apiKey = await getApiKey();
   if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
@@ -532,6 +557,268 @@ export async function getResourceContent(shortId, resourceId, opts = {}) {
   } finally { stopSpinner(spinnerId); }
 }
 
+// ── README ──
+
+export async function getReadme(shortId, opts = {}) {
+  const apiKey = await getApiKey();
+  if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
+  if (!shortId) { process.stderr.write('ERROR: short_id is required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Fetching README');
+
+  try {
+    const payload = await apiRequest('GET', `/livedocs/${shortId}/readme`, null, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify(payload, null, 2)); return 0; }
+    const content = payload?.data?.content ?? '';
+    process.stdout.write(content || '(empty)\n');
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to get README: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
+export async function upsertReadme(shortId, opts = {}) {
+  const apiKey = await getApiKey();
+  if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
+  if (!shortId) { process.stderr.write('ERROR: short_id is required.\n'); return 1; }
+  if (opts.content === undefined || opts.content === null) { process.stderr.write('ERROR: --content is required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Updating README');
+
+  try {
+    const payload = await apiRequest('PUT', `/livedocs/${shortId}/readme`, { content: opts.content }, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify(payload, null, 2)); return 0; }
+    process.stdout.write('README updated.\n');
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to update README: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
+export async function appendReadme(shortId, opts = {}) {
+  const apiKey = await getApiKey();
+  if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
+  if (!shortId) { process.stderr.write('ERROR: short_id is required.\n'); return 1; }
+  if (!opts.content) { process.stderr.write('ERROR: --content is required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Appending to README');
+
+  try {
+    const payload = await apiRequest('POST', `/livedocs/${shortId}/readme/append`, { content: opts.content }, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify(payload, null, 2)); return 0; }
+    process.stdout.write('README appended.\n');
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to append README: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
+export async function deleteReadme(shortId, opts = {}) {
+  const apiKey = await getApiKey();
+  if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
+  if (!shortId) { process.stderr.write('ERROR: short_id is required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Deleting README');
+
+  try {
+    await apiRequest('DELETE', `/livedocs/${shortId}/readme`, null, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify({ status: 'ok' }, null, 2)); return 0; }
+    process.stdout.write('README deleted.\n');
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to delete README: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
+// ── Tasks ──
+
+function formatTask(t) {
+  if (!t) return '';
+  let out = `### ${t.title || '(untitled)'}\n`;
+  out += `- Task ID: \`${t.id}\`\n`;
+  out += `- Status: ${t.status === 0 ? 'TODO' : t.status === 1 ? 'IN_PROGRESS' : t.status === 2 ? 'DONE' : t.status}\n`;
+  if (t.sort != null) out += `- Sort: ${t.sort}\n`;
+  if (t.description) out += `- Description: ${t.description}\n`;
+  if (t.labels?.length) out += `- Labels: ${t.labels.join(', ')}\n`;
+  if (t.created_at) out += `- Created: ${t.created_at}\n`;
+  out += '\n';
+  return out;
+}
+
+function formatTaskRecord(r) {
+  if (!r) return '';
+  let out = `- [${r.record_type}] `;
+  if (r.content) out += r.content;
+  else if (r.meta) out += JSON.stringify(r.meta);
+  out += `  (id: ${r.id}, ${r.created_at || ''})\n`;
+  return out;
+}
+
+export async function listTasks(shortId, opts = {}) {
+  const apiKey = await getApiKey();
+  if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
+  if (!shortId) { process.stderr.write('ERROR: short_id is required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Listing tasks');
+
+  try {
+    const params = new URLSearchParams();
+    if (opts.status !== undefined && opts.status !== '') params.set('status', opts.status);
+    if (opts.labels) opts.labels.split(',').map(l => l.trim()).filter(Boolean).forEach(l => params.append('labels', l));
+    if (opts.page) params.set('page', opts.page);
+    if (opts.size) params.set('size', opts.size);
+    const qs = params.toString();
+    const payload = await apiRequest('GET', `/livedocs/${shortId}/tasks${qs ? `?${qs}` : ''}`, null, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify(payload, null, 2)); return 0; }
+    const items = payload?.data?.items || [];
+    if (!items.length) { process.stderr.write('No tasks found.\n'); return 0; }
+    process.stdout.write(`Found ${payload.data.total || items.length} task(s)\n\n`);
+    for (const t of items) process.stdout.write(formatTask(t));
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to list tasks: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
+export async function createTask(shortId, opts = {}) {
+  const apiKey = await getApiKey();
+  if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
+  if (!shortId) { process.stderr.write('ERROR: short_id is required.\n'); return 1; }
+  if (!opts.title) { process.stderr.write('ERROR: --title is required.\n'); return 1; }
+  if (opts.status === undefined || opts.status === '') { process.stderr.write('ERROR: --status is required.\n'); return 1; }
+  if (opts.sort === undefined || opts.sort === '') { process.stderr.write('ERROR: --sort is required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Creating task');
+
+  try {
+    const body = { title: opts.title, status: parseInt(opts.status, 10), sort: parseInt(opts.sort, 10) };
+    if (opts.description) body.description = opts.description;
+    if (opts.labels) body.labels = opts.labels.split(',').map(l => l.trim()).filter(Boolean);
+    const payload = await apiRequest('POST', `/livedocs/${shortId}/tasks`, body, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify(payload, null, 2)); return 0; }
+    process.stdout.write('Task created!\n\n');
+    process.stdout.write(formatTask(payload?.data));
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to create task: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
+export async function updateTask(shortId, taskId, opts = {}) {
+  const apiKey = await getApiKey();
+  if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
+  if (!shortId || !taskId) { process.stderr.write('ERROR: short_id and task_id are required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Updating task');
+
+  try {
+    const body = {};
+    if (opts.title) body.title = opts.title;
+    if (opts.description !== undefined) body.description = opts.description;
+    if (opts.status !== undefined && opts.status !== '') body.status = parseInt(opts.status, 10);
+    if (opts.sort !== undefined && opts.sort !== '') body.sort = parseInt(opts.sort, 10);
+    if (opts.labels !== undefined) body.labels = opts.labels.split(',').map(l => l.trim()).filter(Boolean);
+    const payload = await apiRequest('PATCH', `/livedocs/${shortId}/tasks/${taskId}`, body, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify(payload, null, 2)); return 0; }
+    process.stdout.write('Task updated!\n\n');
+    process.stdout.write(formatTask(payload?.data));
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to update task: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
+export async function deleteTask(shortId, taskId, opts = {}) {
+  const apiKey = await getApiKey();
+  if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
+  if (!shortId || !taskId) { process.stderr.write('ERROR: short_id and task_id are required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Deleting task');
+
+  try {
+    await apiRequest('DELETE', `/livedocs/${shortId}/tasks/${taskId}`, null, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify({ status: 'ok' }, null, 2)); return 0; }
+    process.stdout.write(`Task \`${taskId}\` deleted.\n`);
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to delete task: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
+export async function listTaskRecords(shortId, taskId, opts = {}) {
+  const apiKey = await getApiKey();
+  if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
+  if (!shortId || !taskId) { process.stderr.write('ERROR: short_id and task_id are required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Fetching task records');
+
+  try {
+    const params = new URLSearchParams();
+    if (opts.recordType) params.set('record_type', opts.recordType);
+    if (opts.page) params.set('page', opts.page);
+    if (opts.size) params.set('size', opts.size);
+    const qs = params.toString();
+    const payload = await apiRequest('GET', `/livedocs/${shortId}/tasks/${taskId}/records${qs ? `?${qs}` : ''}`, null, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify(payload, null, 2)); return 0; }
+    const items = payload?.data?.items || [];
+    if (!items.length) { process.stderr.write('No records found.\n'); return 0; }
+    process.stdout.write(`Found ${payload.data.total || items.length} record(s)\n\n`);
+    for (const r of items) process.stdout.write(formatTaskRecord(r));
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to list task records: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
+export async function createTaskComment(shortId, taskId, opts = {}) {
+  const apiKey = await getApiKey();
+  if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }
+  if (!shortId || !taskId) { process.stderr.write('ERROR: short_id and task_id are required.\n'); return 1; }
+  if (!opts.content) { process.stderr.write('ERROR: --content is required.\n'); return 1; }
+
+  const apiBase = await getApiBase();
+  const timeoutMs = opts.timeoutMs || DEFAULT_TIMEOUT_MS;
+  const spinnerId = startSpinner('Adding comment');
+
+  try {
+    const payload = await apiRequest('POST', `/livedocs/${shortId}/tasks/${taskId}/comments`, { content: opts.content }, apiKey, apiBase, timeoutMs);
+    if (opts.json) { console.log(JSON.stringify(payload, null, 2)); return 0; }
+    process.stdout.write('Comment added.\n');
+    process.stdout.write(formatTaskRecord(payload?.data));
+    return 0;
+  } catch (err) {
+    process.stderr.write(`Failed to add comment: ${err?.message || err}\n`);
+    return 1;
+  } finally { stopSpinner(spinnerId); }
+}
+
 export async function pptRetrieve(shortId, opts = {}) {
   const apiKey = await getApiKey();
   if (!apiKey) { console.error(NO_KEY_MESSAGE.trim()); return 1; }