@urateam/cli 0.1.39 → 0.1.40

package/dist/lib/build-repo-configs.js

@@ -1,4 +1,5 @@
 import { repoPluginsFromEnv } from "./repo-plugins-from-env.js";
+import { readUserLevelConfig } from "./user-level-config.js";
 function parseCsv(raw) {
     return raw.split(",").filter(Boolean);
 }
@@ -24,32 +25,69 @@ function parseCsv(raw) {
  */
 export function buildRepoConfigsFromEnv() {
     const repoConfigs = {};
-    if (!process.env.REPO_TEAM_ID || !process.env.REPO_URL)
+    if (process.env.REPO_TEAM_ID && process.env.REPO_URL) {
+        const repoEntry = {
+            url: process.env.REPO_URL,
+            defaultBranch: process.env.REPO_DEFAULT_BRANCH ?? "main",
+            testCommand: process.env.REPO_TEST_CMD ?? "pnpm test",
+            buildCommand: process.env.REPO_BUILD_CMD ?? "pnpm build",
+        };
+        if (process.env.GITHUB_WEBHOOK_SECRET) {
+            repoEntry.githubFeedback = {
+                autoTrigger: process.env.GITHUB_FEEDBACK_AUTO_TRIGGER !== "false",
+                triggerKeyword: process.env.GITHUB_FEEDBACK_TRIGGER_KEYWORD,
+                allowedReviewers: process.env.GITHUB_FEEDBACK_ALLOWED_REVIEWERS
+                    ? parseCsv(process.env.GITHUB_FEEDBACK_ALLOWED_REVIEWERS)
+                    : undefined,
+                botLogins: process.env.GITHUB_FEEDBACK_BOT_LOGINS
+                    ? parseCsv(process.env.GITHUB_FEEDBACK_BOT_LOGINS)
+                    : undefined,
+            };
+        }
+        const pluginCfg = repoPluginsFromEnv();
+        if (pluginCfg)
+            repoEntry.plugins = pluginCfg;
+        repoConfigs[process.env.REPO_TEAM_ID] = repoEntry;
+        return repoConfigs;
+    }
+    // User-level fallback: when no REPO_* env vars produced anything, try
+    // ~/.urateam/config.json (or $URATEAM_HOME/config.json). This is what
+    // makes the `ura init` + `ura repo add` path usable end-to-end without
+    // operators having to hand-craft env vars.
+    //
+    // Read failures (malformed JSON, schema-validation error) bubble up —
+    // the operator should see the error explicitly rather than silently get
+    // an unconfigured daemon.
+    const userConfig = readUserLevelConfig();
+    if (!userConfig || userConfig.repos.length === 0)
         return repoConfigs;
-    const repoEntry = {
-        url: process.env.REPO_URL,
-        defaultBranch: process.env.REPO_DEFAULT_BRANCH ?? "main",
-        testCommand: process.env.REPO_TEST_CMD ?? "pnpm test",
-        buildCommand: process.env.REPO_BUILD_CMD ?? "pnpm build",
-    };
-    if (process.env.GITHUB_WEBHOOK_SECRET) {
-        repoEntry.githubFeedback = {
-            autoTrigger: process.env.GITHUB_FEEDBACK_AUTO_TRIGGER !== "false",
-            triggerKeyword: process.env.GITHUB_FEEDBACK_TRIGGER_KEYWORD,
-            allowedReviewers: process.env.GITHUB_FEEDBACK_ALLOWED_REVIEWERS
-                ? parseCsv(process.env.GITHUB_FEEDBACK_ALLOWED_REVIEWERS)
-                : undefined,
-            botLogins: process.env.GITHUB_FEEDBACK_BOT_LOGINS
-                ? parseCsv(process.env.GITHUB_FEEDBACK_BOT_LOGINS)
-                : undefined,
+    for (const repo of userConfig.repos) {
+        const entry = {
+            url: repo.url,
+            defaultBranch: repo.defaultBranch,
+            testCommand: repo.testCommand,
+            buildCommand: repo.buildCommand,
+            ...(repo.labelPattern && { labelPattern: repo.labelPattern }),
         };
+        // Key by teamId when present (matches the existing env-var schema);
+        // fall back to a slug derived from the URL so config.json entries
+        // without a teamId still get a stable key.
+        const key = repo.teamId ?? deriveKeyFromUrl(repo.url);
+        repoConfigs[key] = entry;
     }
-    const pluginCfg = repoPluginsFromEnv();
-    if (pluginCfg)
-        repoEntry.plugins = pluginCfg;
-    repoConfigs[process.env.REPO_TEAM_ID] = repoEntry;
     return repoConfigs;
 }
+/**
+ * Derive a synthetic Record key from a repo URL when the user-level config
+ * entry omits `teamId`. Mirrors the slug logic in `commands/repo.ts` but
+ * lives here too so this file doesn't import from a sibling that pulls in
+ * commander.
+ */
+function deriveKeyFromUrl(url) {
+    const stripped = url.replace(/\.git$/, "");
+    const last = stripped.split(/[/:]/).filter(Boolean).pop() ?? "repo";
+    return last.replace(/[^A-Za-z0-9._-]/g, "-");
+}
 /**
  * Fail-fast guard: exits 1 with a clear operator-actionable error if
  * `repoConfigs` is empty.
@@ -62,12 +100,32 @@ export function buildRepoConfigsFromEnv() {
 export function requireRepoConfigs(repoConfigs, command) {
     if (Object.keys(repoConfigs).length > 0)
         return;
-    console.error("Error: no repoConfigs could be built from environment variables.\n" +
-        "Set REPO_TEAM_ID and REPO_URL in .urateam/.env and restart.\n" +
-        "Example:\n" +
-        "  REPO_TEAM_ID=<your Linear team UUID — usually the same as LINEAR_TEAM_ID>\n" +
-        `  REPO_URL=https://github.com/org/repo\n` +
-        `\n(command: ${command})\n`);
+    // Branch the error message based on whether `ura init` has been run.
+    // Users on the user-level install path who forgot `ura repo add` need
+    // very different advice than project-level operators who forgot the
+    // env vars.
+    const userConfig = readUserLevelConfig();
+    if (userConfig) {
+        // `ura init` has run; they just need to add a repo.
+        console.error(`Error: no repos configured in ${process.env.URATEAM_HOME ?? "~/.urateam"}/config.json.\n` +
+            "Run 'ura repo add <url> [--team <linear-team-id>]' to register a repo.\n" +
+            "Example:\n" +
+            "  ura repo add https://github.com/org/repo.git --team team-uuid\n" +
+            `\n(command: ${command})\n`);
+    }
+    else {
+        console.error("Error: no repoConfigs could be built.\n" +
+            "Two install paths exist:\n\n" +
+            "  Project-level (sidecar, env-var-driven):\n" +
+            "    Set REPO_TEAM_ID and REPO_URL in .urateam/.env and restart.\n" +
+            "    Example:\n" +
+            "      REPO_TEAM_ID=<your Linear team UUID — usually the same as LINEAR_TEAM_ID>\n" +
+            "      REPO_URL=https://github.com/org/repo\n\n" +
+            "  User-level (~/.urateam config-file-driven):\n" +
+            "    Run 'ura init' then 'ura repo add <url> --team <id>'.\n" +
+            "    See deploy/USER_LEVEL_INSTALL.md.\n" +
+            `\n(command: ${command})\n`);
+    }
     process.exit(1);
 }
 //# sourceMappingURL=build-repo-configs.js.map

package/dist/lib/build-repo-configs.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-repo-configs.js","sourceRoot":"","sources":["../../src/lib/build-repo-configs.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,SAAS,QAAQ,CAAC,GAAW;IAC3B,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,WAAW,GAA+B,EAAE,CAAC;IACnD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,WAAW,CAAC;IAE3E,MAAM,SAAS,GAAe;QAC5B,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ;QACzB,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,MAAM;QACxD,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,WAAW;QACrD,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,YAAY;KACzD,CAAC;IAEF,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,CAAC;QACtC,SAAS,CAAC,cAAc,GAAG;YACzB,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,OAAO;YACjE,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,+BAA+B;YAC3D,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,iCAAiC;gBAC7D,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC;gBACzD,CAAC,CAAC,SAAS;YACb,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B;gBAC/C,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;gBAClD,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,IAAI,SAAS;QAAE,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC;IAE7C,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IAClD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAoC,EACpC,OAAgC;IAEhC,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IAChD,OAAO,CAAC,KAAK,CACX,oEAAoE;QAClE,+DAA+D;QAC/D,YAAY;QACZ,+EAA+E;QAC/E,0CAA0C;QAC1C,eAAe,OAAO,KAAK,CAC9B,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}
+{"version":3,"file":"build-repo-configs.js","sourceRoot":"","sources":["../../src/lib/build-repo-configs.ts"],"names":[],"mappings":"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"}

package/dist/lib/user-level-config.d.ts

@@ -0,0 +1,70 @@
+/**
+ * User-level install — config schema, on-disk locations, read/write helpers.
+ *
+ * The user-level path stores everything under `~/.urateam/` (or
+ * `$URATEAM_HOME` when set). Layout:
+ *
+ *   ~/.urateam/
+ *   ├── config.json       # this module's schema
+ *   ├── .env              # secrets (ANTHROPIC_API_KEY, etc.)
+ *   ├── data/             # SQLite DB lives here
+ *   └── repos/            # cloned repos managed by `ura repo add`
+ *
+ * The schema intentionally mirrors the existing `RepoConfig` shape (`url`,
+ * `defaultBranch`, `testCommand`, `buildCommand`, optional `labelPattern`)
+ * plus a `path` field that records WHERE the clone lives — that's the
+ * field the daemon needs to actually find the worktree.
+ *
+ * `URATEAM_HOME` env-var override exists for two reasons:
+ *   1. Tests (hermetic temp dir per test)
+ *   2. Operators who want to run multiple isolated user-level installs on
+ *      one machine (e.g., one per Linear workspace) without touching
+ *      `~/.urateam/`.
+ */
+import { z } from "zod";
+export declare const UserLevelRepoSchema: z.ZodObject<{
+    url: z.ZodString;
+    path: z.ZodString;
+    defaultBranch: z.ZodString;
+    testCommand: z.ZodDefault<z.ZodString>;
+    buildCommand: z.ZodDefault<z.ZodString>;
+    teamId: z.ZodOptional<z.ZodString>;
+    labelPattern: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UserLevelRepo = z.infer<typeof UserLevelRepoSchema>;
+export declare const UserLevelConfigSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    repos: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        path: z.ZodString;
+        defaultBranch: z.ZodString;
+        testCommand: z.ZodDefault<z.ZodString>;
+        buildCommand: z.ZodDefault<z.ZodString>;
+        teamId: z.ZodOptional<z.ZodString>;
+        labelPattern: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type UserLevelConfig = z.infer<typeof UserLevelConfigSchema>;
+/**
+ * Resolve the user-level state directory. Returns `$URATEAM_HOME` when set,
+ * otherwise `~/.urateam`.
+ */
+export declare function resolveUserLevelHome(): string;
+export declare function userLevelConfigPath(): string;
+export declare function userLevelReposDir(): string;
+export declare function userLevelDataDir(): string;
+/**
+ * Read and validate the user-level config. Returns `null` when the file
+ * doesn't exist (so callers can distinguish "not initialized" from "empty
+ * config"). Throws on schema-validation failure — operators should see the
+ * Zod error explicitly rather than silently get an unconfigured daemon.
+ */
+export declare function readUserLevelConfig(): UserLevelConfig | null;
+/**
+ * Write the user-level config, creating `~/.urateam/` if missing.
+ * Idempotent: callers are expected to read-modify-write to preserve any
+ * fields the writer doesn't know about (the schema is forward-compatible
+ * within version 1).
+ */
+export declare function writeUserLevelConfig(config: UserLevelConfig): void;
+//# sourceMappingURL=user-level-config.d.ts.map

package/dist/lib/user-level-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-level-config.d.ts","sourceRoot":"","sources":["../../src/lib/user-level-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,mBAAmB;;;;;;;;iBAgB9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,qBAAqB;;;;;;;;;;;iBAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,GAAG,IAAI,CAK5D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAIlE"}

package/dist/lib/user-level-config.js

@@ -0,0 +1,91 @@
+/**
+ * User-level install — config schema, on-disk locations, read/write helpers.
+ *
+ * The user-level path stores everything under `~/.urateam/` (or
+ * `$URATEAM_HOME` when set). Layout:
+ *
+ *   ~/.urateam/
+ *   ├── config.json       # this module's schema
+ *   ├── .env              # secrets (ANTHROPIC_API_KEY, etc.)
+ *   ├── data/             # SQLite DB lives here
+ *   └── repos/            # cloned repos managed by `ura repo add`
+ *
+ * The schema intentionally mirrors the existing `RepoConfig` shape (`url`,
+ * `defaultBranch`, `testCommand`, `buildCommand`, optional `labelPattern`)
+ * plus a `path` field that records WHERE the clone lives — that's the
+ * field the daemon needs to actually find the worktree.
+ *
+ * `URATEAM_HOME` env-var override exists for two reasons:
+ *   1. Tests (hermetic temp dir per test)
+ *   2. Operators who want to run multiple isolated user-level installs on
+ *      one machine (e.g., one per Linear workspace) without touching
+ *      `~/.urateam/`.
+ */
+import { z } from "zod";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+export const UserLevelRepoSchema = z.object({
+    /** Source URL (https / git@ — anything `git clone` accepts). */
+    url: z.string().min(1),
+    /** Absolute filesystem path where the clone lives. */
+    path: z.string().min(1),
+    /** Default branch — the daemon uses this for diff/rebase targets. */
+    defaultBranch: z.string().min(1),
+    /** Test command invoked in the worktree. */
+    testCommand: z.string().default("pnpm test"),
+    /** Build command invoked in the worktree. */
+    buildCommand: z.string().default("pnpm build"),
+    /** Linear team ID (optional — required when promote routes by team). */
+    teamId: z.string().optional(),
+    /** BEC-177: label-based routing. When set, this repo handles tickets
+     *  whose pipeline label matches the pattern. */
+    labelPattern: z.string().optional(),
+});
+export const UserLevelConfigSchema = z.object({
+    /** Schema version — bumped if/when the file format changes. */
+    version: z.literal(1),
+    /** Configured repos. `ura repo add` appends; `ura repo remove` filters. */
+    repos: z.array(UserLevelRepoSchema).default([]),
+});
+/**
+ * Resolve the user-level state directory. Returns `$URATEAM_HOME` when set,
+ * otherwise `~/.urateam`.
+ */
+export function resolveUserLevelHome() {
+    return process.env.URATEAM_HOME ?? join(homedir(), ".urateam");
+}
+export function userLevelConfigPath() {
+    return join(resolveUserLevelHome(), "config.json");
+}
+export function userLevelReposDir() {
+    return join(resolveUserLevelHome(), "repos");
+}
+export function userLevelDataDir() {
+    return join(resolveUserLevelHome(), "data");
+}
+/**
+ * Read and validate the user-level config. Returns `null` when the file
+ * doesn't exist (so callers can distinguish "not initialized" from "empty
+ * config"). Throws on schema-validation failure — operators should see the
+ * Zod error explicitly rather than silently get an unconfigured daemon.
+ */
+export function readUserLevelConfig() {
+    const path = userLevelConfigPath();
+    if (!existsSync(path))
+        return null;
+    const raw = JSON.parse(readFileSync(path, "utf8"));
+    return UserLevelConfigSchema.parse(raw);
+}
+/**
+ * Write the user-level config, creating `~/.urateam/` if missing.
+ * Idempotent: callers are expected to read-modify-write to preserve any
+ * fields the writer doesn't know about (the schema is forward-compatible
+ * within version 1).
+ */
+export function writeUserLevelConfig(config) {
+    const home = resolveUserLevelHome();
+    mkdirSync(home, { recursive: true });
+    writeFileSync(userLevelConfigPath(), JSON.stringify(config, null, 2) + "\n");
+}
+//# sourceMappingURL=user-level-config.js.map

package/dist/lib/user-level-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-level-config.js","sourceRoot":"","sources":["../../src/lib/user-level-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,gEAAgE;IAChE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,sDAAsD;IACtD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,qEAAqE;IACrE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,4CAA4C;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC;IAC5C,6CAA6C;IAC7C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC;IAC9C,wEAAwE;IACxE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B;oDACgD;IAChD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,+DAA+D;IAC/D,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,2EAA2E;IAC3E,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAChD,CAAC,CAAC;AAGH;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,oBAAoB,EAAE,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,oBAAoB,EAAE,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,oBAAoB,EAAE,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;IACnC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,OAAO,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAuB;IAC1D,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC;IACpC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,aAAa,CAAC,mBAAmB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC/E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@urateam/cli",
-  "version": "0.1.39",
+  "version": "0.1.40",
   "license": "BUSL-1.1",
   "type": "module",
   "main": "dist/index.js",
@@ -22,8 +22,9 @@
     "better-sqlite3": "^11.8.0",
     "commander": "^13.1.0",
     "postgres": "^3.4.0",
-    "@urateam/core": "0.1.37",
-    "@urateam/dashboard": "0.1.37"
+    "zod": "^4.3.6",
+    "@urateam/core": "0.1.38",
+    "@urateam/dashboard": "0.1.38"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",