harborloop 0.3.0 → 0.4.1

package/dist/providers/codex.js

@@ -1,520 +0,0 @@
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { ensureConfigDir, readIfExists, updateFileLocked } from '../lock.js';
-import { isUnrunnableCommandEntry } from './hook-entry.js';
-import { HOOK_CAPTURE_BASENAME, HOOK_CONTEXT_BASENAME, HOOK_REPORT_BASENAME, HOOK_COMPACT_BASENAME, HOOK_TOOLCONTEXT_BASENAME, LEGACY_MCP_KEYS, MCP_KEY, } from './claude.js';
-const MANAGED_MARKER = '# --- harbor shared context (managed by the harbor CLI) ---';
-const LEGACY_MANAGED_MARKERS = [
-    '# --- Milestone shared context (managed by Milestone Desktop) ---',
-    '# --- Milestone shared context (managed by the harbor CLI) ---',
-];
-const isManagedMarker = (line) => {
-    const trimmed = line.trim();
-    return trimmed === MANAGED_MARKER || LEGACY_MANAGED_MARKERS.includes(trimmed);
-};
-const HOOK_BASENAMES = [
-    HOOK_CONTEXT_BASENAME,
-    HOOK_REPORT_BASENAME,
-    HOOK_CAPTURE_BASENAME,
-    HOOK_TOOLCONTEXT_BASENAME,
-    HOOK_COMPACT_BASENAME,
-];
-const HOOK_CONTEXT_TIMEOUT_S = 8;
-const HOOK_REPORT_TIMEOUT_S = 5;
-const HOOK_CAPTURE_TIMEOUT_S = 10;
-const HOOK_TOOLCONTEXT_TIMEOUT_S = 5;
-const HOOK_COMPACT_TIMEOUT_S = 2;
-const EVENT_USER_PROMPT_SUBMIT = 'UserPromptSubmit';
-const EVENT_STOP = 'Stop';
-const EVENT_POST_TOOL_USE = 'PostToolUse';
-const EVENT_PRE_TOOL_USE = 'PreToolUse';
-const EVENT_POST_COMPACT = 'PostCompact';
-export const MANAGED_HOOK_EVENTS = [
-    EVENT_USER_PROMPT_SUBMIT,
-    EVENT_STOP,
-    EVENT_POST_TOOL_USE,
-    EVENT_PRE_TOOL_USE,
-    EVENT_POST_COMPACT,
-];
-const CODEX_HOOK_EVENTS = MANAGED_HOOK_EVENTS;
-export function resolveCodexPaths(home = homedir()) {
-    const fromEnv = process.env.CODEX_HOME;
-    const codexDir = fromEnv !== undefined && fromEnv.trim() !== ''
-        ? fromEnv
-        : join(home, '.codex');
-    return {
-        codexDir,
-        configTomlPath: join(codexDir, 'config.toml'),
-        hooksJsonPath: join(codexDir, 'hooks.json'),
-    };
-}
-function parseTomlHeaderPath(raw) {
-    const segments = [];
-    let current = '';
-    let quote = null;
-    for (let i = 0; i < raw.length; i += 1) {
-        const ch = raw[i] ?? '';
-        if (quote !== null) {
-            if (ch === '\\' && quote === '"' && i + 1 < raw.length) {
-                current += raw[i + 1] ?? '';
-                i += 1;
-                continue;
-            }
-            if (ch === quote) {
-                quote = null;
-                continue;
-            }
-            current += ch;
-            continue;
-        }
-        if (ch === '"' || ch === "'") {
-            quote = ch;
-            continue;
-        }
-        if (ch === '.') {
-            segments.push(current.trim());
-            current = '';
-            continue;
-        }
-        current += ch;
-    }
-    segments.push(current.trim());
-    return segments.filter((s) => s.length > 0);
-}
-function scanMultilineState(line, state) {
-    let open = state;
-    let i = 0;
-    while (i < line.length) {
-        if (open !== null) {
-            if (line.startsWith(open, i)) {
-                open = null;
-                i += 3;
-                continue;
-            }
-            i += 1;
-            continue;
-        }
-        if (line.startsWith('\"\"\"', i)) {
-            open = '\"\"\"';
-            i += 3;
-            continue;
-        }
-        if (line.startsWith("'''", i)) {
-            open = "'''";
-            i += 3;
-            continue;
-        }
-        const ch = line[i];
-        if (ch === '#')
-            break;
-        if (ch === '\"' || ch === "'") {
-            const quote = ch;
-            i += 1;
-            while (i < line.length) {
-                if (quote === '\"' && line[i] === '\\') {
-                    i += 2;
-                    continue;
-                }
-                if (line[i] === quote) {
-                    i += 1;
-                    break;
-                }
-                i += 1;
-            }
-            continue;
-        }
-        i += 1;
-    }
-    return open;
-}
-function parseTomlTables(content) {
-    const lines = content.split('\n');
-    const headers = [];
-    let multiline = null;
-    for (let i = 0; i < lines.length; i += 1) {
-        const raw = lines[i] ?? '';
-        const startedInsideString = multiline !== null;
-        multiline = scanMultilineState(raw, multiline);
-        if (startedInsideString)
-            continue;
-        const trimmed = raw.trim();
-        const match = /^\[\[?([^\]]*)\]\]?\s*(#.*)?$/.exec(trimmed);
-        if (!match)
-            continue;
-        headers.push({ path: parseTomlHeaderPath(match[1] ?? ''), line: i });
-    }
-    return headers.map((h, idx) => ({
-        path: h.path,
-        startLine: h.line,
-        endLine: idx + 1 < headers.length ? (headers[idx + 1]?.line ?? lines.length) : lines.length,
-    }));
-}
-function removeTomlTables(content, match) {
-    if (content.trim().length === 0)
-        return content;
-    const lines = content.split('\n');
-    const doomed = new Set();
-    for (const table of parseTomlTables(content)) {
-        if (!match(table.path))
-            continue;
-        for (let i = table.startLine; i < table.endLine; i += 1)
-            doomed.add(i);
-        let above = table.startLine - 1;
-        while (above >= 0 && isManagedMarker(lines[above] ?? '')) {
-            doomed.add(above);
-            above -= 1;
-        }
-        while (above >= 0 && (lines[above] ?? 'x').trim() === '' && doomed.has(above + 1)) {
-            doomed.add(above);
-            above -= 1;
-        }
-    }
-    if (doomed.size === 0)
-        return content;
-    const kept = lines.filter((_, i) => !doomed.has(i));
-    const collapsed = [];
-    for (const line of kept) {
-        const prev = collapsed.length > 0 ? (collapsed[collapsed.length - 1] ?? '') : null;
-        if (line.trim() === '' && prev !== null && prev.trim() === '')
-            continue;
-        collapsed.push(line);
-    }
-    return `${collapsed.join('\n').replace(/\n+$/, '')}\n`;
-}
-function appendTomlBlock(content, block) {
-    const base = content.trim().length === 0 ? '' : `${content.replace(/\n+$/, '')}\n`;
-    return `${base}\n${MANAGED_MARKER}\n${block.replace(/\n+$/, '')}\n`;
-}
-export function tomlString(value) {
-    return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
-}
-function unquoteTomlString(raw) {
-    const match = /^"((?:[^"\\]|\\.)*)"/.exec(raw.trim());
-    if (!match)
-        return null;
-    return (match[1] ?? '').replace(/\\"/g, '"').replace(/\\\\/g, '\\');
-}
-const MCP_ROOT_PATH = ['mcp_servers', MCP_KEY];
-const MCP_HEADERS_PATH = ['mcp_servers', MCP_KEY, 'http_headers'];
-const samePath = (a, b) => a.length === b.length && a.every((seg, i) => seg === b[i]);
-const isOurAuthoredMcpTable = (path) => samePath(path, MCP_ROOT_PATH) || samePath(path, MCP_HEADERS_PATH);
-const isMcpSubtreeOf = (path, key) => path.length >= 2 && path[0] === 'mcp_servers' && path[1] === key;
-const isLegacyMcpSubtree = (path) => LEGACY_MCP_KEYS.some((key) => isMcpSubtreeOf(path, key));
-const isOurMcpSubtree = (path) => isMcpSubtreeOf(path, MCP_KEY) || isLegacyMcpSubtree(path);
-const tomlHeader = (path) => `[${path.map((s) => (/^[A-Za-z0-9_-]+$/.test(s) ? s : tomlString(s))).join('.')}]`;
-function setTomlKey(content, tablePath, key, value) {
-    const target = parseTomlTables(content).find((t) => samePath(t.path, tablePath));
-    const line = `${key} = ${value}`;
-    if (target === undefined) {
-        return appendTomlBlock(content, `${tomlHeader(tablePath)}\n${line}`);
-    }
-    const lines = content.split('\n');
-    const keyPattern = new RegExp(`^\\s*${key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*=`);
-    for (let i = target.startLine + 1; i < target.endLine; i += 1) {
-        if (keyPattern.test(lines[i] ?? '')) {
-            lines[i] = line;
-            return lines.join('\n');
-        }
-    }
-    lines.splice(target.startLine + 1, 0, line);
-    return lines.join('\n');
-}
-export function mergeMcpServer(existing, mcpUrl, token) {
-    existing = removeTomlTables(existing, isLegacyMcpSubtree);
-    const authHeader = token.startsWith('Bearer ') ? token : `Bearer ${token}`;
-    const tables = parseTomlTables(existing);
-    const hasAny = tables.some((t) => isOurAuthoredMcpTable(t.path));
-    if (!hasAny) {
-        const block = [
-            tomlHeader(MCP_ROOT_PATH),
-            `url = ${tomlString(mcpUrl)}`,
-            '',
-            tomlHeader(MCP_HEADERS_PATH),
-            `Authorization = ${tomlString(authHeader)}`,
-        ].join('\n');
-        return appendTomlBlock(existing, block);
-    }
-    let out = setTomlKey(existing, MCP_ROOT_PATH, 'url', tomlString(mcpUrl));
-    out = setTomlKey(out, MCP_HEADERS_PATH, 'Authorization', tomlString(authHeader));
-    return out;
-}
-export function removeMcpServer(existing) {
-    return removeTomlTables(existing, isOurMcpSubtree);
-}
-export function hasMcpServer(existing) {
-    return parseTomlTables(existing).some((t) => samePath(t.path, MCP_ROOT_PATH));
-}
-function readTableKey(existing, tableHeaders, key) {
-    if (existing.trim() === '')
-        return null;
-    let inTable = false;
-    let multiline = null;
-    for (const line of existing.split('\n')) {
-        const startedInsideString = multiline !== null;
-        multiline = scanMultilineState(line, multiline);
-        if (startedInsideString)
-            continue;
-        const trimmed = line.trim();
-        if (trimmed.startsWith('[')) {
-            inTable = tableHeaders.includes(trimmed);
-            continue;
-        }
-        if (!inTable || trimmed === '' || trimmed.startsWith('#'))
-            continue;
-        const eq = trimmed.indexOf('=');
-        if (eq === -1)
-            continue;
-        if (trimmed.slice(0, eq).trim() !== key)
-            continue;
-        return unquoteTomlString(trimmed.slice(eq + 1));
-    }
-    return null;
-}
-export function readInstalledToken(existing) {
-    const auth = readTableKey(existing, [
-        `[mcp_servers.${MCP_KEY}.http_headers]`,
-        `[mcp_servers."${MCP_KEY}".http_headers]`,
-    ], 'Authorization');
-    if (auth === null || auth.trim() === '')
-        return null;
-    return auth.startsWith('Bearer ') ? auth.slice('Bearer '.length) : auth;
-}
-export function readInstalledMcpUrl(existing) {
-    return readTableKey(existing, [`[mcp_servers.${MCP_KEY}]`, `[mcp_servers."${MCP_KEY}"]`], 'url');
-}
-const isTrustTable = (hooksJsonPath) => (path) => path.length === 3 &&
-    path[0] === 'hooks' &&
-    path[1] === 'state' &&
-    (path[2] ?? '').startsWith(`${hooksJsonPath}:`);
-export function mergeHookTrust(existing, hooksJsonPath, identities) {
-    const stripped = removeTomlTables(existing, isTrustTable(hooksJsonPath));
-    if (identities.length === 0)
-        return stripped;
-    const block = identities
-        .map((id) => `[hooks.state.${tomlString(id.key)}]\ntrusted_hash = ${tomlString(id.currentHash)}`)
-        .join('\n\n');
-    return appendTomlBlock(stripped, block);
-}
-export function removeHookTrust(existing, hooksJsonPath) {
-    return removeTomlTables(existing, isTrustTable(hooksJsonPath));
-}
-export function countHookTrustStamps(existing, hooksJsonPath) {
-    const lines = existing.split('\n');
-    return parseTomlTables(existing)
-        .filter((t) => isTrustTable(hooksJsonPath)(t.path))
-        .filter((t) => lines
-        .slice(t.startLine + 1, t.endLine)
-        .some((line) => /^\s*trusted_hash\s*=/.test(line))).length;
-}
-export function isOurHookCommand(command) {
-    if (typeof command !== 'string')
-        return false;
-    return HOOK_BASENAMES.some((base) => command.endsWith(base));
-}
-function stripOurHooks(event) {
-    if (!Array.isArray(event))
-        return [];
-    const kept = [];
-    for (const group of event) {
-        if (group === null || typeof group !== 'object' || Array.isArray(group)) {
-            kept.push(group);
-            continue;
-        }
-        const inner = group.hooks;
-        if (!Array.isArray(inner)) {
-            kept.push(group);
-            continue;
-        }
-        const keptInner = inner.filter((h) => {
-            if (h === null || typeof h !== 'object' || Array.isArray(h))
-                return true;
-            if (isUnrunnableCommandEntry(h))
-                return false;
-            return !isOurHookCommand(h.command);
-        });
-        if (keptInner.length === 0)
-            continue;
-        kept.push({ ...group, hooks: keptInner });
-    }
-    return kept;
-}
-function commandHookGroup(command, timeoutSeconds, statusMessage) {
-    const hook = {
-        type: 'command',
-        command,
-        timeout: timeoutSeconds,
-    };
-    if (statusMessage !== undefined)
-        hook.statusMessage = statusMessage;
-    return { hooks: [hook] };
-}
-export function mergeHooks(existing, paths) {
-    let root;
-    if (existing.trim().length === 0) {
-        root = {};
-    }
-    else {
-        try {
-            root = JSON.parse(existing);
-        }
-        catch (err) {
-            throw new Error(`Failed to parse hooks.json: ${err.message}`);
-        }
-    }
-    if (root === null || typeof root !== 'object' || Array.isArray(root)) {
-        throw new Error('hooks.json root is not an object');
-    }
-    const rootObj = root;
-    rootObj.description = 'harbor shared-context hooks (team knowledge for bare Codex)';
-    let hooks = rootObj.hooks;
-    if (hooks === undefined) {
-        hooks = {};
-        rootObj.hooks = hooks;
-    }
-    if (hooks === null || typeof hooks !== 'object' || Array.isArray(hooks)) {
-        throw new Error('hooks.json `hooks` is not an object');
-    }
-    const hooksObj = hooks;
-    hooksObj[EVENT_USER_PROMPT_SUBMIT] = [
-        ...stripOurHooks(hooksObj[EVENT_USER_PROMPT_SUBMIT]),
-        commandHookGroup(paths.contextHookPath, HOOK_CONTEXT_TIMEOUT_S, 'Loading harbor team context'),
-    ];
-    hooksObj[EVENT_STOP] = [
-        ...stripOurHooks(hooksObj[EVENT_STOP]),
-        commandHookGroup(paths.reportHookPath, HOOK_REPORT_TIMEOUT_S),
-        commandHookGroup(paths.captureHookPath, HOOK_CAPTURE_TIMEOUT_S),
-    ];
-    hooksObj[EVENT_POST_TOOL_USE] = [
-        ...stripOurHooks(hooksObj[EVENT_POST_TOOL_USE]),
-        commandHookGroup(paths.toolContextHookPath, HOOK_TOOLCONTEXT_TIMEOUT_S),
-    ];
-    hooksObj[EVENT_PRE_TOOL_USE] = [
-        ...stripOurHooks(hooksObj[EVENT_PRE_TOOL_USE]),
-        commandHookGroup(paths.toolContextHookPath, HOOK_TOOLCONTEXT_TIMEOUT_S),
-    ];
-    hooksObj[EVENT_POST_COMPACT] = [
-        ...stripOurHooks(hooksObj[EVENT_POST_COMPACT]),
-        commandHookGroup(paths.compactHookPath, HOOK_COMPACT_TIMEOUT_S),
-    ];
-    return `${JSON.stringify(rootObj, null, 2)}\n`;
-}
-export function removeHooks(existing) {
-    if (existing.trim() === '')
-        return existing;
-    let root;
-    try {
-        root = JSON.parse(existing);
-    }
-    catch (err) {
-        throw new Error(`Failed to parse hooks.json: ${err.message}`);
-    }
-    if (root === null || typeof root !== 'object' || Array.isArray(root)) {
-        throw new Error('hooks.json root is not an object');
-    }
-    const rootObj = root;
-    const hooks = rootObj.hooks;
-    if (hooks !== null && typeof hooks === 'object' && !Array.isArray(hooks)) {
-        const hooksObj = hooks;
-        for (const event of CODEX_HOOK_EVENTS) {
-            if (!(event in hooksObj))
-                continue;
-            const stripped = stripOurHooks(hooksObj[event]);
-            if (stripped.length === 0)
-                delete hooksObj[event];
-            else
-                hooksObj[event] = stripped;
-        }
-        if (Object.keys(hooksObj).length === 0) {
-            delete rootObj.hooks;
-            delete rootObj.description;
-        }
-    }
-    return `${JSON.stringify(rootObj, null, 2)}\n`;
-}
-export function readInstalledHooks(existing) {
-    const commands = [];
-    const events = [];
-    const empty = { installed: false, commands, events };
-    if (existing.trim() === '')
-        return empty;
-    let root;
-    try {
-        root = JSON.parse(existing);
-    }
-    catch {
-        return empty;
-    }
-    const hooks = root?.hooks;
-    if (hooks === null || typeof hooks !== 'object' || Array.isArray(hooks)) {
-        return empty;
-    }
-    for (const event of CODEX_HOOK_EVENTS) {
-        const groups = hooks[event];
-        if (!Array.isArray(groups))
-            continue;
-        const before = commands.length;
-        for (const group of groups) {
-            if (group === null || typeof group !== 'object')
-                continue;
-            const inner = group.hooks;
-            if (!Array.isArray(inner))
-                continue;
-            for (const h of inner) {
-                if (h === null || typeof h !== 'object')
-                    continue;
-                const command = h.command;
-                if (isOurHookCommand(command))
-                    commands.push(String(command));
-            }
-        }
-        if (commands.length > before)
-            events.push(event);
-    }
-    return { installed: commands.length > 0, commands, events };
-}
-export function hasHooks(existing) {
-    return readInstalledHooks(existing).installed;
-}
-const ensureCodexDir = ensureConfigDir;
-export async function readCodexConfig(home) {
-    return readIfExists(resolveCodexPaths(home).configTomlPath);
-}
-export async function readCodexHooksJson(home) {
-    return readIfExists(resolveCodexPaths(home).hooksJsonPath);
-}
-export async function installMcpServer(opts) {
-    const paths = resolveCodexPaths(opts.home);
-    await ensureCodexDir(paths.codexDir);
-    await updateFileLocked(paths.configTomlPath, (existing) => mergeMcpServer(existing, opts.mcpUrl, opts.token));
-    return paths.configTomlPath;
-}
-export async function uninstallMcpServer(home) {
-    const paths = resolveCodexPaths(home);
-    await updateFileLocked(paths.configTomlPath, (existing) => removeMcpServer(existing));
-    return paths.configTomlPath;
-}
-export async function installHooks(paths, home) {
-    const codex = resolveCodexPaths(home);
-    await ensureCodexDir(codex.codexDir);
-    await updateFileLocked(codex.hooksJsonPath, (existing) => mergeHooks(existing, paths));
-    return codex.hooksJsonPath;
-}
-export async function uninstallHooks(home) {
-    const paths = resolveCodexPaths(home);
-    await updateFileLocked(paths.hooksJsonPath, (existing) => removeHooks(existing));
-    const { realpath } = await import('node:fs/promises');
-    const realHooksPath = await realpath(paths.hooksJsonPath).catch(() => paths.hooksJsonPath);
-    await updateFileLocked(paths.configTomlPath, (existing) => {
-        let cleaned = removeHookTrust(existing, paths.hooksJsonPath);
-        if (realHooksPath !== paths.hooksJsonPath) {
-            cleaned = removeHookTrust(cleaned, realHooksPath);
-        }
-        return cleaned;
-    });
-    return paths.hooksJsonPath;
-}
-export async function stampHookTrust(opts) {
-    const paths = resolveCodexPaths(opts.home);
-    const keyPrefix = opts.hooksJsonPath ?? paths.hooksJsonPath;
-    await updateFileLocked(paths.configTomlPath, (existing) => mergeHookTrust(existing, keyPrefix, opts.identities));
-}

package/dist/providers/cursor.d.ts

@@ -1,45 +0,0 @@
-import { type HookPaths } from './claude.js';
-export declare const MANAGED_HOOK_EVENTS: readonly string[];
-export interface CursorPaths {
-    readonly cursorDir: string;
-    readonly mcpJsonPath: string;
-    readonly hooksJsonPath: string;
-}
-export declare function resolveCursorPaths(home?: string): CursorPaths;
-export declare function stripJsonComments(raw: string): {
-    readonly text: string;
-    readonly hadComments: boolean;
-};
-export interface CursorMcpServerEntry {
-    readonly url: string;
-    readonly headers: {
-        readonly Authorization: string;
-    };
-}
-export declare function buildMcpServerEntry(mcpUrl: string, token: string): CursorMcpServerEntry;
-export declare function mergeMcpServer(existing: string, mcpUrl: string, token: string): string;
-export declare function removeMcpServer(existing: string): string;
-export declare function hasMcpServer(existing: string): boolean;
-export declare function readInstalledToken(existing: string): string | null;
-export declare function readInstalledMcpUrl(existing: string): string | null;
-export declare function shellQuote(command: string): string;
-export declare function isOurHookCommand(command: unknown): boolean;
-export declare function mergeHooks(existing: string, paths: HookPaths): string;
-export declare function removeHooks(existing: string): string;
-export interface InstalledHooks {
-    readonly installed: boolean;
-    readonly commands: readonly string[];
-    readonly events: readonly string[];
-}
-export declare function readInstalledHooks(existing: string): InstalledHooks;
-export declare function hasHooks(existing: string): boolean;
-export declare function readCursorMcpJson(home?: string): Promise<string>;
-export declare function readCursorHooksJson(home?: string): Promise<string>;
-export declare function installMcpServer(opts: {
-    readonly mcpUrl: string;
-    readonly token: string;
-    readonly home?: string;
-}): Promise<string>;
-export declare function uninstallMcpServer(home?: string): Promise<string>;
-export declare function installHooks(paths: HookPaths, home?: string): Promise<string>;
-export declare function uninstallHooks(home?: string): Promise<string>;