oh-my-second-brain 0.1.8 → 0.2.0

package/dist/install/common.js

@@ -0,0 +1,122 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, lstatSync } from "node:fs";
+import { cp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import { isMap, parseDocument } from "yaml";
+export class InstallTargetSymlinkError extends Error {
+    target;
+    constructor(target) {
+        super(`Refusing to replace symlinked Oh My Second Brain install target: ${target}`);
+        this.name = "InstallTargetSymlinkError";
+        this.target = target;
+    }
+}
+export function commandExists(command) {
+    const result = spawnSync(process.platform === "win32" ? "where" : "command", process.platform === "win32" ? [command] : ["-v", command], {
+        stdio: "ignore",
+        shell: process.platform !== "win32",
+    });
+    return result.status === 0;
+}
+export function hostHome(homeDir, dirname, envName) {
+    const override = process.env[envName];
+    return override ? path.resolve(override) : path.join(homeDir ?? homedir(), dirname);
+}
+export function mcpArgs(options) {
+    return ["mcp", "--vault", options.vault];
+}
+export function jsonString(value) {
+    return JSON.stringify(value);
+}
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export async function readJsonObject(file) {
+    try {
+        const parsed = JSON.parse(await readFile(file, "utf-8"));
+        return isRecord(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+export async function writeJsonObject(file, data, dryRun) {
+    if (dryRun)
+        return false;
+    await mkdir(path.dirname(file), { recursive: true });
+    await writeFile(file, `${JSON.stringify(data, null, 2)}\n`, "utf-8");
+    return true;
+}
+/**
+ * Applies one `section.key` edit to a YAML file while leaving every other byte,
+ * comment, and key ordering the document already had in place.
+ */
+export async function editYamlEntryPreservingComments(file, entryPath, edit) {
+    const raw = existsSync(file) ? await readFile(file, "utf-8") : "";
+    const doc = parseDocument(raw);
+    if (doc.errors.length > 0)
+        return false;
+    if (doc.contents !== null && !isMap(doc.contents))
+        return false;
+    if (edit.kind === "delete") {
+        if (!doc.hasIn(entryPath))
+            return false;
+        doc.deleteIn(entryPath);
+    }
+    else {
+        doc.setIn(entryPath, edit.value);
+    }
+    await mkdir(path.dirname(file), { recursive: true });
+    await writeFile(file, doc.toString(), "utf-8");
+    return true;
+}
+export function mcpServerEntry(options) {
+    return {
+        command: "oms",
+        args: mcpArgs(options),
+    };
+}
+export function runExternal(command, args) {
+    const result = spawnSync(command, args, { stdio: "pipe", encoding: "utf-8" });
+    const stdout = typeof result.stdout === "string" ? result.stdout : "";
+    const stderr = typeof result.stderr === "string" ? result.stderr : "";
+    const exitCode = result.status;
+    const signal = result.signal;
+    if (exitCode === 0) {
+        return {
+            ok: true,
+            exitCode,
+            signal,
+            stdout,
+            stderr,
+            message: `${command} ${args.join(" ")}`,
+        };
+    }
+    const spawnError = result.error instanceof Error ? result.error.message : "";
+    return {
+        ok: false,
+        exitCode,
+        signal,
+        stdout,
+        stderr,
+        message: spawnError || stderr.trim() || stdout.trim() || `${command} exited ${exitCode ?? "unknown"}`,
+    };
+}
+function refuseSymlinkedLeaf(target) {
+    if (!existsSync(target))
+        return;
+    if (lstatSync(target).isSymbolicLink()) {
+        throw new InstallTargetSymlinkError(target);
+    }
+}
+export async function replaceDirectory(source, target, dryRun) {
+    if (dryRun)
+        return false;
+    refuseSymlinkedLeaf(target);
+    await rm(target, { recursive: true, force: true });
+    await mkdir(path.dirname(target), { recursive: true });
+    await cp(source, target, { recursive: true });
+    return true;
+}
+//# sourceMappingURL=common.js.map

package/dist/install/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/install/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAG5C,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,MAAM,CAAS;IAExB,YAAY,MAAc;QACxB,KAAK,CAAC,oEAAoE,MAAM,EAAE,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,MAAM,MAAM,GAAG,SAAS,CACtB,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAClD,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAC1D;QACE,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;KACpC,CACF,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAA2B,EAAE,OAAe,EAAE,OAAe;IACpF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAA6B;IACnD,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAY,CAAC;QACpE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAY,EACZ,IAA6B,EAC7B,MAAe;IAEf,IAAI,MAAM;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC;AACd,CAAC;AAMD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,IAAY,EACZ,SAAoC,EACpC,IAAmB;IAEnB,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;YAAE,OAAO,KAAK,CAAC;QACxC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAA6B;IAC1D,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC;KACvB,CAAC;AACJ,CAAC;AAWD,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAc;IACzD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,QAAQ;YACR,MAAM;YACN,MAAM;YACN,MAAM;YACN,OAAO,EAAE,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;SACxC,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,OAAO;QACL,EAAE,EAAE,KAAK;QACT,QAAQ;QACR,MAAM;QACN,MAAM;QACN,MAAM;QACN,OAAO,EAAE,UAAU,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,WAAW,QAAQ,IAAI,SAAS,EAAE;KACtG,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc;IACzC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO;IAChC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,MAAc,EAAE,MAAe;IACpF,IAAI,MAAM;QAAE,OAAO,KAAK,CAAC;IACzB,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/install/hermes.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessHostSurface } from "../harness/surface-registry.js";
+import type { HostOperationOptions, HostOperationResult } from "./types.js";
+export declare function installHermes(options: HostOperationOptions, host: HarnessHostSurface): Promise<HostOperationResult>;
+export declare function uninstallHermes(options: HostOperationOptions): Promise<HostOperationResult>;

package/dist/install/hermes.js

@@ -0,0 +1,78 @@
+import { existsSync } from "node:fs";
+import { rm } from "node:fs/promises";
+import path from "node:path";
+import { resolveHostAdapterSource } from "./adapter-source.js";
+import { editYamlEntryPreservingComments, hostHome, mcpServerEntry, replaceDirectory } from "./common.js";
+const HERMES_SKILL_CATEGORY = "knowledge-management";
+const HERMES_SKILL_NAME = "oms";
+const HERMES_MCP_ENTRY_PATH = ["mcp_servers", "oms"];
+async function upsertHermesMcp(options, hermesConfig) {
+    if (options.dryRun)
+        return false;
+    return editYamlEntryPreservingComments(hermesConfig, HERMES_MCP_ENTRY_PATH, {
+        kind: "set",
+        value: { ...mcpServerEntry(options), enabled: true },
+    });
+}
+async function removeHermesMcp(options, hermesConfig) {
+    if (options.dryRun)
+        return false;
+    return editYamlEntryPreservingComments(hermesConfig, HERMES_MCP_ENTRY_PATH, { kind: "delete" });
+}
+export async function installHermes(options, host) {
+    const hermesDir = hostHome(options.homeDir, ".hermes", "OMS_HERMES_HOME");
+    const pluginSource = resolveHostAdapterSource(options.adapterRoot, host);
+    const legacyPluginTarget = path.join(hermesDir, "plugins", "oms");
+    const legacyMcpPath = path.join(hermesDir, "mcp", "oms.json");
+    const skillSource = path.join(pluginSource, "skills");
+    const skillTarget = path.join(hermesDir, "skills", HERMES_SKILL_CATEGORY, HERMES_SKILL_NAME);
+    const configPath = path.join(hermesDir, "config.yaml");
+    const adapterTarget = path.join(hermesDir, "adapters", "oms");
+    const messages = ["Installed Hermes-native Oh My Second Brain skill bundle and registered mcp_servers.oms in ~/.hermes/config.yaml."];
+    if (!options.dryRun) {
+        await rm(legacyPluginTarget, { recursive: true, force: true });
+        await rm(legacyMcpPath, { force: true });
+        await replaceDirectory(pluginSource, adapterTarget, false);
+        await replaceDirectory(skillSource, skillTarget, false);
+        if (!(await upsertHermesMcp(options, configPath))) {
+            messages.push(`WARNING: ${configPath} is not a supported YAML mapping; mcp_servers.oms was not registered. Add it manually.`);
+        }
+    }
+    return {
+        runtime: "hermes",
+        action: "install",
+        changed: !options.dryRun,
+        skipped: false,
+        paths: [adapterTarget, skillTarget, configPath],
+        commands: [`Hermes MCP config: ${configPath}`],
+        messages,
+    };
+}
+export async function uninstallHermes(options) {
+    const hermesDir = hostHome(options.homeDir, ".hermes", "OMS_HERMES_HOME");
+    const adapterTarget = path.join(hermesDir, "adapters", "oms");
+    const skillTarget = path.join(hermesDir, "skills", HERMES_SKILL_CATEGORY, HERMES_SKILL_NAME);
+    const legacyPluginTarget = path.join(hermesDir, "plugins", "oms");
+    const legacyMcpPath = path.join(hermesDir, "mcp", "oms.json");
+    const configPath = path.join(hermesDir, "config.yaml");
+    let changed = false;
+    if (existsSync(configPath))
+        changed = (await removeHermesMcp(options, configPath)) || changed;
+    for (const target of [adapterTarget, skillTarget, legacyPluginTarget, legacyMcpPath]) {
+        if (existsSync(target)) {
+            changed = true;
+            if (!options.dryRun)
+                await rm(target, { recursive: true, force: true });
+        }
+    }
+    return {
+        runtime: "hermes",
+        action: "uninstall",
+        changed: changed && !options.dryRun,
+        skipped: !changed,
+        paths: [adapterTarget, skillTarget, configPath],
+        commands: [],
+        messages: ["Removed Hermes Oh My Second Brain skill bundle, adapter copy, legacy descriptor files, and mcp_servers.oms."],
+    };
+}
+//# sourceMappingURL=hermes.js.map

package/dist/install/hermes.js.map

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

package/dist/install/hosts.d.ts

@@ -1,59 +1,9 @@
-export type HostRuntime = "claude" | "codex" | "hermes";
-export type RuntimeSelection = HostRuntime | "auto" | "all";
-export type HostAction = "install" | "uninstall";
-export interface HostOperationOptions {
-    action: HostAction;
-    runtime: RuntimeSelection;
-    vault: string;
-    /** Optional second vault path (e.g. agent/raw vault). Emitted as OMS_AGENT_VAULT. */
-    agentVault?: string;
-    packageSpec?: string;
-    dryRun?: boolean;
-    executeExternal?: boolean;
-    yes?: boolean;
-    homeDir?: string;
-    adapterRoot: string;
-}
-export interface HostOperationResult {
-    runtime: HostRuntime;
-    action: HostAction;
-    changed: boolean;
-    skipped: boolean;
-    paths: string[];
-    commands: string[];
-    messages: string[];
-}
+import type { HostOperationOptions, HostOperationResult, HostRuntime, RuntimeSelection } from "./types.js";
+export type { HostAction, HostOperationOptions, HostOperationResult, HostRuntime, RuntimeSelection, } from "./types.js";
+export { HostAdapterSourceError, UnsupportedHostRuntimeError, resolveHostAdapterSource } from "./adapter-source.js";
+export { buildGuardCommandString, isOmsHookEntry, removeClaudeHooks, replaceRootJsonPropertyPreservingBytes, toShellVaultPath, upsertClaudeHooks, } from "./claude-hooks.js";
 export declare function detectAvailableHosts(): HostRuntime[];
 export declare function resolveRuntimeSelection(selection: RuntimeSelection): HostRuntime[];
-/**
- * Convert an absolute vault path to a shell-safe `$HOME`-relative reference.
- * Returns `"$HOME/rel/path"` when the path is under homeDir, otherwise falls
- * back to a quoted absolute path.  The outer double-quotes let the shell expand
- * `$HOME` at hook execution time, so paths survive across reboots and username
- * changes.
- */
-export declare function toShellVaultPath(absPath: string, homeDir: string): string;
-/** Build the shell command string for a guard binary entry. */
-export declare function buildGuardCommandString(vault: string, agentVault: string | undefined, homeDir: string, guardBin: string): string;
-/** Return true when any inner `hooks[*].command` contains the given marker string. */
-export declare function isOmsHookEntry(entry: unknown, marker: string): boolean;
-/**
- * Idempotently merge OMS guard hooks into `~/.claude/settings.json`.
- * Existing non-OMS hook entries are never modified.
- * Returns a human-readable message and whether the file was changed.
- */
-export declare function upsertClaudeHooks(options: Pick<HostOperationOptions, "vault" | "agentVault" | "dryRun" | "homeDir">, claudeDir: string): Promise<{
-    changed: boolean;
-    messages: string[];
-}>;
-/**
- * Remove OMS guard hook entries from `~/.claude/settings.json`.
- * Only entries whose inner `command` contains `oms-guard` / `oms-post-guard`
- * are removed; all other entries are preserved unchanged.
- */
-export declare function removeClaudeHooks(options: Pick<HostOperationOptions, "dryRun" | "homeDir">, claudeDir: string): Promise<{
-    changed: boolean;
-    messages: string[];
-}>;
 export declare function runHostOperation(options: HostOperationOptions): Promise<HostOperationResult[]>;
-export declare function formatHostOperationResults(results: HostOperationResult[], dryRun: boolean): string;
+export declare function formatHostOperationResults(results: readonly HostOperationResult[], dryRun?: boolean): string;
+export declare function formatHostOperationResultsJson(results: readonly HostOperationResult[], dryRun?: boolean): string;