@bjorntech/key-ferry 0.1.8 → 0.1.9

package/dist/scopes/controller-helpers.js

@@ -0,0 +1,268 @@
+import { applyProtection } from "../plugin.js";
+export function filterGroupMappings(group, bindings) {
+    return Object.fromEntries(Object.entries(group.servers).filter(([name]) => bindings[name] === group.id));
+}
+/**
+ * Returns the semantic project inputs used by the configuration watcher.
+ *
+ * `sourceRoot` and the manager directory are resolved by scoped-config before
+ * this point. Including both prevents a project-root switch from reusing the
+ * Varlock process while keeping relative aliases and key ordering stable.
+ */
+export function configurationFingerprint(value) {
+    return JSON.stringify(stableValue({
+        project: value.project === undefined
+            ? undefined
+            : {
+                servers: value.project.servers,
+                sourceRoot: value.project.sourceRoot,
+                managerProjectDirectory: value.project.manager.projectDirectory,
+            },
+        activation: value.activation,
+        bindings: value.bindings,
+        diagnostics: value.diagnostics,
+    }));
+}
+function stableValue(value) {
+    if (Array.isArray(value))
+        return value.map(stableValue);
+    if (value === null || typeof value !== "object")
+        return value;
+    return Object.fromEntries(Object.entries(value)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, item]) => [key, stableValue(item)]));
+}
+function optionalStatusFields(status) {
+    return {
+        ...(status.pid === undefined ? {} : { pid: status.pid }),
+        ...(status.lastRefreshAt === undefined ? {} : { lastRefreshAt: status.lastRefreshAt }),
+        ...(status.error === undefined ? {} : { error: status.error }),
+    };
+}
+export function groupStatus(runtime, activation) {
+    const status = runtime.status ?? {
+        phase: "starting",
+        projectDirectory: runtime.group.sourceRoot,
+        generation: 0,
+    };
+    const diagnostics = [
+        ...(status.diagnostics ?? []),
+        ...runtime.remote.diagnostics,
+    ];
+    return {
+        scope: runtime.id,
+        projectDirectory: status.projectDirectory,
+        phase: status.phase,
+        generation: status.generation,
+        ...optionalStatusFields(status),
+        ...(diagnostics.length === 0 ? {} : { diagnostics }),
+        ...(activation === undefined ? {} : { activation }),
+    };
+}
+export function emptyProtectionState() {
+    return { ready: false, environment: {} };
+}
+export function captureEditor(editor) {
+    const disabled = new Set();
+    const remote = new Map();
+    const environments = new Map();
+    for (const [name, value] of editor.list()) {
+        if (value.disabled === true)
+            disabled.add(name);
+        if (value.type === "local")
+            environments.set(name, { ...(value.environment ?? {}) });
+        if (value.type === "remote")
+            remote.set(name, remoteSnapshot(value));
+    }
+    return { disabled, remote, environments };
+}
+function remoteSnapshot(value) {
+    return {
+        type: "remote",
+        url: value.url,
+        ...(value.headers === undefined ? {} : { headers: { ...value.headers } }),
+        ...(value.oauth === undefined ? {} : { oauth: value.oauth }),
+        ...(value.disabled === undefined ? {} : { disabled: value.disabled }),
+    };
+}
+export function cleanManagedEnvironment(editor, managed, injected, pristine) {
+    for (const [name, keys] of managed)
+        editor.update(name, (config) => restoreManaged(config, keys, pristine, name));
+    for (const [name, values] of injected)
+        editor.update(name, (config) => restoreInjected(config, values, pristine, name));
+}
+function restoreManaged(config, keys, pristine, name) {
+    if (config.type !== "local")
+        return;
+    const environment = { ...(config.environment ?? {}) };
+    for (const state of keys.values())
+        for (const key of Object.keys(state.injected))
+            restoreManagedKey(environment, key, state, keys, pristine, name);
+    keys.clear();
+    config.environment = environment;
+}
+function restoreManagedKey(environment, key, state, _keys, pristine, name) {
+    if (environment[key] !== state.injected[key])
+        pristine.set(name, { ...(pristine.get(name) ?? {}), [key]: environment[key] });
+    else if (state.original[key] === undefined)
+        delete environment[key];
+    else
+        environment[key] = state.original[key];
+}
+function restoreInjected(config, values, pristine, name) {
+    if (config.type !== "local")
+        return;
+    const environment = { ...(config.environment ?? {}) };
+    for (const [key, value] of Object.entries(values))
+        restoreInjectedKey(environment, key, value, pristine.get(name)?.[key]);
+    config.environment = environment;
+}
+function restoreInjectedKey(environment, key, injected, original) {
+    if (environment[key] !== injected)
+        return;
+    if (original === undefined)
+        delete environment[key];
+    else
+        environment[key] = original;
+}
+export function runtimeEnvironment(editor, runtime, pristine, managed, injected) {
+    for (const [name, mapping] of Object.entries(runtime.mappings)) {
+        if (!eligibleEnvironmentMapping(mapping, runtime.state.ready))
+            continue;
+        const server = editor.get(name);
+        if (server?.type !== "local")
+            continue;
+        rememberEnvironment(name, mapping, runtime, pristine, managed, injected);
+    }
+}
+function eligibleEnvironmentMapping(mapping, ready) {
+    return ready && typeof mapping === "object" && !("remote" in mapping);
+}
+function rememberEnvironment(name, mapping, runtime, pristine, managed, injected) {
+    const values = environmentValues(mapping, runtime.state.environment, pristine.get(name));
+    if (Object.keys(values.injected).length === 0)
+        return;
+    managed.set(name, new Map([[runtime.id, values]]));
+    injected.set(name, values.injected);
+}
+function environmentValues(mapping, environment, originalEnvironment) {
+    const injected = {};
+    const original = {};
+    for (const output of Object.keys(mapping)) {
+        const value = environment[mapping[output]];
+        if (value === undefined)
+            continue;
+        injected[output] = value;
+        original[output] = originalEnvironment?.[output];
+    }
+    return { original, injected };
+}
+export function selectRuntime(runtimes, bindings, selector) {
+    if (!selector?.scope && !selector?.server)
+        return defaultRuntime(runtimes);
+    const scope = selector.scope ?? (selector.server === undefined ? undefined : bindings[selector.server]);
+    return validSelection(scope, selector?.server, bindings) ? runtimes.get(scope) : undefined;
+}
+function defaultRuntime(runtimes) {
+    return runtimes.get("global") ?? runtimes.get("project");
+}
+function validSelection(scope, server, bindings) {
+    return scope !== undefined && (server === undefined || bindings[server] === scope);
+}
+export function aggregatePhase(base, scopes) {
+    const active = scopes.filter((item) => item.activation !== "awaiting_activation");
+    const unstable = active.some((item) => item.phase === "failed" || item.phase === "starting");
+    if (unstable)
+        return active.some((item) => item.phase === "ready") ? "degraded" : base;
+    return active.every((item) => item.phase === "ready") ? "ready" : base;
+}
+export function projectFallback(configuration) {
+    if (!configuration.project)
+        return undefined;
+    return {
+        scope: "project",
+        projectDirectory: configuration.project.sourceRoot,
+        phase: "stopped",
+        generation: 0,
+        activation: configuration.activation === "auto" ? "auto" : "awaiting_activation",
+        diagnostics: configuration.diagnostics,
+    };
+}
+export function applyRuntimeProtection(editor, runtime, explicitlyDisabled) {
+    for (const name of Object.keys(runtime.mappings)) {
+        if (explicitlyDisabled.has(name))
+            continue;
+        editor.update(name, (config) => {
+            config.disabled = undefined;
+        });
+    }
+    applyProtection(editor, { ...runtime.group.options.adapter, servers: runtime.mappings }, {
+        ...runtime.state,
+        explicitlyDisabled,
+        remoteHandles: runtime.remote.handles,
+    });
+}
+export function disableProjectServers(editor, configuration, inactive) {
+    for (const [name] of Object.entries(configuration.project?.servers ?? {})) {
+        if (configuration.bindings[name] !== "project")
+            continue;
+        editor.update(name, (config) => {
+            config.disabled = true;
+        });
+    }
+    for (const name of inactive)
+        editor.update(name, (config) => {
+            config.disabled = true;
+        });
+}
+export function selectedStatus(runtime, configuration, selector) {
+    if (runtime) {
+        const scoped = groupStatus(runtime, runtime.id === "project" ? configuration.activation : "auto");
+        return {
+            phase: scoped.phase,
+            projectDirectory: scoped.projectDirectory,
+            generation: scoped.generation,
+            ...safeFields(scoped),
+            scopes: [scoped],
+            bindings: configuration.bindings,
+        };
+    }
+    return {
+        phase: "failed",
+        projectDirectory: configuration.global.sourceRoot,
+        generation: 0,
+        diagnostics: [
+            {
+                code: "server_unbound",
+                server: selector.server ?? "",
+                message: "server is not bound to an active scope",
+            },
+        ],
+    };
+}
+function safeFields(status) {
+    return {
+        ...(status.pid === undefined ? {} : { pid: status.pid }),
+        ...(status.lastRefreshAt === undefined ? {} : { lastRefreshAt: status.lastRefreshAt }),
+        ...(status.error === undefined ? {} : { error: status.error }),
+        ...(status.diagnostics === undefined ? {} : { diagnostics: status.diagnostics }),
+    };
+}
+export function statusBase(global, project, configuration) {
+    if (global?.status)
+        return global.status;
+    if (global)
+        return { phase: "starting", projectDirectory: global.group.sourceRoot, generation: 0 };
+    if (project)
+        return {
+            phase: project.phase,
+            projectDirectory: project.projectDirectory,
+            generation: project.generation,
+            ...(project.error === undefined ? {} : { error: project.error }),
+        };
+    return { phase: "stopped", projectDirectory: configuration.global.sourceRoot, generation: 0 };
+}
+export function statusScopes(global, project) {
+    return [...(global ? [groupStatus(global, "auto")] : []), ...(project ? [project] : [])];
+}
+//# sourceMappingURL=controller-helpers.js.map

package/dist/scopes/controller-helpers.js.map

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

package/dist/scopes/controller-types.d.ts

@@ -0,0 +1,22 @@
+import type { Scope } from "effect";
+import type { BrokerLease } from "../broker-registry.js";
+import type { ScopeId, SafeStatus } from "../contracts.js";
+import type { ServerProtection } from "../options.js";
+import type { ProtectionState } from "../plugin.js";
+import type { RemoteRelayCoordinator } from "../remote.js";
+import type { ScopedGroup } from "../scoped-config.js";
+export type Runtime = {
+    readonly id: ScopeId;
+    readonly group: ScopedGroup;
+    lease?: BrokerLease;
+    readonly remote: RemoteRelayCoordinator;
+    mappings: Readonly<Record<string, ServerProtection>>;
+    state: ProtectionState;
+    status?: SafeStatus;
+    observedGeneration: number;
+    active: boolean;
+    readonly scope: Scope.Closeable;
+    epoch: number;
+    transitioning: boolean;
+};
+//# sourceMappingURL=controller-types.d.ts.map

package/dist/scopes/controller-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-types.d.ts","sourceRoot":"","sources":["../../src/scopes/controller-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACrD,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC"}

package/dist/scopes/controller-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=controller-types.js.map

package/dist/scopes/controller-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-types.js","sourceRoot":"","sources":["../../src/scopes/controller-types.ts"],"names":[],"mappings":""}

package/dist/tui.d.ts

@@ -2,6 +2,23 @@ import { Plugin } from "@opencode/plugin/tui";
 export interface SafeStatusView {
     readonly phase: string;
     readonly generation: number;
+    readonly activation?: "auto" | "manual" | "awaiting_activation";
+    readonly scopes?: readonly {
+        readonly scope: "global" | "project";
+        readonly phase: string;
+        readonly generation: number;
+        readonly activation?: "auto" | "manual" | "awaiting_activation";
+        readonly diagnostics?: readonly {
+            readonly server: string;
+            readonly code: string;
+            readonly message: string;
+        }[];
+        readonly error?: {
+            readonly code: string;
+            readonly message: string;
+            readonly retryable: boolean;
+        };
+    }[];
     readonly diagnostics?: readonly {
         readonly server: string;
         readonly code: string;
@@ -17,43 +34,24 @@ export interface TuiActions {
     readonly status: () => Promise<SafeStatusView>;
     readonly refresh: () => Promise<SafeStatusView>;
     readonly doctor: () => Promise<SafeStatusView>;
+    readonly activateProject?: () => Promise<SafeStatusView>;
+    readonly refreshProject?: () => Promise<SafeStatusView>;
+    readonly doctorProject?: () => Promise<SafeStatusView>;
     readonly show: (title: string, message: string, variant: "info" | "success" | "warning" | "error") => void;
 }
 export declare function formatStatus(status: SafeStatusView): string;
-export declare function createCommands(actions: TuiActions): readonly [{
-    readonly id: "key-ferry.status";
-    readonly title: "Key Ferry: Status";
-    readonly description: "Show safe Key Ferry sidecar state";
-    readonly group: "Varlock";
-    readonly palette: true;
-    readonly slash: {
-        readonly name: "key-ferry-status";
-        readonly aliases: string[];
-    };
-    readonly run: () => Promise<void>;
-}, {
-    readonly id: "key-ferry.refresh";
-    readonly title: "Key Ferry: Refresh";
-    readonly description: "Refresh the protected project environment";
-    readonly group: "Varlock";
-    readonly palette: true;
-    readonly slash: {
-        readonly name: "key-ferry-refresh";
-        readonly aliases: string[];
-    };
-    readonly run: () => Promise<void>;
-}, {
-    readonly id: "key-ferry.doctor";
-    readonly title: "Key Ferry: Doctor";
-    readonly description: "Check Varlock readiness and protected connections";
-    readonly group: "Varlock";
-    readonly palette: true;
-    readonly slash: {
-        readonly name: "key-ferry-doctor";
-        readonly aliases: string[];
+export declare function createCommands(actions: TuiActions): {
+    id: string;
+    title: string;
+    description: string;
+    group: string;
+    palette: true;
+    slash: {
+        name: string;
+        aliases: string[];
     };
-    readonly run: () => Promise<void>;
-}];
+    run: () => Promise<void>;
+}[];
 declare const _default: Plugin.Definition;
 export default _default;
 //# sourceMappingURL=tui.d.ts.map

package/dist/tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAG9C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS;QAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,EAAE,CAAC;IACJ,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CACnG;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,CACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,KAC9C,IAAI,CAAC;CACX;AAuBD,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAO3D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU;;;;;;;;0BAuBe,MAAM,EAAE;;;;;;;;;;;0BASN,MAAM,EAAE;;;;;;;;;;;0BASV,MAAM,EAAE;;;GAIxE;;AAED,wBAwBG"}
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAG9C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,qBAAqB,CAAC;IAChE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS;QACzB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;QACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,qBAAqB,CAAC;QAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS;YAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;SAC1B,EAAE,CAAC;QACJ,QAAQ,CAAC,KAAK,CAAC,EAAE;YACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;YACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;SAC7B,CAAC;KACH,EAAE,CAAC;IACJ,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS;QAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,EAAE,CAAC;IACJ,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;CACnG;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IACxD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IACvD,QAAQ,CAAC,IAAI,EAAE,CACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,KAC9C,IAAI,CAAC;CACX;AAuBD,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAK3D;AA4JD,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU;;;;;;;;iBALU,MAAM,EAAE;;;IAOnE;;AAED,wBA2BG"}

package/dist/tui.js

@@ -22,15 +22,102 @@ const errorMessage = (error) => {
     }
 };
 export function formatStatus(status) {
-    const lines = status.error
+    const lines = formatOverview(status);
+    appendDiagnostics(lines, status.diagnostics);
+    for (const scope of status.scopes ?? [])
+        lines.push(...formatScope(scope));
+    return lines.join("\n");
+}
+function formatOverview(status) {
+    return status.error
         ? [`${status.error.message} (${status.error.code})`]
         : [`State: ${status.phase}`, `Generation: ${status.generation}`];
-    for (const item of status.diagnostics ?? [])
-        lines.push(`${item.server}: ${item.message} (${item.code})`);
-    return lines.join("\n");
 }
-export function createCommands(actions) {
-    const run = (title, operation, success) => async () => {
+function appendDiagnostics(lines, diagnostics, prefix) {
+    for (const item of diagnostics ?? [])
+        lines.push(`${prefix ? `${prefix}/` : ""}${item.server}: ${item.message} (${item.code})`);
+}
+function formatScope(scope) {
+    const lines = [formatScopeHeader(scope)];
+    appendScopeError(lines, scope);
+    appendDiagnostics(lines, scope.diagnostics, scope.scope);
+    return lines;
+}
+function formatScopeHeader(scope) {
+    const activation = scope.activation ? `, ${scope.activation}` : "";
+    return `${scope.scope}: ${scope.phase} (generation ${scope.generation}${activation})`;
+}
+function appendScopeError(lines, scope) {
+    if (scope.error)
+        lines.push(`${scope.scope}: ${scope.error.message} (${scope.error.code})`);
+}
+const commandSpecs = [
+    {
+        id: "key-ferry.status",
+        title: "Key Ferry: Status",
+        description: "Show safe Key Ferry sidecar state",
+        slashName: "key-ferry-status",
+        alias: "vstatus",
+        toastTitle: "Varlock status",
+        success: "Status loaded",
+        operation: "status",
+    },
+    {
+        id: "key-ferry.refresh",
+        title: "Key Ferry: Refresh",
+        description: "Refresh the protected project environment",
+        slashName: "key-ferry-refresh",
+        alias: "vrefresh",
+        toastTitle: "Varlock refresh",
+        success: "Refresh completed",
+        operation: "refresh",
+    },
+    {
+        id: "key-ferry.doctor",
+        title: "Key Ferry: Doctor",
+        description: "Check Varlock readiness and protected connections",
+        slashName: "key-ferry-doctor",
+        alias: "vdoctor",
+        toastTitle: "Varlock doctor",
+        success: "Check completed",
+        operation: "doctor",
+    },
+    {
+        id: "key-ferry.project.activate",
+        title: "Key Ferry: Activate Project",
+        description: "Activate the protected project environment",
+        slashName: "key-ferry-project-activate",
+        alias: "vproject-activate",
+        toastTitle: "Varlock project activation",
+        success: "Project activation completed",
+        operation: "activateProject",
+    },
+    {
+        id: "key-ferry.project.refresh",
+        title: "Key Ferry: Refresh Project",
+        description: "Refresh the protected project environment",
+        slashName: "key-ferry-project-refresh",
+        alias: "vproject-refresh",
+        toastTitle: "Varlock project refresh",
+        success: "Project refresh completed",
+        operation: "refreshProject",
+    },
+    {
+        id: "key-ferry.project.doctor",
+        title: "Key Ferry: Doctor Project",
+        description: "Check project Varlock readiness",
+        slashName: "key-ferry-project-doctor",
+        alias: "vproject-doctor",
+        toastTitle: "Varlock project doctor",
+        success: "Project check completed",
+        operation: "doctorProject",
+    },
+];
+const unavailable = async () => {
+    throw { code: "unavailable" };
+};
+function runCommand(actions, title, operation, success) {
+    return async () => {
         actions.show(title, "Working…", "info");
         try {
             const status = await operation();
@@ -40,35 +127,21 @@ export function createCommands(actions) {
             actions.show(title, errorMessage(error), "error");
         }
     };
-    return [
-        {
-            id: "key-ferry.status",
-            title: "Key Ferry: Status",
-            description: "Show safe Key Ferry sidecar state",
-            group: "Varlock",
-            palette: true,
-            slash: { name: "key-ferry-status", aliases: ["vstatus"] },
-            run: run("Varlock status", actions.status, "Status loaded"),
-        },
-        {
-            id: "key-ferry.refresh",
-            title: "Key Ferry: Refresh",
-            description: "Refresh the protected project environment",
-            group: "Varlock",
-            palette: true,
-            slash: { name: "key-ferry-refresh", aliases: ["vrefresh"] },
-            run: run("Varlock refresh", actions.refresh, "Refresh completed"),
-        },
-        {
-            id: "key-ferry.doctor",
-            title: "Key Ferry: Doctor",
-            description: "Check Varlock readiness and protected connections",
-            group: "Varlock",
-            palette: true,
-            slash: { name: "key-ferry-doctor", aliases: ["vdoctor"] },
-            run: run("Varlock doctor", actions.doctor, "Check completed"),
-        },
-    ];
+}
+function createCommand(spec, actions) {
+    const operation = actions[spec.operation] ?? unavailable;
+    return {
+        id: spec.id,
+        title: spec.title,
+        description: spec.description,
+        group: "Varlock",
+        palette: true,
+        slash: { name: spec.slashName, aliases: [spec.alias] },
+        run: runCommand(actions, spec.toastTitle, operation, spec.success),
+    };
+}
+export function createCommands(actions) {
+    return commandSpecs.map((spec) => createCommand(spec, actions));
 }
 export default Plugin.define({
     id: "key-ferry.tui",
@@ -85,6 +158,9 @@ export default Plugin.define({
                 status: () => rpc.status({}),
                 refresh: () => rpc.refresh({}),
                 doctor: () => rpc.doctor({}),
+                activateProject: () => rpc.activateProject({}),
+                refreshProject: () => rpc.refresh({ scope: "project" }),
+                doctorProject: () => rpc.doctor({ scope: "project" }),
                 show,
             }),
         }));

package/dist/tui.js.map

@@ -1 +1 @@
-{"version":3,"file":"tui.js","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AA4CvC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,EAAE;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,wBAAwB,CAAC;IACjF,MAAM,IAAI,GAAG,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC;IAC5F,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,gBAAgB;YACnB,OAAO,kCAAkC,CAAC;QAC5C,KAAK,cAAc;YACjB,OAAO,yBAAyB,CAAC;QACnC,KAAK,gBAAgB;YACnB,OAAO,wBAAwB,CAAC;QAClC,KAAK,SAAS;YACZ,OAAO,6BAA6B,CAAC;QACvC,KAAK,WAAW;YACd,OAAO,sBAAsB,CAAC;QAChC,KAAK,gBAAgB;YACnB,OAAO,sCAAsC,CAAC;QAChD;YACE,OAAO,wBAAwB,CAAC;IACpC,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,MAAsB;IACjD,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACrC,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,MAAsB;IAC5C,OAAO,MAAM,CAAC,KAAK;QACjB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;QACpD,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE,eAAe,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAe,EACf,WAA0C,EAC1C,MAAe;IAEf,KAAK,MAAM,IAAI,IAAI,WAAW,IAAI,EAAE;QAClC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,WAAW,CAAC,KAAoD;IACvE,MAAM,KAAK,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/B,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAoD;IAC7E,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,OAAO,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,gBAAgB,KAAK,CAAC,UAAU,GAAG,UAAU,GAAG,CAAC;AACxF,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAe,EACf,KAAoD;IAEpD,IAAI,KAAK,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;AAC9F,CAAC;AAqBD,MAAM,YAAY,GAA2B;IAC3C;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,mCAAmC;QAChD,SAAS,EAAE,kBAAkB;QAC7B,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,gBAAgB;QAC5B,OAAO,EAAE,eAAe;QACxB,SAAS,EAAE,QAAQ;KACpB;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,2CAA2C;QACxD,SAAS,EAAE,mBAAmB;QAC9B,KAAK,EAAE,UAAU;QACjB,UAAU,EAAE,iBAAiB;QAC7B,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,SAAS;KACrB;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,mDAAmD;QAChE,SAAS,EAAE,kBAAkB;QAC7B,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,gBAAgB;QAC5B,OAAO,EAAE,iBAAiB;QAC1B,SAAS,EAAE,QAAQ;KACpB;IACD;QACE,EAAE,EAAE,4BAA4B;QAChC,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,4CAA4C;QACzD,SAAS,EAAE,4BAA4B;QACvC,KAAK,EAAE,mBAAmB;QAC1B,UAAU,EAAE,4BAA4B;QACxC,OAAO,EAAE,8BAA8B;QACvC,SAAS,EAAE,iBAAiB;KAC7B;IACD;QACE,EAAE,EAAE,2BAA2B;QAC/B,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,2CAA2C;QACxD,SAAS,EAAE,2BAA2B;QACtC,KAAK,EAAE,kBAAkB;QACzB,UAAU,EAAE,yBAAyB;QACrC,OAAO,EAAE,2BAA2B;QACpC,SAAS,EAAE,gBAAgB;KAC5B;IACD;QACE,EAAE,EAAE,0BAA0B;QAC9B,KAAK,EAAE,2BAA2B;QAClC,WAAW,EAAE,iCAAiC;QAC9C,SAAS,EAAE,0BAA0B;QACrC,KAAK,EAAE,iBAAiB;QACxB,UAAU,EAAE,wBAAwB;QACpC,OAAO,EAAE,yBAAyB;QAClC,SAAS,EAAE,eAAe;KAC3B;CACF,CAAC;AAEF,MAAM,WAAW,GAAG,KAAK,IAA6B,EAAE;IACtD,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AAChC,CAAC,CAAC;AAEF,SAAS,UAAU,CACjB,OAAmB,EACnB,KAAa,EACb,SAAwC,EACxC,OAAe;IAEf,OAAO,KAAK,IAAI,EAAE;QAChB,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CACV,KAAK,EACL,GAAG,OAAO,OAAO,YAAY,CAAC,MAAM,CAAC,EAAE,EACvC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CACrC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAmC,EAAE,OAAmB;IAC7E,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC;IACzD,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,IAAa;QACtB,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,CAAa,EAAE;QAClE,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAmB;IAChD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,eAAe,MAAM,CAAC,MAAM,CAAC;IAC3B,EAAE,EAAE,eAAe;IACnB,KAAK,CAAC,OAAO;QACX,0EAA0E;QAC1E,oEAAoE;QACpE,sEAAsE;QACtE,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,WAAgD,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,CACX,KAAa,EACb,OAAe,EACf,OAAiD,EACjD,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAExD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YAC1B,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,cAAc,CAAC;gBACvB,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAA4B;gBACvD,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAA4B;gBACzD,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAA4B;gBACvD,eAAe,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAA4B;gBACzE,cAAc,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAA4B;gBAClF,aAAa,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAA4B;gBAChF,IAAI;aACL,CAAC;SACH,CAAC,CAAC,CAAC;IACN,CAAC;CACF,CAAC,CAAC"}

package/docs/architecture.md

@@ -160,7 +160,8 @@ OpenCode host/TUI run.
    state transitions, fail-closed readiness, refresh, and acquire/release.
 4. `src/plugin.ts`: native V2 plugin layer, local/remote MCP transforms, RPC,
    relay lifecycle, and cleanup.
-5. `src/rpc.ts`: secret-free status and refresh RPC definitions.
+5. `src/rpc.ts`: secret-free status, refresh, doctor, and activateProject RPC
+   definitions.
 6. `src/options.ts`: validation of explicit project-scoped configuration.
 7. `src/tui.ts`: optional status/refresh UX over the RPC shape.
 8. `src/remote.ts`: adapter-side remote relay contract, target/header
@@ -177,3 +178,28 @@ ambient environment variables.
 Cleanup is scope-owned and project-owned: it stops only the sidecar and relay
 resources acquired by this plugin instance. It does not perform a global
 Varlock shutdown and does not claim full sandbox isolation.
+
+## Global and project scopes
+
+The plugin may be installed once in native global OpenCode configuration. Its
+`projectConfig.enabled` option is `false` by default, preserving the original
+single-project behavior. When enabled, the loader reads the optional
+`.opencode/key-ferry.jsonc` from the canonical current project root. The global
+and project scopes have independent Varlock roots, managers, mappings, and
+keysets; project configuration never imports or unions global mappings.
+
+Project `servers` use the same validated mapping shape as native plugin
+options. Reusing a global server name requires listing it in `overrides`; other
+name collisions fail closed. `projectDirectory`, when present in the project
+file, must resolve within the canonical project root. The global activation
+policy is a floor: global manual policy cannot be escalated by a project, and
+project manual policy can restrict global auto activation. Manual activation is
+an in-memory current-location action, not an enrollment store.
+
+A registry deduplicates identical global managers across contexts while keeping
+project managers local. Broker startup is readiness-gated: protected MCP
+servers remain disabled while a group starts, and a failure in one group does
+not stop a healthy group. File watching and configuration reload are local to
+the project group. Status, refresh, and doctor do not activate inactive groups;
+`activateProject` is the explicit one-time activation operation for a manual
+project.