@yeaft/webchat-agent 0.1.854 → 0.1.857

package/{unify → yeaft}/conversation/search.js

@@ -2,46 +2,48 @@
  * search.js — Conversation history search
  *
  * Simple keyword search across hot and cold messages.
- * Reference: yeaft-unify-core-systems.md §4.3
  */
 
 import { existsSync, readdirSync, readFileSync } from 'fs';
 import { join } from 'path';
-import { parseMessage } from './persist.js';
+import { parseMessage, parseSeqFromId } from './persist.js';
 
 /**
  * Search messages in a directory for a keyword.
  *
  * @param {string} dir — messages directory
  * @param {string} keyword — search term (case-insensitive)
- * @param {number} limit — max results
  * @returns {object[]} — matching messages
  */
-function searchDir(dir, keyword, limit) {
+function searchDir(dir, keyword) {
   if (!existsSync(dir)) return [];
 
   const lowerKeyword = keyword.toLowerCase();
   const files = readdirSync(dir)
     .filter(f => f.endsWith('.md'))
     .sort()
-    .reverse(); // newest first
+    .reverse(); // newest first within one directory
 
   const results = [];
   for (const file of files) {
-    if (results.length >= limit) break;
-
     const raw = readFileSync(join(dir, file), 'utf8');
-    if (raw.toLowerCase().includes(lowerKeyword)) {
-      const msg = parseMessage(raw);
-      if (msg) results.push(msg);
-    }
-  }
+    if (!raw.toLowerCase().includes(lowerKeyword)) continue;
 
+    const msg = parseMessage(raw);
+    if (msg) results.push(msg);
+  }
   return results;
 }
 
+function compareNewestFirst(a, b) {
+  const sa = parseSeqFromId(a?.id);
+  const sb = parseSeqFromId(b?.id);
+  if (Number.isFinite(sa) && Number.isFinite(sb) && sa !== sb) return sb - sa;
+  return String(b?.time || '').localeCompare(String(a?.time || ''));
+}
+
 /**
- * Search conversation history (hot + cold) for a keyword.
+ * Search Yeaft history (chat + group + legacy conversation) for a keyword.
  *
  * @param {string} dir — Yeaft root directory (e.g. ~/.yeaft)
  * @param {string} keyword — search term
@@ -51,15 +53,18 @@ function searchDir(dir, keyword, limit) {
 export function searchMessages(dir, keyword, limit = 20) {
   if (!keyword || !keyword.trim()) return [];
 
-  const msgDir = join(dir, 'conversation', 'messages');
-  const coldDir = join(dir, 'conversation', 'cold');
-
-  // Search hot first (more recent), then cold
-  const hotResults = searchDir(msgDir, keyword, limit);
-  const remaining = limit - hotResults.length;
-  const coldResults = remaining > 0
-    ? searchDir(coldDir, keyword, remaining)
-    : [];
+  const dirs = [
+    join(dir, 'chat', 'messages'),
+    join(dir, 'chat', 'cold'),
+    join(dir, 'group', 'messages'),
+    join(dir, 'group', 'cold'),
+    // Compatibility for profiles created before chat/group split.
+    join(dir, 'conversation', 'messages'),
+    join(dir, 'conversation', 'cold'),
+  ];
 
-  return [...hotResults, ...coldResults];
+  return dirs
+    .flatMap(d => searchDir(d, keyword))
+    .sort(compareNewestFirst)
+    .slice(0, limit);
 }

package/{unify → yeaft}/debug-trace.js

@@ -401,7 +401,7 @@ export class DebugTrace {
   }
 
   /**
-   * Fetch the recent debug history for the UnifyDebugPanel. Returns one
+   * Fetch the recent debug history for the YeaftDebugPanel. Returns one
    * record per LLM loop (ordered oldest → newest) with the structured
    * fields the panel expects. JSON columns are parsed; truncated /
    * malformed payloads degrade to null instead of failing the call.

package/{unify → yeaft}/dream-v2/apply.js

@@ -120,12 +120,28 @@ export function targetToScope(target) {
   if (!target || typeof target !== 'string') throw new Error('apply.targetToScope: target required');
   if (target === 'user') return { kind: 'user' };
   const segs = target.split('/').filter(Boolean);
-  const head = segs[0];
-  if (head === 'vp' && segs.length === 2) return { kind: 'vp', id: segs[1] };
-  if (head === 'group' && segs.length === 2) return { kind: 'group', id: segs[1] };
-  if (head === 'feature' && segs.length === 2) return { kind: 'feature', id: segs[1] };
-  if (head === 'topic' && (segs.length === 2 || segs.length === 3)) {
-    return { kind: 'topic', path: segs.slice(1) };
+  // Legacy scopes — explicitly rejected. Old data lives under .legacy/.
+  if (segs[0] === 'vp' || segs[0] === 'feature' || segs[0] === 'topic') {
+    throw new Error(`apply.targetToScope: legacy root scope ${JSON.stringify(target)} rejected — use group/<g>/${segs[0]}/...`);
+  }
+  if (segs[0] === 'group') {
+    if (segs.length === 2) return { kind: 'group', id: segs[1] };
+    // group/<g>/user
+    if (segs.length === 3 && segs[2] === 'user') {
+      return { kind: 'group-user', groupId: segs[1] };
+    }
+    // group/<g>/vp/<v>
+    if (segs.length === 4 && segs[2] === 'vp') {
+      return { kind: 'group-vp', groupId: segs[1], id: segs[3] };
+    }
+    // group/<g>/feature/<f>
+    if (segs.length === 4 && segs[2] === 'feature') {
+      return { kind: 'group-feature', groupId: segs[1], id: segs[3] };
+    }
+    // group/<g>/topic/<l1>[/<l2>]
+    if (segs[2] === 'topic' && (segs.length === 4 || segs.length === 5)) {
+      return { kind: 'group-topic', groupId: segs[1], path: segs.slice(3) };
+    }
   }
   throw new Error(`apply.targetToScope: malformed target ${JSON.stringify(target)}`);
 }
@@ -252,11 +268,12 @@ export async function applyMergedTarget(merged, opts) {
 
 function scopeRelDir(scope) {
   switch (scope.kind) {
-    case 'user':    return 'user';
-    case 'vp':      return `vp/${scope.id}`;
-    case 'group':   return `group/${scope.id}`;
-    case 'feature': return `feature/${scope.id}`;
-    case 'topic':   return `topic/${scope.path.join('/')}`;
+    case 'user':          return 'user';
+    case 'group':         return `group/${scope.id}`;
+    case 'group-user':    return `group/${scope.groupId}/user`;
+    case 'group-vp':      return `group/${scope.groupId}/vp/${scope.id}`;
+    case 'group-feature': return `group/${scope.groupId}/feature/${scope.id}`;
+    case 'group-topic':   return `group/${scope.groupId}/topic/${scope.path.join('/')}`;
     default: throw new Error(`apply.scopeRelDir: unknown kind ${scope.kind}`);
   }
 }

package/{unify → yeaft}/dream-v2/limits.js

@@ -6,7 +6,7 @@
  * callers that want to override one knob without restating the rest.
  *
  * `loadLimitsFromConfig(config)` merges a `~/.yeaft/config.json`
- * `unify.dream` block on top of defaults; unknown keys are ignored,
+ * `yeaft.dream` block on top of defaults; unknown keys are ignored,
  * malformed values fall back to default.
  */
 
@@ -35,12 +35,12 @@ export const DEFAULT_LIMITS = Object.freeze({
 });
 
 /**
- * Merge a config object's `unify.dream` block on top of defaults.
+ * Merge a config object's `yeaft.dream` block on top of defaults.
  * @param {object} [config]
  */
 export function loadLimitsFromConfig(config) {
   const out = { ...DEFAULT_LIMITS };
-  const ud = config && config.unify && config.unify.dream;
+  const ud = config && config.yeaft && config.yeaft.dream;
   if (!ud || typeof ud !== 'object') return out;
   for (const k of Object.keys(out)) {
     if (Object.prototype.hasOwnProperty.call(ud, k)) {

package/{unify → yeaft}/dream-v2/prompts/index.js

@@ -41,8 +41,15 @@ const FILES = {
 export function extractTemplateForScope(scope) {
   if (!scope || typeof scope !== 'string') return 'extractTopic';
   if (scope === 'user') return 'extractUser';
-  if (scope.startsWith('vp/')) return 'extractVp';
+  // Nested group-isolated scopes must be matched BEFORE the bare `group/<g>`
+  // branch so VPs/topics/features under a group don't get the group template.
+  if (/^group\/[^/]+\/vp\//.test(scope)) return 'extractVp';
+  if (/^group\/[^/]+\/topic\//.test(scope)) return 'extractTopic';
+  if (/^group\/[^/]+\/user(?:\/|$)/.test(scope)) return 'extractUser';
   if (scope.startsWith('group/')) return 'extractGroup';
+  // Legacy top-level vp/topic scopes (archived to .legacy/ on boot — kept
+  // here defensively in case something still constructs the old strings).
+  if (scope.startsWith('vp/')) return 'extractVp';
   if (scope.startsWith('topic/')) return 'extractTopic';
   return 'extractTopic';
 }

package/{unify → yeaft}/dream-v2/runner.js

@@ -29,7 +29,7 @@
  *   pruneOldSnapshots()
  *
  *   onProgress emits dream_progress events that the web bridge forwards
- *   as `unify_output` messages so the debug panel can render live state
+ *   as `yeaft_output` messages so the debug panel can render live state
  *  . All events flow through the same channel; no new
  *   WebSocket message type is introduced.
  *
@@ -95,9 +95,14 @@ export async function runDream(opts) {
   const processedGroups = [];
 
   // 2. per-group: skip / segment / triage
-  const topicSummaries = opts.listTopicSummaries
-    ? await safeCall(opts.listTopicSummaries, [])
-    : await defaultListTopicSummaries(opts.root, opts.language).catch(() => []);
+  // Topic summaries are now per-group (group/<g>/topic/...), so resolve
+  // them inside the per-group loop instead of once up front.
+  const resolveTopicSummaries = async (groupId) => {
+    if (opts.listTopicSummaries) {
+      return await safeCall(() => opts.listTopicSummaries(groupId), []);
+    }
+    return await defaultListTopicSummaries(opts.root, groupId, opts.language).catch(() => []);
+  };
 
   for (const groupId of groupIds) {
     // Current-group manual dream passes are the one case where scopeFilter
@@ -152,6 +157,7 @@ export async function runDream(opts) {
 
     let actions;
     try {
+      const topicSummaries = await resolveTopicSummaries(groupId);
       actions = await triageGroupSegments({
         groupId,
         segments,
@@ -304,11 +310,12 @@ async function safeCall(fn, fallback) {
   }
 }
 
-async function defaultListTopicSummaries(root, language) {
+async function defaultListTopicSummaries(root, groupId, language) {
   const all = await listScopes({ root });
   const out = [];
   for (const sc of all) {
-    if (sc.kind !== 'topic') continue;
+    if (sc.kind !== 'group-topic') continue;
+    if (sc.groupId !== groupId) continue;
     const summary = await readSummary(sc, { root, language });
     out.push({ path: sc.path.join('/'), summary });
   }

package/{unify → yeaft}/dream-v2/session-wiring.js

@@ -9,7 +9,7 @@
  * retired (task-710) — the wiring is unconditional.
  *
  * ─────────────────────────────────────────────────────────────────────
- * Wire contract — DreamEvent (consumed by web/components/UnifyDebugPanel.js)
+ * Wire contract — DreamEvent (consumed by web/components/YeaftDebugPanel.js)
  * ─────────────────────────────────────────────────────────────────────
  * The events persisted to trace_events with these event_type values are
  * load-bearing for the debug panel. Renaming a field on this side
@@ -282,7 +282,7 @@ function persistDreamTrace(session, eventType, eventData) {
 /**
  * Create a v2 dream scheduler bound to a session and wire its progress
  * events into the engine's sub-agent event sink (web-bridge translates
- * `dream_progress` into `unify_output` for the debug panel).
+ * `dream_progress` into `yeaft_output` for the debug panel).
  *
  * @param {Object} session
  * @returns {Object}                   — scheduler (start/stop/triggerNow)

package/{unify → yeaft}/dream-v2/triage.js

@@ -62,20 +62,24 @@ export function applyHardRules({ groupId, messages }) {
   const out = new Map();
   const add = (scope) => { if (!out.has(scope)) out.set(scope, { kind: 'update', scope }); };
 
-  // user is always in.
+  // global user is always in.
   add('user');
 
-  // active group, except the virtual _no-group bucket.
-  if (groupId && groupId !== '_no-group') add(`group/${groupId}`);
+  // active group + its per-group user layer, except the virtual _no-group bucket.
+  if (groupId && groupId !== '_no-group') {
+    add(`group/${groupId}`);
+    add(`group/${groupId}/user`);
+  }
 
   for (const m of (messages || [])) {
     if (!m || typeof m !== 'object') continue;
-    // Active VP: any assistant message's vpId.
+    // Active VP: any assistant message's vpId — now group-internal.
     if (m.role === 'assistant') {
       const vp = m.vpId || (m.author && /^vp:(.+)$/.exec(m.author)?.[1]);
-      if (vp && /^[A-Za-z0-9_\-.一-鿿]+$/.test(vp)) add(`vp/${vp}`);
+      if (vp && /^[A-Za-z0-9_\-.一-鿿]+$/.test(vp) && groupId && groupId !== '_no-group') {
+        add(`group/${groupId}/vp/${vp}`);
+      }
     }
-    // (Active feature scope was dropped 2026-05-13 with the Feature system.)
   }
 
   return Array.from(out.values());
@@ -161,8 +165,9 @@ export async function classifySoft({ groupId, messages, topicSummaries, llm, lan
     const path = String(pass2.path || '').trim();
     if (!path) continue;
     const segs = path.split('/').filter(Boolean);
-    if (!isValidTopic({ kind: 'topic', path: segs })) continue;
-    const scope = `topic/${segs.join('/')}`;
+    if (!groupId || groupId === '_no-group') continue;
+    if (!isValidTopic({ kind: 'group-topic', groupId, path: segs })) continue;
+    const scope = `group/${groupId}/topic/${segs.join('/')}`;
     if (pass2.decision === 'match') {
       out.push({ kind: 'update', scope });
     } else if (pass2.decision === 'new') {

package/{unify → yeaft}/effort.js

@@ -1,5 +1,5 @@
 /**
- * effort.js — Scenario → effort decision tree for Unify
+ * effort.js — Scenario → effort decision tree for Yeaft
  *
  * task-327b: given a per-query context (scenario tag, tool-loop depth,
  * user override), pick the thinking/reasoning effort level that should be
@@ -14,7 +14,7 @@
  *
  * Red lines:
  *   • Never error on unknown scenario — default to 'max'.
- *   • Feature flag UNIFY_THINKING_V1 is enforced at the adapter/router
+ *   • Feature flag YEAFT_THINKING_V1 is enforced at the adapter/router
  *     layer; this module just computes the intended value. If the flag
  *     is off, adapters drop it anyway.
  *   • Unsupported models silently drop effort at the router — this

package/{unify → yeaft}/engine.js

@@ -14,7 +14,7 @@
  *
  * Pattern derived from Claude Code's query loop (src/query.ts).
  *
- * Reference: yeaft-unify-implementation-plan.md §3.1, §4 (Phase 2)
+ * Reference: yeaft-yeaft-implementation-plan.md §3.1, §4 (Phase 2)
  */
 
 import { randomUUID } from 'crypto';
@@ -60,7 +60,7 @@ import {
  * task-324 — Turn cap removed.
  *
  * Previously MAX_TURNS=25 broke the query loop out of long tool-driven
- * conversations (user report: Unify loop errored at the cap). The engine
+ * conversations (user report: Yeaft loop errored at the cap). The engine
  * now runs until the LLM itself returns stopReason='end_turn' or a
  * non-retryable error surfaces. Real runaway loops are still bounded by:
  *   • provider rate limits / context window (LLMContextError → compact)
@@ -81,7 +81,7 @@ const MAX_CONTINUE_TURNS = 3;
  * Content is passed through verbatim — never truncated. Debug traces must
  * mirror exactly what we sent to the LLM; a truncated copy is misleading.
  * If the resulting payload is too large for the client debug store the
- * bound is per-loop-count (see `MAX_UNIFY_DEBUG_LOOPS` in
+ * bound is per-loop-count (see `MAX_YEAFT_DEBUG_LOOPS` in
  * `web/stores/chat.js`), not per-payload mutilation here.
  *
  * Pure function — no side effects on the input message.
@@ -569,8 +569,8 @@ export class Engine {
       groupId
         ? readScopeSummary({ kind: 'group', id: groupId }, { root: memoryRoot, language }).catch(() => '')
         : Promise.resolve(''),
-      vpId
-        ? readScopeSummary({ kind: 'vp', id: vpId }, { root: memoryRoot, language }).catch(() => '')
+      vpId && groupId
+        ? readScopeSummary({ kind: 'group-vp', groupId, id: vpId }, { root: memoryRoot, language }).catch(() => '')
         : Promise.resolve(''),
     ];
     const [user, group, vp] = await Promise.all(tasks);
@@ -790,7 +790,7 @@ export class Engine {
       // Worker-shape harness is descriptive metadata for human inspection;
       // production prompts skip it to save tokens. Re-enable via env when
       // diagnosing prompt structure issues.
-      includeShape: process.env.UNIFY_PROMPT_INCLUDE_SHAPE === '1',
+      includeShape: process.env.YEAFT_PROMPT_INCLUDE_SHAPE === '1',
     });
   }
 
@@ -888,9 +888,9 @@ export class Engine {
       // ViewImage (task-333b PR-B rev-3 P1-A): expose size cap + allowlist
       // via tool ctx so hosts can override via ~/.yeaft/config.json without
       // touching the tool impl.
-      maxImageBytes: this.#config?.unify?.maxImageBytes,
-      imageAllowlist: Array.isArray(this.#config?.unify?.imageAllowlist)
-        ? this.#config.unify.imageAllowlist
+      maxImageBytes: this.#config?.yeaft?.maxImageBytes,
+      imageAllowlist: Array.isArray(this.#config?.yeaft?.imageAllowlist)
+        ? this.#config.yeaft.imageAllowlist
         : [],
       // Bug 4 fix — VP / routing context for RouteForward (and any other
       // VP-aware tool). Undefined when running in non-group / no-VP flows.
@@ -2735,7 +2735,7 @@ export class Engine {
   /**
    * Run a one-shot fast-model call to produce a compact summary.
    * Used by the web bridge's in-memory history compactor
-   * (`agent/unify/history-compact.js`) — kept on the engine so callers
+   * (`agent/yeaft/history-compact.js`) — kept on the engine so callers
    * don't reach into the private adapter field.
    *
    * @param {{system: string, prompt: string, maxTokens?: number}} args

package/{unify → yeaft}/eval/run-eval.js

@@ -5,22 +5,22 @@
  *
  * Usage:
  *   # Run all evals against default model (requires API key)
- *   node agent/unify/eval/run-eval.js
+ *   node agent/yeaft/eval/run-eval.js
  *
  *   # Run specific suite
- *   node agent/unify/eval/run-eval.js --suite tools
+ *   node agent/yeaft/eval/run-eval.js --suite tools
  *
  *   # Compare multiple models
- *   node agent/unify/eval/run-eval.js --models claude-sonnet-4-20250514,gpt-5
+ *   node agent/yeaft/eval/run-eval.js --models claude-sonnet-4-20250514,gpt-5
  *
  *   # Save baseline
- *   node agent/unify/eval/run-eval.js --save-baseline initial
+ *   node agent/yeaft/eval/run-eval.js --save-baseline initial
  *
  *   # Compare against baseline
- *   node agent/unify/eval/run-eval.js --compare-baseline baselines/initial.json
+ *   node agent/yeaft/eval/run-eval.js --compare-baseline baselines/initial.json
  *
  *   # Dry run (MockAdapter, no API calls)
- *   node agent/unify/eval/run-eval.js --dry-run
+ *   node agent/yeaft/eval/run-eval.js --dry-run
  *
  * Environment:
  *   YEAFT_API_KEY          — Anthropic API key
@@ -62,7 +62,7 @@ if (args.help) {
 Yeaft Eval Runner
 
 Usage:
-  node agent/unify/eval/run-eval.js [options]
+  node agent/yeaft/eval/run-eval.js [options]
 
 Options:
   -s, --suite <name>         Run specific suite: tools, memory, skills, e2e, all (default: all)
@@ -78,16 +78,16 @@ Environment:
 
 Examples:
   # Quick dry run to verify harness works
-  node agent/unify/eval/run-eval.js --dry-run
+  node agent/yeaft/eval/run-eval.js --dry-run
 
   # Run tool evals against Claude Sonnet
-  node agent/unify/eval/run-eval.js --suite tools --models claude-sonnet-4-20250514
+  node agent/yeaft/eval/run-eval.js --suite tools --models claude-sonnet-4-20250514
 
   # Full eval, save baseline
-  node agent/unify/eval/run-eval.js --save-baseline v0.1.411
+  node agent/yeaft/eval/run-eval.js --save-baseline v0.1.411
 
   # Check for regressions
-  node agent/unify/eval/run-eval.js --compare-baseline baselines/v0.1.411.json
+  node agent/yeaft/eval/run-eval.js --compare-baseline baselines/v0.1.411.json
 `);
   process.exit(0);
 }

package/{unify → yeaft}/eval/runner.js

@@ -1,5 +1,5 @@
 /**
- * eval/runner.js — Eval harness for Yeaft Unify
+ * eval/runner.js — Eval harness for Yeaft Yeaft
  *
  * Runs eval cases against one or more models and produces scored results.
  * Each eval case defines:

package/{unify → yeaft}/groups/feature-flag.js

@@ -1,5 +1,5 @@
 /**
- * feature-flag.js — Reads `config.unify.multiVp.enabled` from ~/.yeaft/config.json.
+ * feature-flag.js — Reads `config.yeaft.multiVp.enabled` from ~/.yeaft/config.json.
  *
  * Per architecture §11: multi-VP group mode is opt-in for MVP. The flag
  * gates UI entry points and (later) migration. This module returns a plain
@@ -14,7 +14,7 @@ import { join } from 'path';
 import { writeAtomic } from '../storage/index.js';
 
 const CONFIG_FILE = 'config.json';
-const FLAG_PATH = ['unify', 'multiVp', 'enabled'];
+const FLAG_PATH = ['yeaft', 'multiVp', 'enabled'];
 
 function readConfig(yeaftDir) {
   const path = join(yeaftDir, CONFIG_FILE);

package/{unify → yeaft}/groups/index.js

@@ -6,10 +6,10 @@
  *   - Roster mutation helpers
  *   - Coordinator that parses @-mentions on USER messages and dispatches to
  *     target RoleInstances via a caller-supplied `deliver(vpId, envelope)`.
- *   - Feature flag reader for `unify.multiVp.enabled`
+ *   - Feature flag reader for `yeaft.multiVp.enabled`
  *   - First-boot default group seeder
  *
- * See agent/unify/groups/coordinator.js for the dispatch contract.
+ * See agent/yeaft/groups/coordinator.js for the dispatch contract.
  */
 
 export {

package/{unify → yeaft}/groups/pre-flow.js

@@ -1,5 +1,5 @@
 /**
- * groups/pre-flow.js — explicit pre-flow stage for Unify.
+ * groups/pre-flow.js — explicit pre-flow stage for Yeaft.
  *
  * Pre-flow is the "before any VP runs" stage. It owns:
  *
@@ -167,6 +167,15 @@ export function selectRespondingVps(input) {
  */
 function scopeHeading(scope) {
   if (scope === 'user') return '## Memory: User';
+  // Nested group scopes first.
+  let m = /^group\/([^/]+)\/vp\/(.+)$/.exec(scope);
+  if (m) return `## Memory: VP ${m[2]}`;
+  m = /^group\/([^/]+)\/user$/.exec(scope);
+  if (m) return `## Memory: Group ${m[1]} (user)`;
+  m = /^group\/([^/]+)\/feature\/(.+)$/.exec(scope);
+  if (m) return `## Memory: Feature ${m[2]}`;
+  m = /^group\/([^/]+)\/topic\/(.+)$/.exec(scope);
+  if (m) return `## Memory: Topic ${m[2]}`;
   if (scope.startsWith('group/')) return `## Memory: Group ${scope.slice(6)}`;
   if (scope.startsWith('vp/')) return `## Memory: VP ${scope.slice(3)}`;
   if (scope.startsWith('feature/')) return `## Memory: Feature ${scope.slice(8)}`;
@@ -238,8 +247,11 @@ export function formatPickedForInjection(picked) {
  */
 export function buildRelevantScopes({ groupId, vpId, extra } = {}) {
   const scopes = ['user'];
-  if (groupId) scopes.push(`group/${groupId}`);
-  if (vpId) scopes.push(`vp/${vpId}`);
+  if (groupId) {
+    scopes.push(`group/${groupId}`);
+    scopes.push(`group/${groupId}/user`);
+    if (vpId) scopes.push(`group/${groupId}/vp/${vpId}`);
+  }
   if (Array.isArray(extra)) {
     for (const s of extra) {
       if (s && !scopes.includes(s)) scopes.push(s);

package/{unify → yeaft}/groups/project-doc.js

@@ -140,7 +140,7 @@ export function readProjectDoc(workDir, opts = {}) {
   const text = buffer.toString('utf8', 0, useBytes).trim();
   if (truncated) {
     console.warn(
-      `[unify/project-doc] ${picked.path} exceeds ${maxBytes} bytes — truncated.`,
+      `[yeaft/project-doc] ${picked.path} exceeds ${maxBytes} bytes — truncated.`,
     );
   }
   if (!text) return null;

package/{unify → yeaft}/history-compact.js

@@ -1,15 +1,15 @@
 /**
  * history-compact.js — In-memory conversation history compaction for the
- * Unify group-chat fan-out path.
+ * Yeaft group-chat fan-out path.
  *
  * Problem this solves:
- *   `agent/unify/web-bridge.js` keeps a flat module-level array
+ *   `agent/yeaft/web-bridge.js` keeps a flat module-level array
  *   `conversationMessages` that grows unbounded across the lifetime of the
  *   agent process. Every fan-out turn snapshots the whole thing into
  *   `baseSnapshot` and feeds it to `engine.query` for every VP. Without a
  *   cap, prompt size and token cost grow linearly with conversation length.
  *
- * Existing infrastructure (`agent/unify/compact/orchestrator.js`,
+ * Existing infrastructure (`agent/yeaft/compact/orchestrator.js`,
  * `engine.js#runOrchestratorCompact`) compacts the on-disk
  * `conversationStore` — a different surface. This helper compacts the
  * in-memory array that actually gets passed to the LLM.

package/{unify → yeaft}/index.js

@@ -1,5 +1,5 @@
 /**
- * index.js — Yeaft Unify module entry point
+ * index.js — Yeaft Yeaft module entry point
  *
  * Re-exports all public APIs for external consumption.
  */

package/{unify → yeaft}/init.js

@@ -2,7 +2,7 @@
  * init.js — Yeaft directory structure initialization
  *
  * Ensures ~/.yeaft/ and all required subdirectories exist.
- * Creates default config.md, MEMORY.md, and conversation/index.md if missing.
+ * Creates default config.md, MEMORY.md, chat/index.md, and group/index.md if missing.
  */
 
 import { existsSync, mkdirSync, writeFileSync, accessSync, constants } from 'fs';
@@ -74,9 +74,13 @@ export const DEFAULT_YEAFT_DIR = join(homedir(), '.yeaft');
 
 /** Subdirectories that must exist inside the Yeaft data directory. */
 const SUBDIRS = [
-  'conversation/messages',
-  'conversation/cold',
-  'conversation/blobs',
+  'chat/messages',
+  'chat/cold',
+  'chat/blobs',
+  'group/messages',
+  'group/cold',
+  'group/blobs',
+  'group/compact',
   'memory/entries',
   'tasks',
   'skills',
@@ -144,7 +148,7 @@ totalMessages: 0
 
 # Conversation Index
 
-This file tracks the conversation state for the "one eternal conversation" model.
+This file tracks one Yeaft message-history mode.
 `;
 
 /**
@@ -196,10 +200,12 @@ export function initYeaftDir(dir) {
     created.push(memoryPath);
   }
 
-  const indexPath = join(root, 'conversation', 'index.md');
-  if (!existsSync(indexPath)) {
-    safeWriteFile(indexPath, DEFAULT_CONVERSATION_INDEX, warnings);
-    created.push(indexPath);
+  for (const mode of ['chat', 'group']) {
+    const indexPath = join(root, mode, 'index.md');
+    if (!existsSync(indexPath)) {
+      safeWriteFile(indexPath, DEFAULT_CONVERSATION_INDEX, warnings);
+      created.push(indexPath);
+    }
   }
 
   // mcp.json.example — reference template for MCP server configuration

package/{unify → yeaft}/llm/adapter.js

@@ -120,7 +120,7 @@ export class LLMAbortError extends Error {
  * sent to the LLM. A truncated copy is worse than useless — it lies about
  * what the model saw. If the resulting payload is too large for the debug
  * store, the fix is to bound retention (drop oldest turns), not to mutilate
- * individual payloads. See `MAX_UNIFY_DEBUG_LOOPS` in `web/stores/chat.js`.
+ * individual payloads. See `MAX_YEAFT_DEBUG_LOOPS` in `web/stores/chat.js`.
  *
  * @param {{ url: string, method: string, headers: object, body: any }} req
  * @returns {{ url: string, method: string, headers: object, body: any }}

package/{unify → yeaft}/llm/anthropic.js

@@ -24,10 +24,10 @@ import {
 
 /**
  * task-327a: feature-flag accessor. thinkingV1 is OFF by default; set
- * env UNIFY_THINKING_V1=1 to enable. Read lazily so tests can flip.
+ * env YEAFT_THINKING_V1=1 to enable. Read lazily so tests can flip.
  */
 function thinkingV1Enabled() {
-  return process.env.UNIFY_THINKING_V1 === '1';
+  return process.env.YEAFT_THINKING_V1 === '1';
 }
 
 const DEFAULT_BASE_URL = 'https://api.anthropic.com';