@springbrand/cli 0.1.0

package/dist/lib/connect-runtime.js

@@ -0,0 +1,360 @@
+/** 复刻自 tiny-fish CLI 编译产物：connect-runtime.d.ts + connect-runtime.impl.js */
+import { randomUUID } from 'node:crypto';
+import spawn from 'cross-spawn';
+import { CONNECT_ATTEMPT_ENV, isAttemptId, takePendingConnectAttempt, } from './auth.js';
+import { CLI_INVOCATION_ID, CLI_VERSION } from './constants.js';
+import { detectHarness, detectHumanInitiated, detectRuntimeEnv } from './harness.js';
+import { boundedVersion, errLine, sanitizeLine } from './output.js';
+import { postConnectEvent, telemetryDisabled } from './setup-telemetry.js';
+import { installSignalGuard } from './signals.js';
+export const NON_INTERACTIVE_TIMEOUT_MS = 10_000;
+// Mirrors the route's Zod enum; tests both sides pin it.
+export const CONNECT_FAILURE_REASONS = [
+    'harness_not_installed',
+    'harness_command_unsupported',
+    'harness_too_old',
+    'key_auth_unsupported',
+    'command_not_found',
+    'timeout',
+    'spawn_error',
+    'nonzero_exit',
+    'invalid_config',
+    'user_abandoned',
+    'process_terminated',
+    'unexpected_error',
+];
+/** Ctrl+C killed a setup child — abandonment, not error. */
+export class ConnectInterruptedError extends Error {
+}
+/** Carried hoisted-install failure an earlier harness already reported. */
+export class HoistedFailureReportedError extends Error {
+}
+/** A classified step failure; runGuarded forwards the reason. */
+export class ConnectStepError extends Error {
+    failureReason;
+    harnessVersion;
+    failureDetail;
+    constructor(message, failureReason, opts) {
+        super(message, { cause: opts?.cause });
+        this.failureReason = failureReason;
+        this.harnessVersion = opts?.harnessVersion;
+        this.failureDetail = opts?.failureDetail;
+    }
+}
+/** Hoisted install predates this attempt's telemetry; the gap reads ~0 ms. */
+export function withStageDuration(error, stageDurationMs) {
+    error.stageDurationMs = stageDurationMs;
+    return error;
+}
+export function stageDurationOf(error) {
+    const value = error?.stageDurationMs;
+    return typeof value === 'number' ? value : undefined;
+}
+/** A bounded sign-in wait elapsed — unfinished, not broken. */
+export class SignInTimeoutError extends ConnectStepError {
+    constructor(message, cause) {
+        super(message, 'timeout', { cause });
+    }
+}
+// A maxBuffer overflow is also killed with SIGTERM, and is a failure too.
+const NOT_INTERRUPTIONS = new Set(['ETIMEDOUT', 'ENOBUFS']);
+export function throwIfInterrupted(result) {
+    // spawn.sync kills a timed-out child with SIGTERM, so signal alone would misread a slow
+    // network as the user walking away. A timeout is a failure and must report as one.
+    const code = result.error?.code;
+    if (code && NOT_INTERRUPTIONS.has(code))
+        return;
+    if (result.signal === 'SIGINT') {
+        throw new ConnectInterruptedError('Setup interrupted');
+    }
+}
+/** Bounded removal spawn shared by install cleanup and --uninstall; Ctrl+C throws. */
+export function spawnRemoval(command, args, timeoutMs) {
+    const result = spawn.sync(command, [...args], {
+        encoding: 'utf8',
+        timeout: timeoutMs,
+    });
+    throwIfInterrupted(result);
+    return result;
+}
+// Sanitized before the cut so the count is not spent on invisible bytes.
+const STDERR_TAIL_MAX_CHARS = 400;
+/** Outcome plus a bounded stderr tail; the route sanitizes and caps the rest. */
+export function spawnFailureDetail(result) {
+    const stderr = typeof result.stderr === 'string'
+        ? sanitizeLine(result.stderr.trim()).slice(-STDERR_TAIL_MAX_CHARS)
+        : '';
+    // A signal kill leaves status null, where the signal is the diagnosis.
+    const outcome = result.signal ? `signal=${result.signal}` : `exit=${result.status}`;
+    return `${outcome}${stderr ? ` | ${stderr}` : ''}`;
+}
+/** Classifies a spawn failure; interrupts throw instead. */
+export function spawnStepError(message, result, failureDetail) {
+    throwIfInterrupted(result);
+    const code = result.error?.code;
+    const reason = !result.error
+        ? 'nonzero_exit'
+        : code === 'ENOENT'
+            ? 'command_not_found'
+            : code === 'ETIMEDOUT'
+                ? 'timeout'
+                : 'spawn_error';
+    const detail = failureDetail ?? (reason === 'nonzero_exit' ? spawnFailureDetail(result) : undefined);
+    return new ConnectStepError(message, reason, { cause: result.error, failureDetail: detail });
+}
+export function commandNotFound(error) {
+    return error?.code === 'ENOENT';
+}
+/** One command redoes every post-install step for a client. */
+export function finishSetupCommand(client) {
+    return `npx -y @springbrand/cli@latest connect ${client}`;
+}
+/** Terminal events exactly once, whichever of flow or signal handler wins. */
+export function settle(state, telemetry, stage, detail) {
+    if (state.settled)
+        return;
+    state.settled = true;
+    telemetry.track(stage, { harnessDegraded: state.harnessDegraded, ...detail });
+}
+// Raw-mode children still surface via throwIfInterrupted; cooked-mode stages
+// (npm/npx/OAuth waits) land here.
+function installConnectSignalGuard(state, telemetry) {
+    return installSignalGuard(async (signal) => {
+        if (!state.settled) {
+            settle(state, telemetry, 'aborted', {
+                failedStage: state.stage,
+                failureReason: signal === 'SIGINT' ? 'user_abandoned' : 'process_terminated',
+            });
+            errLine('Setup interrupted — run the command again to finish.');
+        }
+        // Settled spans the whole post-install phase; the `completed` POST may still be in flight.
+        await telemetry.flush();
+    });
+}
+/** Shared terminal handling: interrupted → aborted, else failed. */
+export async function runGuarded(state, telemetry, body) {
+    const uninstallSignalGuard = installConnectSignalGuard(state, telemetry);
+    try {
+        await body();
+    }
+    catch (error) {
+        if (error instanceof ConnectInterruptedError) {
+            settle(state, telemetry, 'aborted', {
+                failedStage: state.stage,
+                failureReason: 'user_abandoned',
+            });
+            errLine('Setup interrupted — run the command again to finish.');
+            process.exitCode = 130;
+            return;
+        }
+        // An elapsed sign-in wait is abandonment, not breakage.
+        if (error instanceof SignInTimeoutError) {
+            settle(state, telemetry, 'aborted', {
+                failedStage: state.stage,
+                failureReason: 'timeout',
+                failureDetail: error.failureDetail ?? error.message,
+            });
+            throw error;
+        }
+        // An earlier attempt owns the shared failure's terminal row.
+        if (error instanceof HoistedFailureReportedError)
+            throw error;
+        settle(state, telemetry, 'failed', {
+            failedStage: state.stage,
+            failureReason: error instanceof ConnectStepError ? error.failureReason : 'unexpected_error',
+            ...(error instanceof ConnectStepError
+                ? {
+                    harnessVersion: error.harnessVersion,
+                    failureDetail: error.failureDetail ?? error.message,
+                }
+                : {}),
+            stageDurationMs: stageDurationOf(error),
+        });
+        throw error;
+    }
+    finally {
+        uninstallSignalGuard();
+        await telemetry.flush();
+    }
+}
+function probeTimeoutMs(client) {
+    return client.supportCheck.timeoutMs ?? NON_INTERACTIVE_TIMEOUT_MS;
+}
+function throwProbeFailure(client, result) {
+    throwIfInterrupted(result);
+    // A hung probe is a timeout, not a missing capability.
+    if (result.error?.code === 'ETIMEDOUT') {
+        const probe = `${client.command} ${client.supportCheck.args.join(' ')}`;
+        throw new ConnectStepError(`${client.displayName} did not respond to \`${probe}\` within ` +
+            `${probeTimeoutMs(client) / 1000}s. Retry.`, 'timeout', { cause: result.error });
+    }
+    // It ran and exited non-zero, so the version is still answerable.
+    throw new ConnectStepError(client.supportCheck.unavailableMessage, 'harness_command_unsupported', { cause: result.error, harnessVersion: probeHarnessVersion(client) });
+}
+function supportProbeOutput(client) {
+    const result = spawn.sync(client.command, client.supportCheck.args, {
+        encoding: 'utf8',
+        // Agent harnesses export FORCE_COLOR, which makes clients colourise even a piped --help.
+        env: { ...process.env, FORCE_COLOR: '0', NO_COLOR: '1' },
+        timeout: probeTimeoutMs(client),
+    });
+    // 127 is the shell's not-found code; a wrapper shim with no real binary behind it exits that.
+    if (commandNotFound(result.error) || result.status === 127) {
+        throw new ConnectStepError(`${client.displayName} is not installed or not available on PATH.`, 'harness_not_installed', { cause: result.error });
+    }
+    if (result.error || result.status !== 0) {
+        throwProbeFailure(client, result);
+    }
+    // Belt and braces with the colour env: a client that ignores NO_COLOR still has to match.
+    return sanitizeLine(`${result.stdout ?? ''}\n${result.stderr ?? ''}`);
+}
+function debugProbeOutput(client, output) {
+    if (!process.env['SPRINGBRAND_DEBUG'])
+        return;
+    errLine(`${client.command} ${client.supportCheck.args.join(' ')} printed:\n${output.trim()}`);
+}
+function requireEssential(client, output) {
+    if (client.supportCheck.patterns.every((pattern) => pattern.test(output)))
+        return;
+    debugProbeOutput(client, output);
+    throw new ConnectStepError(client.supportCheck.unavailableMessage, 'harness_too_old', {
+        harnessVersion: probeHarnessVersion(client),
+    });
+}
+/** Absence is a fact; an unknown flag means an upstream rename. */
+function resolveVariant(client, output) {
+    const check = client.supportCheck;
+    // Token equality, not a built regex: exact on both edges, and no dynamic RegExp.
+    const listed = new Set(output.split(/[\s,=]+/));
+    const matched = check.variants?.find((flag) => listed.has(flag));
+    if (matched)
+        return matched;
+    const unknown = check.unknownVariant?.exec(output)?.[0];
+    if (unknown === undefined)
+        return undefined;
+    // Unacknowledged policy warnings can block the install; fail before it does.
+    debugProbeOutput(client, output);
+    throw new ConnectStepError(`${client.displayName} lists \`${unknown}\`, which this SpringBrand CLI does not recognise. ` +
+        'Upgrade the SpringBrand CLI with `sp upgrade` and retry.', 'harness_too_old', { harnessVersion: probeHarnessVersion(client) });
+}
+/** Refresh paths need the advertised alternative without connect's version probe. */
+export function probeSupportVariant(client) {
+    const output = supportProbeOutput(client);
+    requireEssential(client, output);
+    return resolveVariant(client, output);
+}
+export function requireCommandSupport(client) {
+    const output = supportProbeOutput(client);
+    requireEssential(client, output);
+    const optionalSupported = (client.supportCheck.optionalPatterns ?? []).every((pattern) => pattern.test(output));
+    const keyAuthPattern = client.supportCheck.keyAuthPattern;
+    const keyAuthSupported = keyAuthPattern ? keyAuthPattern.test(output) : true;
+    if (!optionalSupported || !keyAuthSupported)
+        debugProbeOutput(client, output);
+    return {
+        optionalSupported,
+        keyAuthSupported,
+        matchedVariant: resolveVariant(client, output),
+        harnessVersion: probeHarnessVersion(client),
+    };
+}
+/** Best-effort; the server rejects non-printable characters and >32 chars. */
+function probeHarnessVersion(client) {
+    const result = spawn.sync(client.command, ['--version'], {
+        encoding: 'utf8',
+        timeout: probeTimeoutMs(client),
+    });
+    if (result.error || result.status !== 0)
+        return undefined;
+    return boundedVersion(result.stdout ?? '');
+}
+/**
+ * One page-minted id seeds one install attempt, so `sp onboard` connecting three agents
+ * does not report three installs under it. Later connects in the run fall back to a random id.
+ */
+function takeSeedAttemptId() {
+    const fromEnv = process.env[CONNECT_ATTEMPT_ENV];
+    // Both sources are read-and-clear, and the delete lands before any subprocess inherits it.
+    delete process.env[CONNECT_ATTEMPT_ENV];
+    const parked = takePendingConnectAttempt();
+    return fromEnv && isAttemptId(fromEnv) ? fromEnv : parked;
+}
+// postConnectEvent is total, so this only fires on a bug inside deliver.
+function reportDeliverBug(error) {
+    if (!process.env['SPRINGBRAND_DEBUG'])
+        return;
+    errLine(`connect telemetry failed: ${error instanceof Error ? error.message : String(error)}`);
+}
+export function createConnectTelemetry(mcpUrl, client, opts) {
+    // Consumed even when --url already supplied an id: leaving it behind would let a stale
+    // seed reach the agent this connect launches, or the next connect on this machine.
+    const seeded = takeSeedAttemptId();
+    // A setup-page id (via --url, the env var, or one parked by login) joins "copied the
+    // command" to this install attempt.
+    const attemptId = opts?.attemptId ?? seeded ?? opts?.fallbackAttemptId ?? randomUUID();
+    const endpoint = new URL('/api/cli/connect-event', mcpUrl).toString();
+    const pending = [];
+    let lastTrackAt;
+    let harnessVersion;
+    let fallbackOutcome;
+    async function deliver(body) {
+        // postConnectEvent's own opt-out check is too late to skip the work above it.
+        if (telemetryDisabled())
+            return;
+        await postConnectEvent({ endpoint, body, attempts: 2, label: 'connect' });
+    }
+    function eventBody(stage, detail, stageDurationMs) {
+        return JSON.stringify({
+            attempt_id: attemptId,
+            client,
+            stage,
+            failed_stage: detail?.failedStage,
+            phase: detail?.phase,
+            failure_reason: detail?.failureReason,
+            // Only with failed_stage: the route refine 400s the event otherwise.
+            failure_detail: detail?.failedStage ? detail.failureDetail : undefined,
+            // Terminal rows only: rescue checkpoints stay wire-identical to normal ones.
+            fallback_outcome: stage === 'failed' || stage === 'aborted' ? fallbackOutcome : undefined,
+            harness_version: detail?.harnessVersion ?? harnessVersion,
+            plugin_version: detail?.pluginVersion,
+            auth_mode: detail?.authMode,
+            harness_degraded: detail?.harnessDegraded,
+            stage_duration_ms: stageDurationMs,
+            runtime_platform: process.platform,
+            node_version: process.version,
+            cli_version: CLI_VERSION,
+            // Same signal the usage events carry, so TTY and headless connects can be split.
+            is_human_initiated: detectHumanInitiated(),
+            // "none", not absent — absent has to keep meaning "CLI too old".
+            calling_harness: detectHarness() ?? 'none',
+            cli_invocation_id: CLI_INVOCATION_ID,
+            runtime_env: detectRuntimeEnv(),
+        });
+    }
+    return {
+        attemptId,
+        // Fire-and-forget; awaiting each event stalls setup when telemetry down.
+        setHarnessVersion(version) {
+            harnessVersion = version;
+        },
+        setFallbackOutcome(outcome) {
+            fallbackOutcome = outcome;
+        },
+        track(stage, detail) {
+            const now = Date.now();
+            // Clamped: a backward clock step would send a route-rejected negative.
+            const stageDurationMs = detail?.stageDurationMs ??
+                (lastTrackAt === undefined ? undefined : Math.max(0, now - lastTrackAt));
+            lastTrackAt = now;
+            // Absorbed here, not in flush: flush runs in runGuarded's finally, so a rejection would
+            // replace the error the flow is already reporting.
+            pending.push(deliver(eventBody(stage, detail, stageDurationMs)).catch(reportDeliverBug));
+        },
+        // Awaited in finally so in-flight events land before exit. Drains, so the signal-guard
+        // flush and the finally flush do not re-await the same events.
+        async flush() {
+            await Promise.all(pending.splice(0));
+        },
+    };
+}
+//# sourceMappingURL=connect-runtime.js.map

package/dist/lib/connect-runtime.js.map

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

package/dist/lib/constants.d.ts

@@ -0,0 +1,23 @@
+/** 复刻自 tiny-fish CLI 编译产物：constants.d.ts + constants.impl.js */
+export declare const CLI_VERSION: string;
+/** One id per CLI process; joins events across commands (PF-3779). */
+export declare const CLI_INVOCATION_ID: string;
+/** Unversioned: the install site appends `@latest`, the version read must not. */
+export declare const SPRINGBRAND_CLI_PACKAGE = "@springbrand/cli";
+export declare const CLI_AGENT_IDENTITY = "springbrand-cli";
+/** Names the bundled dir, every install target dir, and the lock entry. */
+export declare const WEB_SKILL_NAME = "use-springbrand";
+/** The CLI installs one common entry skill plus the domain guidance it references. */
+export declare const BUNDLED_SKILL_NAMES: readonly ["use-springbrand", "springbrand-platform", "springbrand-action-api", "springbrand-connector", "springbrand-gtm"];
+/** The descriptor hands this name to harnesses; the probes resolve it. */
+export declare const SPRINGBRAND_API_KEY_VAR = "SPRINGBRAND_API_KEY";
+export declare const BASE_URL: string;
+export declare const API_URL_OVERRIDE: string | undefined;
+export declare const WEB_APP_URL: string;
+/** URL where users can create and manage API keys */
+export declare function getDashboardUrl(source?: string): string;
+export declare const DASHBOARD_URL: string;
+export declare const HARNESS_PROBE_TIMEOUT_MS = 15000;
+/** Hermes' own id for the SpringBrand web plugin. */
+export declare const HERMES_PLUGIN_NAME = "springbrand";
+//# sourceMappingURL=constants.d.ts.map

package/dist/lib/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/lib/constants.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAMhE,eAAO,MAAM,WAAW,EAAE,MAAqB,CAAC;AAChD,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,EAAE,MAAqB,CAAC;AACtD,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AACpD,2EAA2E;AAC3E,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAChD,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,4HAMtB,CAAC;AACX,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAkB7D,eAAO,MAAM,QAAQ,EAAE,MAA6D,CAAC;AAGrF,eAAO,MAAM,gBAAgB,EAAE,MAAM,GAAG,SAA0B,CAAC;AAUnE,eAAO,MAAM,WAAW,EAAE,MAAiE,CAAC;AAsB5F,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAIvD;AACD,eAAO,MAAM,aAAa,EAAE,MAA0B,CAAC;AACvD,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,gBAAgB,CAAC"}

package/dist/lib/constants.js

@@ -0,0 +1,87 @@
+/** 复刻自 tiny-fish CLI 编译产物：constants.d.ts + constants.impl.js */
+import { randomUUID } from 'node:crypto';
+import { createRequire } from 'module';
+const _require = createRequire(import.meta.url);
+const _pkg = _require('../../package.json');
+export const CLI_VERSION = _pkg.version;
+/** One id per CLI process; joins events across commands (PF-3779). */
+export const CLI_INVOCATION_ID = randomUUID();
+/** Unversioned: the install site appends `@latest`, the version read must not. */
+export const SPRINGBRAND_CLI_PACKAGE = '@springbrand/cli';
+// How we identify ourselves to other tools; `skills` echoes it back.
+export const CLI_AGENT_IDENTITY = 'springbrand-cli';
+/** Names the bundled dir, every install target dir, and the lock entry. */
+export const WEB_SKILL_NAME = 'use-springbrand';
+/** The CLI installs one common entry skill plus the domain guidance it references. */
+export const BUNDLED_SKILL_NAMES = [
+    WEB_SKILL_NAME,
+    'springbrand-platform',
+    'springbrand-action-api',
+    'springbrand-connector',
+    'springbrand-gtm',
+];
+/** The descriptor hands this name to harnesses; the probes resolve it. */
+export const SPRINGBRAND_API_KEY_VAR = 'SPRINGBRAND_API_KEY';
+/** Base URL for the SpringBrand API. Override with SPRINGBRAND_API_URL for staging/self-hosted. */
+const apiUrlOverride = process.env['SPRINGBRAND_API_URL']?.trim() || undefined;
+if (apiUrlOverride) {
+    let parsed;
+    try {
+        parsed = new URL(apiUrlOverride);
+    }
+    catch {
+        process.stderr.write('Error: SPRINGBRAND_API_URL must be a valid https URL\n');
+        process.exit(1);
+    }
+    const loopbackHttp = parsed.protocol === 'http:' && ['localhost', '127.0.0.1', '[::1]'].includes(parsed.hostname);
+    if (parsed.protocol !== 'https:' && !loopbackHttp) {
+        process.stderr.write(`Error: SPRINGBRAND_API_URL must use https:// (got protocol "${parsed.protocol || 'unknown'}")\n`);
+        process.exit(1);
+    }
+}
+export const BASE_URL = apiUrlOverride ?? 'https://connector.springbrand.ai';
+// Left undefined, the SDK sends Search and Fetch to their own hosts, which are the ones
+// behind the API gateway.
+export const API_URL_OVERRIDE = apiUrlOverride;
+/**
+ * Where a user creates and copies an MCP API key. Placeholder: the page belongs to the
+ * sp-platform web app and its path is not final yet, so `sp auth login` opens the settings area
+ * rather than a key page that may not exist.
+ *
+ * Deliberately independent of `SPRINGBRAND_API_URL`: pointing the MCP endpoint at a local
+ * worker must not move the browser page a human is told to visit.
+ */
+const webUrlOverride = process.env['SPRINGBRAND_WEB_URL']?.trim() || undefined;
+export const WEB_APP_URL = parsedOrigin(webUrlOverride) ?? 'https://springbrand.ai';
+const DASHBOARD_PATH = '/account-settings';
+function parsedOrigin(value) {
+    if (!value)
+        return undefined;
+    try {
+        return new URL(value).origin;
+    }
+    catch {
+        process.stderr.write('Warning: SPRINGBRAND_WEB_URL is not a valid URL; using the default.\n');
+        return undefined;
+    }
+}
+const DEFAULT_DASHBOARD_SOURCE = 'cli';
+const DASHBOARD_SOURCE_PATTERN = /^[a-z0-9][a-z0-9_-]{0,63}$/;
+function normalizeDashboardSource(source) {
+    const normalized = source?.trim().toLowerCase();
+    if (!normalized || !DASHBOARD_SOURCE_PATTERN.test(normalized)) {
+        return DEFAULT_DASHBOARD_SOURCE;
+    }
+    return normalized;
+}
+/** URL where users can create and manage API keys */
+export function getDashboardUrl(source) {
+    const url = new URL(`${WEB_APP_URL}${DASHBOARD_PATH}`);
+    url.searchParams.set('source', normalizeDashboardSource(source));
+    return url.toString();
+}
+export const DASHBOARD_URL = getDashboardUrl();
+export const HARNESS_PROBE_TIMEOUT_MS = 15_000;
+/** Hermes' own id for the SpringBrand web plugin. */
+export const HERMES_PLUGIN_NAME = 'springbrand';
+//# sourceMappingURL=constants.js.map

package/dist/lib/constants.js.map

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

package/dist/lib/cursor-config.d.ts

@@ -0,0 +1,16 @@
+/** 复刻自 tiny-fish CLI 编译产物：cursor-config.d.ts + cursor-config.impl.js */
+import type { McpJsonServerEntry, McpJsonWriteResult } from './mcp-json-config.js';
+export declare function cursorMcpPath(): string;
+/** Dry-run description of the pending write; touches nothing. */
+export declare function planCursorWrite(mcpUrl: string, apiKey?: string): string;
+/** Reports the header's shape, never its value. */
+export declare function readCursorSpringbrandEntry(): CursorSpringbrandEntry;
+/** Merges only the `springbrand` key; skips unreadable/corrupt files rather than clobber. */
+export declare function writeCursorMcpConfig(mcpUrl: string, apiKey?: string): CursorMcpWriteResult;
+/** Removes only the `springbrand` key. */
+export declare function removeCursorMcpServer(): CursorMcpWriteResult;
+/** Cursor deeplink format: cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64 */
+export declare function cursorInstallDeeplink(mcpUrl: string): string;
+export type CursorMcpWriteResult = McpJsonWriteResult;
+export type CursorSpringbrandEntry = McpJsonServerEntry;
+//# sourceMappingURL=cursor-config.d.ts.map

package/dist/lib/cursor-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-config.d.ts","sourceRoot":"","sources":["../../src/lib/cursor-config.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AASnF,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AACD,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvE;AACD,mDAAmD;AACnD,wBAAgB,0BAA0B,IAAI,sBAAsB,CAEnE;AACD,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAE1F;AACD,0CAA0C;AAC1C,wBAAgB,qBAAqB,IAAI,oBAAoB,CAE5D;AACD,uGAAuG;AACvG,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5D;AAGD,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEtD,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CAAC"}

package/dist/lib/cursor-config.js

@@ -0,0 +1,34 @@
+/** 复刻自 tiny-fish CLI 编译产物：cursor-config.d.ts + cursor-config.impl.js */
+import * as os from 'os';
+import * as path from 'path';
+import { buildSpringbrandServerEntry, planWrite, readSpringbrandEntry, removeServer, writeMcpConfig, } from './mcp-json-config.js';
+const CURSOR_TARGET = {
+    serverKey: 'springbrand',
+    dir: () => path.join(os.homedir(), '.cursor'),
+    file: () => path.join(os.homedir(), '.cursor', 'mcp.json'),
+};
+export function cursorMcpPath() {
+    return CURSOR_TARGET.file();
+}
+/** Dry-run description of the pending write; touches nothing. */
+export function planCursorWrite(mcpUrl, apiKey) {
+    return planWrite(CURSOR_TARGET, mcpUrl, apiKey);
+}
+/** Reports the header's shape, never its value. */
+export function readCursorSpringbrandEntry() {
+    return readSpringbrandEntry(CURSOR_TARGET);
+}
+/** Merges only the `springbrand` key; skips unreadable/corrupt files rather than clobber. */
+export function writeCursorMcpConfig(mcpUrl, apiKey) {
+    return writeMcpConfig(CURSOR_TARGET, mcpUrl, apiKey);
+}
+/** Removes only the `springbrand` key. */
+export function removeCursorMcpServer() {
+    return removeServer(CURSOR_TARGET);
+}
+/** Cursor deeplink format: cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64 */
+export function cursorInstallDeeplink(mcpUrl) {
+    const config = Buffer.from(JSON.stringify(buildSpringbrandServerEntry(mcpUrl))).toString('base64');
+    return `cursor://anysphere.cursor-deeplink/mcp/install?name=${CURSOR_TARGET.serverKey}&config=${encodeURIComponent(config)}`;
+}
+//# sourceMappingURL=cursor-config.js.map

package/dist/lib/cursor-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-config.js","sourceRoot":"","sources":["../../src/lib/cursor-config.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAGxE,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,oBAAoB,EAAE,YAAY,EAAE,cAAc,GAAG,MAAM,sBAAsB,CAAC;AACnI,MAAM,aAAa,GAAG;IAClB,SAAS,EAAE,aAAa;IACxB,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC;IAC7C,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC;CAC7D,CAAC;AACF,MAAM,UAAU,aAAa;IACzB,OAAO,aAAa,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC;AACD,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,MAAe;IAC3D,OAAO,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AACD,mDAAmD;AACnD,MAAM,UAAU,0BAA0B;IACtC,OAAO,oBAAoB,CAAC,aAAa,CAAC,CAAC;AAC/C,CAAC;AACD,6FAA6F;AAC7F,MAAM,UAAU,oBAAoB,CAAC,MAAc,EAAE,MAAe;IAChE,OAAO,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AACD,0CAA0C;AAC1C,MAAM,UAAU,qBAAqB;IACjC,OAAO,YAAY,CAAC,aAAa,CAAC,CAAC;AACvC,CAAC;AACD,uGAAuG;AACvG,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAChD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnG,OAAO,uDAAuD,aAAa,CAAC,SAAS,WAAW,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;AACjI,CAAC"}

package/dist/lib/doctor-checks.d.ts

@@ -0,0 +1,21 @@
+/** 复刻自 tiny-fish CLI 编译产物：doctor-checks.d.ts + doctor-checks.impl.js */
+import type { DoctorCheck } from './doctor-report.js';
+import type { RegistrationStatus } from './registration-detect.js';
+import type { VerifyResult } from './verify.js';
+export declare function provesHarnessReach(status: RegistrationStatus, keyAuth: VerifyResult | undefined, healthOk: boolean, mcpUrl: string): boolean;
+export declare function checkCliVersion(): DoctorCheck;
+export declare function checkConnectivity(mcpUrl: string): Promise<DoctorCheck>;
+export declare function checkRegistration(status: RegistrationStatus, mcpUrl: string, keyAuth: VerifyResult | undefined, cliKeyMissing: boolean): DoctorCheck;
+export declare function checkCredential(): {
+    check: DoctorCheck;
+    key?: string;
+};
+export declare function checkAuthCall(auth: VerifyResult | undefined): DoctorCheck;
+export declare function verifyHarnessKey(status: RegistrationStatus, cliAuth: Promise<VerifyResult> | undefined, mcpUrl: string): Promise<VerifyResult> | undefined;
+export declare function checkPiAdapter(status: RegistrationStatus): DoctorCheck;
+export declare function checkHermesPlugin(status: RegistrationStatus): HermesPluginResult;
+export interface HermesPluginResult {
+    check: DoctorCheck;
+    observedVersion?: string;
+}
+//# sourceMappingURL=doctor-checks.d.ts.map

package/dist/lib/doctor-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-checks.d.ts","sourceRoot":"","sources":["../../src/lib/doctor-checks.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAchD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,YAAY,GAAG,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAe5I;AAED,wBAAgB,eAAe,IAAI,WAAW,CAS7C;AACD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAW5E;AA+FD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,SAAS,EAAE,aAAa,EAAE,OAAO,GAAG,WAAW,CAQpJ;AACD,wBAAgB,eAAe,IAAI;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB,CAWA;AACD,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,WAAW,CAuBzE;AACD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,CAQ1J;AA2DD,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,WAAW,CAgCtE;AACD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAqBhF;AAGD,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B"}