@1a35e1/sonar-cli 0.4.0 → 0.4.2

package/README.md

@@ -229,10 +229,32 @@ sonar topics suggest --json          # raw suggestions as JSON
 
 Requires `OPENAI_API_KEY` or `ANTHROPIC_API_KEY` depending on vendor.
 
-### Pipeline
+### Account
+
+```bash
+sonar account                        # list accounts, * marks active
+sonar account add <key>              # add account (random name)
+sonar account add <key> --alias work # add with custom name
+sonar account switch <name>          # switch active account
+sonar account rename <old> <new>     # rename an account
+sonar account remove <name>          # remove (--force if active)
+```
+
+### Refresh
+
+```bash
+sonar refresh                        # full pipeline (all steps)
+sonar refresh --bookmarks            # just sync bookmarks from X
+sonar refresh --likes                # just sync likes from X
+sonar refresh --graph                # just rebuild social graph
+sonar refresh --tweets               # just index tweets
+sonar refresh --suggestions          # just regenerate suggestions
+sonar refresh --likes --bookmarks    # any combo of flags
+```
+
+### Status
 
 ```bash
-sonar refresh                        # full pipeline: graph → tweets → suggestions
 sonar status                         # account status, queue activity
 sonar status --watch                 # poll every 2s
 ```
@@ -245,17 +267,24 @@ sonar later --id <suggestion_id>     # save for later
 sonar archive --id <suggestion_id>   # archive a suggestion
 ```
 
-### Config
+### Data
 
 ```bash
-sonar config                         # show current config
-sonar config setup key=<API_KEY>     # set API key
+sonar data pull                      # download feed/suggestions/topics to local SQLite
+sonar data backup                    # backup local DB
+sonar data restore --from <path>     # restore from backup
+sonar data verify                    # integrity check
+sonar data path                      # show DB location
+sonar data sql                       # query helper
 ```
 
-### Sync
+### Config
 
 ```bash
-sonar sync bookmarks                 # sync bookmarks to local SQLite
+sonar config                         # show current config
+sonar config setup --key=<API_KEY>   # legacy setup
+sonar config set vendor anthropic    # set AI vendor
+sonar config skill --install         # install OpenClaw skill (--force to overwrite)
 ```
 
 ---

package/dist/commands/config/skill.js

@@ -6,10 +6,11 @@ import { writeSkillTo } from '../../lib/skill.js';
 export const options = zod.object({
     install: zod.boolean().default(false).describe('Install to ~/.claude/skills/sonar/SKILL.md'),
     dest: zod.string().optional().describe('Write to a custom path'),
+    force: zod.boolean().default(false).describe('Overwrite even if file was modified'),
 });
 export default function Skill({ options: flags }) {
     useEffect(() => {
-        writeSkillTo(flags.dest, flags.install);
+        writeSkillTo(flags.dest, flags.install, flags.force);
     }, []);
     return _jsx(Text, { dimColor: true, children: "Generating SKILL.md..." });
 }

package/dist/lib/skill.js

@@ -1,4 +1,5 @@
-import { writeFileSync, mkdirSync } from 'node:fs';
+import { writeFileSync, readFileSync, existsSync, mkdirSync } from 'node:fs';
+import { createHash } from 'node:crypto';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 const SKILL_CONTENT = `---
@@ -109,18 +110,33 @@ sonar config nuke --confirm
 | \`ANTHROPIC_API_KEY\` | Required when vendor is \`anthropic\` |
 `;
 const DEFAULT_INSTALL_PATH = join(homedir(), '.claude', 'skills', 'sonar', 'SKILL.md');
-export function writeSkillTo(dest, install) {
+function sha256(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+function safeWrite(target, content, force) {
+    if (existsSync(target) && !force) {
+        const existing = readFileSync(target, 'utf8');
+        if (existing === content) {
+            process.stdout.write(`SKILL.md is already up to date: ${target}\n`);
+            process.exit(0);
+        }
+        // File exists and differs — user may have customized it
+        process.stderr.write(`SKILL.md has been modified: ${target}\n` +
+            `Use --force to overwrite, or manually merge.\n` +
+            `New version hash: ${sha256(content).slice(0, 8)}\n`);
+        process.exit(1);
+    }
+    mkdirSync(dirname(target), { recursive: true });
+    writeFileSync(target, content, 'utf8');
+    process.stdout.write(`SKILL.md written to ${target}\n`);
+}
+export function writeSkillTo(dest, install, force) {
     if (install || dest === '--install') {
-        const target = DEFAULT_INSTALL_PATH;
-        mkdirSync(dirname(target), { recursive: true });
-        writeFileSync(target, SKILL_CONTENT, 'utf8');
-        process.stdout.write(`SKILL.md written to ${target}\n`);
+        safeWrite(DEFAULT_INSTALL_PATH, SKILL_CONTENT, force ?? false);
         process.exit(0);
     }
     if (dest) {
-        mkdirSync(dirname(dest), { recursive: true });
-        writeFileSync(dest, SKILL_CONTENT, 'utf8');
-        process.stdout.write(`SKILL.md written to ${dest}\n`);
+        safeWrite(dest, SKILL_CONTENT, force ?? false);
         process.exit(0);
     }
     // Default: print to stdout

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1a35e1/sonar-cli",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "X social graph CLI for signal filtering and curation",
   "type": "module",
   "bin": {

package/dist/commands/sync/bookmarks.js

@@ -1,35 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from 'react';
-import { Box, Text, useApp } from 'ink';
-import { gql } from '../../lib/client.js';
-import { Spinner } from '../../components/Spinner.js';
-export default function SyncBookmarks() {
-    const { exit } = useApp();
-    const [status, setStatus] = useState('pending');
-    const [error, setError] = useState(null);
-    useEffect(() => {
-        async function run() {
-            setStatus('running');
-            try {
-                await gql('mutation SyncBookmarks { syncBookmarks }');
-                setStatus('ok');
-            }
-            catch (err) {
-                setStatus('failed');
-                setError(err instanceof Error ? err.message : String(err));
-            }
-        }
-        run();
-    }, []);
-    useEffect(() => {
-        if (status === 'ok' || status === 'failed')
-            exit();
-    }, [status]);
-    if (status === 'running') {
-        return _jsx(Spinner, { label: "Syncing bookmarks..." });
-    }
-    if (status === 'failed') {
-        return _jsxs(Text, { color: "red", children: ["Error: ", error] });
-    }
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "green", children: "\u2713 Bookmark sync queued" }), _jsxs(Text, { dimColor: true, children: ["Run ", _jsx(Text, { color: "cyan", children: "sonar status --watch" }), " to monitor progress."] })] }));
-}

package/dist/commands/sync/likes.js

@@ -1,35 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from 'react';
-import { Box, Text, useApp } from 'ink';
-import { gql } from '../../lib/client.js';
-import { Spinner } from '../../components/Spinner.js';
-export default function SyncLikes() {
-    const { exit } = useApp();
-    const [status, setStatus] = useState('pending');
-    const [error, setError] = useState(null);
-    useEffect(() => {
-        async function run() {
-            setStatus('running');
-            try {
-                await gql('mutation SyncLikes { syncLikes }');
-                setStatus('ok');
-            }
-            catch (err) {
-                setStatus('failed');
-                setError(err instanceof Error ? err.message : String(err));
-            }
-        }
-        run();
-    }, []);
-    useEffect(() => {
-        if (status === 'ok' || status === 'failed')
-            exit();
-    }, [status]);
-    if (status === 'running') {
-        return _jsx(Spinner, { label: "Syncing likes..." });
-    }
-    if (status === 'failed') {
-        return _jsxs(Text, { color: "red", children: ["Error: ", error] });
-    }
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: "green", children: "\u2713 Likes sync queued" }), _jsxs(Text, { dimColor: true, children: ["Run ", _jsx(Text, { color: "cyan", children: "sonar status --watch" }), " to monitor progress."] })] }));
-}