@automagik/genie 4.260407.5 → 4.260407.7

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "genie",
-      "version": "4.260407.5",
+      "version": "4.260407.7",
       "source": "./plugins/genie",
       "description": "Human-AI partnership for Claude Code. Share a terminal, orchestrate workers, evolve together. Brainstorm ideas, wish them into plans, make with parallel agents, ship as one team. A coding genie that grows with your project."
     }

package/.genie/agents/metrics-updater/tools/parse-metrics.py

@@ -69,12 +69,20 @@ def calc_ship_rate(prs_json: list, days: int = 7) -> float:
     return round((shipped_first / total) * 100, 0)
 
 
-def calc_loc_changed(repo_root: str) -> int:
-    """Calculate total lines changed (additions + deletions) in last 24 hours."""
+def calc_loc_changed(repo_root: str, branches: list[str] | None = None, hours: int = 24) -> int:
+    """Calculate total lines changed (additions + deletions) in last N hours.
+
+    When branches is provided, counts changes across all listed branches
+    (e.g. ['main', 'dev']) to capture work that hasn't been promoted yet.
+    """
     try:
+        cmd = ['git', 'log', f'--since={hours} hours ago', '--stat', '--format=']
+        if branches:
+            cmd.extend(branches)
+        else:
+            cmd.append('--all')
         result = subprocess.run(
-            ['git', 'log', '--since=24 hours ago', '--stat', '--format='],
-            capture_output=True, text=True, cwd=repo_root
+            cmd, capture_output=True, text=True, cwd=repo_root
         )
         total = 0
         for line in result.stdout.splitlines():
@@ -91,12 +99,20 @@ def calc_loc_changed(repo_root: str) -> int:
         return 0
 
 
-def calc_commits_24h(repo_root: str) -> int:
-    """Count commits in the last 24 hours."""
+def calc_commits_24h(repo_root: str, branches: list[str] | None = None, hours: int = 24) -> int:
+    """Count commits in the last N hours.
+
+    When branches is provided, counts across all listed branches
+    (e.g. ['main', 'dev']) to capture work not yet promoted to main.
+    """
     try:
+        cmd = ['git', 'log', f'--since={hours} hours ago', '--oneline']
+        if branches:
+            cmd.extend(branches)
+        else:
+            cmd.append('--all')
         result = subprocess.run(
-            ['git', 'log', '--since=24 hours ago', '--oneline'],
-            capture_output=True, text=True, cwd=repo_root
+            cmd, capture_output=True, text=True, cwd=repo_root
         )
         lines = [l for l in result.stdout.strip().splitlines() if l.strip()]
         return len(lines)
@@ -104,32 +120,98 @@ def calc_commits_24h(repo_root: str) -> int:
         return 0
 
 
-def calc_prs_24h(owner: str, repo: str) -> int:
-    """Count PRs created in the last 24 hours using gh API."""
+def calc_files_changed(repo_root: str, hours: int = 24, branches: list[str] | None = None) -> int:
+    """Count files changed in the last N hours."""
+    try:
+        cmd = ['git', 'log', f'--since={hours} hours ago', '--stat', '--format=']
+        if branches:
+            cmd.extend(branches)
+        else:
+            cmd.append('--all')
+        result = subprocess.run(
+            cmd, capture_output=True, text=True, cwd=repo_root
+        )
+        total = 0
+        for line in result.stdout.splitlines():
+            if 'file' in line and 'changed' in line:
+                total += int(line.strip().split()[0])
+        return total
+    except Exception:
+        return 0
+
+
+def calc_npm_releases(package: str, hours: int = 24) -> int:
+    """Count npm releases in the last N hours."""
     try:
-        since = (datetime.now(timezone.utc) - timedelta(hours=24)).strftime('%Y-%m-%dT%H:%M:%SZ')
         result = subprocess.run(
-            ['gh', 'api', f'search/issues?q=repo:{owner}/{repo}+type:pr+created:>={since}',
-             '--jq', '.total_count'],
+            ['npm', 'view', package, 'time', '--json'],
             capture_output=True, text=True
         )
-        return int(result.stdout.strip()) if result.stdout.strip() else 0
+        if not result.stdout.strip():
+            return 0
+        data = json.loads(result.stdout)
+        cutoff = datetime.now(timezone.utc) - timedelta(hours=hours)
+        count = 0
+        for ver, ts in data.items():
+            if ver in ('created', 'modified'):
+                continue
+            dt = datetime.fromisoformat(ts.replace('Z', '+00:00'))
+            if dt >= cutoff:
+                count += 1
+        return count
     except Exception:
         return 0
 
 
-def format_metrics(releases_per_day: int, avg_merge_hours: float,
-                   ship_rate: float, parallel_agents: int,
-                   loc_changed_24h: int = 0, commits_24h: int = 0,
-                   prs_24h: int = 0) -> dict:
+def calc_merged_prs(prs_json: list, hours: int = 24) -> int:
+    """Count merged PRs within the last N hours."""
+    cutoff = datetime.now(timezone.utc) - timedelta(hours=hours)
+    count = 0
+    for pr in prs_json:
+        if not pr.get('merged_at'):
+            continue
+        merged = datetime.fromisoformat(pr['merged_at'].replace('Z', '+00:00'))
+        if merged >= cutoff:
+            count += 1
+    return count
+
+
+def calc_avg_merge_time_window(prs_json: list, hours: int = 24) -> float:
+    """Calculate average merge time in hours for PRs merged in the last N hours."""
+    cutoff = datetime.now(timezone.utc) - timedelta(hours=hours)
+    durations = []
+    for pr in prs_json:
+        if not pr.get('merged_at'):
+            continue
+        merged = datetime.fromisoformat(pr['merged_at'].replace('Z', '+00:00'))
+        if merged < cutoff:
+            continue
+        created = datetime.fromisoformat(pr['created_at'].replace('Z', '+00:00'))
+        durations.append((merged - created).total_seconds() / 3600)
+    if not durations:
+        return 0.0
+    return round(sum(durations) / len(durations), 1)
+
+
+def format_metrics(*, commits_7d: int = 0, loc_7d: int = 0, files_7d: int = 0,
+                   prs_7d: int = 0, releases_7d: int = 0, avg_merge_7d: float = 0,
+                   commits_24h: int = 0, loc_24h: int = 0, files_24h: int = 0,
+                   prs_24h: int = 0, releases_24h: int = 0, avg_merge_24h: float = 0,
+                   parallel_agents: int = 0) -> dict:
     """Format metrics into the standard output structure."""
     return {
-        'releases_per_day': releases_per_day,
-        'avg_bugfix_time_hours': avg_merge_hours,
-        'ship_rate_pct': ship_rate,
-        'loc_changed_24h': loc_changed_24h,
+        'commits_7d': commits_7d,
+        'loc_changed_7d': loc_7d,
+        'files_changed_7d': files_7d,
+        'prs_7d': prs_7d,
+        'releases_7d': releases_7d,
+        'avg_merge_time_7d': avg_merge_7d,
         'commits_24h': commits_24h,
+        'loc_changed_24h': loc_24h,
+        'files_changed_24h': files_24h,
         'prs_24h': prs_24h,
+        'releases_24h': releases_24h,
+        'avg_merge_time_24h': avg_merge_24h,
         'parallel_agents': parallel_agents,
         'updated': datetime.now(timezone.utc).strftime('%Y-%m-%dT%H:%M:%SZ'),
     }
@@ -142,6 +224,8 @@ def main():
     parser.add_argument('--parallel-agents', type=int, default=0,
                         help='Number of parallel agents active')
     parser.add_argument('--repo-root', default='.', help='Path to repo root for git log commands')
+    parser.add_argument('--branches', nargs='+', default=['main', 'dev'],
+                        help='Branches to include in git metrics (default: main dev)')
     parser.add_argument('--owner', default='automagik-dev', help='GitHub owner')
     parser.add_argument('--repo', default='genie', help='GitHub repo name')
     parser.add_argument('--from-state', help='Fallback: read last_metrics from state.json')
@@ -166,21 +250,24 @@ def main():
         with open(args.prs_json) as f:
             prs = json.load(f)
 
-        releases_count = parse_releases_count(releases)
-        avg_merge = calc_avg_merge_time_hours(prs)
-        ship_rate = calc_ship_rate(prs)
-        loc_changed = calc_loc_changed(args.repo_root)
-        commits = calc_commits_24h(args.repo_root)
-        prs_count = calc_prs_24h(args.owner, args.repo)
+        pkg = f'@{args.owner}/{args.repo}'
 
         metrics = format_metrics(
-            releases_per_day=releases_count,
-            avg_merge_hours=avg_merge,
-            ship_rate=ship_rate,
+            # 7-day metrics
+            commits_7d=calc_commits_24h(args.repo_root, args.branches, hours=168),
+            loc_7d=calc_loc_changed(args.repo_root, args.branches, hours=168),
+            files_7d=calc_files_changed(args.repo_root, hours=168, branches=args.branches),
+            prs_7d=calc_merged_prs(prs, hours=168),
+            releases_7d=calc_npm_releases(pkg, hours=168),
+            avg_merge_7d=calc_avg_merge_time_window(prs, hours=168),
+            # 24h metrics
+            commits_24h=calc_commits_24h(args.repo_root, args.branches),
+            loc_24h=calc_loc_changed(args.repo_root, args.branches),
+            files_24h=calc_files_changed(args.repo_root, branches=args.branches),
+            prs_24h=calc_merged_prs(prs),
+            releases_24h=calc_npm_releases(pkg),
+            avg_merge_24h=calc_avg_merge_time_window(prs),
             parallel_agents=args.parallel_agents,
-            loc_changed_24h=loc_changed,
-            commits_24h=commits,
-            prs_24h=prs_count,
         )
 
     output = json.dumps(metrics, indent=2)

package/.genie/agents/metrics-updater/tools/update-readme.py

@@ -23,27 +23,41 @@ END_MARKER = '<!-- METRICS:END \u2014 \U0001f9de automagik/genie -->'
 def build_metrics_table(metrics: dict) -> str:
     """Build the markdown metrics table with signature markers."""
     timestamp = metrics.get('updated', datetime.now(timezone.utc).strftime('%Y-%m-%dT%H:%M:%SZ'))
-    releases = metrics.get('releases_per_day', 0)
-    avg_time = metrics.get('avg_bugfix_time_hours', 0)
-    ship_rate = metrics.get('ship_rate_pct', 0)
-    loc_changed = metrics.get('loc_changed_24h', 0)
-    commits = metrics.get('commits_24h', 0)
-    prs = metrics.get('prs_24h', 0)
-    agents = metrics.get('parallel_agents', 0)
+    date_str = timestamp[:10] if 'T' in timestamp else timestamp
+
+    # 7-day metrics
+    commits_7d = metrics.get('commits_7d', 0)
+    loc_7d = metrics.get('loc_changed_7d', 0)
+    files_7d = metrics.get('files_changed_7d', 0)
+    prs_7d = metrics.get('prs_7d', 0)
+    releases_7d = metrics.get('releases_7d', 0)
+    avg_merge_7d = metrics.get('avg_merge_time_7d', 0)
+
+    # 24h metrics
+    commits_24h = metrics.get('commits_24h', 0)
+    loc_24h = metrics.get('loc_changed_24h', 0)
+    files_24h = metrics.get('files_changed_24h', 0)
+    prs_24h = metrics.get('prs_24h', 0)
+    releases_24h = metrics.get('releases_24h', metrics.get('releases_per_day', 0))
+    avg_merge_24h = metrics.get('avg_merge_time_24h', metrics.get('avg_bugfix_time_hours', 0))
 
     start_marker = f'<!-- METRICS:START \u2014 Updated by Genie Metrics Agent at {timestamp} -->'
 
     lines = [
         start_marker,
-        '| Metric | Value |',
-        '|--------|-------|',
-        f'| Releases/day | {releases} |',
-        f'| Avg bug-fix time | {avg_time}h |',
-        f'| SHIP rate | {ship_rate}% |',
-        f'| Lines changed (24h) | {loc_changed:,} |',
-        f'| Commits (24h) | {commits} |',
-        f'| Pull requests (24h) | {prs} |',
-        f'| Parallel agents | {agents} |',
+        '<p align="center">',
+        '',
+        '| Metric | 7 days | 24h |',
+        '|--------|--------|-----|',
+        f'| Commits | {commits_7d:,} | {commits_24h} |',
+        f'| Lines changed | {loc_7d:,} | {loc_24h:,} |',
+        f'| Files touched | {files_7d:,} | {files_24h} |',
+        f'| Merged PRs | {prs_7d} | {prs_24h} |',
+        f'| npm releases | {releases_7d} | {releases_24h} |',
+        f'| Avg merge time | {avg_merge_7d}h | {avg_merge_24h}h |',
+        '',
+        f'*Last updated: {date_str}*',
+        '</p>',
         END_MARKER,
     ]
     return '\n'.join(lines)

package/README.md

@@ -27,14 +27,16 @@
 <!-- METRICS:START -->
 <p align="center">
 
-| Metric | Value |
-|--------|-------|
-| Releases (24h) | 2 |
-| Merged PRs (7d) | 35 |
-| Avg merge time | 0.3h |
-| SHIP rate | 85% |
-
-*Last updated: 2026-04-06*
+| Metric | 7 days | 24h |
+|--------|--------|-----|
+| Commits | 445 | 38 |
+| Lines changed | 57,462 | 3,917 |
+| Files touched | 1,062 | 80 |
+| Merged PRs | 87 | 10 |
+| npm releases | 68 | 7 |
+| Avg merge time | 3.3h | 5.4h |
+
+*Last updated: 2026-04-07*
 </p>
 <!-- METRICS:END -->
 

package/dist/genie.js

@@ -3023,9 +3023,9 @@ Board: ${board.name} (${board.id})`),board.description)console.log(`Description:
 Columns:`);for(let i2=0;i2<sorted.length;i2++){let c=sorted[i2],count=countByColumn.get(c.name)??countByColumn.get(c.id)??0,gate=` [gate: ${c.gate}]`,action=c.action?` (action: ${c.action})`:"";console.log(`  ${i2+1}. ${c.label??c.name}${gate}${action} \u2014 ${count} task${count===1?"":"s"}`)}console.log("")}function buildColumnUpdates(options){let updates={};if(options.gate)updates.gate=options.gate;if(options.action)updates.action=options.action;if(options.color)updates.color=options.color;if(options.rename)updates.name=options.rename,updates.label=options.rename;return updates}async function handleBoardEdit(name,options){let bs=await getBoardService(),board=await resolveBoard(name,options.project);if(options.column){let col=board.columns.find((c)=>c.name===options.column||c.label===options.column);if(!col)throw Error(`Column not found: ${options.column}`);let updates=buildColumnUpdates(options);if(!await bs.updateColumn(board.id,col.id,updates))throw Error(`Failed to update column: ${options.column}`);console.log(`Updated column "${options.column}" on board "${board.name}".`);return}let boardUpdates={};if(options.name)boardUpdates.name=options.name;if(options.description)boardUpdates.description=options.description;if(Object.keys(boardUpdates).length===0)console.error("Error: No updates specified. Use --column, --name, or --description."),process.exit(1);let updated=await bs.updateBoard(board.id,boardUpdates);if(!updated)throw Error(`Failed to update board: ${name}`);console.log(`Updated board "${updated.name}" (${updated.id}).`)}async function handleBoardDelete(name,options){let bs=await getBoardService(),board=await resolveBoard(name,options.project);if(!options.force)console.log(`Deleting board "${board.name}" (${board.id})...`);if(!await bs.deleteBoard(board.id))throw Error(`Failed to delete board: ${name}`);console.log(`Deleted board "${board.name}" (${board.id}).`)}async function handleBoardColumns(name,options){let board=await resolveBoard(name,options.project);if(options.json){console.log(JSON.stringify(board.columns,null,2));return}printColumnPipeline(board.columns,`Board: ${board.name} (${board.columns.length} columns)`)}async function handleBoardUse(name,options){let board=await resolveBoard(name,options.project),repoRoot=execSync10("git rev-parse --show-toplevel",{encoding:"utf-8"}).trim(),genieDir=join37(repoRoot,".genie"),configPath2=join37(genieDir,"config.json");if(!existsSync28(genieDir))mkdirSync12(genieDir,{recursive:!0});let config={};if(existsSync28(configPath2))try{config=JSON.parse(readFileSync17(configPath2,"utf-8"))}catch{}config.activeBoard=board.id,writeFileSync15(configPath2,`${JSON.stringify(config,null,2)}
 `),console.log(`Active board set to "${board.name}" (${board.id})`)}async function handleBoardExport(name,options){let bs=await getBoardService(),board=await resolveBoard(name,options.project),exported=await bs.exportBoard(board.id),json2=JSON.stringify(exported,null,2);if(options.output){let dir=dirname6(options.output);if(!existsSync28(dir))mkdirSync12(dir,{recursive:!0});writeFileSync15(options.output,`${json2}
 `),console.log(`Exported board "${board.name}" to ${options.output}`)}else console.log(json2)}async function handleBoardReconcile(name,options){let{reconcileBoard:reconcileBoard2}=await Promise.resolve().then(() => (init_board_service(),exports_board_service)),board=await resolveBoard(name,options.project),result2=await reconcileBoard2(board.id);if(options.json){console.log(JSON.stringify(result2,null,2));return}if(result2.fixed===0&&result2.orphaned===0){console.log(`Board "${board.name}": all tasks have valid column_ids.`);return}if(console.log(`Board "${board.name}" reconciliation:`),console.log(`  Fixed: ${result2.fixed} task${result2.fixed===1?"":"s"}`),result2.orphaned>0){let count=result2.orphaned;console.log(`  Still orphaned: ${count} task${count===1?"":"s"} (stage doesn't match any column)`)}}async function handleBoardImport(options){let bs=await getBoardService(),projectId=await resolveProjectId(options.project),raw=readFileSync17(options.json,"utf-8"),data=JSON.parse(raw),board=await bs.importBoard(data,projectId);console.log(`Imported board "${board.name}" (${board.id}) with ${board.columns.length} columns`)}async function handleTemplateList(options){let templates=await(await getTemplateService()).listTemplates();if(options.json){console.log(JSON.stringify(templates,null,2));return}printTemplateTable(templates)}async function handleTemplateShow(name,options){let template=await(await getTemplateService()).getTemplate(name);if(!template)throw Error(`Template not found: ${name}`);if(options.json){console.log(JSON.stringify(template,null,2));return}if(console.log(`
-Template: ${template.name} (${template.id})`),template.description)console.log(`Description: ${template.description}`);if(template.icon)console.log(`Icon: ${template.icon}`);console.log(`Built-in: ${template.isBuiltin?"yes":"no"}`),printColumnPipeline(template.columns,`Pipeline (${template.columns.length} columns)`)}async function handleTemplateCreate(name,options){let tmpl=await getTemplateService();if(options.fromBoard){let board=await(await getBoardService()).getBoard(options.fromBoard);if(!board)throw Error(`Board not found: ${options.fromBoard}`);let template2=await tmpl.snapshotFromBoard(board.id,name);console.log(`Created template "${template2.name}" (${template2.id}) from board "${board.name}" with ${template2.columns.length} columns`);return}let columns;if(options.columns)columns=options.columns.split(",").map((colName,i2)=>({id:crypto.randomUUID(),name:colName.trim(),label:colName.trim(),gate:"human",action:null,auto_advance:!1,transitions:[],roles:["*"],color:"#94a3b8",parallel:!1,on_fail:null,position:i2}));let template=await tmpl.createTemplate({name,description:options.description,columns});console.log(`Created template "${template.name}" (${template.id}) with ${template.columns.length} columns`)}async function handleTemplateEdit(name,options){let tmpl=await getTemplateService(),template=await tmpl.getTemplate(name);if(!template)throw Error(`Template not found: ${name}`);if(!options.column)console.error("Error: --column is required for template edit."),process.exit(1);let updates={};if(options.gate)updates.gate=options.gate;if(options.action)updates.action=options.action;if(options.color)updates.color=options.color;if(options.rename)updates.name=options.rename,updates.label=options.rename;if(!await tmpl.updateTemplateColumn(template.id,options.column,updates))throw Error(`Failed to update template: ${name}`);console.log(`Updated column "${options.column}" on template "${template.name}".`)}async function handleTemplateRename(oldName,newName){let tmpl=await getTemplateService(),template=await tmpl.getTemplate(oldName);if(!template)throw Error(`Template not found: ${oldName}`);let updated=await tmpl.renameTemplate(template.id,newName);if(!updated)throw Error(`Failed to rename template: ${oldName}`);console.log(`Renamed template "${oldName}" to "${updated.name}".`)}async function handleTemplateDelete(name){let tmpl=await getTemplateService(),template=await tmpl.getTemplate(name);if(!template)throw Error(`Template not found: ${name}`);if(!await tmpl.deleteTemplate(template.id))throw Error(`Failed to delete template: ${name}`);console.log(`Deleted template "${template.name}" (${template.id}).`)}function registerBoardCommands(program2){let board=program2.command("board").description("Board and pipeline management");board.command("create <name>").description("Create a new board").option("--project <project>","Project name").option("--from <template>","Create from template name").option("--columns <columns>","Comma-separated column names").option("--description <text>","Board description").action(async(name,options)=>{try{await handleBoardCreate(name,options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("list").description("List all boards").option("--project <project>","Filter by project").option("--all","Include archived boards").option("--json","Output as JSON").action(async(options)=>{try{await handleBoardList(options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("show <name...>").description("Show board detail").option("--project <project>","Disambiguate by project").option("--json","Output as JSON").action(async(nameParts,options)=>{try{await handleBoardShow(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("edit <name...>").description("Edit board or column properties").option("--project <project>","Disambiguate by project").option("--column <col>","Column name to edit").option("--gate <gate>","New gate value (human|agent|human+agent)").option("--action <action>","New action skill").option("--color <color>","New color hex").option("--rename <new>","Rename the column").option("--name <new>","Rename the board itself").option("--description <text>","Update description").action(async(nameParts,options)=>{try{await handleBoardEdit(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("delete <name...>").description("Delete a board").option("--project <project>","Disambiguate by project").option("--force","Skip confirmation").action(async(nameParts,options)=>{try{await handleBoardDelete(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("columns <name...>").description("Show board column pipeline").option("--project <project>","Disambiguate by project").option("--json","Output as JSON").action(async(nameParts,options)=>{try{await handleBoardColumns(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("use <name...>").description("Set active board for current repo").option("--project <project>","Disambiguate by project").action(async(nameParts,options)=>{try{await handleBoardUse(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("export <name...>").description("Export board as JSON").option("--project <project>","Disambiguate by project").option("--output <file>","Write to file instead of stdout").option("--json","Output as JSON (default, accepted for consistency)").action(async(nameParts,options)=>{try{await handleBoardExport(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("reconcile <name...>").description("Fix orphaned column_ids by matching task stage to board columns").option("--project <project>","Disambiguate by project").option("--json","Output as JSON").action(async(nameParts,options)=>{try{await handleBoardReconcile(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("archive <name...>").description("Archive a board and its unfinished tasks").option("--project <project>","Disambiguate by project").action(async(nameParts,options)=>{try{let ts3=await getTaskService3(),board2=await resolveBoard(nameParts.join(" "),options.project);await ts3.archiveBoard(board2.id),console.log(`Archived board "${board2.name}" and its unfinished tasks.`)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("import").description("Import board from JSON file").requiredOption("--json <file>","JSON file to import").requiredOption("--project <project>","Target project").action(async(options)=>{try{await handleBoardImport(options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}});let template=board.command("template").description("Board template management");template.command("list").description("List all board templates").option("--json","Output as JSON").action(async(options)=>{try{await handleTemplateList(options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),template.command("show <name>").description("Show template detail with pipeline view").option("--json","Output as JSON").action(async(name,options)=>{try{await handleTemplateShow(name,options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),template.command("create <name>").description("Create a board template").option("--from-board <board>","Create from existing board").option("--columns <columns>","Comma-separated column names").option("--description <text>","Template description").action(async(name,options)=>{try{await handleTemplateCreate(name,options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),template.command("edit <name>").description("Edit a template column").option("--column <col>","Column name to edit").option("--gate <gate>","New gate value (human|agent|human+agent)").option("--action <action>","New action skill").option("--rename <new>","Rename the column").option("--color <color>","New color hex").action(async(name,options)=>{try{await handleTemplateEdit(name,options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),template.command("rename <old> <new>").description("Rename a template").action(async(oldName,newName)=>{try{await handleTemplateRename(oldName,newName)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),template.command("delete <name>").description("Delete a template").action(async(name)=>{try{await handleTemplateDelete(name)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}})}import{execSync as execSync11}from"child_process";import{existsSync as existsSync29,mkdirSync as mkdirSync13,readFileSync as readFileSync18,realpathSync as realpathSync4,writeFileSync as writeFileSync16}from"fs";import{homedir as homedir25}from"os";import{dirname as dirname7,join as join38,resolve as resolve6}from"path";var BRAIN_PKG2="@khal-os/brain",BRAIN_REPO="khal-os/brain";function resolveGenieRoot(){try{let scriptDir=dirname7(realpathSync4(process.argv[1])),candidates=[resolve6(scriptDir,".."),resolve6(scriptDir,"..","..")];for(let c of candidates)if(existsSync29(join38(c,"package.json")))return c}catch{}return resolve6(import.meta.dir,"..","..")}var BRAIN_DIR2=join38(resolveGenieRoot(),"node_modules","@khal-os","brain"),CACHE_PATH=join38(homedir25(),".genie","brain-version-check.json");function compareVersions(a,b2){let partsA=a.split(".").map(Number),partsB=b2.split(".").map(Number);for(let i2=0;i2<Math.max(partsA.length,partsB.length);i2++){let diff=(partsA[i2]??0)-(partsB[i2]??0);if(diff!==0)return diff}return 0}function readLocalBrainVersion(){try{return JSON.parse(readFileSync18(join38(BRAIN_DIR2,"package.json"),"utf-8")).version??"unknown"}catch{return}}function checkForUpdates(cachePath){try{let p=cachePath??CACHE_PATH;if(!existsSync29(p))return{updateAvailable:!1};let cache=JSON.parse(readFileSync18(p,"utf-8"));if(cache.updateAvailable&&cache.latestVersion)return{updateAvailable:!0,latestVersion:cache.latestVersion};return{updateAvailable:!1}}catch{return{updateAvailable:!1}}}function refreshVersionCache(localVersion){try{let version=localVersion??readLocalBrainVersion();if(!version)return;let latestTag=execSync11(`gh release view --repo ${BRAIN_REPO} --json tagName -q .tagName`,{stdio:"pipe",encoding:"utf-8"}).trim(),latestVersion=latestTag.replace(/^v/,""),localCore=version.replace(/^\d+\./,""),latestCore=latestVersion.replace(/^\d+\./,""),updateAvailable=compareVersions(latestCore,localCore)>0,cacheDir=join38(homedir25(),".genie");mkdirSync13(cacheDir,{recursive:!0}),writeFileSync16(CACHE_PATH,JSON.stringify({checkedAt:new Date().toISOString(),localVersion:version,latestTag,latestVersion,updateAvailable},null,2))}catch{}}async function updateBrain(){if(!existsSync29(join38(BRAIN_DIR2,"package.json")))return console.log("  Brain is not installed. Run: genie brain install"),!1;let oldVersion=readLocalBrainVersion()??"unknown";console.log("  Checking for updates...");let tag;try{tag=execSync11(`gh release view --repo ${BRAIN_REPO} --json tagName -q .tagName`,{stdio:"pipe",encoding:"utf-8"}).trim()}catch{return console.error("  Failed to check latest release. Ensure: gh auth login"),!1}let newVersion=tag.replace(/^v/,"");if(compareVersions(newVersion,oldVersion)<=0)return console.log(`  Already at latest version (${oldVersion}).`),!0;console.log(`  Upgrading: ${oldVersion} \u2192 ${newVersion}`),console.log("");let tmpDir=join38(homedir25(),".cache","genie-brain");mkdirSync13(tmpDir,{recursive:!0}),execSync11(`gh release download ${tag} --repo ${BRAIN_REPO} --pattern '*.tgz' --dir "${tmpDir}" --clobber`,{stdio:"inherit"}),execSync11(`rm -rf "${BRAIN_DIR2}"`,{stdio:"pipe"}),mkdirSync13(BRAIN_DIR2,{recursive:!0}),execSync11(`tar xzf "${tmpDir}/khal-os-brain-${newVersion}.tgz" -C "${BRAIN_DIR2}" --strip-components=1`,{stdio:"inherit"}),execSync11("bun install",{cwd:BRAIN_DIR2,stdio:"inherit"}),console.log(`
-  Updated: ${oldVersion} \u2192 ${newVersion}`);try{let migrateScript=`const b = require('${BRAIN_PKG2}'); if (b.runAllMigrations) b.runAllMigrations().then(() => process.exit(0)).catch((e) => { console.error(e); process.exit(1); }); else process.exit(0);`;execSync11(`bun -e "${migrateScript}"`,{cwd:BRAIN_DIR2,stdio:"inherit"}),console.log("  Migrations applied.")}catch{console.log("  Migration skipped. Run: genie brain migrate")}return refreshVersionCache(newVersion),!0}async function showVersion(){let localVersion="not installed";try{let brain=await import(BRAIN_PKG2);localVersion=brain.getVersion?.()??brain.VERSION??"unknown"}catch(err){let msg=err instanceof Error?err.message:String(err);if(isModuleNotFound(msg)){console.log("  Brain is not installed. Run: genie brain install");return}}console.log(`  Local:  ${localVersion}`),refreshVersionCache(localVersion);let check2=checkForUpdates();if(check2.updateAvailable&&check2.latestVersion)console.log(`  Latest: ${check2.latestVersion}`),console.log(""),console.log("  Update available. Run: genie brain upgrade");else console.log("  Status: up to date")}async function installBrain(){console.log(""),console.log("  Installing brain from GitHub release (enterprise)..."),console.log(""),console.log("  Source: https://github.com/khal-os/brain"),console.log("  Requires: GitHub org membership (khal-os)"),console.log("");try{try{execSync11("gh auth token",{stdio:"pipe"})}catch{return console.error("  GitHub CLI not authenticated. Run: gh auth login"),!1}let tag=execSync11(`gh release view --repo ${BRAIN_REPO} --json tagName -q .tagName`,{stdio:"pipe",encoding:"utf-8"}).trim(),version=tag.replace(/^v/,"");console.log(`  Latest release: ${tag}`),console.log("");let root=resolveGenieRoot(),brainDir=join38(root,"node_modules","@khal-os","brain"),tmpDir=join38(homedir25(),".cache","genie-brain");mkdirSync13(tmpDir,{recursive:!0}),execSync11(`gh release download ${tag} --repo ${BRAIN_REPO} --pattern '*.tgz' --dir "${tmpDir}" --clobber`,{stdio:"inherit"}),execSync11(`rm -rf "${brainDir}"`,{stdio:"pipe"}),mkdirSync13(brainDir,{recursive:!0}),execSync11(`tar xzf "${tmpDir}/khal-os-brain-${version}.tgz" -C "${brainDir}" --strip-components=1`,{stdio:"inherit"}),execSync11("bun install",{cwd:brainDir,stdio:"inherit"}),console.log(""),console.log(`  Brain ${version} installed from GitHub release.`),console.log("");try{let brain=await import(BRAIN_PKG2);if(brain.runAllMigrations)console.log("  Running brain migrations..."),await brain.runAllMigrations(),console.log("  Brain tables created in Postgres.")}catch{console.log("  Auto-migration skipped. Run: genie brain migrate")}return console.log(""),console.log("  Get started:"),console.log("    genie brain init --name my-brain --path ./brain"),console.log(""),!0}catch(err){let msg=err instanceof Error?err.message:String(err);if(msg.includes("Authentication")||msg.includes("permission")||msg.includes("404"))console.error("  Access denied. Brain is enterprise-only."),console.log(""),console.log("  You need:"),console.log("    1. Membership in the khal-os GitHub org"),console.log("    2. GitHub CLI authenticated: gh auth login"),console.log(""),console.log("  Manual install:"),console.log(`    gh release download --repo ${BRAIN_REPO} --pattern '*.tgz'`),console.log("    tar xzf khal-os-brain-*.tgz -C node_modules/@khal-os/brain --strip-components=1"),console.log("");else console.error(`  Install failed: ${msg}`),console.log(""),console.log("  Manual install:"),console.log(`    gh release download --repo ${BRAIN_REPO} --pattern '*.tgz'`),console.log("    tar xzf khal-os-brain-*.tgz -C node_modules/@khal-os/brain --strip-components=1"),console.log("");return!1}}function uninstallBrain(){try{if(!existsSync29(BRAIN_DIR2)){console.log("  Brain is not installed.");return}execSync11(`rm -rf "${BRAIN_DIR2}"`,{stdio:"pipe"}),console.log("  Brain uninstalled.")}catch{console.error(`  Uninstall failed. Manual: rm -rf ${BRAIN_DIR2}`)}}function isModuleNotFound(msg){return msg.includes("Cannot find")||msg.includes("not found")||msg.includes("MODULE_NOT_FOUND")}function printNotInstalledMessage(){console.log(""),console.log("  Brain is an enterprise knowledge graph engine."),console.log("  It is not installed."),console.log(""),console.log("  Quick install:"),console.log(""),console.log("    genie brain install"),console.log(""),console.log("  Requires GitHub org membership (khal-os)."),console.log("")}async function executeBrainCommand(args){try{let brain=await import(BRAIN_PKG2);if(brain.execute){await brain.execute(args);let check2=checkForUpdates();if(check2.updateAvailable&&check2.latestVersion)console.log(`
-  Update available (${check2.latestVersion}). Run: genie brain upgrade`)}else console.error("Brain module loaded but execute() not found."),console.error("Update: genie brain install")}catch(err){let msg=err instanceof Error?err.message:String(err);if(isModuleNotFound(msg))printNotInstalledMessage();else console.error(`Brain error: ${msg}`)}}function registerBrainCommands(program2){let brain=program2.command("brain").description("Knowledge graph engine (enterprise)").allowUnknownOption().allowExcessArguments().action(async(_options,cmd)=>{let args=cmd.args;if(args.length===0){brain.help();return}await executeBrainCommand(args)});brain.command("install").description("Install genie-brain from GitHub").action(async()=>{await installBrain()}),brain.command("uninstall").description("Remove genie-brain installation").action(()=>{uninstallBrain()}),brain.command("upgrade").description("Upgrade genie-brain to latest version").action(async()=>{await updateBrain()}),brain.command("version").description("Show installed brain version").action(async()=>{await showVersion()})}var _brief2;async function getBrief2(){if(!_brief2)_brief2=await Promise.resolve().then(() => (init_brief(),exports_brief));return _brief2}async function handleBrief2(options){let team=options.team??process.env.GENIE_TEAM;if(!team)console.error("Error: --team is required (or set GENIE_TEAM)"),process.exit(1);let agent=options.agent??process.env.GENIE_AGENT_NAME,briefService=await getBrief2(),brief=await briefService.generateBrief({team,agent,since:options.since,repoPath:process.cwd()});console.log(briefService.formatBrief(brief))}function registerBriefCommands(program2){program2.command("brief").description("Show startup brief \u2014 aggregated context since last session").option("--team <name>","Team name (default: GENIE_TEAM)").option("--agent <name>","Agent name (default: GENIE_AGENT_NAME)").option("--since <iso>","Start timestamp (default: last executor end)").action(async(options)=>{try{await handleBrief2(options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}})}import{existsSync as existsSync30,mkdirSync as mkdirSync14,readFileSync as readFileSync19,unlinkSync as unlinkSync8,writeFileSync as writeFileSync17}from"fs";import{homedir as homedir26}from"os";import{join as join39}from"path";function genieHome4(){return process.env.GENIE_HOME??join39(homedir26(),".genie")}function pidFilePath(){return join39(genieHome4(),"scheduler.pid")}function logFilePath(){return join39(genieHome4(),"logs","scheduler.log")}function systemdDir(){return join39(homedir26(),".config","systemd","user")}function systemdUnitPath(){return join39(systemdDir(),"genie-scheduler.service")}function readPid(){let path3=pidFilePath();if(!existsSync30(path3))return null;let raw=readFileSync19(path3,"utf-8").trim(),pid=Number.parseInt(raw,10);if(Number.isNaN(pid)||pid<=0)return null;return pid}function removePid(){let path3=pidFilePath();if(existsSync30(path3))try{unlinkSync8(path3)}catch{}}function isProcessAlive2(pid){try{return process.kill(pid,0),!0}catch{return!1}}function servePidPath2(){return join39(genieHome4(),"serve.pid")}function readServePid2(){let path3=servePidPath2();if(!existsSync30(path3))return null;let raw=readFileSync19(path3,"utf-8").trim(),pid=Number.parseInt(raw,10);if(Number.isNaN(pid)||pid<=0)return null;return pid}function removeServePid2(){let path3=servePidPath2();if(existsSync30(path3))try{unlinkSync8(path3)}catch{}}function generateSystemdUnit(){let genieBin=process.argv[1]??"genie";return`[Unit]
+Template: ${template.name} (${template.id})`),template.description)console.log(`Description: ${template.description}`);if(template.icon)console.log(`Icon: ${template.icon}`);console.log(`Built-in: ${template.isBuiltin?"yes":"no"}`),printColumnPipeline(template.columns,`Pipeline (${template.columns.length} columns)`)}async function handleTemplateCreate(name,options){let tmpl=await getTemplateService();if(options.fromBoard){let board=await(await getBoardService()).getBoard(options.fromBoard);if(!board)throw Error(`Board not found: ${options.fromBoard}`);let template2=await tmpl.snapshotFromBoard(board.id,name);console.log(`Created template "${template2.name}" (${template2.id}) from board "${board.name}" with ${template2.columns.length} columns`);return}let columns;if(options.columns)columns=options.columns.split(",").map((colName,i2)=>({id:crypto.randomUUID(),name:colName.trim(),label:colName.trim(),gate:"human",action:null,auto_advance:!1,transitions:[],roles:["*"],color:"#94a3b8",parallel:!1,on_fail:null,position:i2}));let template=await tmpl.createTemplate({name,description:options.description,columns});console.log(`Created template "${template.name}" (${template.id}) with ${template.columns.length} columns`)}async function handleTemplateEdit(name,options){let tmpl=await getTemplateService(),template=await tmpl.getTemplate(name);if(!template)throw Error(`Template not found: ${name}`);if(!options.column)console.error("Error: --column is required for template edit."),process.exit(1);let updates={};if(options.gate)updates.gate=options.gate;if(options.action)updates.action=options.action;if(options.color)updates.color=options.color;if(options.rename)updates.name=options.rename,updates.label=options.rename;if(!await tmpl.updateTemplateColumn(template.id,options.column,updates))throw Error(`Failed to update template: ${name}`);console.log(`Updated column "${options.column}" on template "${template.name}".`)}async function handleTemplateRename(oldName,newName){let tmpl=await getTemplateService(),template=await tmpl.getTemplate(oldName);if(!template)throw Error(`Template not found: ${oldName}`);let updated=await tmpl.renameTemplate(template.id,newName);if(!updated)throw Error(`Failed to rename template: ${oldName}`);console.log(`Renamed template "${oldName}" to "${updated.name}".`)}async function handleTemplateDelete(name){let tmpl=await getTemplateService(),template=await tmpl.getTemplate(name);if(!template)throw Error(`Template not found: ${name}`);if(!await tmpl.deleteTemplate(template.id))throw Error(`Failed to delete template: ${name}`);console.log(`Deleted template "${template.name}" (${template.id}).`)}function registerBoardCommands(program2){let board=program2.command("board").description("Board and pipeline management");board.command("create <name>").description("Create a new board").option("--project <project>","Project name").option("--from <template>","Create from template name").option("--columns <columns>","Comma-separated column names").option("--description <text>","Board description").action(async(name,options)=>{try{await handleBoardCreate(name,options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("list").description("List all boards").option("--project <project>","Filter by project").option("--all","Include archived boards").option("--json","Output as JSON").action(async(options)=>{try{await handleBoardList(options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("show <name...>").description("Show board detail").option("--project <project>","Disambiguate by project").option("--json","Output as JSON").action(async(nameParts,options)=>{try{await handleBoardShow(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("edit <name...>").description("Edit board or column properties").option("--project <project>","Disambiguate by project").option("--column <col>","Column name to edit").option("--gate <gate>","New gate value (human|agent|human+agent)").option("--action <action>","New action skill").option("--color <color>","New color hex").option("--rename <new>","Rename the column").option("--name <new>","Rename the board itself").option("--description <text>","Update description").action(async(nameParts,options)=>{try{await handleBoardEdit(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("delete <name...>").description("Delete a board").option("--project <project>","Disambiguate by project").option("--force","Skip confirmation").action(async(nameParts,options)=>{try{await handleBoardDelete(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("columns <name...>").description("Show board column pipeline").option("--project <project>","Disambiguate by project").option("--json","Output as JSON").action(async(nameParts,options)=>{try{await handleBoardColumns(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("use <name...>").description("Set active board for current repo").option("--project <project>","Disambiguate by project").action(async(nameParts,options)=>{try{await handleBoardUse(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("export <name...>").description("Export board as JSON").option("--project <project>","Disambiguate by project").option("--output <file>","Write to file instead of stdout").option("--json","Output as JSON (default, accepted for consistency)").action(async(nameParts,options)=>{try{await handleBoardExport(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("reconcile <name...>").description("Fix orphaned column_ids by matching task stage to board columns").option("--project <project>","Disambiguate by project").option("--json","Output as JSON").action(async(nameParts,options)=>{try{await handleBoardReconcile(nameParts.join(" "),options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("archive <name...>").description("Archive a board and its unfinished tasks").option("--project <project>","Disambiguate by project").action(async(nameParts,options)=>{try{let ts3=await getTaskService3(),board2=await resolveBoard(nameParts.join(" "),options.project);await ts3.archiveBoard(board2.id),console.log(`Archived board "${board2.name}" and its unfinished tasks.`)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),board.command("import").description("Import board from JSON file").requiredOption("--json <file>","JSON file to import").requiredOption("--project <project>","Target project").action(async(options)=>{try{await handleBoardImport(options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}});let template=board.command("template").description("Board template management");template.command("list").description("List all board templates").option("--json","Output as JSON").action(async(options)=>{try{await handleTemplateList(options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),template.command("show <name>").description("Show template detail with pipeline view").option("--json","Output as JSON").action(async(name,options)=>{try{await handleTemplateShow(name,options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),template.command("create <name>").description("Create a board template").option("--from-board <board>","Create from existing board").option("--columns <columns>","Comma-separated column names").option("--description <text>","Template description").action(async(name,options)=>{try{await handleTemplateCreate(name,options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),template.command("edit <name>").description("Edit a template column").option("--column <col>","Column name to edit").option("--gate <gate>","New gate value (human|agent|human+agent)").option("--action <action>","New action skill").option("--rename <new>","Rename the column").option("--color <color>","New color hex").action(async(name,options)=>{try{await handleTemplateEdit(name,options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),template.command("rename <old> <new>").description("Rename a template").action(async(oldName,newName)=>{try{await handleTemplateRename(oldName,newName)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}}),template.command("delete <name>").description("Delete a template").action(async(name)=>{try{await handleTemplateDelete(name)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}})}import{execSync as execSync11}from"child_process";import{existsSync as existsSync29,mkdirSync as mkdirSync13,readFileSync as readFileSync18,realpathSync as realpathSync4,writeFileSync as writeFileSync16}from"fs";import{homedir as homedir25}from"os";import{dirname as dirname7,join as join38,resolve as resolve6}from"path";var BRAIN_PKG2="@khal-os/brain",BRAIN_REPO="khal-os/brain";function resolveGenieRoot(){try{let scriptDir=dirname7(realpathSync4(process.argv[1])),candidates=[resolve6(scriptDir,".."),resolve6(scriptDir,"..","..")];for(let c of candidates)if(existsSync29(join38(c,"package.json")))return c}catch{}return resolve6(import.meta.dir,"..","..")}var BRAIN_DIR2=join38(resolveGenieRoot(),"node_modules","@khal-os","brain"),CACHE_PATH=join38(homedir25(),".genie","brain-version-check.json");function compareVersions(a,b2){let partsA=a.split(".").map(Number),partsB=b2.split(".").map(Number);for(let i2=0;i2<Math.max(partsA.length,partsB.length);i2++){let diff=(partsA[i2]??0)-(partsB[i2]??0);if(diff!==0)return diff}return 0}function readLocalBrainVersion(){try{return JSON.parse(readFileSync18(join38(BRAIN_DIR2,"package.json"),"utf-8")).version??"unknown"}catch{return}}function resolveBrainBin(){let candidates=[join38(resolveGenieRoot(),"node_modules",".bin","brain"),join38(BRAIN_DIR2,"dist","cli.js")];for(let c of candidates)if(existsSync29(c))return c;return}function findBrainVault(){let candidates=[process.cwd(),join38(process.cwd(),"brain"),join38(homedir25(),"brain")];for(let dir of candidates)if(existsSync29(join38(dir,"brain.json")))return dir;return null}function readActiveBrainConfig(){try{let configPath2=join38(homedir25(),".brain","config.json");if(!existsSync29(configPath2))return null;let data=JSON.parse(readFileSync18(configPath2,"utf-8"));if(!data.pid)return null;return{pid:data.pid,pgPort:data.pgPort,brainPath:data.brainPath}}catch{return null}}function isProcessAlive2(pid){try{return process.kill(pid,0),!0}catch{return!1}}async function stopBrainDaemon(){let config=readActiveBrainConfig();if(!config?.pid||!isProcessAlive2(config.pid))return!1;let brainBin=resolveBrainBin(),brainPath=config.brainPath;if(brainBin)try{let pathArg=brainPath?` --brain-path "${brainPath}"`:"";execSync11(`"${brainBin}" serve stop${pathArg}`,{stdio:"pipe",timeout:1e4})}catch{}for(let i2=0;i2<25;i2++){if(!isProcessAlive2(config.pid))return!0;await new Promise((r)=>setTimeout(r,200))}try{process.kill(config.pid,"SIGKILL")}catch{}return!0}function startBrainDaemon(vaultPath,extraArgs){let bin=resolveBrainBin();if(!bin)return;try{let argsStr=extraArgs?.length?` ${extraArgs.join(" ")}`:"";execSync11(`"${bin}" serve --daemon --brain-path "${vaultPath}"${argsStr}`,{stdio:"inherit",timeout:15000}),console.log("  Brain daemon started.")}catch{console.log("  Daemon failed to start. Run: brain serve --daemon")}}function readSavedDaemonArgs(brainPath){try{let serverJsonPath=join38(brainPath,".brain-server.json");return JSON.parse(readFileSync18(serverJsonPath,"utf-8")).args}catch{return}}function checkForUpdates(cachePath){try{let p=cachePath??CACHE_PATH;if(!existsSync29(p))return{updateAvailable:!1};let cache=JSON.parse(readFileSync18(p,"utf-8"));if(cache.updateAvailable&&cache.latestVersion)return{updateAvailable:!0,latestVersion:cache.latestVersion};return{updateAvailable:!1}}catch{return{updateAvailable:!1}}}function refreshVersionCache(localVersion){try{let version=localVersion??readLocalBrainVersion();if(!version)return;let latestTag=execSync11(`gh release view --repo ${BRAIN_REPO} --json tagName -q .tagName`,{stdio:"pipe",encoding:"utf-8"}).trim(),latestVersion=latestTag.replace(/^v/,""),localCore=version.replace(/^\d+\./,""),latestCore=latestVersion.replace(/^\d+\./,""),updateAvailable=compareVersions(latestCore,localCore)>0,cacheDir=join38(homedir25(),".genie");mkdirSync13(cacheDir,{recursive:!0}),writeFileSync16(CACHE_PATH,JSON.stringify({checkedAt:new Date().toISOString(),localVersion:version,latestTag,latestVersion,updateAvailable},null,2))}catch{}}async function updateBrain(){if(!existsSync29(join38(BRAIN_DIR2,"package.json")))return console.log("  Brain is not installed. Run: genie brain install"),!1;let oldVersion=readLocalBrainVersion()??"unknown";console.log("  Checking for updates...");let tag;try{tag=execSync11(`gh release view --repo ${BRAIN_REPO} --json tagName -q .tagName`,{stdio:"pipe",encoding:"utf-8"}).trim()}catch{return console.error("  Failed to check latest release. Ensure: gh auth login"),!1}let newVersion=tag.replace(/^v/,"");if(compareVersions(newVersion,oldVersion)<=0)return console.log(`  Already at latest version (${oldVersion}).`),!0;console.log(`  Upgrading: ${oldVersion} \u2192 ${newVersion}`),console.log("");let activeConfig=readActiveBrainConfig(),savedArgs=activeConfig?.brainPath?readSavedDaemonArgs(activeConfig.brainPath):void 0,wasRunning=activeConfig?await stopBrainDaemon():!1,tmpDir=join38(homedir25(),".cache","genie-brain");mkdirSync13(tmpDir,{recursive:!0}),execSync11(`gh release download ${tag} --repo ${BRAIN_REPO} --pattern '*.tgz' --dir "${tmpDir}" --clobber`,{stdio:"inherit"}),execSync11(`rm -rf "${BRAIN_DIR2}"`,{stdio:"pipe"}),mkdirSync13(BRAIN_DIR2,{recursive:!0}),execSync11(`tar xzf "${tmpDir}/khal-os-brain-${newVersion}.tgz" -C "${BRAIN_DIR2}" --strip-components=1`,{stdio:"inherit"}),execSync11("bun install",{cwd:BRAIN_DIR2,stdio:"inherit"}),console.log(`
+  Updated: ${oldVersion} \u2192 ${newVersion}`);try{let migrateScript=`const b = require('${BRAIN_PKG2}'); if (b.runAllMigrations) b.runAllMigrations().then(() => process.exit(0)).catch((e) => { console.error(e); process.exit(1); }); else process.exit(0);`;execSync11(`bun -e "${migrateScript}"`,{cwd:BRAIN_DIR2,stdio:"inherit"}),console.log("  Migrations applied.")}catch{console.log("  Migration skipped. Run: genie brain migrate")}if(refreshVersionCache(newVersion),wasRunning&&activeConfig?.brainPath)startBrainDaemon(activeConfig.brainPath,savedArgs);return!0}async function showVersion(){let localVersion="not installed";try{let brain=await import(BRAIN_PKG2);localVersion=brain.getVersion?.()??brain.VERSION??"unknown"}catch(err){let msg=err instanceof Error?err.message:String(err);if(isModuleNotFound(msg)){console.log("  Brain is not installed. Run: genie brain install");return}}console.log(`  Local:  ${localVersion}`),refreshVersionCache(localVersion);let check2=checkForUpdates();if(check2.updateAvailable&&check2.latestVersion)console.log(`  Latest: ${check2.latestVersion}`),console.log(""),console.log("  Update available. Run: genie brain upgrade");else console.log("  Status: up to date")}async function installBrain(){console.log(""),console.log("  Installing brain from GitHub release (enterprise)..."),console.log(""),console.log("  Source: https://github.com/khal-os/brain"),console.log("  Requires: GitHub org membership (khal-os)"),console.log("");try{try{execSync11("gh auth token",{stdio:"pipe"})}catch{return console.error("  GitHub CLI not authenticated. Run: gh auth login"),!1}let tag=execSync11(`gh release view --repo ${BRAIN_REPO} --json tagName -q .tagName`,{stdio:"pipe",encoding:"utf-8"}).trim(),version=tag.replace(/^v/,"");console.log(`  Latest release: ${tag}`),console.log("");let root=resolveGenieRoot(),brainDir=join38(root,"node_modules","@khal-os","brain"),tmpDir=join38(homedir25(),".cache","genie-brain");mkdirSync13(tmpDir,{recursive:!0}),execSync11(`gh release download ${tag} --repo ${BRAIN_REPO} --pattern '*.tgz' --dir "${tmpDir}" --clobber`,{stdio:"inherit"}),execSync11(`rm -rf "${brainDir}"`,{stdio:"pipe"}),mkdirSync13(brainDir,{recursive:!0}),execSync11(`tar xzf "${tmpDir}/khal-os-brain-${version}.tgz" -C "${brainDir}" --strip-components=1`,{stdio:"inherit"}),execSync11("bun install",{cwd:brainDir,stdio:"inherit"}),console.log(""),console.log(`  Brain ${version} installed from GitHub release.`),console.log("");try{let brain=await import(BRAIN_PKG2);if(brain.runAllMigrations)console.log("  Running brain migrations..."),await brain.runAllMigrations(),console.log("  Brain tables created in Postgres.")}catch{console.log("  Auto-migration skipped. Run: genie brain migrate")}let vaultPath=findBrainVault();if(vaultPath)startBrainDaemon(vaultPath);else console.log("  No brain vault found. Create one with: brain init --name <name> --path <path>");return console.log(""),console.log("  Get started:"),console.log("    genie brain init --name my-brain --path ./brain"),console.log(""),!0}catch(err){let msg=err instanceof Error?err.message:String(err);if(msg.includes("Authentication")||msg.includes("permission")||msg.includes("404"))console.error("  Access denied. Brain is enterprise-only."),console.log(""),console.log("  You need:"),console.log("    1. Membership in the khal-os GitHub org"),console.log("    2. GitHub CLI authenticated: gh auth login"),console.log(""),console.log("  Manual install:"),console.log(`    gh release download --repo ${BRAIN_REPO} --pattern '*.tgz'`),console.log("    tar xzf khal-os-brain-*.tgz -C node_modules/@khal-os/brain --strip-components=1"),console.log("");else console.error(`  Install failed: ${msg}`),console.log(""),console.log("  Manual install:"),console.log(`    gh release download --repo ${BRAIN_REPO} --pattern '*.tgz'`),console.log("    tar xzf khal-os-brain-*.tgz -C node_modules/@khal-os/brain --strip-components=1"),console.log("");return!1}}async function uninstallBrain(){try{if(!existsSync29(BRAIN_DIR2)){console.log("  Brain is not installed.");return}await stopBrainDaemon(),execSync11(`rm -rf "${BRAIN_DIR2}"`,{stdio:"pipe"}),console.log("  Brain uninstalled.")}catch{console.error(`  Uninstall failed. Manual: rm -rf ${BRAIN_DIR2}`)}}function isModuleNotFound(msg){return msg.includes("Cannot find")||msg.includes("not found")||msg.includes("MODULE_NOT_FOUND")}function printNotInstalledMessage(){console.log(""),console.log("  Brain is an enterprise knowledge graph engine."),console.log("  It is not installed."),console.log(""),console.log("  Quick install:"),console.log(""),console.log("    genie brain install"),console.log(""),console.log("  Requires GitHub org membership (khal-os)."),console.log("")}async function executeBrainCommand(args){try{let brain=await import(BRAIN_PKG2);if(brain.execute){await brain.execute(args);let check2=checkForUpdates();if(check2.updateAvailable&&check2.latestVersion)console.log(`
+  Update available (${check2.latestVersion}). Run: genie brain upgrade`)}else console.error("Brain module loaded but execute() not found."),console.error("Update: genie brain install")}catch(err){let msg=err instanceof Error?err.message:String(err);if(isModuleNotFound(msg))printNotInstalledMessage();else console.error(`Brain error: ${msg}`)}}function registerBrainCommands(program2){let brain=program2.command("brain").description("Knowledge graph engine (enterprise)").allowUnknownOption().allowExcessArguments().action(async(_options,cmd)=>{let args=cmd.args;if(args.length===0){brain.help();return}await executeBrainCommand(args)});brain.command("install").description("Install genie-brain from GitHub").action(async()=>{await installBrain()}),brain.command("uninstall").description("Remove genie-brain installation").action(async()=>{await uninstallBrain()}),brain.command("upgrade").description("Upgrade genie-brain to latest version").action(async()=>{await updateBrain()}),brain.command("version").description("Show installed brain version").action(async()=>{await showVersion()})}var _brief2;async function getBrief2(){if(!_brief2)_brief2=await Promise.resolve().then(() => (init_brief(),exports_brief));return _brief2}async function handleBrief2(options){let team=options.team??process.env.GENIE_TEAM;if(!team)console.error("Error: --team is required (or set GENIE_TEAM)"),process.exit(1);let agent=options.agent??process.env.GENIE_AGENT_NAME,briefService=await getBrief2(),brief=await briefService.generateBrief({team,agent,since:options.since,repoPath:process.cwd()});console.log(briefService.formatBrief(brief))}function registerBriefCommands(program2){program2.command("brief").description("Show startup brief \u2014 aggregated context since last session").option("--team <name>","Team name (default: GENIE_TEAM)").option("--agent <name>","Agent name (default: GENIE_AGENT_NAME)").option("--since <iso>","Start timestamp (default: last executor end)").action(async(options)=>{try{await handleBrief2(options)}catch(error2){console.error(`Error: ${error2 instanceof Error?error2.message:String(error2)}`),process.exit(1)}})}import{existsSync as existsSync30,mkdirSync as mkdirSync14,readFileSync as readFileSync19,unlinkSync as unlinkSync8,writeFileSync as writeFileSync17}from"fs";import{homedir as homedir26}from"os";import{join as join39}from"path";function genieHome4(){return process.env.GENIE_HOME??join39(homedir26(),".genie")}function pidFilePath(){return join39(genieHome4(),"scheduler.pid")}function logFilePath(){return join39(genieHome4(),"logs","scheduler.log")}function systemdDir(){return join39(homedir26(),".config","systemd","user")}function systemdUnitPath(){return join39(systemdDir(),"genie-scheduler.service")}function readPid(){let path3=pidFilePath();if(!existsSync30(path3))return null;let raw=readFileSync19(path3,"utf-8").trim(),pid=Number.parseInt(raw,10);if(Number.isNaN(pid)||pid<=0)return null;return pid}function removePid(){let path3=pidFilePath();if(existsSync30(path3))try{unlinkSync8(path3)}catch{}}function isProcessAlive3(pid){try{return process.kill(pid,0),!0}catch{return!1}}function servePidPath2(){return join39(genieHome4(),"serve.pid")}function readServePid2(){let path3=servePidPath2();if(!existsSync30(path3))return null;let raw=readFileSync19(path3,"utf-8").trim(),pid=Number.parseInt(raw,10);if(Number.isNaN(pid)||pid<=0)return null;return pid}function removeServePid2(){let path3=servePidPath2();if(existsSync30(path3))try{unlinkSync8(path3)}catch{}}function generateSystemdUnit(){let genieBin=process.argv[1]??"genie";return`[Unit]
 Description=Genie Serve (headless) \u2014 pgserve + scheduler + services
 Documentation=https://github.com/automagik/genie
 After=network.target
@@ -3048,7 +3048,7 @@ WantedBy=default.target
 `}async function daemonInstallCommand(){let unitContent=generateSystemdUnit(),unitPath=systemdUnitPath();mkdirSync14(systemdDir(),{recursive:!0}),writeFileSync17(unitPath,unitContent,"utf-8"),console.log(`Wrote systemd unit: ${unitPath}`);let{spawnSync:spawnSync5}=await import("child_process"),reloadResult=spawnSync5("systemctl",["--user","daemon-reload"],{stdio:["ignore","pipe","pipe"]});if(reloadResult.status!==0){let stderr=reloadResult.stderr?.toString().trim();if(console.log(`
 Note: systemctl daemon-reload failed (systemd may not be available).`),stderr)console.log(`  ${stderr}`);console.log("You can still run manually: genie serve --headless --foreground");return}let enableResult=spawnSync5("systemctl",["--user","enable","genie-scheduler.service"],{stdio:["ignore","pipe","pipe"]});if(enableResult.status===0)console.log("Enabled genie-scheduler.service"),console.log(`
 To start: systemctl --user start genie-scheduler`),console.log("Or:       genie serve --headless");else{let stderr=enableResult.stderr?.toString().trim();if(console.log(`
-Note: systemctl enable failed.`),stderr)console.log(`  ${stderr}`);console.log("You can start manually: genie serve --headless")}}async function daemonStartCommand(options){console.log("Note: `genie daemon start` now redirects to `genie serve --headless`."),console.log("      Use `genie serve --headless` directly in the future.\n");let{spawn:spawnChild}=await import("child_process"),bunPath=process.execPath??"bun",genieBin=process.argv[1]??"genie";if(options.foreground)spawnChild(bunPath,[genieBin,"serve","start","--headless","--foreground"],{stdio:"inherit",env:{...process.env}}).on("exit",(code)=>process.exit(code??0)),await new Promise(()=>{});else spawnChild(bunPath,[genieBin,"serve","start","--headless","--daemon"],{stdio:"inherit",env:{...process.env}}).on("exit",(code)=>process.exit(code??0))}async function daemonStopCommand(){let pid=readServePid2(),source="serve";if(!pid)pid=readPid(),source="scheduler";if(!pid){console.log("No serve or scheduler PID file found. Nothing is running.");return}if(!isProcessAlive2(pid)){console.log(`Stale PID file (${source}, PID ${pid} is not running). Cleaning up.`),removeServePid2(),removePid();return}console.log(`Stopping genie serve (PID ${pid})...`),process.kill(pid,"SIGTERM");let deadline=Date.now()+1e4;while(Date.now()<deadline&&isProcessAlive2(pid))await new Promise((resolve7)=>setTimeout(resolve7,250));if(isProcessAlive2(pid)){console.log("Did not stop within 10s. Sending SIGKILL.");try{process.kill(pid,"SIGKILL")}catch{}}removeServePid2(),removePid(),console.log("Genie serve stopped.")}function getProcessUptime(pid){try{let procStat=readFileSync19(`/proc/${pid}/stat`,"utf-8"),bootTimeJiffies=Number.parseInt(procStat.split(" ")[21],10);if(Number.isNaN(bootTimeJiffies))return null;let uptimeSec=readFileSync19("/proc/uptime","utf-8"),processUptimeS=Number.parseFloat(uptimeSec.split(" ")[0])-bootTimeJiffies/100;return processUptimeS>0?formatUptime(processUptimeS*1000):null}catch{return null}}async function printDaemonStats(){try{let{getConnection:getConnection2,shutdown:shutdown3}=await Promise.resolve().then(() => (init_db(),exports_db)),sql=await getConnection2(),firedResult=await sql`
+Note: systemctl enable failed.`),stderr)console.log(`  ${stderr}`);console.log("You can start manually: genie serve --headless")}}async function daemonStartCommand(options){console.log("Note: `genie daemon start` now redirects to `genie serve --headless`."),console.log("      Use `genie serve --headless` directly in the future.\n");let{spawn:spawnChild}=await import("child_process"),bunPath=process.execPath??"bun",genieBin=process.argv[1]??"genie";if(options.foreground)spawnChild(bunPath,[genieBin,"serve","start","--headless","--foreground"],{stdio:"inherit",env:{...process.env}}).on("exit",(code)=>process.exit(code??0)),await new Promise(()=>{});else spawnChild(bunPath,[genieBin,"serve","start","--headless","--daemon"],{stdio:"inherit",env:{...process.env}}).on("exit",(code)=>process.exit(code??0))}async function daemonStopCommand(){let pid=readServePid2(),source="serve";if(!pid)pid=readPid(),source="scheduler";if(!pid){console.log("No serve or scheduler PID file found. Nothing is running.");return}if(!isProcessAlive3(pid)){console.log(`Stale PID file (${source}, PID ${pid} is not running). Cleaning up.`),removeServePid2(),removePid();return}console.log(`Stopping genie serve (PID ${pid})...`),process.kill(pid,"SIGTERM");let deadline=Date.now()+1e4;while(Date.now()<deadline&&isProcessAlive3(pid))await new Promise((resolve7)=>setTimeout(resolve7,250));if(isProcessAlive3(pid)){console.log("Did not stop within 10s. Sending SIGKILL.");try{process.kill(pid,"SIGKILL")}catch{}}removeServePid2(),removePid(),console.log("Genie serve stopped.")}function getProcessUptime(pid){try{let procStat=readFileSync19(`/proc/${pid}/stat`,"utf-8"),bootTimeJiffies=Number.parseInt(procStat.split(" ")[21],10);if(Number.isNaN(bootTimeJiffies))return null;let uptimeSec=readFileSync19("/proc/uptime","utf-8"),processUptimeS=Number.parseFloat(uptimeSec.split(" ")[0])-bootTimeJiffies/100;return processUptimeS>0?formatUptime(processUptimeS*1000):null}catch{return null}}async function printDaemonStats(){try{let{getConnection:getConnection2,shutdown:shutdown3}=await Promise.resolve().then(() => (init_db(),exports_db)),sql=await getConnection2(),firedResult=await sql`
       SELECT count(*)::int AS cnt FROM triggers WHERE status IN ('executing', 'completed')
     `;console.log(`  Fired:    ${firedResult[0]?.cnt??0} trigger(s)`);let pendingResult=await sql`
       SELECT count(*)::int AS cnt FROM triggers WHERE status = 'pending'
@@ -3059,7 +3059,7 @@ Note: systemctl enable failed.`),stderr)console.log(`  ${stderr}`);console.log("
       WHERE status = 'failed' AND error IS NOT NULL
       ORDER BY completed_at DESC
       LIMIT 1
-    `;if(lastError.length>0&&lastError[0].error)console.log(`  Last err: ${lastError[0].error.slice(0,80)}`);await shutdown3()}catch{console.log("  (database not available \u2014 stats unavailable)")}}async function daemonStatusCommand(){let sPid=readServePid2(),schPid=readPid(),pid=sPid&&isProcessAlive2(sPid)?sPid:schPid,running2=pid!==null&&isProcessAlive2(pid);if(console.log(`
+    `;if(lastError.length>0&&lastError[0].error)console.log(`  Last err: ${lastError[0].error.slice(0,80)}`);await shutdown3()}catch{console.log("  (database not available \u2014 stats unavailable)")}}async function daemonStatusCommand(){let sPid=readServePid2(),schPid=readPid(),pid=sPid&&isProcessAlive3(sPid)?sPid:schPid,running2=pid!==null&&isProcessAlive3(pid);if(console.log(`
 Genie Scheduler Daemon`),console.log("\u2500".repeat(50)),console.log(`  Status:   ${running2?"running":"stopped"}`),running2&&pid){console.log(`  PID:      ${pid}`);let uptime=getProcessUptime(pid);if(uptime)console.log(`  Uptime:   ${uptime}`)}try{let{getInboxPollIntervalMs:getInboxPollIntervalMs2}=await Promise.resolve().then(() => (init_inbox_watcher(),exports_inbox_watcher)),inboxPollMs=getInboxPollIntervalMs2();if(inboxPollMs===0)console.log("  Inbox:    disabled (GENIE_INBOX_POLL_MS=0)");else console.log(`  Inbox:    ${running2?"watching":"stopped"} (poll every ${inboxPollMs/1000}s)`)}catch{console.log("  Inbox:    unavailable")}await printDaemonStats(),console.log(`  PID file: ${servePidPath2()} (canonical) / ${pidFilePath()} (legacy)`),console.log(`  Log file: ${logFilePath()}`),console.log("")}async function daemonLogsCommand(options){let logPath=logFilePath();if(!existsSync30(logPath)){console.log("No scheduler log file found. Start the daemon first."),console.log(`  Expected: ${logPath}`);return}let linesToShow=options.lines??20;if(options.follow)await tailFollow(logPath,linesToShow);else tailStatic(logPath,linesToShow)}function tailStatic(filePath,lines){let allLines=readFileSync19(filePath,"utf-8").trim().split(`
 `).filter(Boolean),start2=Math.max(0,allLines.length-lines),slice=allLines.slice(start2);for(let line of slice)printLogLine(line);if(allLines.length>lines)console.log(`
 (showing last ${lines} of ${allLines.length} entries)`)}async function tailFollow(filePath,initialLines){let{watch:watch2}=await import("fs");tailStatic(filePath,initialLines),console.log(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automagik/genie",
-  "version": "4.260407.5",
+  "version": "4.260407.7",
   "description": "Collaborative terminal toolkit for human + AI workflows",
   "type": "module",
   "bin": {

package/plugins/genie/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "genie",
-  "version": "4.260407.5",
+  "version": "4.260407.7",
   "description": "Human-AI partnership for Claude Code. Share a terminal, orchestrate workers, evolve together. Brainstorm ideas, turn them into wishes, execute with /work, validate with /review, and ship as one team.",
   "author": {
     "name": "Namastex Labs"

package/plugins/genie/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genie-plugin",
-  "version": "4.260407.5",
+  "version": "4.260407.7",
   "private": true,
   "description": "Runtime dependencies for genie bundled CLIs",
   "type": "module",

package/src/term-commands/brain.ts

@@ -62,6 +62,120 @@ function readLocalBrainVersion(): string | undefined {
   }
 }
 
+// ── Daemon lifecycle helpers ────────────────────────────────────────────────
+
+/** Resolve the brain CLI binary. Prefers .bin symlink, falls back to dist/cli.js. */
+function resolveBrainBin(): string | undefined {
+  const candidates = [join(resolveGenieRoot(), 'node_modules', '.bin', 'brain'), join(BRAIN_DIR, 'dist', 'cli.js')];
+  for (const c of candidates) {
+    if (existsSync(c)) return c;
+  }
+  return undefined;
+}
+
+/** Search for a brain vault (brain.json) in common locations. Returns path or null. */
+function findBrainVault(): string | null {
+  const candidates = [process.cwd(), join(process.cwd(), 'brain'), join(homedir(), 'brain')];
+  for (const dir of candidates) {
+    if (existsSync(join(dir, 'brain.json'))) return dir;
+  }
+  return null;
+}
+
+interface ActiveBrainConfig {
+  pid: number;
+  pgPort?: number;
+  brainPath?: string;
+}
+
+/** Read ~/.brain/config.json for running server PID + brainPath. Returns null on failure. */
+function readActiveBrainConfig(): ActiveBrainConfig | null {
+  try {
+    const configPath = join(homedir(), '.brain', 'config.json');
+    if (!existsSync(configPath)) return null;
+    const data = JSON.parse(readFileSync(configPath, 'utf-8'));
+    if (!data.pid) return null;
+    return { pid: data.pid, pgPort: data.pgPort, brainPath: data.brainPath };
+  } catch {
+    return null;
+  }
+}
+
+/** Check if a process is alive by signaling 0. */
+function isProcessAlive(pid: number): boolean {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Stop a running brain daemon gracefully.
+ * Calls `brain serve stop --brain-path`, polls PID 200ms × 25 (5s), SIGKILL fallback.
+ * Returns true if a daemon was running and stopped.
+ */
+async function stopBrainDaemon(): Promise<boolean> {
+  const config = readActiveBrainConfig();
+  if (!config?.pid || !isProcessAlive(config.pid)) return false;
+
+  const brainBin = resolveBrainBin();
+  const brainPath = config.brainPath;
+
+  // Use brain's own stop command
+  if (brainBin) {
+    try {
+      const pathArg = brainPath ? ` --brain-path "${brainPath}"` : '';
+      execSync(`"${brainBin}" serve stop${pathArg}`, { stdio: 'pipe', timeout: 10000 });
+    } catch {
+      // Fall through to PID polling — stop command may not be available in older versions
+    }
+  }
+
+  // Poll PID for up to 5s (25 × 200ms)
+  for (let i = 0; i < 25; i++) {
+    if (!isProcessAlive(config.pid)) return true;
+    await new Promise((r) => setTimeout(r, 200));
+  }
+
+  // SIGKILL fallback
+  try {
+    process.kill(config.pid, 'SIGKILL');
+  } catch {
+    // Already gone
+  }
+
+  return true;
+}
+
+/** Start brain daemon for a vault. Logs result. Never throws. */
+function startBrainDaemon(vaultPath: string, extraArgs?: string[]): void {
+  const bin = resolveBrainBin();
+  if (!bin) return;
+  try {
+    const argsStr = extraArgs?.length ? ` ${extraArgs.join(' ')}` : '';
+    execSync(`"${bin}" serve --daemon --brain-path "${vaultPath}"${argsStr}`, {
+      stdio: 'inherit',
+      timeout: 15000,
+    });
+    console.log('  Brain daemon started.');
+  } catch {
+    console.log('  Daemon failed to start. Run: brain serve --daemon');
+  }
+}
+
+/** Read saved daemon args from .brain-server.json in a vault. */
+function readSavedDaemonArgs(brainPath: string): string[] | undefined {
+  try {
+    const serverJsonPath = join(brainPath, '.brain-server.json');
+    const serverInfo = JSON.parse(readFileSync(serverJsonPath, 'utf-8'));
+    return serverInfo.args;
+  } catch {
+    return undefined;
+  }
+}
+
 // ── Cache-only update check (no network, sync, never throws) ──────────────
 
 interface UpdateCheck {
@@ -160,6 +274,11 @@ async function updateBrain(): Promise<boolean> {
   console.log(`  Upgrading: ${oldVersion} → ${newVersion}`);
   console.log('');
 
+  // Stop running daemon before upgrade (read saved args for restart)
+  const activeConfig = readActiveBrainConfig();
+  const savedArgs = activeConfig?.brainPath ? readSavedDaemonArgs(activeConfig.brainPath) : undefined;
+  const wasRunning = activeConfig ? await stopBrainDaemon() : false;
+
   // Download and extract new tarball (same flow as install)
   const tmpDir = join(homedir(), '.cache', 'genie-brain');
   mkdirSync(tmpDir, { recursive: true });
@@ -194,6 +313,11 @@ async function updateBrain(): Promise<boolean> {
   // Refresh version cache
   refreshVersionCache(newVersion);
 
+  // Restart daemon if it was running before upgrade
+  if (wasRunning && activeConfig?.brainPath) {
+    startBrainDaemon(activeConfig.brainPath, savedArgs);
+  }
+
   return true;
 }
 
@@ -296,6 +420,14 @@ async function installBrain(): Promise<boolean> {
       console.log('  Auto-migration skipped. Run: genie brain migrate');
     }
 
+    // Auto-start daemon if a vault is found
+    const vaultPath = findBrainVault();
+    if (vaultPath) {
+      startBrainDaemon(vaultPath);
+    } else {
+      console.log('  No brain vault found. Create one with: brain init --name <name> --path <path>');
+    }
+
     console.log('');
     console.log('  Get started:');
     console.log('    genie brain init --name my-brain --path ./brain');
@@ -327,12 +459,16 @@ async function installBrain(): Promise<boolean> {
   }
 }
 
-function uninstallBrain(): void {
+async function uninstallBrain(): Promise<void> {
   try {
     if (!existsSync(BRAIN_DIR)) {
       console.log('  Brain is not installed.');
       return;
     }
+
+    // Stop running daemon before removing files
+    await stopBrainDaemon();
+
     execSync(`rm -rf "${BRAIN_DIR}"`, { stdio: 'pipe' });
     console.log('  Brain uninstalled.');
   } catch {
@@ -409,8 +545,8 @@ export function registerBrainCommands(program: Command): void {
   brain
     .command('uninstall')
     .description('Remove genie-brain installation')
-    .action(() => {
-      uninstallBrain();
+    .action(async () => {
+      await uninstallBrain();
     });
 
   brain