@monoes/monomindcli 2.14.1 → 2.15.0

package/dist/src/knowledge/lookup.js

@@ -0,0 +1,156 @@
+/**
+ * "Have I already saved this?" (RCL-02) — one URL in, one answer out.
+ *
+ * The browser extension asks this on every navigation. That is the only
+ * thing that shapes this module:
+ *
+ *  - it NEVER throws. An empty store, a store that has never been written,
+ *    a URL that is not a URL — all of them are `{saved: false}`, because a
+ *    page load must not be able to fail on a badge;
+ *  - it is a pure read. No embedder, no subprocess, no index write. The
+ *    answer comes off the metadata log, which is a file read;
+ *  - it answers the WHOLE question in one call. `doc list` can already say
+ *    that a URL is present, but not what note was written at save time —
+ *    and "you saved this, and here is why you said you were saving it" is
+ *    the entire value of the badge over a bookmark.
+ *
+ * Identity is `captureIdentityUrl`'s rule and nothing else: canonical URL
+ * when the capturer resolved one, fragment stripped, nothing else rewritten.
+ * Matching more loosely than the ingest side would make the badge claim
+ * pages are saved that cannot actually be found again.
+ *
+ * @module v1/cli/knowledge/lookup
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { isCaptureEnvelope } from './capture-envelope.js';
+import { getKnowledgeRoot, listDocuments, listDocumentVersions, } from './document-pipeline.js';
+import { documentCapturedAt, documentSite } from './library.js';
+const EMPTY = (url) => ({ saved: false, url, versions: 0, tags: [] });
+/**
+ * identityUrl mirrors `captureIdentityUrl` for a raw URL rather than a
+ * provenance record: drop the fragment, trim, rewrite nothing else.
+ *
+ * Duplicated deliberately rather than reshaping the URL into a fake
+ * `CaptureProvenance` to borrow that function — the two callers mean
+ * different things ("the URL a tab is on" vs. "what this capture is of")
+ * and only happen to agree on the rule.
+ */
+export function identityUrl(raw) {
+    const s = String(raw ?? '').trim();
+    const hash = s.indexOf('#');
+    return (hash === -1 ? s : s.slice(0, hash)).trim();
+}
+/** The identity URL a record is addressable by, or undefined. */
+function recordUrl(meta) {
+    const url = meta.canonicalUrl ?? meta.provenance?.canonicalUrl ?? meta.provenance?.url;
+    return url ? identityUrl(url) : undefined;
+}
+/**
+ * countHighlights reads the `highlights.json` the extension wrote beside
+ * the document (RCL-04). Silent on every failure: the count is decoration
+ * on an answer that is already complete without it.
+ */
+function countHighlights(envelope) {
+    try {
+        const file = path.join(envelope, 'highlights.json');
+        if (!fs.existsSync(file))
+            return 0;
+        const parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
+        return Array.isArray(parsed?.highlights) ? parsed.highlights.length : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/** The envelope directory for an indexed file, or undefined when the file
+ *  is not inside one. */
+export function envelopeFor(filePath) {
+    if (!filePath)
+        return undefined;
+    const dir = path.dirname(path.resolve(filePath));
+    try {
+        return isCaptureEnvelope(dir) ? dir : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function provenanceOf(meta) {
+    return meta.provenance ?? {};
+}
+/**
+ * lookupUrl answers whether this URL is in the store, and what is known
+ * about it. `rootDir` is the store to look in; pass the global brain's root
+ * to ask the personal store.
+ */
+export function lookupUrl(rawUrl, opts = {}) {
+    const url = identityUrl(rawUrl);
+    if (!url)
+        return EMPTY('');
+    // The SAME routing the ingest used: scope `global` lives in the personal
+    // cross-project brain, not under `rootDir`. Reading the wrong store would
+    // report every globally-captured page as unsaved.
+    let root;
+    let docs;
+    try {
+        root = opts.scope ? getKnowledgeRoot(opts.scope, opts.rootDir) : opts.rootDir;
+        docs = listDocuments(root, opts.scope);
+    }
+    catch {
+        // A store that has never been written, or one this process cannot
+        // read. Neither is an error worth failing a page load over.
+        return EMPTY(url);
+    }
+    const matches = docs.filter((d) => recordUrl(d) === url);
+    if (!matches.length)
+        return EMPTY(url);
+    // The live record with the highest version. A re-captured page lands at
+    // a new path, so several records can match and only the newest is the
+    // one the badge should describe.
+    const best = matches.reduce((a, b) => ((b.version ?? 0) > (a.version ?? 0) ? b : a));
+    const prov = provenanceOf(best);
+    // The version COUNT is the larger of the record's own number and what
+    // the append-only log still holds: the log is compacted past 1MB, and
+    // the `version` field is the durable count. Reading only the log would
+    // under-report a long-lived document.
+    let logged = 0;
+    try {
+        logged = listDocumentVersions(root, best.canonicalUrl ?? url, opts.scope).length;
+    }
+    catch {
+        logged = 0;
+    }
+    const versions = Math.max(best.version ?? 1, logged, 1);
+    const envelope = envelopeFor(best.filePath);
+    const answer = {
+        saved: true,
+        url,
+        versions,
+        tags: prov.tags ?? [],
+        ...(prov.title ? { title: prov.title } : {}),
+        ...(documentSite(best) ? { site: documentSite(best) } : {}),
+        ...(documentCapturedAt(best) ? { capturedAt: documentCapturedAt(best) } : {}),
+        ...(prov.note ? { note: prov.note } : {}),
+        ...(prov.collection ? { collection: prov.collection } : {}),
+        ...(prov.source ? { source: prov.source } : {}),
+        filePath: best.filePath,
+        ...(envelope ? { envelope } : {}),
+        scope: best.scope,
+        ...(best.contentHash ? { contentHash: best.contentHash } : {}),
+    };
+    if (opts.withHighlights && envelope) {
+        const count = countHighlights(envelope);
+        if (count)
+            answer.highlights = count;
+    }
+    return answer;
+}
+/**
+ * lookupUrls answers a batch in one pass over the metadata, for a caller
+ * with several tabs to ask about. Same rules, same guarantees.
+ */
+export function lookupUrls(urls, opts = {}) {
+    return urls.map((u) => lookupUrl(u, opts));
+}
+//# sourceMappingURL=lookup.js.map

package/dist/src/knowledge/lookup.js.map

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

package/dist/src/knowledge/okf-bundle.d.ts

@@ -0,0 +1,19 @@
+/**
+ * OKF bundles — export the indexed documents to a portable Markdown bundle
+ * (frontmatter + `index.md`), and ingest one back.
+ *
+ * A bundle is plain files, so a round trip goes back through the ordinary
+ * ingest path rather than restoring index records directly: whatever comes
+ * back is re-extracted, re-chunked and re-versioned like any other document.
+ *
+ * Split out of document-pipeline.ts.
+ *
+ * @module v1/cli/knowledge/okf-bundle
+ */
+import type { BatchIngestResult } from './document-types.js';
+export declare function exportToOKF(outputDir: string, rootDir?: string, scope?: string): Promise<{
+    exported: number;
+    outputDir: string;
+}>;
+export declare function importFromOKF(bundleDir: string, scope?: string, rootDir?: string): Promise<BatchIngestResult>;
+//# sourceMappingURL=okf-bundle.d.ts.map

package/dist/src/knowledge/okf-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"okf-bundle.d.ts","sourceRoot":"","sources":["../../../src/knowledge/okf-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,wBAAsB,WAAW,CAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,SAAmB,EAC1B,KAAK,SAAW,GACf,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA8DlD;AAID,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,KAAK,SAAW,EAChB,OAAO,SAAmB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CA4B5B"}

package/dist/src/knowledge/okf-bundle.js

@@ -0,0 +1,106 @@
+/**
+ * OKF bundles — export the indexed documents to a portable Markdown bundle
+ * (frontmatter + `index.md`), and ingest one back.
+ *
+ * A bundle is plain files, so a round trip goes back through the ordinary
+ * ingest path rather than restoring index records directly: whatever comes
+ * back is re-extracted, re-chunked and re-versioned like any other document.
+ *
+ * Split out of document-pipeline.ts.
+ *
+ * @module v1/cli/knowledge/okf-bundle
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { extractText } from '../capabilities/cap-documents.js';
+// Static import is safe and deliberate: memory-bridge imports only node builtins
+// at module scope (everything heavy is lazy), and the project-root rule must not
+// be duplicated — two copies of "which directory is this project" is exactly the
+// bug this default exists to fix.
+import { getProjectRoot } from '../memory/memory-bridge.js';
+import { listDocuments } from './document-index.js';
+import { ingestDocument, toFileEntry } from './document-ingest.js';
+export async function exportToOKF(outputDir, rootDir = getProjectRoot(), scope = 'shared') {
+    const docs = listDocuments(rootDir, scope);
+    fs.mkdirSync(outputDir, { recursive: true });
+    let exported = 0;
+    const indexEntries = [];
+    for (const doc of docs) {
+        // Read original content
+        let content = '';
+        try {
+            if (fs.existsSync(doc.filePath)) {
+                const entry = toFileEntry(doc.filePath);
+                content = await extractText(entry);
+            }
+        }
+        catch {
+            continue;
+        }
+        if (!content)
+            continue;
+        const title = path.basename(doc.filePath, path.extname(doc.filePath));
+        const ext = path.extname(doc.filePath).toLowerCase();
+        const relativePath = path.relative(rootDir, doc.filePath);
+        const slug = title.replace(/[^a-zA-Z0-9._-]+/g, '-').toLowerCase();
+        const outFile = path.join(outputDir, `${slug}.md`);
+        const yamlEscape = (s) => /[:"'[\]{}#&*!|>%@`]/.test(s) ? `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"` : s;
+        const frontmatter = [
+            '---',
+            `type: Document`,
+            `title: ${yamlEscape(title)}`,
+            `description: ${yamlEscape(`Extracted from ${path.basename(doc.filePath)}`)}`,
+            `resource: ${yamlEscape(relativePath)}`,
+            `tags: ["document", ${yamlEscape(ext.slice(1))}]`,
+            `timestamp: ${yamlEscape(doc.indexedAt)}`,
+            `contentHash: ${yamlEscape(doc.contentHash)}`,
+            `chunkCount: ${doc.chunkCount}`,
+            '---',
+            '',
+        ].join('\n');
+        fs.writeFileSync(outFile, frontmatter + content, 'utf-8');
+        indexEntries.push(`* [${title}](${slug}.md) - ${path.basename(doc.filePath)} (${doc.chunkCount} chunks)`);
+        exported++;
+    }
+    // Write index.md
+    const indexContent = [
+        `# Knowledge Bundle`,
+        '',
+        `Exported from monomind on ${new Date().toISOString().slice(0, 10)}`,
+        '',
+        ...indexEntries,
+        '',
+    ].join('\n');
+    fs.writeFileSync(path.join(outputDir, 'index.md'), indexContent, 'utf-8');
+    return { exported, outputDir };
+}
+// ── OKF Import ─────────────────────────────────────────────────────
+export async function importFromOKF(bundleDir, scope = 'shared', rootDir = getProjectRoot()) {
+    const resolved = path.resolve(bundleDir);
+    const files = fs
+        .readdirSync(resolved)
+        .filter((f) => f.endsWith('.md') && f !== 'index.md' && f !== 'log.md')
+        .map((f) => path.join(resolved, f));
+    const result = {
+        filesProcessed: 0,
+        filesSkipped: 0,
+        totalChunks: 0,
+        errors: [],
+        results: [],
+    };
+    for (const file of files) {
+        const r = await ingestDocument(file, scope, rootDir);
+        result.results.push(r);
+        if (r.skipped) {
+            result.filesSkipped++;
+        }
+        else {
+            result.filesProcessed++;
+            result.totalChunks += r.chunksIndexed;
+        }
+        if (r.error && !r.skipped)
+            result.errors.push(`${r.filePath}: ${r.error}`);
+    }
+    return result;
+}
+//# sourceMappingURL=okf-bundle.js.map

package/dist/src/knowledge/okf-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"okf-bundle.js","sourceRoot":"","sources":["../../../src/knowledge/okf-bundle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,kCAAkC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnE,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,SAAiB,EACjB,OAAO,GAAG,cAAc,EAAE,EAC1B,KAAK,GAAG,QAAQ;IAEhB,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3C,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7C,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,wBAAwB;QACxB,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACxC,OAAO,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACrD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QACnE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;QAEnD,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,EAAE,CAC/B,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,MAAM,WAAW,GAAG;YAClB,KAAK;YACL,gBAAgB;YAChB,UAAU,UAAU,CAAC,KAAK,CAAC,EAAE;YAC7B,gBAAgB,UAAU,CAAC,kBAAkB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;YAC7E,aAAa,UAAU,CAAC,YAAY,CAAC,EAAE;YACvC,sBAAsB,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG;YACjD,cAAc,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;YACzC,gBAAgB,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;YAC7C,eAAe,GAAG,CAAC,UAAU,EAAE;YAC/B,KAAK;YACL,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1D,YAAY,CAAC,IAAI,CACf,MAAM,KAAK,KAAK,IAAI,UAAU,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,UAAU,UAAU,CACvF,CAAC;QACF,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,iBAAiB;IACjB,MAAM,YAAY,GAAG;QACnB,oBAAoB;QACpB,EAAE;QACF,6BAA6B,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QACpE,EAAE;QACF,GAAG,YAAY;QACf,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;IAE1E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC;AAED,sEAAsE;AAEtE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAAiB,EACjB,KAAK,GAAG,QAAQ,EAChB,OAAO,GAAG,cAAc,EAAE;IAE1B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,EAAE;SACb,WAAW,CAAC,QAAQ,CAAC;SACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,QAAQ,CAAC;SACtE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAsB;QAChC,cAAc,EAAE,CAAC;QACjB,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;KACZ,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC,aAAa,CAAC;QACxC,CAAC;QACD,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO;YAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/knowledge/profile-store.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Per-profile capture stores (the browser track's profile feature).
+ *
+ * mono-agent has profiles — work, personal, a client — and a page captured
+ * from the browser can name the one it belongs to (`meta.profile` on the
+ * capture envelope). The promise that makes that worth having is negative:
+ * a page saved into `work` must NOT come back from a search of `personal`.
+ *
+ * WHICH MECHANISM, AND WHY. A store here is three things — a vector db
+ * directory (`dbPath`), a namespace, and the root the `doc-metadata.jsonl`
+ * lives under — and `scope` already decides all three (see
+ * document-pipeline: `namespace()`, `effectiveRoot()`, `storeDbPath()`).
+ * `global` is the existing proof: one scope value routes to a directory
+ * outside any project. A profile is the same shape, so it is expressed the
+ * same way — a scope of `profile:<id>` — rather than as a second, parallel
+ * "which brain" parameter threaded through ingest, search, cite and
+ * related. Nothing here is a new concept; it is one more value of an
+ * existing one.
+ *
+ * WHERE THE DIRECTORY GOES. Inside the global brain
+ * (`~/.monomind/global-brain/profiles/<id>`), not beside it. That is not
+ * cosmetic: `memory-bridge.getDbPath` refuses any dbPath outside the
+ * project, the per-project data dir, or the global brain, and — this is the
+ * dangerous part — a refused path does not throw, it silently falls back to
+ * the DEFAULT store. A profile brain anywhere else would quietly put every
+ * profile's captures in one database, which is the exact failure this
+ * feature exists to prevent. Being inside the global brain also inherits
+ * its protection from `cleanup --data`, which prunes `~/.monomind/projects`
+ * and deliberately never touches its sibling.
+ *
+ * UNTRUSTED INPUT. The profile id arrives from a browser extension and
+ * becomes a directory name. `isValidProfileId` is the guard, kept
+ * deliberately identical to Go's `profiledir.ValidProfileID` — the two
+ * sides of this contract must reject exactly the same strings.
+ *
+ * @module v1/cli/knowledge/profile-store
+ */
+/** Scopes of the form `profile:<id>` address one profile's own store. */
+export declare const PROFILE_SCOPE_PREFIX = "profile:";
+/**
+ * isValidProfileId mirrors `profiledir.ValidProfileID` (Go): non-empty, no
+ * path separator, no parent-directory component. Every other function here
+ * returns undefined for an id this rejects, so a hostile id can never
+ * become a path — not even a path that is then refused.
+ */
+export declare function isValidProfileId(id: unknown): id is string;
+/** The scope value addressing one profile's store, or undefined. */
+export declare function profileScope(id: unknown): string | undefined;
+/** The profile id inside a `profile:<id>` scope, or undefined for any other. */
+export declare function parseProfileScope(scope: unknown): string | undefined;
+/** True for a scope that names a profile. */
+export declare const isProfileScope: (scope: unknown) => boolean;
+/**
+ * profileBrainDir is a profile's store directory — the value used BOTH as
+ * the dbPath and as the metadata root, exactly as the global brain uses one
+ * directory for both.
+ *
+ * It creates the directory, which a resolver would not normally do. The
+ * reason is specific: `memory-bridge.getDbPath` compares
+ * `fs.realpathSync(dbPath)` against `fs.realpathSync(globalBrainDir)`, and
+ * a path that does not exist yet cannot be realpath'd. On a machine where
+ * the home directory is reached through a symlink, the two sides would then
+ * resolve differently, the guard would reject the path, and — because that
+ * guard falls back instead of throwing — the profile's captures would land
+ * in the default store together with every other profile's. Creating the
+ * directory first makes both sides resolvable and the comparison honest.
+ */
+export declare function profileBrainDir(id: unknown): string | undefined;
+/**
+ * profileStoreDir is profileBrainDir for a `profile:<id>` SCOPE, and
+ * undefined for every other scope — the single function
+ * `document-store`'s `effectiveRoot`/`storeDbPath` consult, so that the
+ * routing rule lives in one place and the pipeline keeps a two-line hook.
+ *
+ * DO NOT MOVE THIS DIRECTORY OUT OF THE GLOBAL BRAIN. The nesting looks
+ * arbitrary and is not: `memory-bridge.getDbPath` accepts a dbPath only
+ * inside the project, the per-project data dir, or the global brain, and a
+ * path it does not accept is NOT rejected — it SILENTLY RETURNS THE DEFAULT
+ * STORE. So a profile brain sited anywhere else (beside the global brain,
+ * under `~/.monoagent`, under the profile's own root) does not fail: every
+ * profile's captures quietly land in one database, `work` turns up in a
+ * `personal` search, and nothing anywhere reports a problem. The feature
+ * fails by succeeding. `src/__tests__/profile-store-dbpath.test.ts` holds
+ * both halves of that — this path surviving, and an outside path silently
+ * becoming the default.
+ */
+export declare function profileStoreDir(scope: unknown): string | undefined;
+/**
+ * profileInboxDir is where that profile's captures land, as the Go side
+ * writes them: `~/.monoagent/profiles/<id>/.monomind/inbox`.
+ *
+ * Keyed by profile id alone. mono-agent lets a profile's root be moved
+ * (`profiles.root_dir`), and the capture inbox deliberately does NOT follow
+ * it on either side — see `ProfileInbox` in `internal/capture/profile.go`
+ * for why. This path and that one are the same rule written twice, which is
+ * the cost of the two repos agreeing about a directory at all.
+ */
+export declare function profileInboxDir(id: unknown): string | undefined;
+/**
+ * profileInboxes lists the profile inboxes that exist on this machine, for
+ * a sweep that wants to ingest every profile's captures rather than only
+ * the shared inbox. Missing directories are simply absent; nothing here
+ * throws.
+ */
+export declare function profileInboxes(): Array<{
+    id: string;
+    inbox: string;
+    scope: string;
+}>;
+/**
+ * captureScope is the routing rule, applied once per ingest: a capture
+ * whose envelope names a profile belongs to that profile's store, whatever
+ * scope the caller reached for.
+ *
+ * The envelope wins on purpose. The profile was chosen by a person at save
+ * time, in the browser, and every automatic caller (`doc ingest` on a path
+ * outside any project, the dashboard's watcher, an inbox sweep) picks its
+ * scope from where the FILE is rather than from what it holds. A caller
+ * that genuinely means a particular store says so by passing a
+ * `profile:<id>` scope, which is returned untouched.
+ */
+export declare function captureScope(scope: string, filePath: string): string;
+/**
+ * envelopeProfile reads the `profile` out of the capture envelope holding
+ * `filePath`, if there is one. Defensive on the same terms as the rest of
+ * capture-envelope: `meta.json` is written by a browser extension on a
+ * machine we do not control, so every failure — absent, oversized,
+ * truncated, wrong-typed, or an id that could escape a directory — is
+ * "this capture names no profile", never a thrown error.
+ */
+export declare function envelopeProfile(filePath: string): string | undefined;
+/** A human-readable name for a scope, for a listing or a search result. */
+export declare function describeScope(scope: string): string;
+//# sourceMappingURL=profile-store.d.ts.map

package/dist/src/knowledge/profile-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-store.d.ts","sourceRoot":"","sources":["../../../src/knowledge/profile-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAMH,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAiB/C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,CAO1D;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAE5D;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIpE;AAED,6CAA6C;AAC7C,eAAO,MAAM,cAAc,UAAW,OAAO,KAAG,OAAiD,CAAC;AAKlG;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAa/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBpF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIpE;AAKD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYpE;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnD"}