@pcircle/memesh 4.9.4 → 4.10.1

package/dist/core/briefing-index.js

@@ -0,0 +1,140 @@
+import { redactSecrets, redactUserPaths } from './paths.js';
+import { EVIDENCE_LAYER_TYPES, isAutoInjectable, topologyLine } from './work-topology.js';
+export const INDEX_MAX_LINES = 40;
+export const INDEX_MAX_BYTES = 3072;
+export const INDEX_STALE_DAYS = 180;
+export const INDEX_LINE_MAX_CHARS = 120;
+export const INDEX_SNIPPET_FETCH_CHARS = 4000;
+export const INDEX_CANDIDATE_CAP = 2000;
+export const INDEX_EXCLUDED_TYPES = [...EVIDENCE_LAYER_TYPES, 'task-state'];
+export function isIndexableType(type) {
+    return !INDEX_EXCLUDED_TYPES.includes(type || 'memory');
+}
+const DAY_MS = 24 * 60 * 60 * 1000;
+function byteLength(text) {
+    return new TextEncoder().encode(text).length;
+}
+function sectionBytes(lines) {
+    return lines.reduce((sum, line) => sum + byteLength(line) + 1, 0);
+}
+function parseActivity(value) {
+    if (!value)
+        return Number.NaN;
+    const iso = /[zZ]|[+-]\d\d:?\d\d$/.test(value) ? value : `${value.replace(' ', 'T')}Z`;
+    return Date.parse(iso);
+}
+function compareIndexCandidates(a, b) {
+    const at = parseActivity(a.lastActivity);
+    const bt = parseActivity(b.lastActivity);
+    const av = Number.isNaN(at) ? -Infinity : at;
+    const bv = Number.isNaN(bt) ? -Infinity : bt;
+    if (av !== bv)
+        return bv - av;
+    return b.id - a.id;
+}
+function candidateIsAutoInjectable(metadata) {
+    if (metadata == null)
+        return true;
+    if (typeof metadata === 'string') {
+        let parsed;
+        try {
+            parsed = JSON.parse(metadata);
+        }
+        catch {
+            return false;
+        }
+        return parsed !== null && typeof parsed === 'object' && isAutoInjectable(parsed);
+    }
+    return isAutoInjectable(metadata);
+}
+function redact(text) {
+    if (!text)
+        return '';
+    return redactUserPaths(redactSecrets(String(text))).replace(/\s+/g, ' ').trim();
+}
+function indexLine(candidate) {
+    const title = redact(candidate.title);
+    const snippet = redact(candidate.snippet);
+    const repeats = title && snippet && snippet.toLowerCase().startsWith(title.replace(/…$/, '').toLowerCase());
+    const text = title && snippet && !repeats ? `${title} — ${snippet}` : (title || snippet);
+    return topologyLine({ name: String(candidate.id), id: candidate.id, type: candidate.type || 'memory', title: text || null }, INDEX_LINE_MAX_CHARS);
+}
+function indexHeading(projectName) {
+    return `Index of durable memories for "${projectName}" (newest first):`;
+}
+function indexEmptyLine(projectName) {
+    return `- No durable memories (decisions, lessons, patterns, references) for "${projectName}" yet.`;
+}
+function moreLine(n, truncated) {
+    return `- ${n}${truncated ? '+' : ''} more — memesh recall --tag "project:…"`;
+}
+function olderLine(n, truncated) {
+    return `- ${n}${truncated ? '+' : ''} older memor${n === 1 ? 'y' : 'ies'} (no change in ${INDEX_STALE_DAYS} days) — recall to see`;
+}
+function footerLine(shown, bytes, tokens) {
+    return `(index cost: ${shown} line${shown === 1 ? '' : 's'}, ${bytes} bytes ≈ ${tokens} tokens; cap ${INDEX_MAX_LINES} lines / ${INDEX_MAX_BYTES} bytes)`;
+}
+function closeWithFooter(lines, shown) {
+    const above = sectionBytes(lines);
+    let footer = footerLine(shown, above, Math.ceil(above / 4));
+    for (let step = 0; step < 8; step++) {
+        const bytes = above + byteLength(footer) + 1;
+        const tokens = Math.ceil(bytes / 4);
+        const next = footerLine(shown, bytes, tokens);
+        if (next === footer)
+            return { lines: [...lines, footer], bytes, tokens };
+        footer = next;
+    }
+    throw new Error('briefing index: the footer cost did not converge');
+}
+export function buildBriefingIndex(candidates, projectName, now, options = {}) {
+    const truncated = options.truncated === true;
+    const cutoff = now - INDEX_STALE_DAYS * DAY_MS;
+    const eligible = candidates
+        .filter((c) => isIndexableType(c.type) && candidateIsAutoInjectable(c.metadata))
+        .slice()
+        .sort(compareIndexCandidates);
+    const current = [];
+    let older = 0;
+    for (const c of eligible) {
+        const at = parseActivity(c.lastActivity);
+        if (!Number.isNaN(at) && at < cutoff)
+            older++;
+        else
+            current.push(c);
+    }
+    const heading = indexHeading(projectName);
+    if (current.length === 0 && older === 0) {
+        const closed = closeWithFooter([heading, indexEmptyLine(projectName)], 0);
+        return { ...closed, shown: 0, more: 0, older: 0, truncated, ids: [] };
+    }
+    const reserve = sectionBytes([
+        moreLine(current.length, truncated),
+        olderLine(older, truncated),
+        footerLine(INDEX_MAX_LINES, INDEX_MAX_BYTES, INDEX_MAX_BYTES),
+    ]);
+    const budget = INDEX_MAX_BYTES - reserve - sectionBytes([heading]);
+    const rendered = [];
+    const ids = [];
+    let used = 0;
+    for (const c of current) {
+        if (rendered.length >= INDEX_MAX_LINES)
+            break;
+        const line = indexLine(c);
+        const cost = byteLength(line) + 1;
+        if (used + cost > budget)
+            break;
+        rendered.push(line);
+        ids.push(c.id);
+        used += cost;
+    }
+    const more = current.length - rendered.length;
+    const above = [heading, ...rendered];
+    if (more > 0)
+        above.push(moreLine(more, truncated));
+    if (older > 0)
+        above.push(olderLine(older, truncated));
+    const closed = closeWithFooter(above, rendered.length);
+    return { ...closed, shown: rendered.length, more, older, truncated, ids };
+}
+//# sourceMappingURL=briefing-index.js.map

package/dist/core/briefing-index.js.map

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

package/dist/core/briefing.d.ts

@@ -1,8 +1,12 @@
+import { type BriefingIndex } from './briefing-index.js';
+import type { MemeshDatabase } from '../storage/sqlite.js';
 export interface BriefingResult {
     project: string;
     text: string;
     entityCount: number;
     hasTaskState: boolean;
+    index: BriefingIndex;
 }
+export declare function readBriefingIndex(db: MemeshDatabase, projectName: string, now?: number): BriefingIndex;
 export declare function assembleBriefing(project?: string, recipient?: string): BriefingResult;
 //# sourceMappingURL=briefing.d.ts.map

package/dist/core/briefing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"briefing.d.ts","sourceRoot":"","sources":["../../src/core/briefing.ts"],"names":[],"mappings":"AAgDA,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,EAAE,MAAM,CAAC;IAEpB,YAAY,EAAE,OAAO,CAAC;CACvB;AAuFD,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAgJrF"}
+{"version":3,"file":"briefing.d.ts","sourceRoot":"","sources":["../../src/core/briefing.ts"],"names":[],"mappings":"AAmCA,OAAO,EAKL,KAAK,aAAa,EAEnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAc3D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAEhB,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,EAAE,MAAM,CAAC;IAEpB,YAAY,EAAE,OAAO,CAAC;IAItB,KAAK,EAAE,aAAa,CAAC;CACtB;AA8FD,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,aAAa,CAiClH;AAOD,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAoKrF"}

package/dist/core/briefing.js

@@ -2,10 +2,11 @@ import { getDatabase } from '../db.js';
 import { getProjectName } from './paths.js';
 import { readRepoState, repoStateLines } from './repo-state.js';
 import { rankEntities } from './scoring.js';
-import { getTaskState } from './task-state-store.js';
+import { getTaskState, TaskStateUnreadableError } from './task-state-store.js';
 import { recipientEverSeen, unreadDeliveryCount, unreadInboxLines } from './agent-message-inbox.js';
 import { canonicalAgentScopeId } from './agent-scope-id.js';
 import { taskStateLines } from './task-state.js';
+import { INDEX_CANDIDATE_CAP, INDEX_EXCLUDED_TYPES, INDEX_SNIPPET_FETCH_CHARS, buildBriefingIndex, } from './briefing-index.js';
 import { GLOBAL_TOPOLOGY_LIMIT, SNIPPET_FETCH_CHARS, TOPOLOGY_CANDIDATE_CAP, assembleTopologyBlock, buildReferenceContext, isAutoInjectable, } from './work-topology.js';
 const PROJECT_LIMIT = 30;
 const RECENT_LIMIT = 5;
@@ -49,20 +50,54 @@ function toTopologyEntity(row, snippet) {
         signalScore: typeof signal === 'number' ? signal : null,
     };
 }
+export function readBriefingIndex(db, projectName, now = Date.now()) {
+    const hasNamespace = db.prepare('PRAGMA table_info(entities)').all()
+        .some((column) => column.name === 'namespace');
+    const nonGlobal = hasNamespace ? " AND (e.namespace IS NULL OR e.namespace <> 'global')" : '';
+    const excluded = INDEX_EXCLUDED_TYPES.map(() => '?').join(',');
+    const rows = db.prepare(`SELECT e.id, e.type, e.title, e.metadata,
+       (SELECT substr(o.content, 1, ${INDEX_SNIPPET_FETCH_CHARS}) FROM observations o
+         WHERE o.entity_id = e.id ORDER BY o.id ASC LIMIT 1) AS snippet,
+       max(e.created_at, COALESCE((SELECT MAX(o2.created_at) FROM observations o2
+         WHERE o2.entity_id = e.id), e.created_at)) AS last_activity
+     FROM entities e
+     WHERE e.id IN (SELECT entity_id FROM tags WHERE tag = ?)
+       AND e.status = 'active'${nonGlobal}
+       AND e.type NOT IN (${excluded})
+     ORDER BY last_activity DESC, e.id DESC
+     LIMIT ?`).all(`project:${projectName}`, ...INDEX_EXCLUDED_TYPES, INDEX_CANDIDATE_CAP);
+    const candidates = rows.map((row) => ({
+        id: row.id,
+        type: row.type,
+        title: row.title,
+        snippet: row.snippet,
+        lastActivity: row.last_activity,
+        metadata: row.metadata,
+    }));
+    return buildBriefingIndex(candidates, projectName, now, { truncated: rows.length >= INDEX_CANDIDATE_CAP });
+}
 export function assembleBriefing(project, recipient) {
     const projectName = project ?? getProjectName();
     const db = getDatabase();
     const repoLines = (project === undefined || project === getProjectName())
         ? repoStateLines(readRepoState())
         : [];
-    const { state } = getTaskState(projectName);
+    let taskLines;
+    try {
+        taskLines = taskStateLines(getTaskState(projectName).state, projectName);
+    }
+    catch (err) {
+        if (!(err instanceof TaskStateUnreadableError))
+            throw err;
+        taskLines = [`task state for ${projectName}: ${err.message}`];
+    }
     const inboxRecipient = recipient === undefined ? undefined : canonicalAgentScopeId(recipient);
     const unreadCount = unreadDeliveryCount(db, canonicalAgentScopeId(projectName), inboxRecipient);
     const everSeen = inboxRecipient !== undefined && unreadCount === 0
         ? recipientEverSeen(db, canonicalAgentScopeId(projectName), inboxRecipient)
         : undefined;
     const stateLines = [
-        ...taskStateLines(state, projectName),
+        ...taskLines,
         ...unreadInboxLines(unreadCount, canonicalAgentScopeId(projectName), inboxRecipient, everSeen),
     ];
     const hasNamespace = db.prepare('PRAGMA table_info(entities)').all()
@@ -112,11 +147,14 @@ export function assembleBriefing(project, recipient) {
     const withRepo = lines.length > 0 && repoLines.length > 0
         ? [...repoLines, '', ...lines]
         : lines;
+    const index = readBriefingIndex(db, projectName);
+    const block = withRepo.length > 0 ? [...withRepo, '', ...index.lines] : index.lines;
     return {
         project: projectName,
-        text: lines.length > 0 ? buildReferenceContext(withRepo) : '',
+        text: buildReferenceContext(block),
         entityCount: lines.filter((l) => l.startsWith('- [')).length,
         hasTaskState: stateLines.length > 0,
+        index,
     };
 }
 //# sourceMappingURL=briefing.js.map

package/dist/core/briefing.js.map

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

package/dist/core/capture-liveness.d.ts

@@ -0,0 +1,136 @@
+export type HookOutcome = 'wrote' | 'skipped' | 'notified' | 'error';
+export type HookHost = 'claude-code' | 'codex' | 'unknown';
+export interface HookOutcomeRecord {
+    hook: string;
+    at: string;
+    host: HookHost;
+    outcome: HookOutcome;
+    reason?: string;
+    entity?: string;
+}
+export interface HookOutcomeFile {
+    hooks: Record<string, HookOutcomeRecord[]>;
+}
+export declare const HOOK_OUTCOMES_FILENAME = "hook-outcomes.jsonl";
+export declare const HOOK_OUTCOMES_PER_HOOK = 20;
+export declare const HOOK_OUTCOMES_NOT_TRIGGERED_PER_HOOK = 5;
+export declare function isTriggeredRecord(record: Pick<HookOutcomeRecord, 'hook' | 'outcome' | 'reason'>): boolean;
+export declare const HOOK_OUTCOMES_ROTATE_BYTES: number;
+export declare function serializeHookOutcome(record: HookOutcomeRecord): string;
+export declare function trimHookOutcomeLines(raw: string, max?: number, maxBytes?: number): string;
+export declare const SILENT_HOOK_MIN_RUNS = 5;
+export declare const CAPTURE_HOOKS: readonly ["post-commit", "session-summary", "pre-compact", "pre-edit-recall", "user-prompt-intent", "decision-nudge", "guard-check", "session-start", "note-ingest", "remember-nudge"];
+export declare const FAIL_ELIGIBLE_HOOKS: readonly ["session-summary"];
+export declare const SILENT_ELIGIBLE_HOOKS: readonly ["post-commit", "session-summary", "pre-compact"];
+export declare const SKIP_REASONS: {
+    readonly notBash: "not a Bash tool call";
+    readonly notGitCommit: "not a git commit command";
+    readonly commitLineMissing: "a git commit ran but printed no commit line";
+    readonly commitHeadBaseline: "recorded the repository HEAD baseline; no history was backfilled";
+    readonly commitHeadUnchanged: "a commit-like command completed but repository HEAD did not change";
+    readonly commitHeadUnresolvable: "a commit-like command ran but repository HEAD could not be resolved";
+    readonly alreadyCaptured: "this session was already captured";
+    readonly payloadTooLarge: "payload exceeded the stdin byte cap";
+    readonly toolNameAbsent: "tool_name absent in payload";
+    readonly notDecisionTool: "not a decision-shaped tool call";
+    readonly noSessionId: "no usable session_id in the payload";
+    readonly alreadyNudged: "already nudged for this tool in this session";
+    readonly noBashCommand: "no Bash command in the payload";
+    readonly noDatabaseForGuards: "no database yet — nothing to guard against";
+    readonly noGuardMatched: "no active guard matched this command";
+    readonly autoCaptureOff: "auto-capture is turned off";
+    readonly commitCwdAbsent: "data.cwd absent — cannot resolve project or repo";
+    readonly hashNotACommit: "the hash is not a commit in this repository";
+    readonly noSessionOrTranscript: "neither session_id nor transcript_path in the payload";
+    readonly emptyStdin: "empty stdin";
+    readonly cwdAbsent: "cwd absent in payload — cannot resolve project";
+    readonly notAgenticLoop: "not an agentic loop";
+    readonly transcriptPathAbsent: "transcript_path absent";
+    readonly transcriptGone: "the transcript file named by the payload is gone";
+    readonly tooLittleActivity: "too little activity in the session to be worth saving";
+    readonly noRuleMatched: "no rule matched (no edited file and fewer than 20 tool calls)";
+    readonly allMatchedEntitiesArchived: "every rule that matched targeted an entity the user forget-archived";
+    readonly toolInputAbsent: "tool_input absent in payload";
+    readonly noFilePath: "no file_path in the tool input";
+    readonly noDatabaseForRecall: "no database yet — nothing to recall";
+    readonly nothingToRecall: "no guard matched and nothing to recall for this file";
+    readonly noPromptIntent: "the prompt carried no remember intent and no update decision";
+    readonly noMemoryDir: "no Claude Code memory directory for this project";
+    readonly noNoteChanged: "no note file changed since the last ingestion";
+    readonly noteIngesterNotBuilt: "the note ingester is not built (dist/core/note-ingest.js is missing)";
+    readonly noteNothingNew: "note files were read and nothing new needed storing";
+    readonly noteFilesRefused: "note files were refused and nothing was stored";
+    readonly noTranscript: "no transcript to read";
+    readonly trivialTurn: "trivial turn — too few tool calls since the last Stop";
+    readonly noDecisionMove: "no decision-shaped move since the last Stop";
+    readonly memoryWritten: "a memory was written since the last Stop";
+    readonly noteFileChanged: "a note file changed since the last Stop";
+};
+export declare const UNRECOGNISED_REASON = "unrecognised reason";
+export declare function renderableSkipReason(reason: string | undefined): string;
+export declare function isGitCommitCommand(command: string): boolean;
+export declare const NOT_TRIGGERED_SKIP_REASONS: Readonly<Record<string, readonly string[]>>;
+export declare const UNCLASSIFIED_SKIP_HOOKS: readonly ["pre-compact", "pre-edit-recall", "user-prompt-intent", "decision-nudge", "guard-check", "session-start"];
+export declare const NEVER_RAN_GRACE_HOURS = 72;
+export declare function parseHookOutcomes(raw: string | null | undefined, limit?: number): HookOutcomeFile;
+export declare function parseHookOutcomeLine(line: string): HookOutcomeRecord | null;
+export declare const RECORD_TEXT_MAX = 200;
+export declare function sanitizeRecordText(text: string): string;
+export interface HookLivenessSummary {
+    hook: string;
+    runs: number;
+    triggeredRuns: number;
+    writes: number;
+    skips: number;
+    errors: number;
+    lastRunAt: string | null;
+    firstTriggeredAt: string | null;
+    lastWriteAt: string | null;
+    lastEntity: string | null;
+    notifies: number;
+    lastNotifiedAt: string | null;
+    lastSkipReason: string | null;
+    dominantSkipReason: string | null;
+    dominantSkipCount: number;
+    hosts: HookHost[];
+    silent: boolean;
+}
+export declare function summarizeHookOutcomes(file: HookOutcomeFile): HookLivenessSummary[];
+export interface TypeTrend {
+    type: string;
+    last7: number;
+    prev7: number;
+    stopped: boolean;
+}
+export declare function summarizeTypeTrends(rows: Array<{
+    type: string;
+    last7: number;
+    prev7: number;
+}>): TypeTrend[];
+export type CaptureLivenessStatus = 'PASS' | 'PASS_WITH_CONCERNS' | 'FAIL';
+export interface CaptureLivenessInput {
+    hooks: HookLivenessSummary[];
+    types: TypeTrend[];
+    neverRanHooks?: string[];
+    measuringHours?: number | null;
+}
+export interface CaptureLivenessVerdict {
+    status: CaptureLivenessStatus;
+    silentHook: HookLivenessSummary | null;
+    stoppedTypes: TypeTrend[];
+    deadHooks: string[];
+}
+export declare function captureLivenessVerdict(input: CaptureLivenessInput): CaptureLivenessVerdict;
+export declare function captureLivenessNotice(verdict: CaptureLivenessVerdict): string | null;
+export declare const GRACE_SESSIONS = 3;
+export declare const GRACE_HOURS = 24;
+export interface CaptureGraceState {
+    version: string;
+    firstSeenAt: string;
+    sessions: number;
+}
+export declare function parseGraceState(raw: string | null | undefined): CaptureGraceState | null;
+export declare function advanceGraceState(previous: CaptureGraceState | null, version: string, nowMs: number): CaptureGraceState;
+export declare function graceInEffect(state: CaptureGraceState, nowMs: number): boolean;
+export declare function detectHookHost(payload: Record<string, unknown> | null | undefined, env?: Record<string, string | undefined>): HookHost;
+//# sourceMappingURL=capture-liveness.d.ts.map

package/dist/core/capture-liveness.d.ts.map

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