@novis10813/secondbrain-cli 0.1.0 → 0.1.2

package/dist/utils/placeholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.d.ts","sourceRoot":"","sources":["../../src/utils/placeholder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,CA0B1E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,CAK1E;AAkBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA8BzF"}

package/dist/utils/placeholder.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDatePlaceholder = parseDatePlaceholder;
+exports.parseTimePlaceholder = parseTimePlaceholder;
+exports.processPlaceholders = processPlaceholders;
+const moment_1 = __importDefault(require("moment"));
+/**
+ * Parse a DATE placeholder token and return the formatted date string.
+ *
+ * Supported formats:
+ *   DATE             → default 'YYYY-MM-DD'
+ *   DATE:format      → custom moment format
+ *   DATE+N / DATE-N  → offset by N days, default format
+ *   DATE:format+N    → custom format + day offset
+ */
+function parseDatePlaceholder(token, baseDate) {
+    // Strip leading 'DATE'
+    const rest = token.slice(4); // e.g. '', ':YYYY/MM/DD', '+3', ':YYYY/MM/DD+3'
+    let fmt = 'YYYY-MM-DD';
+    let offset = 0;
+    if (rest === '') {
+        // plain {{DATE}}
+    }
+    else if (rest.startsWith(':')) {
+        // has custom format; offset may follow after the format as +N or -N
+        // We need to find if there's an offset at the end: match trailing [+-]\d+
+        const offsetMatch = rest.match(/([+-]\d+)$/);
+        if (offsetMatch) {
+            offset = parseInt(offsetMatch[1], 10);
+            fmt = rest.slice(1, rest.length - offsetMatch[1].length);
+        }
+        else {
+            fmt = rest.slice(1);
+        }
+    }
+    else {
+        // no custom format, just offset: +N or -N
+        offset = parseInt(rest, 10);
+    }
+    const m = (0, moment_1.default)(baseDate).add(offset, 'days');
+    return m.format(fmt);
+}
+/**
+ * Parse a TIME placeholder token and return the formatted time string.
+ *
+ * Supported formats:
+ *   TIME          → default 'HH:mm'
+ *   TIME:format   → custom moment format
+ */
+function parseTimePlaceholder(token, baseDate) {
+    const rest = token.slice(4); // strip 'TIME'
+    const fmt = rest.startsWith(':') ? rest.slice(1) : 'HH:mm';
+    return (0, moment_1.default)(baseDate).format(fmt);
+}
+/**
+ * Generate a UUID v4 string.
+ * Uses crypto.randomUUID if available (Node 15+ / Bun), otherwise falls back to manual generation.
+ */
+function generateUUID() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    // Fallback: manual RFC4122 v4 UUID
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+/**
+ * Process all built-in placeholders in a template string.
+ *
+ * Built-in placeholders (uppercase keywords):
+ *   {{DATE}}          → today's date (YYYY-MM-DD)
+ *   {{DATE:format}}   → custom moment format
+ *   {{DATE+N}}        → N days from today
+ *   {{DATE:format+N}} → custom format + offset
+ *   {{TIME}}          → current time (HH:mm)
+ *   {{TIME:format}}   → custom moment format
+ *   {{TITLE}}         → context.title (left as-is if not provided)
+ *   {{VAULT}}         → context.vault (left as-is if not provided)
+ *   {{UUID}}          → random UUID v4 (unique per occurrence)
+ *
+ * User-defined lowercase {{variable}} placeholders are NOT touched.
+ */
+function processPlaceholders(template, context) {
+    const baseDate = context.date ?? new Date();
+    // Match every {{...}} in the template; decide per-match whether it's built-in
+    return template.replace(/\{\{([^}]+)\}\}/g, (match, inner) => {
+        const token = inner.trim();
+        if (token === 'DATE' || token.startsWith('DATE:') || /^DATE[+-]\d+/.test(token)) {
+            return parseDatePlaceholder(token, baseDate);
+        }
+        if (token === 'TIME' || token.startsWith('TIME:')) {
+            return parseTimePlaceholder(token, baseDate);
+        }
+        if (token === 'TITLE') {
+            return context.title !== undefined ? context.title : match;
+        }
+        if (token === 'VAULT') {
+            return context.vault !== undefined ? context.vault : match;
+        }
+        if (token === 'UUID') {
+            return generateUUID();
+        }
+        // Not a built-in placeholder — preserve as-is for user variable handling
+        return match;
+    });
+}
+//# sourceMappingURL=placeholder.js.map

package/dist/utils/placeholder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder.js","sourceRoot":"","sources":["../../src/utils/placeholder.ts"],"names":[],"mappings":"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"}

package/dist/utils/position.d.ts

@@ -0,0 +1,10 @@
+import type { Loc, Pos } from '../types';
+/**
+ * Convert a character offset in content to Obsidian-aligned Loc (0-based line/col).
+ */
+export declare function indexToLoc(content: string, index: number): Loc;
+/**
+ * Convert a start/end character range to Obsidian-aligned Pos (start and end Loc).
+ */
+export declare function rangeToPos(content: string, startIndex: number, endIndex: number): Pos;
+//# sourceMappingURL=position.d.ts.map

package/dist/utils/position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../src/utils/position.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAEzC;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAM9D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAKrF"}

package/dist/utils/position.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.indexToLoc = indexToLoc;
+exports.rangeToPos = rangeToPos;
+/**
+ * Convert a character offset in content to Obsidian-aligned Loc (0-based line/col).
+ */
+function indexToLoc(content, index) {
+    const before = content.slice(0, index);
+    const lastNewline = before.lastIndexOf('\n');
+    const line = (before.match(/\n/g)?.length ?? 0);
+    const col = lastNewline === -1 ? index : index - lastNewline - 1;
+    return { line, col, offset: index };
+}
+/**
+ * Convert a start/end character range to Obsidian-aligned Pos (start and end Loc).
+ */
+function rangeToPos(content, startIndex, endIndex) {
+    return {
+        start: indexToLoc(content, startIndex),
+        end: indexToLoc(content, endIndex)
+    };
+}
+//# sourceMappingURL=position.js.map

package/dist/utils/position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.js","sourceRoot":"","sources":["../../src/utils/position.ts"],"names":[],"mappings":";;AAKA,gCAMC;AAKD,gCAKC;AAnBD;;GAEG;AACH,SAAgB,UAAU,CAAC,OAAe,EAAE,KAAa;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,WAAW,GAAG,CAAC,CAAC;IACjE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,OAAe,EAAE,UAAkB,EAAE,QAAgB;IAC/E,OAAO;QACN,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC;QACtC,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC;KAClC,CAAC;AACH,CAAC"}

package/dist/utils/sqlite-adapter.d.ts

@@ -0,0 +1,8 @@
+/**
+ * SQLite driver adapter: uses bun:sqlite under Bun and better-sqlite3 under Node
+ * so that npm install users can run the CLI with Node.js.
+ */
+import type Database from 'better-sqlite3';
+export type SqliteDatabase = InstanceType<typeof Database>;
+export declare function createDatabase(path: string): SqliteDatabase;
+//# sourceMappingURL=sqlite-adapter.d.ts.map

package/dist/utils/sqlite-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-adapter.d.ts","sourceRoot":"","sources":["../../src/utils/sqlite-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAS3D"}

package/dist/utils/sqlite-adapter.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDatabase = createDatabase;
+function createDatabase(path) {
+    if (typeof globalThis.Bun !== 'undefined') {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { Database } = require('bun:sqlite');
+        return new Database(path);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const DatabaseConstructor = require('better-sqlite3');
+    return new DatabaseConstructor(path);
+}
+//# sourceMappingURL=sqlite-adapter.js.map

package/dist/utils/sqlite-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-adapter.js","sourceRoot":"","sources":["../../src/utils/sqlite-adapter.ts"],"names":[],"mappings":";;AAQA,wCASC;AATD,SAAgB,cAAc,CAAC,IAAY;IAC1C,IAAI,OAAQ,UAAoD,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;QACtF,iEAAiE;QACjE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;QAC3C,OAAO,IAAI,QAAQ,CAAC,IAAI,CAA8B,CAAC;IACxD,CAAC;IACD,iEAAiE;IACjE,MAAM,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAoB,CAAC;IACzE,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/utils/template.d.ts

@@ -1,4 +1,4 @@
-import type { Config } from '../types/index.js';
+import type { Config, PlaceholderContext } from '../types/index.js';
 export declare class TemplateManager {
     private config;
     constructor(config: Config);
@@ -8,7 +8,7 @@ export declare class TemplateManager {
     getTemplate(name: string): string | null;
     listTemplates(): string[];
     deleteTemplate(name: string): void;
-    renderTemplate(name: string, variables: Record<string, string>): string;
+    renderTemplate(name: string, variables: Record<string, string>, context?: PlaceholderContext): string;
     validateTemplate(name: string): string[];
     insertTemplate(name: string, targetPath: string, variables: Record<string, string>): void;
     getRequiredFields(name: string): string[];

package/dist/utils/template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/utils/template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAI1B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,kBAAkB;IAO1B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMnD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQxC,aAAa,IAAI,MAAM,EAAE;IAYzB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQlC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM;IAgBvE,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAiBxC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAazF,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAIzC,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE;CAYjF"}
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/utils/template.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGpE,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAI1B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,kBAAkB;IAO1B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMnD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQxC,aAAa,IAAI,MAAM,EAAE;IAYzB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQlC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM;IAsBrG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAiBxC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAazF,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAIzC,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE;CAYjF"}

package/dist/utils/template.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TemplateManager = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const placeholder_js_1 = require("./placeholder.js");
 class TemplateManager {
     config;
     constructor(config) {
@@ -46,17 +47,21 @@ class TemplateManager {
         }
         (0, fs_1.unlinkSync)(templatePath);
     }
-    renderTemplate(name, variables) {
+    renderTemplate(name, variables, context) {
         const template = this.getTemplate(name);
         if (!template) {
             throw new Error(`Template '${name}' not found`);
         }
-        // Replace all {{variable}} with values
-        let result = template;
+        // Step 1: Expand built-in placeholders (DATE, TIME, TITLE, VAULT, UUID)
+        let result = (0, placeholder_js_1.processPlaceholders)(template, context ?? {});
+        // Step 2: Replace user-defined {{variable}} with provided values
         for (const [key, value] of Object.entries(variables)) {
             const regex = new RegExp(`\\{\\{\\s*${key}\\s*\\}\\}`, 'g');
             result = result.replace(regex, value);
         }
+        // Step 3: Replace any remaining unresolved placeholders with empty string
+        const remainingRegex = /\{\{\s*[a-zA-Z_][a-zA-Z0-9_:+\-]*\s*\}\}/g;
+        result = result.replace(remainingRegex, '');
         return result;
     }
     validateTemplate(name) {

package/dist/utils/template.js.map

@@ -1 +1 @@
-{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/utils/template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/utils/template.ts"],"names":[],"mappings":"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"}

package/dist/utils/vault-resolve.d.ts

@@ -0,0 +1,23 @@
+import type { Config } from '../types/index.js';
+import { VaultManager } from './vault.js';
+export interface ResolveOptions {
+    globalConfigDir?: string;
+    cwd?: string;
+}
+/**
+ * 解析 vault 路徑，依照優先順序：
+ * 1. 環境變數 SECONDBRAIN_VAULT（名稱或路徑）
+ * 2. 當前目錄（往上找 .secondbrain/config.json）
+ * 3. 預設 vault
+ */
+export declare function resolveVaultPath(options?: ResolveOptions): string | null;
+/**
+ * Resolve vault path and run fn with a VaultManager. Ensures vault.close() in finally.
+ * Exits with 1 if not inside a SecondBrain vault.
+ */
+export declare function withVault(fn: (vault: VaultManager) => void | Promise<void>, options?: ResolveOptions): Promise<void>;
+/**
+ * Get config for current vault or exit. Use when only config is needed (e.g. config command).
+ */
+export declare function getConfigOrExit(options?: ResolveOptions): Config;
+//# sourceMappingURL=vault-resolve.d.ts.map

package/dist/utils/vault-resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-resolve.d.ts","sourceRoot":"","sources":["../../src/utils/vault-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAU1C,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,cAAmB,GAAG,MAAM,GAAG,IAAI,CA+B5E;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,EAAE,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACjD,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,cAAmB,GAAG,MAAM,CAQpE"}

package/dist/utils/vault-resolve.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveVaultPath = resolveVaultPath;
+exports.withVault = withVault;
+exports.getConfigOrExit = getConfigOrExit;
+const config_js_1 = require("./config.js");
+const global_config_js_1 = require("./global-config.js");
+const vault_js_1 = require("./vault.js");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const NOT_IN_VAULT_MSG = `❌ 找不到可用的 vault
+   • 設定環境變數：export SECONDBRAIN_VAULT=<name|path>
+   • 或進入 vault 目錄
+   • 或設定預設 vault：sb vault default set <name>
+   • 或初始化新 vault：sb vault init`;
+/**
+ * 解析 vault 路徑，依照優先順序：
+ * 1. 環境變數 SECONDBRAIN_VAULT（名稱或路徑）
+ * 2. 當前目錄（往上找 .secondbrain/config.json）
+ * 3. 預設 vault
+ */
+function resolveVaultPath(options = {}) {
+    const globalConfig = new global_config_js_1.GlobalConfigManager(options.globalConfigDir);
+    const cwd = options.cwd ?? process.cwd();
+    // 1. 環境變數
+    const envVault = process.env.SECONDBRAIN_VAULT;
+    if (envVault) {
+        // 先嘗試作為路徑
+        if ((0, fs_1.existsSync)((0, path_1.join)(envVault, '.secondbrain', 'config.json'))) {
+            return envVault;
+        }
+        // 再嘗試作為名稱
+        const entry = globalConfig.findVault(envVault);
+        if (entry && (0, fs_1.existsSync)((0, path_1.join)(entry.path, '.secondbrain', 'config.json'))) {
+            return entry.path;
+        }
+    }
+    // 2. 當前目錄（向上查找）
+    const localVault = config_js_1.ConfigManager.findVaultPath(cwd);
+    if (localVault) {
+        return localVault;
+    }
+    // 3. 預設 vault
+    const defaultVault = globalConfig.getDefault();
+    if (defaultVault && (0, fs_1.existsSync)((0, path_1.join)(defaultVault.path, '.secondbrain', 'config.json'))) {
+        return defaultVault.path;
+    }
+    return null;
+}
+/**
+ * Resolve vault path and run fn with a VaultManager. Ensures vault.close() in finally.
+ * Exits with 1 if not inside a SecondBrain vault.
+ */
+async function withVault(fn, options = {}) {
+    const vaultPath = resolveVaultPath(options);
+    if (!vaultPath) {
+        console.error(NOT_IN_VAULT_MSG);
+        process.exit(1);
+    }
+    const configManager = new config_js_1.ConfigManager(vaultPath);
+    const config = configManager.getConfig();
+    const vault = new vault_js_1.VaultManager(config);
+    try {
+        await fn(vault);
+    }
+    catch (error) {
+        console.error('❌', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+    finally {
+        vault.close();
+    }
+}
+/**
+ * Get config for current vault or exit. Use when only config is needed (e.g. config command).
+ */
+function getConfigOrExit(options = {}) {
+    const vaultPath = resolveVaultPath(options);
+    if (!vaultPath) {
+        console.error(NOT_IN_VAULT_MSG);
+        process.exit(1);
+    }
+    const configManager = new config_js_1.ConfigManager(vaultPath);
+    return configManager.getConfig();
+}
+//# sourceMappingURL=vault-resolve.js.map

package/dist/utils/vault-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-resolve.js","sourceRoot":"","sources":["../../src/utils/vault-resolve.ts"],"names":[],"mappings":"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"}

package/dist/utils/vault.d.ts

@@ -1,32 +1,99 @@
-import type { Note, Config } from '../types/index.js';
+import type { Config, FileInfo, ContentMetadata } from '../types/index.js';
 export declare class VaultManager {
-    private config;
+    private _config;
     private db;
     constructor(config: Config);
+    get config(): Config;
     close(): void;
     sync(): Promise<{
         added: number;
         updated: number;
         removed: number;
     }>;
+    /**
+     * Rapidly index a single file without a full vault scan.
+     * Useful for capture or real-time updates.
+     */
+    indexSingleFile(relativePath: string): void;
     private findMarkdownFiles;
-    createNoteFromFile(path: string, content: string, hash: string, links?: string[]): Promise<Note>;
-    private findNoteByTitleOrPath;
+    /**
+     * Create FileInfo from file path and stats.
+     * Separates file system information from content parsing.
+     */
+    private createFileInfo;
     writeNote(path: string, content: string): void;
     readNote(path: string): string | null;
     getDailyNotePath(date?: Date): string;
     getTemplatePath(templateName: string): string;
-    getNoteById(id: string): Note | null;
-    getNoteByPath(path: string): Note | null;
-    searchNotes(query: string, tags?: string[], limit?: number): Note[];
-    getBacklinks(noteId: string): Note[];
-    getOrphans(): Note[];
     getStats(): {
         totalNotes: number;
         totalLinks: number;
         orphans: number;
     };
+    getBacklinksByPath(filePath: string): FileInfo[];
+    getOutlinksByPath(filePath: string): FileInfo[];
+    getOrphanFiles(): FileInfo[];
+    searchFiles(query: string, tags?: string[], limit?: number, pathPrefix?: string, linksToPath?: string, headingQuery?: string, modifiedAfter?: number, modifiedBefore?: number): Array<{
+        file: FileInfo;
+        tags: string[];
+    }>;
     getGraphData(): import("../types/index.js").GraphData;
-    upsertNote(note: Note): void;
+    /**
+     * Get all markdown files in the vault (Obsidian-style API).
+     * Equivalent to Obsidian's Vault.getMarkdownFiles().
+     * @returns Array of FileInfo for every .md file in the vault
+     */
+    getMarkdownFiles(): FileInfo[];
+    /**
+     * Get FileInfo by path (Obsidian-style API).
+     * @param path Relative path from vault root
+     * @returns FileInfo or null if not found
+     */
+    getFileByPath(path: string): FileInfo | null;
+    /**
+     * Resolve path or basename to FileInfo using new structure only.
+     * Tries exact path, path + .md, then match by basename.
+     */
+    resolvePathOrBasename(pathOrBasename: string): FileInfo | null;
+    /**
+     * Read file content by FileInfo (Obsidian-style API).
+     * Equivalent to Obsidian's Vault.read(file).
+     * @param file FileInfo object
+     * @returns File content or null if not found
+     */
+    readFile(file: FileInfo): string | null;
+    /**
+     * Get backlinks for a file by FileInfo (Obsidian-style API).
+     * Equivalent to Obsidian's MetadataCache.getBacklinksForFile(file).
+     * @param file FileInfo object
+     * @returns Array of FileInfo that link to this file
+     */
+    getBacklinksForFile(file: FileInfo): FileInfo[];
+    /**
+     * Get ContentMetadata for a FileInfo (Obsidian-style API).
+     * Equivalent to Obsidian's MetadataCache.getFileCache(file).
+     * @param file FileInfo object
+     * @returns ContentMetadata or null if not found
+     */
+    getFileCache(file: FileInfo): ContentMetadata | null;
+    /**
+     * Resolve a linkpath to a FileInfo (Obsidian-style API).
+     * Equivalent to Obsidian's MetadataCache.getFirstLinkpathDest(linkpath, sourcePath).
+     * Resolves linkpaths like "note-name", "folder/note-name", "note-name#heading", etc.
+     * @param linkpath Link path (may include heading/block reference after #)
+     * @param sourcePath Path of the source file (for relative path resolution)
+     * @returns FileInfo or null if not found
+     */
+    getFirstLinkpathDest(linkpath: string, sourcePath: string): FileInfo | null;
+    /**
+     * Resolve a linkpath to a file and position (line, col) for editor navigation.
+     * Supports note, note#heading, note#^block-id, and note#heading#^block-id.
+     * @returns { path, line, col } (1-based) or null if file not found
+     */
+    resolveLinkToPosition(linkpath: string, sourcePath: string): {
+        path: string;
+        line: number;
+        col: number;
+    } | null;
 }
 //# sourceMappingURL=vault.d.ts.map

package/dist/utils/vault.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../src/utils/vault.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAItD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,EAAE,CAAkB;gBAEhB,MAAM,EAAE,MAAM;IAK1B,KAAK,IAAI,IAAI;IAKP,IAAI,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAoE1E,OAAO,CAAC,iBAAiB;IAsBnB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1G,OAAO,CAAC,qBAAqB;IA0B7B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAY9C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASrC,gBAAgB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM;IASjD,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAK7C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIpC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIxC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,MAAW,GAAG,IAAI,EAAE;IAIvE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE;IAIpC,UAAU,IAAI,IAAI,EAAE;IAIpB,QAAQ;;;;;IAIR,YAAY;IAKZ,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CAG7B"}
+{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../../src/utils/vault.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAI3E,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,EAAE,CAAkB;gBAEhB,MAAM,EAAE,MAAM;IAK1B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,KAAK,IAAI,IAAI;IAKP,IAAI,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA+E1E;;;OAGG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IA0B3C,OAAO,CAAC,iBAAiB;IAyBzB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAwBtB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAY9C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASrC,gBAAgB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM;IASjD,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAI7C,QAAQ;;;;;IAKR,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE;IAIhD,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE;IAI/C,cAAc,IAAI,QAAQ,EAAE;IAI5B,WAAW,CACT,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,KAAK,GAAE,MAAW,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,KAAK,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAM5C,YAAY;IAOZ;;;;OAIG;IACH,gBAAgB,IAAI,QAAQ,EAAE;IAI9B;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAI5C;;;OAGG;IACH,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAW9D;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI;IAIvC;;;;;OAKG;IACH,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE;IAI/C;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,eAAe,GAAG,IAAI;IAIpD;;;;;;;OAOG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IA8C3E;;;;OAIG;IACH,qBAAqB,CACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CA8BtD"}