@uluops/setup 0.9.4 → 0.9.6

package/README.md

@@ -137,10 +137,18 @@ npx @uluops/setup [options]
                        --harness <single-name> (fail-fast conflict error).
   --signup             Create account from terminal (email + password)
   --scope <mode>       MCP config scope: "global" or "local" (default: global)
-  --local-defs         Save definitions to ./uluops/ for review
+  --local-defs         Install definitions into ./uluops/ (project-scoped)
+                       instead of the harness's home directory
   --shell              Write API key export to shell profile
   --with-cli           Install @uluops/cli globally (skip prompt)
   --no-cli             Skip @uluops/cli install (skip prompt)
+  --with-agent-metrics-cli
+                       Install @uluops/agent-metrics globally (skip prompt)
+  --no-agent-metrics-cli
+                       Skip @uluops/agent-metrics install (skip prompt)
+  --no-metrics         Skip the agent-metrics hook install (no hook
+                       configured, no tool files copied). The downstream
+                       @uluops/agent-metrics CLI prompt is also suppressed.
   --skip-validation    Accept API key without server verification
   --list               Show available agents and workflows without installing
   --verify             Check installation health: manifest, files, MCP config, API connectivity (no changes)
@@ -159,7 +167,7 @@ npx @uluops/setup [options]
 Displays all agents and workflows included in the current version of the setup tool.
 
 ```text
-  ⟨u⟩ ulu·ops v0.8.1 — available agents and workflows
+  ⟨u⟩ ulu·ops v0.9.5 — available agents and workflows
 
   WORKFLOWS
   /workflows:post-implementation   Iterative validation after coding
@@ -178,7 +186,7 @@ Displays all agents and workflows included in the current version of the setup t
 Validates your current installation against the local manifest and checks API connectivity.
 
 ```text
-  ⟨u⟩ ulu·ops Installation Check v0.8.1
+  ⟨u⟩ ulu·ops Installation Check v0.9.5
 
   ✓ Manifest found (~/.uluops/manifest.json)
   ✓ All 23 agents present in ~/.claude/agents/
@@ -217,8 +225,8 @@ npx @uluops/setup --api-key ulr_abc123 --all-detected -y
 # Local MCP config (project-scoped)
 npx @uluops/setup --scope local
 
-# Preview without changes
-npx @uluops/setup --dry-run --api-key ulr_abc123
+# Preview without changes while offline
+npx @uluops/setup --dry-run --api-key ulr_abc123 --skip-validation
 
 # Persist API key in shell profile (~/.zshrc, ~/.bashrc, etc.)
 npx @uluops/setup --shell
@@ -228,6 +236,12 @@ npx @uluops/setup --with-cli
 
 # Skip the CLI prompt entirely (interactive runs default to asking)
 npx @uluops/setup --no-cli
+
+# Install the agent-metrics CLI globally alongside the metrics hook
+npx @uluops/setup --with-agent-metrics-cli
+
+# Skip the agent-metrics CLI prompt entirely
+npx @uluops/setup --no-agent-metrics-cli
 ```
 
 ## How updates work
@@ -273,7 +287,7 @@ Removes only UluOps-managed files: agents, commands, MCP config entries, shell p
 
 - **Node.js:** >= 20.0.0
 - **Platform:** Linux, macOS, or WSL2 (native Windows not supported)
-- **Harness:** Claude Code, OpenCode, or Gemini CLI
+- **Harness:** Claude Code, OpenCode, Gemini CLI, or Codex
 - **Auth:** UluOps API key ([get one here](https://app.uluops.ai/settings/api-keys))
 
 ---

package/dist/cli.js

@@ -27,6 +27,7 @@ async function main() {
         .option("--no-cli", "Skip @uluops/cli install without prompting (takes precedence over --with-cli)")
         .option("--with-agent-metrics-cli", "Install @uluops/agent-metrics globally without prompting")
         .option("--no-agent-metrics-cli", "Skip @uluops/agent-metrics install without prompting (takes precedence over --with-agent-metrics-cli)")
+        .option("--no-metrics", "Skip the agent-metrics hook install (no hook configured, no tool files copied)")
         .option("--skip-validation", "Accept API key without verifying", false)
         .option("--list", "Show available agents and workflows without installing")
         .option("--verify", "Check existing installation health")
@@ -131,6 +132,7 @@ async function main() {
         cli: opts.cli,
         withAgentMetricsCli: opts.withAgentMetricsCli,
         agentMetricsCli: opts.agentMetricsCli,
+        noMetrics: !opts.metrics,
         skipValidation: opts.skipValidation,
         dryRun: opts.dryRun,
         yes: opts.yes,

package/dist/commands/helpers.d.ts

@@ -41,6 +41,7 @@ export declare function installSkillsDefs(profile: HarnessProfile, opts: {
 /** Install agent-metrics hook and tool files (Claude Code only). */
 export declare function configureMetricsStep(profile: HarnessProfile, opts: {
     dryRun: boolean;
+    noMetrics?: boolean;
 }): Promise<MetricsResult>;
 /**
  * Decide whether to install `@uluops/cli` globally and do it (or not).

package/dist/commands/helpers.js

@@ -205,6 +205,15 @@ export async function installSkillsDefs(profile, opts, prev) {
 }
 /** Install agent-metrics hook and tool files (Claude Code only). */
 export async function configureMetricsStep(profile, opts) {
+    if (opts.noMetrics) {
+        info(chalk.dim(`Metrics hook skipped (--no-metrics)`));
+        return {
+            toolFilesCopied: 0,
+            hookConfigured: false,
+            hooksInstalledVersion: null,
+            skippedReason: "no-metrics-flag",
+        };
+    }
     if (!profile.hooks) {
         info(chalk.dim(`Metrics hooks not supported for ${profile.displayName}`));
         return { toolFilesCopied: 0, hookConfigured: false, hooksInstalledVersion: null };

package/dist/commands/setup.d.ts

@@ -13,5 +13,11 @@ interface RunSetupOpts {
     cli?: boolean;
     withAgentMetricsCli?: boolean;
     agentMetricsCli?: boolean;
+    /**
+     * When true, skip the agent-metrics hook step entirely. configureMetricsStep
+     * short-circuits with a "skipped via --no-metrics" status. The agent-metrics
+     * CLI prompt is also suppressed downstream (no hook → no CLI gate).
+     */
+    noMetrics?: boolean;
 }
 export declare function runSetup(opts: RunSetupOpts): Promise<void>;

package/dist/lib/asset-catalog.d.ts

@@ -3,7 +3,7 @@ export interface CommandEntry {
     description: string;
     model: string;
 }
-/** Get all agent command entries from assets. */
+/** Get all agent command entries from the canonical catalog. */
 export declare function getAgentCommands(): Promise<CommandEntry[]>;
-/** Get all workflow command entries from assets. */
+/** Get all workflow command entries from the canonical catalog. */
 export declare function getWorkflowCommands(): Promise<CommandEntry[]>;

package/dist/lib/asset-catalog.js

@@ -1,6 +1,15 @@
 import { readdir, readFile } from "node:fs/promises";
 import { join } from "node:path";
 import { ASSETS_DIR } from "./paths.js";
+/**
+ * Canonical command-catalog source. `assets/claude-code/commands/` is the
+ * reference set of markdown command definitions; other harnesses (codex,
+ * gemini-cli, opencode) are rendered from this source at install time and
+ * do not ship parallel command-markdown trees. `printAgentList` therefore
+ * reads from here regardless of which harness the user has installed —
+ * the listing is the catalog, not a per-harness manifest.
+ */
+const CATALOG_COMMANDS_DIR = join(ASSETS_DIR, "claude-code", "commands");
 /**
  * Parse YAML-like frontmatter from a markdown file.
  * Returns key-value pairs between the opening and closing `---`.
@@ -46,11 +55,11 @@ async function scanCommandDir(dir) {
     }
     return entries.sort((a, b) => a.name.localeCompare(b.name));
 }
-/** Get all agent command entries from assets. */
+/** Get all agent command entries from the canonical catalog. */
 export async function getAgentCommands() {
-    return scanCommandDir(join(ASSETS_DIR, "claude-code", "commands", "agents"));
+    return scanCommandDir(join(CATALOG_COMMANDS_DIR, "agents"));
 }
-/** Get all workflow command entries from assets. */
+/** Get all workflow command entries from the canonical catalog. */
 export async function getWorkflowCommands() {
-    return scanCommandDir(join(ASSETS_DIR, "claude-code", "commands", "workflows"));
+    return scanCommandDir(join(CATALOG_COMMANDS_DIR, "workflows"));
 }

package/dist/lib/display.js

@@ -156,13 +156,13 @@ export async function printAgentList() {
         console.log();
     }
     if (agents.length > 0) {
-        info(`${chalk.bold("AGENTS")} (run individually)${" ".repeat(26)}${chalk.dim("MODEL")}`);
+        info(`${chalk.bold("AGENTS")} (run individually)${" ".repeat(30)}${chalk.dim("MODEL")}`);
         for (const agent of agents) {
             const cmd = `/agents:${agent.name}`;
-            const desc = agent.description.length > 17
-                ? agent.description.slice(0, 14) + "..."
+            const desc = agent.description.length > 21
+                ? agent.description.slice(0, 18) + "..."
                 : agent.description;
-            info(`  ${chalk.cyan(cmd.padEnd(34))}${desc.padEnd(17)}${chalk.dim(agent.model)}`);
+            info(`  ${chalk.cyan(cmd.padEnd(34))}${desc.padEnd(22)}${chalk.dim(agent.model)}`);
         }
         console.log();
     }

package/dist/lib/mcp-packages.d.ts

@@ -21,11 +21,11 @@
  * the latest version was reachable.
  */
 export declare const OPS_MCP_PACKAGE = "@uluops/ops-mcp";
-export declare const OPS_MCP_VERSION = "0.3.1";
-export declare const OPS_MCP_SPEC: "@uluops/ops-mcp@0.3.1";
+export declare const OPS_MCP_VERSION = "0.4.3";
+export declare const OPS_MCP_SPEC: "@uluops/ops-mcp@0.4.3";
 export declare const REGISTRY_MCP_PACKAGE = "@uluops/registry-mcp";
-export declare const REGISTRY_MCP_VERSION = "0.2.7";
-export declare const REGISTRY_MCP_SPEC: "@uluops/registry-mcp@0.2.7";
+export declare const REGISTRY_MCP_VERSION = "0.2.9";
+export declare const REGISTRY_MCP_SPEC: "@uluops/registry-mcp@0.2.9";
 /**
  * Bare package names for the npm availability probe. The probe checks
  * existence on the registry, not version-specific resolvability, so it

package/dist/lib/mcp-packages.js

@@ -21,10 +21,10 @@
  * the latest version was reachable.
  */
 export const OPS_MCP_PACKAGE = "@uluops/ops-mcp";
-export const OPS_MCP_VERSION = "0.3.1";
+export const OPS_MCP_VERSION = "0.4.3";
 export const OPS_MCP_SPEC = `${OPS_MCP_PACKAGE}@${OPS_MCP_VERSION}`;
 export const REGISTRY_MCP_PACKAGE = "@uluops/registry-mcp";
-export const REGISTRY_MCP_VERSION = "0.2.7";
+export const REGISTRY_MCP_VERSION = "0.2.9";
 export const REGISTRY_MCP_SPEC = `${REGISTRY_MCP_PACKAGE}@${REGISTRY_MCP_VERSION}`;
 /**
  * Bare package names for the npm availability probe. The probe checks

package/dist/steps/signup.d.ts

@@ -1,7 +1,15 @@
 import type { AuthResult } from "./auth.js";
 /**
- * Advisory password hints. Returns warning strings for inquirer display,
- * but all are non-blocking — server validation is the authority.
+ * Pure advisory check: returns the first hint message that applies to the
+ * password, or null if none apply. No I/O. Server validation remains the
+ * authority — hints exist only to nudge the user toward likely-acceptable
+ * inputs before round-tripping to the server.
+ * @internal Exported for testing only — not part of the public API.
+ */
+declare function getPasswordHint(password: string): string | null;
+/**
+ * Inquirer validate wrapper. Always returns true (hints are non-blocking)
+ * and emits the pure-computed hint via console.warn for display.
  * @internal Exported for testing only — not part of the public API.
  */
 declare function hintPassword(password: string): true;
@@ -13,4 +21,4 @@ declare function validateEmail(email: string): string | true;
  */
 export declare function signup(): Promise<AuthResult>;
 /** @internal Exported for testing only — not part of the public API. */
-export { hintPassword, validateEmail };
+export { hintPassword, getPasswordHint, validateEmail };

package/dist/steps/signup.js

@@ -1,20 +1,33 @@
 const API_BASE = "https://api.uluops.ai/api/v1";
 /**
- * Advisory password hints. Returns warning strings for inquirer display,
- * but all are non-blocking — server validation is the authority.
+ * Pure advisory check: returns the first hint message that applies to the
+ * password, or null if none apply. No I/O. Server validation remains the
+ * authority — hints exist only to nudge the user toward likely-acceptable
+ * inputs before round-tripping to the server.
  * @internal Exported for testing only — not part of the public API.
  */
-function hintPassword(password) {
+function getPasswordHint(password) {
     if (password.length < 8)
-        console.warn("  ⚠ Hint: server may require at least 8 characters");
-    else if (password.length > 128)
-        console.warn("  ⚠ Hint: server may reject passwords over 128 characters");
-    else if (!/[a-z]/.test(password))
-        console.warn("  ⚠ Hint: server may require a lowercase letter");
-    else if (!/[A-Z]/.test(password))
-        console.warn("  ⚠ Hint: server may require an uppercase letter");
-    else if (!/[0-9]/.test(password))
-        console.warn("  ⚠ Hint: server may require a number");
+        return "  ⚠ Hint: server may require at least 8 characters";
+    if (password.length > 128)
+        return "  ⚠ Hint: server may reject passwords over 128 characters";
+    if (!/[a-z]/.test(password))
+        return "  ⚠ Hint: server may require a lowercase letter";
+    if (!/[A-Z]/.test(password))
+        return "  ⚠ Hint: server may require an uppercase letter";
+    if (!/[0-9]/.test(password))
+        return "  ⚠ Hint: server may require a number";
+    return null;
+}
+/**
+ * Inquirer validate wrapper. Always returns true (hints are non-blocking)
+ * and emits the pure-computed hint via console.warn for display.
+ * @internal Exported for testing only — not part of the public API.
+ */
+function hintPassword(password) {
+    const hint = getPasswordHint(password);
+    if (hint !== null)
+        console.warn(hint);
     return true;
 }
 /** @internal Exported for testing only — not part of the public API. */
@@ -111,4 +124,4 @@ async function callApi(url, method, body, bearerToken, validate) {
     throw new Error(`Signup failed (${res.status}): ${message}`);
 }
 /** @internal Exported for testing only — not part of the public API. */
-export { hintPassword, validateEmail };
+export { hintPassword, getPasswordHint, validateEmail };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uluops/setup",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "Zero-friction installer for UluOps agentic harnesses",
   "license": "MIT",
   "repository": {
@@ -23,9 +23,6 @@
   "bin": {
     "uluops-setup": "./dist/cli.js"
   },
-  "exports": {
-    "./cli": "./dist/cli.js"
-  },
   "files": [
     "dist/cli.js",
     "dist/cli.d.ts",