@urateam/cli 0.1.39 → 0.1.41

package/dist/__tests__/start-user-level-fallback.test.js

@@ -0,0 +1,191 @@
+/**
+ * `buildRepoConfigsFromEnv` — user-level config fallback.
+ *
+ * When no `REPO_*` env vars produce a RepoConfig, the function should fall
+ * back to reading `~/.urateam/config.json` (or `$URATEAM_HOME/config.json`).
+ * Env vars win when both are present so the existing project-level
+ * `ura start` deploys are unaffected.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { writeUserLevelConfig } from "../lib/user-level-config.js";
+import { buildRepoConfigsFromEnv } from "../lib/build-repo-configs.js";
+describe("buildRepoConfigsFromEnv — user-level fallback", () => {
+    let tmp;
+    const envBackup = {};
+    const ENV_KEYS_TO_STRIP = [
+        "REPO_TEAM_ID",
+        "REPO_URL",
+        "REPO_DEFAULT_BRANCH",
+        "REPO_TEST_CMD",
+        "REPO_BUILD_CMD",
+    ];
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), "ura-fallback-"));
+        process.env.URATEAM_HOME = tmp;
+        for (const k of ENV_KEYS_TO_STRIP) {
+            envBackup[k] = process.env[k];
+            delete process.env[k];
+        }
+    });
+    afterEach(() => {
+        delete process.env.URATEAM_HOME;
+        for (const [k, v] of Object.entries(envBackup)) {
+            if (v === undefined)
+                delete process.env[k];
+            else
+                process.env[k] = v;
+            delete envBackup[k];
+        }
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    it("returns an empty map when no env vars and no user-level config", () => {
+        expect(buildRepoConfigsFromEnv()).toEqual({});
+    });
+    it("loads from ~/.urateam/config.json when no REPO_* env vars are set", () => {
+        writeUserLevelConfig({
+            version: 1,
+            repos: [
+                {
+                    url: "https://github.com/o/r.git",
+                    path: "/tmp/r",
+                    defaultBranch: "main",
+                    testCommand: "pnpm test",
+                    buildCommand: "pnpm build",
+                    teamId: "team-1",
+                },
+            ],
+        });
+        const configs = buildRepoConfigsFromEnv();
+        expect(configs["team-1"]).toBeDefined();
+        expect(configs["team-1"].url).toBe("https://github.com/o/r.git");
+        expect(configs["team-1"].defaultBranch).toBe("main");
+    });
+    it("propagates labelPattern when present (BEC-177 routing)", () => {
+        writeUserLevelConfig({
+            version: 1,
+            repos: [
+                {
+                    url: "https://github.com/o/r.git",
+                    path: "/tmp/r",
+                    defaultBranch: "main",
+                    testCommand: "pnpm test",
+                    buildCommand: "pnpm build",
+                    teamId: "team-1",
+                    labelPattern: "auto-implement",
+                },
+            ],
+        });
+        const configs = buildRepoConfigsFromEnv();
+        expect(configs["team-1"].labelPattern).toBe("auto-implement");
+    });
+    it("keys repos by url-slug when teamId is omitted", () => {
+        writeUserLevelConfig({
+            version: 1,
+            repos: [
+                {
+                    url: "https://github.com/o/no-team.git",
+                    path: "/tmp/no-team",
+                    defaultBranch: "main",
+                    testCommand: "pnpm test",
+                    buildCommand: "pnpm build",
+                },
+            ],
+        });
+        const configs = buildRepoConfigsFromEnv();
+        expect(Object.keys(configs)).toHaveLength(1);
+        const key = Object.keys(configs)[0];
+        expect(key).toContain("no-team");
+    });
+    it("env vars win over user-level config (project-level back-compat)", () => {
+        writeUserLevelConfig({
+            version: 1,
+            repos: [
+                {
+                    url: "https://github.com/user-level/r.git",
+                    path: "/p",
+                    defaultBranch: "main",
+                    testCommand: "pnpm test",
+                    buildCommand: "pnpm build",
+                    teamId: "team-userlevel",
+                },
+            ],
+        });
+        process.env.REPO_TEAM_ID = "team-env";
+        process.env.REPO_URL = "https://github.com/env-var/r.git";
+        const configs = buildRepoConfigsFromEnv();
+        expect(configs["team-env"]).toBeDefined();
+        expect(configs["team-env"].url).toBe("https://github.com/env-var/r.git");
+        expect(configs["team-userlevel"]).toBeUndefined();
+    });
+    it("handles multiple repos in the user-level config", () => {
+        writeUserLevelConfig({
+            version: 1,
+            repos: [
+                {
+                    url: "https://github.com/o/a.git",
+                    path: "/tmp/a",
+                    defaultBranch: "main",
+                    testCommand: "pnpm test",
+                    buildCommand: "pnpm build",
+                    teamId: "team-a",
+                },
+                {
+                    url: "https://github.com/o/b.git",
+                    path: "/tmp/b",
+                    defaultBranch: "main",
+                    testCommand: "pnpm test",
+                    buildCommand: "pnpm build",
+                    teamId: "team-b",
+                },
+            ],
+        });
+        const configs = buildRepoConfigsFromEnv();
+        expect(Object.keys(configs).sort()).toEqual(["team-a", "team-b"]);
+    });
+});
+describe("requireRepoConfigs — branched error messages", () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), "ura-req-"));
+        process.env.URATEAM_HOME = tmp;
+    });
+    afterEach(() => {
+        delete process.env.URATEAM_HOME;
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    it("prints a 'ura repo add' hint when ~/.urateam/config.json exists but has no repos", async () => {
+        writeUserLevelConfig({ version: 1, repos: [] });
+        const errSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        const exitSpy = vi.spyOn(process, "exit").mockImplementation((() => {
+            throw new Error("exit");
+        }));
+        const { requireRepoConfigs } = await import("../lib/build-repo-configs.js");
+        expect(() => requireRepoConfigs({}, "ura start")).toThrow();
+        const msg = errSpy.mock.calls.flat().join("\n");
+        expect(msg).toContain("ura repo add");
+        expect(msg).not.toContain("REPO_TEAM_ID and REPO_URL in .urateam/.env"); // user-level branch
+        errSpy.mockRestore();
+        exitSpy.mockRestore();
+    });
+    it("prints both install paths when no ~/.urateam/config.json exists yet", async () => {
+        // Don't write a config — exercises the `userConfig === null` branch
+        const errSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        const exitSpy = vi.spyOn(process, "exit").mockImplementation((() => {
+            throw new Error("exit");
+        }));
+        const { requireRepoConfigs } = await import("../lib/build-repo-configs.js");
+        expect(() => requireRepoConfigs({}, "ura start")).toThrow();
+        const msg = errSpy.mock.calls.flat().join("\n");
+        expect(msg).toContain("REPO_TEAM_ID");
+        expect(msg).toContain("ura init");
+        expect(msg).toContain("ura repo add");
+        errSpy.mockRestore();
+        exitSpy.mockRestore();
+    });
+});
+// vi needs to be available — re-import at top-level for the new tests
+import { vi } from "vitest";
+//# sourceMappingURL=start-user-level-fallback.test.js.map

package/dist/__tests__/start-user-level-fallback.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-user-level-fallback.test.js","sourceRoot":"","sources":["../../src/__tests__/start-user-level-fallback.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,QAAQ,CAAC,+CAA+C,EAAE,GAAG,EAAE;IAC7D,IAAI,GAAW,CAAC;IAChB,MAAM,SAAS,GAAuC,EAAE,CAAC;IACzD,MAAM,iBAAiB,GAAG;QACxB,cAAc;QACd,UAAU;QACV,qBAAqB;QACrB,eAAe;QACf,gBAAgB;KACjB,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC;YAClC,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAChC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/C,IAAI,CAAC,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;;gBACtC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACxB,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;QACD,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,CAAC,uBAAuB,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,oBAAoB,CAAC;YACnB,OAAO,EAAE,CAAC;YACV,KAAK,EAAE;gBACL;oBACE,GAAG,EAAE,4BAA4B;oBACjC,IAAI,EAAE,QAAQ;oBACd,aAAa,EAAE,MAAM;oBACrB,WAAW,EAAE,WAAW;oBACxB,YAAY,EAAE,YAAY;oBAC1B,MAAM,EAAE,QAAQ;iBACjB;aACF;SACF,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAClE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAE,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,oBAAoB,CAAC;YACnB,OAAO,EAAE,CAAC;YACV,KAAK,EAAE;gBACL;oBACE,GAAG,EAAE,4BAA4B;oBACjC,IAAI,EAAE,QAAQ;oBACd,aAAa,EAAE,MAAM;oBACrB,WAAW,EAAE,WAAW;oBACxB,YAAY,EAAE,YAAY;oBAC1B,MAAM,EAAE,QAAQ;oBAChB,YAAY,EAAE,gBAAgB;iBAC/B;aACF;SACF,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAE,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,oBAAoB,CAAC;YACnB,OAAO,EAAE,CAAC;YACV,KAAK,EAAE;gBACL;oBACE,GAAG,EAAE,kCAAkC;oBACvC,IAAI,EAAE,cAAc;oBACpB,aAAa,EAAE,MAAM;oBACrB,WAAW,EAAE,WAAW;oBACxB,YAAY,EAAE,YAAY;iBAC3B;aACF;SACF,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,oBAAoB,CAAC;YACnB,OAAO,EAAE,CAAC;YACV,KAAK,EAAE;gBACL;oBACE,GAAG,EAAE,qCAAqC;oBAC1C,IAAI,EAAE,IAAI;oBACV,aAAa,EAAE,MAAM;oBACrB,WAAW,EAAE,WAAW;oBACxB,YAAY,EAAE,YAAY;oBAC1B,MAAM,EAAE,gBAAgB;iBACzB;aACF;SACF,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,UAAU,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,kCAAkC,CAAC;QAC1D,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,UAAU,CAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAC1E,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,oBAAoB,CAAC;YACnB,OAAO,EAAE,CAAC;YACV,KAAK,EAAE;gBACL;oBACE,GAAG,EAAE,4BAA4B;oBACjC,IAAI,EAAE,QAAQ;oBACd,aAAa,EAAE,MAAM;oBACrB,WAAW,EAAE,WAAW;oBACxB,YAAY,EAAE,YAAY;oBAC1B,MAAM,EAAE,QAAQ;iBACjB;gBACD;oBACE,GAAG,EAAE,4BAA4B;oBACjC,IAAI,EAAE,QAAQ;oBACd,aAAa,EAAE,MAAM;oBACrB,WAAW,EAAE,WAAW;oBACxB,YAAY,EAAE,YAAY;oBAC1B,MAAM,EAAE,QAAQ;iBACjB;aACF;SACF,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,uBAAuB,EAAE,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8CAA8C,EAAE,GAAG,EAAE;IAC5D,IAAI,GAAW,CAAC;IAChB,UAAU,CAAC,GAAG,EAAE;QACd,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAChC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kFAAkF,EAAE,KAAK,IAAI,EAAE;QAChG,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,GAAG,EAAE;YACjE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAQ,CAAC,CAAC;QACX,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;QAC5E,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,4CAA4C,CAAC,CAAC,CAAC,oBAAoB;QAC7F,MAAM,CAAC,WAAW,EAAE,CAAC;QACrB,OAAO,CAAC,WAAW,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,oEAAoE;QACpE,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,GAAG,EAAE;YACjE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAQ,CAAC,CAAC;QACX,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;QAC5E,MAAM,CAAC,GAAG,EAAE,CAAC,kBAAkB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACtC,MAAM,CAAC,WAAW,EAAE,CAAC;QACrB,OAAO,CAAC,WAAW,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,sEAAsE;AACtE,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC"}

package/dist/__tests__/uninstall.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=uninstall.test.d.ts.map

package/dist/__tests__/uninstall.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/uninstall.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/uninstall.test.js

@@ -0,0 +1,51 @@
+/**
+ * `ura uninstall` — remove the user-level install at ~/.urateam (or
+ * $URATEAM_HOME).
+ *
+ * Destructive, so gated on `--yes`. Without `--yes`, prints what would be
+ * deleted and exits 0. With `--yes`, recursively removes the directory.
+ * No-op if the directory doesn't exist (so re-running after a manual
+ * `rm -rf ~/.urateam` doesn't error).
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { mkdtempSync, mkdirSync, existsSync, writeFileSync, rmSync, } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { uninstallCommand } from "../commands/uninstall.js";
+describe("ura uninstall", () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), "ura-uninst-"));
+        process.env.URATEAM_HOME = tmp;
+        mkdirSync(join(tmp, "data"), { recursive: true });
+        mkdirSync(join(tmp, "repos"), { recursive: true });
+        writeFileSync(join(tmp, "config.json"), '{"version":1,"repos":[]}');
+    });
+    afterEach(() => {
+        delete process.env.URATEAM_HOME;
+    });
+    it("removes URATEAM_HOME when --yes is passed", async () => {
+        await uninstallCommand.parseAsync(["--yes"], { from: "user" });
+        expect(existsSync(tmp)).toBe(false);
+    });
+    it("aborts without --yes (no destructive action)", async () => {
+        const spy = vi.spyOn(console, "log").mockImplementation(() => { });
+        await uninstallCommand.parseAsync([], { from: "user" });
+        expect(existsSync(tmp)).toBe(true);
+        expect(spy.mock.calls.flat().join("\n")).toMatch(/--yes/i);
+        spy.mockRestore();
+        // Test-cleanup: remove the directory manually since uninstall didn't.
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    it("is a no-op when URATEAM_HOME does not exist", async () => {
+        rmSync(tmp, { recursive: true, force: true });
+        await expect(uninstallCommand.parseAsync(["--yes"], { from: "user" })).resolves.not.toThrow();
+    });
+    it("prints an npm-uninstall hint after a successful removal", async () => {
+        const spy = vi.spyOn(console, "log").mockImplementation(() => { });
+        await uninstallCommand.parseAsync(["--yes"], { from: "user" });
+        expect(spy.mock.calls.flat().join("\n")).toContain("npm uninstall -g @urateam/cli");
+        spy.mockRestore();
+    });
+});
+//# sourceMappingURL=uninstall.test.js.map

package/dist/__tests__/uninstall.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.test.js","sourceRoot":"","sources":["../../src/__tests__/uninstall.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/user-level-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=user-level-config.test.d.ts.map

package/dist/__tests__/user-level-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-level-config.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/user-level-config.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/user-level-config.test.js

@@ -0,0 +1,92 @@
+/**
+ * User-level config — schema + read/write/path helpers.
+ *
+ * The user-level install path stores its state at `~/.urateam/` (or
+ * `$URATEAM_HOME` when set). This module is the source of truth for the
+ * schema, the on-disk locations, and the round-trip read/write contract.
+ *
+ * Tests use a temp-dir override via `URATEAM_HOME` to keep them hermetic.
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { resolveUserLevelHome, readUserLevelConfig, writeUserLevelConfig, UserLevelConfigSchema, } from "../lib/user-level-config.js";
+describe("resolveUserLevelHome", () => {
+    const envBefore = process.env.URATEAM_HOME;
+    afterEach(() => {
+        if (envBefore === undefined)
+            delete process.env.URATEAM_HOME;
+        else
+            process.env.URATEAM_HOME = envBefore;
+    });
+    it("returns ~/.urateam by default", () => {
+        delete process.env.URATEAM_HOME;
+        const home = resolveUserLevelHome();
+        expect(home.endsWith("/.urateam")).toBe(true);
+    });
+    it("honors URATEAM_HOME override", () => {
+        process.env.URATEAM_HOME = "/tmp/test-urateam";
+        expect(resolveUserLevelHome()).toBe("/tmp/test-urateam");
+    });
+});
+describe("readUserLevelConfig / writeUserLevelConfig", () => {
+    let tmp;
+    beforeEach(() => {
+        tmp = mkdtempSync(join(tmpdir(), "ura-test-"));
+        process.env.URATEAM_HOME = tmp;
+    });
+    afterEach(() => {
+        delete process.env.URATEAM_HOME;
+        rmSync(tmp, { recursive: true, force: true });
+    });
+    it("round-trips an empty config", () => {
+        const config = { version: 1, repos: [] };
+        writeUserLevelConfig(config);
+        expect(readUserLevelConfig()).toEqual(config);
+    });
+    it("returns null when the config file does not exist", () => {
+        expect(readUserLevelConfig()).toBeNull();
+    });
+    it("validates repo entries against the zod schema (rejects malformed)", () => {
+        writeFileSync(join(tmp, "config.json"), JSON.stringify({ version: 1, repos: [{ url: 42 }] }));
+        expect(() => readUserLevelConfig()).toThrow();
+    });
+    it("schema accepts minimum repo fields (url + defaultBranch + paths + commands)", () => {
+        const result = UserLevelConfigSchema.safeParse({
+            version: 1,
+            repos: [
+                {
+                    url: "https://github.com/o/r.git",
+                    path: "/tmp/r",
+                    defaultBranch: "main",
+                    testCommand: "pnpm test",
+                    buildCommand: "pnpm build",
+                },
+            ],
+        });
+        expect(result.success).toBe(true);
+    });
+    it("schema accepts optional teamId and labelPattern", () => {
+        const result = UserLevelConfigSchema.safeParse({
+            version: 1,
+            repos: [
+                {
+                    url: "https://github.com/o/r.git",
+                    path: "/tmp/r",
+                    defaultBranch: "main",
+                    testCommand: "pnpm test",
+                    buildCommand: "pnpm build",
+                    teamId: "team-abc",
+                    labelPattern: "auto-implement",
+                },
+            ],
+        });
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.data.repos[0].teamId).toBe("team-abc");
+            expect(result.data.repos[0].labelPattern).toBe("auto-implement");
+        }
+    });
+});
+//# sourceMappingURL=user-level-config.test.js.map

package/dist/__tests__/user-level-config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-level-config.test.js","sourceRoot":"","sources":["../../src/__tests__/user-level-config.test.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -0,0 +1,11 @@
+import { Command } from "commander";
+/**
+ * Bootstrap a user-level urateam install at `~/.urateam/` (or `$URATEAM_HOME`).
+ *
+ * Creates the directory skeleton (`config.json`, `data/`, `repos/`) and
+ * prints a one-line next-step hint. Idempotent: if `config.json` already
+ * exists, the existing config is preserved — only missing subdirectories
+ * are created.
+ */
+export declare const initCommand: Command;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,SAmBpB,CAAC"}

package/dist/commands/init.js

@@ -0,0 +1,27 @@
+import { Command } from "commander";
+import { mkdirSync } from "node:fs";
+import { resolveUserLevelHome, userLevelConfigPath, userLevelDataDir, userLevelReposDir, writeUserLevelConfig, readUserLevelConfig, } from "../lib/user-level-config.js";
+/**
+ * Bootstrap a user-level urateam install at `~/.urateam/` (or `$URATEAM_HOME`).
+ *
+ * Creates the directory skeleton (`config.json`, `data/`, `repos/`) and
+ * prints a one-line next-step hint. Idempotent: if `config.json` already
+ * exists, the existing config is preserved — only missing subdirectories
+ * are created.
+ */
+export const initCommand = new Command("init")
+    .description("Bootstrap a user-level urateam install at ~/.urateam (or $URATEAM_HOME)")
+    .action(() => {
+    const home = resolveUserLevelHome();
+    mkdirSync(home, { recursive: true });
+    mkdirSync(userLevelDataDir(), { recursive: true });
+    mkdirSync(userLevelReposDir(), { recursive: true });
+    if (readUserLevelConfig() !== null) {
+        console.log(`ura init: ${userLevelConfigPath()} already exists — leaving it untouched.`);
+        return;
+    }
+    writeUserLevelConfig({ version: 1, repos: [] });
+    console.log(`ura init: created ${home}`);
+    console.log("Next: ura repo add <url>");
+});
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC3C,WAAW,CACV,yEAAyE,CAC1E;KACA,MAAM,CAAC,GAAG,EAAE;IACX,MAAM,IAAI,GAAG,oBAAoB,EAAE,CAAC;IACpC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,SAAS,CAAC,gBAAgB,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,SAAS,CAAC,iBAAiB,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpD,IAAI,mBAAmB,EAAE,KAAK,IAAI,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CACT,aAAa,mBAAmB,EAAE,yCAAyC,CAC5E,CAAC;QACF,OAAO;IACT,CAAC;IACD,oBAAoB,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC"}

package/dist/commands/repo.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+/**
+ * `ura repo` — the parent command. The subcommands below carry the
+ * actual behavior.
+ */
+export declare const repoCommand: Command;
+//# sourceMappingURL=repo.d.ts.map

package/dist/commands/repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/commands/repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyCpC;;;GAGG;AACH,eAAO,MAAM,WAAW,SAEvB,CAAC"}

package/dist/commands/repo.js

@@ -0,0 +1,126 @@
+import { Command } from "commander";
+import { rmSync } from "node:fs";
+import { join, basename } from "node:path";
+import { cloneRepo } from "@urateam/core";
+import { readUserLevelConfig, writeUserLevelConfig, resolveUserLevelHome, userLevelReposDir, } from "../lib/user-level-config.js";
+/**
+ * Derive a filesystem-safe slug from a repo URL. Handles:
+ *   https://github.com/org/name.git   → "name"
+ *   git@github.com:org/name.git       → "name"
+ *   ssh://git@host/path/to/name       → "name"
+ *
+ * Characters outside `[A-Za-z0-9._-]` are replaced with `-` so the slug
+ * survives use as a directory name on every platform we target.
+ */
+function deriveSlug(url) {
+    const stripped = url.replace(/\.git$/, "");
+    const last = stripped.split(/[/:]/).filter(Boolean).pop() ?? "repo";
+    return last.replace(/[^A-Za-z0-9._-]/g, "-");
+}
+/**
+ * Load the user-level config, or throw a helpful "run `ura init` first"
+ * error so the operator isn't left guessing why the command failed.
+ */
+function loadOrThrow() {
+    const cfg = readUserLevelConfig();
+    if (!cfg) {
+        throw new Error(`ura: no user-level config found. Run 'ura init' first.`);
+    }
+    return cfg;
+}
+/**
+ * `ura repo` — the parent command. The subcommands below carry the
+ * actual behavior.
+ */
+export const repoCommand = new Command("repo").description("Manage repos in the user-level config (~/.urateam/config.json)");
+/**
+ * `ura repo add <url> [--branch] [--test-command] [--build-command]
+ *                     [--team] [--label-pattern]`
+ *
+ * Clones the repo into `~/.urateam/repos/<slug>` and appends to
+ * `config.json`. Rejects duplicate URLs so re-running by accident doesn't
+ * produce two near-identical entries for the same upstream.
+ */
+repoCommand
+    .command("add <url>")
+    .description("Clone <url> into ~/.urateam/repos/<slug> and register it")
+    .option("--branch <name>", "Default branch (defaults to 'main')", "main")
+    .option("--test-command <cmd>", "Test command", "pnpm test")
+    .option("--build-command <cmd>", "Build command", "pnpm build")
+    .option("--team <id>", "Linear team ID (optional)")
+    .option("--label-pattern <pattern>", "Pipeline label pattern (BEC-177 routing)")
+    .action(async (url, opts) => {
+    const cfg = loadOrThrow();
+    if (cfg.repos.some((r) => r.url === url)) {
+        throw new Error(`ura: ${url} is already configured.`);
+    }
+    const slug = deriveSlug(url);
+    const path = join(userLevelReposDir(), slug);
+    await cloneRepo(url, path);
+    const repo = {
+        url,
+        path,
+        defaultBranch: opts.branch,
+        testCommand: opts.testCommand,
+        buildCommand: opts.buildCommand,
+        ...(opts.team && { teamId: opts.team }),
+        ...(opts.labelPattern && { labelPattern: opts.labelPattern }),
+    };
+    cfg.repos.push(repo);
+    writeUserLevelConfig(cfg);
+    console.log(`ura repo add: cloned ${url} → ${path}`);
+});
+/**
+ * `ura repo list` — print the configured repos.
+ *
+ * Output is plain text; one repo per line. When no repos are configured,
+ * prints a hint pointing at `ura repo add`.
+ */
+repoCommand
+    .command("list")
+    .description("List configured repos")
+    .action(() => {
+    const cfg = loadOrThrow();
+    if (cfg.repos.length === 0) {
+        console.log("ura repo list: no repos configured. Run 'ura repo add <url>'.");
+        return;
+    }
+    for (const r of cfg.repos) {
+        console.log(`  ${basename(r.path)}\t${r.url}\t(${r.defaultBranch})`);
+    }
+});
+/**
+ * `ura repo remove <slug> [--purge]`
+ *
+ * Removes the repo from `config.json`. The clone on disk is preserved by
+ * default so operators don't lose uncommitted work; `--purge` deletes the
+ * directory after the config update.
+ */
+repoCommand
+    .command("remove <slug>")
+    .description("Remove a repo from config (use --purge to delete the clone)")
+    .option("--purge", "Also delete the cloned directory on disk")
+    .action((slug, opts) => {
+    const cfg = loadOrThrow();
+    const idx = cfg.repos.findIndex((r) => basename(r.path) === slug);
+    if (idx === -1) {
+        throw new Error(`ura repo remove: slug '${slug}' not found.`);
+    }
+    const [removed] = cfg.repos.splice(idx, 1);
+    writeUserLevelConfig(cfg);
+    if (opts.purge && removed) {
+        // Path-safety guard: `config.json` is a plain file an operator can
+        // hand-edit. Without this check, a config entry with `"path": "/"` or
+        // `"path": "/home/operator"` would silently `rm -rf` that path on
+        // `--purge`. Restrict purges to descendants of URATEAM_HOME (the
+        // directory `ura repo add` writes into by construction).
+        const home = resolveUserLevelHome();
+        if (!removed.path.startsWith(home + "/")) {
+            throw new Error(`ura repo remove --purge: refusing to delete '${removed.path}' — ` +
+                `path is not under ${home}. (Config entry may have been hand-edited.)`);
+        }
+        rmSync(removed.path, { recursive: true, force: true });
+    }
+    console.log(`ura repo remove: removed '${slug}'${opts.purge ? " and deleted the clone" : ""}`);
+});
+//# sourceMappingURL=repo.js.map

package/dist/commands/repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.js","sourceRoot":"","sources":["../../src/commands/repo.ts"],"names":[],"mappings":"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"}

package/dist/commands/service.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `ura service install` / `ura service uninstall`
+ *
+ * Generates a platform-appropriate service unit (launchd plist on macOS,
+ * systemd-user unit on Linux) so the user-level daemon auto-starts on login.
+ * Mirrors what `deploy/USER_LEVEL_INSTALL.md` previously documented as
+ * copy-paste blocks. Idempotent: refuses to overwrite an existing unit
+ * (operator must uninstall first). `--dry-run` prints the unit content
+ * without touching the filesystem.
+ */
+import { Command } from "commander";
+export declare const serviceCommand: Command;
+//# sourceMappingURL=service.d.ts.map

package/dist/commands/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/commands/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwGpC,eAAO,MAAM,cAAc,SAE1B,CAAC"}