lynxprompt 1.1.0 → 1.2.0

package/dist/index.js

@@ -2,7 +2,7 @@
 
 // src/index.ts
 import { Command } from "commander";
-import chalk17 from "chalk";
+import chalk18 from "chalk";
 
 // src/commands/login.ts
 import chalk from "chalk";
@@ -151,6 +151,35 @@ var ApiClient = class {
       body: JSON.stringify(data)
     });
   }
+  // Hierarchy endpoints
+  async listHierarchies(options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit) params.set("limit", options.limit.toString());
+    if (options.offset) params.set("offset", options.offset.toString());
+    const query = params.toString();
+    return this.request(
+      `/api/v1/hierarchies${query ? `?${query}` : ""}`
+    );
+  }
+  async getHierarchy(id) {
+    let apiId = id;
+    if (!id.startsWith("ha_")) {
+      apiId = `ha_${id}`;
+    }
+    return this.request(`/api/v1/hierarchies/${apiId}`);
+  }
+  async createHierarchy(data) {
+    return this.request("/api/v1/hierarchies", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async deleteHierarchy(id) {
+    const apiId = id.startsWith("ha_") ? id : `ha_${id}`;
+    return this.request(`/api/v1/hierarchies/${apiId}`, {
+      method: "DELETE"
+    });
+  }
   // AI endpoints
   async aiEditBlueprint(data) {
     return this.request("/api/ai/edit-blueprint", {
@@ -670,6 +699,9 @@ function getSourceFromVisibility(visibility) {
       return "marketplace";
   }
 }
+function isHierarchyId(id) {
+  return id.startsWith("ha_");
+}
 async function pullCommand(id, options) {
   if (!isAuthenticated()) {
     console.log(
@@ -677,6 +709,113 @@ async function pullCommand(id, options) {
     );
     process.exit(1);
   }
+  if (isHierarchyId(id)) {
+    await pullHierarchy(id, options);
+  } else {
+    await pullBlueprint(id, options);
+  }
+}
+async function pullHierarchy(id, options) {
+  const cwd = process.cwd();
+  const spinner = ora4(`Fetching hierarchy ${chalk5.cyan(id)}...`).start();
+  try {
+    const response = await api.getHierarchy(id);
+    const { hierarchy, blueprints } = response;
+    spinner.stop();
+    console.log();
+    console.log(chalk5.cyan(`\u{1F4C1} Hierarchy: ${chalk5.bold(hierarchy.name)}`));
+    if (hierarchy.description) {
+      console.log(chalk5.gray(`   ${hierarchy.description}`));
+    }
+    console.log(chalk5.gray(`   Repository: ${hierarchy.repository_root}`));
+    console.log(chalk5.gray(`   Blueprints: ${blueprints.length}`));
+    console.log();
+    if (options.preview) {
+      console.log(chalk5.yellow("\u{1F4CB} Hierarchy structure:"));
+      console.log();
+      for (const bp of blueprints) {
+        const indent = bp.parent_id ? "  \u21B3 " : "  ";
+        const path2 = bp.repository_path || TYPE_TO_FILENAME[bp.type] || "unknown";
+        console.log(chalk5.gray(`${indent}${path2}`));
+        console.log(chalk5.gray(`${indent}  \u2514\u2500 ${bp.name} (${bp.id})`));
+      }
+      console.log();
+      console.log(chalk5.gray("Run without --preview to download this hierarchy."));
+      return;
+    }
+    if (!options.yes && blueprints.length > 1) {
+      const { proceed } = await prompts({
+        type: "confirm",
+        name: "proceed",
+        message: `Download ${blueprints.length} blueprints to ${options.output}?`,
+        initial: true
+      });
+      if (!proceed) {
+        console.log(chalk5.gray("Cancelled."));
+        return;
+      }
+    }
+    console.log(chalk5.cyan("\u{1F4E5} Downloading blueprints..."));
+    console.log();
+    let downloaded = 0;
+    let skipped = 0;
+    for (const bp of blueprints) {
+      const filename = bp.repository_path || TYPE_TO_FILENAME[bp.type] || "ai-config.md";
+      const outputPath = join2(options.output, filename);
+      if (existsSync(outputPath) && !options.yes) {
+        const { overwrite } = await prompts({
+          type: "confirm",
+          name: "overwrite",
+          message: `File exists: ${filename}. Overwrite?`,
+          initial: false
+        });
+        if (!overwrite) {
+          console.log(chalk5.gray(`  \u23ED Skipped: ${filename}`));
+          skipped++;
+          continue;
+        }
+      }
+      const { blueprint } = await api.getBlueprint(bp.id);
+      if (!blueprint.content) {
+        console.log(chalk5.yellow(`  \u26A0 No content: ${filename}`));
+        skipped++;
+        continue;
+      }
+      const dir = dirname2(outputPath);
+      if (dir !== "." && dir !== options.output) {
+        await mkdir2(dir, { recursive: true });
+      }
+      await writeFile2(outputPath, blueprint.content, "utf-8");
+      if (options.track !== false) {
+        const source = getSourceFromVisibility(blueprint.visibility);
+        await trackBlueprint(cwd, {
+          id: blueprint.id,
+          name: blueprint.name,
+          file: filename,
+          content: blueprint.content,
+          source
+        });
+      }
+      console.log(chalk5.green(`  \u2713 ${filename}`));
+      downloaded++;
+    }
+    console.log();
+    console.log(chalk5.green(`\u2705 Downloaded ${downloaded} blueprint(s)`));
+    if (skipped > 0) {
+      console.log(chalk5.gray(`   Skipped: ${skipped}`));
+    }
+    console.log();
+    console.log(chalk5.gray("Tips:"));
+    console.log(chalk5.gray(`  \u2022 Run 'lynxp status' to see tracked blueprints`));
+    console.log(chalk5.gray(`  \u2022 Run 'lynxp sync' to push local changes`));
+    console.log(chalk5.gray(`  \u2022 Run 'lynxp pull ${id}' again to refresh all files`));
+    console.log();
+  } catch (error) {
+    spinner.fail("Failed to pull hierarchy");
+    handleApiError2(error);
+  }
+}
+async function pullBlueprint(id, options) {
   const cwd = process.cwd();
   const spinner = ora4(`Fetching blueprint ${chalk5.cyan(id)}...`).start();
   try {
@@ -694,6 +833,12 @@ async function pullCommand(id, options) {
       console.log(chalk5.gray(`   ${blueprint.description}`));
     }
     console.log(chalk5.gray(`   Type: ${blueprint.type} \u2022 Tier: ${blueprint.tier} \u2022 Visibility: ${blueprint.visibility}`));
+    if (blueprint.hierarchy_id) {
+      console.log(chalk5.blue(`   \u{1F4C1} Part of hierarchy: ${blueprint.hierarchy_id}`));
+      if (blueprint.repository_path) {
+        console.log(chalk5.gray(`   Path in hierarchy: ${blueprint.repository_path}`));
+      }
+    }
     if (isMarketplace) {
       console.log(chalk5.yellow(`   \u{1F4E6} Marketplace blueprint (read-only - changes won't sync back)`));
     } else if (source === "team") {
@@ -730,7 +875,7 @@ async function pullCommand(id, options) {
       console.log(chalk5.gray("Run without --preview to download this blueprint."));
       return;
     }
-    const filename = TYPE_TO_FILENAME[blueprint.type] || "ai-config.md";
+    const filename = blueprint.repository_path || TYPE_TO_FILENAME[blueprint.type] || "ai-config.md";
     const outputPath = join2(options.output, filename);
     let localContent = null;
     if (existsSync(outputPath)) {
@@ -823,6 +968,9 @@ async function pullCommand(id, options) {
     console.log(chalk5.green(`\u2705 Downloaded: ${chalk5.bold(outputPath)}`));
     if (options.track !== false) {
       console.log(chalk5.gray(`   Linked to: ${blueprint.id}`));
+      if (blueprint.content_checksum) {
+        console.log(chalk5.gray(`   Checksum: ${blueprint.content_checksum}`));
+      }
       if (isMarketplace) {
         console.log(chalk5.gray(`   Updates: Run 'lynxp pull ${id}' to sync updates`));
       } else {
@@ -873,18 +1021,18 @@ function handleApiError2(error) {
       );
     } else if (error.statusCode === 403) {
       console.error(
-        chalk5.red("\u2717 You don't have access to this blueprint.")
+        chalk5.red("\u2717 You don't have access to this blueprint or hierarchy.")
       );
       console.error(
         chalk5.gray(
-          "  This might be a private blueprint or require a higher subscription tier."
+          "  This might be a private resource or require a higher subscription tier."
         )
       );
     } else if (error.statusCode === 404) {
-      console.error(chalk5.red("\u2717 Blueprint not found."));
+      console.error(chalk5.red("\u2717 Blueprint or hierarchy not found."));
       console.error(
         chalk5.gray(
-          "  Make sure you have the correct blueprint ID. Use 'lynxp list' to see your blueprints."
+          "  Make sure you have the correct ID. Use 'lynxp list' or 'lynxp hierarchies' to see your resources."
         )
       );
     } else {
@@ -904,64 +1052,46 @@ import path from "path";
 import { createHash as createHash2 } from "crypto";
 import prompts2 from "prompts";
 async function detectHierarchyInfo(cwd, file) {
+  const repositoryRoot = createRepositoryRoot(cwd);
   const result = {
     repositoryPath: null,
-    repositoryRoot: null,
-    parentId: null
+    hierarchyId: null,
+    parentId: null,
+    repositoryRoot
   };
   try {
-    const hierarchyPath = path.join(cwd, ".lynxprompt", "hierarchy.json");
-    if (fs.existsSync(hierarchyPath)) {
-      const hierarchyData = JSON.parse(fs.readFileSync(hierarchyPath, "utf-8"));
-      const relativePath = path.relative(cwd, path.resolve(file));
-      for (const group of hierarchyData.hierarchy || []) {
-        if (group.rootFile === relativePath) {
-          result.repositoryPath = relativePath;
-          result.repositoryRoot = createRepositoryRoot(hierarchyData.rootPath || cwd);
-          break;
-        }
-        for (const child of group.children || []) {
-          if (child.path === relativePath) {
-            result.repositoryPath = relativePath;
-            result.repositoryRoot = createRepositoryRoot(hierarchyData.rootPath || cwd);
-            if (group.rootFile) {
-              const blueprints = await loadBlueprints(cwd);
-              const parentBlueprint = blueprints.blueprints.find(
-                (b) => b.file === group.rootFile
-              );
-              if (parentBlueprint) {
-                result.parentId = parentBlueprint.id;
-              }
-            }
-            break;
-          }
-        }
-      }
-    }
-    if (!result.repositoryPath) {
-      const relativePath = path.relative(cwd, path.resolve(file));
-      if (relativePath.includes(path.sep) && !relativePath.startsWith("..")) {
-        result.repositoryPath = relativePath;
-        result.repositoryRoot = createRepositoryRoot(cwd);
-        const rootAgentsMd = path.join(cwd, "AGENTS.md");
-        if (fs.existsSync(rootAgentsMd) && path.resolve(file) !== rootAgentsMd) {
-          const blueprints = await loadBlueprints(cwd);
-          const parentBlueprint = blueprints.blueprints.find(
-            (b) => b.file === "AGENTS.md"
-          );
-          if (parentBlueprint) {
-            result.parentId = parentBlueprint.id;
-          }
+    const relativePath = path.relative(cwd, path.resolve(file));
+    if (relativePath.includes(path.sep) && !relativePath.startsWith("..")) {
+      result.repositoryPath = relativePath;
+      const rootAgentsMd = path.join(cwd, "AGENTS.md");
+      if (fs.existsSync(rootAgentsMd) && path.resolve(file) !== rootAgentsMd) {
+        const blueprints = await loadBlueprints(cwd);
+        const parentBlueprint = blueprints.blueprints.find(
+          (b) => b.file === "AGENTS.md"
+        );
+        if (parentBlueprint) {
+          result.parentId = parentBlueprint.id;
         }
-      } else if (relativePath === "AGENTS.md" || relativePath === path.basename(file)) {
-        result.repositoryPath = relativePath;
-        result.repositoryRoot = createRepositoryRoot(cwd);
       }
+    } else if (relativePath === "AGENTS.md" || relativePath === path.basename(file)) {
+      result.repositoryPath = relativePath;
     }
-  } catch (error) {
+  } catch {
   }
   return result;
 }
+async function ensureHierarchy(cwd, repositoryRoot, name) {
+  try {
+    const response = await api.createHierarchy({
+      name,
+      repository_root: repositoryRoot
+    });
+    return response.hierarchy.id;
+  } catch (error) {
+    console.log(chalk6.gray("   Note: Hierarchy creation skipped"));
+    return null;
+  }
+}
 function createRepositoryRoot(rootPath) {
   try {
     const gitConfigPath = path.join(rootPath, ".git", "config");
@@ -999,12 +1129,12 @@ async function pushCommand(fileArg, options) {
   const filename = path.basename(file);
   const linked = await findBlueprintByFile(cwd, file);
   if (linked) {
-    await updateBlueprint(cwd, file, linked.id, content, options);
+    await updateBlueprint(cwd, file, linked.id, content, options, linked.checksum);
   } else {
     await createOrLinkBlueprint(cwd, file, filename, content, options);
   }
 }
-async function updateBlueprint(cwd, file, blueprintId, content, options) {
+async function updateBlueprint(cwd, file, blueprintId, content, options, expectedChecksum) {
   console.log(chalk6.cyan(`
 \u{1F4E4} Updating blueprint ${chalk6.bold(blueprintId)}...`));
   console.log(chalk6.gray(`   File: ${file}`));
@@ -1022,15 +1152,32 @@ async function updateBlueprint(cwd, file, blueprintId, content, options) {
   }
   const spinner = ora5("Pushing changes...").start();
   try {
-    const result = await api.updateBlueprint(blueprintId, { content });
+    const updateData = { content };
+    if (expectedChecksum && !options.force) {
+      updateData.expected_checksum = expectedChecksum;
+    }
+    const result = await api.updateBlueprint(blueprintId, updateData);
     spinner.succeed("Blueprint updated!");
     await updateChecksum(cwd, file, content);
     console.log();
     console.log(chalk6.green(`\u2705 Successfully updated ${chalk6.bold(result.blueprint.name)}`));
     console.log(chalk6.gray(`   ID: ${blueprintId}`));
+    if (result.blueprint.content_checksum) {
+      console.log(chalk6.gray(`   Checksum: ${result.blueprint.content_checksum}`));
+    }
     console.log(chalk6.gray(`   View: https://lynxprompt.com/templates/${blueprintId.replace("bp_", "")}`));
   } catch (error) {
     spinner.fail("Failed to update blueprint");
+    if (error instanceof ApiRequestError && error.statusCode === 409) {
+      console.log();
+      console.log(chalk6.yellow("\u26A0 Conflict: The blueprint has been modified since you last pulled it."));
+      console.log(chalk6.gray("  Someone else may have pushed changes."));
+      console.log();
+      console.log(chalk6.gray("Options:"));
+      console.log(chalk6.gray("  1. Run 'lynxp pull " + blueprintId + "' to get the latest version"));
+      console.log(chalk6.gray("  2. Run 'lynxp push --force' to overwrite remote changes"));
+      process.exit(1);
+    }
     handleError(error);
   }
 }
@@ -1087,6 +1234,10 @@ async function createOrLinkBlueprint(cwd, file, filename, content, options) {
     name = filename.replace(/\.(md|mdc|json|yml|yaml)$/, "");
   }
   const hierarchyInfo = await detectHierarchyInfo(cwd, file);
+  let hierarchyId = null;
+  if (hierarchyInfo.repositoryPath) {
+    hierarchyId = await ensureHierarchy(cwd, hierarchyInfo.repositoryRoot, path.basename(cwd));
+  }
   const spinner = ora5("Creating blueprint...").start();
   try {
     const result = await api.createBlueprint({
@@ -1096,9 +1247,9 @@ async function createOrLinkBlueprint(cwd, file, filename, content, options) {
       visibility,
       tags,
       // Include hierarchy info if detected
+      hierarchy_id: hierarchyId,
       parent_id: hierarchyInfo.parentId,
-      repository_path: hierarchyInfo.repositoryPath,
-      repository_root: hierarchyInfo.repositoryRoot
+      repository_path: hierarchyInfo.repositoryPath
     });
     spinner.succeed("Blueprint created!");
     await trackBlueprint(cwd, {
@@ -1115,6 +1266,9 @@ async function createOrLinkBlueprint(cwd, file, filename, content, options) {
     if (hierarchyInfo.repositoryPath) {
       console.log(chalk6.gray(`   Path: ${hierarchyInfo.repositoryPath}`));
     }
+    if (result.blueprint.hierarchy_id) {
+      console.log(chalk6.gray(`   Hierarchy: ${result.blueprint.hierarchy_id}`));
+    }
     if (hierarchyInfo.parentId) {
       console.log(chalk6.cyan(`   \u21B3 Linked to parent blueprint: ${hierarchyInfo.parentId}`));
     }
@@ -3024,7 +3178,7 @@ function generateYamlConfig(options, platform2) {
 
 // src/commands/wizard.ts
 var DRAFTS_DIR = ".lynxprompt/drafts";
-var CLI_VERSION = "1.1.0";
+var CLI_VERSION = "1.2.0";
 async function saveDraftLocally(name, config2, stepReached) {
   const draftsPath = join4(process.cwd(), DRAFTS_DIR);
   await mkdir3(draftsPath, { recursive: true });
@@ -7599,8 +7753,76 @@ async function saveHierarchyInfo(rootPath, result) {
   }
 }
 
+// src/commands/hierarchies.ts
+import chalk17 from "chalk";
+import ora15 from "ora";
+async function hierarchiesCommand(options) {
+  if (!isAuthenticated()) {
+    console.log(chalk17.yellow("You need to be logged in to view hierarchies."));
+    console.log(chalk17.gray("Run 'lynxp login' to authenticate."));
+    process.exit(1);
+  }
+  const spinner = ora15("Fetching hierarchies...").start();
+  try {
+    const response = await api.listHierarchies({
+      limit: options.limit || 50
+    });
+    spinner.stop();
+    if (options.json) {
+      console.log(JSON.stringify(response, null, 2));
+      return;
+    }
+    const { hierarchies, total } = response;
+    if (hierarchies.length === 0) {
+      console.log();
+      console.log(chalk17.yellow("No hierarchies found."));
+      console.log();
+      console.log(chalk17.gray("Hierarchies are created automatically when you push AGENTS.md files from a repository."));
+      console.log(chalk17.gray("Run 'lynxp push AGENTS.md' in a git repository to create a hierarchy."));
+      console.log();
+      return;
+    }
+    console.log();
+    console.log(chalk17.cyan(`\u{1F4C1} Your Hierarchies (${total} total)`));
+    console.log();
+    for (const hierarchy of hierarchies) {
+      console.log(chalk17.bold(`  ${hierarchy.name}`));
+      console.log(chalk17.gray(`    ID: ${hierarchy.id}`));
+      if (hierarchy.description) {
+        console.log(chalk17.gray(`    ${hierarchy.description}`));
+      }
+      console.log(chalk17.gray(`    Blueprints: ${hierarchy.blueprint_count || 0}`));
+      console.log(chalk17.gray(`    Repository: ${hierarchy.repository_root.slice(0, 16)}...`));
+      console.log();
+    }
+    console.log(chalk17.gray("\u2500".repeat(50)));
+    console.log();
+    console.log(chalk17.gray("Tips:"));
+    console.log(chalk17.gray(`  \u2022 Pull entire hierarchy: lynxp pull <hierarchy_id>`));
+    console.log(chalk17.gray(`  \u2022 View hierarchy details: lynxp hierarchy <hierarchy_id>`));
+    console.log(chalk17.gray(`  \u2022 Sync local changes: lynxp sync`));
+    console.log();
+  } catch (error) {
+    spinner.fail("Failed to fetch hierarchies");
+    handleError2(error);
+  }
+}
+function handleError2(error) {
+  if (error instanceof ApiRequestError) {
+    console.error(chalk17.red(`Error: ${error.message}`));
+    if (error.statusCode === 401) {
+      console.error(chalk17.gray("Your session may have expired. Run 'lynxp login' to re-authenticate."));
+    } else if (error.statusCode === 403) {
+      console.error(chalk17.gray("You don't have permission to access hierarchies."));
+    }
+  } else {
+    console.error(chalk17.red("An unexpected error occurred."));
+  }
+  process.exit(1);
+}
+
 // src/index.ts
-var CLI_VERSION2 = "1.1.0";
+var CLI_VERSION2 = "1.2.0";
 var program = new Command();
 program.name("lynxprompt").description("CLI for LynxPrompt - Generate AI IDE configuration files").version(CLI_VERSION2);
 program.command("wizard").description("Generate AI IDE configuration (recommended for most users)").option("-n, --name <name>", "Project name").option("-d, --description <description>", "Project description").option("-s, --stack <stack>", "Tech stack (comma-separated)").option("-f, --format <format>", "Output format: agents, cursor, or comma-separated for multiple").option("-p, --platforms <platforms>", "Alias for --format (deprecated)").option("--persona <persona>", "AI persona (fullstack, backend, frontend, devops, data, security)").option("--boundaries <level>", "Boundary preset (conservative, standard, permissive)").option("-y, --yes", "Skip prompts, use defaults (generates AGENTS.md)").option("-o, --output <dir>", "Output directory (default: current directory)").option("--repo-url <url>", "Analyze remote repository URL (GitHub/GitLab supported)").option("--blueprint", "Generate with [[VARIABLE|default]] placeholders for templates").option("--license <type>", "License type (mit, apache-2.0, gpl-3.0, etc.)").option("--ci-cd <platform>", "CI/CD platform (github_actions, gitlab_ci, jenkins, etc.)").option("--project-type <type>", "Project type (work, leisure, opensource, learning)").option("--detect-only", "Only detect project info, don't generate files").option("--load-draft <name>", "Load a saved wizard draft").option("--save-draft <name>", "Save wizard state as a draft (auto-saves at end)").option("--vars <values>", "Fill variables: VAR1=value1,VAR2=value2").action(wizardCommand);
@@ -7610,10 +7832,11 @@ program.command("convert [source] <target>").description("Convert AI config betw
 program.command("merge <files...>").description("Merge multiple AI configuration files into one").option("-o, --output <file>", "Output filename (default: merged.md)").option("-s, --strategy <type>", "Merge strategy: concat, sections, smart (default: smart)").option("-f, --force", "Overwrite existing output file").option("-i, --interactive", "Review and select sections to include").action(mergeCommand);
 program.command("import [path]").description("Scan and import AGENTS.md files from a repository").option("--dry-run", "Preview what would be imported without changes").option("--no-recursive", "Don't scan subdirectories").option("--depth <n>", "Max directory depth to scan", "10").option("--pattern <file>", "Custom config filename to look for").option("--link", "Link imported files to cloud (requires login)").option("-v, --verbose", "Show detailed section information").option("-j, --json", "Output as JSON").action(importCommand);
 program.command("status").description("Show current AI configuration and tracked blueprints").action(statusCommand);
-program.command("pull <id>").description("Download and track a blueprint from the marketplace").option("-o, --output <path>", "Output directory", ".").option("-y, --yes", "Overwrite existing files without prompting").option("--preview", "Preview content without downloading").option("--no-track", "Don't track the blueprint for future syncs").action(pullCommand);
+program.command("pull <id>").description("Download a blueprint (bp_xxx) or entire hierarchy (ha_xxx)").option("-o, --output <path>", "Output directory", ".").option("-y, --yes", "Overwrite existing files without prompting").option("--preview", "Preview content without downloading").option("--no-track", "Don't track the blueprint for future syncs").action(pullCommand);
 program.command("search <query>").description("Search public blueprints in the marketplace").option("-l, --limit <number>", "Number of results", "20").action(searchCommand);
 program.command("list").description("List your blueprints").option("-l, --limit <number>", "Number of results", "20").option("-v, --visibility <visibility>", "Filter: PRIVATE, TEAM, PUBLIC, or all").action(listCommand);
-program.command("push [file]").description("Push local file to LynxPrompt cloud as a blueprint").option("-n, --name <name>", "Blueprint name").option("-d, --description <desc>", "Blueprint description").option("-v, --visibility <vis>", "Visibility: PRIVATE, TEAM, or PUBLIC", "PRIVATE").option("-t, --tags <tags>", "Tags (comma-separated)").option("-y, --yes", "Skip prompts").action(pushCommand);
+program.command("push [file]").description("Push local file to LynxPrompt cloud as a blueprint").option("-n, --name <name>", "Blueprint name").option("-d, --description <desc>", "Blueprint description").option("-v, --visibility <vis>", "Visibility: PRIVATE, TEAM, or PUBLIC", "PRIVATE").option("-t, --tags <tags>", "Tags (comma-separated)").option("-y, --yes", "Skip prompts").option("-f, --force", "Force push (overwrite remote changes)").action(pushCommand);
+program.command("hierarchies").description("List your blueprint hierarchies (monorepo groupings)").option("-l, --limit <number>", "Number of results", "50").option("-j, --json", "Output as JSON").action(hierarchiesCommand);
 program.command("link [file] [blueprint-id]").description("Link a local file to a cloud blueprint for tracking").option("--list", "List all tracked blueprints").action(linkCommand);
 program.command("unlink [file]").description("Disconnect a local file from its cloud blueprint").action(unlinkCommand);
 program.command("diff [file-or-id]").description("Compare tracked files with their cloud blueprints").option("--local", "Compare .lynxprompt/rules/ with exported files").action(diffCommand);
@@ -7623,42 +7846,44 @@ program.command("whoami").description("Show current authenticated user").action(
 program.addHelpText(
   "beforeAll",
   `
-${chalk17.cyan("\u{1F431} LynxPrompt CLI")} ${chalk17.gray("(also available as: lynxp)")}
-${chalk17.gray("Generate AI IDE configuration files from your terminal")}
+${chalk18.cyan("\u{1F431} LynxPrompt CLI")} ${chalk18.gray("(also available as: lynxp)")}
+${chalk18.gray("Generate AI IDE configuration files from your terminal")}
 `
 );
 program.addHelpText(
   "after",
   `
-${chalk17.cyan("Quick Start:")}
-  ${chalk17.white("$ lynxp wizard")}                ${chalk17.gray("Generate config interactively")}
-  ${chalk17.white("$ lynxp wizard -y")}             ${chalk17.gray("Generate AGENTS.md with defaults")}
-  ${chalk17.white("$ lynxp wizard -f cursor")}      ${chalk17.gray("Generate .cursor/rules/")}
-  ${chalk17.white("$ lynxp wizard --blueprint")}    ${chalk17.gray("Generate with [[VAR|default]] placeholders")}
+${chalk18.cyan("Quick Start:")}
+  ${chalk18.white("$ lynxp wizard")}                ${chalk18.gray("Generate config interactively")}
+  ${chalk18.white("$ lynxp wizard -y")}             ${chalk18.gray("Generate AGENTS.md with defaults")}
+  ${chalk18.white("$ lynxp wizard -f cursor")}      ${chalk18.gray("Generate .cursor/rules/")}
+  ${chalk18.white("$ lynxp wizard --blueprint")}    ${chalk18.gray("Generate with [[VAR|default]] placeholders")}
 
-${chalk17.cyan("Analysis & Tools:")}
-  ${chalk17.white("$ lynxp analyze")}               ${chalk17.gray("Analyze project tech stack")}
-  ${chalk17.white("$ lynxp analyze -r <url>")}      ${chalk17.gray("Analyze remote repository")}
-  ${chalk17.white("$ lynxp import")}                ${chalk17.gray("Scan repo for AGENTS.md files")}
-  ${chalk17.white("$ lynxp import --dry-run")}      ${chalk17.gray("Preview monorepo hierarchy")}
-  ${chalk17.white("$ lynxp convert AGENTS.md cursor")} ${chalk17.gray("Convert to Cursor format")}
-  ${chalk17.white("$ lynxp merge a.md b.md -o out.md")} ${chalk17.gray("Merge multiple configs")}
+${chalk18.cyan("Analysis & Tools:")}
+  ${chalk18.white("$ lynxp analyze")}               ${chalk18.gray("Analyze project tech stack")}
+  ${chalk18.white("$ lynxp analyze -r <url>")}      ${chalk18.gray("Analyze remote repository")}
+  ${chalk18.white("$ lynxp import")}                ${chalk18.gray("Scan repo for AGENTS.md files")}
+  ${chalk18.white("$ lynxp import --dry-run")}      ${chalk18.gray("Preview monorepo hierarchy")}
+  ${chalk18.white("$ lynxp convert AGENTS.md cursor")} ${chalk18.gray("Convert to Cursor format")}
+  ${chalk18.white("$ lynxp merge a.md b.md -o out.md")} ${chalk18.gray("Merge multiple configs")}
 
-${chalk17.cyan("Marketplace:")}
-  ${chalk17.white("$ lynxp search nextjs")}         ${chalk17.gray("Search blueprints")}
-  ${chalk17.white("$ lynxp pull bp_abc123")}        ${chalk17.gray("Download and track a blueprint")}
-  ${chalk17.white("$ lynxp push")}                  ${chalk17.gray("Push local file to cloud")}
-  ${chalk17.white("$ lynxp link --list")}           ${chalk17.gray("Show tracked blueprints")}
+${chalk18.cyan("Marketplace:")}
+  ${chalk18.white("$ lynxp search nextjs")}         ${chalk18.gray("Search blueprints")}
+  ${chalk18.white("$ lynxp pull bp_abc123")}        ${chalk18.gray("Download and track a blueprint")}
+  ${chalk18.white("$ lynxp pull ha_xyz789")}        ${chalk18.gray("Download entire hierarchy")}
+  ${chalk18.white("$ lynxp push")}                  ${chalk18.gray("Push local file to cloud")}
+  ${chalk18.white("$ lynxp hierarchies")}           ${chalk18.gray("List your hierarchies")}
+  ${chalk18.white("$ lynxp link --list")}           ${chalk18.gray("Show tracked blueprints")}
 
-${chalk17.cyan("Blueprint Tracking:")}
-  ${chalk17.white("$ lynxp link AGENTS.md bp_xyz")} ${chalk17.gray("Link existing file to blueprint")}
-  ${chalk17.white("$ lynxp unlink AGENTS.md")}      ${chalk17.gray("Disconnect from cloud")}
-  ${chalk17.white("$ lynxp diff bp_abc123")}        ${chalk17.gray("Show changes vs cloud version")}
+${chalk18.cyan("Blueprint Tracking:")}
+  ${chalk18.white("$ lynxp link AGENTS.md bp_xyz")} ${chalk18.gray("Link existing file to blueprint")}
+  ${chalk18.white("$ lynxp unlink AGENTS.md")}      ${chalk18.gray("Disconnect from cloud")}
+  ${chalk18.white("$ lynxp diff bp_abc123")}        ${chalk18.gray("Show changes vs cloud version")}
 
-${chalk17.cyan("CI/CD:")}
-  ${chalk17.white("$ lynxp check --ci")}            ${chalk17.gray("Validate config (exit code)")}
+${chalk18.cyan("CI/CD:")}
+  ${chalk18.white("$ lynxp check --ci")}            ${chalk18.gray("Validate config (exit code)")}
 
-${chalk17.gray("Docs: https://lynxprompt.com/docs/cli")}
+${chalk18.gray("Docs: https://lynxprompt.com/docs/cli")}
 `
 );
 program.parse();