@uluops/setup 0.9.4 → 0.9.5

package/README.md

@@ -137,10 +137,14 @@ 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)
+  --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 +163,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 +182,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/

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/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.5",
   "description": "Zero-friction installer for UluOps agentic harnesses",
   "license": "MIT",
   "repository": {