aiblueprint-cli 1.4.82 → 1.4.84

package/README.md

@@ -136,9 +136,12 @@ npx aiblueprint-cli@latest agents config unify sessions
 
 ### Skills
 
-Install individual skills directly into `~/.claude/skills/`:
+Install skills directly into `~/.claude/skills/`:
 
 ```bash
+# Install all skills
+npx skills@latest add melvynx/aiblueprint
+
 # Install a single skill
 npx skills add Melvynx/aiblueprint --skill ultrathink
 

package/agents-config/skills/apex/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: apex
+description: Structured implementation using the APEX method (Analyze → Plan → Execute → eXamine). Use when implementing a feature or fixing a bug that benefits from a clear, deliberate workflow instead of jumping straight to code.
+argument-hint: "[-x] <task-description>"
+---
+
+# APEX
+
+Implement `$ARGUMENTS` with a deliberate, four-phase workflow. Think before each phase.
+
+Add `-x` to the request for an extra adversarial review pass after validation.
+
+## A — Analyze
+
+Gather just enough context to act with confidence:
+
+- Use `Glob`/`Grep` to find the files and patterns you'll touch
+- Read the closest existing example and follow its conventions
+- Restate the task as 2-4 concrete acceptance criteria
+- Note open questions; ask only if a wrong assumption would be costly
+
+## P — Plan
+
+Write a short, file-by-file plan before editing:
+
+- List each file to create or change and what changes in it
+- Pick the simplest approach that satisfies the criteria
+- Order the steps so the code stays runnable along the way
+
+## E — Execute
+
+Implement the plan:
+
+- Match the surrounding code's naming, structure, and idioms
+- Stay strictly in scope — no "while I'm here" refactors
+- Comments only where intent is genuinely non-obvious
+- Run the formatter if the project has one
+
+## X — eXamine
+
+Validate, then optionally review:
+
+1. **Validate**: run `lint`, `typecheck`, and relevant tests. Fix only what you broke; re-run until clean.
+2. **Review** (only if `-x`): re-read the diff as a skeptic — check for bugs, security holes, missed edge cases, and overcomplication. Fix what you find.
+
+## Output
+
+```
+## APEX complete
+
+**Task:** {what was implemented}
+**Criteria:** {✓ per acceptance criterion}
+**Files changed:** {list}
+**Validation:** ✓ lint ✓ typecheck ✓ tests
+```
+
+## Rules
+
+- One step at a time — finish each phase before the next
+- Stay in scope; ship the smallest change that meets the criteria
+- If blocked after 2 attempts, report the blocker and stop

package/agents-config/skills/app-icon/SKILL.md

@@ -0,0 +1,161 @@
+---
+name: app-icon
+description: Generate a polished iOS + Android app icon for an Expo / React Native app with AI image generation, then post-process it to App Store / Play specs. Use for "create my app icon", "generate the iOS icon", "redo the app logo", "make the launcher icon". Requires an image-generation tool (Codex imagegen / gpt-image); without one it builds the prompt for you to run, then resumes at post-processing.
+argument-hint: "[app concept or brand]"
+---
+
+# App Icon
+
+Generate a store-quality launcher icon (iOS App Store icon + Android adaptive icon + web favicon) for an Expo / React Native app, then post-process it to meet store requirements.
+
+<capability_gate>
+**This workflow requires an image-generation tool** (Codex's `imagegen` skill backed by gpt-image, or any model/agent that can generate raster images).
+
+- **Codex**: invoke the `imagegen` skill with the prompt below. Generated files land in `~/.codex/generated_images/<session-id>/ig_*.png` — copy them into the repo.
+- **Agent WITHOUT image generation (e.g. Claude Code without an image tool)**: do NOT fake it (no SVG-to-PNG pipelines — that produces flat, amateur results). Instead: build the final prompt from the recipe below, give it to the user to run in their image tool of choice, then resume at the Post-Processing phase with the file they provide.
+</capability_gate>
+
+<locate_assets>
+Find where this app's icon actually lives before writing anything. Read the Expo config (`app.json`, `app.config.js`, or `app.config.ts`) and use the real paths:
+
+- iOS icon → `expo.icon` (commonly `./assets/icon.png` or `./assets/images/icon.png`)
+- Android adaptive icon foreground → `expo.android.adaptiveIcon.foregroundImage` (commonly `./assets/adaptive-icon.png`)
+- Android adaptive background color → `expo.android.adaptiveIcon.backgroundColor`
+- Web favicon → `expo.web.favicon` (commonly `./assets/favicon.png`)
+
+In a monorepo the app may live under `mobile-app/` or `apps/<name>/` — resolve paths relative to the Expo project root, not the repo root. Below, `<ASSETS>` means that app's resolved assets directory.
+
+Pull the **brand colors** and **app concept/name** from the project (a brand/site config, the README, or just ask the user). Use color *names* in the prompt, never hex.
+</locate_assets>
+
+<objective>
+| Asset | Target file (typical) | Spec |
+| --- | --- | --- |
+| iOS app icon | `<ASSETS>/icon.png` | 1024x1024, square, **NO transparency**, **no baked rounded mask** (iOS applies its own) |
+| Android adaptive icon | `<ASSETS>/adaptive-icon.png` | foreground layer, subject inside the central ~66% safe circle, padded |
+| Web favicon | `<ASSETS>/favicon.png` | 192x192 derived from the icon |
+</objective>
+
+<icon_recipe>
+A layered prompt that avoids the common app-icon failure modes (baked rounded tiles, logo plates, accidental text, drop-shadow "floating card" look, unwanted mascots). Fill the two project blanks — **Subject** (the product's core concept/mascot/symbol) and the **Color palette** (named brand colors, never hex) — then send the entire block as one prompt to the image model.
+
+Counter-intuitive but critical: tell the model it is **NOT** making an app-icon tile. Models bake in rounded-square plates, outer margins, and drop shadows the moment they hear "app icon". You want a full-bleed square subject filling 92-98% of the canvas; iOS applies its own mask afterward.
+
+```
+Create a 1024x1024 square symbol illustration.
+
+Subject: <single centered mark for <AppName> — the product's core concept/mascot/symbol, highly readable at small sizes>
+
+Context: standalone symbol/illustration for general use, not an app launcher icon or UI mockup.
+Do not design or imply an app icon, logo plate, badge, or rounded-square container, even if the words "app icon" or "logo" appear.
+Do not draw an icon inside a larger canvas. No outer margins, padding, or separate card background.
+Do not draw any rounded-square tile, card, or container behind the subject.
+The canvas itself is a perfect square with sharp 90° corners; do not simulate rounded-corner app icon masks or device-rounded corners.
+No global drop shadows, long cast shadows, outer glows, or halos around the subject or canvas.
+No UI mockups. No borders, frames, stickers, app plates, or device chrome.
+No text/typography (letters, numbers, monograms). No watermark.
+Not a full photo/portrait/real-world scene. No realistic human faces as the main subject.
+Do not copy or imitate real brand logos, trademarked shapes, or recognizable brand marks.
+
+Archetype (internal decision, do not mention in the output):
+Choose exactly ONE archetype: object_icon, abstract_form_icon, hybrid_icon, or character_icon. Characters are optional and must only be used when clearly appropriate; never the default.
+- object_icon: a single physical/symbolic object without a face (finance, productivity, utilities, dev tools, dashboards, system apps).
+- abstract_form_icon: pure form/metaphor without literal objects or faces (AI tools, design tools, analytics, experimental products).
+- hybrid_icon: an object with subtle life cues (no face), friendly but restrained (health, lifestyle).
+- character_icon: a friendly expressive character with a face (kids, games, beginner education, wellness, fun social).
+
+Concept:
+Design a single, intentional visual element that represents the app. Avoid generic logos and the most literal/obvious metaphor; choose a clear but slightly unexpected metaphor.
+Creativity means unusual material choices, unexpected-but-clear metaphors, expressive lighting, playful proportions, premium texture decisions. It does NOT mean always adding eyes/faces or always making it cute.
+
+Material:
+Default to an illustration-friendly matte finish (painted polymer, ceramic, paper, or flat vector). Avoid glass/chrome/neon unless explicitly requested. Material choice should communicate the product category.
+
+Composition:
+Main subject fills 92-98% of the canvas. Strong silhouette. No unnecessary elements.
+
+Lighting:
+Soft, controlled lighting. Minimal specular highlights. No bloom/glow/lens flares. No "3D glass icon" look.
+
+Overall feel:
+Modern, bold, subject-first illustration (not an app icon layout). Creative without being childish. Readable at small sizes. Clean illustration / 2D or 2.5D, matte finish, subtle shading only.
+
+Color palette: <brand colors as names — e.g. "warm peach background, deep ink subject">. Clean contrast on both light and dark backgrounds.
+
+Technical constraints:
+Square 1:1 aspect ratio.
+Main subject fills 92-98% of the canvas (zoom in; avoid excessive empty space).
+Center/balance the silhouette. Keep critical details within ~5-8% safe area.
+Android-safe: keep critical details within the central ~70% (silhouette may extend).
+Background extends to all four edges of the square canvas with straight (non-rounded) corners; keep it clean (low-detail, low-noise).
+Default-look guardrail: avoid inflated glass/chrome/neon/glow/sparkles/lens flare/exaggerated shine unless explicitly requested.
+
+Quality filters (internal):
+Reject if: it reads like a photo/portrait/full scene; it becomes a mascot by default; too many elements hurt clarity; a face appears without choosing character_icon; any rounded-square/card/tile background or app-icon container appears behind the subject.
+Accept if: instant read at small size; strong silhouette; intentional material; clean contrast on both light and dark backgrounds.
+
+Icon QA (internal): blur test (~64px), small-size readability, wallpaper contrast, one focal point.
+```
+
+**Optional style preset.** Lock a look as a HARD constraint (it wins any conflict) by appending a dominant style block before the technical constraints. Useful named looks: `minimalism`, `glassy`, `geometric`, `gradient`, `flat`, `material`, `clay`, `kawaii`. Example for `minimalism`:
+
+```
+STYLE SYSTEM: MINIMALISM (dominant — if anything conflicts, the style wins)
+Cultural DNA: Swiss design, Apple, Braun, Dieter Rams, Functionalism.
+Visual traits: max 3 colors; simple primary silhouettes; large negative space; no textures; no effects.
+Mandatory: readable at very small sizes; works in monochrome; single dominant symbol.
+Forbidden: gradients, shadows, 3D effects, decorative details, textures.
+```
+
+Non-negotiable for iOS (enforced in Post-Processing, not the prompt): the saved `icon.png` must have **no baked rounded corners** (iOS applies the mask), **no transparency** (App Store rejects alpha in the marketing icon), and stay **readable at 60px**.
+</icon_recipe>
+
+<generation_loop>
+1. Generate the icon (1-3 candidates if the concept is open).
+2. **Visually inspect every output** (open/read the images): strong silhouette? readable at small size? no baked rounded-square tile / no drop-shadow card? no accidental text or watermark? no transparency artifacts?
+3. Reject and regenerate what fails — refine the prompt, don't accept "almost".
+4. **Safety-filter gotcha**: a prompt can be rejected for ambiguous wording with harmless content. Reword to simple, neutral, single-paragraph phrasing and retry.
+5. **Blur test:** shrink to ~64px — if the mark turns to mush, the concept is too detailed; simplify the silhouette.
+</generation_loop>
+
+<post_processing>
+macOS uses `sips` (built in) + ImageMagick (`magick`, `brew install imagemagick`). Replace `<ASSETS>` and `<brand-bg-color>` with the values from `<locate_assets>`.
+
+```bash
+# 1. iOS icon: enforce 1024x1024 and strip alpha (App Store requirement)
+sips -z 1024 1024 icon-raw.png --out /tmp/icon-1024.png
+magick /tmp/icon-1024.png -background "<brand-bg-color>" -alpha remove -alpha off <ASSETS>/icon.png
+# (no ImageMagick? `sips -s format jpeg /tmp/icon-1024.png --out /tmp/icon.jpg` then back to png also strips alpha)
+
+# 2. Android adaptive icon: pad the subject into the central ~66% safe circle on a brand background.
+#    Scaling the full-bleed icon to ~66% places the SUBJECT inside the safe zone; the brand-bg extent fills the rest.
+magick <ASSETS>/icon.png -resize 66% -background "<brand-bg-color>" -gravity center -extent 1024x1024 <ASSETS>/adaptive-icon.png
+#    Then make sure app config matches: expo.android.adaptiveIcon.backgroundColor == <brand-bg-color>.
+#    (For a cleaner result you can instead re-run the recipe with "leave ~20% padding for Android adaptive safe zone".)
+
+# 3. Favicon + verification
+sips -z 192 192 <ASSETS>/icon.png --out <ASSETS>/favicon.png
+sips -g pixelWidth -g pixelHeight -g hasAlpha <ASSETS>/icon.png <ASSETS>/adaptive-icon.png <ASSETS>/favicon.png
+# icon.png MUST report hasAlpha: no
+```
+
+Remember: **icon and adaptive-icon changes require a native rebuild** (`npx expo run:ios` / `npx expo run:android`, or a new EAS build) — they will NOT appear on hot reload. The favicon is a web asset and reloads normally.
+</post_processing>
+
+<render_verification>
+File inspection is not enough for the launcher icon — confirm it on a device/simulator after a native rebuild.
+
+1. Rebuild the dev client so the new icon is bundled (`npx expo run:ios` or `npx expo run:android`).
+2. On the home screen, confirm: the icon shows the new art (not the old/default), iOS applies a clean rounded mask with no double-rounding or visible alpha edge, and the mark is readable at home-screen size.
+3. Fail the run if the icon still shows the previous art or a transparent/white corner halo. Fix before reporting completion.
+</render_verification>
+
+<failure_modes>
+- Generated icon has transparency or baked rounded corners → App Store rejection; strip alpha (`-alpha remove`), regenerate without any tile/mask.
+- iOS shows a white/transparent corner halo → alpha was not stripped; re-run the `magick ... -alpha remove -alpha off` step and rebuild.
+- Android adaptive icon looks cropped at the edges → subject sat outside the central 66% safe circle; increase padding (lower the `-resize` percentage) or regenerate with explicit padding.
+- Icon unchanged after editing the PNG → no native rebuild; hot reload never updates the launcher icon.
+- Flat/amateur output → prompt missed the "subject-first illustration, not an app icon layout" + matte/material anchors, or fell back to a generic logo.
+- Prompt rejected by safety filter → reword neutrally, simplify to one plain paragraph; content was almost certainly fine.
+- Mark turns to mush at small size → too detailed; simplify to a single strong silhouette (blur/64px test).
+</failure_modes>

package/agents-config/skills/appstore-connect/SKILL.md

@@ -8,7 +8,7 @@ description: Interact with App Store Connect via the asc CLI - apps, builds, Tes
 Read, manage, and ship any of the user's App Store apps through the **`asc`** CLI (App Store Connect CLI by Rork). `asc` covers nearly the entire ASC surface; reach for the raw API only for the rare gap.
 
 <auth>
-`asc` is already authenticated on this machine (a default keychain profile). Verify before doing real work:
+`asc` is usually already authenticated on this machine (a default keychain profile). Verify before doing real work:
 
 ```bash
 asc auth status            # shows stored credential profiles + which is default
@@ -17,7 +17,7 @@ asc doctor                 # diagnose auth/config issues
 ```
 
 - Multiple accounts/teams: `asc --profile <name> <command>` selects a profile.
-- A NEW account with no stored key: run the `appstore-connect-setup` skill (locates the `.p8`, key id, and issuer id, then `asc auth login`). Never print or commit `.p8` keys, key ids, or issuer ids.
+- **Not authenticated / no working credential / a NEW account with no stored key:** read [references/setup.md](references/setup.md) and follow it — a battle-tested workflow to locate the `.p8`, key id, and issuer id, then `asc auth login`. Never print or commit `.p8` keys, key ids, or issuer ids.
 </auth>
 
 <how_to_drive>

package/agents-config/skills/{appstore-connect-setup/SKILL.md → appstore-connect/references/setup.md}

@@ -1,12 +1,9 @@
----
-name: appstore-connect-setup
-description: Find and configure App Store Connect API credentials for asc auth. Use when asc auth is missing, credentials are unknown, the user says login to App Store Connect, or before TestFlight/App Store release work.
----
+# App Store Connect Setup (asc auth)
 
-# App Store Connect Setup
+Read this when `asc` is **not yet authenticated** — `asc auth status --validate` reports no working credential, the user asks to "log in to App Store Connect", or credentials are unknown before TestFlight/App Store release work.
 
 <objective>
-`asc auth login` needs three things: a **key ID**, an **issuer ID**, and a **.p8 private key file**. Users rarely remember where these are. This skill is a battle-tested workflow for finding all three without asking the user to dig through App Store Connect manually.
+`asc auth login` needs three things: a **key ID**, an **issuer ID**, and a **.p8 private key file**. Users rarely remember where these are. This is a battle-tested workflow for finding all three without asking the user to dig through App Store Connect manually.
 
 Key insight from a real session: the `.p8` files and key IDs live on disk, but the **issuer ID is almost never stored locally** — it only exists in the App Store Connect web UI. The trick is to read it from the user's already-signed-in browser session via CDP, since Apple login requires 2FA and cannot be automated.
 </objective>

package/agents-config/skills/ios-testflight/SKILL.md

@@ -34,7 +34,7 @@ The key insight: interactive `eas build` credential setup requires Apple ID 2FA
 The user must have (ask once, as a group — these cannot be created by the agent):
 
 1. **Apple Developer Program membership** (paid, enrolled).
-2. **App Store Connect API key**: the `AuthKey_<KEY_ID>.p8` file, its key ID, and the team issuer ID. If unknown, run the `appstore-connect-setup` skill, or point the user to App Store Connect > Users and Access > Integrations > App Store Connect API (key must have Admin or App Manager role).
+2. **App Store Connect API key**: the `AuthKey_<KEY_ID>.p8` file, its key ID, and the team issuer ID. If unknown, follow the `appstore-connect` skill's setup workflow (`references/setup.md`), or point the user to App Store Connect > Users and Access > Integrations > App Store Connect API (key must have Admin or App Manager role).
 3. **Expo account** logged in: `npx eas-cli@latest whoami` (else `npx eas-cli@latest login`).
 4. **App record in App Store Connect** for the bundle ID. The public API cannot create app records — if missing, the user creates it once at appstoreconnect.apple.com (My Apps > + > New App, selecting the bundle ID). Verify with Phase D step 1 and stop with clear instructions if absent.
 5. `asc` CLI installed (`brew install asc`) — used only for the final upload; everything else goes through `scripts/asc-api.mjs`.
@@ -47,7 +47,7 @@ The user must have (ask once, as a group — these cannot be created by the agen
 | `{bundle_id}` | `SiteConfig.bundleId` |
 | `{apple_team_id}` | `SiteConfig.appleTeamId` |
 | `{eas_project_id}` | output of `eas project:init`, then written to `site-config.ts` |
-| `{asc_key_id}` / `{asc_issuer_id}` / `{asc_p8_path}` | from the user / `appstore-connect-setup`. Never commit, never print. |
+| `{asc_key_id}` / `{asc_issuer_id}` / `{asc_p8_path}` | from the user / the `appstore-connect` skill's `references/setup.md`. Never commit, never print. |
 | `{convex_prod_url}` / `{convex_prod_site_url}` | from `npx convex deploy` output / Convex dashboard |
 | `{asc_app_id}` | numeric app ID resolved from the bundle ID (Phase D) |
 | `{build_mode}` | default `local`; `expo` only when the user passes `--expo` |

package/dist/cli.js

@@ -32265,7 +32265,7 @@ var lib_default = inquirer;
 // src/commands/setup.ts
 var import_fs_extra9 = __toESM(require_lib4(), 1);
 import path13 from "path";
-import os10 from "os";
+import os11 from "os";
 
 // node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
@@ -33686,6 +33686,7 @@ async function mergeCodexConfigFile(sourceConfigPath, codexDir) {
 
 // src/lib/configs-store.ts
 var import_fs_extra7 = __toESM(require_lib4(), 1);
+import os10 from "os";
 import path11 from "path";
 var RETENTION_MANAGED_BACKUP_TRIGGERS = new Set(["setup", "sync", "load", "backup-load"]);
 var DEFAULT_BACKUP_RETENTION_DAYS = 30;
@@ -33738,7 +33739,7 @@ async function hasContent(folderPath) {
 async function copyManagedFolder(source, destination) {
   await import_fs_extra7.default.copy(source, destination, {
     overwrite: true,
-    dereference: false
+    dereference: os10.platform() === "win32"
   });
 }
 async function writeMetadata(snapshotPath, metadata) {
@@ -34491,7 +34492,7 @@ async function setupCommand(params = {}) {
     console.log(source_default.gray(`
 Next steps:`));
     if (options.shellShortcuts) {
-      const platform = os10.platform();
+      const platform = os11.platform();
       if (platform === "win32") {
         console.log(source_default.gray("  • Restart PowerShell to load the new functions"));
       } else {
@@ -34521,7 +34522,7 @@ Next steps:`));
 // src/commands/setup-terminal.ts
 var import_fs_extra10 = __toESM(require_lib4(), 1);
 import path14 from "path";
-import os11 from "os";
+import os12 from "os";
 import { execSync as execSync3, exec as exec2 } from "child_process";
 var OHMYZSH_INSTALL_URL = "https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh";
 var INSTALL_TIMEOUT = 120000;
@@ -34688,7 +34689,7 @@ plugins=(${pluginsString})`;
 }
 async function setupTerminalCommand(options = {}) {
   const { skipInteractive, homeDir: customHomeDir } = options;
-  const homeDir = customHomeDir || os11.homedir();
+  const homeDir = customHomeDir || os12.homedir();
   try {
     console.log(source_default.blue.bold(`
 \uD83D\uDDA5️  AIBlueprint Terminal Setup ${source_default.gray(`v${getVersion()}`)}
@@ -34838,24 +34839,24 @@ Next steps:`));
 // src/commands/setup/symlinks.ts
 var import_fs_extra11 = __toESM(require_lib4(), 1);
 import path15 from "path";
-import os12 from "os";
+import os13 from "os";
 async function getToolPaths(tool, customFolder) {
   let baseDir;
   switch (tool) {
     case "claude-code":
-      baseDir = customFolder ? path15.resolve(customFolder) : path15.join(os12.homedir(), ".claude");
+      baseDir = customFolder ? path15.resolve(customFolder) : path15.join(os13.homedir(), ".claude");
       return {
         baseDir,
         agentsPath: path15.join(baseDir, "agents")
       };
     case "codex":
-      baseDir = customFolder ? path15.resolve(customFolder) : path15.join(os12.homedir(), ".codex");
+      baseDir = customFolder ? path15.resolve(customFolder) : path15.join(os13.homedir(), ".codex");
       return {
         baseDir,
         agentsPath: path15.join(baseDir, "agents")
       };
     case "factoryai":
-      baseDir = customFolder ? path15.resolve(customFolder) : path15.join(os12.homedir(), ".factory");
+      baseDir = customFolder ? path15.resolve(customFolder) : path15.join(os13.homedir(), ".factory");
       return {
         baseDir,
         agentsPath: path15.join(baseDir, "droids")
@@ -34883,7 +34884,7 @@ async function createSymlink(sourcePath, targetPath, options = {}) {
         return false;
       }
     }
-    const isWindows2 = os12.platform() === "win32";
+    const isWindows2 = os13.platform() === "win32";
     if (isWindows2) {
       await import_fs_extra11.default.symlink(sourcePath, targetPath, "junction");
     } else {
@@ -35727,14 +35728,14 @@ var Y2 = ({ indicator: t = "dots" } = {}) => {
 // src/lib/agents-unifier.ts
 var import_fs_extra13 = __toESM(require_lib4(), 1);
 import crypto from "crypto";
-import os14 from "os";
+import os15 from "os";
 import path17 from "path";
 
 // src/lib/backup-utils.ts
 var import_fs_extra12 = __toESM(require_lib4(), 1);
 import path16 from "path";
-import os13 from "os";
-var BACKUP_BASE_DIR = path16.join(os13.homedir(), ".config", "aiblueprint", "backup");
+import os14 from "os";
+var BACKUP_BASE_DIR = path16.join(os14.homedir(), ".config", "aiblueprint", "backup");
 function getBackupDir() {
   return process.env.AIBLUEPRINT_BACKUP_DIR || BACKUP_BASE_DIR;
 }
@@ -35781,7 +35782,7 @@ var MANAGED_FOLDERS = [".claude", ".codex", ".agents"];
 async function copyForBackup(sourcePath, destPath) {
   await import_fs_extra12.default.copy(sourcePath, destPath, {
     overwrite: true,
-    dereference: false
+    dereference: os14.platform() === "win32"
   });
 }
 async function hasMeaningfulContent(dir) {
@@ -36507,7 +36508,7 @@ async function ensureBackupPath(result, dryRun = false) {
 }
 async function createDirectorySymlink(source, target) {
   await import_fs_extra13.default.ensureDir(path17.dirname(target));
-  if (os14.platform() === "win32") {
+  if (os15.platform() === "win32") {
     await import_fs_extra13.default.symlink(source, target, "junction");
     return;
   }
@@ -36515,7 +36516,7 @@ async function createDirectorySymlink(source, target) {
 }
 async function createFileSymlink(source, target) {
   await import_fs_extra13.default.ensureDir(path17.dirname(target));
-  if (os14.platform() === "win32") {
+  if (os15.platform() === "win32") {
     await import_fs_extra13.default.symlink(source, target, "file");
     return;
   }
@@ -37221,7 +37222,7 @@ Codex agents render failed:`), error);
 // src/lib/session-unifier.ts
 var import_fs_extra14 = __toESM(require_lib4(), 1);
 import crypto2 from "crypto";
-import os15 from "os";
+import os16 from "os";
 import path18 from "path";
 var MANAGED_FOLDERS2 = [".claude", ".codex", ".agents"];
 var SESSION_PATHS = {
@@ -37245,7 +37246,7 @@ async function collectSnapshotSources(folders) {
     ...await listSnapshotSources(storePaths.configsDir, "config"),
     ...await listSnapshotSources(storePaths.backupsDir, "backup")
   ];
-  if (path18.resolve(folders.rootDir) === os15.homedir()) {
+  if (path18.resolve(folders.rootDir) === os16.homedir()) {
     sources.push(...await listSnapshotSources(getBackupDir(), "legacy-backup"));
   }
   return sources.sort((a, b3) => a.name.localeCompare(b3.name));
@@ -37518,7 +37519,7 @@ import path21 from "path";
 
 // src/lib/pro-installer.ts
 var import_fs_extra15 = __toESM(require_lib4(), 1);
-import os16 from "os";
+import os17 from "os";
 import path19 from "path";
 import { exec as exec3 } from "child_process";
 import { promisify as promisify2 } from "util";
@@ -37548,7 +37549,7 @@ function routePath(relativePath) {
   return { kind: "claude", relativePath };
 }
 function getCacheRepoDir() {
-  return path19.join(os16.homedir(), ".config", "aiblueprint", "pro-repos", "aiblueprint-cli-premium");
+  return path19.join(os17.homedir(), ".config", "aiblueprint", "pro-repos", "aiblueprint-cli-premium");
 }
 async function execGitWithAuth(command, token, repoUrl, cwd) {
   const authenticatedUrl = `https://x-access-token:${token}@${repoUrl.replace(/^https?:\/\//, "")}`;
@@ -37719,7 +37720,7 @@ async function installProConfigs(options) {
   } catch (error) {
     console.warn("Git caching failed, falling back to API download");
   }
-  const tempDir = path19.join(os16.tmpdir(), `aiblueprint-premium-${Date.now()}`);
+  const tempDir = path19.join(os17.tmpdir(), `aiblueprint-premium-${Date.now()}`);
   try {
     let success = false;
     for (const candidate of CONFIG_FOLDER_CANDIDATES2) {
@@ -37755,15 +37756,15 @@ async function syncAllAgentSymlinks(agentsDir, claudeDir) {
 
 // src/lib/token-storage.ts
 var import_fs_extra16 = __toESM(require_lib4(), 1);
-import os17 from "os";
+import os18 from "os";
 import path20 from "path";
 function getConfigDir() {
-  const platform = os17.platform();
+  const platform = os18.platform();
   if (platform === "win32") {
-    const appData = process.env.APPDATA || path20.join(os17.homedir(), "AppData", "Roaming");
+    const appData = process.env.APPDATA || path20.join(os18.homedir(), "AppData", "Roaming");
     return path20.join(appData, "aiblueprint");
   } else {
-    const configHome = process.env.XDG_CONFIG_HOME || path20.join(os17.homedir(), ".config");
+    const configHome = process.env.XDG_CONFIG_HOME || path20.join(os18.homedir(), ".config");
     return path20.join(configHome, "aiblueprint");
   }
 }
@@ -37799,7 +37800,7 @@ async function getToken() {
 function getTokenInfo() {
   return {
     path: getTokenFilePath2(),
-    platform: os17.platform()
+    platform: os18.platform()
   };
 }
 
@@ -38919,19 +38920,19 @@ async function configsBackupsCleanCommand(options = {}) {
 }
 
 // src/commands/openclaw-pro.ts
-import os20 from "os";
+import os21 from "os";
 import path25 from "path";
 
 // src/lib/openclaw-installer.ts
 var import_fs_extra19 = __toESM(require_lib4(), 1);
-import os18 from "os";
+import os19 from "os";
 import path23 from "path";
 import { exec as exec4 } from "child_process";
 import { promisify as promisify3 } from "util";
 var execAsync3 = promisify3(exec4);
 var OPENCLAW_PRO_REPO = "Melvynx/openclawpro";
 function getCacheRepoDir2() {
-  return path23.join(os18.homedir(), ".config", "openclaw", "pro-repos", "openclawpro");
+  return path23.join(os19.homedir(), ".config", "openclaw", "pro-repos", "openclawpro");
 }
 async function execGitWithAuth2(command, token, repoUrl, cwd) {
   const authenticatedUrl = `https://x-access-token:${token}@${repoUrl.replace(/^https?:\/\//, "")}`;
@@ -38980,7 +38981,7 @@ async function copyConfigFromCache2(cacheConfigDir, targetDir, onProgress) {
 }
 async function installOpenclawProConfigs(options) {
   const { githubToken, openclawFolder, onProgress } = options;
-  const targetFolder = openclawFolder || path23.join(os18.homedir(), ".openclaw");
+  const targetFolder = openclawFolder || path23.join(os19.homedir(), ".openclaw");
   try {
     const cacheConfigDir = await cloneOrUpdateRepo2(githubToken);
     await copyConfigFromCache2(cacheConfigDir, targetFolder, onProgress);
@@ -38992,14 +38993,14 @@ async function installOpenclawProConfigs(options) {
 
 // src/lib/openclaw-token-storage.ts
 var import_fs_extra20 = __toESM(require_lib4(), 1);
-import os19 from "os";
+import os20 from "os";
 import path24 from "path";
 function getConfigDir2() {
-  const platform = os19.platform();
+  const platform = os20.platform();
   if (platform === "win32") {
-    return path24.join(process.env.APPDATA || os19.homedir(), "openclaw");
+    return path24.join(process.env.APPDATA || os20.homedir(), "openclaw");
   }
-  return path24.join(os19.homedir(), ".config", "openclaw");
+  return path24.join(os20.homedir(), ".config", "openclaw");
 }
 function getTokenPath() {
   return path24.join(getConfigDir2(), "token.txt");
@@ -39020,7 +39021,7 @@ async function getOpenclawToken() {
 function getOpenclawTokenInfo() {
   return {
     path: getTokenPath(),
-    platform: os19.platform()
+    platform: os20.platform()
   };
 }
 
@@ -39132,7 +39133,7 @@ async function openclawProSetupCommand(options = {}) {
       Se(source_default.red("❌ Not activated"));
       process.exit(1);
     }
-    const openclawDir = options.folder ? path25.resolve(options.folder) : path25.join(os20.homedir(), ".openclaw");
+    const openclawDir = options.folder ? path25.resolve(options.folder) : path25.join(os21.homedir(), ".openclaw");
     const spinner = Y2();
     const onProgress = (file, type) => {
       spinner.message(`Installing: ${source_default.cyan(file)} ${source_default.gray(`(${type})`)}`);
@@ -39306,10 +39307,10 @@ var import_fs_extra23 = __toESM(require_lib4(), 1);
 import { spawn as spawn2 } from "child_process";
 import { execSync as execSync4 } from "child_process";
 import path27 from "path";
-import os21 from "os";
+import os22 from "os";
 function checkCommand2(cmd) {
   try {
-    const isWindows2 = os21.platform() === "win32";
+    const isWindows2 = os22.platform() === "win32";
     const whichCmd = isWindows2 ? `where ${cmd}` : `which ${cmd}`;
     execSync4(whichCmd, { stdio: "ignore" });
     return true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiblueprint-cli",
-  "version": "1.4.82",
+  "version": "1.4.84",
   "description": "AIBlueprint CLI for setting up AI coding configurations",
   "author": "AIBlueprint",
   "license": "MIT",