aiblueprint-cli 1.4.82 → 1.4.83

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/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.83",
   "description": "AIBlueprint CLI for setting up AI coding configurations",
   "author": "AIBlueprint",
   "license": "MIT",