@litfamily/litcodex 1.0.0 → 1.0.2

package/README.md

@@ -1,6 +1,7 @@
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.0/readme-assets/cover.webp" width="100%" alt="LitCodex v5 armory cover" /></p>
+<p align="center"><picture><source media="(prefers-reduced-motion: reduce)" srcset="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/cover.webp" /><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/cover-motion.webp" width="100%" alt="LitCodex cover art. An orange signal moves through orbital paths above the CODEX CLI wordmark. The static family cover appears for reduced-motion preference." /></picture></p>
+<p align="center"><a href="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/cover.webp">View the static cover</a></p>
 
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.0/readme-assets/ascii-readme.svg" width="480" alt="LIT ASCII B mark" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/ascii-readme.svg" width="480" alt="LIT ASCII B mark" /></p>
 
 <details>
 <summary>Copy ASCII logo</summary>
@@ -32,12 +33,12 @@ LIT · codex
 </details>
 
 <p align="center">
-<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.0/readme-assets/badge-version.svg" alt="1.0.0" /></a>
-<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.0/readme-assets/badge-license.svg" alt="MIT license" /></a>
+<a href="#install"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/badge-version.svg" alt="1.0.2" /></a>
+<a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/badge-license.svg" alt="MIT license" /></a>
 </p>
 
 <p align="center">
-<a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.0/readme-assets/lucide-book-open.svg" width="16" alt="" /> Docs</a> &nbsp; <a href="#install">Install</a> &nbsp; <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.0/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition</a> &nbsp; <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.0/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
+<a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage.md"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/lucide-book-open.svg" width="16" alt="" /> Docs</a> &nbsp; <a href="#install">Install</a> &nbsp; <a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/lucide-play.svg" width="16" alt="" /> Ignition</a> &nbsp; <a href="https://github.com/wjgoarxiv/litcodex/blob/main/LICENSE"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/lucide-shield-check.svg" width="16" alt="" /> MIT</a>
 </p>
 
 # @litfamily/litcodex
@@ -79,7 +80,7 @@ Append `lit` to a prompt to activate the Codex CLI hook. It routes the request i
 
 The hook is an entry signal; it does not prove that a model result or visual check completed.
 
-<p align="center"><a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.0/readme-assets/ignition-poster.png" width="720" alt="Ignition motion poster" /></a></p>
+<p align="center"><a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/ignition-poster.png" width="720" alt="Ignition motion poster" /></a></p>
 
 Select the poster for the optional film; this README keeps motion opt-in.
 
@@ -93,30 +94,30 @@ Host limit: Codex CLI owns hook and agent execution, while authentication, model
 and any visual check remain host capabilities. A route mark or static editorial image is not completion
 evidence.
 
-<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.0/readme-assets/litcodex-ignition-1600.webp" width="49%" alt="LitCodex ignition editorial cue" /> <img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.0/readme-assets/litcodex-continuity-1600.webp" width="49%" alt="LitCodex continuity editorial cue" /></p>
+<p align="center"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/litcodex-ignition-1600.webp" width="49%" alt="LitCodex ignition editorial cue" /> <img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/litcodex-continuity-1600.webp" width="49%" alt="LitCodex continuity editorial cue" /></p>
 
 ## What is LitCodex
 
 LitCodex adds planning, review, research, and a durable execution loop to Codex CLI. Its `UserPromptSubmit`
-hook routes your request into the right discipline; the bundled library provides 39 skills. A goal is complete
+hook routes your request into the right discipline; the bundled library provides 38 skills. A goal is complete
 only after every success criterion passes. The npm package is self-contained and installs without a GitHub clone.
 
 ## Install
 
-> Install `@litfamily/litcodex@1.0.0` with the scoped command below. See [migration guidance](https://github.com/wjgoarxiv/litcodex/blob/main/docs/npm-migration.md).
+> Install `@litfamily/litcodex@1.0.2` with the scoped command below. See [migration guidance](https://github.com/wjgoarxiv/litcodex/blob/main/docs/npm-migration.md).
 
 With **Node.js 22+** and **Codex CLI** installed, run:
 
 ```sh
-npm exec --yes --package @litfamily/litcodex@1.0.0 -- litcodex install
+npm exec --yes --package @litfamily/litcodex@1.0.2 -- litcodex install
 ```
 
 The installer registers the plugin, hooks, and agents, then updates managed keys in `~/.codex/config.toml`.
 It asks for the lead model, helper model, and output style. Codex authentication and model access are required
 when you run model work; installation itself does not require GitHub credentials.
 
-Preview changes with `npm exec --yes --package @litfamily/litcodex@1.0.0 -- litcodex --dry-run install`. For unattended setup, use
-`npm exec --yes --package @litfamily/litcodex@1.0.0 -- litcodex install --yes`. An explicit `--style <id>` still applies.
+Preview changes with `npm exec --yes --package @litfamily/litcodex@1.0.2 -- litcodex --dry-run install`. For unattended setup, use
+`npm exec --yes --package @litfamily/litcodex@1.0.2 -- litcodex install --yes`. An explicit `--style <id>` still applies.
 
 For a persistent command:
 
@@ -125,7 +126,7 @@ npm install -g @litfamily/litcodex
 litcodex install
 ```
 
-> Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.0 -- litcodex <command>`, such as `npm exec --yes --package @litfamily/litcodex@1.0.0 -- litcodex doctor`.
+> Without a global install, use `npm exec --yes --package @litfamily/litcodex@1.0.2 -- litcodex <command>`, such as `npm exec --yes --package @litfamily/litcodex@1.0.2 -- litcodex doctor`.
 
 For an isolated trial apart from existing settings, follow the [isolated trial guide](https://github.com/wjgoarxiv/litcodex/blob/main/docs/npm-migration.md#isolated-local-trial).
 Changing only `CODEX_HOME` can still discover settings in your existing home.
@@ -205,8 +206,6 @@ from the Codex picker or with a scoped mention, including `$litcodex:lit-handoff
 | `litcodex uninstall` | Remove the plugin and LitCodex-managed config |
 | `litcodex config migrate` | Preview or apply managed Codex config keys |
 | `litcodex hook user-prompt-submit` | Run the host hook entrypoint |
-| `litcodex observer` | Record one proposal from bounded JSON on stdin |
-| `litcodex skill-loop <command>` | Review, approve, reject, roll back, or curate agent-owned skill proposals |
 | `litcodex loop create` | Derive goals and criteria from a brief |
 | `litcodex loop status --json` | Inspect loop state as JSON |
 | `litcodex loop run` | Select the next runnable goal |
@@ -226,7 +225,7 @@ See [state and recovery](https://github.com/wjgoarxiv/litcodex/blob/main/docs/us
 ## Verify it worked
 
 ```sh
-npm exec --yes --package @litfamily/litcodex@1.0.0 -- litcodex doctor
+npm exec --yes --package @litfamily/litcodex@1.0.2 -- litcodex doctor
 ```
 
 `litcodex doctor` checks registration, hooks, config, and host capabilities. `litcodex loop doctor` checks
@@ -236,8 +235,6 @@ project loop state. A successful installation check does not prove authenticated
 
 - Plans and evidence stay reviewable. No criterion is marked complete merely because a test command ran.
 - Installation preserves unrelated Codex settings. Preview changes before `--reconfigure`.
-- Skill learning requires explicit review and apply; `autoApply` stays `false`. Only marked agent-owned skills
-  may be changed. [Approval, rollback, and recovery rules](https://github.com/wjgoarxiv/litcodex/blob/main/docs/usage.md#skill-learning-loop).
 - The doctor diagnostic core never modifies Codex config, install state, or plugin state. An eligible interactive
   doctor may show a cached advisory notice. Its detached worker performs a fixed registry refresh at
   `~/.litcodex/update-check.json`; that worker never installs packages.
@@ -259,7 +256,7 @@ project loop state. A successful installation check does not prove authenticated
 ## Uninstall
 
 ```sh
-npm exec --yes --package @litfamily/litcodex@1.0.0 -- litcodex uninstall
+npm exec --yes --package @litfamily/litcodex@1.0.2 -- litcodex uninstall
 ```
 
 `litcodex uninstall` removes the plugin and LitCodex-managed config while preserving unrelated settings.
@@ -274,7 +271,7 @@ npm exec --yes --package @litfamily/litcodex@1.0.0 -- litcodex uninstall
 The bundled skill library also includes `autoconference`, `autoresearch`, `browser-drive`, `coding-session-audit`,
 `comment-checker`, `debugging`, `frontend-ui-ux`, `lit-commit`, `lit-crucible`, `lit-init`, `lit-korean`, `lit-fetch`,
 `litcodex-contribute-bug-fix`, `litcodex-doctor`, `litcodex-report-bug`, `lsp`, `lsp-setup`, `lit-code`, `refactor`,
-`lit-burnoff`, `skill-observer`, `structural-search`, `lit-team`, `visual-qa`, and `wikify`.
+`lit-burnoff`, `structural-search`, `lit-team`, `visual-qa`, and `wikify`.
 
 Tests, fixtures, test helpers, and Vitest configuration remain tracked repository coverage and are excluded from npm and installed marketplace payloads.
 
@@ -284,7 +281,7 @@ Tests, fixtures, test helpers, and Vitest configuration remain tracked repositor
 
 Select the poster to watch the 10-second film.
 
-<p align="center"><a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.0/readme-assets/ignition-poster.png" width="720" alt="Ignition motion graphic poster" /></a></p>
+<p align="center"><a href="https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-film.mp4"><img src="https://cdn.jsdelivr.net/npm/@litfamily/litcodex@1.0.2/readme-assets/ignition-poster.png" width="720" alt="Ignition motion graphic poster" /></a></p>
 
 [Animated GIF](https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/ignition-readme.gif) · [Media and icon credits](https://github.com/wjgoarxiv/litcodex/blob/main/docs/assets/readme/README.md)
 

package/dist/cli.d.ts

@@ -17,7 +17,7 @@ export declare function dispatch(argv: readonly string[]): DispatchResult;
 /**
  * Async process entry used by `bin/litcodex.js`. It owns the side-effecting routes: install/doctor/
  * uninstall (install/* modules, which are the ONLY code that ever spawns `codex`), `config migrate`
- * (M13, in-process), and the bundled `@litcodex/lit-loop` runtime routes `loop`/`hook`/`observer`. Returns the
+ * (M13, in-process), and the bundled `@litcodex/lit-loop` runtime routes `loop`/`hook`. Returns the
  * integer exit code; the bin owns `process.exit`. No forwarding, no exec-wrapper, no harness.
  */
 export declare function runCli(argv: readonly string[]): Promise<number>;

package/dist/cli.js

@@ -55,19 +55,7 @@ const ROUTES = {
     config: configRouteHandler,
     loop: () => ok("litcodex loop\n"),
     hook: () => ok("litcodex hook\n"),
-    observer: observerRouteHandler,
-    "skill-loop": () => ok("litcodex skill-loop\n"),
 };
-function observerRouteHandler(rest, dryRun) {
-    if (dryRun || rest.length > 0) {
-        return {
-            stdout: "",
-            stderr: "litcodex observer: this command accepts no arguments.\n",
-            exitCode: CONFIG_USAGE_EXIT_CODE,
-        };
-    }
-    return ok("litcodex observer\n");
-}
 /**
  * Synchronous arm of the `config` route. The real `config migrate` work is async and is run by
  * `runCli` BEFORE `dispatch`; this sync handler only handles routing-level outcomes: an unknown
@@ -96,8 +84,6 @@ function renderHelp() {
         "  litcodex config migrate                  Migrate Codex config for LitCodex",
         "  litcodex loop <sub>                      Run a Lit-Loop subcommand",
         "  litcodex hook user-prompt-submit         Run the UserPromptSubmit hook",
-        "  litcodex observer                        Record one proposal from bounded stdin",
-        "  litcodex skill-loop <sub>                Review, apply, reject, or roll back skill proposals",
         "  litcodex --dry-run <command>             Resolve a command without applying it",
         "  litcodex --help                          Show this help",
         "  litcodex --version                       Show the @litfamily/litcodex version",
@@ -167,7 +153,7 @@ export function dispatch(argv) {
 /**
  * Async process entry used by `bin/litcodex.js`. It owns the side-effecting routes: install/doctor/
  * uninstall (install/* modules, which are the ONLY code that ever spawns `codex`), `config migrate`
- * (M13, in-process), and the bundled `@litcodex/lit-loop` runtime routes `loop`/`hook`/`observer`. Returns the
+ * (M13, in-process), and the bundled `@litcodex/lit-loop` runtime routes `loop`/`hook`. Returns the
  * integer exit code; the bin owns `process.exit`. No forwarding, no exec-wrapper, no harness.
  */
 export async function runCli(argv) {
@@ -176,28 +162,6 @@ export async function runCli(argv) {
     const head = rest[0];
     const isHelp = rest.includes("--help") || rest.includes("-h");
     const isVersion = rest.includes("--version") || rest.includes("-v");
-    if (!isHelp && !isVersion && head === "observer") {
-        const observerResult = observerRouteHandler(rest.slice(1), dryRun);
-        if (observerResult.exitCode !== 0)
-            return dispatchExit(observerResult);
-        const { runSkillObserverCli } = await import("@litcodex/lit-loop/dist/skill-observer-cli.js");
-        return runSkillObserverCli(process.stdin, process.stdout, process.stderr);
-    }
-    if (!isHelp && !isVersion && head === "skill-loop") {
-        if (dryRun)
-            return dispatchExit({
-                stdout: "",
-                stderr: "litcodex skill-loop: --dry-run is not supported.\n",
-                exitCode: 64,
-            });
-        const { skillLoopCommand } = await import("@litcodex/lit-loop/dist/skill-loop-cli.js");
-        return skillLoopCommand(rest.slice(1), {
-            cwd: process.cwd(),
-            env: process.env,
-            stdout: process.stdout,
-            stderr: process.stderr,
-        });
-    }
     if (!isHelp && !isVersion) {
         if (head === "config" && rest[1] === "migrate") {
             const passthrough = dryRun ? [...rest.slice(2), "--dry-run"] : rest.slice(2);
@@ -231,7 +195,7 @@ export async function runCli(argv) {
             }
             const hooks = await import("@litcodex/lit-loop/dist/hook-cli.js");
             return rest[1] === "stop"
-                ? hooks.runStopSkillReviewHookCli(process.stdin, process.stdout, process.stderr)
+                ? hooks.runStopPlanPersistenceHookCli(process.stdin, process.stdout, process.stderr)
                 : hooks.runUserPromptSubmitHookCli(process.stdin, process.stdout, process.stderr);
         }
     }

package/dist/config-migration/profile-files.d.ts

@@ -9,3 +9,7 @@ export declare function ensureGpt56ProfileFiles(args: {
     readonly reconfigure: boolean;
     readonly modelContexts?: Gpt56ModelContexts;
 }): Promise<ProfileFileResult>;
+/** The per-model profile file names LitCodex may write directly under `codexHome`. */
+export declare const GPT56_PROFILE_FILE_NAMES: readonly string[];
+/** True when `content` is exactly what LitCodex would have written for `name` (bare, or with the limits it still recognizes as its own). Used by uninstall to remove only files it authored. */
+export declare function isManagedGpt56ProfileContent(name: string, content: string): boolean;

package/dist/config-migration/profile-files.js

@@ -56,6 +56,28 @@ function profileContent() {
         "gpt56-luna-max.config.toml": renderProfile(GPT56_MODELS.luna, "max"),
     };
 }
+/** The per-model profile file names LitCodex may write directly under `codexHome`. */
+export const GPT56_PROFILE_FILE_NAMES = Object.keys(profileContent());
+/** True when `content` is exactly what LitCodex would have written for `name` (bare, or with the limits it still recognizes as its own). Used by uninstall to remove only files it authored. */
+export function isManagedGpt56ProfileContent(name, content) {
+    const desired = profileContent()[name];
+    if (desired === undefined)
+        return false;
+    if (content === desired)
+        return true;
+    switch (name) {
+        case "gpt56-sol-high.config.toml":
+            return isExactGeneratedExplicitSolProfile(content);
+        case "gpt56-terra-high.config.toml":
+            return isExactGeneratedTerraProfile(content);
+        case "gpt56-luna-max.config.toml":
+            return isExactGeneratedLunaProfile(content);
+        case "gpt6-astra-xhigh.config.toml":
+            return isExactGeneratedAstraProfile(content);
+        default:
+            return false;
+    }
+}
 function renderProfile(model, effort) {
     return `model = ${JSON.stringify(model)}\nmodel_reasoning_effort = ${JSON.stringify(effort)}\n`;
 }

package/dist/install/capability-preflight-error.js

@@ -27,7 +27,11 @@ export function capabilityPreflightError(capabilities, codexBin) {
     // When that also fails, the existing Codex configuration on this machine is what
     // the resolved binary cannot load, and LitCodex's managed settings are innocent.
     if (reason === "host-config-incompatible") {
-        return new InstallError("LITCODEX_INSTALL_HOST_CONFIG_INCOMPATIBLE", `The existing Codex configuration on this machine could not be loaded by the Codex that ran, with or without LitCodex settings; no install mutation was attempted.${resolved} This usually means that Codex is older than the one that last wrote the configuration.`, { capabilities });
+        const detail = capabilities.concurrency.detail;
+        const explanation = detail === undefined
+            ? " This usually means that Codex is older than the one that last wrote the configuration."
+            : ` Codex reported: ${detail}.`;
+        return new InstallError("LITCODEX_INSTALL_HOST_CONFIG_INCOMPATIBLE", `The existing Codex configuration on this machine could not be loaded by the Codex that ran, with or without LitCodex settings; no install mutation was attempted.${resolved}${explanation}`, { capabilities });
     }
     return new InstallError("LITCODEX_INSTALL_CONFIG_WRITE_FAILED", `Codex strict config rejected LitCodex managed settings; no install mutation was attempted.${resolved}`, { capabilities });
 }

package/dist/install/codex.d.ts

@@ -10,6 +10,7 @@ export interface SpawnOptions {
     readonly stdio: "inherit" | "pipe";
     readonly timeout?: number;
     readonly env?: NodeJS.ProcessEnv;
+    readonly cwd?: string;
     readonly shell?: false;
     readonly windowsVerbatimArguments?: boolean;
 }

package/dist/install/generated-skill-payload-hashes.d.ts

@@ -6,12 +6,7 @@ export declare const BROWSER_DRIVE_PAYLOAD_HASHES: {
     readonly "SKILL.md": "74f89ce0b7462e397952ac9d074b8a29a0133cccbc3e7179e8ec63128d88724f";
     readonly "agents/openai.yaml": "1b9a859e2da403ffc3a526b3d36e9bd6bfd95af087b7ec4ae71f6b615ced7828";
     readonly "references/snapshot-act-loop.md": "7aff2f4145413d61aaac577c2e551e3ed11a14b78dd46d047409c91a522ece1f";
-    readonly "scripts/capability-probe.mjs": "7e8fa7b0c5243c51893c929ecdca4996eae83cad307590c5ac2ae8c34af1625c";
-};
-export declare const SKILL_OBSERVER_PAYLOAD_HASHES: {
-    readonly "SKILL.md": "e56a3dd538f2e986f19abbc360f8902551a06e4c38903114ceb2ffba6681458d";
-    readonly "agents/openai.yaml": "584a177dd2db92fdeb5a742643de035ff0932dd75cb01192953852df02fad3fe";
-    readonly "references/review-contract.md": "f55dc8334f3b8d8498c84d57725fa03af8fbd689b2dd7cce25e49931629ee54f";
+    readonly "scripts/capability-probe.mjs": "95bac59fd820e5a1e1d7f43e984ddf9f8ffdcb10b4803d566afe06be316ad953";
 };
 export declare const FRONTEND_UIUX_PAYLOAD_HASHES: {
     readonly "SKILL.md": "b5fdb88106a0e23112686b120f4da0f250ac66c8909afaafbdf00f0ae823c88b";

package/dist/install/generated-skill-payload-hashes.js

@@ -7,12 +7,7 @@ export const BROWSER_DRIVE_PAYLOAD_HASHES = {
     "SKILL.md": "74f89ce0b7462e397952ac9d074b8a29a0133cccbc3e7179e8ec63128d88724f",
     "agents/openai.yaml": "1b9a859e2da403ffc3a526b3d36e9bd6bfd95af087b7ec4ae71f6b615ced7828",
     "references/snapshot-act-loop.md": "7aff2f4145413d61aaac577c2e551e3ed11a14b78dd46d047409c91a522ece1f",
-    "scripts/capability-probe.mjs": "7e8fa7b0c5243c51893c929ecdca4996eae83cad307590c5ac2ae8c34af1625c",
-};
-export const SKILL_OBSERVER_PAYLOAD_HASHES = {
-    "SKILL.md": "e56a3dd538f2e986f19abbc360f8902551a06e4c38903114ceb2ffba6681458d",
-    "agents/openai.yaml": "584a177dd2db92fdeb5a742643de035ff0932dd75cb01192953852df02fad3fe",
-    "references/review-contract.md": "f55dc8334f3b8d8498c84d57725fa03af8fbd689b2dd7cce25e49931629ee54f",
+    "scripts/capability-probe.mjs": "95bac59fd820e5a1e1d7f43e984ddf9f8ffdcb10b4803d566afe06be316ad953",
 };
 export const FRONTEND_UIUX_PAYLOAD_HASHES = {
     "SKILL.md": "b5fdb88106a0e23112686b120f4da0f250ac66c8909afaafbdf00f0ae823c88b",

package/dist/install/host-capabilities.d.ts

@@ -7,6 +7,8 @@ export interface CapabilityReport {
     readonly reason: string;
     readonly observedSource: string;
     readonly limit?: number;
+    /** Extra diagnostic text observed from Codex itself: a startup warning on acceptance, or the doctor-reported failure detail on host-config-incompatible rejection. */
+    readonly detail?: string;
 }
 export interface HostCapabilities {
     readonly concurrency: CapabilityReport;

package/dist/install/host-capabilities.js

@@ -64,6 +64,10 @@ export function probeHostCapabilities(codexBin, spawn, selection = {}) {
         hostConfigRejected: baselineProbe?.kind === "rejected",
         timedOut: isTimeout(versionResult) || rootProbe.kind === "timeout",
         versionSupport,
+        ...(rootProbe.kind === "accepted" && rootProbe.warning !== undefined ? { rootWarning: rootProbe.warning } : {}),
+        ...(baselineProbe?.kind === "rejected" && baselineProbe.detail !== undefined
+            ? { hostConfigDetail: baselineProbe.detail }
+            : {}),
     });
     return {
         concurrency,
@@ -99,14 +103,21 @@ function concurrencyReport(args) {
     }
     if (!args.rootAccepted) {
         const reason = args.hostConfigRejected === true ? "host-config-incompatible" : "strict-config-rejected";
-        return { status: "unavailable", reason, observedSource };
+        return {
+            status: "unavailable",
+            reason,
+            observedSource,
+            ...(args.hostConfigDetail === undefined ? {} : { detail: args.hostConfigDetail }),
+        };
     }
+    const detail = args.rootWarning === undefined ? {} : { detail: args.rootWarning };
     if (args.versionSupport.kind === "newer-stable") {
         return {
             status: "advisory",
             limit: HARD_CONCURRENCY_LIMIT,
             reason: "strict config accepted on a newer stable Codex; configured concurrency is usable but runtime enforcement is not yet source-verified",
             observedSource,
+            ...detail,
         };
     }
     return {
@@ -114,6 +125,7 @@ function concurrencyReport(args) {
         limit: HARD_CONCURRENCY_LIMIT,
         reason: "strict-config accepted the reserved collaboration schema, max_concurrent_threads_per_session=20, and agents.max_depth=1",
         observedSource,
+        ...detail,
     };
 }
 function autoCompactionReport(args) {

package/dist/install/index.js

@@ -5,7 +5,7 @@
 // argv into typed `InstallOptions`, and return an integer exit code. `--dry-run` returns BEFORE any
 // spawn or fs write (renders the plan only). Unknown/bad flags exit 1.
 import { spawnSync } from "node:child_process";
-import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmdirSync, rmSync, writeFileSync } from "node:fs";
 import { createRequire } from "node:module";
 import { join } from "node:path";
 import readline from "node:readline/promises";
@@ -40,6 +40,7 @@ const realSpawn = (cmd, args, opts) => {
         shell: invocation.shell,
         windowsVerbatimArguments: invocation.windowsVerbatimArguments || opts.windowsVerbatimArguments === true,
         ...(opts.env === undefined ? {} : { env: opts.env }),
+        ...(opts.cwd === undefined ? {} : { cwd: opts.cwd }),
     });
     const out = {
         status: res.status,
@@ -384,6 +385,7 @@ export function runUninstallCli(args, io = defaultIo()) {
             existsSync,
             readdirSync: (path) => readdirSync(path),
             rmSync,
+            rmdirSync: (path) => rmdirSync(path),
             readFileSync: (path, enc) => readFileSync(path, enc),
             writeFileSync: (path, data) => {
                 writeFileSync(path, data);

package/dist/install/skill-catalog.d.ts

@@ -6,7 +6,7 @@ import type { ReadonlyFsLike } from "./codex.js";
  * marketplace has every supported skill entry point, while the companion test
  * compares it with the repository's package contract.
  */
-export declare const CANONICAL_SKILL_IDS: readonly ["autoconference", "autoresearch", "browser-drive", "coding-session-audit", "comment-checker", "debugging", "deep-interview", "frontend-ui-ux", "lit-burnoff", "lit-burnoff-file", "lit-code", "lit-commit", "lit-comprehend", "lit-crucible", "lit-fetch", "lit-handoff", "lit-init", "lit-korean", "lit-loop", "lit-plan", "lit-recap", "lit-scientific-visualization", "lit-team", "litcodex-contribute-bug-fix", "litcodex-doctor", "litcodex-report-bug", "litgoal", "litresearch", "litwork", "lsp", "lsp-setup", "refactor", "review-work", "rules", "skill-observer", "start-work", "structural-search", "visual-qa", "wikify"];
+export declare const CANONICAL_SKILL_IDS: readonly ["autoconference", "autoresearch", "browser-drive", "coding-session-audit", "comment-checker", "debugging", "deep-interview", "frontend-ui-ux", "lit-burnoff", "lit-burnoff-file", "lit-code", "lit-commit", "lit-comprehend", "lit-crucible", "lit-fetch", "lit-handoff", "lit-init", "lit-korean", "lit-loop", "lit-plan", "lit-recap", "lit-scientific-visualization", "lit-team", "litcodex-contribute-bug-fix", "litcodex-doctor", "litcodex-report-bug", "litgoal", "litresearch", "litwork", "lsp", "lsp-setup", "refactor", "review-work", "rules", "start-work", "structural-search", "visual-qa", "wikify"];
 export declare const CANONICAL_SKILL_RESOURCE_PATHS: readonly ["lsp/references/runtime-triage.md", ...string[]];
 export interface SkillCatalogPayloadReport {
     readonly complete: boolean;

package/dist/install/skill-catalog.js

@@ -1,6 +1,6 @@
 import { join } from "node:path";
 import { payloadExact } from "./bundled-skills.js";
-import { AUTOCONFERENCE_PAYLOAD_HASHES, AUTORESEARCH_PAYLOAD_HASHES, BROWSER_DRIVE_PAYLOAD_HASHES, CODING_SESSION_AUDIT_PAYLOAD_HASHES, DEEP_INTERVIEW_PAYLOAD_HASHES, FRONTEND_UIUX_PAYLOAD_HASHES, SKILL_OBSERVER_PAYLOAD_HASHES, STRUCTURAL_SEARCH_PAYLOAD_HASHES, VISUAL_QA_PAYLOAD_HASHES, WIKIFY_PAYLOAD_HASHES, } from "./skill-resource-hashes.js";
+import { AUTOCONFERENCE_PAYLOAD_HASHES, AUTORESEARCH_PAYLOAD_HASHES, BROWSER_DRIVE_PAYLOAD_HASHES, CODING_SESSION_AUDIT_PAYLOAD_HASHES, DEEP_INTERVIEW_PAYLOAD_HASHES, FRONTEND_UIUX_PAYLOAD_HASHES, STRUCTURAL_SEARCH_PAYLOAD_HASHES, VISUAL_QA_PAYLOAD_HASHES, WIKIFY_PAYLOAD_HASHES, } from "./skill-resource-hashes.js";
 /**
  * The Codex-native skill directories shipped in the LitCodex marketplace payload.
  *
@@ -43,7 +43,6 @@ export const CANONICAL_SKILL_IDS = [
     "refactor",
     "review-work",
     "rules",
-    "skill-observer",
     "start-work",
     "structural-search",
     "visual-qa",
@@ -66,9 +65,6 @@ export const CANONICAL_SKILL_RESOURCE_PATHS = [
     ...Object.keys(FRONTEND_UIUX_PAYLOAD_HASHES)
         .filter((path) => path !== "SKILL.md")
         .map((path) => `frontend-ui-ux/${path}`),
-    ...Object.keys(SKILL_OBSERVER_PAYLOAD_HASHES)
-        .filter((path) => path !== "SKILL.md")
-        .map((path) => `skill-observer/${path}`),
     ...Object.keys(VISUAL_QA_PAYLOAD_HASHES)
         .filter((path) => path !== "SKILL.md")
         .map((path) => `visual-qa/${path}`),
@@ -93,7 +89,6 @@ export function probeSkillCatalogPayload(fs, marketplaceRoot) {
         ["browser-drive", BROWSER_DRIVE_PAYLOAD_HASHES],
         ["deep-interview", DEEP_INTERVIEW_PAYLOAD_HASHES],
         ["frontend-ui-ux", FRONTEND_UIUX_PAYLOAD_HASHES],
-        ["skill-observer", SKILL_OBSERVER_PAYLOAD_HASHES],
         ["visual-qa", VISUAL_QA_PAYLOAD_HASHES],
         ["structural-search", STRUCTURAL_SEARCH_PAYLOAD_HASHES],
         ["coding-session-audit", CODING_SESSION_AUDIT_PAYLOAD_HASHES],

package/dist/install/skill-resource-hashes.d.ts

@@ -1 +1 @@
-export { AUTOCONFERENCE_PAYLOAD_HASHES, AUTORESEARCH_PAYLOAD_HASHES, BROWSER_DRIVE_PAYLOAD_HASHES, CODING_SESSION_AUDIT_PAYLOAD_HASHES, DEEP_INTERVIEW_PAYLOAD_HASHES, FRONTEND_UIUX_PAYLOAD_HASHES, SKILL_OBSERVER_PAYLOAD_HASHES, STRUCTURAL_SEARCH_PAYLOAD_HASHES, VISUAL_QA_PAYLOAD_HASHES, WIKIFY_PAYLOAD_HASHES, } from "./generated-skill-payload-hashes.js";
+export { AUTOCONFERENCE_PAYLOAD_HASHES, AUTORESEARCH_PAYLOAD_HASHES, BROWSER_DRIVE_PAYLOAD_HASHES, CODING_SESSION_AUDIT_PAYLOAD_HASHES, DEEP_INTERVIEW_PAYLOAD_HASHES, FRONTEND_UIUX_PAYLOAD_HASHES, STRUCTURAL_SEARCH_PAYLOAD_HASHES, VISUAL_QA_PAYLOAD_HASHES, WIKIFY_PAYLOAD_HASHES, } from "./generated-skill-payload-hashes.js";

package/dist/install/skill-resource-hashes.js

@@ -1 +1 @@
-export { AUTOCONFERENCE_PAYLOAD_HASHES, AUTORESEARCH_PAYLOAD_HASHES, BROWSER_DRIVE_PAYLOAD_HASHES, CODING_SESSION_AUDIT_PAYLOAD_HASHES, DEEP_INTERVIEW_PAYLOAD_HASHES, FRONTEND_UIUX_PAYLOAD_HASHES, SKILL_OBSERVER_PAYLOAD_HASHES, STRUCTURAL_SEARCH_PAYLOAD_HASHES, VISUAL_QA_PAYLOAD_HASHES, WIKIFY_PAYLOAD_HASHES, } from "./generated-skill-payload-hashes.js";
+export { AUTOCONFERENCE_PAYLOAD_HASHES, AUTORESEARCH_PAYLOAD_HASHES, BROWSER_DRIVE_PAYLOAD_HASHES, CODING_SESSION_AUDIT_PAYLOAD_HASHES, DEEP_INTERVIEW_PAYLOAD_HASHES, FRONTEND_UIUX_PAYLOAD_HASHES, STRUCTURAL_SEARCH_PAYLOAD_HASHES, VISUAL_QA_PAYLOAD_HASHES, WIKIFY_PAYLOAD_HASHES, } from "./generated-skill-payload-hashes.js";

package/dist/install/strict-config-probe.d.ts

@@ -1,8 +1,10 @@
 import { type SpawnLike } from "./codex.js";
 export type StrictConfigProbe = {
     readonly kind: "accepted";
+    readonly warning?: string;
 } | {
     readonly kind: "rejected";
+    readonly detail?: string;
 } | {
     readonly kind: "timeout";
 };

package/dist/install/strict-config-probe.js

@@ -13,7 +13,12 @@ export function probeStrictConfig(args) {
         if (existsSync(sourceConfig)) {
             writeFileSync(join(probeHome, "config.toml"), readFileSync(sourceConfig), { mode: 0o600 });
         }
-        return runProbe({ ...args, env: { ...args.env, CODEX_HOME: probeHome } });
+        // cwd matters here: Codex resolves per-project trust/overlay state from the *caller's*
+        // cwd, not from CODEX_HOME. Inheriting the real caller cwd let an unrelated trusted
+        // project entry in the copied config.toml (e.g. `[projects."$HOME"]`) change how that
+        // same config parses, turning a healthy host into a false refusal. Pointing cwd at the
+        // disposable probe home keeps the result a function of the config content alone.
+        return runProbe({ ...args, env: { ...args.env, CODEX_HOME: probeHome }, cwd: probeHome });
     }
     finally {
         rmSync(probeHome, { recursive: true, force: true, maxRetries: 3, retryDelay: 50 });
@@ -24,6 +29,7 @@ function runProbe(args) {
         stdio: "pipe",
         timeout: STRICT_CONFIG_PROBE_TIMEOUT_MS,
         ...(args.env === undefined ? {} : { env: args.env }),
+        ...(args.cwd === undefined ? {} : { cwd: args.cwd }),
     });
     if (isTimeout(result))
         return { kind: "timeout" };
@@ -31,7 +37,16 @@ function runProbe(args) {
         return { kind: "rejected" };
     try {
         const parsed = JSON.parse(result.stdout ?? "");
-        return configLoadStatus(parsed) === "ok" ? { kind: "accepted" } : { kind: "rejected" };
+        const load = inspectConfigLoad(parsed);
+        if (load === null)
+            return { kind: "rejected" };
+        // A "warning" config.load status still parsed config.toml successfully — Codex is
+        // reporting something advisory (e.g. an ignored project-local key), not a load
+        // failure. Only a genuinely unparsable/failed load is a real rejection.
+        if (load.status === "ok" || (load.status === "warning" && load.parseOk)) {
+            return load.warning === undefined ? { kind: "accepted" } : { kind: "accepted", warning: load.warning };
+        }
+        return load.detail === undefined ? { kind: "rejected" } : { kind: "rejected", detail: load.detail };
     }
     catch (error) {
         if (error instanceof SyntaxError)
@@ -42,11 +57,25 @@ function runProbe(args) {
 function isTimeout(result) {
     return result.error instanceof Error && "code" in result.error && result.error.code === "ETIMEDOUT";
 }
-function configLoadStatus(value) {
+function inspectConfigLoad(value) {
     if (!isRecord(value) || !isRecord(value["checks"]) || !isRecord(value["checks"]["config.load"]))
         return null;
-    const status = value["checks"]["config.load"]["status"];
-    return typeof status === "string" ? status : null;
+    const check = value["checks"]["config.load"];
+    const status = check["status"];
+    if (typeof status !== "string")
+        return null;
+    const details = isRecord(check["details"]) ? check["details"] : {};
+    const parseOk = details["config.toml parse"] === "ok";
+    const warning = typeof details["startup warning"] === "string" ? details["startup warning"] : undefined;
+    const notes = Array.isArray(check["notes"]) ? check["notes"].filter((note) => typeof note === "string") : [];
+    const summary = typeof check["summary"] === "string" ? check["summary"] : undefined;
+    const detailParts = [summary, ...notes].filter((part) => part !== undefined && part.length > 0);
+    return {
+        status,
+        parseOk,
+        ...(warning === undefined ? {} : { warning }),
+        ...(detailParts.length === 0 ? {} : { detail: detailParts.join(": ") }),
+    };
 }
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);

package/dist/install/uninstall.d.ts

@@ -6,6 +6,8 @@ export interface UninstallFs {
         recursive?: boolean;
         force?: boolean;
     }): void;
+    /** Removes an empty directory only; must throw (not silently recurse) if the directory is non-empty. */
+    rmdirSync?(path: string): void;
     lstatSync?(path: string): {
         isSymbolicLink(): boolean;
         isDirectory(): boolean;

package/dist/install/uninstall.js

@@ -3,6 +3,7 @@ import { lstatSync as nativeLstatSync } from "node:fs";
 import { join } from "node:path";
 import { removeSubagentDefaults } from "../config-migration/multi-agent-v2-guard.js";
 import { ensureNativeDefaultAgentConfig } from "../config-migration/native-default-route.js";
+import { GPT56_PROFILE_FILE_NAMES, isManagedGpt56ProfileContent } from "../config-migration/profile-files.js";
 import { NATIVE_DEFAULT_AGENT_FILE } from "./agent-routing.js";
 import { prepareAgentSources } from "./agents-install.js";
 import { isSafeManagedMarketplaceRoot, LITCODEX_MARKETPLACE, LITCODEX_PLUGIN_REF, managedMarketplaceRoot, } from "./marketplace.js";
@@ -25,6 +26,7 @@ export function runUninstall(deps) {
     }
     removeManagedAgents(deps);
     removeManagedSubagentDefaults(deps);
+    removeManagedProfileFiles(deps);
     return { ok: pluginOk && marketplaceOk, codexHome: deps.codexHome };
 }
 function isSafeUninstallPaths(deps) {
@@ -102,6 +104,38 @@ function removeManagedAgents(deps) {
     catch {
         // Best-effort agent cleanup must not hide the authoritative Codex removal result.
     }
+    removeIfEmptyDirectory(deps, agentsDir);
+}
+/** Best-effort per-model profile removal: only files whose content matches what LitCodex generates. */
+function removeManagedProfileFiles(deps) {
+    if (!isDirectoryNonSymlink(deps, deps.codexHome) || deps.fs.readFileSync === undefined)
+        return;
+    for (const name of GPT56_PROFILE_FILE_NAMES) {
+        const path = join(deps.codexHome, name);
+        if (!isRegularNonSymlink(deps, path))
+            continue;
+        try {
+            const content = deps.fs.readFileSync(path, "utf8");
+            if (isManagedGpt56ProfileContent(name, content))
+                deps.fs.rmSync(path);
+        }
+        catch {
+            // Preserve unreadable or unremovable profiles while checking the rest.
+        }
+    }
+}
+/** Non-recursive: only removes a managed directory that install created and that is now empty. */
+function removeIfEmptyDirectory(deps, path) {
+    if (deps.fs.rmdirSync === undefined || !isDirectoryNonSymlink(deps, path))
+        return;
+    try {
+        if (deps.fs.readdirSync(path).length > 0)
+            return;
+        deps.fs.rmdirSync(path);
+    }
+    catch {
+        // A non-empty or otherwise unremovable directory is left in place.
+    }
 }
 const MANAGED_DEFAULT_HEADER = [
     'name = "default"',

package/marketplace/plugins/litcodex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "litcodex",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "LitCodex Codex plugin: the lit-loop activation, durable loop runtime, and local review-gated knowledge.",
   "license": "MIT",
   "keywords": [

package/marketplace/plugins/litcodex/components/auto-update/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@litcodex/auto-update",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "LitCodex foreground update barrier for the SessionStart and management lifecycles.",
 	"type": "module",
 	"private": true,

package/marketplace/plugins/litcodex/components/comment-checker/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@litcodex/comment-checker",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "LitCodex Comment-Checker hook: flags low-value / AI-slop comments introduced by edits.",
 	"type": "module",
 	"private": true,