@pcircle/memesh 4.10.1 → 4.10.2

package/scripts/hooks/_generated/briefing-level.js

@@ -0,0 +1,82 @@
+// ============================================================================
+// AUTO-GENERATED from src/core/briefing-level.ts — DO NOT EDIT BY HAND.
+// Regenerate with: npm run build  (scripts/generate-hook-core.mjs)
+//
+// Claude Code hooks import this committed copy instead of dist/, so the
+// always-on capture path survives a missing or stale dist/ while staying
+// byte-locked to core — eliminating the hand-mirror drift behind the P0 FTS bug.
+// ============================================================================
+export const BRIEFING_LEVELS = ['minimal', 'standard', 'full'];
+export const DEFAULT_BRIEFING_LEVEL = 'standard';
+export function isBriefingLevel(value) {
+    return typeof value === 'string' && BRIEFING_LEVELS.includes(value);
+}
+const INVALID_VALUE_SERIALIZED_MAX = 100;
+const PRE_SLICE_RAW_MAX = 256;
+function safeRawPreSlice(value, maxUnits) {
+    if (value.length <= maxUnits)
+        return value;
+    let end = maxUnits;
+    const lastKept = value.charCodeAt(end - 1);
+    const nextUnit = value.charCodeAt(end);
+    const lastKeptIsHighSurrogate = lastKept >= 0xd800 && lastKept <= 0xdbff;
+    const nextUnitIsLowSurrogate = nextUnit >= 0xdc00 && nextUnit <= 0xdfff;
+    if (lastKeptIsHighSurrogate && nextUnitIsLowSurrogate)
+        end -= 1;
+    return value.slice(0, end);
+}
+function truncateToSerializedBound(codePoints) {
+    let kept = 0;
+    for (; kept < codePoints.length; kept++) {
+        const candidate = JSON.stringify(`${codePoints.slice(0, kept + 1).join('')}…`);
+        if (candidate.length > INVALID_VALUE_SERIALIZED_MAX)
+            break;
+    }
+    return JSON.stringify(`${codePoints.slice(0, kept).join('')}…`);
+}
+function describeInvalidValue(value) {
+    if (typeof value === 'string') {
+        if (value.length <= INVALID_VALUE_SERIALIZED_MAX) {
+            const whole = JSON.stringify(value);
+            if (whole.length <= INVALID_VALUE_SERIALIZED_MAX)
+                return whole;
+            return truncateToSerializedBound(Array.from(value));
+        }
+        return truncateToSerializedBound(Array.from(safeRawPreSlice(value, PRE_SLICE_RAW_MAX)));
+    }
+    if (Array.isArray(value))
+        return '[array]';
+    if (value !== null && typeof value === 'object')
+        return '[object]';
+    if (typeof value === 'bigint')
+        return '[bigint]';
+    if (typeof value === 'symbol')
+        return '[symbol]';
+    if (typeof value === 'function')
+        return '[function]';
+    return JSON.stringify(value) ?? String(value);
+}
+export function resolveBriefingLevel(envValue, configValue) {
+    if (envValue !== undefined) {
+        if (isBriefingLevel(envValue))
+            return { level: envValue, invalid: null };
+        return { level: DEFAULT_BRIEFING_LEVEL, invalid: { source: 'env', value: describeInvalidValue(envValue) } };
+    }
+    if (configValue !== undefined) {
+        if (isBriefingLevel(configValue))
+            return { level: configValue, invalid: null };
+        return { level: DEFAULT_BRIEFING_LEVEL, invalid: { source: 'config', value: describeInvalidValue(configValue) } };
+    }
+    return { level: DEFAULT_BRIEFING_LEVEL, invalid: null };
+}
+const POLICIES = {
+    minimal: { global: false, foreign: false, taskState: false, index: false, workPackageNotice: false },
+    standard: { global: false, foreign: false, taskState: true, index: true, workPackageNotice: false },
+    full: { global: true, foreign: true, taskState: true, index: true, workPackageNotice: true },
+};
+export function briefingLevelPolicy(level) {
+    return POLICIES[level];
+}
+export function sessionStartAppendsWorkPackageNotice(level) {
+    return briefingLevelPolicy(level).workPackageNotice;
+}

package/scripts/hooks/_generated/capture-liveness.js

@@ -130,6 +130,7 @@ export const SKIP_REASONS = {
     noFilePath: 'no file_path in the tool input',
     noDatabaseForRecall: 'no database yet — nothing to recall',
     nothingToRecall: 'no guard matched and nothing to recall for this file',
+    candidateWindowTruncated: 'more candidates may exist than the search window examined',
     noPromptIntent: 'the prompt carried no remember intent and no update decision',
     noMemoryDir: 'no Claude Code memory directory for this project',
     noNoteChanged: 'no note file changed since the last ingestion',

package/scripts/hooks/_generated/core-paths.js

@@ -100,6 +100,10 @@ function tryGit(cwd, args) {
         return null;
     }
 }
+export function gitRepoRoot(cwdInput) {
+    const cwd = cwdInput && cwdInput.length > 0 ? cwdInput : process.cwd();
+    return tryGit(cwd, ['rev-parse', '--show-toplevel']);
+}
 export function canonicalRemoteLocator(remote) {
     const value = remote.trim();
     if (!value)

package/scripts/hooks/_generated/fts-index.js

@@ -62,6 +62,11 @@ const LONE_UNSPACED_CHAR = new RegExp(`[${UNSPACED_SCRIPT_CLASS}]`, 'u');
 export function isLoneUnspacedChar(term) {
     return [...term].length === 1 && LONE_UNSPACED_CHAR.test(term);
 }
+export function renderPhraseExpression(terms) {
+    if (terms.length === 0)
+        return null;
+    return `"${terms.map((term) => term.replace(/"/g, '""')).join(' ')}"`;
+}
 function foldTitleIntoObservations(title, observationsText) {
     return title ? `${title} ${observationsText}` : observationsText;
 }

package/scripts/hooks/_generated/task-state.js

@@ -96,3 +96,73 @@ export function taskStateLines(state, project, now = new Date()) {
     }
     return lines;
 }
+export const STALE_TASK_STATE_HOURS = 72;
+export const CLOCK_SKEW_ALLOWANCE_MINUTES = 5;
+const ZONED_INSTANT = /^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})[Tt](?<hour>\d{2}):(?<minute>\d{2})(?::(?<second>\d{2})(?:\.\d+)?)?(?:(?<zulu>[Zz])|(?<offSign>[+-])(?<offHour>\d{2}):?(?<offMinute>\d{2}))$/;
+function isLeapYear(year) {
+    return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+}
+const DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+function daysInMonth(year, month) {
+    return month === 2 && isLeapYear(year) ? 29 : DAYS_IN_MONTH[month - 1];
+}
+function isRealInstant(groups) {
+    const year = Number(groups.year);
+    const month = Number(groups.month);
+    const day = Number(groups.day);
+    const hour = Number(groups.hour);
+    const minute = Number(groups.minute);
+    const second = groups.second === undefined ? 0 : Number(groups.second);
+    if (month < 1 || month > 12)
+        return false;
+    if (day < 1 || day > daysInMonth(year, month))
+        return false;
+    if (hour > 23)
+        return false;
+    if (minute > 59)
+        return false;
+    if (second > 59)
+        return false;
+    if (groups.zulu === undefined) {
+        const offHour = Number(groups.offHour);
+        const offMinute = Number(groups.offMinute);
+        if (offHour > 23 || offMinute > 59)
+            return false;
+        if (groups.offSign === '-' && offHour === 0 && offMinute === 0)
+            return false;
+    }
+    return true;
+}
+function resolveTaskStateAge(updatedAt, now) {
+    if (!updatedAt)
+        return { known: false };
+    const match = ZONED_INSTANT.exec(updatedAt);
+    if (!match?.groups || !isRealInstant(match.groups))
+        return { known: false };
+    const then = Date.parse(updatedAt);
+    if (Number.isNaN(then))
+        return { known: false };
+    const hours = (now.getTime() - then) / 3_600_000;
+    if (hours < -(CLOCK_SKEW_ALLOWANCE_MINUTES / 60))
+        return { known: false };
+    return { known: true, hours: Math.max(0, hours) };
+}
+function staleTaskStateLine(project, hours) {
+    const days = Math.floor(hours / 24);
+    const age = days >= 1 ? `${days} day${days === 1 ? '' : 's'} ago` : `${Math.floor(hours)} hour${Math.floor(hours) === 1 ? '' : 's'} ago`;
+    return `Task state for "${project}" was last stated ${age} — older than ${STALE_TASK_STATE_HOURS}h, so it is not shown as current. Run \`memesh task\` to see or update it.`;
+}
+function taskStateAgeUnknownLine(project) {
+    return `Task state for "${project}" has a missing, unreadable, or future-dated timestamp, so its age could not be established — not shown as current. Run \`memesh task\` to see or update it.`;
+}
+export function briefingTaskStateLines(state, project, now = new Date(), { includeFresh = true } = {}) {
+    if (isEmptyTaskState(state))
+        return [];
+    const age = resolveTaskStateAge(state.updated_at, now);
+    if (!age.known)
+        return [taskStateAgeUnknownLine(project)];
+    if (age.hours > STALE_TASK_STATE_HOURS) {
+        return [staleTaskStateLine(project, age.hours)];
+    }
+    return includeFresh ? taskStateLines(state, project, now) : [];
+}

package/scripts/hooks/_generated/work-topology.js

@@ -200,6 +200,9 @@ export function assembleTopologyBlock(stateLines, pools, projectName, budget = D
     lines.push(...globalLines);
     return lines;
 }
+export function hasBriefingContent(lines) {
+    return lines.length > 0;
+}
 export function buildReferenceContext(memoryLines) {
     const safeLines = memoryLines.map((line) => String(line ?? '')
         .replace(/[\s\u0085\u001c-\u001e]+/g, ' ')