create-hq 6.0.0 → 10.0.0

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

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

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

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

package/dist/__tests__/deps.test.js

@@ -0,0 +1,176 @@
+import { describe, it, expect } from "vitest";
+import { getInstallCommand } from "../deps.js";
+// ─── Test Fixtures ──────────────────────────────────────────────────────────
+function makeDep(overrides = {}) {
+    return {
+        name: "test-dep",
+        command: "test --version",
+        required: true,
+        installHint: "brew install test",
+        autoInstallable: true,
+        installCommands: {},
+        ...overrides,
+    };
+}
+function makePlatform(overrides = {}) {
+    return {
+        os: "macos",
+        packageManager: "brew",
+        npmAvailable: true,
+        ...overrides,
+    };
+}
+const yqDep = makeDep({
+    name: "yq",
+    command: "yq --version",
+    installHint: "brew install yq",
+    installCommands: {
+        brew: "brew install yq",
+        apt: "sudo snap install yq",
+        dnf: "sudo dnf install yq",
+        pacman: "sudo pacman -S yq",
+    },
+});
+const ghDep = makeDep({
+    name: "gh CLI",
+    command: "gh --version",
+    required: false,
+    installHint: "brew install gh",
+    installCommands: {
+        brew: "brew install gh",
+        apt: "sudo apt install gh",
+        dnf: "sudo dnf install gh",
+        pacman: "sudo pacman -S github-cli",
+    },
+});
+const claudeCodeDep = makeDep({
+    name: "Claude Code CLI",
+    command: "claude --version",
+    installHint: "npm install -g @anthropic-ai/claude-code",
+    installCommands: {
+        npm: "npm install -g @anthropic-ai/claude-code",
+    },
+});
+const qmdDep = makeDep({
+    name: "qmd (search)",
+    command: "qmd --version",
+    installHint: "npm install -g @tobilu/qmd",
+    installCommands: {
+        npm: "npm install -g @tobilu/qmd",
+    },
+});
+const vercelDep = makeDep({
+    name: "Vercel CLI",
+    command: "vercel --version",
+    required: false,
+    installHint: "npm install -g vercel",
+    installCommands: {
+        npm: "npm install -g vercel",
+    },
+});
+const hqCliDep = makeDep({
+    name: "hq-cli",
+    command: "hq --version",
+    required: false,
+    installHint: "npm install -g @indigoai-us/hq-cli",
+    installCommands: {
+        npm: "npm install -g @indigoai-us/hq-cli",
+    },
+});
+const nodeDep = makeDep({
+    name: "Node.js",
+    command: "node --version",
+    required: true,
+    installHint: "https://nodejs.org",
+    autoInstallable: false,
+    installCommands: {},
+});
+// ─── Platforms ──────────────────────────────────────────────────────────────
+const macBrew = makePlatform({ os: "macos", packageManager: "brew", npmAvailable: true });
+const linuxApt = makePlatform({ os: "linux-debian", packageManager: "apt", npmAvailable: true });
+const linuxDnf = makePlatform({ os: "linux-fedora", packageManager: "dnf", npmAvailable: true });
+const linuxPacman = makePlatform({ os: "linux-arch", packageManager: "pacman", npmAvailable: true });
+const linuxYum = makePlatform({ os: "linux-fedora", packageManager: "yum", npmAvailable: true });
+const noPmNoNpm = makePlatform({ os: "unix", packageManager: null, npmAvailable: false });
+const noPmWithNpm = makePlatform({ os: "unix", packageManager: null, npmAvailable: true });
+// ─── Tests ──────────────────────────────────────────────────────────────────
+describe("getInstallCommand", () => {
+    describe("macOS + brew", () => {
+        it("returns brew command for yq", () => {
+            expect(getInstallCommand(yqDep, macBrew)).toBe("brew install yq");
+        });
+        it("returns brew command for gh CLI", () => {
+            expect(getInstallCommand(ghDep, macBrew)).toBe("brew install gh");
+        });
+        it("returns npm command for npm-only deps (prefers system PM, falls back to npm)", () => {
+            // Claude Code only has npm install command, no brew
+            expect(getInstallCommand(claudeCodeDep, macBrew)).toBe("npm install -g @anthropic-ai/claude-code");
+        });
+    });
+    describe("Linux + apt", () => {
+        it("returns apt command for yq", () => {
+            expect(getInstallCommand(yqDep, linuxApt)).toBe("sudo snap install yq");
+        });
+        it("returns apt command for gh CLI", () => {
+            expect(getInstallCommand(ghDep, linuxApt)).toBe("sudo apt install gh");
+        });
+    });
+    describe("Linux + dnf", () => {
+        it("returns dnf command for yq", () => {
+            expect(getInstallCommand(yqDep, linuxDnf)).toBe("sudo dnf install yq");
+        });
+    });
+    describe("Linux + pacman", () => {
+        it("returns pacman command for gh CLI", () => {
+            expect(getInstallCommand(ghDep, linuxPacman)).toBe("sudo pacman -S github-cli");
+        });
+    });
+    describe("yum → dnf fallback", () => {
+        it("maps yum to dnf commands", () => {
+            expect(getInstallCommand(yqDep, linuxYum)).toBe("sudo dnf install yq");
+        });
+    });
+    describe("npm-only deps", () => {
+        it("returns npm command for Claude Code when npm available", () => {
+            expect(getInstallCommand(claudeCodeDep, noPmWithNpm)).toBe("npm install -g @anthropic-ai/claude-code");
+        });
+        it("returns npm command for qmd when npm available", () => {
+            expect(getInstallCommand(qmdDep, noPmWithNpm)).toBe("npm install -g @tobilu/qmd");
+        });
+        it("returns npm command for Vercel CLI when npm available", () => {
+            expect(getInstallCommand(vercelDep, noPmWithNpm)).toBe("npm install -g vercel");
+        });
+        it("returns npm command for hq-cli when npm available", () => {
+            expect(getInstallCommand(hqCliDep, noPmWithNpm)).toBe("npm install -g @indigoai-us/hq-cli");
+        });
+        it("returns null for npm-only deps when npm not available", () => {
+            expect(getInstallCommand(claudeCodeDep, noPmNoNpm)).toBeNull();
+        });
+    });
+    describe("Node.js dep (no install path)", () => {
+        it("returns null — empty installCommands", () => {
+            expect(getInstallCommand(nodeDep, macBrew)).toBeNull();
+        });
+        it("returns null even with npm available", () => {
+            expect(getInstallCommand(nodeDep, noPmWithNpm)).toBeNull();
+        });
+        it("has autoInstallable set to false", () => {
+            expect(nodeDep.autoInstallable).toBe(false);
+        });
+    });
+    describe("no matching package manager and no npm", () => {
+        it("returns null for system deps when no PM and no npm", () => {
+            expect(getInstallCommand(yqDep, noPmNoNpm)).toBeNull();
+        });
+        it("returns null for gh CLI when no PM and no npm", () => {
+            expect(getInstallCommand(ghDep, noPmNoNpm)).toBeNull();
+        });
+    });
+    describe("npm fallback for system deps", () => {
+        it("falls back to npm when no system PM but npm available (for deps with npm command)", () => {
+            // yq has no npm command, so should return null
+            expect(getInstallCommand(yqDep, noPmWithNpm)).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=deps.test.js.map

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

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

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

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

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

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

package/dist/__tests__/platform.test.js

@@ -0,0 +1,127 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+// We need to mock child_process before importing the module
+const mockExecSync = vi.fn();
+vi.mock("child_process", () => ({
+    execSync: (...args) => mockExecSync(...args),
+}));
+// Dynamic import so mocks are in place
+const { detectPlatform } = await import("../platform.js");
+describe("detectPlatform", () => {
+    const validOsTypes = [
+        "macos",
+        "linux-debian",
+        "linux-fedora",
+        "linux-arch",
+        "linux",
+        "unix",
+    ];
+    const validPackageManagers = [
+        "brew",
+        "apt",
+        "dnf",
+        "yum",
+        "pacman",
+        null,
+    ];
+    beforeEach(() => {
+        mockExecSync.mockReset();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("returns a PlatformInfo object with valid os field matching process.platform", () => {
+        // Let hasBin calls succeed for common tools
+        mockExecSync.mockImplementation((cmd) => {
+            if (cmd === "which brew")
+                return Buffer.from("/opt/homebrew/bin/brew");
+            if (cmd === "which npm")
+                return Buffer.from("/usr/local/bin/npm");
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(result).toHaveProperty("os");
+        expect(result).toHaveProperty("packageManager");
+        expect(result).toHaveProperty("npmAvailable");
+        expect(validOsTypes).toContain(result.os);
+        // On macOS CI/local, process.platform is "darwin" → os should be "macos"
+        if (process.platform === "darwin") {
+            expect(result.os).toBe("macos");
+        }
+        else if (process.platform === "linux") {
+            expect(result.os).toMatch(/^linux/);
+        }
+    });
+    it("npmAvailable is a boolean", () => {
+        mockExecSync.mockImplementation((cmd) => {
+            if (cmd === "which npm")
+                return Buffer.from("/usr/local/bin/npm");
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(typeof result.npmAvailable).toBe("boolean");
+    });
+    it("packageManager is a valid value or null", () => {
+        mockExecSync.mockImplementation(() => {
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(validPackageManagers).toContain(result.packageManager);
+    });
+    it("detects brew on macOS when brew is available", () => {
+        // Mock process.platform to darwin
+        const originalPlatform = process.platform;
+        Object.defineProperty(process, "platform", { value: "darwin", writable: true });
+        mockExecSync.mockImplementation((cmd) => {
+            if (cmd === "which brew")
+                return Buffer.from("/opt/homebrew/bin/brew");
+            if (cmd === "which npm")
+                return Buffer.from("/usr/local/bin/npm");
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(result.os).toBe("macos");
+        expect(result.packageManager).toBe("brew");
+        expect(result.npmAvailable).toBe(true);
+        Object.defineProperty(process, "platform", { value: originalPlatform, writable: true });
+    });
+    it("returns null packageManager on macOS when brew is not available", () => {
+        const originalPlatform = process.platform;
+        Object.defineProperty(process, "platform", { value: "darwin", writable: true });
+        mockExecSync.mockImplementation(() => {
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(result.os).toBe("macos");
+        expect(result.packageManager).toBeNull();
+        Object.defineProperty(process, "platform", { value: originalPlatform, writable: true });
+    });
+    it("detects apt on linux-debian", () => {
+        const originalPlatform = process.platform;
+        Object.defineProperty(process, "platform", { value: "linux", writable: true });
+        mockExecSync.mockImplementation((cmd) => {
+            if (cmd === "cat /etc/os-release") {
+                return Buffer.from('ID=ubuntu\nID_LIKE=debian\nVERSION_ID="22.04"');
+            }
+            if (cmd === "which apt")
+                return Buffer.from("/usr/bin/apt");
+            if (cmd === "which npm")
+                return Buffer.from("/usr/bin/npm");
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(result.os).toBe("linux-debian");
+        expect(result.packageManager).toBe("apt");
+        Object.defineProperty(process, "platform", { value: originalPlatform, writable: true });
+    });
+    it("returns 'unix' for non-darwin non-linux platforms", () => {
+        const originalPlatform = process.platform;
+        Object.defineProperty(process, "platform", { value: "freebsd", writable: true });
+        mockExecSync.mockImplementation(() => {
+            throw new Error("not found");
+        });
+        const result = detectPlatform();
+        expect(result.os).toBe("unix");
+        Object.defineProperty(process, "platform", { value: originalPlatform, writable: true });
+    });
+});
+//# sourceMappingURL=platform.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform.test.js","sourceRoot":"","sources":["../../src/__tests__/platform.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGzE,4DAA4D;AAC5D,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC7B,EAAE,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9B,QAAQ,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;CACxD,CAAC,CAAC,CAAC;AAEJ,uCAAuC;AACvC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAE1D,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,MAAM,YAAY,GAAa;QAC7B,OAAO;QACP,cAAc;QACd,cAAc;QACd,YAAY;QACZ,OAAO;QACP,MAAM;KACP,CAAC;IAEF,MAAM,oBAAoB,GAA6B;QACrD,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,QAAQ;QACR,IAAI;KACL,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,YAAY,CAAC,SAAS,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6EAA6E,EAAE,GAAG,EAAE;QACrF,4CAA4C;QAC5C,YAAY,CAAC,kBAAkB,CAAC,CAAC,GAAW,EAAE,EAAE;YAC9C,IAAI,GAAG,KAAK,YAAY;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACvE,IAAI,GAAG,KAAK,WAAW;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAEhC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC;QAC9C,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE1C,yEAAyE;QACzE,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,YAAY,CAAC,kBAAkB,CAAC,CAAC,GAAW,EAAE,EAAE;YAC9C,IAAI,GAAG,KAAK,WAAW;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,CAAC,OAAO,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,YAAY,CAAC,kBAAkB,CAAC,GAAG,EAAE;YACnC,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,CAAC,oBAAoB,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,kCAAkC;QAClC,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhF,YAAY,CAAC,kBAAkB,CAAC,CAAC,GAAW,EAAE,EAAE;YAC9C,IAAI,GAAG,KAAK,YAAY;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;YACvE,IAAI,GAAG,KAAK,WAAW;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhF,YAAY,CAAC,kBAAkB,CAAC,GAAG,EAAE;YACnC,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC;QAEzC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/E,YAAY,CAAC,kBAAkB,CAAC,CAAC,GAAW,EAAE,EAAE;YAC9C,IAAI,GAAG,KAAK,qBAAqB,EAAE,CAAC;gBAClC,OAAO,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,GAAG,KAAK,WAAW;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC5D,IAAI,GAAG,KAAK,WAAW;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE1C,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjF,YAAY,CAAC,kBAAkB,CAAC,GAAG,EAAE;YACnC,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE/B,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

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

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

package/dist/__tests__/scaffold.test.js

@@ -0,0 +1,150 @@
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import fs from "fs-extra";
+import * as path from "path";
+import * as os from "os";
+import { execSync } from "child_process";
+import { fetchTemplate } from "../fetch-template.js";
+/**
+ * Paths within the scaffolded HQ that intentionally contain user-configurable
+ * placeholder strings like {your-username}. These are template variables meant
+ * to be replaced by users after scaffolding — not scaffold bugs.
+ */
+const PLACEHOLDER_EXEMPT_PATHS = [
+    "knowledge",
+    "starter-projects",
+    ".claude/policies",
+    ".claude/commands",
+    "modules/modules.yaml",
+    "README.md",
+    "workers",
+];
+function isExemptFromPlaceholderCheck(relPath) {
+    return PLACEHOLDER_EXEMPT_PATHS.some((exempt) => relPath.startsWith(exempt));
+}
+describe("scaffold integration", () => {
+    let tmpDir;
+    let fetchResult;
+    beforeAll(async () => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "create-hq-test-"));
+        fetchResult = await fetchTemplate(tmpDir);
+    }, 60000); // 60s timeout for network fetch
+    afterAll(() => {
+        if (tmpDir)
+            fs.removeSync(tmpDir);
+    });
+    it("creates expected top-level directories", () => {
+        const expected = [".claude", "workers", "companies", "workspace", "knowledge", "scripts"];
+        for (const dir of expected) {
+            expect(fs.existsSync(path.join(tmpDir, dir)), `Expected directory "${dir}" to exist in scaffolded HQ`).toBe(true);
+        }
+    });
+    it("creates .claude/CLAUDE.md that is non-empty", () => {
+        const claudeMd = path.join(tmpDir, ".claude", "CLAUDE.md");
+        expect(fs.existsSync(claudeMd), ".claude/CLAUDE.md must exist").toBe(true);
+        expect(fs.statSync(claudeMd).size, ".claude/CLAUDE.md must be non-empty").toBeGreaterThan(0);
+    });
+    it("creates core.yaml with valid YAML and has rules.locked array", () => {
+        const coreYaml = path.join(tmpDir, "core.yaml");
+        expect(fs.existsSync(coreYaml), "core.yaml must exist").toBe(true);
+        const content = fs.readFileSync(coreYaml, "utf-8");
+        expect(content.length, "core.yaml must be non-empty").toBeGreaterThan(0);
+        expect(content, "core.yaml must contain 'locked' key").toContain("locked");
+    });
+    it("creates executable scripts/core-integrity.sh", () => {
+        const script = path.join(tmpDir, "scripts", "core-integrity.sh");
+        expect(fs.existsSync(script), "scripts/core-integrity.sh must exist").toBe(true);
+        const stat = fs.statSync(script);
+        // Check any executable bit (owner/group/other)
+        expect(stat.mode & 0o111, "core-integrity.sh must be executable").toBeTruthy();
+    });
+    it("core-integrity.sh passes (exit code 0)", () => {
+        const script = path.join(tmpDir, "scripts", "core-integrity.sh");
+        if (!fs.existsSync(script)) {
+            // No governance script in this template version — skip gracefully
+            return;
+        }
+        // Run compute-checksums first so integrity check has fresh checksums
+        const computeScript = path.join(tmpDir, "scripts", "compute-checksums.sh");
+        if (fs.existsSync(computeScript)) {
+            execSync(`bash "${computeScript}"`, { cwd: tmpDir, stdio: "pipe" });
+        }
+        // execSync throws on non-zero exit code, so reaching next line means success
+        execSync(`bash "${script}"`, { cwd: tmpDir, stdio: "pipe" });
+        expect(true).toBe(true);
+    });
+    it("no {your-username} or {your-name} placeholder strings in core operational files", () => {
+        /**
+         * Checks that scaffolded core files (core.yaml, .claude/CLAUDE.md, scripts/, settings/)
+         * do not contain placeholder strings. User-configurable template locations such as
+         * knowledge/, starter-projects/, .claude/policies/, .claude/commands/, modules/modules.yaml,
+         * workers/, and README.md are intentionally exempt — they ship with placeholder values
+         * that users fill in after setup.
+         */
+        const violations = [];
+        const checkDir = (dir) => {
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                const relPath = path.relative(tmpDir, fullPath);
+                if (entry.isDirectory() &&
+                    !entry.name.startsWith(".git") &&
+                    entry.name !== "node_modules") {
+                    // Skip exempt directories entirely
+                    if (!PLACEHOLDER_EXEMPT_PATHS.some((e) => relPath.startsWith(e) || e.startsWith(relPath))) {
+                        checkDir(fullPath);
+                    }
+                    else if (!isExemptFromPlaceholderCheck(relPath)) {
+                        checkDir(fullPath);
+                    }
+                }
+                else if (entry.isFile() && !isExemptFromPlaceholderCheck(relPath)) {
+                    try {
+                        const content = fs.readFileSync(fullPath, "utf-8");
+                        if (content.includes("{your-username}")) {
+                            violations.push(`${relPath}: contains {your-username}`);
+                        }
+                        if (content.includes("{your-name}")) {
+                            violations.push(`${relPath}: contains {your-name}`);
+                        }
+                    }
+                    catch {
+                        // Binary file or unreadable — skip
+                    }
+                }
+            }
+        };
+        checkDir(tmpDir);
+        expect(violations, `Placeholder strings in core files:\n${violations.join("\n")}`).toHaveLength(0);
+    });
+    it("fetched version is a non-empty string", () => {
+        /**
+         * Verifies fetchTemplate returns a version string. When a GitHub release exists,
+         * this will be a semver tag (e.g. "v9.0.0"). When falling back to gh CLI without
+         * a release, it returns "latest". Either way, the string must be non-empty.
+         */
+        expect(fetchResult.version, "fetchTemplate must return a non-empty version string").toBeTruthy();
+        expect(typeof fetchResult.version).toBe("string");
+        expect(fetchResult.version.length).toBeGreaterThan(0);
+    });
+    it("fetched version matches latest release tag when a release exists", async () => {
+        /**
+         * When the GitHub repo has published releases, verifies the returned version
+         * matches the semver format of the latest release tag. Skips if no releases exist.
+         */
+        const response = await fetch("https://api.github.com/repos/indigoai-us/hq/releases/latest", { headers: { Accept: "application/vnd.github+json" } });
+        if (!response.ok) {
+            // No releases published yet — version format check not applicable
+            console.log(`  Skipping release tag format check (GitHub API returned ${response.status})`);
+            return;
+        }
+        const release = (await response.json());
+        expect(fetchResult.version, `Fetched version "${fetchResult.version}" should match latest release tag "${release.tag_name}"`).toBe(release.tag_name);
+    });
+});
+//# sourceMappingURL=scaffold.test.js.map

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

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

package/dist/auth.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Auth utilities for create-hq — OAuth PKCE flow for Clerk (US-008)
+ *
+ * Reuses the same patterns as hq-cli/src/utils/auth.ts and
+ * hq-cli/src/utils/token-store.ts but bundled inline so create-hq
+ * has no dependency on @indigoai-us/hq-cli.
+ *
+ * Token values are NEVER written to stdout or logs.
+ */
+export interface AuthToken {
+    clerk_session_token: string;
+    user_id: string;
+    email: string;
+    expires_at: string;
+}
+/** Save auth token to ~/.hq/auth.json with 0600 permissions. */
+export declare function saveToken(token: AuthToken): void;
+/** Load auth token from ~/.hq/auth.json. Returns null if missing/invalid. */
+export declare function loadToken(): AuthToken | null;
+/** Check if a token is expired or within 5 minutes of expiry. */
+export declare function isTokenExpired(token: AuthToken): boolean;
+/**
+ * Start the OAuth PKCE auth flow:
+ * 1. Generate PKCE code_verifier + code_challenge
+ * 2. Start local HTTP server on a random port for the callback
+ * 3. Open browser to Clerk auth URL
+ * 4. Wait for callback with auth code
+ * 5. Exchange code for token via registry /auth/token endpoint
+ * 6. Save token and return AuthToken
+ */
+export declare function startAuthFlow(registryUrl: string): Promise<AuthToken>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,MAAM,WAAW,SAAS;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAaD,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAIhD;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,IAAI,SAAS,GAAG,IAAI,CAqB5C;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAIxD;AA0BD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAkG3E"}