@oomkapwn/enquire-mcp 3.5.13 → 3.6.0-rc.1

package/dist/tools/meta.d.ts

@@ -0,0 +1,201 @@
+import type { FtsIndex } from "../fts5.js";
+import type { FileEntry, Vault } from "../vault.js";
+export interface ValidateProposalArgs {
+    /** Vault-relative path the LLM intends to write to (e.g. "Inbox/idea.md"). */
+    path: string;
+    /** Full proposed markdown content including any frontmatter block. */
+    content: string;
+    /** "create" (default) → fail if path exists. "overwrite" / "append" → ok if exists. */
+    mode?: "create" | "overwrite" | "append";
+}
+export interface ValidateProposalResult {
+    ok: boolean;
+    proposed_path: string;
+    mode: "create" | "overwrite" | "append";
+    errors: Array<{
+        kind: string;
+        message: string;
+    }>;
+    warnings: Array<{
+        kind: string;
+        message: string;
+        suggestion?: string;
+    }>;
+    yaml: {
+        parsed: boolean;
+        error: string | null;
+        keys: string[];
+    };
+    wikilinks: Array<{
+        raw: string;
+        target: string;
+        status: "resolved" | "broken" | "ambiguous";
+        resolved_path: string | null;
+        suggestions: string[];
+    }>;
+    tags: Array<{
+        name: string;
+        status: "existing" | "new";
+    }>;
+    collision: {
+        kind: "none" | "path-exists" | "title-exists-elsewhere";
+        existing_path?: string;
+    };
+}
+export declare function validateNoteProposal(vault: Vault, args: ValidateProposalArgs): Promise<ValidateProposalResult>;
+export interface LintWikiArgs {
+    /** Folder to restrict the lint to (default: whole vault). */
+    folder?: string;
+    /** Word count below which a note is considered a "stub". Default 100. */
+    stub_word_threshold?: number;
+    /** A note is "stale" if its frontmatter `last_reviewed` (or mtime if missing)
+     *  is older than this many days. Default 365. */
+    stale_days?: number;
+    /** A capitalised n-gram mentioned by ≥ N distinct notes but not having its
+     *  own page is flagged as a concept candidate. Default 3. */
+    concept_min_mentions?: number;
+    /** Cap on each finding-bucket so the response stays bounded. Default 50. */
+    max_per_bucket?: number;
+}
+export interface LintWikiFinding {
+    kind: "orphan" | "broken-link" | "stub" | "stale" | "concept-without-page";
+    path?: string;
+    message: string;
+    suggestion?: string;
+    details?: Record<string, unknown>;
+}
+export interface LintWikiResult {
+    scope: string;
+    scanned: number;
+    generated_at: string;
+    summary: {
+        orphans: number;
+        broken_links: number;
+        stubs: number;
+        stale: number;
+        concept_candidates: number;
+    };
+    findings: {
+        orphans: LintWikiFinding[];
+        broken_links: LintWikiFinding[];
+        stubs: LintWikiFinding[];
+        stale: LintWikiFinding[];
+        concept_candidates: LintWikiFinding[];
+    };
+}
+export declare function lintWiki(vault: Vault, args: LintWikiArgs): Promise<LintWikiResult>;
+export interface OpenQuestion {
+    question: string;
+    source_path: string;
+    source_title: string;
+    context_heading: string | null;
+    line: number;
+    age_days: number;
+    mtime: string;
+}
+export declare function getOpenQuestions(vault: Vault, args: {
+    folder?: string;
+    limit?: number;
+    pattern?: string;
+}): Promise<OpenQuestion[]>;
+export interface PaperAuditFinding {
+    path: string;
+    title: string;
+    has_frontmatter_citation: boolean;
+    found_in_body: {
+        arxiv: string[];
+        doi: string[];
+        url: string[];
+    };
+    proposed_frontmatter_patch: Record<string, string> | null;
+    message: string;
+}
+export declare function paperAudit(vault: Vault, args: {
+    tag?: string;
+    folder?: string;
+    limit?: number;
+}): Promise<{
+    scanned: number;
+    flagged: PaperAuditFinding[];
+}>;
+export interface PathStep {
+    path: string;
+    title: string;
+    /** Wikilink raw text (`[[…]]` content) used to traverse FROM the previous
+     *  step to this one. Empty on the source step. */
+    via: string;
+}
+export interface FindPathResult {
+    from: string;
+    to: string;
+    found: boolean;
+    path: PathStep[];
+    hops: number;
+    /** Up to 10 same-length alternatives, only when include_alternatives=true. */
+    alternatives?: PathStep[][];
+}
+export declare function findPath(vault: Vault, args: {
+    from?: string;
+    from_title?: string;
+    to?: string;
+    to_title?: string;
+    max_depth?: number;
+    include_alternatives?: boolean;
+    follow_embeds?: boolean;
+}): Promise<FindPathResult>;
+export interface OpenInUiResult {
+    uri: string;
+    vault_name: string;
+    path: string;
+    title: string;
+}
+export declare function openInUi(vault: Vault, args: {
+    path?: string;
+    title?: string;
+    new_pane?: boolean;
+}): Promise<OpenInUiResult>;
+export interface ContextPackArgs {
+    /** Topic / question to gather context for. */
+    query: string;
+    /** Approximate token budget for the bundle. ~4 chars/token assumption. Default 4000. */
+    budget_tokens?: number;
+    /** Restrict retrieval to this folder. */
+    folder?: string;
+    /** Include backlinks of top-K notes (1-line each)? Default true. */
+    include_backlinks?: boolean;
+    /** Include the last N daily notes? Default 0 (off). Set to 3 for "what was I doing recently". */
+    recent_dailies?: number;
+}
+export interface ContextPackResult {
+    query: string;
+    /** The packed markdown bundle ready to paste into an AI chat. */
+    bundle: string;
+    /** Approximate token count (chars / 4). */
+    estimated_tokens: number;
+    budget_tokens: number;
+    /** Per-section byte counts for observability. */
+    sections: {
+        notes: number;
+        backlinks: number;
+        dailies: number;
+    };
+    /** Top-K hit paths included in the bundle. */
+    included_notes: string[];
+}
+export declare function contextPack(vault: Vault, args: ContextPackArgs, ctx: {
+    ftsIndex: FtsIndex | null;
+    embedFile: string;
+}): Promise<ContextPackResult>;
+export declare function jaccard<T>(a: Set<T>, b: Set<T>): number;
+export declare function intersectionSize<T>(a: Set<T>, b: Set<T>): number;
+export declare function ngrams(s: string, n: number): Set<string>;
+interface EntryIndex {
+    byBasename: Map<string, FileEntry[]>;
+    byRelPath: Map<string, FileEntry>;
+}
+export declare function indexFor(entries: FileEntry[]): EntryIndex;
+export declare function findBestMatch(entries: FileEntry[], target: string, fromNote?: string): FileEntry | null;
+export declare function stripMd(name: string): string;
+export declare function normalizeTag(t: string): string;
+export {};
+//# sourceMappingURL=meta.d.ts.map

package/dist/tools/meta.d.ts.map

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