halfcycle 0.3.40 → 0.4.1

package/dist/claude-version-probe.d.ts

@@ -41,4 +41,36 @@ export interface ClaudeVersionProbeDeps {
  * callers' degradation (say nothing) depends on that.
  */
 export declare function probeClaudeCodeVersion(timeoutMs: number, deps?: ClaudeVersionProbeDeps): string | undefined;
+/** The four install methods `npx halfcycle`'s own download page names, and the one
+ *  command that upgrades each. */
+export type ClaudeInstallMethod = 'winget' | 'npm' | 'brew' | 'native';
+export declare const CLAUDE_CODE_INSTALL_PAGE = "https://claude.com/claude-code";
+export declare const UPGRADE_COMMANDS: Readonly<Record<ClaudeInstallMethod, string>>;
+export interface ClaudeInstallMethodDeps {
+    /** Defaults to `process.env`. */
+    readonly env?: NodeJS.ProcessEnv;
+    /** Defaults to `process.platform`. */
+    readonly platform?: NodeJS.Platform;
+    /** Defaults to `existsSync`. Inject so a test can name which files exist without a real PATH. */
+    readonly exists?: (file: string) => boolean;
+    /** Defaults to `realpathSync`, falling back to its own argument on failure. Inject to assert a
+     *  symlink target without creating a real one. */
+    readonly realpath?: (file: string) => string;
+}
+/**
+ * BEST-EFFORT: which of the four install methods put `claude` on this PATH, or
+ * `undefined` when it cannot be told — `claude` is not on PATH at all (the caller
+ * already has its own answer for "not found"), or it is there but resolves to a
+ * real path none of the four patterns match (a developer's own symlink, a
+ * corporate image, an install layout this probe has never seen). The caller's own
+ * rule for that case is "give the one generic line rather than guessing" — this
+ * function does not guess either, and returns `undefined` rather than defaulting
+ * to any one method.
+ *
+ * Scans PATH for `claude`, or `claude.cmd`/`claude.exe` on Windows (an npm install
+ * puts the former on PATH, the native installer the latter — same asymmetry
+ * `probeClaudeCodeVersion`'s own header documents), the same way `hasGitBash`
+ * (`pre-create-checks.ts`) scans it for `git.exe`. Spawns nothing.
+ */
+export declare function probeClaudeCodeInstallMethod(deps?: ClaudeInstallMethodDeps): ClaudeInstallMethod | undefined;
 //# sourceMappingURL=claude-version-probe.d.ts.map

package/dist/claude-version-probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-version-probe.d.ts","sourceRoot":"","sources":["../src/claude-version-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH;0DAC0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IACP,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CAC7C,KACE,MAAM,CAAC;AAEZ,MAAM,WAAW,sBAAsB;IACrC,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IACpC,sFAAsF;IACtF,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B,GAAG,MAAM,GAAG,SAAS,CAqB/G"}
+{"version":3,"file":"claude-version-probe.d.ts","sourceRoot":"","sources":["../src/claude-version-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH;0DAC0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IACP,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CAC7C,KACE,MAAM,CAAC;AAEZ,MAAM,WAAW,sBAAsB;IACrC,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IACpC,sFAAsF;IACtF,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B,GAAG,MAAM,GAAG,SAAS,CAqB/G;AAMD;kCACkC;AAClC,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvE,eAAO,MAAM,wBAAwB,mCAAmC,CAAC;AAEzE,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAK1E,CAAC;AAaF,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IACpC,iGAAiG;IACjG,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C;sDACkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,GAAE,uBAA4B,GAAG,mBAAmB,GAAG,SAAS,CAwBhH"}