felo-ai 0.2.35 → 0.2.42

package/README.md

@@ -113,6 +113,13 @@ felo livedoc retrieve SHORT_ID --query "search query"
 
 **Apple Buy Advisor** — [full options →](./apple-buy-advisor/SKILL.md)
 
+```bash
+# Use as Felo CLI command
+felo apple-buy-advisor "Should I buy MacBook Pro M4?"
+felo apple-buy-advisor "Compare iPhone 17 vs iPhone 17e"
+felo apple-buy-advisor "Is it worth upgrading to iPad Air 13?"
+```
+
 ```bash
 # Use as Claude Code skill
 /apple-buy-advisor Should I buy MacBook Pro M4?

package/felo-livedoc/SKILL.md

@@ -191,6 +191,7 @@ node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs tasks SHORT_ID --labe
 ```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"
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs create-task SHORT_ID --title "Write docs" --operated-by "claude-code"
 ```
 
 Task status values: `0`=TODO, `1`=IN_PROGRESS, `2`=DONE
@@ -199,6 +200,7 @@ Task status values: `0`=TODO, `1`=IN_PROGRESS, `2`=DONE
 ```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"
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs update-task SHORT_ID TASK_ID --status 2 --operated-by "claude-code"
 ```
 
 **Delete a task:**
@@ -215,6 +217,7 @@ node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs task-records SHORT_ID
 **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."
+node ~/.agents/skills/felo-livedoc/scripts/run_livedoc.mjs add-task-comment SHORT_ID TASK_ID --content "This is a comment." --operated-by "claude-code"
 ```
 ### Options
 

package/felo-livedoc/scripts/run_livedoc.mjs

@@ -208,6 +208,7 @@ function usage() {
     '  --sort <n>            Task sort order (non-negative integer)',
     '  --labels <labels>     Comma-separated labels (tasks)',
     '  --record-type <type>  Record type filter: comment, edit, status_change',
+    '  --operated-by <sig>   Operator signature, e.g. claude-code, openclaw (max 100 chars)',
     '  -j, --json            Output raw JSON',
     '  -t, --timeout <ms>    Timeout in ms (default: 60000)',
     '  --help                Show this help',
@@ -219,7 +220,7 @@ function parseArgs(argv) {
     keyword: '', page: '', size: '', type: '', content: '', title: '',
     urls: '', file: '', convert: false, query: '', resourceIds: '', maxResources: '',
     resourceId: '', pageNumber: '', maxChunk: '', expiresIn: '', output: '',
-    status: '', sort: '', labels: '', recordType: '',
+    status: '', sort: '', labels: '', recordType: '', operatedBy: '',
     json: false, timeoutMs: DEFAULT_TIMEOUT_MS, help: false,
   };
   const positional = [];
@@ -251,6 +252,7 @@ function parseArgs(argv) {
     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 === '--operated-by') out.operatedBy = argv[++i] || '';
     else if (a === '-t' || a === '--timeout') {
       const n = parseInt(argv[++i] || '', 10);
       if (Number.isFinite(n) && n > 0) out.timeoutMs = n;
@@ -615,6 +617,7 @@ async function main() {
         const body = { title: args.title, status, sort };
         if (args.description) body.description = args.description;
         body.labels = args.labels ? args.labels.split(',').map(l => l.trim()).filter(Boolean) : [];
+        if (args.operatedBy) body.operated_by = args.operatedBy;
         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)); }
@@ -631,6 +634,7 @@ async function main() {
         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);
+        if (args.operatedBy) body.operated_by = args.operatedBy;
         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)); }
@@ -674,7 +678,9 @@ async function main() {
         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);
+        const body = { content: args.content };
+        if (args.operatedBy) body.operated_by = args.operatedBy;
+        const payload = await apiRequest('POST', `/livedocs/${shortId}/tasks/${resourceId}/comments`, body, 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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "felo-ai",
-  "version": "0.2.35",
+  "version": "0.2.42",
   "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/appleBuyAdvisor.js

@@ -0,0 +1,17 @@
+import { superAgent } from './superAgent.js';
+
+function buildAppleBuyAdvisorPrompt(query) {
+  const trimmed = String(query || '').trim();
+  return [
+    `/apple-buy-advisor ${trimmed}`,
+    '',
+    'If slash-style skill routing is unavailable, still act as an Apple product buy advisor.',
+    'Use current information, compare relevant Apple models, summarize user and professional feedback when possible, and end with a clear buying recommendation.',
+  ].join('\n');
+}
+
+export async function appleBuyAdvisor(query, options = {}) {
+  return superAgent(buildAppleBuyAdvisorPrompt(query), options);
+}
+
+export { buildAppleBuyAdvisorPrompt };

package/src/cli.js

@@ -5,6 +5,7 @@ import { Command } from "commander";
 import { search } from "./search.js";
 import { slides, listPptThemes } from "./slides.js";
 import { superAgent, listLiveDocs, listLiveDocResources } from "./superAgent.js";
+import { appleBuyAdvisor } from "./appleBuyAdvisor.js";
 import { webFetch } from "./webFetch.js";
 import { youtubeSubtitling } from "./youtubeSubtitling.js";
 import { contentToSlides } from "./contentToSlides.js";
@@ -176,6 +177,30 @@ program
     flushStdioThenExit(code);
   });
 
+program
+  .command("apple-buy-advisor")
+  .description("Research and compare Apple products before you buy")
+  .argument("<query>", "Apple product buying or comparison question")
+  .option("-j, --json", "output JSON with answer, thread_short_id, live_doc_short_id")
+  .option("-v, --verbose", "log stream key, thread ID, LiveDoc ID to stderr")
+  .option("-t, --timeout <seconds>", "request/stream timeout in seconds", "60")
+  .option("--live-doc-id <id>", "reuse existing LiveDoc short_id for continuous conversation")
+  .option("--thread-id <id>", "existing thread/conversation ID for follow-up questions")
+  .option("--accept-language <lang>", "language preference (e.g. zh, en)")
+  .action(async (query, opts) => {
+    const timeoutMs = parseInt(opts.timeout, 10) * 1000;
+    const code = await appleBuyAdvisor(query, {
+      json: opts.json,
+      verbose: opts.verbose,
+      timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
+      liveDocId: opts.liveDocId || undefined,
+      threadId: opts.threadId || undefined,
+      acceptLanguage: opts.acceptLanguage || undefined,
+    });
+    process.exitCode = code;
+    flushStdioThenExit(code);
+  });
+
 program
   .command("livedocs")
   .description("List LiveDocs with pagination and optional keyword filtering")
@@ -886,6 +911,7 @@ livedocCmd
   .option("--sort <n>", "sort order (non-negative integer, default: 0)")
   .option("--description <desc>", "task description")
   .option("--labels <labels>", "comma-separated labels (max 10)")
+  .option("--operated-by <signature>", "operator signature, e.g. claude-code, openclaw (max 100 characters)")
   .option("-j, --json", "output raw JSON")
   .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
   .action(async (shortId, opts) => {
@@ -896,6 +922,7 @@ livedocCmd
       sort: opts.sort,
       description: opts.description,
       labels: opts.labels,
+      operatedBy: opts.operatedBy,
       json: opts.json,
       timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
     });
@@ -911,6 +938,7 @@ livedocCmd
   .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("--operated-by <signature>", "operator signature, e.g. claude-code, openclaw (max 100 characters)")
   .option("-j, --json", "output raw JSON")
   .option("-t, --timeout <seconds>", "request timeout in seconds", "60")
   .action(async (shortId, taskId, opts) => {
@@ -921,6 +949,7 @@ livedocCmd
       status: opts.status,
       sort: opts.sort,
       labels: opts.labels,
+      operatedBy: opts.operatedBy,
       json: opts.json,
       timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
     });
@@ -968,12 +997,14 @@ livedocCmd
   .command("add-task-comment <short_id> <task_id>")
   .description("Add a comment to a task")
   .requiredOption("--content <text>", "comment content")
+  .option("--operated-by <signature>", "operator signature, e.g. claude-code, openclaw (max 100 characters)")
   .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,
+      operatedBy: opts.operatedBy,
       json: opts.json,
       timeoutMs: Number.isNaN(timeoutMs) ? 60000 : timeoutMs,
     });

package/src/livedoc.js

@@ -711,6 +711,7 @@ export async function createTask(shortId, opts = {}) {
     const body = { title: opts.title, status, sort };
     if (opts.description) body.description = opts.description;
     body.labels = opts.labels ? opts.labels.split(',').map(l => l.trim()).filter(Boolean) : [];
+    if (opts.operatedBy) body.operated_by = opts.operatedBy;
     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');
@@ -738,6 +739,7 @@ export async function updateTask(shortId, taskId, opts = {}) {
     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);
+    if (opts.operatedBy) body.operated_by = opts.operatedBy;
     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');
@@ -808,7 +810,9 @@ export async function createTaskComment(shortId, taskId, opts = {}) {
   const spinnerId = startSpinner('Adding comment');
 
   try {
-    const payload = await apiRequest('POST', `/livedocs/${shortId}/tasks/${taskId}/comments`, { content: opts.content }, apiKey, apiBase, timeoutMs);
+    const body = { content: opts.content };
+    if (opts.operatedBy) body.operated_by = opts.operatedBy;
+    const payload = await apiRequest('POST', `/livedocs/${shortId}/tasks/${taskId}/comments`, body, 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));

package/tests/cli.test.js

@@ -0,0 +1,26 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+
+const cliPath = path.resolve('src/cli.js');
+
+describe('CLI command registration', () => {
+  it('shows apple-buy-advisor in top-level help', () => {
+    const result = spawnSync(process.execPath, [cliPath, '--help'], {
+      encoding: 'utf8',
+    });
+
+    assert.strictEqual(result.status, 0);
+    assert.match(result.stdout, /apple-buy-advisor/);
+  });
+
+  it('shows help for apple-buy-advisor command', () => {
+    const result = spawnSync(process.execPath, [cliPath, 'apple-buy-advisor', '--help'], {
+      encoding: 'utf8',
+    });
+
+    assert.strictEqual(result.status, 0);
+    assert.match(result.stdout, /Research and compare Apple products before you buy/);
+  });
+});