docks-kit 0.17.1 → 0.17.3

package/cli/src/kitHome.ts

@@ -1,41 +1,45 @@
-import { readFileSync } from "node:fs"
-import { dirname, join, resolve } from "node:path"
+import { readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
 
 const isKitHome = (dir: string): boolean => {
   try {
-    const manifest = JSON.parse(readFileSync(join(dir, "package.json"), "utf8")) as { name?: unknown }
-    return manifest.name === "docks-kit"
+    const manifest = JSON.parse(readFileSync(join(dir, "package.json"), "utf8")) as {
+      name?: unknown;
+    };
+    return manifest.name === "docks-kit";
   } catch {
-    return false
+    return false;
   }
-}
+};
 
 const explicitKitHome = (dir: string, source: string): string => {
-  const packageJson = join(dir, "package.json")
-  let text: string
+  const packageJson = join(dir, "package.json");
+  let text: string;
   try {
-    text = readFileSync(packageJson, "utf8")
+    text = readFileSync(packageJson, "utf8");
   } catch (error) {
     const code =
       typeof error === "object" && error !== null && "code" in error
         ? String(error.code)
-        : undefined
+        : undefined;
     if (code === "ENOENT") {
-      throw new Error(`DOCKS_KIT_HOME=${source} does not contain package.json`)
+      throw new Error(`DOCKS_KIT_HOME=${source} does not contain package.json`, { cause: error });
     }
-    const detail = error instanceof Error ? error.message : String(error)
-    const category = code === undefined ? "" : ` (${code})`
-    throw new Error(
-      `DOCKS_KIT_HOME=${source} package.json cannot be read${category}: ${detail}`
-    )
+    const detail = error instanceof Error ? error.message : String(error);
+    const category = code === undefined ? "" : ` (${code})`;
+    throw new Error(`DOCKS_KIT_HOME=${source} package.json cannot be read${category}: ${detail}`, {
+      cause: error,
+    });
   }
 
-  let manifest: unknown
+  let manifest: unknown;
   try {
-    manifest = JSON.parse(text)
+    manifest = JSON.parse(text);
   } catch (error) {
-    const detail = error instanceof Error ? error.message : String(error)
-    throw new Error(`DOCKS_KIT_HOME=${source} package.json contains invalid JSON: ${detail}`)
+    const detail = error instanceof Error ? error.message : String(error);
+    throw new Error(`DOCKS_KIT_HOME=${source} package.json contains invalid JSON: ${detail}`, {
+      cause: error,
+    });
   }
 
   if (
@@ -45,29 +49,29 @@ const explicitKitHome = (dir: string, source: string): string => {
     manifest.name !== "docks-kit"
   ) {
     throw new Error(
-      `DOCKS_KIT_HOME=${source} is not a docks-kit package root (package.json name must be "docks-kit")`
-    )
+      `DOCKS_KIT_HOME=${source} is not a docks-kit package root (package.json name must be "docks-kit")`,
+    );
   }
-  return dir
-}
+  return dir;
+};
 
 const findKitHome = (start: string | undefined): string | undefined => {
-  if (start === undefined || start === "") return undefined
-  let dir = resolve(start)
+  if (start === undefined || start === "") return undefined;
+  let dir = resolve(start);
   for (;;) {
-    if (isKitHome(dir)) return dir
-    const parent = dirname(dir)
-    if (parent === dir) return undefined
-    dir = parent
+    if (isKitHome(dir)) return dir;
+    const parent = dirname(dir);
+    if (parent === dir) return undefined;
+    dir = parent;
   }
-}
+};
 
 export interface KitHomeSources {
-  readonly env: string | undefined
+  readonly env: string | undefined;
   /** `import.meta.dir` is a Bun extension, so a non-Bun loader leaves it undefined. */
-  readonly moduleDir: string | undefined
-  readonly execPath: string
-  readonly cwd: string
+  readonly moduleDir: string | undefined;
+  readonly execPath: string;
+  readonly cwd: string;
 }
 
 /**
@@ -78,7 +82,7 @@ export interface KitHomeSources {
  */
 export const resolveKitHome = (sources: KitHomeSources): string => {
   if (sources.env !== undefined && sources.env !== "") {
-    return explicitKitHome(resolve(sources.env), sources.env)
+    return explicitKitHome(resolve(sources.env), sources.env);
   }
 
   return (
@@ -86,13 +90,13 @@ export const resolveKitHome = (sources: KitHomeSources): string => {
     findKitHome(dirname(sources.execPath)) ??
     findKitHome(sources.cwd) ??
     dirname(sources.execPath)
-  )
-}
+  );
+};
 
 export const kitHome = (): string =>
   resolveKitHome({
     env: process.env["DOCKS_KIT_HOME"],
     moduleDir: import.meta.dir,
     execPath: process.execPath,
-    cwd: process.cwd()
-  })
+    cwd: process.cwd(),
+  });

package/cli/src/main.ts

@@ -1,46 +1,53 @@
 #!/usr/bin/env bun
-import { Command, CliOutput } from "effect/unstable/cli"
-import { BunRuntime, BunServices } from "@effect/platform-bun"
-import { Console, Effect, Layer } from "effect"
-import { EngineServicesLive } from "./services"
-import { docsCommand } from "./commands/docs"
-import { harnessesCommand } from "./commands/harnesses"
-import { modelCommand } from "./commands/model"
-import { modelsCommand } from "./commands/models"
-import { ompCommand } from "./commands/omp"
-import { pluginsCommand } from "./commands/plugins"
-import { skillsCommand } from "./commands/skills"
-import { statusCommand } from "./commands/status"
-import { syncCommand } from "./commands/sync"
-import { toolchainCommand } from "./commands/toolchain"
-import { updateCommand } from "./commands/update"
-import { GENERATED_PACKAGE_VERSION } from "./generated/sotPayload"
-import { prepareArgv } from "./argv"
-import { runEngineNative } from "./engine-native"
-
+import { Command, CliOutput } from "effect/unstable/cli";
+import { BunRuntime, BunServices } from "@effect/platform-bun";
+import { Console, Effect, Layer } from "effect";
+import { EngineServicesLive } from "./services";
+import { docsCommand } from "./commands/docs";
+import { harnessesCommand } from "./commands/harnesses";
+import { modelCommand } from "./commands/model";
+import { modelsCommand } from "./commands/models";
+import { ompCommand } from "./commands/omp";
+import { pluginsCommand } from "./commands/plugins";
+import { skillsCommand } from "./commands/skills";
+import { statusCommand } from "./commands/status";
+import { syncCommand } from "./commands/sync";
+import { toolchainCommand } from "./commands/toolchain";
+import { updateCommand } from "./commands/update";
+import { GENERATED_PACKAGE_VERSION } from "./generated/sotPayload";
+import { prepareArgv } from "./argv";
+import { runEngineNative } from "./engine-native";
 
 const root = Command.make("docks-kit", {}, () =>
   Effect.gen(function* () {
-    yield* Console.log("docks-kit — portable AI coding agent config kit")
-    yield* Console.log("")
-    yield* Console.log("  docks-kit sync [claude|codex|agents|omp]  deploy the SoT to this machine")
-    yield* Console.log("  docks-kit harnesses                       choose the flag-less sync selection")
-    yield* Console.log("  docks-kit update [--no-sync]              self-update the kit, then sync")
-    yield* Console.log("  docks-kit model <claude|codex> [value]     get/set the deployed model")
-    yield* Console.log("  docks-kit models [tool]                    kit-verified model catalog")
-    yield* Console.log("  docks-kit toolchain [check|ensure <tool>]  verified-version floors")
-    yield* Console.log("  docks-kit status                           deployed-vs-SoT doctor view")
-    yield* Console.log("  docks-kit plugins list                     plugin tri-state")
-    yield* Console.log("  docks-kit skills list                      universal skills")
-    yield* Console.log("  docks-kit docs [topic]                     self-documentation")
-    yield* Console.log("  docks-kit omp [--model|--pick] [...]       free-model omp session")
-    yield* Console.log("")
-    yield* Console.log("Run 'docks-kit --help' for full option listings (also: --wizard, --completions).")
-    yield* Console.log("No-Bun recovery path: use a platform release binary.")
-  })
+    yield* Console.log("docks-kit — portable AI coding agent config kit");
+    yield* Console.log("");
+    yield* Console.log(
+      "  docks-kit sync [claude|codex|agents|omp]  deploy the SoT to this machine",
+    );
+    yield* Console.log(
+      "  docks-kit harnesses                       choose the flag-less sync selection",
+    );
+    yield* Console.log(
+      "  docks-kit update [--no-sync]              self-update the kit, then sync",
+    );
+    yield* Console.log("  docks-kit model <claude|codex> [value]     get/set the deployed model");
+    yield* Console.log("  docks-kit models [tool]                    kit-verified model catalog");
+    yield* Console.log("  docks-kit toolchain [check|ensure <tool>]  verified-version floors");
+    yield* Console.log("  docks-kit status                           deployed-vs-SoT doctor view");
+    yield* Console.log("  docks-kit plugins list                     plugin tri-state");
+    yield* Console.log("  docks-kit skills list                      universal skills");
+    yield* Console.log("  docks-kit docs [topic]                     self-documentation");
+    yield* Console.log("  docks-kit omp [--model|--pick] [...]       free-model omp session");
+    yield* Console.log("");
+    yield* Console.log(
+      "Run 'docks-kit --help' for full option listings (also: --wizard, --completions).",
+    );
+    yield* Console.log("No-Bun recovery path: use a platform release binary.");
+  }),
 ).pipe(
   Command.withDescription(
-    "Portable AI coding agent config kit — SoT sync engine + helpers for Claude Code, Codex, and universal agent skills."
+    "Portable AI coding agent config kit — SoT sync engine + helpers for Claude Code, Codex, and universal agent skills.",
   ),
   Command.withSubcommands([
     syncCommand,
@@ -53,17 +60,17 @@ const root = Command.make("docks-kit", {}, () =>
     pluginsCommand,
     skillsCommand,
     docsCommand,
-    ompCommand
-  ])
-)
+    ompCommand,
+  ]),
+);
 
 // v4's default formatter renders `name vversion`, but the `docks-kit` launcher
 // compares `--version` against the bare `package.json` version. The trailing
 // newline reproduces the characterized byte-for-byte output of the v3 CLI.
 const bareVersionFormatter: CliOutput.Formatter = {
   ...CliOutput.defaultFormatter(),
-  formatVersion: (_name, version) => `${version}\n`
-}
+  formatVersion: (_name, version) => `${version}\n`,
+};
 
 // Harness-private raw channel:
 // `DOCKS_KIT_ENGINE=native-raw` bypasses effect/unstable/cli and hands the raw engine
@@ -71,31 +78,31 @@ const bareVersionFormatter: CliOutput.Formatter = {
 // PUBLIC engine execution lives at the engine.ts seam after the CLI has
 // parsed/normalized pickers, --flag value forms, and non-engine commands.
 if (process.env["DOCKS_KIT_ENGINE"] === "native-raw") {
-  const rawArgs = process.argv.slice(2)
-  const rawOperation = rawArgs.join(" ") || "default"
+  const rawArgs = process.argv.slice(2);
+  const rawOperation = rawArgs.join(" ") || "default";
   try {
-    process.exit(await runEngineNative(rawArgs))
+    process.exit(await runEngineNative(rawArgs));
   } catch (error) {
-    let detail = "unknown error"
-    if (error instanceof Error && error.message !== "") detail = error.message
-    else if (typeof error === "string" && error !== "") detail = error
-    process.stderr.write(`docks-kit raw operation '${rawOperation}' failed: ${detail}\n`)
-    process.exit(1)
+    let detail = "unknown error";
+    if (error instanceof Error && error.message !== "") detail = error.message;
+    else if (typeof error === "string" && error !== "") detail = error;
+    process.stderr.write(`docks-kit raw operation '${rawOperation}' failed: ${detail}\n`);
+    process.exit(1);
   }
 }
 
 // Validate and normalize before parsing because the kit refuses to guess at unrecognized
 // or duplicated flags, and Effect 4 would otherwise negate `--no-<flag>` into a real
 // mutating run. This seam owns argument normalization.
-const prepared = prepareArgv(process.argv.slice(2))
+const prepared = prepareArgv(process.argv.slice(2));
 if (prepared.kind === "reject") {
-  process.stderr.write(`${prepared.message}\n`)
-  process.exit(prepared.exitCode)
+  process.stderr.write(`${prepared.message}\n`);
+  process.exit(prepared.exitCode);
 }
 
 Command.runWith(root, { version: GENERATED_PACKAGE_VERSION })(prepared.args).pipe(
   Effect.provide(
-    Layer.mergeAll(BunServices.layer, EngineServicesLive, CliOutput.layer(bareVersionFormatter))
+    Layer.mergeAll(BunServices.layer, EngineServicesLive, CliOutput.layer(bareVersionFormatter)),
   ),
-  BunRuntime.runMain
-)
+  BunRuntime.runMain,
+);

package/cli/src/manifests.ts

@@ -1,99 +1,98 @@
-import { existsSync, lstatSync, readFileSync, readdirSync, readlinkSync } from "node:fs"
-import { homedir } from "node:os"
-import { dirname, join, resolve } from "node:path"
-import { pluginUserScopeInstalled } from "./engine-native/claudePlugins"
-import { COPY_MARKER } from "./engine-native/skillsSync"
-import { payloadText } from "./payload"
+import { existsSync, lstatSync, readFileSync, readdirSync, readlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { pluginUserScopeInstalled } from "./engine-native/claudePluginPasses";
+import { COPY_MARKER } from "./engine-native/skillsSync";
+import { payloadText } from "./payload";
 
-export { homedir }
+export { homedir };
 
-export type Tool = "claude" | "codex"
+export type Tool = "claude" | "codex";
 
-const readJson = (path: string): any => JSON.parse(readFileSync(path, "utf8"))
-const readJsonText = (text: string): any => JSON.parse(text)
+const readJson = (path: string): any => JSON.parse(readFileSync(path, "utf8"));
+const readJsonText = (text: string): any => JSON.parse(text);
 
 /** SoT settings (claude) — model/effort/env for drift display. */
-export const sotClaudeSettings = (): any =>
-  readJsonText(payloadText("SoT/.claude/settings.json"))
+export const sotClaudeSettings = (): any => readJsonText(payloadText("SoT/.claude/settings.json"));
 
 export const deployedClaudeSettings = (): any | undefined => {
-  const p = join(homedir(), ".claude", "settings.json")
-  return existsSync(p) ? readJson(p) : undefined
-}
+  const p = join(homedir(), ".claude", "settings.json");
+  return existsSync(p) ? readJson(p) : undefined;
+};
 
 export function topLevelTomlString(text: string, setting: string): string | undefined {
   for (const line of text.split(/\r?\n/)) {
-    if (/^\s*\[/.test(line)) return undefined
-    const assignment = line.match(/^\s*([A-Za-z0-9_-]+)\s*=\s*"([^"]+)"/)
-    if (assignment?.[1] === setting) return assignment[2]
+    if (/^\s*\[/.test(line)) return undefined;
+    const assignment = line.match(/^\s*([A-Za-z0-9_-]+)\s*=\s*"([^"]+)"/);
+    if (assignment?.[1] === setting) return assignment[2];
   }
-  return undefined
+  return undefined;
 }
 
 const tomlModel = (path: string): string | undefined => {
-  if (!existsSync(path)) return undefined
-  return topLevelTomlString(readFileSync(path, "utf8"), "model")
-}
+  if (!existsSync(path)) return undefined;
+  return topLevelTomlString(readFileSync(path, "utf8"), "model");
+};
 
 export const sotCodexModel = (): string | undefined =>
-  topLevelTomlString(payloadText("SoT/.codex/config.toml"), "model")
+  topLevelTomlString(payloadText("SoT/.codex/config.toml"), "model");
 
 export const deployedCodexModel = (): string | undefined =>
-  tomlModel(join(homedir(), ".codex", "config.toml"))
+  tomlModel(join(homedir(), ".codex", "config.toml"));
 
 /** Installed plugins (user scope) vs SoT enabledPlugins tri-state. */
 export const pluginsView = (): Array<{
-  plugin: string
-  sot: "true" | "false" | "absent"
-  installed: boolean
+  plugin: string;
+  sot: "true" | "false" | "absent";
+  installed: boolean;
 }> => {
-  const sot: Record<string, boolean> = sotClaudeSettings().enabledPlugins ?? {}
-  const installedPath = join(homedir(), ".claude", "plugins", "installed_plugins.json")
+  const sot: Record<string, boolean> = sotClaudeSettings().enabledPlugins ?? {};
+  const installedPath = join(homedir(), ".claude", "plugins", "installed_plugins.json");
   const installed: Record<string, unknown> = existsSync(installedPath)
-    ? readJson(installedPath).plugins ?? {}
-    : {}
-  const names = new Set([...Object.keys(sot), ...Object.keys(installed)])
+    ? (readJson(installedPath).plugins ?? {})
+    : {};
+  const names = new Set([...Object.keys(sot), ...Object.keys(installed)]);
   return [...names].sort().map((plugin) => ({
     plugin,
     sot: plugin in sot ? (sot[plugin] ? "true" : "false") : "absent",
-    installed: pluginUserScopeInstalled(installedPath, plugin)
-  }))
-}
+    installed: pluginUserScopeInstalled(installedPath, plugin),
+  }));
+};
 
 /** Universal skills: SoT manifest slugs vs ~/.agents/skills contents. */
 export const skillsView = (): Array<{
-  skill: string
-  declared: boolean
-  installed: boolean
+  skill: string;
+  declared: boolean;
+  installed: boolean;
   /** Claude entry resolves to the canonical skill by symlink, junction, or kit-created copy. */
-  claudeSymlink: boolean
+  claudeSymlink: boolean;
 }> => {
   const declared = payloadText("SoT/.agents/skills.txt")
     .split("\n")
     .map((l) => l.replace(/#.*$/, "").trim())
     .filter((l) => l.length > 0)
-    .map((slug) => slug.split("/").pop() as string)
-  const home = homedir()
-  const skillsDir = join(home, ".agents", "skills")
+    .map((slug) => slug.split("/").pop() as string);
+  const home = homedir();
+  const skillsDir = join(home, ".agents", "skills");
   const installed = existsSync(skillsDir)
     ? readdirSync(skillsDir, { withFileTypes: true })
         .filter((e) => e.isDirectory())
         .map((e) => e.name)
-    : []
-  const names = new Set([...declared, ...installed])
+    : [];
+  const names = new Set([...declared, ...installed]);
   return [...names].sort().map((skill) => {
-    const link = join(home, ".claude", "skills", skill)
-    const canonical = resolve(skillsDir, skill)
-    let claudeSymlink = false
+    const link = join(home, ".claude", "skills", skill);
+    const canonical = resolve(skillsDir, skill);
+    let claudeSymlink = false;
     try {
-      const target = resolve(dirname(link), readlinkSync(link))
-      claudeSymlink = target === canonical && existsSync(target)
+      const target = resolve(dirname(link), readlinkSync(link));
+      claudeSymlink = target === canonical && existsSync(target);
     } catch {
       /* not a symlink or missing */
     }
     if (!claudeSymlink && installed.includes(skill)) {
       try {
-        claudeSymlink = lstatSync(link).isDirectory() && existsSync(join(link, COPY_MARKER))
+        claudeSymlink = lstatSync(link).isDirectory() && existsSync(join(link, COPY_MARKER));
       } catch {
         /* missing Claude entry */
       }
@@ -102,7 +101,7 @@ export const skillsView = (): Array<{
       skill,
       declared: declared.includes(skill),
       installed: installed.includes(skill),
-      claudeSymlink
-    }
-  })
-}
+      claudeSymlink,
+    };
+  });
+};

package/cli/src/md.d.ts

@@ -1,4 +1,4 @@
 declare module "*.md" {
-  const content: string
-  export default content
+  const content: string;
+  export default content;
 }

package/cli/src/payload.ts

@@ -1,25 +1,25 @@
 import {
   GENERATED_PAYLOAD_BASE64,
   GENERATED_PAYLOAD_PATHS,
-  GENERATED_PAYLOAD_TEXT
-} from "./generated/sotPayload"
+  GENERATED_PAYLOAD_TEXT,
+} from "./generated/sotPayload";
 
-export type PayloadPath = typeof GENERATED_PAYLOAD_PATHS[number]
-type TextPayloadPath = Exclude<PayloadPath, "notification.mp3">
+export type PayloadPath = (typeof GENERATED_PAYLOAD_PATHS)[number];
+type TextPayloadPath = Exclude<PayloadPath, "notification.mp3">;
 
 export function payloadText(path: TextPayloadPath): string {
-  return GENERATED_PAYLOAD_TEXT[path]
+  return GENERATED_PAYLOAD_TEXT[path];
 }
 
 export function payloadBytes(path: PayloadPath): Buffer {
-  if (path === "notification.mp3") return Buffer.from(GENERATED_PAYLOAD_BASE64[path], "base64")
-  return Buffer.from(payloadText(path))
+  if (path === "notification.mp3") return Buffer.from(GENERATED_PAYLOAD_BASE64[path], "base64");
+  return Buffer.from(payloadText(path));
 }
 
 export function payloadPaths(prefix: string): ReadonlyArray<PayloadPath> {
-  return GENERATED_PAYLOAD_PATHS.filter((path) => path.startsWith(prefix))
+  return GENERATED_PAYLOAD_PATHS.filter((path) => path.startsWith(prefix));
 }
 
 export function payloadDisplayPath(path: PayloadPath): string {
-  return `embedded:${path}`
+  return `embedded:${path}`;
 }

package/cli/src/services.ts

@@ -4,9 +4,14 @@
  * named test-layer constructors. Composed ONCE at main.ts — command code
  * accesses services via `yield*`, never by re-providing.
  */
-import { Context, Layer } from "effect"
-import { makeLogger, type Logger, type LoggerSinks } from "./engine-native/logger"
-import { makeEngineServices, makePlatform, type DependencyManager, type Platform } from "./engine-native/services"
+import { Context, Layer } from "effect";
+import { makeLogger, type Logger, type LoggerSinks } from "./engine-native/logger";
+import {
+  makeEngineServices,
+  makePlatform,
+  type DependencyManager,
+  type Platform,
+} from "./engine-native/services";
 
 export class LoggerService extends Context.Service<LoggerService, Logger>()("docks-kit/Logger") {}
 
@@ -15,20 +20,23 @@ export class DependencyManagerService extends Context.Service<
   DependencyManager
 >()("docks-kit/DependencyManager") {}
 
-export class PlatformService extends Context.Service<PlatformService, Platform>()("docks-kit/Platform") {}
+export class PlatformService extends Context.Service<PlatformService, Platform>()(
+  "docks-kit/Platform",
+) {}
 
-const live = makeEngineServices()
+const live = makeEngineServices();
 
-export const LoggerLive = Layer.succeed(LoggerService, live.logger)
-export const DependencyManagerLive = Layer.succeed(DependencyManagerService, live.deps)
-export const PlatformLive = Layer.succeed(PlatformService, live.platform)
-export const EngineServicesLive = Layer.mergeAll(LoggerLive, DependencyManagerLive, PlatformLive)
+export const LoggerLive = Layer.succeed(LoggerService, live.logger);
+export const DependencyManagerLive = Layer.succeed(DependencyManagerService, live.deps);
+export const PlatformLive = Layer.succeed(PlatformService, live.platform);
+export const EngineServicesLive = Layer.mergeAll(LoggerLive, DependencyManagerLive, PlatformLive);
 
 export const LoggerTest = (sinks: LoggerSinks): Layer.Layer<LoggerService> =>
-  Layer.succeed(LoggerService, makeLogger(sinks))
+  Layer.succeed(LoggerService, makeLogger(sinks));
 
 export const PlatformTest = (pf: NodeJS.Platform): Layer.Layer<PlatformService> =>
-  Layer.succeed(PlatformService, makePlatform(pf))
+  Layer.succeed(PlatformService, makePlatform(pf));
 
-export const DependencyManagerTest = (impl: DependencyManager): Layer.Layer<DependencyManagerService> =>
-  Layer.succeed(DependencyManagerService, impl)
+export const DependencyManagerTest = (
+  impl: DependencyManager,
+): Layer.Layer<DependencyManagerService> => Layer.succeed(DependencyManagerService, impl);

package/cli/tsconfig.json

@@ -6,9 +6,12 @@
     "types": ["bun"],
     "strict": true,
     "noEmit": true,
+    "allowJs": true,
+    "checkJs": true,
+    "allowImportingTsExtensions": true,
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true,
     "verbatimModuleSyntax": true
   },
-  "include": ["src/**/*.ts", "src/**/*.d.ts", "test/**/*.ts", "scripts/**/*.ts"]
+  "include": ["src/**/*.ts", "src/**/*.d.ts", "test/**/*.ts", "scripts/**/*.ts", "test/statusline-runtime-smoke.mjs", "../SoT/.claude/bin/*.mjs"]
 }

package/docks-kit

@@ -37,9 +37,20 @@ if [[ -x "$REPO_DIR/cli/dist/$KIT_BIN" ]]; then
   BIN_VERSION="$("$REPO_DIR/cli/dist/$KIT_BIN" --version 2>/dev/null || true)"
   BIN_VERSION="${BIN_VERSION%$'\r'}"
   if [[ -n "$CHECKOUT_VERSION" && "$BIN_VERSION" == "$CHECKOUT_VERSION" ]]; then
-    exec "$REPO_DIR/cli/dist/$KIT_BIN" "$@"
+    # A matching version does not prove matching content. Unreleased work does
+    # not move package.json, so a binary compiled before it still reports the
+    # checkout version and would silently shadow the source it predates.
+    NEWER_SOURCE=""
+    if [[ -d "$REPO_DIR/cli/src" ]]; then
+      NEWER_SOURCE="$(find "$REPO_DIR/cli/src" -type f -newer "$REPO_DIR/cli/dist/$KIT_BIN" -print -quit 2>/dev/null || true)"
+    fi
+    if [[ -z "$NEWER_SOURCE" ]]; then
+      exec "$REPO_DIR/cli/dist/$KIT_BIN" "$@"
+    fi
+    echo "[docks-kit] ignoring cli/dist/$KIT_BIN; ${NEWER_SOURCE#"$REPO_DIR/"} is newer than the binary — running from source; run 'bun run build:binaries' to refresh it or delete it" >&2
+  else
+    echo "[docks-kit] ignoring stale cli/dist/$KIT_BIN ${BIN_VERSION:-<unknown>}; checkout is ${CHECKOUT_VERSION:-<unknown>} — running from source; run 'bun run build:binaries' to refresh it or delete it" >&2
   fi
-  echo "[docks-kit] ignoring stale cli/dist/$KIT_BIN ${BIN_VERSION:-<unknown>}; checkout is ${CHECKOUT_VERSION:-<unknown>} — running from source" >&2
 fi
 
 # Locate bun: PATH, then the known install locations that sit off the

package/docks-kit.ps1

@@ -56,13 +56,28 @@ if (Test-Path -LiteralPath $KitPath -PathType Leaf) {
   }
 
   if (-not [string]::IsNullOrEmpty($CheckoutVersion) -and $BinVersion -eq $CheckoutVersion) {
-    & $KitPath @args
-    exit $LASTEXITCODE
+    # A matching version does not prove matching content. Unreleased work does
+    # not move package.json, so a binary compiled before it still reports the
+    # checkout version and would silently shadow the source it predates.
+    $NewerSource = $null
+    $SrcDir = Join-Path $RepoDir 'cli\src'
+    if (Test-Path -LiteralPath $SrcDir -PathType Container) {
+      $BinWritten = (Get-Item -LiteralPath $KitPath).LastWriteTimeUtc
+      $NewerSource = Get-ChildItem -LiteralPath $SrcDir -Recurse -File -ErrorAction SilentlyContinue |
+        Where-Object { $_.LastWriteTimeUtc -gt $BinWritten } |
+        Select-Object -First 1
+    }
+    if ($null -eq $NewerSource) {
+      & $KitPath @args
+      exit $LASTEXITCODE
+    }
+    $NewerRelative = $NewerSource.FullName.Substring($RepoDir.Length).TrimStart('\', '/')
+    [Console]::Error.WriteLine("[docks-kit] ignoring cli/dist/$KitBin; $NewerRelative is newer than the binary — running from source; run 'bun run build:binaries' to refresh it or delete it")
+  } else {
+    $DisplayedBinVersion = if ([string]::IsNullOrEmpty($BinVersion)) { '<unknown>' } else { $BinVersion }
+    $DisplayedCheckoutVersion = if ([string]::IsNullOrEmpty($CheckoutVersion)) { '<unknown>' } else { $CheckoutVersion }
+    [Console]::Error.WriteLine("[docks-kit] ignoring stale cli/dist/$KitBin $DisplayedBinVersion; checkout is $DisplayedCheckoutVersion — running from source; run 'bun run build:binaries' to refresh it or delete it")
   }
-
-  $DisplayedBinVersion = if ([string]::IsNullOrEmpty($BinVersion)) { '<unknown>' } else { $BinVersion }
-  $DisplayedCheckoutVersion = if ([string]::IsNullOrEmpty($CheckoutVersion)) { '<unknown>' } else { $CheckoutVersion }
-  [Console]::Error.WriteLine("[docks-kit] ignoring stale cli/dist/$KitBin $DisplayedBinVersion; checkout is $DisplayedCheckoutVersion — running from source")
 }
 
 function Find-Bun {