codehere 0.7.1 → 0.8.0

package/dist/application/use-cases/narrator-prompt-template.js

@@ -79,7 +79,7 @@ Write the paragraph now. Do not preface with "Update:" or anything similar.
 Plain prose. No "I'm currently…" — narrate the AGENT, not yourself.
 `;
 function templateFile() {
-    return join(homedir(), '.codehere', 'narrator-prompt.md');
+    return join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'narrator-prompt.md');
 }
 /** Read the user-customized template if present and valid. Falls back to
  *  baked-in default on missing file, parse failure, or missing required

package/dist/index.js

@@ -661,8 +661,8 @@ program
             try {
                 const { migrate } = await import('./infrastructure/storage/project-thread-migration.js');
                 const result = migrate({
-                    sourceJsonl: join(homedir(), '.codehere/sessions.jsonl'),
-                    targetDir: join(homedir(), '.codehere/projects'),
+                    sourceJsonl: join(process.env.CODEHERE_HOME || homedir(), '.codehere/sessions.jsonl'),
+                    targetDir: join(process.env.CODEHERE_HOME || homedir(), '.codehere/projects'),
                 });
                 if (result.threadsWritten > 0) {
                     console.log(colors.dim(`  v0.6 migration: created ${result.threadsWritten} project thread(s) from ${result.sessionsProcessed} sessions (${result.durationMs}ms)`));
@@ -765,8 +765,12 @@ program
                     console.log(colors.dim(`  version: ${existing.version}`));
                 }
                 newline();
-                console.log(colors.dim('  Opening browser...'));
-                await openBrowser();
+                // Honor --no-open here too — found via the v1 stranger walk: a second
+                // `start --no-open` against a running daemon popped a browser anyway.
+                if (shouldOpen) {
+                    console.log(colors.dim('  Opening browser...'));
+                    await openBrowser();
+                }
                 process.exit(0);
             }
             console.error(error(`Port ${port} is in use by another process.`));
@@ -947,8 +951,8 @@ program
 program
     .command('migrate-threads', { hidden: true }) // hidden from --help (v0.6.0 internal — auto-runs on daemon start once wired)
     .description('Migrate sessions.jsonl into per-project thread.jsonl files (v0.6.0 schema)')
-    .option('--source <path>', 'Source sessions.jsonl', `${homedir()}/.codehere/sessions.jsonl`)
-    .option('--target <dir>', 'Target projects dir', `${homedir()}/.codehere/projects`)
+    .option('--source <path>', 'Source sessions.jsonl', `${process.env.CODEHERE_HOME || homedir()}/.codehere/sessions.jsonl`)
+    .option('--target <dir>', 'Target projects dir', `${process.env.CODEHERE_HOME || homedir()}/.codehere/projects`)
     .option('--dry-run', 'Report what migrate WOULD do, write nothing', false)
     .option('--rollback', 'Remove the projects dir; sessions.jsonl untouched', false)
     .option('--keep-temp-dirs', 'Include /tmp + /var/folders cwds (default skips them)', false)

package/dist/infrastructure/cost/budget-config.js

@@ -29,7 +29,7 @@ const DEFAULT_CONFIG = {
     warnAtPct: 70,
 };
 function configFile() {
-    return join(homedir(), '.codehere', 'budget.yaml');
+    return join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'budget.yaml');
 }
 /** Parse a tiny subset of YAML — `key: value` pairs, # comments, blank lines.
  *  No nesting, no lists, no multi-line. Same approach as permissions-config:

package/dist/infrastructure/cost/spend-aggregator.js

@@ -25,7 +25,7 @@ import { join } from 'path';
 /** Resolved at call time, not module load, so test setups that swap $HOME
  *  after import still get a fresh path on each invocation. */
 function sessionsFile() {
-    return join(homedir(), '.codehere', 'sessions.jsonl');
+    return join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'sessions.jsonl');
 }
 /** USD per million OUTPUT tokens at the agent's typical 2026 tier. Input is
  *  estimated at 1/5 of output rate (Anthropic + OpenAI both publish ~5x

package/dist/infrastructure/hooks/claude-sdk-hook.js

@@ -396,8 +396,14 @@ export function calculateRiskScore(findings) {
 /**
  * Audit log path — defaults to ~/.codehere/audit/hook-events.jsonl.
  * Override at process start with CODEHERE_AUDIT_FILE env var (used by tests, optional for users).
+ * Honors CODEHERE_HOME like sessions/config/threads — found via the v1 stranger
+ * walk: an "isolated" daemon (verify-all's :3779, the walk's scratch home) was
+ * writing mock audit entries into the REAL ~/.codehere/audit while verify-all
+ * printed "Real ~/.codehere untouched" (the footer showed 162 entries · 51
+ * agents in a brand-new home — all of them pollution from past mock runs).
  */
-export const AUDIT_FILE = process.env.CODEHERE_AUDIT_FILE || join(homedir(), '.codehere', 'audit', 'hook-events.jsonl');
+export const AUDIT_FILE = process.env.CODEHERE_AUDIT_FILE ||
+    join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'audit', 'hook-events.jsonl');
 const GENESIS_PREV_HASH = '0'.repeat(64);
 /**
  * Canonicalize an audit entry for hashing. We sort keys alphabetically and

package/dist/infrastructure/orchestration/agents-config-seed.js

@@ -15,7 +15,7 @@
 import { existsSync, mkdirSync, writeFileSync } from 'fs';
 import { homedir } from 'os';
 import { join, dirname } from 'path';
-const CONFIG_PATH = join(homedir(), '.codehere', 'agents.yaml');
+const CONFIG_PATH = join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'agents.yaml');
 const DEFAULT_YAML = `# codehere — pluggable agent adapters
 #
 # Built-in adapters (no configuration needed — just install the CLI):

package/dist/infrastructure/orchestration/cassette-recorder.js

@@ -38,7 +38,7 @@ const NULL_RECORDER = {
 export function startRecording(opts) {
     if (process.env[ENV_FLAG] !== '1')
         return NULL_RECORDER;
-    const outDir = opts.outDir ?? join(homedir(), '.codehere', 'cassettes', opts.adapter);
+    const outDir = opts.outDir ?? join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'cassettes', opts.adapter);
     const scenario = `organic-${opts.sessionId.slice(0, 8)}`;
     const stamp = new Date().toISOString().replace(/[:.]/g, '-');
     const path = join(outDir, `${scenario}-${stamp}.jsonl`);

package/dist/infrastructure/orchestration/failover-config.js

@@ -23,7 +23,7 @@ import { readFileSync, existsSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
 import { validateFailoverChain } from './failover-policy.js';
-const GLOBAL_CONFIG_PATH = join(homedir(), '.codehere', 'config.json');
+const GLOBAL_CONFIG_PATH = join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'config.json');
 /**
  * Load failover configuration from ~/.codehere/config.json.
  * Returns undefined if the config file does not exist or has no failover section.

package/dist/infrastructure/orchestration/generic-cli-adapter.js

@@ -38,8 +38,8 @@ import { randomUUID } from 'crypto';
 import { ProgressAggregator } from './progress-aggregator.js';
 import { snapshotCwd, extractArtifacts } from './artifacts-extractor.js';
 import { applyMemoryPrefix } from './memory-injector.js';
-const CONFIG_PATH = join(homedir(), '.codehere', 'agents.yaml');
-const CONFIG_PATH_JSON = join(homedir(), '.codehere', 'agents.json');
+const CONFIG_PATH = join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'agents.yaml');
+const CONFIG_PATH_JSON = join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'agents.json');
 /** Minimal YAML parser for the narrow shape above. Intentionally NOT a full YAML
  *  parser — avoids dragging in a dep. Handles: `key: value`, lists with `- key: val`,
  *  nested lists of simple strings via `[a, b]`, comments after `#`. Errors loud.

package/dist/infrastructure/orchestration/memory-injector.js

@@ -279,8 +279,11 @@ export function buildMemoryPrefix(projectRoot, options = {}) {
  *
  * Stops at the filesystem root. Symlink-following on read is the right
  * asymmetry per ADR-012 (the symlink defense applies to writes, not reads).
+ *
+ * Exported for the daemon's /api/memory/status route (the room's init nudge
+ * must report the SAME readiness the injector itself would act on).
  */
-function findProjectRoot(startPath) {
+export function findProjectRoot(startPath) {
     let current;
     try {
         current = realpathSync(resolve(startPath));

package/dist/infrastructure/orchestration/mocks/mock-agent-repl.js

@@ -194,7 +194,10 @@ async function runOpencode() {
         out({ type: 'tool_use', part: { tool, state: { input: s.input, output: s.result, status: 'completed' } } });
     }
     await sleep(120);
-    out({ type: 'text', text: 'Completed (mock): ' + prompt });
+    // Real opencode carries narrative text in part.text (the adapter's summary
+    // extraction and the aggregator's say capture both read that shape) — the
+    // prior top-level `text` field was mock drift no real parser ever saw.
+    out({ type: 'text', part: { text: 'Completed (mock): ' + prompt } });
 }
 async function main() {
     if (!prompt)

package/dist/infrastructure/orchestration/progress-aggregator.js

@@ -169,6 +169,14 @@ export class ProgressAggregator {
     // real gap surfaced by the mock harness). Build a step on the terminal
     // (status==='completed') event so opencode is a first-class agent.
     ingestOpencode(type, data) {
+        // OpenCode's narrative text rides `text` events with part.text (the same
+        // shape the adapter's summary extraction reads) — cross-vendor say capture
+        // per the v1 spec, so opencode's Final Report stops degrading to the
+        // deterministic fallback.
+        if (type === 'text') {
+            const part = (data.part ?? {});
+            return this.pushSay(String(part.text ?? ''));
+        }
         if (type !== 'tool_use')
             return false;
         const part = (data.part ?? {});
@@ -213,6 +221,24 @@ export class ProgressAggregator {
         const idx = this._steps.push({ label, state, startedAt: Date.now() }) - 1;
         return idx;
     }
+    /** The agent's own narration as a kind:'say' step — the "watch it work"
+     *  signal AND what the Final Report engine reuses as the summary. Cross-
+     *  vendor by decision of the v1 spec (the room thread is "tool steps woven
+     *  with the agent's plain-English narration" — for every agent, not just
+     *  claude/aider). Same 500-char cap as the original claude capture. */
+    pushSay(text) {
+        const said = String(text ?? '').trim();
+        if (!said)
+            return false;
+        this._steps.push({
+            kind: 'say',
+            label: said.length > 500 ? said.slice(0, 500) + '\\u2026' : said,
+            state: 'done',
+            startedAt: Date.now(),
+            completedAt: Date.now(),
+        });
+        return true;
+    }
     ingestClaude(type, data) {
         if (type === 'assistant') {
             const msg = (data.message ?? {});
@@ -322,6 +348,12 @@ export class ProgressAggregator {
                 return true;
             }
         }
+        // Gemini's narrative text rides `content` events — same cross-vendor say
+        // capture as claude/aider/codex (v1 spec: narration woven into the thread,
+        // and the Final Report engine reuses it as the summary).
+        if (type === 'content' && typeof data.text === 'string') {
+            return this.pushSay(data.text);
+        }
         return false;
     }
     /**
@@ -642,12 +674,15 @@ export class ProgressAggregator {
             });
             return true;
         }
-        // NOTE (mock-currency 2026-06-02): codex `agent_message` is intentionally NOT
-        // captured here — a prior decision (pm-layers.test.ts "just chatter, not a
-        // step") drops it. This is INCONSISTENT with ingestClaude/ingestAider, which
-        // DO capture agent narration as kind:'say' (per #45 + A1 "watch it work").
-        // Resolving that inconsistency is a product taste call → flagged for Ega in
-        // mock-currency-2026-06-02.md, not changed unilaterally by the autonomous loop.
+        // agent_message = codex's own narration. Captured as kind:'say' since the
+        // v1 spec settled the taste call that used to be flagged here (pm-layers
+        // "just chatter" decision): the room thread is "tool steps woven with the
+        // agent's plain-English narration" for EVERY vendor, and the Final Report
+        // engine reuses 'say' steps as the summary — without this, codex always
+        // degraded to the deterministic fallback.
+        if (itemType === 'agent_message') {
+            return this.pushSay(String(item.text ?? ''));
+        }
         return false;
     }
 }

package/dist/infrastructure/protocols/cloud-sync.js

@@ -16,8 +16,8 @@ import { readFileSync, existsSync, writeFileSync, mkdirSync } from 'fs';
 import { join, dirname } from 'path';
 import { homedir, hostname } from 'os';
 const CLOUD_URL = 'https://codehere.uk/api/sync';
-const TOKEN_PATH = join(homedir(), '.codehere', 'cloud-token');
-const SESSIONS_FILE = join(homedir(), '.codehere', 'sessions.jsonl');
+const TOKEN_PATH = join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'cloud-token');
+const SESSIONS_FILE = join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'sessions.jsonl');
 // Lazy-loaded session manager — imported once to avoid circular deps
 let _sessionManager = null;
 async function getSessionManager() {

package/dist/infrastructure/protocols/mcp-server-impl.js

@@ -46,6 +46,8 @@ import { begin as oauthBegin, complete as oauthComplete, getProvider as getOAuth
 import { saveToken, clearToken, connectionStatus } from '../context/oauth-store.js';
 import { SessionManager, availableAgents, readinessForAllAgents, getAdapter, allAdapters, } from '../orchestration/session-manager.js';
 import { isAbsolute } from 'path';
+import { findProjectRoot } from '../orchestration/memory-injector.js';
+import { scaffoldProjectAt } from '../../presentation/cli/commands/init-command.js';
 import { readCrossToolAgents } from '../storage/cross-tool-agents.js';
 import { listProjects, readProjectThread } from '../storage/project-thread-reader.js';
 import { mirrorReplyToThread, renameProject } from '../storage/project-thread-mirror.js';
@@ -545,7 +547,7 @@ export function startMCPServer(options = {}) {
         // Tails sessions.jsonl and pushes "change" events so the /v2 UI can
         // re-fetch task state instantly instead of waiting 8s for the next poll.
         // Same pattern as /events (audit log tail) but for sessions.
-        const SESSIONS_FILE = join(homedir(), '.codehere', 'sessions.jsonl');
+        const SESSIONS_FILE = join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'sessions.jsonl');
         if (req.method === 'GET' && req.url === '/api/events/sessions') {
             res.writeHead(200, {
                 'Content-Type': 'text/event-stream',
@@ -1211,6 +1213,66 @@ export function startMCPServer(options = {}) {
             }
             return;
         }
+        // ── v1 project-memory routes (the room's init nudge) ─────────────────────
+        // Found by the stranger walk: web-only users never run `codehere init`, so
+        // the spec's "agent remembers the project" half of nothing-lost silently
+        // doesn't apply. Status reports the SAME readiness the injector acts on
+        // (shared findProjectRoot); init runs the SAME hardened scaffold the CLI
+        // does (shared scaffoldProjectAt — symlink defenses included).
+        if (req.method === 'GET' && req.url?.startsWith('/api/memory/status')) {
+            try {
+                const u = new URL(req.url, `http://${req.headers.host || '127.0.0.1'}`);
+                const cwd = u.searchParams.get('cwd') || '';
+                if (!cwd || !isAbsolute(cwd) || cwd.includes('\0')) {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'cwd (absolute path) required' }));
+                    return;
+                }
+                const root = findProjectRoot(cwd);
+                const ready = !!root && existsSync(join(root, '.codehere', 'memory', 'working'));
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ready, projectRoot: root }));
+            }
+            catch (e) {
+                res.writeHead(500, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'memory_status_failed', detail: String(e) }));
+            }
+            return;
+        }
+        if (req.method === 'POST' && req.url === '/api/memory/init') {
+            (async () => {
+                try {
+                    const body = await readBody(req, res);
+                    let cwd = '';
+                    try {
+                        cwd = String(JSON.parse(body || '{}').cwd || '');
+                    }
+                    catch {
+                        /* falls through to the validation below */
+                    }
+                    if (!cwd || !isAbsolute(cwd) || cwd.includes('\0') || !existsSync(cwd) || !statSync(cwd).isDirectory()) {
+                        res.writeHead(400, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ error: 'cwd (absolute path to an existing directory) required' }));
+                        return;
+                    }
+                    const r = scaffoldProjectAt(cwd);
+                    if (!r.ok) {
+                        res.writeHead(409, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ ok: false, reason: r.reason }));
+                        return;
+                    }
+                    res.writeHead(200, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ ok: true, created: r.created.length, skipped: r.skipped.length, refused: r.refused.length + r.refusedDirs.length }));
+                }
+                catch (e) {
+                    res.writeHead(500, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'memory_init_failed', detail: String(e) }));
+                }
+            })().catch(() => {
+                /* handled above — keep the route from rejecting unhandled */
+            });
+            return;
+        }
         // ── v0.6.0 M1 project thread routes ──────────────────────────────────────
         // GET /api/projects           — list all known projects (slug, cwd, title, taskCount, lastActivityAt)
         // GET /api/projects/:slug     — single project thread (meta + tasks merged by sessionId)

package/dist/infrastructure/protocols/ui-page-v2.js

@@ -662,6 +662,23 @@ const SHARED_STYLES = `
   .audit-line b { color: var(--fg-90); font-weight: 600; }
   .audit-line code { background: hsl(0 0% 9%); padding: 1px 5px; border-radius: 3px; color: var(--fg-70); }
 
+  /* project-memory nudge · same quiet family as .audit-line (trust present-
+     but-quiet); .on = the post-click confirmation state */
+  .mem-nudge {
+    font-family: var(--mono); font-size: 10.5px; color: var(--fg-40);
+    padding: 6px 12px; margin: 8px 0;
+    background: rgba(0,0,0,0.2);
+    border-left: 2px solid var(--border); border-radius: 3px;
+    line-height: 1.55;
+  }
+  .mem-nudge .mem-btn {
+    background: none; border: 1px solid var(--border); border-radius: 4px;
+    color: var(--fg-70); font-family: var(--mono); font-size: 10.5px;
+    padding: 2px 8px; cursor: pointer; margin-left: 4px;
+  }
+  .mem-nudge .mem-btn:hover { border-color: var(--accent); color: var(--fg); }
+  .mem-nudge.on { border-left-color: rgba(40,200,64,0.4); color: var(--fg-70); }
+
   /* auditor persona · audit-chain + verifier + hook-badges amplified,
      summary muted (per demo v12 line 2462: "amplify audit-lines +
      hook-badges + trust-grades") */
@@ -1545,8 +1562,9 @@ const SHARED_STYLES = `
   .input-ta::placeholder { color: var(--fg-40); }
   .input-ta:disabled { color: var(--fg-30); }
   .input-meta { font-family: var(--mono); font-size: 10px; color: var(--fg-40); white-space: nowrap; display: inline-flex; gap: 8px; align-items: center; }
-  .input-meta .pick-agent { color: var(--fg-70); cursor: pointer; padding: 2px 6px; border-radius: 3px; transition: background 0.15s; }
+  .input-meta .pick-agent { color: var(--fg-70); cursor: pointer; padding: 2px 6px; border-radius: 3px; transition: background 0.15s; background: transparent; border: none; font: inherit; -webkit-appearance: none; appearance: none; }
   .input-meta .pick-agent:hover { background: rgba(255,255,255,0.05); color: var(--fg); }
+  .input-meta select.pick-agent option { background: var(--bg-2, #1a1a1f); color: var(--fg); }
   .input-meta .cost-est { color: var(--allow); padding: 2px 6px; border-radius: 3px; background: rgba(40,200,64,0.06); }
   .send-btn {
     background: var(--accent); color: #000; border: none; border-radius: 6px;
@@ -1567,6 +1585,10 @@ const SHARED_STYLES = `
 const APP_SCRIPT = `
 const _cached = {};
 let _filter = 'all', _detail = null, _room = null, _offline = false, _autoOpened = false;
+// Project-memory state for the open room · null = unknown (fetch in flight),
+// false = agents forget this project (show the nudge), true = memory already
+// on (stay quiet), 'just-on' = turned on from the nudge this visit (confirm).
+let _roomMemory = null;
 const ICONS = { queued:'\\u23F3', running:'\\u25CF', paused:'\\u23F8', blocked:'\\uD83D\\uDD12', done:'\\u2713', failed:'\\u2715', crashed:'!', killed:'\\u2298' };
 const STAT_ORDER = ['running','queued','paused','blocked','done','failed','crashed','killed'];
 const FILTERS = { all: s=>true, running: s=>['running','queued','paused','blocked'].includes(s.status), done: s=>['done','completed'].includes(s.status), failed: s=>['failed','crashed','killed','error'].includes(s.status) };
@@ -1733,12 +1755,48 @@ function render() {
 // agent turns. Renders into #task-list (same surface as the goals list).
 function openRoom(enc){
   _room=decodeURIComponent(enc||''); _detail=null;
+  // Project-memory status for the nudge — fetched once per entry from the
+  // daemon (the SAME readiness the injector acts on, not a guess).
+  _roomMemory=null;
+  (function(forCwd){
+    fetch('/api/memory/status?cwd='+encodeURIComponent(forCwd)).then(x=>x.json()).then(j=>{
+      if(_room===forCwd){ _roomMemory=!!j.ready; render(); }
+    }).catch(()=>{});
+  })(_room);
   document.getElementById('task-list-view').style.display='';
   document.getElementById('task-detail-view').style.display='none';
   document.body.classList.remove('detail-open');
+  // Hand-off affordance: inside a room the composer targets THIS goal (cwd is
+  // pinned in submit) and the picker defaults to whoever worked it last —
+  // continuing is zero clicks, handing to a different agent is one visible
+  // click. Set once on entry (not in renderRoom, which re-runs every poll and
+  // would stomp the user's choice).
+  const ta=document.getElementById('main-ta');
+  if(ta) ta.placeholder='Add the next task in this goal\\u2026 any agent picks up where the last one left off';
+  const ap=document.getElementById('agent-pick');
+  if(ap){
+    const turns=allS(_cached.tasks||{}).filter(x=>!/^demo-/.test(x.sessionId||'')&&(x.cwd||'')===_room&&x.agent).sort((a,b)=>(a.startedAt||0)-(b.startedAt||0));
+    const raw=turns.length?String(turns[turns.length-1].agent):'';
+    ap.value=['claude-code','codex','aider','gemini','opencode'].indexOf(raw)>=0?raw:'auto';
+  }
+  render();
+}
+function closeRoom(){
+  _room=null; _roomMemory=null;
+  const ta=document.getElementById('main-ta');
+  if(ta) ta.placeholder='Describe a task or ask a question...';
+  const ap=document.getElementById('agent-pick'); if(ap) ap.value='auto';
   render();
 }
-function closeRoom(){ _room=null; render(); }
+async function initRoomMemory(btn){
+  if(!_room) return;
+  if(btn){ btn.disabled=true; btn.textContent='turning on\\u2026'; }
+  try{
+    const r=await fetch('/api/memory/init',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({cwd:_room})});
+    if(r.ok){ _roomMemory='just-on'; render(); }
+    else { const e=await r.json().catch(()=>({})); al('Could not turn on memory: '+(e.error||e.reason||'unknown')); if(btn){btn.disabled=false;btn.textContent='turn on project memory';} }
+  }catch(e){ al('Network error: '+e.message); if(btn){btn.disabled=false;btn.textContent='turn on project memory';} }
+}
 function renderRoom(){
   const c=document.getElementById('task-list');
   const _hs=document.getElementById('host-sessions-strip'); if(_hs){ _hs.style.display='none'; }
@@ -1769,6 +1827,16 @@ function renderRoom(){
   } else {
     html+='<div class="empty-state"><h2>No tasks in this goal yet.</h2></div>';
   }
+  // Project-memory nudge (stranger-walk finding 2026-06-06): web-only users
+  // never run codehere-init, so agents silently get NO memory of the
+  // project. Honest + quiet: rendered ONLY when the daemon says memory is
+  // off; the confirmation says "from the next task" because injection
+  // happens at spawn — no fake instant effect.
+  if(_roomMemory===false){
+    html+='<div class="mem-nudge">&#129504; agents forget this project between runs \\u00b7 <button class="mem-btn" onclick="initRoomMemory(this)">turn on project memory</button></div>';
+  } else if(_roomMemory==='just-on'){
+    html+='<div class="mem-nudge on">\\u2713 project memory is on \\u2014 agents will remember this project from the next task</div>';
+  }
   c.innerHTML=html;
 }
 
@@ -1852,14 +1920,11 @@ function renderL() {
   const esc=s=>String(s==null?'':s).replace(/[&<>"]/g,ch=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;'}[ch]));
   const fl=all.filter(FILTERS[_filter]||FILTERS.all);
   let html='';
-  // Pin demo-shape sessions (id prefix 'demo-') to the very top — they
-  // exist to demonstrate what the product does · always relevant.
+  // Demo-shape sessions (id prefix 'demo-') render AFTER the goals — they
+  // demonstrate the product, but the home leads with YOUR goals (spec:
+  // "Home is a list of your goals"; demos were burying it).
   const demo=fl.filter(x=>/^demo-/.test(x.sessionId||''));
   const rest=fl.filter(x=>!/^demo-/.test(x.sessionId||''));
-  if(demo.length){
-    html+='<div class="section-label featured">Featured</div>';
-    for(const t of demo) html+=cardH(t);
-  }
   // Goal-first home: group the rest by project (the goal/room), not by status.
   // cwd → project title (from /api/projects); fall back to the folder name.
   const projects=_cached.projects||[];
@@ -1891,7 +1956,7 @@ function renderL() {
     g.items.sort((a,b)=>(b.startedAt||0)-(a.startedAt||0));
     const running=g.items.filter(x=>['running','queued','paused','blocked'].includes(x.status)).length;
     const meta=g.items.length+' task'+(g.items.length===1?'':'s')+(running?' · '+running+' running':'');
-    html+='<div class="goal-group"><div class="goal-head" onclick="openRoom(\\''+encodeURIComponent(g.cwd||'')+'\\')"><span class="goal-title">'+esc(titleFor(g.cwd))+'</span><span class="goal-meta">'+esc(meta)+' \\u00b7 open \\u2192</span></div>';
+    html+='<div class="goal-group"><div class="goal-head" data-goal-cwd="'+encodeURIComponent(g.cwd||'')+'" onclick="openRoom(\\''+encodeURIComponent(g.cwd||'')+'\\')"><span class="goal-title">'+esc(titleFor(g.cwd))+'</span><span class="goal-meta">'+esc(meta)+' \\u00b7 open \\u2192</span></div>';
     // Time-gap separator within a goal · a big gap between consecutive tasks
     // in the same goal is meaningful ("picked this back up 3 days later").
     let prevTs=null;
@@ -1906,6 +1971,10 @@ function renderL() {
     }
     html+='</div>';
   }
+  if(demo.length){
+    html+='<div class="section-label featured">Featured</div>';
+    for(const t of demo) html+=cardH(t);
+  }
   if(!html){
     const h={all:'No goals yet. Type a task below to start one.',running:'No running tasks.',done:'No completed tasks.',failed:'No failed tasks.'};
     html='<div class="empty-state"><h2>'+(h[_filter]||'No tasks found.')+'</h2></div>';
@@ -3316,8 +3385,11 @@ async function fetchAll() {
       if(_all.length){
         _autoOpened=true;
         if(_detail===null){
-          const _act=_all.filter(x=>['running','queued','paused','blocked'].includes(x.status));
-          const _pool=_act.length?_act:_all.slice();
+          // Demos never hijack first load — auto-open is for YOUR work
+          // (a seeded demo stuck on "running" was stealing it · 2026-06-06 walk).
+          const _real=_all.filter(x=>!/^demo-/.test(x.sessionId||''));
+          const _act=_real.filter(x=>['running','queued','paused','blocked'].includes(x.status));
+          const _pool=_act.length?_act:_real.slice();
           _pool.sort((a,b)=>(b.startedAt||0)-(a.startedAt||0));
           const _pick=_pool[0];
           if(_pick&&_pick.sessionId){ showD(_pick.sessionId); }
@@ -3352,7 +3424,20 @@ async function submit(ta,btn,taskId){
     // which is the disabled-composer bug's mirror image: composer enabled but
     // routed wrong.
     const url = taskId ? '/api/task/'+taskId+'/message' : '/api/task';
-    const body = taskId ? JSON.stringify({text:p}) : JSON.stringify({prompt:p});
+    let body;
+    if(taskId){ body=JSON.stringify({text:p}); }
+    else {
+      // Room-aware spawn: typing while a goal room is open adds the task TO
+      // that goal (cwd pinned to the room) — before this, the room composer
+      // silently spawned OUTSIDE the room, the same routing lie as the
+      // follow-up bug above. Agent comes from the visible picker; 'auto'
+      // omits it so the server's conductor default applies unchanged.
+      const payload={prompt:p};
+      if(_room) payload.cwd=_room;
+      const ap=document.getElementById('agent-pick');
+      if(ap&&ap.value&&ap.value!=='auto') payload.agent=ap.value;
+      body=JSON.stringify(payload);
+    }
     const r=await fetch(url,{method:'POST',headers:{'Content-Type':'application/json'},body});
     if(!r.ok){const e=await r.json();al('Failed: '+(e.error||'unknown'));btn.disabled=false;ta.disabled=false;_submitting=false;}else{
       ta.value='';btn.textContent='\\u2713';setTimeout(()=>{btn.textContent='\\u2191';btn.disabled=false;ta.disabled=false;_submitting=false;ta.focus();},1200);
@@ -4129,7 +4214,6 @@ export const TASK_HTML_V2 = `<!doctype html>
 
   <div class="content">
     <div id="task-list-view" class="content-inner">
-      <div id="host-sessions-strip" style="display:none"></div>
       <div id="task-list">
         <div class="skeleton" id="skeleton">
           <div class="skeleton-card"></div>
@@ -4137,6 +4221,10 @@ export const TASK_HTML_V2 = `<!doctype html>
           <div class="skeleton-card"></div>
         </div>
       </div>
+      <!-- Observed host sessions live BELOW the goals: the spec's home is
+           "a list of your goals" — ambient observation must not bury the
+           thesis surface (found burying it during the 2026-06-06 walk). -->
+      <div id="host-sessions-strip" style="display:none"></div>
     </div>
     <div id="task-detail-view" style="display:none" class="content-inner">
       <div id="detail-view"></div>
@@ -4153,7 +4241,7 @@ export const TASK_HTML_V2 = `<!doctype html>
   <div class="input-area">
     <div class="input-bar">
       <textarea class="input-ta composer-bar" id="main-ta" placeholder="Describe a task or ask a question..." rows="1"></textarea>
-      <div class="input-meta composer-meta"><span class="pick-agent" title="Auto-pick · best agent for this task">↳ Auto</span><span class="cost-est" title="Estimated cost · based on prompt length + recent agent pricing">~$0.02</span></div>
+      <div class="input-meta composer-meta"><select class="pick-agent" id="agent-pick" title="Who does this task — Auto picks the best fit" aria-label="Pick the agent for this task"><option value="auto">↳ Auto</option><option value="claude-code">claude-code</option><option value="codex">codex</option><option value="aider">aider</option><option value="gemini">gemini</option><option value="opencode">opencode</option></select><span class="cost-est" title="Estimated cost · based on prompt length + recent agent pricing">~$0.02</span></div>
       <button class="send-btn composer-send" id="main-btn">&#8593;</button>
     </div>
     <div class="kbd-hint">

package/dist/infrastructure/protocols/verify-page.js

@@ -298,6 +298,23 @@ export const VERIFY_HTML = `<!doctype html>
     { id:"F-TASK-CARD", name:"Task card", surface:"list", sel:".task-card", status:"shipped", tier:"v0.7" },
     { id:"F-TIME-GAP-PILL", name:"Brand pill + relative-time sub", surface:"list", sel:".time-gap", status:"shipped", tier:"v0.7" },
     { id:"F-WORKTREE-ALERT", name:"Worktree alert", surface:"list", sel:".worktree-alert", status:"partial", tier:"v0.7" },
+    /* goal-first home + goal room (v1 spec · shared-room hand-off). Goal groups
+       render from REAL non-demo tasks (same data dependency as F-TIME-GAP-PILL);
+       room features are observed by driving the REAL openRoom() on the first
+       goal-head's data-goal-cwd, then closeRoom() — same pattern as showD(). */
+    { id:"F-GOAL-GROUP", name:"Goal-first home · tasks grouped by goal", surface:"list", sel:".goal-group", status:"shipped", tier:"v1" },
+    { id:"F-GOAL-HEAD-OPEN", name:"Goal head opens its room (carries cwd)", surface:"list", sel:".goal-head[data-goal-cwd]", status:"shipped", tier:"v1" },
+    { id:"F-AGENT-PICK", name:"Composer agent picker (Auto + 5 agents)", surface:"list", sel:"select#agent-pick", status:"shipped", tier:"v1" },
+    /* room selectors are scoped to #task-list: the hidden detail view's DOM
+       persists (display:none still matches querySelectorAll) and also has an
+       .audit-line — unscoped, a dead room would false-OBSERVE off it. */
+    { id:"F-ROOM-HEAD", name:"Goal room header (title + outcome sub)", surface:"room", sel:"#task-list .room-head .room-title", status:"shipped", tier:"v1" },
+    { id:"F-ROOM-BACK", name:"Room back-to-all-goals affordance", surface:"room", sel:"#task-list .room-back", status:"shipped", tier:"v1" },
+    { id:"F-ROOM-TURNS", name:"Turns in order (how agents worked the goal)", surface:"room", sel:"#task-list .turns-label", status:"partial", tier:"v1" },
+    { id:"F-ROOM-AUDIT", name:"Room audit line (steps in local chain)", surface:"room", sel:"#task-list .audit-line", status:"partial", tier:"v1" },
+    /* partial by nature: renders ONLY when the daemon reports project memory
+       OFF for the opened room (initialized projects correctly show nothing). */
+    { id:"F-ROOM-MEM-NUDGE", name:"Project-memory init nudge (turn on memory)", surface:"room", sel:"#task-list .mem-nudge", status:"partial", tier:"v1" },
     { id:"M-OVERLAY-LINEAR", name:"Overlay-renderer Linear", surface:"list", sel:".or-overlay", status:"shipped", tier:"v0.9" },
     { id:"M-PRIMITIVES-NOTE", name:"Primitives note", surface:"list", sel:".primitives-note .prims .p", status:"shipped", tier:"v0.8" },
     { id:"M-RESHAPE-AGENT-COMPOSE", name:"Agent-compose animation", surface:"list", sel:".agent-compose .line", status:"shipped", tier:"v0.8" },
@@ -651,6 +668,31 @@ export const VERIFY_HTML = `<!doctype html>
           });
         });
       }, Promise.resolve());
+    }).then(function(){
+      // room-surface features · drive the REAL openRoom() (same pattern as
+      // showD above) on the first goal-head's data-goal-cwd, observe, close.
+      // No goal-head on the home = no real tasks; the room genuinely cannot
+      // be opened, so room features go MISSING/PARTIAL-GAP per their status —
+      // honest, and F-GOAL-GROUP fails alongside so the cause is visible.
+      var room = FEATURES.filter(function(f){ return f.surface==="room" && f.status!=="roadmap" && f.status!=="future"; });
+      if (!room.length) return;
+      var w0 = frameWin();
+      var gh = frameDoc().querySelector(".goal-head[data-goal-cwd]");
+      var check = function(){
+        var d = frameDoc();
+        room.forEach(function(f){
+          var present = d.querySelectorAll(f.sel).length > 0;
+          var r = { id:f.id, present:present, verdict:covVerdict(f, present) };
+          covResults.push(r); paintCov(r);
+        });
+      };
+      if (!gh){ check(); return; }
+      try { w0.openRoom(gh.getAttribute("data-goal-cwd")); } catch(e){}
+      return sleep(200).then(function(){
+        check();
+        try { if (w0.closeRoom) w0.closeRoom(); } catch(e){}
+        return sleep(120);
+      });
     }).then(function(){
       // roadmap / future: SKIP (correctly absent), no observation
       FEATURES.filter(function(f){ return f.status==="roadmap" || f.status==="future"; }).forEach(function(f){

package/dist/infrastructure/storage/project-thread-mirror.js

@@ -31,7 +31,7 @@ import { existsSync, mkdirSync, appendFileSync, readFileSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
 import { createHash } from 'crypto';
-const PROJECTS_DIR = join(homedir(), '.codehere', 'projects');
+const PROJECTS_DIR = join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'projects');
 /** Match migration module's defaults. Same regex set kept in sync. */
 const TEMP_DIR_PATTERNS = [/^\/tmp\//, /^\/var\/folders\//, /^\/private\/var\/folders\//, /^\/private\/tmp\//];
 function isTempDir(cwd) {

package/dist/infrastructure/storage/project-thread-reader.js

@@ -21,7 +21,7 @@
 import { existsSync, readFileSync, readdirSync, statSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
-const DEFAULT_PROJECTS_DIR = join(homedir(), '.codehere', 'projects');
+const DEFAULT_PROJECTS_DIR = join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'projects');
 /** List all known projects with summary stats. Cheap; no full task content. */
 export function listProjects(options) {
     const root = options?.projectsDir ?? DEFAULT_PROJECTS_DIR;

package/dist/infrastructure/storage/project-thread-title-backfill.js

@@ -24,7 +24,7 @@ import { existsSync, readdirSync, readFileSync, appendFileSync, statSync } from
 import { join } from 'path';
 import { homedir } from 'os';
 import { generateThreadTitle } from '../../application/use-cases/generate-thread-title.js';
-const DEFAULT_PROJECTS_DIR = join(homedir(), '.codehere', 'projects');
+const DEFAULT_PROJECTS_DIR = join(process.env.CODEHERE_HOME || homedir(), '.codehere', 'projects');
 function scanThread(slug, file) {
     let title = null;
     let firstPrompt = null;

package/dist/presentation/cli/commands/init-command.js

@@ -430,69 +430,81 @@ function writeTemplate(codehereDir, tmpl, force) {
     writeFileSync(target, tmpl.body);
     return 'created';
 }
+export function scaffoldProjectAt(root, options = {}) {
+    const codehereDir = join(root, '.codehere');
+    const empty = { created: [], skipped: [], refused: [], refusedDirs: [] };
+    const noEpisodic = { result: 'failed', sourcePath: '', targetPath: '' };
+    // Refuse if .codehere itself is a symlink — would redirect every subsequent write.
+    if (existsSync(codehereDir) && isSymlink(codehereDir)) {
+        return { ok: false, reason: 'codehere-dir-is-symlink', ...empty, episodic: noEpisodic, gitignore: { result: 'skipped' } };
+    }
+    if (!existsSync(codehereDir)) {
+        mkdirSync(codehereDir, { recursive: true });
+    }
+    else if (!statSync(codehereDir).isDirectory()) {
+        return { ok: false, reason: 'codehere-not-a-directory', ...empty, episodic: noEpisodic, gitignore: { result: 'skipped' } };
+    }
+    // F3 layout: ensure all directories exist before writing any seeds.
+    // Per-segment symlink check on EACH directory's ancestors; if .codehere/memory
+    // (or skills, or protocols, etc.) is a symlink, refuse to mkdir into it.
+    const refusedDirs = [];
+    for (const dir of F3_DIRECTORIES) {
+        const offending = findSymlinkAncestor(codehereDir, dir);
+        const fullPath = join(codehereDir, dir);
+        if (offending !== null || isSymlink(fullPath)) {
+            refusedDirs.push(dir);
+            continue;
+        }
+        mkdirSync(fullPath, { recursive: true });
+    }
+    const created = [];
+    const skipped = [];
+    const refused = [];
+    // v0.4.1 templates first (CONTEXT/HANDOVER/PROMPTS at the top level).
+    for (const tmpl of TEMPLATES) {
+        const outcome = writeTemplate(codehereDir, tmpl, !!options.force);
+        if (outcome === 'created')
+            created.push(tmpl.filename);
+        else if (outcome === 'skipped')
+            skipped.push(tmpl.filename);
+        else
+            refused.push(tmpl.filename);
+    }
+    // F3 v0.5 seed files (memory layers + skills + protocols).
+    for (const tmpl of F3_TEMPLATES) {
+        const outcome = writeTemplate(codehereDir, tmpl, !!options.force);
+        if (outcome === 'created')
+            created.push(tmpl.filename);
+        else if (outcome === 'skipped')
+            skipped.push(tmpl.filename);
+        else
+            refused.push(tmpl.filename);
+    }
+    // F3 Task 3 — episodic AGENT_LEARNINGS.jsonl symlink to user's session log.
+    const episodic = ensureEpisodicSymlink(codehereDir, resolveHome());
+    const gitignore = options.noGitignore ? { result: 'skipped' } : ensureGitignore(root);
+    return { ok: true, created, skipped, refused, refusedDirs, episodic, gitignore };
+}
 export function executeInitCommand(options = {}) {
     try {
         const { root, type } = resolveTargetRoot();
-        const codehereDir = join(root, '.codehere');
         newline();
         console.log(colors.bold('codehere init'));
         console.log(colors.dim(`  scaffolding .codehere/ at ${type} root: ${root}`));
         newline();
-        // Refuse if .codehere itself is a symlink — would redirect every subsequent write.
-        if (existsSync(codehereDir) && isSymlink(codehereDir)) {
-            console.log(`  ${error('refused')} .codehere is a symlink — refusing to follow. Remove it first.`);
+        const r = scaffoldProjectAt(root, options);
+        if (!r.ok) {
+            if (r.reason === 'codehere-dir-is-symlink') {
+                console.log(`  ${error('refused')} .codehere is a symlink — refusing to follow. Remove it first.`);
+            }
+            else {
+                console.log(`  ${error('refused')} .codehere exists but is not a directory.`);
+            }
             newline();
             process.exitCode = 1;
             return;
         }
-        if (!existsSync(codehereDir)) {
-            mkdirSync(codehereDir, { recursive: true });
-        }
-        else {
-            const codehereStat = statSync(codehereDir);
-            if (!codehereStat.isDirectory()) {
-                console.log(`  ${error('refused')} .codehere exists but is not a directory.`);
-                newline();
-                process.exitCode = 1;
-                return;
-            }
-        }
-        // F3 layout: ensure all directories exist before writing any seeds.
-        // Per-segment symlink check on EACH directory's ancestors; if .codehere/memory
-        // (or skills, or protocols, etc.) is a symlink, refuse to mkdir into it.
-        const refusedDirs = [];
-        for (const dir of F3_DIRECTORIES) {
-            const offending = findSymlinkAncestor(codehereDir, dir);
-            const fullPath = join(codehereDir, dir);
-            if (offending !== null || isSymlink(fullPath)) {
-                refusedDirs.push(dir);
-                continue;
-            }
-            mkdirSync(fullPath, { recursive: true });
-        }
-        const created = [];
-        const skipped = [];
-        const refused = [];
-        // v0.4.1 templates first (CONTEXT/HANDOVER/PROMPTS at the top level).
-        for (const tmpl of TEMPLATES) {
-            const outcome = writeTemplate(codehereDir, tmpl, !!options.force);
-            if (outcome === 'created')
-                created.push(tmpl.filename);
-            else if (outcome === 'skipped')
-                skipped.push(tmpl.filename);
-            else
-                refused.push(tmpl.filename);
-        }
-        // F3 v0.5 seed files (memory layers + skills + protocols).
-        for (const tmpl of F3_TEMPLATES) {
-            const outcome = writeTemplate(codehereDir, tmpl, !!options.force);
-            if (outcome === 'created')
-                created.push(tmpl.filename);
-            else if (outcome === 'skipped')
-                skipped.push(tmpl.filename);
-            else
-                refused.push(tmpl.filename);
-        }
+        const { created, skipped, refused, refusedDirs } = r;
         for (const f of created) {
             console.log(`  ${success(`created`)}  .codehere/${f}`);
         }
@@ -506,8 +518,7 @@ export function executeInitCommand(options = {}) {
             console.log(`  ${error(`refused`)} .codehere/${d}/  ${colors.dim('(intermediate symlink — remove it first)')}`);
         }
         // F3 Task 3 — episodic AGENT_LEARNINGS.jsonl symlink to user's session log.
-        const home = resolveHome();
-        const episodic = ensureEpisodicSymlink(codehereDir, home);
+        const episodic = r.episodic;
         switch (episodic.result) {
             case 'created':
                 console.log(`  ${success('linked  ')} .codehere/memory/episodic/AGENT_LEARNINGS.jsonl → ${episodic.targetPath}`);
@@ -529,7 +540,7 @@ export function executeInitCommand(options = {}) {
                 break;
         }
         if (!options.noGitignore) {
-            const gitignoreResult = ensureGitignore(root);
+            const gitignoreResult = r.gitignore;
             newline();
             switch (gitignoreResult.result) {
                 case 'updated':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codehere",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "A PM for your AI coding agents. Delegate, orchestrate, and audit Claude Code, Codex, Aider, OpenCode, Gemini, and any user-configured CLI agent from one local web UI — every AI action traced, every file scored, every spawn warmed with project memory.",
   "main": "dist/index.js",
   "type": "module",