fix(lfg): prepare 0.1.6 setup release

Author: islee23520

README.md

@@ -19,10 +19,9 @@ Not a Grok plugin. Not a runtime. Not a replacement for `lazycodex-ai`.
 | Situation | Command |
 |---|---|
 | First install | `npx @islee23520/lfg setup` |
-| Reinstall or repair | `npx @islee23520/lfg setup --run` |
+| Sync models / preserve healthy existing install | `npx @islee23520/lfg setup --run` |
+| Force reinstall or repair adapter tree | `npx @islee23520/lfg setup --run --force` |
 | Automation | `npx @islee23520/lfg --json setup --run` |
-| Inspect install state | `npx @islee23520/lfg --json doctor` |
-| Show commands | `npx @islee23520/lfg help` |
 
 During interactive setup, `lfg` can read an OpenAI-compatible base URL, fetch `/v1/models`, map model aliases, and ask before writing files.
 
@@ -32,10 +31,11 @@ During interactive setup, `lfg` can read an OpenAI-compatible base URL, fetch `/
 npx @islee23520/lfg setup
 npx @islee23520/lfg --json setup
 npx @islee23520/lfg --json setup --base-url http://127.0.0.1:11434
+npx @islee23520/lfg --json setup --preset grok
+npx @islee23520/lfg --json setup --preset gpt
 npx @islee23520/lfg --json setup --run
 npx @islee23520/lfg setup --run
-npx @islee23520/lfg --json doctor
-npx @islee23520/lfg help
+npx @islee23520/lfg setup --run --force
 ```
 
 ## Development

docs/grok-adapter-ownership.md

@@ -11,7 +11,7 @@
 
 **`@islee23520/lfg` is the single npm surface** for this **omo Grok adapter** (+ built-in extensions). Registry publish contract: [`docs/npm-publish.md`](npm-publish.md) (closes #22).
 
-1. **omo-style Grok adapter** — install/verify semantics comparable to `omo-codex` on `~/.grok` (plugin tree, config merge, agents, hooks, doctor).
+1. **omo-style Grok adapter** — install/verify semantics comparable to `omo-codex` on `~/.grok` (adapter tree, config merge, agents, hooks, verification).
 2. **LFP-equivalent extensions** — capabilities from legacy `@islee23520/lfp` (hooks, agent overrides, optional extra agents) are **re-implemented for Grok** inside lfg — **not** a copy-paste vendor of the LFP package. See `docs/lfp-capability-port.md`.
 
 **`@islee23520/lfp`** remains a separate npm package only if needed for **Codex-only** or legacy consumers; **Grok Build path is `npx @islee23520/lfg setup` only.**
@@ -21,7 +21,7 @@
 | Term | Meaning |
 |------|---------|
 | **`lfgIsPlugin: false`** (JSON) | The **npm CLI** `@islee23520/lfg` is not registered as a Grok plugin name. |
-| **Grok plugin payload** | What `setup --run` installs under `~/.grok` — **omo core + ported extension features**, shipped **by** lfg. |
+| **Grok adapter payload** | What `setup --run` installs under `~/.grok` — **omo core + ported extension features**, shipped **by** lfg. |
 | **LFP (legacy name)** | Reference for **which features to port**; not a subtree copied into this repo. |
 
 ## Homes
@@ -37,7 +37,7 @@ Dual-home is allowed; Grok users are not required to run Codex.
 
 | Capability | Where it lives (target) |
 |------------|-------------------------|
-| Grok install + doctor + cleanup | `plugins/lfg/bin/` + `plugins/lfg/grok-install/` |
+| Grok install + verification + cleanup | `plugins/lfg/bin/` + `plugins/lfg/grok-install/` |
 | Extension hooks / agent overrides | **Ported** per `docs/lfp-capability-port.md` into `plugins/lfg/extensions/` (or grok-install modules) — **new Grok-native code** |
 | omo component parity | Vendor or sync from `oh-my-openagent/packages/omo-codex/plugin` — not duplicate maintenance in lfg forever without sync script |
 | Model discovery | Existing `lfg-models.ts` + `lfg-grok-config.ts` until install owns full merge |
@@ -57,4 +57,4 @@ Dual-home is allowed; Grok users are not required to run Codex.
 
 - Plan: `plans/lfg-omo-grok-build-adapter.md`
 - Port map: `docs/lfp-capability-port.md`
-- Upstream reference: `oh-my-openagent/packages/omo-codex` (Codex); Grok parity owned here
+- Upstream reference: `oh-my-openagent/packages/omo-codex` (Codex); Grok parity owned here

docs/grok-adapter-parity.md

@@ -7,12 +7,12 @@ Status column updated during `plans/lfg-omo-grok-adapter.md` execution.
 | Plugin cache install | `~/.codex/plugins/cache/sisyphuslabs/omo/` | `plugins/lfg/grok-install/` | Implemented (`plugin-cache-install.acceptance.test.ts` #27; `setup-doctor-parity.test.ts` postInstallVerify #21) |
 | `config.toml` merge | `install/config.mjs` | `grok-install` + `lfg-grok-config.ts` | Implemented (`config-single-writer.acceptance.test.ts` #29; `lfg-installer.contract.test.ts`; `lfg-grok-config.endpoints` #24; `grok-config-endpoints-doc.test.ts`; `docs/grok-config-endpoints.md`; `LFG_OWNED_GROK_CONFIG_SECTIONS`) |
 | Agent TOML + preserve reasoning | `install/agents.mjs` | `grok-install/apply-agent-tomls.ts` | Implemented (`agent-tomls.acceptance.test.ts` #30; `apply-agent-tomls.test.ts`; `no-linalab-branding.test.ts`) |
-| Hook trust | `install/hook-trust.mjs` | `grok-install/hook-trust.ts` | Implemented (`hook-trust.acceptance.test.ts` #28; `post-install-verify.test.ts`; doctor `hooksRegistered`) |
+| Hook trust | `install/hook-trust.mjs` | `grok-install/hook-trust.ts` | Implemented (`hook-trust.acceptance.test.ts` #28; `post-install-verify.test.ts`; internal verifier `hooksRegistered`) |
 | Install version stamp | `lazycodex-install.json` | `lfg-install.json` (Grok plugin root) | Implemented (`plugin-cache-install.acceptance.test.ts` #27; `npm-publish-root-contract.test.ts` #22; `publish-gap-evidence-shape.test.ts`) |
-| `doctor` | `src/cli/doctor/checks/codex.ts` | `lfg doctor` | Implemented (`doctor-pack-layout.acceptance.test.ts` #25; `doctor-json-contract.test.ts` #31; `setup-doctor-parity.test.ts` #21; `publish-owner-checklist.test.ts`; `registry-bin-publish-gap.test.ts`; `publishGap` #22) |
-| `cleanup` / `update` | passthrough CLI | `docs/grok-cleanup-update.md` | N/A (`grok-cleanup-update-doc.test.ts` #34; re-run `setup --run` / `doctor`) |
+| Internal verifier | `src/cli/doctor/checks/codex.ts` | `grok-install/doctor.ts` (not public CLI) | Implemented (`doctor-pack-layout.acceptance.test.ts` #25; `doctor-json-contract.test.ts` #31; `setup-doctor-parity.test.ts` #21; `publish-owner-checklist.test.ts`; `registry-bin-publish-gap.test.ts`; `publishGap` #22) |
+| `cleanup` / `update` | passthrough CLI | `docs/grok-cleanup-update.md` | N/A (`grok-cleanup-update-doc.test.ts` #34; re-run `setup --run`) |
 | ulw-loop / start-work skills | plugin components | Grok plugin tree | N/A (brownfield vendored; not owned by `grok-install` adapter) |
-| Project-local `.grok` repair | `project-local-cleanup.mjs` | `grok-install/project-local.ts` | N/A (`lfg project-local` inspect; automated repair deferred — `repair` field in JSON; `lfg-project-local.test.ts` #28) |
+| Project-local `.grok` repair | `project-local-cleanup.mjs` | `grok-install/project-local.ts` | N/A (internal inspect helper; public CLI remains setup-only; automated repair deferred — `repair` field in JSON; `lfg-project-local.test.ts` #28) |
 | Model catalog | `model-catalog.json` | `lfg-models.ts` + `LAZYCODEX_*` | Implemented (`lfg-models.mapping.test.ts`; `lfg-models.urls.test.ts`; setup discovery env) |
 | Autonomous permissions | `permissions.mjs` | N/A or Grok permissions | N/A |
 | Telemetry | plugin telemetry | vendored in tree | N/A (upstream plugin telemetry; lfg does not emit) |
@@ -21,4 +21,4 @@ Status column updated during `plans/lfg-omo-grok-adapter.md` execution.
 | Per-agent model overrides (LFP-style) | LFP `omo-agent-model-overrides` + `agent-config` | `lazycodex-agent-overrides.ts` + `sync-lazycodex-agents-to-grok.ts` | Implemented (`lazycodex-agent-overrides.test.ts`; `~/.grok/lazycodex-agent-overrides.json`; interactive setup) |
 
 **Normative port map:** `docs/lfp-capability-port.md`  
-**Ownership:** `docs/grok-adapter-ownership.md` (ADR; tested in `grok-adapter-ownership-doc.test.ts`)
+**Ownership:** `docs/grok-adapter-ownership.md` (ADR; tested in `grok-adapter-ownership-doc.test.ts`)

docs/grok-cleanup-update.md

@@ -10,13 +10,14 @@ Codex exposes passthrough cleanup/update on `~/.codex`. Grok Build uses `~/.grok
 
 | Action | Surface |
 |--------|---------|
-| Re-install / refresh stamp + fixture tree | `npx @islee23520/lfg --json setup --run` (idempotent internal `runGrokInstall`) |
-| Verify install | `npx @islee23520/lfg --json doctor` |
+| Sync models / preserve healthy stamped adapter tree | `npx @islee23520/lfg --json setup --run` (idempotent internal `runGrokInstall`) |
+| Force re-install / replace adapter tree | `npx @islee23520/lfg --json setup --run --force` |
+| Verify install | Re-run `npx @islee23520/lfg --json setup --run` and inspect the JSON result |
 | Model/config merge | Same `setup --run` with `--base-url` when discovery needed |
 
 ## Not implemented (by design)
 
 - `lfg cleanup` — no automatic wipe of user `~/.grok` blocks; manual edit per Grok user guide.
 - `lfg update` — no separate version pin fetch; use npm bump + `setup --run` after upgrading `@islee23520/lfg`.
 
-Future: optional `lfg --json cleanup --dry-run` reporting paths only (non-destructive).
+Future: optional `lfg --json cleanup --dry-run` reporting paths only (non-destructive).

docs/grok-host-auth.md

@@ -16,8 +16,8 @@
 | 1 | Fix config warnings: re-run `npx @islee23520/lfg --json setup --run` so `endpoints.api_key` is removed — see [`grok-config-endpoints.md`](grok-config-endpoints.md) (#24) |
 | 2 | Interactive: run `grok` and complete sign-in to refresh `~/.grok/auth.json` |
 | 3 | Headless BYOK: set `XAI_API_KEY` or `OPENAI_API_KEY` (and discovery base URL via `lfg setup --run`) |
-| 4 | Verify adapter: `npx @islee23520/lfg --json doctor` on fixture or real HOME after install |
+| 4 | Verify adapter plan: `npx @islee23520/lfg --json setup`; materialize only with explicit `setup --run` |
 
 ## lfg scope
 
-Adapter install (`runGrokInstall`, plugin tree, `config.toml` merge) is independent of Grok OIDC health. Issue #23 tracks **Grok CLI auth infrastructure**, not missing lfg code paths.
+Adapter install (`runGrokInstall`, plugin tree, `config.toml` merge) is independent of Grok OIDC health. Issue #23 tracks **Grok CLI auth infrastructure**, not missing lfg code paths.

docs/lfp-capability-port.md

@@ -11,7 +11,7 @@
 | Extra helper agents (artistry, visual-engineering, etc.) | **Port selectively** — only agents that make sense on Grok Build; rewrite configs, don’t copy TOML verbatim if model IDs differ |
 | `codex-plugin-install.mjs` / Codex marketplace `linalab` | **Do not port** — Grok uses `~/.grok` plugin layout from `grok-install` |
 | OpenAI-compat / cliproxy provider blocks for **Codex** | **Replace** with lfg `LAZYCODEX_*` + `lfg-grok-config.ts` / Grok `[model.*]` |
-| `cli.mjs` setup/doctor for Codex `CODEX_HOME` | **Replace** with `lfg setup` / `lfg doctor` targeting `~/.grok` |
+| `cli.mjs` setup/doctor for Codex `CODEX_HOME` | **Replace** with `lfg setup` targeting `~/.grok`; doctor-style checks stay internal |
 | Sync scripts (`sync-agent-overrides.mjs`, etc.) | **Reimplement** as part of `runGrokInstall()` idempotent merge |
 
 ## Implementation home
@@ -21,4 +21,4 @@
 
 ## Tests
 
-- Each ported capability gets a **new** vitest/node:test in lfg — do not depend on running legacy LFP test files unchanged.
+- Each ported capability gets a **new** vitest/node:test in lfg — do not depend on running legacy LFP test files unchanged.

docs/npm-publish.md

@@ -19,24 +19,16 @@ npm publish --access public   # must ship 0.1.4+ with `plugins/lfg/lfg` (registr
 
 `npm run assert-pack` runs `npm pack --dry-run` (triggers `prepack` → `npm run build`) then checks root `bin.lfg` and required dist paths.
 
-After publish, set `LFG_DOCTOR_REGISTRY_VERSION` to the registry version when checking publish gap locally:
-
-```sh
-LFG_DOCTOR_REGISTRY_VERSION=$(npm view @islee23520/lfg version) npx lfg --json doctor
-```
-
 Verify from a clean directory:
 
 ```sh
 mkdir /tmp/lfg-smoke && cd /tmp/lfg-smoke && npm init -y
 npm install @islee23520/lfg@latest
-npx @islee23520/lfg --json doctor
+npx @islee23520/lfg --json setup
 ```
 
-Expected: `bin` resolves to `plugins/lfg/lfg` → `dist/lfg.js`; doctor `cli.ok: true` when `~/.grok` has stamp after `setup --run`.
+Expected: `bin` resolves to `plugins/lfg/lfg` → `dist/lfg.js`; setup returns a non-mutating JSON plan unless `setup --run` is explicit.
 
 `@0.1.1` on npm has **no** `bin` — `npx @islee23520/lfg` fails with *could not determine executable* (`registry-install-smoke.integration.test.ts`).
 
-Registry `0.1.3` uses legacy `bin.lfg: plugins/lfg/dist/lfg.js` and does **not** ship the `plugins/lfg/lfg` shell shim (0.1.4+ pack does); `npx @islee23520/lfg` runs but republish `0.1.4+` with `plugins/lfg/lfg` is required for full doctor `cli` / `publishGap` parity (`registry-install-smoke.integration.test.ts`).
-
-`lfg --json doctor` with `LFG_DOCTOR_REGISTRY_VERSION` includes `publishGap`; broken npm layouts (missing or wrong `bin.lfg`) set `cli.ok: false` and `publishGap.publishReady: false`.
+Registry `0.1.3` uses legacy `bin.lfg: plugins/lfg/dist/lfg.js` and does **not** ship the `plugins/lfg/lfg` shell shim (0.1.4+ pack does); republish `0.1.4+` with `plugins/lfg/lfg` is required for the stable setup bin contract (`registry-install-smoke.integration.test.ts`).

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@islee23520/lfg",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "omo / lazycodex Grok Build adapter: npx @islee23520/lfg setup --run installs ~/.grok via internal grok-install (not a Grok plugin).",
   "publishConfig": {
     "access": "public"
@@ -38,7 +38,7 @@
     "plugins/lfg"
   ],
   "scripts": {
-    "setup": "sh plugins/lfg/lfg setup",
+    "setup": "sh plugins/lfg/lfg --json setup",
     "test": "npm run build && vitest run plugins/lfg/bin/*.test.ts plugins/lfg/grok-install/*.test.ts",
     "verify": "npm run assert-pack && npm test && npm run typecheck && npm run self-test",
     "self-test": "npm run build && node plugins/lfg/dist/self-test.js",

package.json

@@ -15,9 +15,9 @@ npx @islee23520/lfg setup
 | 상황 | 명령 |
 |------|------|
 | 처음 | `npx @islee23520/lfg setup` — (선택) OpenAI-compatible base URL, `/v1/models` 매핑, 역할 조정 후 `Install now?` **y** |
-| 다시 설치 | `npx @islee23520/lfg setup --run` |
+| 모델 동기화 / 기존 정상 설치 보존 | `npx @islee23520/lfg setup --run` |
+| 강제 재설치 / 어댑터 트리 복구 | `npx @islee23520/lfg setup --run --force` |
 | CI / 스크립트 | `npx @islee23520/lfg --json setup --run` |
-| 명령 목록 | `npx @islee23520/lfg help` |
 | 모델만 변경 | `setup` 다시 실행, 또는 `~/.grok`의 `models_base_url` 변경 후 `setup --run` |
 
 ## What lfg does
@@ -32,9 +32,11 @@ npx @islee23520/lfg setup
 npx @islee23520/lfg setup
 npx @islee23520/lfg --json setup
 npx @islee23520/lfg --json setup --base-url http://127.0.0.1:11434
+npx @islee23520/lfg --json setup --preset grok
+npx @islee23520/lfg --json setup --preset gpt
 npx @islee23520/lfg --json setup --run
 npx @islee23520/lfg setup --run
-npx @islee23520/lfg help
+npx @islee23520/lfg setup --run --force
 ```
 
 `lfg` is not a plugin, not a runtime, and not a replacement for `lazycodex-ai`.