oh-my-second-brain 0.1.8 → 0.2.0

package/dist/cli/host-commands.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Host-lifecycle CLI commands: `install`, `uninstall`, `update`, and the
+ * internal `update-reconcile`.
+ *
+ * These four are the only commands that mutate host adapter state (and, for
+ * install, the global vault record), so they live together and away from the
+ * router, which owns dispatch alone.
+ */
+import { type RuntimeSelection } from "../install/hosts.js";
+/** Everything the host commands need from the parsed argv, plus the adapter root. */
+export interface HostCommandContext {
+    readonly vault: string;
+    readonly vaultExplicit: boolean;
+    readonly runtime: RuntimeSelection | undefined;
+    readonly agentVault: string | undefined;
+    readonly dryRun: boolean;
+    readonly executeExternal: boolean;
+    readonly yes: boolean;
+    readonly json: boolean;
+    readonly checkUpdate: boolean;
+    readonly timeoutMs: number | undefined;
+    readonly unknownFlags: readonly string[];
+    readonly adapterRoot: string;
+}
+/** `oms install` / `oms uninstall`. Returns the process exit code. */
+export declare function runInstallOrUninstall(action: "install" | "uninstall", context: HostCommandContext): Promise<number>;
+/** `oms update`. Returns the process exit code. */
+export declare function runUpdateCommand(context: HostCommandContext): Promise<number>;
+/** `oms update-reconcile` — internal; re-runs install after a package update. */
+export declare function runUpdateReconcile(context: HostCommandContext): Promise<number>;

package/dist/cli/host-commands.js

@@ -0,0 +1,89 @@
+/**
+ * Host-lifecycle CLI commands: `install`, `uninstall`, `update`, and the
+ * internal `update-reconcile`.
+ *
+ * These four are the only commands that mutate host adapter state (and, for
+ * install, the global vault record), so they live together and away from the
+ * router, which owns dispatch alone.
+ */
+import path from "node:path";
+import { formatHostOperationResults, formatHostOperationResultsJson, runHostOperation, } from "../install/hosts.js";
+import { formatUpdateResult, runUpdate } from "../update/update.js";
+import { backfillGlobalVaultFromEnv, nonFatalGlobalWriteback, registerGlobalVault, } from "./global-writeback.js";
+import { readCurrentPackageVersion } from "./update-notice.js";
+/** Persist the vault the install just configured into the global record. */
+async function recordInstalledVault(context) {
+    if (context.vaultExplicit) {
+        await nonFatalGlobalWriteback(() => registerGlobalVault({ vault: path.resolve(context.vault), homeDir: undefined, overwrite: true }));
+        return;
+    }
+    await nonFatalGlobalWriteback(() => backfillGlobalVaultFromEnv({ env: process.env, homeDir: undefined }));
+}
+/** `oms install` / `oms uninstall`. Returns the process exit code. */
+export async function runInstallOrUninstall(action, context) {
+    if (action === "uninstall" && !context.yes && !context.dryRun && process.env["OMS_NON_INTERACTIVE"] !== "1") {
+        console.error("[oms] Refusing uninstall without --yes or --dry-run.");
+        return 1;
+    }
+    const results = await runHostOperation({
+        action,
+        runtime: context.runtime ?? (action === "install" ? "auto" : "all"),
+        vault: context.vault,
+        agentVault: context.agentVault,
+        dryRun: context.dryRun,
+        executeExternal: context.executeExternal,
+        yes: context.yes,
+        adapterRoot: context.adapterRoot,
+    });
+    console.log(context.json
+        ? formatHostOperationResultsJson(results, context.dryRun)
+        : formatHostOperationResults(results, context.dryRun));
+    if (action === "install" && !context.dryRun)
+        await recordInstalledVault(context);
+    return 0;
+}
+/** `oms update`. Returns the process exit code. */
+export async function runUpdateCommand(context) {
+    if (context.unknownFlags.length > 0) {
+        console.error(`[oms] Unsupported update option: ${context.unknownFlags.join(", ")}`);
+        return 1;
+    }
+    const result = await runUpdate({
+        currentVersion: await readCurrentPackageVersion(),
+        latestVersion: process.env["OMS_UPDATE_LATEST_VERSION"],
+        runtime: context.runtime ?? "all",
+        vault: context.vault,
+        check: context.checkUpdate,
+        dryRun: context.dryRun,
+        yes: context.yes,
+        executeExternal: context.executeExternal,
+        timeoutMs: context.timeoutMs,
+        reconcileCommand: {
+            command: process.execPath,
+            argsPrefix: process.argv[1] === undefined ? [] : [process.argv[1]],
+        },
+    });
+    console.log(formatUpdateResult(result));
+    return result.success ? 0 : 1;
+}
+/** `oms update-reconcile` — internal; re-runs install after a package update. */
+export async function runUpdateReconcile(context) {
+    if (process.env["OMS_UPDATE_RECONCILE"] !== "1" && !context.dryRun) {
+        console.error("[oms] update-reconcile is internal; run `oms update --yes` instead.");
+        return 1;
+    }
+    const results = await runHostOperation({
+        action: "install",
+        runtime: context.runtime ?? "all",
+        vault: context.vault,
+        dryRun: context.dryRun,
+        executeExternal: context.executeExternal,
+        yes: true,
+        adapterRoot: context.adapterRoot,
+    });
+    console.log(context.json
+        ? formatHostOperationResultsJson(results, context.dryRun)
+        : formatHostOperationResults(results, context.dryRun));
+    return 0;
+}
+//# sourceMappingURL=host-commands.js.map

package/dist/cli/host-commands.js.map

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

package/dist/cli/link-command.d.ts

@@ -0,0 +1,9 @@
+import { type CreateVaultLinkResult } from "../link/link.js";
+export declare function formatLinkResult(result: CreateVaultLinkResult, conventionNotePath?: string): string;
+export declare function runLink(options: {
+    readonly cwd: string;
+    readonly vault: string;
+    readonly vaultExplicit: boolean;
+    readonly folders: readonly string[];
+    readonly conventionNote?: boolean;
+}): Promise<number>;

package/dist/cli/link-command.js

@@ -0,0 +1,47 @@
+import { createVaultLink, LINKED_GITIGNORE_PATTERN, } from "../link/link.js";
+import { writeConventionUsageSection } from "../link/convention-note.js";
+export function formatLinkResult(result, conventionNotePath) {
+    const lines = ["Oh My Second Brain vault bridge ready."];
+    lines.push(`  Vault:     ${result.record.vault}`);
+    lines.push(`  Scope:     ${result.record.scope.join(", ") || "(none)"}`);
+    if (result.linked.length > 0)
+        lines.push(`  Linked:    ${result.linked.join(", ")}`);
+    if (result.unchanged.length > 0)
+        lines.push(`  Unchanged: ${result.unchanged.join(", ")}`);
+    lines.push(`  Record:    ${result.recordPath}`);
+    lines.push(result.gitignoreUpdated
+        ? `  Gitignore: added ${LINKED_GITIGNORE_PATTERN}`
+        : `  Gitignore: ${LINKED_GITIGNORE_PATTERN} already present`);
+    if (conventionNotePath !== undefined) {
+        lines.push(`  Convention: wrote ${conventionNotePath}`);
+    }
+    return lines.join("\n");
+}
+export async function runLink(options) {
+    if (!options.vaultExplicit) {
+        console.error("[oms] link requires --vault <path> (the Obsidian vault to bridge to).");
+        return 1;
+    }
+    if (options.folders.length === 0) {
+        console.error("[oms] link requires at least one --folder <name>.");
+        return 1;
+    }
+    try {
+        const result = await createVaultLink({
+            cwd: options.cwd,
+            vault: options.vault,
+            folders: [...options.folders],
+        });
+        let conventionNotePath;
+        if (options.conventionNote !== false) {
+            conventionNotePath = (await writeConventionUsageSection(options.cwd, result.record.vault)).agentsPath;
+        }
+        console.log(formatLinkResult(result, conventionNotePath));
+        return 0;
+    }
+    catch (error) {
+        console.error(`[oms] ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+    }
+}
+//# sourceMappingURL=link-command.js.map

package/dist/cli/link-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-command.js","sourceRoot":"","sources":["../../src/cli/link-command.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,wBAAwB,GAEzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAEzE,MAAM,UAAU,gBAAgB,CAC9B,MAA6B,EAC7B,kBAA2B;IAE3B,MAAM,KAAK,GAAa,CAAC,wCAAwC,CAAC,CAAC;IACnE,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;IACzE,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrF,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3F,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,gBAAgB;QACrB,CAAC,CAAC,sBAAsB,wBAAwB,EAAE;QAClD,CAAC,CAAC,gBAAgB,wBAAwB,kBAAkB,CAC/D,CAAC;IACF,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,uBAAuB,kBAAkB,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAM7B;IACC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,uEAAuE,CAAC,CAAC;QACvF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;YACnC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QACH,IAAI,kBAAsC,CAAC;QAC3C,IAAI,OAAO,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;YACrC,kBAAkB,GAAG,CAAC,MAAM,2BAA2B,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;QACxG,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjF,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/cli/linkify.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `oms linkify` — batch retrofit of `[[wikilinks]]` over EXISTING vault notes.
+ *
+ * Report-only by default. Mutation requires BOTH `--apply` and `--yes`, checked
+ * before any note is read, so a half-typed command can never reach the disk.
+ *
+ * The command owns scope and reporting only: span detection stays in
+ * engine/linkify (pure), and every write goes through the capture kernel's
+ * `writeNote`, which keeps path safety, the concept contract, and the
+ * postcondition read-back unduplicated here.
+ */
+export interface LinkifyOptions {
+    readonly vault: string;
+    /** Restrict both scan and writes to one top-level vault folder. */
+    readonly folder?: string;
+    readonly apply: boolean;
+    readonly yes: boolean;
+}
+/**
+ * Scan (and optionally link) a vault, restricting link TARGETS to notes bound
+ * to the `term` concept.
+ */
+export declare function runLinkify(options: LinkifyOptions): Promise<number>;

package/dist/cli/linkify.js

@@ -0,0 +1,118 @@
+/**
+ * `oms linkify` — batch retrofit of `[[wikilinks]]` over EXISTING vault notes.
+ *
+ * Report-only by default. Mutation requires BOTH `--apply` and `--yes`, checked
+ * before any note is read, so a half-typed command can never reach the disk.
+ *
+ * The command owns scope and reporting only: span detection stays in
+ * engine/linkify (pure), and every write goes through the capture kernel's
+ * `writeNote`, which keeps path safety, the concept contract, and the
+ * postcondition read-back unduplicated here.
+ */
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parseNote } from "../conventions/frontmatter.js";
+import { mapWithConcurrency, walkVaultMarkdown } from "../conventions/vault-walk.js";
+import { writeNote } from "../capture/safe.js";
+import { resolveConcept } from "../core/ontology/resolver.js";
+import { applyLinks, hashBody } from "../engine/linkify/apply.js";
+import { suggestLinks, termBoundNotes } from "../engine/linkify/suggest.js";
+import { validateVaultLintFolder } from "../engine/conventions/vault-lint.js";
+import { resolveActiveOntology } from "../ontology/active.js";
+/** Parallel note reads; the walk itself is cheap, contents are the hot cost. */
+const READ_CONCURRENCY = 16;
+/** Flatten an unknown frontmatter `aliases` value to trimmed non-empty strings. */
+function aliasStrings(value) {
+    if (Array.isArray(value))
+        return value.flatMap(aliasStrings);
+    if (typeof value !== "string")
+        return [];
+    const trimmed = value.trim();
+    return trimmed ? [trimmed] : [];
+}
+/** Read every markdown note in the vault, parsed into body + surface forms. */
+async function scanVault(vault, ontology) {
+    const paths = [];
+    for await (const notePath of walkVaultMarkdown(vault))
+        paths.push(notePath);
+    return mapWithConcurrency(paths, READ_CONCURRENCY, async (notePath) => {
+        const raw = await readFile(path.join(vault, notePath), "utf-8");
+        const parsed = parseNote(raw);
+        return {
+            path: notePath,
+            body: parsed.body,
+            concept: resolveConcept(ontology, notePath)?.concept ?? null,
+            aliases: aliasStrings(parsed.frontmatter["aliases"]),
+        };
+    });
+}
+/** True when `notePath` sits inside `folder` (or when no scope was requested). */
+function inScope(notePath, folder) {
+    return folder === undefined || notePath.startsWith(`${folder}/`);
+}
+function toTermNote(note) {
+    return { path: note.path, concept: note.concept, aliases: note.aliases };
+}
+function describeCandidate(candidate) {
+    const ambiguity = candidate.ambiguous ? ` (ambiguous: ${candidate.rivalPaths.join(", ")})` : "";
+    return `    ${candidate.matchedText} → ${candidate.renderedReplacement}  [${candidate.targetPath}]${ambiguity}`;
+}
+/** Print one note's proposals; returns how many candidates it had. */
+function reportNote(notePath, candidates) {
+    console.log(`\n  ${notePath}`);
+    for (const candidate of candidates)
+        console.log(describeCandidate(candidate));
+}
+/** Persist one note's candidates through the capture kernel. */
+async function applyNote(vault, ontology, note, candidates) {
+    const result = await applyLinks({
+        body: note.body,
+        baseContentHash: hashBody(note.body),
+        accepted: candidates,
+        writeNote,
+        target: { target: { vault, source: "explicit" }, ontology, notePath: note.path },
+    });
+    if (result.applied)
+        return true;
+    console.error(`[oms] linkify skipped ${note.path}: ${result.reason}`);
+    return false;
+}
+/**
+ * Scan (and optionally link) a vault, restricting link TARGETS to notes bound
+ * to the `term` concept.
+ */
+export async function runLinkify(options) {
+    if (options.apply && !options.yes) {
+        console.error("[oms] linkify --apply rewrites notes in place; re-run with --yes to confirm. Nothing was written.");
+        return 1;
+    }
+    try {
+        const { ontology } = await resolveActiveOntology(options.vault);
+        await validateVaultLintFolder(options.vault, ontology, options.folder);
+        const notes = await scanVault(options.vault, ontology);
+        const targets = termBoundNotes(notes.map(toTermNote));
+        const scoped = notes.filter((note) => inScope(note.path, options.folder));
+        console.log(`\nOh My Second Brain linkify: ${String(scoped.length)} note(s) in scope, ${String(targets.length)} term note(s) available as link targets.`);
+        let candidateCount = 0;
+        let appliedNotes = 0;
+        for (const note of scoped) {
+            const candidates = suggestLinks(note.body, targets, { notePath: note.path });
+            if (candidates.length === 0)
+                continue;
+            candidateCount += candidates.length;
+            reportNote(note.path, candidates);
+            if (options.apply && (await applyNote(options.vault, ontology, note, candidates))) {
+                appliedNotes++;
+            }
+        }
+        console.log(options.apply
+            ? `\n${String(candidateCount)} candidate(s); applied to ${String(appliedNotes)} note(s).\n`
+            : `\n${String(candidateCount)} candidate(s) proposed across ${String(scoped.length)} note(s). Report only — nothing was written. Re-run with --apply --yes to write.\n`);
+        return 0;
+    }
+    catch (error) {
+        console.error(`[oms] linkify could not complete: ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+    }
+}
+//# sourceMappingURL=linkify.js.map

package/dist/cli/linkify.js.map

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

package/dist/cli/oms.d.ts

@@ -1,33 +1,9 @@
 #!/usr/bin/env node
-import { type UpdateRunner } from "../update/update.js";
-export declare function maybePrintUpdateNotice(options?: {
-    readonly currentVersion?: string | null;
-    readonly latestVersion?: string;
-    readonly timeoutMs?: number;
-    readonly runner?: UpdateRunner;
-    readonly env?: Readonly<Record<string, string | undefined>>;
-    readonly write?: (message: string) => void;
-}): Promise<void>;
-export interface SetupPrompt {
-    question(query: string): Promise<string>;
-    close(): void;
-}
-export interface ClaudeInstallPlan {
-    pluginPath: string;
-    pluginInstallCommand: string;
-    mcpRegistrationCommand: string;
-    mcpRuntimeStatus: "read-status-runtime";
-}
-export declare function buildClaudeInstallPlan(opts: {
-    vault: string;
-}): ClaudeInstallPlan;
-export declare function runSetup(opts: {
-    vault: string;
-    yes: boolean;
-    installClaude?: boolean;
-    suggestFields?: boolean;
-    prompt?: SetupPrompt;
-}): Promise<void>;
-export declare function runDoctor(opts: {
-    vault: string;
-}): Promise<number>;
+export { buildClaudeInstallPlan } from "./claude-install-plan.js";
+export type { ClaudeInstallPlan } from "./claude-install-plan.js";
+export { runDoctor, runLint } from "./doctor-lint.js";
+export { runAudit } from "./audit.js";
+export { formatLinkResult, runLink, } from "./link-command.js";
+export { runLinkify } from "./linkify.js";
+export { runSetup, type SetupPrompt, } from "./setup-command.js";
+export { maybePrintUpdateNotice } from "./update-notice.js";