botmancers 0.3.0 → 0.5.0

package/app/server.js

@@ -9,7 +9,7 @@ const currentPort = parseInt(process.env.PORT, 10) || 3000
 const hostname = process.env.HOSTNAME || '0.0.0.0'
 
 let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10)
-const nextConfig = {"env":{"BOTMANCERS_BUILD_VERSION":"0.3.0","BOTMANCERS_BUILD_COMMIT":"a08e532e759845e03310017398ab584ebc9d5b9e"},"webpack":null,"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"instrumentationClientInject":[],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":__dirname,"enablePrerenderSourceMaps":true,"cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":true,"coldCacheBadge":false,"devValidationWorker":true,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"dynamicOnHover":false,"useOffline":false,"varyParams":true,"optimisticRouting":true,"instrumentationClientRouterTransitionEvents":false,"prefetchInlining":{"maxSize":2048,"maxBundleSize":10240},"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":9,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptOperationCache":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"devMemoryThresholdRestart":true,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"requestInsights":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"useTypeScriptCli":true,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":true,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"serverComponentsHmrCancellation":false,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":true,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","turbopackMemoryEvictionMode":"auto","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"useCacheTimeout":54,"instantInsights":{"validationLevel":"warning"},"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","repoRoot":__dirname,"turbopack":{"root":__dirname},"distDirRoot":".next","_originalRewrites":{"beforeFiles":[],"afterFiles":[{"source":"/favicon.ico","destination":"/brand/botmancers-logo-filled-64.png"}],"fallback":[]}}
+const nextConfig = {"env":{"BOTMANCERS_BUILD_VERSION":"0.5.0","BOTMANCERS_BUILD_COMMIT":"47984e52c3b4b718ad944d03532e9b80efc95529"},"webpack":null,"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"instrumentationClientInject":[],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":__dirname,"enablePrerenderSourceMaps":true,"cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":true,"coldCacheBadge":false,"devValidationWorker":true,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"dynamicOnHover":false,"useOffline":false,"varyParams":true,"optimisticRouting":true,"instrumentationClientRouterTransitionEvents":false,"prefetchInlining":{"maxSize":2048,"maxBundleSize":10240},"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":9,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptOperationCache":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"devMemoryThresholdRestart":true,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"requestInsights":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"useTypeScriptCli":true,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":true,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"serverComponentsHmrCancellation":false,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":true,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","turbopackMemoryEvictionMode":"auto","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"useCacheTimeout":54,"instantInsights":{"validationLevel":"warning"},"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","repoRoot":__dirname,"turbopack":{"root":__dirname},"distDirRoot":".next","_originalRewrites":{"beforeFiles":[],"afterFiles":[{"source":"/favicon.ico","destination":"/brand/botmancers-logo-filled-64.png"}],"fallback":[]}}
 
 process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)
 

package/dist/cli.d.ts

@@ -13,7 +13,7 @@ export interface CliIo {
 export declare const PRODUCT_COMMANDS: readonly ["setup", "start", "stop", "status", "doctor", "open"];
 export declare const INSTALL_COMMANDS: readonly ["install", "upgrade"];
 export declare const UPDATE_WORKER_COMMAND = "__update-check";
-export declare const PRODUCT_HELP = "Usage: botmancers <command>\n\nRun Botmancers (UI, API, core engine, and MCP bridge) from this package:\n\n  setup                     Create BOTMANCERS_HOME (owner-only) and generate the\n                            bridge credentials; prints Hermes and Agent Deck steps\n  start [--daemon] [--open] Start the UI/core on 127.0.0.1:43123 and the MCP bridge\n                            on 127.0.0.1:43124 under one supervisor\n  stop                      Stop the supervisor, core, and bridge\n  status                    Report healthy / degraded / stopped, versions, endpoints\n  doctor                    Check the installation, home, ports, Hermes, Agent Deck\n  open                      Open the UI in a browser\n  mcp [options]             Run only the MCP bridge (same as bare `botmancers`)\n  install [--to VERSION]    Managed install into ~/.botmancers/versions with the\n                            ~/.local/bin/botmancers launcher (--help for options)\n  upgrade [--check] [--to VERSION] [--yes]\n                            Update this installation (managed or npm-global)\n\nManaged installs update themselves: at most one npm check a day, a background\ndownload, activation at the next `botmancers start` once nothing is running.\nBOTMANCERS_DISABLE_AUTOUPDATER=1 turns that off; `botmancers upgrade` still works.\n\nEnvironment: BOTMANCERS_HOME (default ~/.botmancers), BOTMANCERS_UI_PORT,\nBOTMANCERS_MCP_PORT. Variables exported in your shell (HERMES_*, BOTMANCERS_DB_PATH,\n...) take precedence over <home>/config/core.env.\n\nExit codes: 0 ok, 1 degraded or check failed, 2 usage, 3 not running,\n6 port in use, 7 core or bridge failed to start, 8 packaged app incomplete,\n9 home not writable, 10 not set up (run botmancers setup).\n";
+export declare const PRODUCT_HELP = "Usage: botmancers <command>\n\nRun Botmancers (UI, API, core engine, and MCP bridge) from this package:\n\n  setup                     Create BOTMANCERS_HOME (owner-only) and generate the\n                            bridge credentials; prints Hermes and Agent Deck steps;\n                            refreshes the clients set up with --client\n  setup --client codex|cursor|claude [--remove]\n                            Connect that client to the MCP bridge and install the\n                            optional botmancers-collaboration skill (or remove both);\n                            files you edited are never overwritten\n  start [--daemon] [--open] Start the UI/core on 127.0.0.1:3333 and the MCP bridge\n                            on 127.0.0.1:3332 under one supervisor\n  stop                      Stop the supervisor, core, and bridge\n  status                    Report healthy / degraded / stopped, versions, endpoints\n  doctor                    Check the installation, home, ports, Hermes, Agent Deck\n  open                      Open the UI in a browser\n  mcp [options]             Run only the MCP bridge (same as bare `botmancers`)\n  install [--to VERSION]    Managed install into ~/.botmancers/versions with the\n                            ~/.local/bin/botmancers launcher (--help for options)\n  upgrade [--check] [--to VERSION] [--yes]\n                            Update this installation (managed or npm-global)\n\nManaged installs update themselves: at most one npm check a day, a background\ndownload, activation at the next `botmancers start` once nothing is running.\nBOTMANCERS_DISABLE_AUTOUPDATER=1 turns that off; `botmancers upgrade` still works.\n\nEnvironment: BOTMANCERS_HOME (default ~/.botmancers), BOTMANCERS_UI_PORT,\nBOTMANCERS_MCP_PORT. Variables exported in your shell (HERMES_*, BOTMANCERS_DB_PATH,\n...) take precedence over <home>/config/core.env.\n\nExit codes: 0 ok, 1 degraded or check failed, 2 usage, 3 not running,\n6 port in use, 7 core or bridge failed to start, 8 packaged app incomplete,\n9 home not writable, 10 not set up (run botmancers setup), 11 the client is not\ninstalled, 12 client files conflict (setup --client changed nothing).\n";
 export declare function productMain(command: typeof PRODUCT_COMMANDS[number], argv: string[], env: NodeJS.ProcessEnv, io?: CliIo): Promise<number>;
 export declare function main(argv: string[], env: NodeJS.ProcessEnv, io?: CliIo): Promise<number | 'serving'>;
 export declare function bridgeMain(argv: string[], env: NodeJS.ProcessEnv, io?: CliIo): Promise<number | 'serving'>;

package/dist/cli.js

@@ -19,6 +19,7 @@ import { HEALTH_PATH, MCP_PATH, createBridge } from './server.js';
 import { UpstreamError } from './upstream.js';
 import { PRODUCT_EXIT, UsageError, doctor, open, parseStartArgs, productContext, start, status, stop } from './product.js';
 import { SetupError, runSetup } from './setup.js';
+import { ClientUsageError, mcpTarget, parseSetupArgs, setupClients } from './clients.js';
 import { DISABLE_AUTOUPDATER_ENV, runUpdateCheck, scheduleAutoUpdate } from './managed.js';
 import { runInstall, runUpgrade } from './upgrade.js';
 export const EXIT = { ok: 0, config: 2, listen: 3, unavailable: 4, credentials: 5 };
@@ -38,9 +39,14 @@ export const PRODUCT_HELP = `Usage: botmancers <command>
 Run Botmancers (UI, API, core engine, and MCP bridge) from this package:
 
   setup                     Create BOTMANCERS_HOME (owner-only) and generate the
-                            bridge credentials; prints Hermes and Agent Deck steps
-  start [--daemon] [--open] Start the UI/core on 127.0.0.1:43123 and the MCP bridge
-                            on 127.0.0.1:43124 under one supervisor
+                            bridge credentials; prints Hermes and Agent Deck steps;
+                            refreshes the clients set up with --client
+  setup --client codex|cursor|claude [--remove]
+                            Connect that client to the MCP bridge and install the
+                            optional botmancers-collaboration skill (or remove both);
+                            files you edited are never overwritten
+  start [--daemon] [--open] Start the UI/core on 127.0.0.1:3333 and the MCP bridge
+                            on 127.0.0.1:3332 under one supervisor
   stop                      Stop the supervisor, core, and bridge
   status                    Report healthy / degraded / stopped, versions, endpoints
   doctor                    Check the installation, home, ports, Hermes, Agent Deck
@@ -61,7 +67,8 @@ BOTMANCERS_MCP_PORT. Variables exported in your shell (HERMES_*, BOTMANCERS_DB_P
 
 Exit codes: 0 ok, 1 degraded or check failed, 2 usage, 3 not running,
 6 port in use, 7 core or bridge failed to start, 8 packaged app incomplete,
-9 home not writable, 10 not set up (run botmancers setup).
+9 home not writable, 10 not set up (run botmancers setup), 11 the client is not
+installed, 12 client files conflict (setup --client changed nothing).
 `;
 // Product commands (./product). Resolves when the command finishes; a
 // foreground `start` resolves only after the product stops.
@@ -75,12 +82,33 @@ export async function productMain(command, argv, env, io = processIo) {
         // The running supervisor schedules its own checks; `start` reaches it.
         if (command !== 'start')
             scheduleAutoUpdate(env);
-        if (command !== 'start' && argv.length)
+        if (command !== 'start' && command !== 'setup' && argv.length)
             throw new UsageError(`${command} takes no arguments.`);
         switch (command) {
             case 'setup': {
-                const result = runSetup(ctx.paths, { ui: ctx.uiPort, mcp: ctx.mcpPort });
-                ctx.io.stdout(`${result.lines.join('\n')}\n`);
+                let options;
+                try {
+                    options = parseSetupArgs(argv);
+                }
+                catch (error) {
+                    if (error instanceof ClientUsageError)
+                        throw new UsageError(error.message);
+                    throw error;
+                }
+                if (!options.remove) {
+                    const result = runSetup(ctx.paths, { ui: ctx.uiPort, mcp: ctx.mcpPort });
+                    ctx.io.stdout(`${result.lines.join('\n')}\n`);
+                }
+                const outcomes = setupClients(options, ctx.env, ctx.paths, mcpTarget(ctx.paths, ctx.mcpPort), ctx.version);
+                for (const outcome of outcomes)
+                    (outcome.ok ? ctx.io.stdout : ctx.io.stderr)(`${options.remove ? '' : '\n'}${outcome.lines.join('\n')}\n`);
+                // Plain setup only refreshes; its own job (the home) already succeeded.
+                if (!options.clients.length)
+                    return PRODUCT_EXIT.ok;
+                if (outcomes.some(outcome => outcome.kind === 'conflict'))
+                    return PRODUCT_EXIT.clientConflict;
+                if (outcomes.some(outcome => outcome.kind === 'missing-client'))
+                    return PRODUCT_EXIT.clientMissing;
                 return PRODUCT_EXIT.ok;
             }
             case 'start': return await start(ctx, parseStartArgs(argv));

package/dist/clients.d.ts

@@ -0,0 +1,86 @@
+import { type HomePaths } from './home.js';
+export declare const SKILL_NAME = "botmancers-collaboration";
+export declare const MCP_SERVER_NAME = "botmancers";
+export declare const CLIENT_IDS: readonly ["codex", "cursor", "claude"];
+export type ClientId = typeof CLIENT_IDS[number];
+export declare const PACKAGED_SKILL_DIR: string;
+export interface ClientLayout {
+    id: ClientId;
+    label: string;
+    root: string;
+    config: string;
+    format: 'toml' | 'json';
+    skillDir: string;
+}
+export declare function isClientId(value: string): value is ClientId;
+export declare function clientLayout(id: ClientId, env: NodeJS.ProcessEnv): ClientLayout;
+export interface SkillFile {
+    rel: string;
+    data: Buffer;
+    hash: string;
+}
+export declare function packagedSkill(dir?: string): SkillFile[];
+export interface ClientManifest {
+    schema: 1;
+    client: ClientId;
+    version: string;
+    installed_at: string;
+    skill: {
+        dir: string;
+        files: Record<string, string>;
+    };
+    mcp: {
+        config: string;
+        name: string;
+        hash: string;
+    };
+}
+export declare const manifestPath: (paths: HomePaths, id: ClientId) => string;
+export declare function loadManifest(paths: HomePaths, id: ClientId): {
+    manifest: ClientManifest | null;
+    problem: string | null;
+};
+export declare function readManifest(paths: HomePaths, id: ClientId): ClientManifest | null;
+export interface McpTarget {
+    url: string;
+    token: string;
+}
+export declare function mcpTarget(paths: HomePaths, mcpPort: number): McpTarget | null;
+export type PartState = 'current' | 'stale' | 'missing' | 'conflict' | 'absent';
+export interface ClientView {
+    layout: ClientLayout;
+    installed: boolean;
+    manifest: ClientManifest | null;
+    manifestProblem: string | null;
+    mcp: {
+        state: PartState;
+        reason?: string;
+    };
+    skill: {
+        state: PartState;
+        conflicts: string[];
+        changes: number;
+    };
+}
+export declare function inspectClient(id: ClientId, env: NodeJS.ProcessEnv, paths: HomePaths, target: McpTarget | null, skill?: SkillFile[]): ClientView;
+export interface ClientOutcome {
+    ok: boolean;
+    kind: 'installed' | 'removed' | 'missing-client' | 'conflict';
+    lines: string[];
+}
+export declare const repairCommand: (id: ClientId) => string;
+export declare function mcpOnlyLines(target: {
+    url: string;
+}, paths: HomePaths): string[];
+export declare function installClient(id: ClientId, env: NodeJS.ProcessEnv, paths: HomePaths, target: McpTarget, version: string, skill?: SkillFile[]): ClientOutcome;
+export declare function removeClient(id: ClientId, env: NodeJS.ProcessEnv, paths: HomePaths): ClientOutcome;
+export type DoctorLine = ['ok' | 'warn' | 'info', string, string];
+export declare function clientDoctorLines(env: NodeJS.ProcessEnv, paths: HomePaths, target: McpTarget | null): DoctorLine[];
+export interface SetupOptions {
+    clients: ClientId[];
+    remove: boolean;
+}
+export declare class ClientUsageError extends Error {
+}
+export declare function parseSetupArgs(argv: string[]): SetupOptions;
+export declare function setupClients(options: SetupOptions, env: NodeJS.ProcessEnv, paths: HomePaths, target: McpTarget | null, version: string): ClientOutcome[];