@kyo-so/cli 0.13.1 → 0.14.0

package/dist/cli/integration.d.ts

@@ -1,4 +1,4 @@
-import type { ManualMcpStatus } from "./setup.js";
+import type { ManualMcpRegistration, ManualMcpStatus } from "./setup.js";
 export type IntegrationMode = "manual-mcp" | "cli-skill" | "skill-on-demand" | "mcp-only" | "cli-only" | "missing" | "unknown";
 export type InstalledCli = {
     kind: "installed";
@@ -8,10 +8,11 @@ export type InstalledCli = {
 export type CliAvailability = InstalledCli | {
     kind: "missing" | "transient" | "unknown";
 };
+export type RunnerAvailability = "available" | "missing" | "present-unverified";
 export type CliDetection = {
     kyoso: CliAvailability;
-    npx: boolean;
-    bunx: boolean;
+    npx: RunnerAvailability;
+    bunx: RunnerAvailability;
 };
 export type NonPluginIntegration = {
     mode: IntegrationMode;
@@ -24,7 +25,9 @@ export declare function detectCli(options: {
 }): CliDetection;
 export declare function determineNonPluginIntegration(options: {
     manualMcpStatus: ManualMcpStatus;
+    manualMcpRegistrations: readonly ManualMcpRegistration[];
     hasSkill: boolean;
     cli: CliDetection;
 }): NonPluginIntegration;
+export declare function formatRunnerAvailability(runner: RunnerAvailability): string;
 export declare function formatCliAvailability(cli: CliAvailability): string;

package/dist/cli/knownSkillDigests.d.ts

@@ -1,5 +1,9 @@
-export declare const CURRENT_SKILL_DIGEST = "sha256:8654e68ea61f2acea29027056802bf627ad737f084c9a86ab052946943538409";
+export declare const CURRENT_SKILL_DIGEST = "sha256:d28acaadf490df9e58e12f195804f181a683d0d33344275d7989efbee26a4504";
 export declare const KNOWN_SKILL_DIGESTS_BY_VERSION: {
+    readonly "0.13.1": readonly [{
+        readonly digest: "sha256:8654e68ea61f2acea29027056802bf627ad737f084c9a86ab052946943538409";
+        readonly kind: "historical";
+    }];
     readonly "0.11.0": readonly [{
         readonly digest: "sha256:110dd872a3d1c8a71474a0eadb226f51a6addd86f9d4f3ed17b73678b3179a4e";
         readonly kind: "historical";

package/dist/cli/manualMcpInvocation.d.ts

@@ -0,0 +1,11 @@
+import { type KyosoPackageCommand, type KyosoPackageRunner } from "./packageRunner.js";
+export type ManualMcpInvocationKind = "current" | "legacy" | "custom" | "unknown";
+export type ManualMcpInvocationInspection = {
+    kind: ManualMcpInvocationKind;
+    runner?: KyosoPackageRunner;
+    packageSpec?: string;
+    legacyArgs?: readonly string[];
+    replacement?: KyosoPackageCommand;
+    reason: string;
+};
+export declare function inspectManualMcpInvocation(value: unknown): ManualMcpInvocationInspection;

package/dist/cli/packageRunner.d.ts

@@ -0,0 +1,15 @@
+export declare const KYOSO_PACKAGE_NAME = "@kyo-so/cli";
+export declare const KYOSO_EXECUTABLE_NAME = "kyoso";
+export type KyosoPackageRunner = "npx" | "bunx";
+export type KyosoPackageCommand = {
+    command: KyosoPackageRunner;
+    args: string[];
+};
+export type BuildKyosoPackageCommandOptions = {
+    runner: KyosoPackageRunner;
+    cliArgs: readonly string[];
+    version?: string;
+};
+export declare function buildKyosoPackageCommand(options: BuildKyosoPackageCommandOptions): KyosoPackageCommand;
+export declare function formatKyosoPackageCommand(options: BuildKyosoPackageCommandOptions): string;
+export declare function isCompleteSemVer(value: string): boolean;

package/dist/cli/pluginRuntimeContract.d.ts

@@ -6,13 +6,14 @@
  * retains dated probe metadata, which deliberately does not belong in the
  * published CLI.
  */
-export declare const PLUGIN_RUNTIME_COMPATIBILITY_SCHEMA_VERSION = 1;
+export declare const PLUGIN_RUNTIME_COMPATIBILITY_SCHEMA_VERSION = 2;
 export declare const MINIMUM_SUPPORTED_CODEX_VERSION = "0.144.0-alpha.4";
 export declare const PLUGIN_RUNTIME_EXPECTED_CONTRACT: {
     readonly distribution: {
-        readonly pluginVersion: "0.7.0";
+        readonly pluginVersion: "0.7.2";
         readonly mcpCommand: "npx";
-        readonly mcpPackagePin: "@kyo-so/cli@0.13.0";
+        readonly mcpPackagePin: "@kyo-so/cli@0.13.1";
+        readonly mcpExecutable: "kyoso";
     };
     readonly marketplace: {
         readonly name: "kyoso";
@@ -124,15 +125,16 @@ export declare const PLUGIN_LIST_JSON_SCHEMA: {
 };
 /** Stable runtime contract consumed by Doctor and distribution verification. */
 export declare const pluginRuntimeContract: {
-    readonly schemaVersion: 1;
+    readonly schemaVersion: 2;
     readonly minimumSupportedCodexVersion: "0.144.0-alpha.4";
     readonly pluginId: "kyoso@kyoso";
     readonly pluginListTopLevelKeys: readonly ["installed", "available"];
     readonly expectedContract: {
         readonly distribution: {
-            readonly pluginVersion: "0.7.0";
+            readonly pluginVersion: "0.7.2";
             readonly mcpCommand: "npx";
-            readonly mcpPackagePin: "@kyo-so/cli@0.13.0";
+            readonly mcpPackagePin: "@kyo-so/cli@0.13.1";
+            readonly mcpExecutable: "kyoso";
         };
         readonly marketplace: {
             readonly name: "kyoso";

package/dist/cli/setup.d.ts

@@ -1,14 +1,36 @@
+import { type ManualMcpInvocationInspection } from "./manualMcpInvocation.js";
+import { type KyosoPackageRunner } from "./packageRunner.js";
 export type SetupClient = "codex" | "claude-code";
-export type SetupRunner = "npx" | "bunx";
+export type SetupRunner = KyosoPackageRunner;
 export type SetupScope = "project" | "global";
 export type ManualMcpStatus = "enabled" | "disabled" | "missing" | "unknown";
+export type ManualMcpScope = "codex-global" | "claude-project" | "claude-global" | "claude-global-project";
+export type ManualMcpRegistration = {
+    path: string;
+    scope: ManualMcpScope;
+    status: ManualMcpStatus;
+    invocation: ManualMcpInvocationInspection;
+    autoMigrationEligible: boolean;
+};
 export type SetupDetection = {
     mcp: boolean;
     skill: boolean;
     manualMcpStatus: ManualMcpStatus;
+    manualMcpRegistrations: ManualMcpRegistration[];
     mcpPaths: string[];
     skillPaths: string[];
 };
+export type BunxVersionProbeResult = {
+    status: "verified";
+    version: string;
+} | {
+    status: "missing" | "failed" | "timeout" | "invalid" | "unsupported";
+    detail: string;
+};
+export type BunxVersionProbe = (options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}) => BunxVersionProbeResult;
 export type CodexPluginMcpOverride = {
     status: ManualMcpStatus;
     path: string;
@@ -24,6 +46,12 @@ export type SetupOptions = {
     skillOnly?: boolean;
     force?: boolean;
     env?: NodeJS.ProcessEnv;
+    bunxVersionProbe?: BunxVersionProbe;
+    beforeManualMcpWrite?: (path: string) => void | Promise<void>;
+    beforeManualMcpCommit?: (path: string) => void | Promise<void>;
+    afterManualMcpValidation?: (path: string) => void | Promise<void>;
+    beforeManualMcpRename?: (path: string) => void | Promise<void>;
+    manualMcpRename?: (source: string, destination: string) => Promise<void>;
 };
 type McpCommand = {
     command: string;
@@ -47,4 +75,8 @@ export declare function detectSetup(options: {
     codexHome?: string;
     env?: NodeJS.ProcessEnv;
 }): Record<SetupClient, SetupDetection>;
+export declare function probeBunxVersion(options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}): BunxVersionProbeResult;
 export {};

package/dist/core/constants.d.ts

@@ -7,4 +7,4 @@ export declare const JUDGE_MAX_OUTPUT_TOKENS = 4096;
 export declare const RAW_OUTPUT_MAX_CHARS = 16384;
 export declare const TRACE_DIR = ".kyoso/traces";
 export declare const KYOSO_CHILD_AGENT = "KYOSO_CHILD_AGENT";
-export declare const KYOSO_VERSION = "0.13.1";
+export declare const KYOSO_VERSION = "0.14.0";

package/examples/claude-code-mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "kyoso": {
       "command": "npx",
-      "args": ["-y", "@kyo-so/cli", "mcp"],
+      "args": ["-y", "--package=@kyo-so/cli", "kyoso", "mcp"],
       "env": {
         "OPENAI_API_KEY": "${OPENAI_API_KEY}",
         "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}",

package/examples/codex-config.toml

@@ -1,6 +1,6 @@
 [mcp_servers.kyoso]
 command = "npx"
-args = ["-y", "@kyo-so/cli", "mcp"]
+args = ["-y", "--package=@kyo-so/cli", "kyoso", "mcp"]
 # Generated by `kyoso setup codex --write`. For OpenRouter, use
 # `kyoso setup codex --write --with-openrouter`, or insert
 # "OPENROUTER_API_KEY" after "CODEX_ACCESS_TOKEN" in this list.
@@ -11,4 +11,4 @@ enabled = true
 
 # Bun alternative:
 # command = "bunx"
-# args = ["@kyo-so/cli", "mcp"]
+# args = ["--package", "@kyo-so/cli", "kyoso", "mcp"]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kyo-so/cli",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "description": "Kyo-so: MCP-native, ACP-powered multi-agent review gates for AI coding workflows.",
   "license": "AGPL-3.0-or-later",
   "repository": {
@@ -49,6 +49,8 @@
     "plugin:sync": "node scripts/plugin-sync.mjs",
     "plugin:verify": "node scripts/verify-plugin.mjs",
     "plugin:verify:registry": "node scripts/verify-plugin-registry.mjs",
+    "plugin:verify:published-cli": "node scripts/verify-published-cli.mjs",
+    "plugin:runtime:migrate": "node scripts/plugin-runtime-contract-migrate.mjs",
     "plugin:runtime:verify": "node scripts/verify-plugin-runtime.mjs",
     "plugin:promote": "node scripts/plugin-promote.mjs",
     "skill:runtime:verify": "node scripts/verify-skill-runtime.mjs",