create-hq 6.0.0 → 7.0.0

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/cloud-sync.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Detect whether cloud sync has already been configured for this HQ directory.
+ *
+ * Checks for the presence of `.hq-cloud/` config directory or a
+ * `.hq-cloud-config.json` file that would indicate a prior sync setup.
+ *
+ * This is a local-only stub — the full cloud detection (checking remote S3
+ * for existing files) happens via `@indigoai/hq-cloud` during the setup flow.
+ */
+export declare function detectExistingSync(targetDir: string): Promise<boolean>;
+//# sourceMappingURL=cloud-sync.d.ts.map

package/dist/cloud-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-sync.d.ts","sourceRoot":"","sources":["../src/cloud-sync.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAc5E"}

package/dist/cloud-sync.js

@@ -0,0 +1,25 @@
+import * as path from "path";
+import fs from "fs-extra";
+/**
+ * Detect whether cloud sync has already been configured for this HQ directory.
+ *
+ * Checks for the presence of `.hq-cloud/` config directory or a
+ * `.hq-cloud-config.json` file that would indicate a prior sync setup.
+ *
+ * This is a local-only stub — the full cloud detection (checking remote S3
+ * for existing files) happens via `@indigoai/hq-cloud` during the setup flow.
+ */
+export async function detectExistingSync(targetDir) {
+    const checks = [
+        path.join(targetDir, ".hq-cloud"),
+        path.join(targetDir, ".hq-cloud-config.json"),
+        path.join(targetDir, "settings", "cloud.json"),
+    ];
+    for (const p of checks) {
+        if (fs.existsSync(p)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=cloud-sync.js.map

package/dist/cloud-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-sync.js","sourceRoot":"","sources":["../src/cloud-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,MAAM,UAAU,CAAC;AAE1B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB;IACxD,MAAM,MAAM,GAAG;QACb,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,uBAAuB,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC;KAC/C,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"AAqDA,wBAAgB,SAAS,IAAI;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,CAoBpD"}
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"AA2DA,wBAAgB,SAAS,IAAI;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,CAoBpD"}

package/dist/deps.js

@@ -17,7 +17,13 @@ const deps = [
         name: "qmd (search)",
         command: "qmd --version",
         required: true,
-        installHint: "brew install tobi/tap/qmd",
+        installHint: "npm install -g @tobilu/qmd",
+    },
+    {
+        name: "yq",
+        command: "yq --version",
+        required: true,
+        installHint: "brew install yq",
     },
     {
         name: "gh CLI",

package/dist/deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"deps.js","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAS9C,MAAM,IAAI,GAAU;IAClB;QACE,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,gBAAgB;QACzB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,oBAAoB;KAClC;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,kBAAkB;QAC3B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,0CAA0C;KACxD;IACD;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,eAAe;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,2BAA2B;KACzC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,iBAAiB;KAC/B;IACD;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,kBAAkB;QAC3B,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,uBAAuB;KACrC;CACF,CAAC;AAEF,SAAS,YAAY,CAAC,OAAe;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAE1C,IAAI,WAAW,GAAG,IAAI,CAAC;IAEvB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC;aAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,YAAY,CAAC,CAAC;YAC9B,IAAI,CAAC,YAAY,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACpC,WAAW,GAAG,KAAK,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,iBAAiB,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC"}
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAS9C,MAAM,IAAI,GAAU;IAClB;QACE,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,gBAAgB;QACzB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,oBAAoB;KAClC;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,kBAAkB;QAC3B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,0CAA0C;KACxD;IACD;QACE,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,eAAe;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,4BAA4B;KAC1C;IACD;QACE,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,iBAAiB;KAC/B;IACD;QACE,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,iBAAiB;KAC/B;IACD;QACE,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,kBAAkB;QAC3B,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,uBAAuB;KACrC;CACF,CAAC;AAEF,SAAS,YAAY,CAAC,OAAe;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAE1C,IAAI,WAAW,GAAG,IAAI,CAAC;IAEvB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,GAAG,CAAC,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC;aAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,YAAY,CAAC,CAAC;YAC9B,IAAI,CAAC,YAAY,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACpC,WAAW,GAAG,KAAK,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,iBAAiB,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC"}

package/dist/fetch-template.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Fetch the HQ template from GitHub and extract it into targetDir.
+ *
+ * Strategy:
+ * 1. GitHub REST API → download tarball_url
+ * 2. Fallback: gh CLI (`gh api repos/indigoai-us/hq/tarball/{ref}`)
+ * 3. If both fail: throw with manual clone instructions
+ *
+ * Returns the version tag that was fetched.
+ */
+export declare function fetchTemplate(targetDir: string, tag?: string): Promise<{
+    version: string;
+}>;
+//# sourceMappingURL=fetch-template.d.ts.map

package/dist/fetch-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-template.d.ts","sourceRoot":"","sources":["../src/fetch-template.ts"],"names":[],"mappings":"AAsGA;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAwC9B"}

package/dist/fetch-template.js

@@ -0,0 +1,136 @@
+import fs from "fs-extra";
+import * as path from "path";
+import * as os from "os";
+import { execSync } from "child_process";
+const REPO = "indigoai-us/hq";
+const GITHUB_API = "https://api.github.com";
+async function getLatestRelease() {
+    const response = await fetch(`${GITHUB_API}/repos/${REPO}/releases/latest`, {
+        headers: { Accept: "application/vnd.github+json" },
+    });
+    if (!response.ok) {
+        throw new Error(`GitHub API returned ${response.status}: ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return data;
+}
+async function getTagRelease(tag) {
+    const response = await fetch(`${GITHUB_API}/repos/${REPO}/releases/tags/${tag}`, {
+        headers: { Accept: "application/vnd.github+json" },
+    });
+    if (!response.ok) {
+        throw new Error(`GitHub API returned ${response.status}: ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return data;
+}
+async function downloadAndExtractViaApi(tarballUrl, targetDir) {
+    const response = await fetch(tarballUrl, {
+        headers: { Accept: "application/vnd.github+json" },
+        redirect: "follow",
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to download tarball: ${response.status} ${response.statusText}`);
+    }
+    const buffer = await response.arrayBuffer();
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "create-hq-"));
+    const tarPath = path.join(tmpDir, "hq.tar.gz");
+    try {
+        fs.writeFileSync(tarPath, Buffer.from(buffer));
+        extractTemplateDirFromTar(tarPath, targetDir);
+    }
+    finally {
+        fs.removeSync(tmpDir);
+    }
+}
+function extractTemplateDirFromTar(tarPath, targetDir) {
+    // The tarball contains a top-level directory like `indigoai-us-hq-<sha>/`
+    // We need to find the `template/` subdirectory within that and extract it.
+    const tmpExtract = fs.mkdtempSync(path.join(os.tmpdir(), "create-hq-extract-"));
+    try {
+        // Extract the full tarball to a temp location
+        execSync(`tar -xzf "${tarPath}" -C "${tmpExtract}"`, { stdio: "pipe" });
+        // Find the top-level directory created by GitHub's tarball
+        const entries = fs.readdirSync(tmpExtract);
+        if (entries.length === 0) {
+            throw new Error("Tarball was empty");
+        }
+        const rootDir = path.join(tmpExtract, entries[0]);
+        const templateSrc = path.join(rootDir, "template");
+        if (!fs.existsSync(templateSrc)) {
+            throw new Error("template/ directory not found in HQ tarball");
+        }
+        // Copy template contents to targetDir
+        fs.ensureDirSync(targetDir);
+        fs.copySync(templateSrc, targetDir, { overwrite: true });
+    }
+    finally {
+        fs.removeSync(tmpExtract);
+    }
+}
+function extractTemplateDirViaGhCli(tag, targetDir) {
+    const ref = tag || "HEAD";
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "create-hq-gh-"));
+    const tarPath = path.join(tmpDir, "hq.tar.gz");
+    try {
+        // Use sh -c so that output redirection works
+        execSync(`gh api repos/${REPO}/tarball/${ref} > "${tarPath}"`, {
+            stdio: "pipe",
+            shell: "/bin/sh",
+        });
+        extractTemplateDirFromTar(tarPath, targetDir);
+    }
+    finally {
+        fs.removeSync(tmpDir);
+    }
+}
+/**
+ * Fetch the HQ template from GitHub and extract it into targetDir.
+ *
+ * Strategy:
+ * 1. GitHub REST API → download tarball_url
+ * 2. Fallback: gh CLI (`gh api repos/indigoai-us/hq/tarball/{ref}`)
+ * 3. If both fail: throw with manual clone instructions
+ *
+ * Returns the version tag that was fetched.
+ */
+export async function fetchTemplate(targetDir, tag) {
+    let version = tag || "";
+    let tarballUrl = "";
+    let apiError = null;
+    // --- Attempt 1: GitHub API ---
+    try {
+        const release = tag ? await getTagRelease(tag) : await getLatestRelease();
+        version = release.tag_name;
+        tarballUrl = release.tarball_url;
+        await downloadAndExtractViaApi(tarballUrl, targetDir);
+        return { version };
+    }
+    catch (err) {
+        apiError = err;
+    }
+    // --- Attempt 2: gh CLI fallback ---
+    try {
+        const ref = tag || "HEAD";
+        extractTemplateDirViaGhCli(ref, targetDir);
+        // If we got a version from the API response (even if download failed later), keep it.
+        // Otherwise mark as unknown.
+        if (!version) {
+            version = tag || "latest";
+        }
+        return { version };
+    }
+    catch (ghErr) {
+        // Both failed — provide a clear error message.
+        const apiMsg = apiError instanceof Error ? apiError.message : String(apiError);
+        const ghMsg = ghErr instanceof Error ? ghErr.message : String(ghErr);
+        throw new Error(`Failed to fetch HQ template from GitHub.\n\n` +
+            `  GitHub API error: ${apiMsg}\n` +
+            `  gh CLI error:     ${ghMsg}\n\n` +
+            `You appear to be offline or rate-limited.\n` +
+            `To set up HQ manually, clone the repo and copy the template directory:\n\n` +
+            `  git clone https://github.com/indigoai-us/hq.git\n` +
+            `  cp -R hq/template ${targetDir}\n`);
+    }
+}
+//# sourceMappingURL=fetch-template.js.map

package/dist/fetch-template.js.map

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

package/dist/index.js

@@ -1,21 +1,22 @@
 #!/usr/bin/env node
 import { Command } from "commander";
+import { createRequire } from "node:module";
 import { scaffold } from "./scaffold.js";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
 const program = new Command();
 program
     .name("create-hq")
     .description("Create a new HQ — Personal OS for AI Workers")
-    .version("6.0.0")
-    .argument("[directory]", "target directory (default: 'hq' for new install, '.' for --upgrade)")
+    .version(pkg.version)
+    .argument("[directory]", "where to create HQ", "hq")
     .option("--skip-deps", "skip dependency checks")
     .option("--skip-cli", "don't install @indigoai-us/hq-cli globally")
-    .option("--skip-cloud", "don't prompt for cloud setup")
-    .option("--upgrade", "upgrade an existing HQ directory (non-destructive)")
+    .option("--skip-sync", "don't prompt for cloud sync setup")
+    .option("--tag <version>", "fetch a specific HQ version tag (e.g. v9.1.0)")
     .action(async (directory, options) => {
     try {
-        // Default to current directory for --upgrade, 'hq' for fresh install
-        const dir = directory ?? (options.upgrade ? "." : "hq");
-        await scaffold(dir, options);
+        await scaffold(directory, options);
     }
     catch (err) {
         console.error(err instanceof Error ? err.message : "An unexpected error occurred");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,8CAA8C,CAAC;KAC3D,OAAO,CAAC,OAAO,CAAC;KAChB,QAAQ,CAAC,aAAa,EAAE,qEAAqE,CAAC;KAC9F,MAAM,CAAC,aAAa,EAAE,wBAAwB,CAAC;KAC/C,MAAM,CAAC,YAAY,EAAE,4CAA4C,CAAC;KAClE,MAAM,CAAC,cAAc,EAAE,8BAA8B,CAAC;KACtD,MAAM,CAAC,WAAW,EAAE,oDAAoD,CAAC;KACzE,MAAM,CAAC,KAAK,EAAE,SAA6B,EAAE,OAAO,EAAE,EAAE;IACvD,IAAI,CAAC;QACH,qEAAqE;QACrE,MAAM,GAAG,GAAG,SAAS,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CACpE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,8CAA8C,CAAC;KAC3D,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;KACpB,QAAQ,CAAC,aAAa,EAAE,oBAAoB,EAAE,IAAI,CAAC;KACnD,MAAM,CAAC,aAAa,EAAE,wBAAwB,CAAC;KAC/C,MAAM,CAAC,YAAY,EAAE,4CAA4C,CAAC;KAClE,MAAM,CAAC,aAAa,EAAE,mCAAmC,CAAC;KAC1D,MAAM,CAAC,iBAAiB,EAAE,+CAA+C,CAAC;KAC1E,MAAM,CAAC,KAAK,EAAE,SAAiB,EAAE,OAAO,EAAE,EAAE;IAC3C,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CACpE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/scaffold.d.ts

@@ -1,8 +1,8 @@
 interface ScaffoldOptions {
     skipDeps?: boolean;
     skipCli?: boolean;
-    skipCloud?: boolean;
-    upgrade?: boolean;
+    skipSync?: boolean;
+    tag?: string;
 }
 export declare function scaffold(directory: string, options: ScaffoldOptions): Promise<void>;
 export {};

package/dist/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAYA,UAAU,eAAe;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA6HD,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAiPf"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAcA,UAAU,eAAe;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAoBD,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CA6If"}