@arvoretech/hub 0.1.2 → 0.3.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 
 // src/commands/init.ts
 import { Command } from "commander";
@@ -679,6 +679,7 @@ function buildKiroOrchestratorRule(config) {
   const taskFolder = config.workflow?.task_folder || "./tasks/<TASK_ID>/";
   const steps = config.workflow?.pipeline || [];
   const prompt = config.workflow?.prompt;
+  const enforce = config.workflow?.enforce_workflow ?? false;
   const sections = [];
   sections.push(`# Orchestrator
 
@@ -687,6 +688,22 @@ function buildKiroOrchestratorRule(config) {
 You are the development orchestrator. Your job is to ensure that any feature or task requested by the user is completed end-to-end by following a structured pipeline. You work as a single agent but follow specialized instructions from steering files for each phase of development.
 
 > **Note:** This workspace uses steering files in \`.kiro/steering/\` to provide role-specific instructions for each pipeline step. When a step says "follow the instructions from steering file X", read that file and apply its guidelines to the current task.`);
+  if (enforce) {
+    sections.push(`
+## STRICT WORKFLOW ENFORCEMENT
+
+**YOU MUST FOLLOW THE PIPELINE DEFINED BELOW. NO EXCEPTIONS.**
+
+- NEVER skip a pipeline step, even if the task seems simple or obvious.
+- ALWAYS execute steps in the exact order defined. Do not reorder, merge, or parallelize steps unless the pipeline explicitly allows it.
+- ALWAYS follow the designated steering file for each step. Do not improvise if a steering file is assigned.
+- ALWAYS wait for a step to complete and validate its output before moving to the next step.
+- If a step produces a document, READ the document and confirm it is complete before proceeding.
+- If a step has unanswered questions or validation issues, RESOLVE them before advancing.
+- NEVER jump directly to coding without completing refinement first.
+- NEVER skip review or QA steps, even for small changes.
+- If the user asks you to skip a step, explain why the pipeline exists and ask for explicit confirmation before proceeding.`);
+  }
   if (prompt?.prepend) {
     sections.push(`
 ${prompt.prepend.trim()}`);
@@ -786,6 +803,10 @@ Follow each step sequentially, applying the role-specific instructions from the
     }
     const stepTitle = step.step.charAt(0).toUpperCase() + step.step.slice(1);
     parts.push(`### ${stepTitle}`);
+    if (step.mode === "plan") {
+      parts.push(`**This step is a planning phase.** Do NOT make any code changes. Focus on reading, analyzing, and collaborating with the user to define requirements before proceeding.`);
+      parts.push(``);
+    }
     if (step.agent) {
       parts.push(`Follow the instructions from the \`agent-${step.agent}.md\` steering file.${step.output ? ` Write output to \`${step.output}\`.` : ""}`);
       if (step.step === "refinement") {
@@ -825,6 +846,7 @@ function buildOrchestratorRule(config) {
   const taskFolder = config.workflow?.task_folder || "./tasks/<TASK_ID>/";
   const steps = config.workflow?.pipeline || [];
   const prompt = config.workflow?.prompt;
+  const enforce = config.workflow?.enforce_workflow ?? false;
   const sections = [];
   sections.push(`---
 description: "Orchestrator agent \u2014 coordinates sub-agents through the development pipeline"
@@ -836,6 +858,22 @@ alwaysApply: true
 ## Your Main Responsibility
 
 You are an agent orchestrator. Your job is to ensure that any feature or task requested by the user is completed end-to-end using specialized sub-agents.`);
+  if (enforce) {
+    sections.push(`
+## STRICT WORKFLOW ENFORCEMENT
+
+**YOU MUST FOLLOW THE PIPELINE DEFINED BELOW. NO EXCEPTIONS.**
+
+- NEVER skip a pipeline step, even if the task seems simple or obvious.
+- ALWAYS execute steps in the exact order defined. Do not reorder, merge, or parallelize steps unless the pipeline explicitly allows it.
+- ALWAYS call the designated sub-agent for each step. Do not attempt to perform a step yourself if an agent is assigned to it.
+- ALWAYS wait for a step to complete and validate its output before moving to the next step.
+- If a step produces a document, READ the document and confirm it is complete before proceeding.
+- If a step has unanswered questions or validation issues, RESOLVE them before advancing.
+- NEVER jump directly to coding without completing refinement first.
+- NEVER skip review or QA steps, even for small changes.
+- If the user asks you to skip a step, explain why the pipeline exists and ask for explicit confirmation before proceeding.`);
+  }
   if (prompt?.prepend) {
     sections.push(`
 ${prompt.prepend.trim()}`);
@@ -963,6 +1001,10 @@ function buildPipelineSection(steps) {
     }
     const stepTitle = step.step.charAt(0).toUpperCase() + step.step.slice(1);
     parts.push(`### ${stepTitle}`);
+    if (step.mode === "plan") {
+      parts.push(`**Before starting this step, switch to Plan Mode** by calling \`SwitchMode\` with \`target_mode_id: "plan"\`. This ensures collaborative planning with the user in a read-only context before any implementation begins.`);
+      parts.push(``);
+    }
     if (step.agent) {
       parts.push(`Call the \`${step.agent}\` agent.${step.output ? ` It writes to \`${step.output}\`.` : ""}`);
       if (step.step === "refinement") {
@@ -998,6 +1040,10 @@ If any coding agent has doubts, they will write questions in their document. App
 If any validation agent leaves comments requiring fixes, call the relevant coding agents again to address them.`);
       }
     }
+    if (step.mode === "plan") {
+      parts.push(`
+**After this step is complete and approved**, switch back to Agent Mode to proceed with the next step.`);
+    }
     parts.push("");
   }
   return parts.join("\n");
@@ -2291,6 +2337,55 @@ Agent '${name}' not found in ${opts.global ? "global" : "project"}
 Removed agent: ${name}
 `));
   })
+).addCommand(
+  new Command9("sync").description("Install all agents referenced in hub.yaml from the registry").option("-g, --global", "Install to global ~/.cursor/agents/").option("-r, --repo <repo>", "Registry repository (owner/repo)").option("-f, --force", "Re-install even if the agent already exists locally").action(async (opts) => {
+    const hubDir = process.cwd();
+    let config;
+    try {
+      config = await loadHubConfig(hubDir);
+    } catch {
+      console.log(chalk9.red("\n  Could not load hub.yaml in the current directory.\n"));
+      return;
+    }
+    const steps = config.workflow?.pipeline || [];
+    const agentNames = /* @__PURE__ */ new Set();
+    for (const step of steps) {
+      if (step.agent) agentNames.add(step.agent);
+      if (Array.isArray(step.agents)) {
+        for (const a of step.agents) {
+          agentNames.add(typeof a === "string" ? a : a.agent);
+        }
+      }
+    }
+    if (agentNames.size === 0) {
+      console.log(chalk9.yellow("\n  No agents found in hub.yaml workflow pipeline.\n"));
+      return;
+    }
+    console.log(chalk9.blue(`
+\u2501\u2501\u2501 Syncing ${agentNames.size} agent(s) from hub.yaml \u2501\u2501\u2501
+`));
+    const targetBase = opts.global ? join10(process.env.HOME || "~", ".cursor", "agents") : join10(hubDir, "agents");
+    let installed = 0;
+    let skipped = 0;
+    for (const name of agentNames) {
+      const fileName = name.endsWith(".md") ? name : `${name}.md`;
+      const targetPath = join10(targetBase, fileName);
+      if (!opts.force && existsSync7(targetPath)) {
+        console.log(chalk9.dim(`  \u2713 ${name} (already installed)`));
+        skipped++;
+        continue;
+      }
+      await addFromRegistry2(name, hubDir, { global: opts.global, repo: opts.repo });
+      installed++;
+    }
+    console.log();
+    if (installed > 0) console.log(chalk9.green(`  ${installed} agent(s) installed`));
+    if (skipped > 0) console.log(chalk9.dim(`  ${skipped} agent(s) already up to date`));
+    if (installed === 0 && skipped > 0) {
+      console.log(chalk9.green("  All agents are already installed. Use --force to re-install."));
+    }
+    console.log();
+  })
 );
 
 // src/commands/hooks.ts
@@ -3246,11 +3341,90 @@ function extractVersion(s) {
   return match?.[1] || s;
 }
 
+// src/commands/update.ts
+import { Command as Command16 } from "commander";
+import { execSync as execSync12 } from "child_process";
+import { readFileSync } from "fs";
+import { join as join17, dirname } from "path";
+import { fileURLToPath } from "url";
+import chalk16 from "chalk";
+var PACKAGE_NAME = "@arvoretech/hub";
+function getCurrentVersion() {
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  const pkgPath = join17(__dirname, "..", "package.json");
+  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+  return pkg.version;
+}
+async function getLatestVersion() {
+  const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`);
+  if (!res.ok) throw new Error(`npm registry returned ${res.status}`);
+  const data = await res.json();
+  return data.version;
+}
+function detectPackageManager() {
+  try {
+    execSync12("pnpm --version", { stdio: "pipe" });
+    return "pnpm";
+  } catch {
+    try {
+      execSync12("yarn --version", { stdio: "pipe" });
+      return "yarn";
+    } catch {
+      return "npm";
+    }
+  }
+}
+var updateCommand = new Command16("update").description("Update hub CLI to the latest version").option("--check", "Only check for updates without installing").action(async (opts) => {
+  const currentVersion = getCurrentVersion();
+  console.log(chalk16.blue(`
+  Current version: ${currentVersion}`));
+  let latestVersion;
+  try {
+    latestVersion = await getLatestVersion();
+  } catch (err) {
+    console.log(chalk16.red(`  Failed to check for updates: ${err.message}
+`));
+    return;
+  }
+  console.log(chalk16.blue(`  Latest version:  ${latestVersion}`));
+  if (currentVersion === latestVersion) {
+    console.log(chalk16.green("\n  You're already on the latest version.\n"));
+    return;
+  }
+  console.log(chalk16.yellow(`
+  Update available: ${currentVersion} \u2192 ${latestVersion}`));
+  if (opts.check) {
+    const pm2 = detectPackageManager();
+    console.log(chalk16.dim(`
+  Run 'hub update' or '${pm2} install -g ${PACKAGE_NAME}@latest' to update.
+`));
+    return;
+  }
+  const pm = detectPackageManager();
+  const installCmd = pm === "pnpm" ? `pnpm install -g ${PACKAGE_NAME}@latest` : pm === "yarn" ? `yarn global add ${PACKAGE_NAME}@latest` : `npm install -g ${PACKAGE_NAME}@latest`;
+  console.log(chalk16.cyan(`
+  Updating with ${pm}...
+`));
+  console.log(chalk16.dim(`  $ ${installCmd}
+`));
+  try {
+    execSync12(installCmd, { stdio: "inherit" });
+    console.log(chalk16.green(`
+  Updated to ${latestVersion} successfully.
+`));
+  } catch {
+    console.log(chalk16.red(`
+  Update failed. Try running manually:`));
+    console.log(chalk16.dim(`  $ ${installCmd}
+`));
+  }
+});
+
 // src/index.ts
-var program = new Command16();
+var program = new Command17();
 program.name("hub").description(
   "Give your AI coding assistant the full picture. Multi-repo context, agent orchestration, and end-to-end workflows."
-).version("0.1.2").enablePositionalOptions();
+).version("0.2.0").enablePositionalOptions();
 program.addCommand(initCommand);
 program.addCommand(addRepoCommand);
 program.addCommand(setupCommand);
@@ -3268,4 +3442,5 @@ program.addCommand(execCommand);
 program.addCommand(worktreeCommand);
 program.addCommand(doctorCommand);
 program.addCommand(toolsCommand);
+program.addCommand(updateCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arvoretech/hub",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "description": "CLI for managing AI-aware multi-repository workspaces",
   "main": "dist/index.js",
   "type": "module",