gdx 0.4.5 → 0.5.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Type-Delta
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Type-Delta
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -17,8 +17,8 @@ It wraps standard git commands with intelligent shorthands and adds powerful new
 
 **Why gdx?**
 
-- **👍 Convenience:** Type less, do more. `git status`? how about `gdx s`?, `git reset HEAD~3`? why not `gdx res ~3`?
-- **🛡️ Safety:** `gdx clear` wipes your directory but saves a backup patch. No more "oops" moments.
+- **👍 Convenience:** Type less, do more. `git status`? how about `gdx s`, `git reset HEAD~3`? why not `gdx res ~3`
+- **🛡️ Safety:** `gdx clear` backs up before it wipes, and `gdx history undo` is Ctrl+Z for your repo. No more "oops" moments.
 - **✨ Enhanced Output:** Git's output is... functional. `gdx` makes it beautiful and easier for _humans_ to digest.
 - **🧠 Logic:** Handles the things Git makes hard, like dropping a range of stashes, working with worktrees, or submodules.
 - **📊 Local-First Stats:** Beautiful TrueColor graphs and stats generated from your local history.
@@ -92,7 +92,7 @@ To enable features like `gdx parallel switch` (auto-cd into worktrees) and **tab
 
 Shell integration provides:
 
-- **Auto-cd support**: Allows `gdx parallel switch` to change directories
+- **Auto-cd support**: Allows switching between parallel **worktrees** and **submodules** without needing to `cd` into them manually.
 - **Tab completion**: Intelligent completion for gdx commands, shorthands, and git subcommands
 - **Completion fallback**: Falls back to native git completion when gdx has no suggestions (git fallback requires you to install git's completion scripts separately)
 
@@ -130,13 +130,14 @@ Invoke-Expression (& { (gdx --init pwsh | Out-String) })
 `gdx` isn't just a list of static aliases. It understands partial commands and expands them smartly.
 
 ```bash
-gdx s             # -> git status
-gdx sta           # -> git stash
-gdx statu         # -> git status
-gdx lg            # -> git log --oneline --graph --all --decorate
-gdx pl -au        # -> git pull --allow-unrelated-histories
-gdx ps -fl        # -> git push --force-with-lease
-gdx reset ~2      # -> git reset HEAD~2
+gdx s                 # -> git status
+gdx sta               # -> git stash
+gdx statu             # -> git status
+gdx lg                # -> git log --oneline --graph --all --decorate
+gdx pu -au            # -> git pull --allow-unrelated-histories
+gdx ps -fl            # -> git push --force-with-lease
+gdx cmi -m "Fix bug"  # -> git commit -m "Fix bug"
+gdx reset ~2          # -> git reset HEAD~2
 ```
 
 > [!NOTE]
@@ -155,12 +156,23 @@ Catch issues before they reach the remote. `gdx lint` checks for:
 
 You can configure `gdx` to run this automatically before every push.
 
-### 3. The Safety Net: `clear` vs `reset`
+### 3. The Safety Net
 
-We've all accidentally reset files we meant to keep. `gdx clear` is the solution.
+We've all accidentally nuked changes we meant to keep. `gdx` gives you ways back:
 
-- **`gdx clear`**: Creates a timestamped patch backup in a temp folder, then effectively runs `reset --hard` & `clean -fd`.
+- **`gdx clear`**: Creates a timestamped patch backup, then effectively runs `reset --hard` & `clean -fd`.
 - **`gdx clear pardon`**: "Wait, I didn't mean to do that." Applies the backup patch and restores your changes.
+- **`gdx snap`**: Creates a repository/worktree+index backup you can switch back to later.
+- **`gdx history` (Experimental)**: Ctrl+Z for Git. `gdx` keeps a repository-local journal of the commands it runs (and picks up direct `git` ref changes from reflogs, or live via `gdx history hook`) so you can step through them:
+
+   ```bash
+   gdx history           # List recorded transactions (newest first)
+   gdx history undo      # Undo the most recent transaction
+   gdx history redo      # ...changed your mind? bring it back
+   gdx history show 0    # Inspect a transaction in detail
+   ```
+
+   Undo and redo refuse to touch anything that has diverged since the recording — no silent overwrites. Entries respect a retention limit (`history.maxEntries`), and recording can be turned off with `history.enabled`.
 
 ### 4. Parallel Worktrees (Experimental)
 
@@ -185,7 +197,7 @@ using detected package managers (see `parallel.init` config for options), and **
 ignored env files** if configured (see `parallel.envPaths` config for options),
 getting the fork ready for work in no time.
 
-### 5. Git Output for Human (Experimental)
+### 5. Git Output for Humans
 
 Admit it, Git's default output isn't exactly designed for readability.
 `gdx` enhances the output of some commands with better formatting to make it less "git" to read.
@@ -217,7 +229,114 @@ gdx sta drop 2..6   # Drops stashes 2 through 6.
 gdx stash d pardon  # Restores the last dropped stash.
 ```
 
-### 7. Commits Message Generation
+### 7. GitHub CLI Wrapper (Experimental)
+
+Similar to how `gdx` wraps git, `gdx gh` wraps the GitHub CLI (`gh`) to provides better UX and some QoL features like:
+
+#### Example: `gdx gh repo create`
+
+Instead of asking you millions of obvious questions, gdx looks around to figure out what you want and only asks what matter.
+
+<details>
+<summary><strong>See how it works</strong></summary>
+
+```mermaid
+flowchart TD
+   classDef ask fill:#f59e0b,stroke:#b45309,color:#1f2937,font-weight:bold
+   classDef auto fill:#34d399,stroke:#059669,color:#064e3b,font-weight:bold
+   classDef skip fill:#94a3b8,stroke:#475569,color:#1e293b
+   classDef decision fill:#e0e7ff,stroke:#6366f1,color:#312e81
+   classDef mode fill:#6366f1,stroke:#4338ca,color:#ffffff,font-weight:bold
+   classDef final fill:#0ea5e9,stroke:#0369a1,color:#ffffff,font-weight:bold
+
+   START(["gdx gh repo create"]) --> MODE{"Which mode?"}
+   class MODE decision
+
+   MODE -- "--template / -p given" --> T["🧩 From template"]:::mode
+   MODE -- "--source given,<br/>or inside a git repo" --> P["📤 Push local"]:::mode
+   MODE -- "otherwise" --> S["✨ From scratch"]:::mode
+
+   %% ───────────── From scratch ─────────────
+   subgraph SG_S [" From scratch "]
+      S --> S_NAME{"Name in args?"}:::decision
+      S_NAME -- yes --> S_NAME_A["Skip — use positional arg"]:::skip
+      S_NAME -- no --> S_NAME_Q["Ask: repository name"]:::ask
+
+      S_NAME_A & S_NAME_Q --> S_DESC{"--description given?"}:::decision
+      S_DESC -- yes --> S_DESC_A["Skip"]:::skip
+      S_DESC -- no --> S_DESC_Q["Ask: description<br/><i>(optional)</i>"]:::ask
+
+      S_DESC_A & S_DESC_Q --> S_LIC{"--license given?"}:::decision
+      S_LIC -- yes --> S_LIC_A["Skip"]:::skip
+      S_LIC -- no --> S_LIC_Q["Ask: license<br/><i>(optional dropdown)</i>"]:::ask
+
+      S_LIC_A & S_LIC_Q --> S_VIS{"--public/--private/<br/>--internal given?"}:::decision
+      S_VIS -- yes --> S_VIS_A["Skip"]:::skip
+      S_VIS -- no --> S_VIS_Q["Ask: visibility<br/><i>(default: private)</i>"]:::ask
+
+      S_VIS_A & S_VIS_Q --> S_CLONE["Auto: --clone<br/><i>(unless --clone/--no-clone given)</i>"]:::auto
+   end
+
+   %% ───────────── From template ─────────────
+   subgraph SG_T [" From template "]
+      T --> T_NAME{"Name in args?"}:::decision
+      T_NAME -- yes --> T_NAME_A["Skip — use positional arg"]:::skip
+      T_NAME -- no --> T_NAME_Q["Ask: repository name"]:::ask
+
+      T_NAME_A & T_NAME_Q --> T_DESC{"--description given?"}:::decision
+      T_DESC -- yes --> T_DESC_A["Skip"]:::skip
+      T_DESC -- no --> T_DESC_Q["Ask: description<br/><i>(optional)</i>"]:::ask
+
+      T_DESC_A & T_DESC_Q --> T_LIC["License question skipped<br/><i>(template provides files)</i>"]:::skip
+
+      T_LIC --> T_VIS{"--public/--private/<br/>--internal given?"}:::decision
+      T_VIS -- yes --> T_VIS_A["Skip"]:::skip
+      T_VIS -- no --> T_VIS_Q["Ask: visibility<br/><i>(default: private)</i>"]:::ask
+
+      T_VIS_A & T_VIS_Q --> T_CLONE["Auto: --clone if outside a repo<br/><i>(unless --clone/--no-clone given)</i>"]:::auto
+   end
+
+   %% ───────────── Push local ─────────────
+   subgraph SG_P [" Push local "]
+      P --> P_META["Read package.json /<br/>pyproject.toml metadata"]:::auto
+
+      P_META --> P_NAME{"Name in args<br/>or in metadata?"}:::decision
+      P_NAME -- "in args" --> P_NAME_A["Skip"]:::skip
+      P_NAME -- "in metadata" --> P_NAME_M["Auto-fill from manifest"]:::auto
+      P_NAME -- neither --> P_NAME_Q["Ask: repository name"]:::ask
+
+      P_NAME_A & P_NAME_M & P_NAME_Q --> P_DESC{"--description given<br/>or in metadata?"}:::decision
+      P_DESC -- "in args" --> P_DESC_A["Skip"]:::skip
+      P_DESC -- "in metadata" --> P_DESC_M["Auto-fill from manifest"]:::auto
+      P_DESC -- neither --> P_DESC_Q["Ask: description<br/><i>(optional)</i>"]:::ask
+
+      P_DESC_A & P_DESC_M & P_DESC_Q --> P_VIS{"--public/--private/<br/>--internal given?"}:::decision
+      P_VIS -- yes --> P_VIS_A["Skip"]:::skip
+      P_VIS -- no --> P_VIS_Q["Ask: visibility<br/><i>(default: private)</i>"]:::ask
+
+      P_VIS_A & P_VIS_Q --> P_FILL["Auto: --source ‹repo root›<br/>--remote origin · --push"]:::auto
+   end
+
+   S_CLONE & T_CLONE & P_FILL --> CONFIRM["📋 Show summary &<br/>confirm"]:::final
+   CONFIRM --> RUN(["▶ gh repo create ‹args›"]):::final
+
+   %% Legend
+   subgraph LEGEND ["Legend"]
+      L1["Asked interactively"]:::ask
+      L2["Auto-filled"]:::auto
+      L3["Skipped — already provided"]:::skip
+   end
+```
+
+</details>
+
+With this you will only be asked a maximum of 4 questions, only the ones you care about.
+
+Oh! did I mention that the "Form" now looks like this?
+
+![gh repo create tui](https://github.com/Type-Delta/gdx/raw/main/resources/images/gdx-gh-repo-create-form.png)
+
+### 8. Commits Message Generation
 
 Struggling to come up with a commit message? Let `gdx` do it for you.
 
@@ -230,11 +349,11 @@ gdx cmi auto --no-commit --copy
 # You can also configure which LLM to use with `gdx-config`
 ```
 
-Unlike most AI commit message generators, by default `gdx` creates messages generation guidelines and instructions based on your repo's history and conventions.
+Unlike most AI commit message generators, by default `gdx` creates messages generation guidelines based on your repo's history and conventions.
 This ensures the generated messages fit your project's style and tone.
 Said guidelines are updated every month to reflect your evolving commit style.
 
-### 8. Fun & Analytics
+### 9. Fun & Analytics
 
 Tools to help you feel productive without leaving the terminal.
 
@@ -253,7 +372,7 @@ Tools to help you feel productive without leaving the terminal.
 | Command           | Expansion / Function                                                                         |
 | :---------------- | :------------------------------------------------------------------------------------------- |
 | `s`, `stat`       | `git status` (use `-r` recursively run "status" on all submodules)                           |
-| `lg`, `lo`        | `git log --oneline --graph --all --decorate`                                                 |
+| `lg`              | `git log --oneline --graph --all --decorate`                                                 |
 | `sw`, `swit`      | `git switch`                                                                                 |
 | `br`, `bra`       | `git branch`                                                                                 |
 | `ps`              | `git push` with option expansion `-fl`=`--force-with-lease`                                  |
@@ -265,6 +384,7 @@ Tools to help you feel productive without leaving the terminal.
 | `dif`             | `git diff` (supports `dif ~3`, `dif origin ~2` expansion)                                    |
 | `sho`             | `git show` (supports `sho ~3`, `sho origin ~2` expansion)                                    |
 | `sta`, `st`       | `git stash`                                                                                  |
+| `rst`             | `git restore`                                                                                |
 | `lint`            | Run pre-push checks (spelling, secrets, etc.)                                                |
 | `gdx-config`      | Manage gdx configuration                                                                     |
 | `reword`, `rew`   | Rewrite commit messages                                                                      |
@@ -274,8 +394,10 @@ Tools to help you feel productive without leaving the terminal.
 | `graph`           | Render a GitHub-style contribution heatmap in the terminal                                   |
 | `nocap`           | Roast your latest commit message with AI                                                     |
 | `clear`           | Wipe changes in the working directory with a backup patch                                    |
+| `history`, `his`  | Inspect, undo, and redo recorded repository transactions                                     |
 | `cache`           | Manage gdx cache                                                                             |
 | `macro`           | Create custom gdx command macros to run multiple commands with a single macro                |
+| `gh`              | GitHub CLI wrapper, provides better UX and QoL features                                      |
 
 _Run `gdx ghelp` to see the full list of expansions/commands._
 
@@ -284,7 +406,7 @@ _Run `gdx ghelp` to see the full list of expansions/commands._
 | Command                           | Expansion / Function                                                                                 |
 | :-------------------------------- | :--------------------------------------------------------------------------------------------------- |
 | `tag mv`, `tag move`              | Move a tag to a new commit (supports ref expansion)                                                  |
-| `lg export`                       | Export git log to a markdown file with enhanced formatting                                           |
+| `log export`                      | Export git log to a markdown file with enhanced formatting                                           |
 | `commit auto`                     | Generate commit messages with AI based on staged changes (supports `--no-commit` and `--copy` flags) |
 | `stash drop`                      | Drop stashes with advanced options (e.g., `drop 2..6`)                                               |
 | `stash drop pardon`               | Restore the last dropped stash                                                                       |
@@ -332,7 +454,7 @@ Since this is currently a solo "scratch your own itch" project, the roadmap is f
 - [x] **Submodule dir switching**: extension of `git submodule`, `gdx submodule switch` to jump into a submodule's directory from the parent repo (requires shell integration)
 - [x] **Snapshot**: `gdx snap` to create snapshot of current state of your working directory (including uncommitted changes, untracked files) that can be easily switched back to later (similar to a lightweight, temporary branch that doesn't clutter your branch list)
 - [ ] **Enhanced output for more commands**: Extend the "Git Output for Humans"
-- [ ] **Undo and Redo**: `gdx undo` and `gdx redo` to step backward and forward through git actions (reset, commit, stash, etc.) with safety nets.
+- [x] **Undo and Redo**: `gdx history undo` and `gdx history redo` to step backward and forward through git actions (commit, add, branch, switch, etc.) with safety nets.
 - [x] **Edit commit messages**: `gdx reword` to quickly reword the last commit message or a specific commit without needing to do an interactive rebase.
 
 ## License

package/dist/diagnostics/postinstall.validator.js

@@ -0,0 +1,54 @@
+import{execFile as U}from"node:child_process";import J from"node:fs";import O from"node:path";import{promisify as Y}from"node:util";var Z=Y(U),$=20000,C=["shiki"];async function T(w){let j=[L(w),M(w),V(w)];if(w.isNative)return j.push({name:"External dependencies",status:"pass",detail:"Bundled into the native executable; Node package probes are not required."}),j;let z;try{z=K(w.packageRoot)}catch(G){return j.push({name:"External dependencies",status:"fail",detail:G instanceof Error?G.message:String(G)}),j}let B=await Promise.all(z.map((G)=>W(w.packageRoot,G)));return j.push(...B),j}function K(w){let j=O.join(w,"package.json"),z=JSON.parse(J.readFileSync(j,"utf8"));return[...new Set([...Object.keys(z.dependencies??{}),...C])]}function L(w){let j=["package.json","scripts/launcher.cjs","scripts/postinstall.cjs"],z=w.isNative?j:[...j,"dist/index.js","dist/workers/generic.worker.min.js"],B=z.filter((H)=>!J.existsSync(O.join(w.packageRoot,H))),G=["dist/diagnostics/postinstall.validator.js","bin/diagnostics/postinstall.validator.js"];if(!G.some((H)=>J.existsSync(O.join(w.packageRoot,H))))B.push(G.join(" or "));return B.length===0?{name:"Required artifacts",status:"pass",detail:`${z.length+1} packaged artifacts are present.`}:{name:"Required artifacts",status:"fail",detail:`Missing: ${B.join(", ")}`}}function M(w){if(!w.installInfo)return{name:"Install metadata",status:"fail",detail:"Postinstall did not produce bin/native/install.json."};try{let j=JSON.parse(J.readFileSync(O.join(w.packageRoot,"package.json"),"utf8")),z=[];if(w.installInfo.version!==j.version)z.push(`version ${String(w.installInfo.version)} (expected ${j.version})`);if(w.installInfo.platform!==process.platform)z.push(`platform ${String(w.installInfo.platform)} (expected ${process.platform})`);if(w.installInfo.arch!==process.arch)z.push(`architecture ${String(w.installInfo.arch)} (expected ${process.arch})`);return z.length===0?{name:"Install metadata",status:"pass",detail:"Version, platform, and architecture match this installation."}:{name:"Install metadata",status:"fail",detail:`Mismatched ${z.join("; ")}.`}}catch(j){return{name:"Install metadata",status:"fail",detail:j instanceof Error?j.message:String(j)}}}function V(w){let j=w.installInfo;if(!j)return{name:"Command shim",status:"fail",detail:"bin/native/install.json is missing or unreadable."};if(w.isNative){if(j.mode==="node"||j.mode==="runtime")return{name:"Command shim",status:"fail",detail:"Install metadata selects a JavaScript runtime fallback, but a stale native binary was launched."};let H=typeof j.binaryPath==="string"?j.binaryPath:process.execPath,Q=j.useNativeShim===!0;return{name:"Command shim",status:Q?"pass":"warn",detail:Q?`The npm shim targets the native binary (${H}).`:"The native binary is running, but postinstall did not confirm a native shim."}}let z=j.useGlobalShim===!0||j.useLocalShim===!0,B=process.env.GDX_RUNTIME_SHIM==="1"||process.env.GDX_NODE_SHIM==="1",G=typeof j.runtime==="string"?j.runtime:"node";if(!z)return{name:"Command shim",status:"warn",detail:"Postinstall did not record a rewritten runtime shim (common with non-npm installers)."};return{name:"Command shim",status:B?"pass":"fail",detail:B?`The postinstall ${G} shim is installed and active for this invocation.`:`A rewritten ${G} shim was recorded, but this invocation bypassed it.`}}async function W(w,j){try{let{stdout:z}=await Z(process.execPath,["--input-type=module","--eval",X(),w,j],{cwd:w,timeout:$,windowsHide:!0,env:{...process.env,GDX_DOCTOR_PROBE:"1"}}),B=JSON.parse(z.trim()),G=j==="keytar"&&!B.ok;return{name:`Dependency: ${j}`,status:B.ok?"pass":G?"warn":"fail",detail:B.detail}}catch(z){let B=z instanceof Error?z.message:String(z);return{name:`Dependency: ${j}`,status:j==="keytar"?"warn":"fail",detail:`Probe failed: ${B}`}}}function X(){return String.raw`
+const packageRoot = process.argv[1];
+const dependency = process.argv[2];
+
+try {
+   process.chdir(packageRoot);
+   const imported = await import(dependency);
+   const module = imported.default && Object.keys(imported).length === 1 ? imported.default : imported;
+
+   if (dependency === 'keytar') {
+      const keytar = imported.default ?? imported;
+      const service = 'gdx-doctor-probe';
+      const account = 'probe-' + process.pid + '-' + Date.now();
+      const secret = 'gdx-keychain-round-trip';
+      try {
+         await keytar.setPassword(service, account, secret);
+         const value = await keytar.getPassword(service, account);
+         if (value !== secret) throw new Error('Keychain returned an unexpected value.');
+      } finally {
+         await keytar.deletePassword(service, account).catch(() => false);
+      }
+   } else if (dependency === 'yaml') {
+      if (imported.parse('healthy: true').healthy !== true) throw new Error('YAML parse failed.');
+   } else if (dependency === 'fflate') {
+      const input = imported.strToU8('gdx');
+      if (imported.strFromU8(imported.gunzipSync(imported.gzipSync(input))) !== 'gdx') throw new Error('Compression round-trip failed.');
+   } else if (dependency === 'diff') {
+      if (!imported.diffChars('gdx', 'GDX').some((part) => part.added)) throw new Error('Diff smoke test failed.');
+   } else if (dependency === '@leeoniya/ufuzzy') {
+      const U = imported.default;
+      const fuzzy = new U();
+      if (!Array.isArray(fuzzy.filter(['gdx'], 'gdx'))) throw new Error('Fuzzy-search smoke test failed.');
+   } else if (dependency === 'openai') {
+      const OpenAI = imported.default ?? imported.OpenAI;
+      if (!new OpenAI({ apiKey: 'doctor-probe-key' }).chat) throw new Error('OpenAI client construction failed.');
+   } else if (dependency === 'cspell-lib') {
+      if (typeof imported.getDefaultSettings !== 'function') throw new Error('cspell settings API is unavailable.');
+      imported.getDefaultSettings();
+   } else if (dependency === '@shikijs/cli') {
+      if (typeof imported.codeToANSI !== 'function') throw new Error('Shiki ANSI API is unavailable.');
+      await imported.codeToANSI('const gdx = true', 'typescript', 'github-dark');
+   } else if (dependency === 'shiki') {
+      if (typeof imported.codeToHtml !== 'function') throw new Error('Shiki HTML API is unavailable.');
+      const html = await imported.codeToHtml('const gdx = true', { lang: 'typescript', theme: 'github-dark' });
+      if (!html.includes('<pre')) throw new Error('Syntax highlighting smoke test failed.');
+   } else if (!module) {
+      throw new Error('Imported module was empty.');
+   }
+
+   process.stdout.write(JSON.stringify({ ok: true, detail: 'Resolved, imported, and passed its smoke test.' }));
+} catch (error) {
+   process.stdout.write(JSON.stringify({ ok: false, detail: error instanceof Error ? error.message : String(error) }));
+}
+`}export{T as runPostInstallDiagnostics};