create-hq 6.0.0 → 7.0.0

package/dist/ui.js.map

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

package/package.json

@@ -1,40 +1,48 @@
-{
-  "name": "create-hq",
-  "version": "6.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": "rm -rf dist",
-    "prepack": "node -e \"require('fs').cpSync('../../template','./template',{recursive:true})\"",
-    "postpack": "node -e \"require('fs').rmSync('./template',{recursive:true,force:true})\""
-  },
-  "dependencies": {
-    "chalk": "^5.3.0",
-    "commander": "^12.1.0",
-    "fs-extra": "^11.2.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"
-}
+{
+  "name": "create-hq",
+  "version": "7.0.0",
+  "description": "Create a new HQ — Personal OS for AI Workers",
+  "bin": {
+    "create-hq": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepack": "tsc",
+    "test": "vitest run"
+  },
+  "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",
+    "@vitest/coverage-v8": "^4.1.2",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.2"
+  },
+  "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

@@ -1,202 +0,0 @@
-# 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

package/template/.claude/commands/checkpoint.md

@@ -1,127 +0,0 @@
----
-description: Save checkpoint and check context status
-allowed-tools: Write, Bash, Read
-argument-hint: [task-id]
-visibility: public
----
-
-# /checkpoint - Save Progress
-
-Save current work state as a thread to survive context loss.
-
-**Task ID (optional):** $ARGUMENTS
-
-## Process
-
-1. **Generate thread ID** if not provided
-   - Format: `T-{YYYYMMDD}-{HHMMSS}-{slug}`
-   - Derive slug from recent work (e.g., `mrr-report`, `email-fix`)
-
-2. **Capture git state**
-   ```bash
-   git rev-parse --abbrev-ref HEAD          # branch
-   git remote get-url origin 2>/dev/null    # remote
-   git rev-parse --short HEAD               # current commit
-   git log --oneline -5                     # recent commits
-   git diff --name-only HEAD~3              # recently touched files
-   git status --porcelain                   # dirty check
-   ```
-
-3. **Capture knowledge repo git states**
-   Knowledge folders are separate git repos (symlinked). For any knowledge path in files_touched, capture its repo state:
-   ```bash
-   # For each knowledge repo with changes:
-   for symlink in knowledge/public/* knowledge/private/* companies/*/knowledge; do
-     [ -L "$symlink" ] || continue
-     repo_dir=$(cd "$symlink" && git rev-parse --show-toplevel 2>/dev/null) || continue
-     dirty=$(cd "$repo_dir" && git status --porcelain)
-     [ -z "$dirty" ] && continue
-     echo "$symlink: $(cd "$repo_dir" && git rev-parse --short HEAD) (dirty)"
-   done
-   ```
-   Include dirty knowledge repos in the thread JSON under `git.knowledge_repos`.
-
-4. **Gather session state**
-   - Summarize what was accomplished
-   - List files touched
-   - Identify next steps
-
-5. **Write thread** to `workspace/threads/{thread_id}.json` (include knowledge_repos from step 3):
-   ```json
-   {
-     "thread_id": "T-20260123-143052-mrr-report",
-     "version": 1,
-     "created_at": "ISO8601",
-     "updated_at": "ISO8601",
-
-     "workspace_root": "~/Documents/HQ",
-     "cwd": "current/working/dir",
-
-     "git": {
-       "branch": "main",
-       "remote_url": "git@github.com:...",
-       "initial_commit": "abc1234",
-       "current_commit": "def5678",
-       "commits_made": ["hash: message"],
-       "dirty": false,
-       "knowledge_repos": {
-         "knowledge-acme": {"commit": "abc1234", "dirty": true},
-         "knowledge-ralph": {"commit": "def5678", "dirty": false}
-       }
-     },
-
-     "worker": {
-       "id": "worker-id or null",
-       "skill": "skill-name or null",
-       "state": "completed"
-     },
-
-     "conversation_summary": "1-2 sentence summary",
-     "files_touched": ["relative/paths"],
-     "next_steps": ["remaining tasks"],
-
-     "metadata": {
-       "title": "Human-readable title",
-       "tags": ["searchable", "tags"]
-     }
-   }
-   ```
-
-6. **Also write legacy checkpoint** to `workspace/checkpoints/{task-id}.json` for backward compat
-
-7. **Update INDEX.md files**
-   - Regenerate `INDEX.md` at HQ root with current:
-     - Workers from `workers/registry.yaml`
-     - Recent threads from `workspace/threads/`
-     - Update timestamp
-   - Regenerate `workspace/threads/INDEX.md` (all threads, full table)
-   - Check files_touched for any `companies/*/knowledge/` paths — if found, regenerate that company's `knowledge/INDEX.md`
-   - See `knowledge/public/hq-core/index-md-spec.md` for INDEX format
-
-8. **Report**
-   ```
-   Thread saved: workspace/threads/{thread_id}.json
-
-   Summary: {summary}
-   Git: {branch} @ {commit} ({dirty ? "dirty" : "clean"})
-   Files: {count} files touched
-   Next: {next_steps or "Work complete"}
-
-   To hand off to fresh session: /handoff
-   ```
-
-## Thread vs Checkpoint
-
-| Feature | Thread (new) | Checkpoint (legacy) |
-|---------|--------------|---------------------|
-| Git context | Full (branch, commits, dirty) | Minimal |
-| Worker state | Captured | Not captured |
-| Location | workspace/threads/ | workspace/checkpoints/ |
-| Format | Rich JSON | Simple JSON |
-
-## Notes
-
-- Threads ensure work survives context clears
-- Run frequently during long sessions
-- If session feels long, suggest `/handoff`
-- Threads are searchable via `/search`