@yeaft/webchat-agent 0.1.762 → 0.1.766

package/unify/features/summary.js

@@ -1,250 +0,0 @@
-/**
- * summary.js — Feature multi-VP collaboration summary protocol.
- *
- * Owns:
- *   - postSummary()          — write a `type=summary` message to the group jsonl
- *   - buildSummaryReminder() — compute the §Δ31.4 3-AND soft reminder shape
- *   - buildFeatureCtxMemories() — feature-memory top-5 (post-rip stub: returns [])
- *
- * Hard boundaries:
- *   - does NOT touch jsonl rotation internals (calls group.appendMessage)
- *   - does NOT write feature-memory shards — the H2-AMS rip retired the shard
- *     store; feature memory now flows through Dream V2's scope merge instead.
- */
-
-import { join } from 'path';
-
-// ─── §Δ31.4 soft-reminder thresholds ─────────────────────────────
-/** Must be initiator AND members>1 AND (age≥20min OR turns≥10). */
-export const SUMMARY_REMINDER_MIN_MEMBERS  = 2;
-export const SUMMARY_REMINDER_MIN_TURNS    = 10;
-export const SUMMARY_REMINDER_MIN_AGE_MS   = 20 * 60 * 1000;
-
-// ─── extractor limits ────────────────────────────────────────────
-export const EXTRACT_MIN_ENTRIES = 2;
-export const EXTRACT_MAX_ENTRIES = 5;
-
-/** Semantic progress anchors — string labels accepted alongside 0-100 number. */
-export const PROGRESS_ANCHORS = Object.freeze([
-  'blocked', 'planning', 'in-progress', 'review', 'milestone', 'shipped', 'done',
-]);
-
-/** Whitelist of R6 kinds emitted by the summary-extractor. */
-const EXTRACT_KINDS = Object.freeze(['progress', 'decision']);
-
-/** Shard routing for each extracted kind (§Δ25.2 feature-memory fixed set). */
-const KIND_TO_SHARD = Object.freeze({
-  progress: 'progress',
-  decision: 'decision',
-});
-
-// ─── (B) postSummary ─────────────────────────────────────────────
-
-/**
- * Write a `type=summary` message to the group log, then auto-run the
- * extractor to derive feature-memory entries.
- *
- * @param {{
- *   group: import('../groups/group-store.js').GroupHandle,
- *   featureId: string,
- *   fromVpId: string,
- *   body: string,
- *   progress?: number|string,
- *   supersedes?: string[],
- *   memoryDir: string,            // groups/<g>/features/<f>/memory/
- *   now?: () => number,
- *   extractor?: (body:string) => Array<{kind:string,body:string,tags?:string[]}>
- * }} opts
- * @returns {{ message: any, memoryIds: string[], supersededSummaryIds: string[] }}
- */
-export function postSummary(opts) {
-  const {
-    group,
-    featureId,
-    fromVpId,
-    body,
-    progress,
-    supersedes,
-    memoryDir,
-    now = () => Date.now(),
-    extractor = defaultExtractor,
-  } = opts || {};
-
-  if (!group || typeof group.appendMessage !== 'function') {
-    throw new Error('postSummary: group handle required');
-  }
-  if (!featureId)   throw new Error('postSummary: featureId required');
-  if (!fromVpId) throw new Error('postSummary: fromVpId required');
-  if (typeof body !== 'string' || !body.trim()) {
-    throw new Error('postSummary: body required (non-empty string)');
-  }
-  if (progress != null) {
-    if (typeof progress === 'string') {
-      if (!PROGRESS_ANCHORS.includes(progress)) {
-        throw new Error(`postSummary: progress string must be one of: ${PROGRESS_ANCHORS.join(', ')}`);
-      }
-    } else {
-      const p = Number(progress);
-      if (!Number.isFinite(p) || p < 0 || p > 100) {
-        throw new Error('postSummary: progress must be number in [0,100] or a semantic anchor string');
-      }
-    }
-  }
-  const supersedesArr = Array.isArray(supersedes)
-    ? supersedes.filter((s) => typeof s === 'string' && s)
-    : [];
-
-  // 1) Append the summary message to the group jsonl log (type=summary).
-  const stored = group.appendMessage({
-    from: fromVpId,
-    role: 'assistant',
-    text: body,
-    featureId,
-    meta: {
-      type: 'summary',
-      progress: progress == null ? null : (typeof progress === 'string' ? progress : Number(progress)),
-      supersedes: supersedesArr,
-    },
-  });
-
-  // 2) Feature-memory extraction is now owned by Dream V2 (per-group diff →
-  //    triage → merge by target scope → atomic segments). The legacy in-line
-  //    shard-store extractor was retired in the H2-AMS rip; we leave
-  //    `memoryIds` empty so callers don't depend on inline-extracted IDs.
-  const memoryIds = [];
-
-  return {
-    message: stored,
-    memoryIds,
-    supersededSummaryIds: supersedesArr,
-  };
-}
-
-/** Clamp raw extractor output to [EXTRACT_MIN_ENTRIES..EXTRACT_MAX_ENTRIES]. */
-function clampExtracted(arr) {
-  const cleaned = arr.filter((x) => x && typeof x.body === 'string' && x.body.trim());
-  if (cleaned.length === 0) return [];
-  return cleaned.slice(0, EXTRACT_MAX_ENTRIES);
-}
-
-// ─── (C) default extractor ───────────────────────────────────────
-
-export function defaultExtractor(body) {
-  if (typeof body !== 'string') return [];
-  const lines = body
-    .split(/\r?\n/)
-    .map((l) => l.replace(/^[\s*\-•]+/, '').trim())
-    .filter(Boolean);
-  const out = [];
-  for (const line of lines) {
-    const lower = line.toLowerCase();
-    let kind = 'progress';
-    if (/^(decide|decision|chose|chosen|pick|choose)\b/.test(lower)) {
-      kind = 'decision';
-    }
-    out.push({ kind, body: line });
-    if (out.length >= EXTRACT_MAX_ENTRIES) break;
-  }
-  if (out.length < EXTRACT_MIN_ENTRIES && body.trim()) {
-    while (out.length < EXTRACT_MIN_ENTRIES) {
-      out.push({ kind: 'progress', body: body.trim() });
-    }
-  }
-  return out;
-}
-
-// ─── (D) soft reminder builder ───────────────────────────────────
-
-/**
- * Build the `featureCtx.summaryReminder` shape consumed by 334e's prompt.
- *
- * §Δ31.4 conditions:
- *   (1) feature.members.length > 1
- *   (2) caller role === 'initiator'  (i.e. currentVpId === feature.initiator)
- *   (3) (now - lastSummaryAt) ≥ 20 min  OR  nonSummaryTurns ≥ 10
- *
- * @param {{
- *   feature: { initiator?: string, members?: string[] },
- *   currentVpId: string,
- *   lastSummaryAt: number,
- *   nonSummaryTurns: number,
- *   now?: number,
- * }} input
- */
-export function buildSummaryReminder(input) {
-  const { feature, currentVpId, lastSummaryAt = 0, nonSummaryTurns = 0 } = input || {};
-  const now = typeof input?.now === 'number' ? input.now : Date.now();
-  const reasons = [];
-
-  if (!feature || typeof feature !== 'object') {
-    return { triggered: false, reasons: ['no-feature'], nonSummaryCount: nonSummaryTurns, lastSummaryAt, now };
-  }
-  const members = Array.isArray(feature.members) ? feature.members : [];
-  const isInitiator = !!currentVpId && feature.initiator === currentVpId;
-
-  if (!isInitiator) reasons.push('not-initiator');
-  if (members.length <= SUMMARY_REMINDER_MIN_MEMBERS - 1) reasons.push('solo-feature');
-
-  const ageMs = lastSummaryAt > 0 ? now - lastSummaryAt : Number.POSITIVE_INFINITY;
-  const ageOk = ageMs >= SUMMARY_REMINDER_MIN_AGE_MS;
-  const turnsOk = nonSummaryTurns >= SUMMARY_REMINDER_MIN_TURNS;
-  if (!ageOk && !turnsOk) reasons.push('too-soon');
-
-  const triggered = isInitiator && members.length >= SUMMARY_REMINDER_MIN_MEMBERS && (ageOk || turnsOk);
-  return {
-    triggered,
-    reasons,
-    nonSummaryCount: nonSummaryTurns,
-    lastSummaryAt,
-    now,
-  };
-}
-
-// ─── (E) feature_ctx top-5 feature-memory builder ────────────────
-
-/**
- * Assemble feature-memory top-5 for 334e's `featureCtx.memories` field.
- * Post-rip stub: the underlying shard store was retired in the H2-AMS rip;
- * Dream V2 owns feature-scope memory now. Returning `[]` keeps the prompt
- * shape valid until a follow-up wires the new scope-summary read path.
- *
- * @param {string} memoryDir  unused (kept for callsite compatibility)
- * @param {{ tags?: string[], top?: number }} [opts]
- * @returns {Array<{body:string, shard:string, authoredBy?:string}>}
- */
-export function buildFeatureCtxMemories(_memoryDir, _opts = {}) {
-  return [];
-}
-
-// ─── (F) related-feature ACL fail-closed gate ─────────────────────
-
-/**
- * Return memory/summary hints for a related feature only when ACL grants.
- * Caller passes the FeatureStore so we can ask `canAccessRelated()`.
- *
- * @param {{
- *   featureStore: import('./store.js').FeatureStore,
- *   currentFeatureId: string,
- *   otherFeatureId: string,
- *   vpId: string,
- *   groupsRoot: string,
- *   top?: number,
- * }} input
- * @returns {null | { id:string, title:string, members:string[], updatedAt?:number, memories:Array<{body:string,shard:string}> }}
- */
-export function getRelatedFeatureCtx(input) {
-  const { featureStore, currentFeatureId, otherFeatureId, vpId, groupsRoot, top = 2 } = input || {};
-  if (!featureStore || !currentFeatureId || !otherFeatureId || !vpId || !groupsRoot) return null;
-  if (!featureStore.canAccessRelated(currentFeatureId, otherFeatureId, vpId)) return null;
-  const other = featureStore.get(otherFeatureId);
-  if (!other || !other.groupId) return null;
-  const memoryDir = join(groupsRoot, other.groupId, 'features', other.id, 'memory');
-  const mems = buildFeatureCtxMemories(memoryDir, { top });
-  return {
-    id: other.id,
-    title: other.title || other.id,
-    members: Array.isArray(other.members) ? other.members.slice() : [],
-    updatedAt: other.updatedAt || 0,
-    memories: mems,
-  };
-}