javi-forge 1.37.0 → 1.38.0

package/ci-local/install.ps1

@@ -7,7 +7,7 @@
 #   .\install.ps1
 #
 # Behaviour MUST match install.sh. Diff against the bash version on every
-# change. Test on real Windows + WSL + macOS pwsh before tagging a release.
+# change. Test on supported Windows and WSL hosts before tagging a release.
 # =============================================================================
 
 #Requires -Version 7.2
@@ -15,19 +15,36 @@
 param()
 
 function Invoke-CiLocalMain {
-    param([Parameter(Mandatory)][string]$Platform)
-
-    if ($Platform -eq 'Darwin') {
-        Write-Host 'macOS is deprecated and unsupported for new CI-Local install/startup. Pin a supported release or migrate. Existing installed guards are not removed; Darwin code removal is planned separately for 2.0.'
+    param(
+        [Parameter(Mandatory)][string]$Platform,
+        [ref]$ExitCode
+    )
+
+    if ($Platform -notin @('Linux', 'Windows')) {
+        Write-Host 'unsupported-platform: javi-forge supports Linux and Windows only.'
+        if ($PSBoundParameters.ContainsKey('ExitCode')) {
+            $ExitCode.Value = 1
+            return
+        }
         return 1
     }
 
-    Invoke-CiLocalStartupBody -Platform $Platform
+    $bodyExitCode = 0
+    & ${function:Invoke-CiLocalStartupBody} -Platform $Platform -ExitCode ([ref]$bodyExitCode)
+    if ($PSBoundParameters.ContainsKey('ExitCode')) {
+        $ExitCode.Value = $bodyExitCode
+    } elseif ($bodyExitCode -ne 0) {
+        return $bodyExitCode
+    }
 }
 
 function Invoke-CiLocalStartupBody {
-    param([string]$Platform)
+    param(
+        [string]$Platform,
+        [ref]$ExitCode
+    )
 
+    $ExitCode.Value = 0
 # Defense-in-depth: #Requires is parsed by some hosts AFTER the script body.
 # 7.2 is the minimum because FileSystemInfo.ResolveLinkTarget($true) is .NET 6+,
 # which shipped with pwsh 7.2. Earlier pwsh 7.x runs on .NET 5 and the method
@@ -159,9 +176,11 @@ try {
 
     $jfVersionOk     = $true
     $jfVersionOutput = ''
+    $jfVersionExitCode = 1
     try {
         $jfVersionOutput = (& javi-forge --version 2>&1) -join "`n"
-        if ($LASTEXITCODE -ne 0) { $jfVersionOk = $false }
+        $jfVersionExitCode = $LASTEXITCODE
+        if ($jfVersionExitCode -ne 0) { $jfVersionOk = $false }
     } catch {
         $jfVersionOk     = $false
         $jfVersionOutput = $_.Exception.Message
@@ -177,7 +196,8 @@ try {
         Write-Host "ERROR: javi-forge found at $jfPath but '--version' failed" -ForegroundColor Red
         Write-Host "Output: $jfVersionOutput" -ForegroundColor Yellow
         Write-Host 'Reinstall: npm install -g javi-forge' -ForegroundColor Cyan
-        exit 1
+        $ExitCode.Value = $jfVersionExitCode
+        return
     }
 
     # Reject UNC / remote paths outright — a javi-forge symlinked to
@@ -297,12 +317,13 @@ try {
     & git config core.hooksPath $hooksRel
     if ($LASTEXITCODE -ne 0) {
         Write-Host 'ERROR: failed to set core.hooksPath. Are you inside a git repo?' -ForegroundColor Red
-        exit 1
+        $ExitCode.Value = $LASTEXITCODE
+        return
     }
     Write-Host "hooksPath = $hooksRel" -ForegroundColor Green
 
     # Make hooks executable. Different OS, different model:
-    #   - macOS / Linux / WSL: chmod 0755 — POSIX bits, what git expects.
+    #   - Linux / WSL: chmod 0755 — POSIX bits, what git expects.
     #   - Windows native NTFS: chmod is a no-op; lock the ACL via icacls so
     #     only the current user can rewrite the hooks between commits.
     if (Test-CommandExists -Name 'chmod') {
@@ -382,9 +403,10 @@ try {
 }
 
 if ($MyInvocation.InvocationName -ne '.') {
-    $platform = if ($IsMacOS) { 'Darwin' } else { 'Windows' }
-    $exitCode = & ${function:Invoke-CiLocalMain} -Platform $platform
-    if ($exitCode -is [int] -and $exitCode -ne 0) {
+    $platform = if ($IsWindows) { 'Windows' } elseif ($IsLinux) { 'Linux' } else { 'unsupported' }
+    $exitCode = 0
+    & ${function:Invoke-CiLocalMain} -Platform $platform -ExitCode ([ref]$exitCode)
+    if ($exitCode -ne 0) {
         exit $exitCode
     }
 }

package/ci-local/install.sh

@@ -3,22 +3,40 @@
 # CI-LOCAL: Installation Script
 # =============================================================================
 
-function ci_local_main() {
+
+CI_LOCAL_ENTRYPOINT_SOURCE="${BASH_SOURCE[0]}"
+if [[ "$CI_LOCAL_ENTRYPOINT_SOURCE" == /* ]]; then
+    CI_LOCAL_ENTRYPOINT_PATH="$CI_LOCAL_ENTRYPOINT_SOURCE"
+else
+    CI_LOCAL_ENTRYPOINT_PATH="$PWD/$CI_LOCAL_ENTRYPOINT_SOURCE"
+fi
+CI_LOCAL_ENTRYPOINT_DIR="${CI_LOCAL_ENTRYPOINT_PATH%/*}"
+
+function ci_local_normalize_platform() {
     local platform="${1:?platform required}"
 
-    if [ "$platform" = "Darwin" ]; then
-        printf '%s\n' 'macOS is deprecated and unsupported for new CI-Local install/startup. Pin a supported release or migrate. Existing installed guards are not removed; Darwin code removal is planned separately for 2.0.'
-        return 1
-    fi
+    case "$platform" in
+        MINGW*_NT-*|MSYS*|CYGWIN*) printf '%s\n' 'Windows' ;;
+        *) printf '%s\n' "$platform" ;;
+    esac
+}
 
-    ci_local_startup_body "$platform"
+function ci_local_main() {
+    local platform
+    platform="$(ci_local_normalize_platform "${1:?platform required}")"
+    shift
+
+    case "$platform" in
+        Linux|Windows) ci_local_startup_body "$@" ;;
+        *) printf '%s\n' 'unsupported-platform: javi-forge supports Linux and Windows only.'; return 1 ;;
+    esac
 }
 
 function ci_local_startup_body() {
     set -e
 
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+SCRIPT_DIR="$CI_LOCAL_ENTRYPOINT_DIR"
+PROJECT_DIR="${SCRIPT_DIR%/*}"
 
 # ─── Required tools (fail-closed) ──────────────────────────────────
 # realpath is load-bearing for the symlink-traversal checks below. If it's
@@ -27,7 +45,6 @@ PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
 if ! command -v realpath >/dev/null 2>&1; then
     printf 'ERROR: realpath is required for ci-local install (symlink checks).\n' >&2
     printf '  Linux/WSL: install coreutils\n' >&2
-    printf '  macOS:     brew install coreutils, then add gnubin to PATH\n' >&2
     exit 1
 fi
 
@@ -208,5 +225,5 @@ echo -e ""
 }
 
 if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
-    ci_local_main "$(/usr/bin/uname -s)"
+    ci_local_main "$(/usr/bin/uname -s)" "$@"
 fi

package/ci-local/lib/common.sh

@@ -39,16 +39,12 @@ log_info() { echo -e "  ${CYAN}[INFO]${NC} $1"; }
 log_step() { echo -e "${YELLOW}$1${NC}"; }
 
 # =============================================================================
-# sed_inplace - Portable sed -i (works on both GNU and BSD/macOS sed)
+# sed_inplace - GNU sed -i for supported Linux/WSL hosts
 # =============================================================================
 # Usage: sed_inplace "s/foo/bar/" file.txt
 # =============================================================================
 sed_inplace() {
-    if sed --version 2>/dev/null | grep -q GNU; then
-        sed -i "$@"
-    else
-        sed -i '' "$@"
-    fi
+    sed -i "$@"
 }
 
 # =============================================================================
@@ -100,7 +96,7 @@ detect_stack() {
         STACK_TYPE="java-gradle"
         BUILD_TOOL="gradle"
 
-        # Detect Java version from build files (compatible with macOS and Linux)
+        # Detect Java version from build files
         if [[ -f "$project_dir/build.gradle.kts" ]]; then
             JAVA_VERSION=$(grep -E 'languageVersion\s*=\s*JavaLanguageVersion\.of\(' "$project_dir/build.gradle.kts" 2>/dev/null | grep -o '[0-9]\+' | head -1 || echo "21")
         elif [[ -f "$project_dir/build.gradle" ]]; then

package/ci-local/uninstall.ps1

@@ -16,6 +16,42 @@ param(
     [switch]$Purge
 )
 
+
+function Invoke-CiLocalMain {
+    param(
+        [Parameter(Mandatory)][string]$Platform,
+        [switch]$RestoreBackups,
+        [switch]$Purge,
+        [ref]$ExitCode
+    )
+
+    if ($Platform -notin @('Linux', 'Windows')) {
+        Write-Host 'unsupported-platform: javi-forge supports Linux and Windows only.'
+        if ($PSBoundParameters.ContainsKey('ExitCode')) {
+            $ExitCode.Value = 1
+            return
+        }
+        return 1
+    }
+
+    $bodyExitCode = 0
+    & ${function:Invoke-CiLocalStartupBody} -Platform $Platform -RestoreBackups:$RestoreBackups -Purge:$Purge -ExitCode ([ref]$bodyExitCode)
+    if ($PSBoundParameters.ContainsKey('ExitCode')) {
+        $ExitCode.Value = $bodyExitCode
+    } elseif ($bodyExitCode -ne 0) {
+        return $bodyExitCode
+    }
+}
+
+function Invoke-CiLocalStartupBody {
+    param(
+        [Parameter(Mandatory)][string]$Platform,
+        [switch]$RestoreBackups,
+        [switch]$Purge,
+        [ref]$ExitCode
+    )
+
+$ExitCode.Value = 0
 Set-StrictMode -Version Latest
 $ErrorActionPreference = 'Stop'
 
@@ -32,6 +68,10 @@ try {
     $current = (& git config --get core.hooksPath 2>$null) -join ''
     if ($current) {
         & git config --unset core.hooksPath
+        if ($LASTEXITCODE -ne 0) {
+            $ExitCode.Value = $LASTEXITCODE
+            return
+        }
         Write-Host "Removed hooksPath = $current" -ForegroundColor Green
     } else {
         Write-Host 'No core.hooksPath was set; nothing to remove' -ForegroundColor Yellow
@@ -83,3 +123,13 @@ try {
 } finally {
     Pop-Location
 }
+}
+
+if ($MyInvocation.InvocationName -ne '.') {
+    $platform = if ($IsWindows) { 'Windows' } elseif ($IsLinux) { 'Linux' } else { 'unsupported' }
+    $exitCode = 0
+    & ${function:Invoke-CiLocalMain} -Platform $platform -RestoreBackups:$RestoreBackups -Purge:$Purge -ExitCode ([ref]$exitCode)
+    if ($exitCode -ne 0) {
+        exit $exitCode
+    }
+}

package/ci-local/uninstall.sh

@@ -13,10 +13,40 @@
 #   ./uninstall.sh --purge               # also rm -rf ci-local/ + lib/common.sh
 # =============================================================================
 
-set -e
 
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+CI_LOCAL_ENTRYPOINT_SOURCE="${BASH_SOURCE[0]}"
+if [[ "$CI_LOCAL_ENTRYPOINT_SOURCE" == /* ]]; then
+    CI_LOCAL_ENTRYPOINT_PATH="$CI_LOCAL_ENTRYPOINT_SOURCE"
+else
+    CI_LOCAL_ENTRYPOINT_PATH="$PWD/$CI_LOCAL_ENTRYPOINT_SOURCE"
+fi
+CI_LOCAL_ENTRYPOINT_DIR="${CI_LOCAL_ENTRYPOINT_PATH%/*}"
+
+function ci_local_normalize_platform() {
+    local platform="${1:?platform required}"
+
+    case "$platform" in
+        MINGW*_NT-*|MSYS*|CYGWIN*) printf '%s\n' 'Windows' ;;
+        *) printf '%s\n' "$platform" ;;
+    esac
+}
+
+function ci_local_main() {
+    local platform
+    platform="$(ci_local_normalize_platform "${1:?platform required}")"
+    shift
+
+    case "$platform" in
+        Linux|Windows) ci_local_startup_body "$@" ;;
+        *) printf '%s\n' 'unsupported-platform: javi-forge supports Linux and Windows only.'; return 1 ;;
+    esac
+}
+
+function ci_local_startup_body() {
+    set -e
+
+SCRIPT_DIR="$CI_LOCAL_ENTRYPOINT_DIR"
+PROJECT_DIR="${SCRIPT_DIR%/*}"
 
 # Source colors if available; degrade gracefully if not.
 if [ -f "$SCRIPT_DIR/../lib/common.sh" ]; then
@@ -93,3 +123,8 @@ fi
 echo -e ""
 echo -e "${GREEN}Uninstall complete!${NC}"
 echo -e ""
+}
+
+if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then
+    ci_local_main "$(/usr/bin/uname -s)" "$@"
+fi

package/dist/cli/bootstrap.d.ts

@@ -0,0 +1,12 @@
+export type BootstrapResult = {
+    state: "supported";
+    exitCode: 0;
+} | {
+    state: "unsupported-platform";
+    exitCode: 1;
+};
+export interface SupportedCli {
+    runCli: () => Promise<void>;
+}
+export declare function bootstrapCli(platform: string, loadSupportedCli: () => Promise<SupportedCli>, refuse: (message: string) => void): Promise<BootstrapResult>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/cli/bootstrap.js

@@ -0,0 +1,12 @@
+import { resolvePlatformSupport } from "../lib/platform-support.js";
+export async function bootstrapCli(platform, loadSupportedCli, refuse) {
+    const refusal = resolvePlatformSupport(platform);
+    if (refusal) {
+        refuse(`${refusal.refusalCode}: ${refusal.guidance}`);
+        return { state: "unsupported-platform", exitCode: 1 };
+    }
+    const supportedCli = await loadSupportedCli();
+    await supportedCli.runCli();
+    return { state: "supported", exitCode: 0 };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/cli/dispatch/simple-renderers.d.ts

@@ -7,8 +7,15 @@
  * Ink + React are already eagerly imported at the entrypoint, so importing the
  * concrete UI components at the top of this file does NOT worsen cold-start.
  */
+import { render } from "ink";
 import type { CLI, RendererCtx } from "./types.js";
-export declare function handleDoctor(_cli: CLI, ctx: RendererCtx): void;
+export interface RendererDeps {
+    platform?: string;
+    render?: typeof render;
+    error?: (message: string) => void;
+    setExitCode?: (code: number) => void;
+}
+export declare function handleDoctor(_cli: CLI, ctx: RendererCtx, deps?: RendererDeps): void;
 export declare function handleAnalyze(cli: CLI, ctx: RendererCtx): void;
 export declare function handleLlmsTxt(cli: CLI, ctx: RendererCtx): void;
 export declare function handlePlugin(cli: CLI, ctx: RendererCtx): void;

package/dist/cli/dispatch/simple-renderers.js

@@ -17,8 +17,17 @@ import Doctor from "../../ui/Doctor.js";
 import LlmsTxt from "../../ui/LlmsTxt.js";
 import Plugin from "../../ui/Plugin.js";
 import { VALID_CI, VALID_MEMORY, VALID_STACKS } from "../validators.js";
-export function handleDoctor(_cli, ctx) {
-    render(React.createElement(CIContextProvider, { isCI: ctx.isCI },
+export function handleDoctor(_cli, ctx, deps = {}) {
+    const platformSupport = resolvePlatformSupport(deps.platform ?? process.platform);
+    if (platformSupport) {
+        (deps.error ?? console.error)(`${platformSupport.refusalCode}: ${platformSupport.guidance}`);
+        (deps.setExitCode ??
+            ((code) => {
+                process.exitCode = code;
+            }))(1);
+        return;
+    }
+    (deps.render ?? render)(React.createElement(CIContextProvider, { isCI: ctx.isCI },
         React.createElement(Doctor, null)), { stdin: ctx.inkStdin });
 }
 export function handleAnalyze(cli, ctx) {

package/dist/cli/main.d.ts

@@ -0,0 +1,2 @@
+export declare function runCli(): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.js

@@ -0,0 +1,85 @@
+import { createRequire } from "node:module";
+import meow from "meow";
+import { handleCi } from "./dispatch/ci.js";
+import { handleHooks } from "./dispatch/hooks.js";
+import { handleSecurity } from "./dispatch/security.js";
+import { handleAnalyze, handleDoctor, handleInitDefault, handleLlmsTxt, handlePlugin, } from "./dispatch/simple-renderers.js";
+import { handleSkillPublish } from "./dispatch/skill-publish.js";
+import { handleSkillsCmd } from "./dispatch/skills-cmd.js";
+import { handleTdd } from "./dispatch/tdd.js";
+import { handleWorkflow } from "./dispatch/workflow.js";
+import { FLAGS_SCHEMA, HELP_TEXT } from "./help.js";
+import { createInkStdin, detectCI, setupUpdateNotifier } from "./runtime.js";
+export async function runCli() {
+    // Check for updates in background (non-blocking, cached 24h)
+    const _require = createRequire(import.meta.url);
+    const pkg = _require("../../package.json");
+    setupUpdateNotifier(pkg);
+    const cli = meow(HELP_TEXT, {
+        importMeta: import.meta,
+        flags: FLAGS_SCHEMA,
+        // Handle --help manually so `ci --help` can show ci-specific usage instead
+        // of the global banner (meow's autoHelp would print + exit before dispatch).
+        autoHelp: false,
+    });
+    const subcommand = cli.input[0] ?? "init";
+    // Global --help: every command except `ci` and `hooks` shows the global banner
+    // here. Those two own their per-command help inside their handlers.
+    if (cli.flags.help && subcommand !== "ci" && subcommand !== "hooks") {
+        console.log(HELP_TEXT);
+        process.exit(0);
+    }
+    const isCI = detectCI(cli.flags);
+    const inkStdin = createInkStdin();
+    switch (subcommand) {
+        case "tdd": {
+            await handleTdd(cli);
+            break;
+        }
+        case "ci": {
+            await handleCi(cli, { inkStdin, isCI });
+            break;
+        }
+        case "hooks": {
+            await handleHooks(cli);
+            break;
+        }
+        case "doctor": {
+            handleDoctor(cli, { inkStdin, isCI });
+            break;
+        }
+        case "analyze": {
+            handleAnalyze(cli, { inkStdin, isCI });
+            break;
+        }
+        case "workflow": {
+            await handleWorkflow(cli);
+            break;
+        }
+        case "llms-txt": {
+            handleLlmsTxt(cli, { inkStdin, isCI });
+            break;
+        }
+        case "plugin": {
+            handlePlugin(cli, { inkStdin, isCI });
+            break;
+        }
+        case "skills": {
+            await handleSkillsCmd(cli, { inkStdin, isCI });
+            break;
+        }
+        case "skill": {
+            await handleSkillPublish(cli);
+            break;
+        }
+        case "security": {
+            await handleSecurity(cli);
+            break;
+        }
+        default: {
+            handleInitDefault(cli, { inkStdin, isCI });
+            break;
+        }
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/commands/claude-hooks.d.ts

@@ -17,6 +17,7 @@ import { doctorClaudePreToolUse, installClaudePreToolUse, repairClaudePreToolUse
 export type ClaudeHookSub = "install" | "doctor" | "repair";
 /** Injectable seams for tests; each defaults to the real implementation. */
 export interface ClaudeHookCmdDeps {
+    platform?: string;
     install?: typeof installClaudePreToolUse;
     doctor?: typeof doctorClaudePreToolUse;
     repair?: typeof repairClaudePreToolUse;

package/dist/commands/claude-hooks.js

@@ -14,6 +14,7 @@
  * current.
  */
 import { doctorClaudePreToolUse, installClaudePreToolUse, repairClaudePreToolUse, } from "../lib/claude-hook-manager.js";
+import { resolvePlatformSupport } from "../lib/platform-support.js";
 import { remediationForMessage } from "../lib/secure-refusal-remediation.js";
 /**
  * Warnings are NON-BLOCKING notices, so they go to stdout under their own
@@ -57,10 +58,13 @@ function renderMutation(verb, result, log, logError) {
     renderWarnings(result.warnings, log);
     return 1;
 }
-function renderDoctor(report, log) {
+function renderDoctor(result, log) {
+    if ("state" in result) {
+        log(`${result.platformSupport.refusalCode}: ${result.platformSupport.guidance}`);
+        return 1;
+    }
+    const report = result;
     log(`doctor claude: ${report.healthy ? "healthy" : "unhealthy"}`);
-    if (report.platformSupport)
-        log(`  platform-support: ${report.platformSupport.state} — ${report.platformSupport.guidance}`);
     log(`  settings: ${report.settings.state} — ${report.settings.detail}`);
     log(`  asset:    ${report.asset.state} — ${report.asset.detail}`);
     log(`  node:     ${report.node.version ?? "unavailable"} (min-satisfied: ${report.node.satisfiesMinimum})`);
@@ -124,6 +128,11 @@ function renderDoctor(report, log) {
 export async function runClaudeHookCommand(sub, projectDir, opts, deps = {}) {
     const log = deps.log ?? ((m) => console.log(m));
     const logError = deps.logError ?? ((m) => console.error(m));
+    const platformSupport = resolvePlatformSupport(deps.platform ?? process.platform);
+    if (platformSupport) {
+        logError(`${platformSupport.refusalCode}: ${platformSupport.guidance}`);
+        return 1;
+    }
     const install = deps.install ?? installClaudePreToolUse;
     const doctor = deps.doctor ?? doctorClaudePreToolUse;
     const repair = deps.repair ?? repairClaudePreToolUse;

package/dist/commands/codex-hooks.d.ts

@@ -13,6 +13,7 @@
 import { doctorCodexPreToolUse, installCodexPreToolUse, repairCodexPreToolUse } from "../lib/codex-hook-manager.js";
 export type CodexHookSub = "install" | "doctor" | "repair";
 export interface CodexHookCmdDeps {
+    platform?: string;
     install?: typeof installCodexPreToolUse;
     doctor?: typeof doctorCodexPreToolUse;
     repair?: typeof repairCodexPreToolUse;

package/dist/commands/codex-hooks.js

@@ -11,6 +11,7 @@
  * install correctly reports blocked until the user grants trust.
  */
 import { doctorCodexPreToolUse, installCodexPreToolUse, repairCodexPreToolUse, } from "../lib/codex-hook-manager.js";
+import { resolvePlatformSupport } from "../lib/platform-support.js";
 function renderWarnings(warnings, log) {
     if (warnings.length === 0)
         return;
@@ -42,10 +43,13 @@ function renderMutation(verb, result, log, logError) {
     renderWarnings(result.warnings, log);
     return 1;
 }
-function renderDoctor(report, log) {
+function renderDoctor(result, log) {
+    if ("state" in result) {
+        log(`${result.platformSupport.refusalCode}: ${result.platformSupport.guidance}`);
+        return 1;
+    }
+    const report = result;
     log(`doctor codex: ${report.healthy ? "healthy" : "unhealthy"}`);
-    if (report.platformSupport)
-        log(`  platform-support: ${report.platformSupport.state} — ${report.platformSupport.guidance}`);
     log(`  hooks.json: ${report.hooksJson.state}`);
     log(`  config:    [features] hooks=${report.config.featuresHooks} (readable: ${report.config.readable})`);
     log(`  trust:     ${report.trust.state}`);
@@ -88,6 +92,11 @@ function renderDoctor(report, log) {
 export async function runCodexHookCommand(sub, _cwd, opts, deps = {}) {
     const log = deps.log ?? ((m) => console.log(m));
     const logError = deps.logError ?? ((m) => console.error(m));
+    const platformSupport = resolvePlatformSupport(deps.platform ?? process.platform);
+    if (platformSupport) {
+        logError(`${platformSupport.refusalCode}: ${platformSupport.guidance}`);
+        return 1;
+    }
     const install = deps.install ?? installCodexPreToolUse;
     const doctor = deps.doctor ?? doctorCodexPreToolUse;
     const repair = deps.repair ?? repairCodexPreToolUse;

package/dist/commands/doctor.d.ts

@@ -1,5 +1,20 @@
+import fs from "fs-extra";
+import { detectStack } from "../lib/common.js";
+import { refreshContextDir } from "../lib/context.js";
+import { execFileAsync } from "../lib/exec.js";
+import { listInstalledPlugins } from "../lib/plugin.js";
 import type { DoctorResult } from "../types/index.js";
 export type CheckStatus = "ok" | "fail" | "skip";
+type DoctorFilesystem = Pick<typeof fs, "pathExists" | "readJson" | "readdir">;
+export interface DoctorDeps {
+    platform?: string;
+    cwd?: () => string;
+    filesystem?: DoctorFilesystem;
+    exec?: typeof execFileAsync;
+    stackDetector?: typeof detectStack;
+    pluginLister?: typeof listInstalledPlugins;
+    contextRefresher?: typeof refreshContextDir;
+}
 interface RemoteInfo {
     host: "github" | "gitlab" | "other";
     owner: string;
@@ -10,6 +25,6 @@ export declare function parseRemote(url: string): RemoteInfo | null;
 /**
  * Run comprehensive health checks for the project and framework.
  */
-export declare function runDoctor(projectDir?: string): Promise<DoctorResult>;
+export declare function runDoctor(projectDir?: string, deps?: DoctorDeps): Promise<DoctorResult>;
 export {};
 //# sourceMappingURL=doctor.d.ts.map