summd 0.1.2

package/README.md

@@ -0,0 +1,51 @@
+# summd
+
+CLI for [sum.md](https://sum.md) — Sum to anything.
+
+Auto-summarize what you save. Surface it as context — for humans, AI agents, or any tool in your workflow.
+
+## Install
+
+```bash
+npm i -g summd
+```
+
+## Setup
+
+```bash
+summd key sk-summd-xxxx   # generate at sum.md/settings
+```
+
+## Usage
+
+```bash
+summd add "Today I learned..."
+cat notes.md | summd add --tag ai
+summd search "React performance"
+summd list --since 7d --tag ai
+summd content <id> | pbcopy
+```
+
+## AI Agent (MCP)
+
+Claude and other MCP-compatible agents can search your knowledge base mid-conversation:
+
+```json
+{
+  "mcpServers": {
+    "sum.md": {
+      "type": "http",
+      "url": "https://sum.md/mcp",
+      "headers": { "Authorization": "Bearer sk-summd-xxxx" }
+    }
+  }
+}
+```
+
+## Options
+
+```
+--key <token>   API key
+--base <url>    Override base URL
+--json          Raw JSON output
+```

package/dist/api.js

@@ -0,0 +1,58 @@
+import { resolveKey, resolveBase } from './config.js';
+let _id = 0;
+async function mcp(method, params, opts) {
+    const key = resolveKey(opts.key);
+    const base = resolveBase(opts.base);
+    const res = await fetch(`${base}/mcp`, {
+        method: 'POST',
+        headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
+        body: JSON.stringify({ jsonrpc: '2.0', id: ++_id, method, params }),
+    });
+    if (res.status === 401) {
+        console.error('Unauthorized — check your API key.');
+        process.exit(1);
+    }
+    if (!res.ok)
+        throw new Error(`HTTP ${res.status}`);
+    const json = await res.json();
+    if (json.error)
+        throw new Error(json.error.message);
+    return json.result;
+}
+function tool(name, args, opts) {
+    return mcp('tools/call', { name, arguments: args }, opts);
+}
+function text(result) {
+    return result.content.map(c => c.text).join('');
+}
+// ── Public API ────────────────────────────────────────────────────────────────
+export async function add(content, tags, opts) {
+    return text(await tool('add_entry', { content, tags }, opts));
+}
+export async function search(query, limit, opts) {
+    return text(await tool('search_context', { query, limit }, opts));
+}
+export async function list(args, opts) {
+    return text(await tool('list_recent', args, opts));
+}
+export async function get(id, opts) {
+    const raw = text(await tool('get_entry', { id }, opts));
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(raw);
+    }
+}
+export async function tags(opts) {
+    const raw = text(await tool('list_tags', {}, opts));
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new Error(raw);
+    }
+}
+export async function del(id, opts) {
+    return text(await tool('delete_entry', { id }, opts));
+}

package/dist/config.js

@@ -0,0 +1,28 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+const CONFIG_DIR = join(homedir(), '.config', 'summd');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+function load() {
+    try {
+        return JSON.parse(readFileSync(CONFIG_FILE, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveKey(apiKey) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify({ ...load(), apiKey }, null, 2));
+}
+export function resolveKey(inline) {
+    const key = inline ?? process.env.SUM_API_KEY ?? load().apiKey;
+    if (!key) {
+        console.error('No API key. Run: summd key <your-api-key>');
+        process.exit(1);
+    }
+    return key;
+}
+export function resolveBase(inline) {
+    return inline ?? process.env.SUM_BASE_URL ?? load().baseUrl ?? 'https://sum.md';
+}

package/dist/index.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+import { readFileSync } from 'fs';
+import { createInterface } from 'readline';
+import { program } from 'commander';
+import { saveKey } from './config.js';
+import * as api from './api.js';
+// ── helpers ───────────────────────────────────────────────────────────────────
+function globalOpts() {
+    return program.opts();
+}
+function sinceToIso(since) {
+    if (!since)
+        return undefined;
+    const match = since.match(/^(\d+)(d|h|m)$/);
+    if (!match)
+        return since; // treat as raw ISO date
+    const [, n, unit] = match;
+    const ms = { d: 86400000, h: 3600000, m: 60000 }[unit];
+    return new Date(Date.now() - Number(n) * ms).toISOString();
+}
+async function readStdin() {
+    const rl = createInterface({ input: process.stdin });
+    const lines = [];
+    for await (const line of rl)
+        lines.push(line);
+    return lines.join('\n');
+}
+function formatDate(iso) {
+    return new Date(iso).toLocaleDateString('en', { month: 'short', day: 'numeric', year: 'numeric' });
+}
+// ── program ───────────────────────────────────────────────────────────────────
+program
+    .name('summd')
+    .description('Sum to anything.')
+    .version('0.1.2')
+    .option('--key <token>', 'API key for this request')
+    .option('--base <url>', 'Override API base URL');
+// ── summd key ─────────────────────────────────────────────────────────────────
+program
+    .command('key <api-key>')
+    .description('Save API key to ~/.config/summd/config.json')
+    .action((apiKey) => {
+    saveKey(apiKey);
+    console.log('✓ API key saved');
+});
+// ── summd add ─────────────────────────────────────────────────────────────────
+program
+    .command('add [content]')
+    .description('Add an entry — reads stdin if no content given')
+    .option('-t, --tag <tags>', 'Comma-separated tags')
+    .option('-f, --file <path>', 'Read content from file')
+    .action(async (content, cmd) => {
+    const tags = cmd.tag ? cmd.tag.split(',').map(t => t.trim()) : [];
+    let body = content;
+    if (!body && cmd.file)
+        body = readFileSync(cmd.file, 'utf8');
+    if (!body && !process.stdin.isTTY)
+        body = await readStdin();
+    if (!body) {
+        console.error('Provide content, --file, or pipe from stdin.');
+        process.exit(1);
+    }
+    console.log(await api.add(body, tags, globalOpts()));
+});
+// ── summd search ──────────────────────────────────────────────────────────────
+program
+    .command('search <query>')
+    .description('Semantic search your knowledge base')
+    .option('-n, --limit <n>', 'Number of results', '5')
+    .action(async (query, cmd) => {
+    console.log(await api.search(query, Number(cmd.limit), globalOpts()));
+});
+// ── summd list ────────────────────────────────────────────────────────────────
+program
+    .command('list')
+    .description('List recent entries')
+    .option('-n, --limit <n>', 'Number of entries', '10')
+    .option('--tag <tag>', 'Filter by tag')
+    .option('--since <value>', 'e.g. 7d, 24h, 30m — or ISO date')
+    .option('--json', 'Raw JSON output')
+    .action(async (cmd) => {
+    console.log(await api.list({ limit: Number(cmd.limit), tag: cmd.tag, since: sinceToIso(cmd.since) }, globalOpts()));
+});
+// ── summd get ─────────────────────────────────────────────────────────────────
+program
+    .command('get <id>')
+    .description('Get full entry metadata and content')
+    .option('--json', 'Raw JSON output')
+    .action(async (id, cmd) => {
+    const entry = await api.get(id, globalOpts());
+    if (cmd.json) {
+        console.log(JSON.stringify(entry, null, 2));
+        return;
+    }
+    console.log(`id:      ${entry.id}`);
+    console.log(`title:   ${entry.title ?? '—'}`);
+    console.log(`status:  ${entry.summary_status}`);
+    console.log(`tags:    ${entry.tags.length ? entry.tags.map(t => `#${t}`).join(' ') : '—'}`);
+    console.log(`created: ${formatDate(entry.created_at)}`);
+    if (entry.summary)
+        console.log(`\nsummary: ${entry.summary}`);
+    if (entry.raw_md)
+        console.log(`\n---\n\n${entry.raw_md}`);
+});
+// ── summd content ─────────────────────────────────────────────────────────────
+program
+    .command('content <id>')
+    .description('Print raw markdown — pipe-friendly')
+    .action(async (id) => {
+    const entry = await api.get(id, globalOpts());
+    if (!entry.raw_md) {
+        console.error('No content available.');
+        process.exit(1);
+    }
+    process.stdout.write(entry.raw_md);
+});
+// ── summd tags ────────────────────────────────────────────────────────────────
+program
+    .command('tags')
+    .description('List all tags with entry counts')
+    .option('--json', 'Raw JSON output')
+    .action(async (cmd) => {
+    const result = await api.tags(globalOpts());
+    if (cmd.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    for (const { tag, count } of result) {
+        console.log(`#${tag.padEnd(24)} ${count}`);
+    }
+});
+// ── summd delete ──────────────────────────────────────────────────────────────
+program
+    .command('delete <id>')
+    .alias('rm')
+    .description('Delete an entry')
+    .action(async (id) => {
+    console.log(await api.del(id, globalOpts()));
+});
+program.parse();

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "summd",
+  "version": "0.1.2",
+  "description": "CLI for sum.md — Sum to anything.",
+  "license": "MIT",
+  "bin": { "summd": "./dist/index.js" },
+  "type": "module",
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": { "node": ">=18" }
+}