create-hq 5.0.0

package/dist/deps.d.ts

@@ -0,0 +1,4 @@
+export declare function checkDeps(): {
+    allRequired: boolean;
+};
+//# sourceMappingURL=deps.d.ts.map

package/dist/deps.d.ts.map

@@ -0,0 +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"}

package/dist/deps.js

@@ -0,0 +1,65 @@
+import { execSync } from "child_process";
+import { success, warn, info } from "./ui.js";
+const deps = [
+    {
+        name: "Node.js",
+        command: "node --version",
+        required: true,
+        installHint: "https://nodejs.org",
+    },
+    {
+        name: "Claude Code CLI",
+        command: "claude --version",
+        required: true,
+        installHint: "npm install -g @anthropic-ai/claude-code",
+    },
+    {
+        name: "qmd (search)",
+        command: "qmd --version",
+        required: true,
+        installHint: "brew install tobi/tap/qmd",
+    },
+    {
+        name: "gh CLI",
+        command: "gh --version",
+        required: false,
+        installHint: "brew install gh",
+    },
+    {
+        name: "Vercel CLI",
+        command: "vercel --version",
+        required: false,
+        installHint: "npm install -g vercel",
+    },
+];
+function checkCommand(command) {
+    try {
+        const output = execSync(command, { stdio: "pipe", encoding: "utf-8" });
+        const version = output.trim().split("\n")[0];
+        return version;
+    }
+    catch {
+        return null;
+    }
+}
+export function checkDeps() {
+    console.log();
+    console.log("  Checking dependencies...");
+    let allRequired = true;
+    for (const dep of deps) {
+        const version = checkCommand(dep.command);
+        if (version) {
+            success(`${dep.name} ${version}`);
+        }
+        else if (dep.required) {
+            warn(`${dep.name} not found`);
+            info(`Install: ${dep.installHint}`);
+            allRequired = false;
+        }
+        else {
+            info(`${dep.name} (optional) — ${dep.installHint}`);
+        }
+    }
+    return { allRequired };
+}
+//# sourceMappingURL=deps.js.map

package/dist/deps.js.map

@@ -0,0 +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"}

package/dist/git.d.ts

@@ -0,0 +1,3 @@
+export declare function initGit(dir: string): void;
+export declare function hasGit(): boolean;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAEA,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAOzC;AAED,wBAAgB,MAAM,IAAI,OAAO,CAOhC"}

package/dist/git.js

@@ -0,0 +1,19 @@
+import { execSync } from "child_process";
+export function initGit(dir) {
+    execSync("git init", { cwd: dir, stdio: "pipe" });
+    execSync("git add -A", { cwd: dir, stdio: "pipe" });
+    execSync('git commit -m "Initial HQ setup via create-hq"', {
+        cwd: dir,
+        stdio: "pipe",
+    });
+}
+export function hasGit() {
+    try {
+        execSync("git --version", { stdio: "pipe" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,QAAQ,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,QAAQ,CAAC,gDAAgD,EAAE;QACzD,GAAG,EAAE,GAAG;QACR,KAAK,EAAE,MAAM;KACd,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,IAAI,CAAC;QACH,QAAQ,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { scaffold } from "./scaffold.js";
+const program = new Command();
+program
+    .name("create-hq")
+    .description("Create a new HQ — Personal OS for AI Workers")
+    .version("5.0.0")
+    .argument("[directory]", "where to create HQ", "hq")
+    .option("--skip-deps", "skip dependency checks")
+    .option("--skip-cli", "don't install @indigoai/hq-cli globally")
+    .option("--skip-sync", "don't prompt for cloud sync setup")
+    .action(async (directory, options) => {
+    try {
+        await scaffold(directory, options);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : "An unexpected error occurred");
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,oBAAoB,EAAE,IAAI,CAAC;KACnD,MAAM,CAAC,aAAa,EAAE,wBAAwB,CAAC;KAC/C,MAAM,CAAC,YAAY,EAAE,yCAAyC,CAAC;KAC/D,MAAM,CAAC,aAAa,EAAE,mCAAmC,CAAC;KAC1D,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

@@ -0,0 +1,8 @@
+interface ScaffoldOptions {
+    skipDeps?: boolean;
+    skipCli?: boolean;
+    skipSync?: boolean;
+}
+export declare function scaffold(directory: string, options: ScaffoldOptions): Promise<void>;
+export {};
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +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,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAyCD,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAoGf"}

package/dist/scaffold.js

@@ -0,0 +1,130 @@
+import * as path from "path";
+import fs from "fs-extra";
+import { createInterface } from "readline";
+import { banner, success, warn, step, nextSteps } from "./ui.js";
+import { checkDeps } from "./deps.js";
+import { initGit, hasGit } from "./git.js";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+async function prompt(question, defaultVal) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const suffix = defaultVal ? ` (${defaultVal})` : "";
+    return new Promise((resolve) => {
+        rl.question(`  ? ${question}${suffix} `, (answer) => {
+            rl.close();
+            resolve(answer.trim() || defaultVal || "");
+        });
+    });
+}
+async function confirm(question, defaultYes = true) {
+    const hint = defaultYes ? "Y/n" : "y/N";
+    const answer = await prompt(`${question} (${hint})`);
+    if (!answer)
+        return defaultYes;
+    return answer.toLowerCase().startsWith("y");
+}
+function getTemplateDir() {
+    // When installed from npm: dist/scaffold.js -> ../template
+    // In monorepo dev from dist: packages/create-hq/dist/scaffold.js -> ../../template
+    // In monorepo dev from src: packages/create-hq/src/scaffold.ts -> ../../template
+    const candidates = [
+        path.resolve(__dirname, "..", "template"), // npm installed (dist/../template)
+        path.resolve(__dirname, "..", "..", "template"), // monorepo (packages/create-hq/template or ../../template)
+        path.resolve(__dirname, "..", "..", "..", "template"), // monorepo from dist (../../template)
+    ];
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate) && fs.existsSync(path.join(candidate, ".claude"))) {
+            return candidate;
+        }
+    }
+    throw new Error("Could not find HQ template directory. This is a packaging error — please report at https://github.com/indigoai-us/hq/issues");
+}
+export async function scaffold(directory, options) {
+    banner();
+    // 1. Resolve target directory
+    const targetDir = path.resolve(directory);
+    const displayDir = directory.startsWith("/")
+        ? directory
+        : path.relative(process.cwd(), targetDir) || ".";
+    // Check if directory already exists
+    if (fs.existsSync(targetDir)) {
+        const contents = fs.readdirSync(targetDir);
+        if (contents.length > 0) {
+            const proceed = await confirm(`Directory ${displayDir} already exists and is not empty. Continue anyway?`, false);
+            if (!proceed) {
+                console.log("  Aborted.");
+                process.exit(0);
+            }
+        }
+    }
+    // 2. Copy template
+    step("Creating HQ...");
+    const templateDir = getTemplateDir();
+    await fs.copy(templateDir, targetDir, {
+        filter: (src) => {
+            const rel = path.relative(templateDir, src);
+            // Skip git internals and node_modules
+            if (rel.includes(".git/") || rel.includes("node_modules/"))
+                return false;
+            return true;
+        },
+    });
+    // Count what we copied
+    const commandCount = fs.existsSync(path.join(targetDir, ".claude", "commands"))
+        ? fs.readdirSync(path.join(targetDir, ".claude", "commands")).filter((f) => f.endsWith(".md")).length
+        : 0;
+    const workerCount = fs.existsSync(path.join(targetDir, "workers"))
+        ? fs.readdirSync(path.join(targetDir, "workers"), { recursive: true })
+            .filter((f) => String(f).endsWith("worker.yaml")).length
+        : 0;
+    success(`Copied template (${commandCount} commands, ${workerCount} workers)`);
+    // 3. Git init
+    if (hasGit()) {
+        initGit(targetDir);
+        success("Initialized git repository");
+    }
+    else {
+        warn("git not found — skipping git init");
+    }
+    // 4. Check dependencies
+    if (!options.skipDeps) {
+        checkDeps();
+    }
+    // 5. Install hq-cli
+    if (!options.skipCli) {
+        console.log();
+        const installCli = await confirm("Install @indigoai/hq-cli globally for module management?");
+        if (installCli) {
+            try {
+                step("Installing @indigoai/hq-cli...");
+                execSync("npm install -g @indigoai/hq-cli", { stdio: "pipe" });
+                success("Installed @indigoai/hq-cli");
+            }
+            catch {
+                warn("Failed to install @indigoai/hq-cli — you can install it later with: npm install -g @indigoai/hq-cli");
+            }
+        }
+    }
+    // 6. Cloud sync setup
+    if (!options.skipSync) {
+        console.log();
+        const setupSync = await confirm("Set up cloud sync? (enables mobile access via hq.indigoai.com)");
+        if (setupSync) {
+            step("Cloud sync setup will be available after running /setup in Claude Code");
+            step("Run: hq sync init");
+        }
+    }
+    // 7. Index with qmd
+    try {
+        execSync("qmd index .", { cwd: targetDir, stdio: "pipe" });
+        success("Indexed HQ for search");
+    }
+    catch {
+        // qmd not installed, skip silently — already warned in deps check
+    }
+    // 8. Next steps
+    nextSteps(displayDir);
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

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

package/dist/ui.d.ts

@@ -0,0 +1,7 @@
+export declare function banner(): void;
+export declare function success(msg: string): void;
+export declare function warn(msg: string): void;
+export declare function info(msg: string): void;
+export declare function step(msg: string): void;
+export declare function nextSteps(dir: string): void;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,IAAI,IAAI,CAa7B;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtC;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtC;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtC;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAW3C"}

package/dist/ui.js

@@ -0,0 +1,36 @@
+import chalk from "chalk";
+export function banner() {
+    console.log();
+    console.log(chalk.bold.white("  ██   ██  ██████  "));
+    console.log(chalk.bold.white("  ██   ██ ██    ██ "));
+    console.log(chalk.bold.white("  ███████ ██    ██ "));
+    console.log(chalk.bold.white("  ██   ██ ██ ▄▄ ██ "));
+    console.log(chalk.bold.white("  ██   ██  ██████  "));
+    console.log(chalk.dim("              ▀▀   "));
+    console.log();
+    console.log(chalk.dim("  Personal OS for AI Workers") + chalk.dim("  v5.0.0"));
+    console.log();
+}
+export function success(msg) {
+    console.log(chalk.green("  ✓") + " " + msg);
+}
+export function warn(msg) {
+    console.log(chalk.yellow("  ✗") + " " + msg);
+}
+export function info(msg) {
+    console.log(chalk.dim("  ~") + " " + msg);
+}
+export function step(msg) {
+    console.log(chalk.cyan("  →") + " " + msg);
+}
+export function nextSteps(dir) {
+    console.log();
+    console.log(chalk.bold("  All done! Next steps:"));
+    console.log();
+    console.log(chalk.white(`    cd ${dir}`));
+    console.log(chalk.white("    claude"));
+    console.log(chalk.white("    /setup") +
+        chalk.dim("          ← interactive wizard to personalize your HQ"));
+    console.log();
+}
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,MAAM;IACpB,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CAAC,8BAA8B,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAClE,CAAC;IACF,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC;QACvB,KAAK,CAAC,GAAG,CAAC,uDAAuD,CAAC,CACrE,CAAC;IACF,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "create-hq",
+  "version": "5.0.0",
+  "description": "Create a new HQ — Personal OS for AI Workers",
+  "bin": {
+    "create-hq": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "node -e \"const fs=require('fs-extra');fs.removeSync('dist');fs.removeSync('template')\"",
+    "prepack": "npm run build && node -e \"require('fs-extra').copySync('../../template','./template')\"",
+    "postpack": "node -e \"require('fs-extra').removeSync('template')\""
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "ora": "^8.1.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/indigoai-us/hq.git",
+    "directory": "packages/create-hq"
+  },
+  "keywords": ["hq", "ai", "workers", "claude", "personal-os"],
+  "license": "MIT",
+  "type": "module"
+}

package/template/.claude/CLAUDE.md

@@ -0,0 +1,202 @@
+# HQ - Personal OS for AI Workers
+
+Personal OS for orchestrating work across companies, workers, and AI.
+
+## Key Files
+
+- `INDEX.md` - Root directory map, recent threads, workers (start here)
+- `USER-GUIDE.md` - Commands, workers, typical session
+- `agents.md` - Your profile, preferences, companies (load for writing/communication tasks)
+- `workers/registry.yaml` - Worker index
+
+## INDEX.md System
+
+Hierarchical INDEX.md files provide a navigable map of HQ. Read parent INDEX before diving into subdirectories.
+
+**Key indexes:** `projects/INDEX.md`, `workspace/orchestrator/INDEX.md`, `companies/*/knowledge/INDEX.md`, `workers/*/INDEX.md`, `knowledge/INDEX.md`, `workspace/reports/INDEX.md`
+
+**Spec:** `knowledge/hq-core/index-md-spec.md`
+**Rebuild all:** `/cleanup --reindex`
+**Auto-updated by:** `/checkpoint`, `/handoff`, `/reanchor`, `/prd`, `/run-project`, `/newworker`, content commands
+
+## Structure
+
+```
+HQ/
+├── .claude/commands/   # Slash commands (17, visibility: public|private in frontmatter)
+├── agents.md           # Your profile
+├── companies/          # Company-scoped resources (optional)
+│   └── {company}/      # settings/, data/, knowledge/
+├── knowledge/          # HQ-level (Ralph, workers, security, projects)
+├── projects/           # Project PRDs
+├── workers/            # Worker definitions
+│   ├── dev-team/       # 12 code workers
+│   └── content-*/      # 5 content workers
+├── social-content/     # Content drafts
+│   └── drafts/         # x/, linkedin/
+└── workspace/
+    ├── checkpoints/    # Manual saves
+    ├── threads/        # Auto-saved sessions
+    ├── orchestrator/   # Project state
+    ├── learnings/      # Task insights (event log)
+    └── content-ideas/  # Idea capture
+```
+
+## Workers
+
+Workers are autonomous agents with defined skills. They *do things*.
+
+| Type | Purpose | Examples |
+|------|---------|----------|
+| CodeWorker | Implement features, fix bugs | dev-team/* |
+| ContentWorker | Draft content, maintain voice | content-brand, content-sales |
+| SocialWorker | Post to platforms | x-worker |
+| ResearchWorker | Analysis, market research | analyst |
+| OpsWorker | Reports, automation | cfo-worker |
+
+**Run a worker:** `/run {worker} {skill}`
+
+**Build a worker:** `/newworker`
+
+## Commands
+
+### Session Management
+| Command | Purpose |
+|---------|---------|
+| `/checkpoint` | Save state + context status |
+| `/handoff` | Prepare for fresh session |
+| `/reanchor` | Pause and realign |
+| `/nexttask` | Find next thing to work on |
+| `/remember` | Capture learnings as rules in relevant files |
+| `/learn` | Auto-capture and classify learnings from task execution |
+
+### Projects
+| Command | Purpose |
+|---------|---------|
+| `/prd` | Generate PRD through discovery |
+| `/run-project` | Execute project via Ralph loop |
+| `/execute-task` | Run single task with workers |
+
+### Workers
+| Command | Purpose |
+|---------|---------|
+| `/run` | List/execute workers |
+| `/newworker` | Create new worker |
+| `/metrics` | View execution metrics |
+
+### System
+| Command | Purpose |
+|---------|---------|
+| `/search` | Semantic + full-text search across HQ (qmd-powered) |
+| `/search-reindex` | Reindex and re-embed HQ for qmd search |
+| `/cleanup` | Audit and clean HQ |
+| `/setup` | Interactive setup wizard |
+| `/exit-plan` | Force exit from plan mode |
+
+## Knowledge Repos
+
+Knowledge folders can be their own git repos, symlinked into HQ. This enables independent versioning, sharing, and publishing per knowledge base.
+
+**Convention:** Repos live in `repos/public/` or `repos/private/`. Symlinks in `knowledge/` and `companies/*/knowledge` point to them. The symlinks are tracked by HQ git; the repo contents are gitignored.
+
+**Reading/searching:** Transparent. `qmd`, `Glob`, `Grep`, `Read` all follow symlinks.
+
+**Committing knowledge changes:** Changes show in `git status` of the *target repo* (not HQ). To commit:
+1. `cd` to the symlink target (e.g. `repos/public/knowledge-ralph/`)
+2. `git add`, `git commit`, `git push` in that repo
+
+**Adding new knowledge:** Create repo in `repos/{public|private}/knowledge-{name}`, symlink into the appropriate knowledge path.
+
+## Search (qmd)
+
+HQ can be indexed with [qmd](https://github.com/tobi/qmd) for local semantic + full-text search.
+
+**When to search:** Before any planning, research, or context-gathering task, search HQ first with `qmd` to find relevant knowledge, workers, skills, and prior work.
+
+**Commands (run via Bash tool):**
+- `qmd search "<query>" --json -n 10` — BM25 keyword search (fast, default)
+- `qmd vsearch "<query>" --json -n 10` — semantic/conceptual search
+- `qmd query "<query>" --json -n 10` — hybrid BM25 + vector + re-ranking (best quality, slower)
+
+**Slash commands:** `/search <query>`, `/search-reindex`
+
+### Search rules (all commands/skills must follow)
+
+| Need | Tool | Example |
+|------|------|---------|
+| Find HQ content by topic | `qmd search` or `qmd vsearch` | "Find knowledge about API integration" |
+| Find files by path pattern | `Glob` | `workers/*/worker.yaml`, `projects/*/prd.json` |
+| Search code in `repos/` | `Grep` | Pattern matching in source code |
+| Validate structured files | `grep` in Bash | Checking YAML fields, git branch filtering |
+
+**Never use Grep/Glob to search HQ content by topic.** That's what qmd does. Commands and skills that scan HQ for related context must use `qmd vsearch` (semantic) or `qmd search` (keyword), not Grep.
+
+## Learned Rules
+
+<!-- Max 20. Overflow removed (rule still lives in its source file). -->
+<!-- Auto-managed by /learn. Manual: /remember -->
+
+(none yet — rules accumulate as the system runs)
+
+## Learning System
+
+Learnings are rules injected directly into the files they govern:
+- Worker rules → `worker.yaml` `instructions:` block
+- Command rules → command `.md` `## Rules` section
+- Knowledge rules → relevant knowledge file
+- Global rules → this file `## Learned Rules`
+
+- `/learn` captures and classifies learnings automatically after task execution
+- `/remember` delegates to `/learn` — user corrections always promote to Tier 1
+
+Event log: `workspace/learnings/*.json` (append-only, for analysis/dedup).
+
+## Auto-Learn (Build Activities)
+
+When building HQ infrastructure (new workers, knowledge bases, commands, projects), auto-capture structural changes so future sessions know what exists:
+
+**Triggers:**
+- `/newworker` completes → `/learn` with scope: global, rule: "Worker {id} exists at {path} for {purpose}"
+- `/prd` completes → `/learn` with scope: global, rule: "Project {name} exists with {N} stories targeting {repo}"
+- New knowledge files created → `/learn` with scope: global, rule: "Knowledge {topic} available at {path}"
+- New command created → `/learn` with scope: global, rule: "Command /{name} available for {purpose}"
+
+**Why:** Fresh sessions load CLAUDE.md but don't scan every directory. Learned rules act as an index of what has been built, preventing re-creation of existing resources and enabling discovery.
+
+**Also:** After any structural change, run `qmd update 2>/dev/null || true` to keep search current.
+
+## Auto-Checkpoint (PostToolsHook)
+
+After completing any of these actions, automatically save thread state to `workspace/threads/`:
+
+**Triggers:**
+- Worker skill completion (via `/run`)
+- Git commit
+- File generation (reports, social drafts)
+- Significant file edits in project repos
+
+**Thread Format:** See `knowledge/hq-core/thread-schema.md`
+
+**Why:** Prevents lost work, enables session resumption, provides audit trail.
+
+**How:** After a triggering action, capture git state + summary and write to `workspace/threads/T-{timestamp}-{slug}.json`
+
+**Knowledge repos:** When edits touch knowledge files (symlinked to `repos/`), commit those changes to the knowledge repo — not HQ git. See "Knowledge Repos" section above for commit instructions.
+
+## Auto-Handoff (Context Limit)
+
+When context usage reaches 70% (remaining drops to 30%), automatically run `/handoff`.
+
+**Rules:**
+- Check context status line — when `remaining_percentage` ≤ 30, trigger handoff
+- Before handoff, finish current atomic task (don't interrupt mid-edit)
+- Notify user: "Context at {X}% remaining. Running /handoff to preserve continuity."
+- Run `/handoff` with summary of remaining work
+- This overrides manual handoff — don't wait for user to request it
+
+## Core Principles
+
+1. **Infrastructure scales, effort doesn't** - Build reusable systems
+2. **Workers should grow smarter** - Capture learnings in knowledge bases
+3. **Context is precious** - Checkpoint often, don't let work evaporate
+4. **Ship, then iterate** - Working > perfect