Merge branch 'main' into codex/crestodian-provider-onboarding

fuller-stack-dev · web-flow · commit 96122b35d4bf · 2026-07-07T18:24:19.000-06:00
diff --git a/docs/install/installer.md b/docs/install/installer.md
@@ -85,10 +85,10 @@ Recommended for most interactive installs on macOS/Linux/WSL.
 
   </Step>
   <Step title="Post-install tasks">
-    - Refreshes a loaded gateway service best-effort (`openclaw gateway install --force`, then restart)
-    - Runs `openclaw doctor --non-interactive` on upgrades and git installs (best effort)
-    - Attempts onboarding when appropriate (TTY available, onboarding not disabled, and bootstrap/config checks pass)
-    - Runs a post-install smoke verify when `--verify` is set
+    - Resolves the just-installed `openclaw` binary for follow-up commands
+    - For an unconfigured install, starts onboarding before doctor or gateway probes. With `--no-onboard` or no TTY, it prints the command to finish setup later.
+    - For a configured install, refreshes and restarts a loaded gateway service best-effort and runs doctor. Upgrades update plugins when possible, or print the manual command in a headless prompt-enabled run.
+    - When `--verify` runs, it checks the installed version and checks gateway health only after configuration exists.
 
   </Step>
 </Steps>
diff --git a/extensions/oc-path/src/cli.ts b/extensions/oc-path/src/cli.ts
@@ -38,7 +38,7 @@ export type OutputRuntimeEnv = {
   exit(code: number): void;
 };
 
-export interface PathCommandOptions {
+interface PathCommandOptions {
   readonly json?: boolean;
   readonly human?: boolean;
   readonly valueJson?: boolean;
diff --git a/extensions/oc-path/src/oc-path/edit.ts b/extensions/oc-path/src/oc-path/edit.ts
@@ -13,7 +13,7 @@ import type { AstBlock, AstItem, FrontmatterEntry, MdAst } from "./ast.js";
 import { formatOcPath, type OcPath } from "./oc-path.js";
 import { guardSentinel } from "./sentinel.js";
 
-export type MdEditResult =
+type MdEditResult =
   | { readonly ok: true; readonly ast: MdAst }
   | {
       readonly ok: false;
diff --git a/extensions/oc-path/src/oc-path/jsonc/edit.ts b/extensions/oc-path/src/oc-path/jsonc/edit.ts
@@ -15,7 +15,7 @@ import { parseJsonc } from "./parse.js";
 
 type JsoncEditPath = Array<string | number>;
 
-export type JsoncEditResult =
+type JsoncEditResult =
   | { readonly ok: true; readonly ast: JsoncAst }
   | { readonly ok: false; readonly reason: "unresolved" | "no-root" };
 
diff --git a/extensions/oc-path/src/oc-path/jsonc/resolve-value.ts b/extensions/oc-path/src/oc-path/jsonc/resolve-value.ts
@@ -2,7 +2,7 @@
 import { isPositionalSeg, parseArrayIndexSegment, resolvePositionalSeg } from "../oc-path.js";
 import type { JsoncEntry, JsoncValue } from "./ast.js";
 
-export type JsoncValueOcPathMatch =
+type JsoncValueOcPathMatch =
   | { readonly kind: "value"; readonly node: JsoncValue; readonly path: readonly string[] }
   | {
       readonly kind: "object-entry";
diff --git a/extensions/oc-path/src/oc-path/jsonc/resolve.ts b/extensions/oc-path/src/oc-path/jsonc/resolve.ts
@@ -11,7 +11,7 @@ import { isQuotedSeg, splitRespectingBrackets, unquoteSeg } from "../oc-path.js"
 import type { JsoncAst, JsoncEntry, JsoncValue } from "./ast.js";
 import { resolveJsoncValueOcPath } from "./resolve-value.js";
 
-export type JsoncOcPathMatch =
+type JsoncOcPathMatch =
   | { readonly kind: "root"; readonly node: JsoncAst }
   | { readonly kind: "value"; readonly node: JsoncValue; readonly path: readonly string[] }
   | {
diff --git a/extensions/oc-path/src/oc-path/jsonl/edit.ts b/extensions/oc-path/src/oc-path/jsonl/edit.ts
@@ -18,7 +18,7 @@ import {
 import type { JsonlAst, JsonlLine } from "./ast.js";
 import { emitJsonl } from "./emit.js";
 
-export type JsonlEditResult =
+type JsonlEditResult =
   | { readonly ok: true; readonly ast: JsonlAst }
   | { readonly ok: false; readonly reason: "unresolved" | "not-a-value-line" };
 
diff --git a/extensions/oc-path/src/oc-path/jsonl/resolve.ts b/extensions/oc-path/src/oc-path/jsonl/resolve.ts
@@ -22,7 +22,7 @@ import { isQuotedSeg, splitRespectingBrackets, unquoteSeg } from "../oc-path.js"
 import type { JsonlAst, JsonlLine } from "./ast.js";
 import { pickJsonlLine } from "./line.js";
 
-export type JsonlOcPathMatch =
+type JsonlOcPathMatch =
   | { readonly kind: "root"; readonly node: JsonlAst }
   | { readonly kind: "line"; readonly node: JsonlLine }
   | {
diff --git a/extensions/oc-path/src/oc-path/oc-path.ts b/extensions/oc-path/src/oc-path/oc-path.ts
@@ -459,7 +459,7 @@ export function parseUnionSeg(seg: string): readonly string[] | null {
  * Value predicate `[key<op>value]`. Operators: `=` `!=` (string),
  * `<` `<=` `>` `>=` (numeric). Multi-char tried before single-char.
  */
-export type PredicateOp = "=" | "!=" | "<" | "<=" | ">" | ">=";
+type PredicateOp = "=" | "!=" | "<" | "<=" | ">" | ">=";
 
 const PREDICATE_OPS: readonly PredicateOp[] = ["!=", "<=", ">=", "<", ">", "="];
 
diff --git a/extensions/oc-path/src/oc-path/universal.ts b/extensions/oc-path/src/oc-path/universal.ts
@@ -99,7 +99,7 @@ export type SetResult =
       readonly detail?: string;
     };
 
-export type SetOcPathOptions = {
+type SetOcPathOptions = {
   readonly valueJson?: boolean;
 };
 
diff --git a/extensions/oc-path/src/oc-path/yaml/edit.ts b/extensions/oc-path/src/oc-path/yaml/edit.ts
@@ -22,7 +22,7 @@ import {
 import { guardSentinel } from "../sentinel.js";
 import type { YamlAst } from "./ast.js";
 
-export type YamlEditResult =
+type YamlEditResult =
   | { readonly ok: true; readonly ast: YamlAst }
   | {
       readonly ok: false;
diff --git a/extensions/oc-path/src/oc-path/yaml/resolve.ts b/extensions/oc-path/src/oc-path/yaml/resolve.ts
@@ -11,7 +11,7 @@ import {
 } from "../oc-path.js";
 import type { YamlAst } from "./ast.js";
 
-export type YamlOcPathMatch =
+type YamlOcPathMatch =
   | { readonly kind: "root"; readonly node: YamlAst }
   | { readonly kind: "scalar"; readonly value: unknown; readonly path: readonly string[] }
   | {
diff --git a/scripts/install.sh b/scripts/install.sh
diff --git a/test/scripts/install-sh.test.ts b/test/scripts/install-sh.test.ts
