stellavault 0.3.0 → 0.4.0

package/packages/cli/dist/commands/fleeting-cmd.js

@@ -0,0 +1,45 @@
+// stellavault fleeting — 찰나 메모 즉시 캡처
+// "떠오른 생각을 raw/ 폴더에 즉시 저장"
+import chalk from 'chalk';
+import { loadConfig } from '@stellavault/core';
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+export async function fleetingCommand(text, options) {
+    if (!text || text.trim().length < 2) {
+        console.error(chalk.yellow('Usage: stellavault fleeting "your idea here" [--tags tag1,tag2]'));
+        process.exit(1);
+    }
+    const config = loadConfig();
+    const rawDir = resolve(config.vaultPath, 'raw');
+    if (!existsSync(rawDir))
+        mkdirSync(rawDir, { recursive: true });
+    const now = new Date();
+    const timestamp = now.toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const slug = text.slice(0, 40).replace(/[^a-zA-Z0-9가-힣\s]/g, '').replace(/\s+/g, '-').toLowerCase();
+    const filename = `${timestamp}-${slug}.md`;
+    const filePath = join(rawDir, filename);
+    // path traversal 방지
+    if (!resolve(filePath).startsWith(resolve(rawDir))) {
+        console.error(chalk.red('Invalid file path'));
+        process.exit(1);
+    }
+    const tags = options.tags ? options.tags.split(',').map(t => t.trim()) : [];
+    const content = [
+        '---',
+        `title: "${text.slice(0, 80)}"`,
+        'type: fleeting',
+        `created: ${now.toISOString()}`,
+        `tags: [${tags.map(t => `"${t}"`).join(', ')}]`,
+        '---',
+        '',
+        text,
+        '',
+        '---',
+        `*Captured via \`stellavault fleeting\` at ${now.toLocaleString('ko-KR')}*`,
+    ].join('\n');
+    writeFileSync(filePath, content, 'utf-8');
+    console.log(chalk.green(`Captured: ${filename}`));
+    console.log(chalk.dim(`Location: raw/${filename}`));
+    console.log(chalk.dim('Run `stellavault compile` to process into wiki.'));
+}
+//# sourceMappingURL=fleeting-cmd.js.map

package/packages/cli/dist/commands/graph-cmd.js

@@ -27,8 +27,20 @@ export async function graphCommand() {
         searchEngine: hub.searchEngine,
         port,
         vaultName,
+        vaultPath: config.vaultPath,
     });
-    await api.start();
+    try {
+        await api.start();
+    }
+    catch (err) {
+        if (err?.code === 'EADDRINUSE') {
+            console.error(chalk.red(`Port ${port} is already in use.`));
+            console.error(chalk.dim(`Stop the other process or use a different port:`));
+            console.error(chalk.dim(`  Edit .stellavault.json: { "mcp": { "port": ${port + 1} } }`));
+            process.exit(1);
+        }
+        throw err;
+    }
     console.error(chalk.green('🧠 Stellavault — Neural Knowledge Graph'));
     console.error(`   📚 ${stats.documentCount} documents | ${stats.chunkCount} chunks`);
     console.error(`   🌐 API: http://127.0.0.1:${port}`);

package/packages/cli/dist/commands/ingest-cmd.d.ts

@@ -0,0 +1,9 @@
+export declare function ingestCommand(input: string, options: {
+    tags?: string;
+    stage?: string;
+    title?: string;
+}): Promise<void>;
+export declare function promoteCommand(filePath: string, options: {
+    to: string;
+}): Promise<void>;
+//# sourceMappingURL=ingest-cmd.d.ts.map

package/packages/cli/dist/commands/ingest-cmd.js

@@ -0,0 +1,131 @@
+// stellavault ingest — 통합 인제스트 (URL, 텍스트, 파일 → 자동 분류 저장)
+import chalk from 'chalk';
+import { loadConfig, ingest, promoteNote } from '@stellavault/core';
+import { readFileSync, existsSync } from 'node:fs';
+import { extname } from 'node:path';
+export async function ingestCommand(input, options) {
+    if (!input) {
+        console.error(chalk.yellow('Usage: stellavault ingest <url|file|text> [--tags t1,t2] [--stage fleeting|literature|permanent]'));
+        process.exit(1);
+    }
+    const config = loadConfig();
+    const tags = options.tags?.split(',').map(t => t.trim()) ?? [];
+    const stage = (options.stage ?? 'fleeting');
+    // 입력 타입 감지
+    let ingestInput;
+    if (/^https?:\/\//.test(input)) {
+        // URL
+        const isYouTube = /youtube\.com\/watch|youtu\.be\//.test(input);
+        // SSRF 방지: private IP 차단
+        try {
+            const url = new URL(input);
+            const host = url.hostname;
+            if (/^(127\.|10\.|192\.168\.|172\.(1[6-9]|2\d|3[01])\.|0\.|localhost|::1)/i.test(host)) {
+                console.error(chalk.yellow('Private/local URLs are not allowed for security.'));
+                process.exit(1);
+            }
+        }
+        catch { /* invalid URL, will fail at fetch */ }
+        if (isYouTube) {
+            // YouTube: 전용 추출기 사용 (메타데이터 + 자막 + 타임스탬프)
+            try {
+                const { extractYouTubeContent, formatYouTubeNote } = await import('@stellavault/core/intelligence/youtube-extractor');
+                const ytContent = await extractYouTubeContent(input);
+                const body = formatYouTubeNote(ytContent);
+                ingestInput = {
+                    type: 'youtube',
+                    content: input + '\n' + body,
+                    tags: [...tags, ...ytContent.tags.filter((t) => !tags.includes(t))],
+                    stage: stage === 'fleeting' ? 'literature' : stage, // YouTube는 literature로 자동 승격
+                    title: options.title ?? ytContent.title,
+                    source: input,
+                };
+            }
+            catch (err) {
+                console.error(chalk.yellow(`YouTube extraction failed, falling back to basic URL. (${err instanceof Error ? err.message : 'error'})`));
+                ingestInput = {
+                    type: 'youtube',
+                    content: input + '\n',
+                    tags,
+                    stage,
+                    title: options.title,
+                    source: input,
+                };
+            }
+        }
+        else {
+            // 일반 URL: HTML → 텍스트 변환
+            let content = input + '\n';
+            try {
+                const resp = await fetch(input);
+                const html = await resp.text();
+                const text = html
+                    .replace(/<script[\s\S]*?<\/script>/gi, '')
+                    .replace(/<style[\s\S]*?<\/style>/gi, '')
+                    .replace(/<[^>]+>/g, ' ')
+                    .replace(/&nbsp;/g, ' ')
+                    .replace(/\s+/g, ' ')
+                    .trim()
+                    .slice(0, 5000);
+                content += text;
+            }
+            catch (err) {
+                console.error(chalk.yellow(`Web fetch failed: saving URL only. (${err instanceof Error ? err.message : 'network error'})`));
+            }
+            ingestInput = {
+                type: 'url',
+                content,
+                tags,
+                stage,
+                title: options.title,
+                source: input,
+            };
+        }
+    }
+    else if (existsSync(input)) {
+        // 파일
+        const ext = extname(input).toLowerCase();
+        const fileContent = readFileSync(input, 'utf-8');
+        ingestInput = {
+            type: ext === '.pdf' ? 'pdf-text' : 'file',
+            content: fileContent,
+            tags,
+            stage,
+            title: options.title,
+            source: input,
+        };
+    }
+    else {
+        // 플레인 텍스트
+        ingestInput = {
+            type: 'text',
+            content: input,
+            tags,
+            stage,
+            title: options.title,
+        };
+    }
+    const result = ingest(config.vaultPath, ingestInput);
+    console.log(chalk.green(`Ingested: ${result.title}`));
+    console.log(chalk.dim(`  Stage: ${result.stage}`));
+    console.log(chalk.dim(`  Saved: ${result.savedTo}`));
+    console.log(chalk.dim(`  Words: ${result.wordCount}`));
+    if (result.indexCode)
+        console.log(chalk.dim(`  Index: ${result.indexCode}`));
+    if (result.tags.length > 0)
+        console.log(chalk.dim(`  Tags: ${result.tags.join(', ')}`));
+    console.log('');
+    console.log(chalk.dim('Run `stellavault compile` to process into wiki.'));
+    console.log(chalk.dim('Run `stellavault autopilot` for full pipeline.'));
+}
+export async function promoteCommand(filePath, options) {
+    const config = loadConfig();
+    const target = options.to;
+    if (!['fleeting', 'literature', 'permanent'].includes(target)) {
+        console.error(chalk.red('--to must be: fleeting, literature, or permanent'));
+        process.exit(1);
+    }
+    const newPath = promoteNote(config.vaultPath, filePath, target);
+    console.log(chalk.green(`Promoted to ${target}: ${newPath}`));
+}
+//# sourceMappingURL=ingest-cmd.js.map

package/packages/cli/dist/commands/init-cmd.js

@@ -56,7 +56,7 @@ export async function initCommand() {
         console.log('');
         console.log(chalk.cyan('  Step 2/3') + ' — Indexing your vault');
         console.log(chalk.dim('  Vectorizing notes with local AI (no data leaves your machine).\n'));
-        const spinner = ora({ text: '  Loading embedding model...', indent: 2 }).start();
+        const spinner = ora({ text: '  Loading embedding model (first run downloads ~30MB, please wait)...', indent: 2 }).start();
         const store = createSqliteVecStore(dbPath);
         await store.initialize();
         const embedder = createLocalEmbedder('all-MiniLM-L6-v2');
@@ -113,6 +113,44 @@ export async function initCommand() {
         console.log(`  ${chalk.cyan('stellavault brief')}     Get your daily knowledge briefing`);
         console.log(`  ${chalk.cyan('stellavault serve')}     Connect AI agents via MCP`);
         console.log('');
+        // Day 2 Experience — 습관화 제안
+        console.log(chalk.cyan('  ─── Build a habit ───\n'));
+        const setupCron = await ask(rl, '  Auto-run daily briefing? (adds cron job) [Y/n]', 'Y');
+        if (setupCron.toLowerCase() !== 'n') {
+            const cronLine = `0 9 * * * cd "${vaultPath}" && stellavault brief >> ~/.stellavault/daily.log 2>&1`;
+            const platform = process.platform;
+            if (platform === 'win32') {
+                console.log(chalk.dim('\n  Windows: Add this to Task Scheduler:'));
+                console.log(chalk.dim(`  Action: stellavault brief`));
+                console.log(chalk.dim(`  Trigger: Daily at 9:00 AM`));
+                console.log(chalk.dim(`  Start in: ${vaultPath}\n`));
+            }
+            else {
+                console.log(chalk.dim('\n  Add this to your crontab (crontab -e):'));
+                console.log(chalk.dim(`  ${cronLine}\n`));
+                const autoAdd = await ask(rl, '  Add to crontab now? [Y/n]', 'Y');
+                if (autoAdd.toLowerCase() !== 'n') {
+                    try {
+                        const { execSync } = await import('node:child_process');
+                        const existing = execSync('crontab -l 2>/dev/null || true', { encoding: 'utf-8' });
+                        if (!existing.includes('stellavault brief')) {
+                            execSync(`(crontab -l 2>/dev/null; echo "${cronLine}") | crontab -`, { encoding: 'utf-8' });
+                            console.log(chalk.green('  ✓ Daily briefing scheduled at 9:00 AM\n'));
+                        }
+                        else {
+                            console.log(chalk.dim('  Already scheduled.\n'));
+                        }
+                    }
+                    catch {
+                        console.log(chalk.yellow('  Could not auto-add. Please add manually.\n'));
+                    }
+                }
+            }
+        }
+        console.log(chalk.dim('  Tomorrow morning, run:'));
+        console.log(`  ${chalk.cyan('stellavault brief')}     See what changed overnight`);
+        console.log(`  ${chalk.cyan('stellavault decay')}     Review fading knowledge`);
+        console.log('');
         console.log(chalk.dim('  Your knowledge is now alive. ✦'));
         console.log('');
     }

package/packages/cli/dist/commands/lint-cmd.d.ts

@@ -0,0 +1,2 @@
+export declare function lintCommand(): Promise<void>;
+//# sourceMappingURL=lint-cmd.d.ts.map

package/packages/cli/dist/commands/lint-cmd.js

@@ -0,0 +1,61 @@
+// stellavault lint — 지식 건강 검사 CLI
+import chalk from 'chalk';
+import { loadConfig, createKnowledgeHub, lintKnowledge } from '@stellavault/core';
+export async function lintCommand() {
+    const config = loadConfig();
+    const hub = createKnowledgeHub(config);
+    console.error(chalk.dim('Scanning your knowledge base...'));
+    await hub.store.initialize();
+    const result = await lintKnowledge(hub.store);
+    // 건강도 점수
+    const scoreColor = result.score >= 80 ? chalk.green : result.score >= 50 ? chalk.yellow : chalk.red;
+    console.log('');
+    console.log(chalk.bold('Knowledge Health Report'));
+    console.log('─'.repeat(40));
+    console.log(`Score: ${scoreColor(result.score + '/100')}`);
+    console.log(`Documents: ${result.stats.totalDocs}`);
+    console.log('');
+    // 이슈
+    if (result.issues.length > 0) {
+        const critical = result.issues.filter(i => i.severity === 'critical');
+        const warnings = result.issues.filter(i => i.severity === 'warning');
+        const info = result.issues.filter(i => i.severity === 'info');
+        if (critical.length > 0) {
+            console.log(chalk.red(`Critical: ${critical.length}`));
+            for (const i of critical) {
+                console.log(chalk.red(`  ✗ ${i.message}`));
+                if (i.suggestion)
+                    console.log(chalk.dim(`    → ${i.suggestion}`));
+            }
+            console.log('');
+        }
+        if (warnings.length > 0) {
+            console.log(chalk.yellow(`Warnings: ${warnings.length}`));
+            for (const i of warnings.slice(0, 10)) {
+                console.log(chalk.yellow(`  ! ${i.message}`));
+                if (i.suggestion)
+                    console.log(chalk.dim(`    → ${i.suggestion}`));
+            }
+            if (warnings.length > 10)
+                console.log(chalk.dim(`  ... and ${warnings.length - 10} more`));
+            console.log('');
+        }
+        if (info.length > 0) {
+            console.log(chalk.dim(`Info: ${info.length}`));
+            for (const i of info.slice(0, 5)) {
+                console.log(chalk.dim(`  ℹ ${i.message}`));
+            }
+            console.log('');
+        }
+    }
+    // 제안
+    if (result.suggestions.length > 0) {
+        console.log(chalk.cyan('Suggestions:'));
+        for (const s of result.suggestions) {
+            console.log(`  → ${s}`);
+        }
+    }
+    console.log('');
+    await hub.store.close?.();
+}
+//# sourceMappingURL=lint-cmd.js.map

package/packages/cli/dist/index.js

@@ -21,11 +21,17 @@ import { federateJoinCommand, federateStatusCommand } from './commands/federate-
 import { cloudSyncCommand, cloudRestoreCommand, cloudStatusCommand } from './commands/cloud-cmd.js';
 import { vaultAddCommand, vaultListCommand, vaultRemoveCommand, vaultSearchAllCommand } from './commands/vault-cmd.js';
 import { captureCommand } from './commands/capture-cmd.js';
+import { askCommand } from './commands/ask-cmd.js';
+import { compileCommand } from './commands/compile-cmd.js';
+import { lintCommand } from './commands/lint-cmd.js';
+import { fleetingCommand } from './commands/fleeting-cmd.js';
+import { ingestCommand, promoteCommand } from './commands/ingest-cmd.js';
+import { autopilotCommand } from './commands/autopilot-cmd.js';
 const program = new Command();
 program
     .name('stellavault')
     .description('Stellavault — Turn your Obsidian vault into a 3D neural knowledge graph')
-    .version('0.1.0')
+    .version('0.3.0')
     .option('--json', 'Output in JSON format (for scripting)')
     .option('--quiet', 'Suppress non-essential output');
 program
@@ -78,6 +84,7 @@ program
     .command('digest')
     .description('주간 지식 활동 리포트')
     .option('-d, --days <n>', '기간 (일)', '7')
+    .option('-v, --visual', 'Save as .md with Mermaid charts for Obsidian')
     .action(digestCommand);
 program
     .command('clip <url>')
@@ -120,6 +127,44 @@ program
     .option('-t, --tags <tags>', 'Comma-separated tags')
     .option('-f, --folder <folder>', 'Vault subfolder', '01_Knowledge/voice')
     .action(captureCommand);
+program
+    .command('ask <question>')
+    .description('Ask a question about your knowledge base — search, compose answer, optionally save')
+    .option('-s, --save', 'Save answer as a new note in your vault')
+    .action((question, opts) => askCommand(question, opts));
+program
+    .command('compile')
+    .description('Compile raw/ documents into a structured wiki')
+    .option('-r, --raw <dir>', 'Raw documents directory (default: raw/)')
+    .option('-w, --wiki <dir>', 'Wiki output directory (default: _wiki/)')
+    .option('-f, --force', 'Overwrite existing wiki files')
+    .action((opts) => compileCommand(opts));
+program
+    .command('lint')
+    .description('Knowledge health check — find gaps, duplicates, contradictions, stale notes')
+    .action(() => lintCommand());
+program
+    .command('fleeting <text>')
+    .description('Capture a fleeting idea instantly to raw/ folder')
+    .option('-t, --tags <tags>', 'Comma-separated tags')
+    .action((text, opts) => fleetingCommand(text, opts));
+program
+    .command('ingest <input>')
+    .description('Ingest any input (URL, file, text) into your knowledge base')
+    .option('-t, --tags <tags>', 'Comma-separated tags')
+    .option('-s, --stage <stage>', 'Note stage: fleeting, literature, permanent', 'fleeting')
+    .option('--title <title>', 'Override title')
+    .action((input, opts) => ingestCommand(input, opts));
+program
+    .command('promote <file>')
+    .description('Promote a note: fleeting → literature → permanent')
+    .requiredOption('--to <stage>', 'Target stage: literature or permanent')
+    .action((file, opts) => promoteCommand(file, opts));
+program
+    .command('autopilot')
+    .description('Run the full knowledge flywheel: inbox → compile → lint')
+    .option('--once', 'Run once (default)')
+    .action((opts) => autopilotCommand(opts));
 const vault = program.command('vault').description('Multi-Vault — manage and search across vaults');
 vault.command('add <id> <path>').description('Register a vault').option('-n, --name <name>', 'Display name').option('-s, --shared', 'Allow federation sharing').action(vaultAddCommand);
 vault.command('list').description('List registered vaults').action(vaultListCommand);

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stellavault/cli",
-  "version": "0.1.0",
+  "version": "0.4.0",
   "description": "Stellavault CLI — stellavault index, search, serve, graph",
   "type": "module",
   "bin": {