@pcircle/memesh 4.10.1 → 4.10.2

package/dist/transports/cli/cli.js

@@ -5890,13 +5890,66 @@ var init_types = __esm({
 });
 
 // dist/core/serializer.js
+function validateFreshForgottenHashes(value) {
+  if (!Array.isArray(value) || value.length === 0)
+    return null;
+  const deduped = [...new Set(value)];
+  if (!deduped.every((h) => typeof h === "string" && FORGOTTEN_HASH_RE.test(h)))
+    return null;
+  return deduped.length <= MAX_IMPORTED_FORGOTTEN_HASHES ? deduped : null;
+}
+function validateFreshSignalScore(value) {
+  return typeof value === "number" && value >= 0 && value <= 1 ? value : null;
+}
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isValidReplacedHistoryEntry(entry) {
+  if (!isPlainObject(entry))
+    return false;
+  for (const key of Object.keys(entry)) {
+    if (!REPLACED_HISTORY_ENTRY_KEYS.has(key))
+      return false;
+  }
+  if (typeof entry.replaced_at !== "string" || entry.replaced_at.length > 64)
+    return false;
+  if (!(entry.title === null || typeof entry.title === "string" && entry.title.length <= 500))
+    return false;
+  if (!Array.isArray(entry.observations) || !entry.observations.every((o) => typeof o === "string"))
+    return false;
+  if (!Array.isArray(entry.tags) || !entry.tags.every((t) => typeof t === "string"))
+    return false;
+  if ("truncated" in entry && typeof entry.truncated !== "boolean")
+    return false;
+  return true;
+}
+function validateFreshReplacedHistory(value) {
+  if (!Array.isArray(value) || value.length === 0)
+    return null;
+  if (value.length > MAX_IMPORTED_REPLACED_HISTORY_ENTRIES)
+    return null;
+  if (!value.every(isValidReplacedHistoryEntry))
+    return null;
+  return jsonBytesOf(value) <= MAX_IMPORTED_REPLACED_HISTORY_TOTAL_BYTES ? value : null;
+}
 function buildImportedMetadata(existingMetadata, args) {
-  const { guard: _guard, ...bundledSafe } = args.bundled ?? {};
-  void _guard;
+  const bundled = args.bundled ?? {};
+  const bundledSafe = {};
+  for (const [key, value] of Object.entries(bundled)) {
+    if (IMPORTABLE_METADATA_KEYS.has(key))
+      bundledSafe[key] = value;
+  }
+  const freshForgottenHashes = args.isNewEntity ? validateFreshForgottenHashes(bundled.forgotten_observation_hashes) : null;
+  const freshPin = args.isNewEntity && bundled.pin === true;
+  const freshSignalScore = args.isNewEntity ? validateFreshSignalScore(bundled.signal_score) : null;
+  const freshReplacedHistory = args.isNewEntity ? validateFreshReplacedHistory(bundled.replaced_history) : null;
   return {
     ...existingMetadata ?? {},
     ...bundledSafe,
-    ...Array.isArray(existingMetadata?.forgotten_observation_hashes) ? { forgotten_observation_hashes: existingMetadata.forgotten_observation_hashes } : {},
+    ...freshForgottenHashes ? { forgotten_observation_hashes: freshForgottenHashes } : {},
+    ...freshSignalScore !== null ? { signal_score: freshSignalScore } : {},
+    ...freshPin ? { pin: true } : {},
+    ...freshReplacedHistory ? { replaced_history: freshReplacedHistory } : {},
     trust: "untrusted",
     provenance: {
       ...existingMetadata?.provenance ?? {},
@@ -5965,6 +6018,12 @@ function importMemories(args) {
   if (!MERGE_STRATEGIES.includes(args.merge_strategy)) {
     throw new Error(`Unknown merge strategy "${args.merge_strategy}". Use one of: ${MERGE_STRATEGIES.join(", ")}. Nothing was imported \u2014 refusing rather than guessing, because the wrong guess overwrites existing memories.`);
   }
+  if (args.restore_archived !== void 0 && typeof args.restore_archived !== "boolean") {
+    throw new Error('restore_archived must be the boolean true or false. Nothing was imported \u2014 refusing rather than guessing, because "yes" brings back memories the user forgot.');
+  }
+  if (args.restore_archived === true && args.merge_strategy === "skip") {
+    throw new Error('restore_archived (--restore-archived) only applies with merge strategy "append" or "overwrite"; "skip" leaves every existing entity untouched, so there is nothing to restore. Nothing was imported.');
+  }
   if (args.namespace !== void 0 && !NAMESPACES.includes(args.namespace)) {
     throw new Error(`Unknown namespace "${args.namespace}". Use one of: ${NAMESPACES.join(", ")}. Nothing was imported \u2014 an unrecognised namespace would move existing memories somewhere nothing queries.`);
   }
@@ -5979,6 +6038,7 @@ function importMemories(args) {
   const pendingRelations = [];
   let skipped = 0;
   let appended = 0;
+  let keptArchived = 0;
   const errors = [];
   const skippedRelations = [];
   const setCreatedAt = db2.prepare("UPDATE entities SET created_at = ? WHERE name = ?");
@@ -5999,11 +6059,14 @@ function importMemories(args) {
           bundled: entity.metadata,
           exportedAt: args.data.exported_at,
           importVersion: args.data.version,
-          mergeStrategy: args.merge_strategy
+          mergeStrategy: args.merge_strategy,
+          isNewEntity: !existing
         });
         if (existing) {
           if (args.merge_strategy === "skip")
             return { kind: "skipped" };
+          if (existing.archived && args.restore_archived !== true)
+            return { kind: "keptArchived" };
           if (args.merge_strategy === "append") {
             const existingText = new Set(existing.observations);
             const newObservations = (entity.observations ?? []).filter((o) => !existingText.has(o));
@@ -6052,6 +6115,8 @@ function importMemories(args) {
       }).immediate();
       if (outcome.kind === "skipped")
         skipped++;
+      else if (outcome.kind === "keptArchived")
+        keptArchived++;
       else if (outcome.kind === "appended")
         appended++;
       else {
@@ -6075,9 +6140,9 @@ function importMemories(args) {
       errors.push(`${rel.from} -${rel.type}-> ${rel.to}: relation not restored (${err instanceof Error ? err.message : String(err)})`);
     }
   }
-  return { imported, overwritten, skipped, appended, errors, skipped_relations: skippedRelations };
+  return { imported, overwritten, skipped, appended, kept_archived: keptArchived, errors, skipped_relations: skippedRelations };
 }
-var MERGE_STRATEGIES;
+var IMPORTABLE_METADATA_KEYS, FORGOTTEN_HASH_RE, MAX_IMPORTED_FORGOTTEN_HASHES, MAX_IMPORTED_REPLACED_HISTORY_ENTRIES, MAX_IMPORTED_REPLACED_HISTORY_TOTAL_BYTES, REPLACED_HISTORY_ENTRY_KEYS, jsonBytesOf, MERGE_STRATEGIES;
 var init_serializer = __esm({
   "dist/core/serializer.js"() {
     "use strict";
@@ -6086,6 +6151,38 @@ var init_serializer = __esm({
     init_title();
     init_time_utils();
     init_types();
+    IMPORTABLE_METADATA_KEYS = /* @__PURE__ */ new Set([
+      "title_source",
+      "source_kind",
+      "source",
+      "cluster_key",
+      "dreamed_at",
+      "kind",
+      "project",
+      "previous_namespace",
+      "namespace_moved_at",
+      "split_from",
+      "retired_recall",
+      "priority",
+      "success_criteria",
+      "verification_scenario",
+      "implementation_state",
+      "outcome_state",
+      "accepted_at",
+      "source_ids"
+    ]);
+    FORGOTTEN_HASH_RE = /^[a-f0-9]{64}$/;
+    MAX_IMPORTED_FORGOTTEN_HASHES = 1e3;
+    MAX_IMPORTED_REPLACED_HISTORY_ENTRIES = 50;
+    MAX_IMPORTED_REPLACED_HISTORY_TOTAL_BYTES = 4 * 64 * 1024;
+    REPLACED_HISTORY_ENTRY_KEYS = /* @__PURE__ */ new Set([
+      "replaced_at",
+      "title",
+      "observations",
+      "tags",
+      "truncated"
+    ]);
+    jsonBytesOf = (v) => Buffer.byteLength(JSON.stringify(v), "utf8");
     MERGE_STRATEGIES = ["skip", "overwrite", "append"];
   }
 });
@@ -6417,6 +6514,8 @@ function selectConfig(raw) {
     config2.updateCheck = raw.updateCheck;
   if (typeof raw.setupCompleted === "boolean")
     config2.setupCompleted = raw.setupCompleted;
+  if (raw.briefing !== void 0)
+    config2.briefing = raw.briefing;
   return config2;
 }
 function findRetiredConfigKeys(raw) {
@@ -6469,7 +6568,7 @@ var init_config = __esm({
   "dist/core/config.js"() {
     "use strict";
     init_paths();
-    CONFIG_KEYS = ["autoCapture", "sessionLimit", "autoUpdate", "updateCheck", "setupCompleted"];
+    CONFIG_KEYS = ["autoCapture", "sessionLimit", "autoUpdate", "updateCheck", "setupCompleted", "briefing"];
     RETIRED_CONFIG_KEYS = [
       "llm",
       "llmFallbacks",
@@ -7365,7 +7464,7 @@ __export(util_exports, {
   getSizableOrigin: () => getSizableOrigin,
   hexToUint8Array: () => hexToUint8Array,
   isObject: () => isObject,
-  isPlainObject: () => isPlainObject,
+  isPlainObject: () => isPlainObject2,
   issue: () => issue,
   joinValues: () => joinValues,
   jsonStringifyReplacer: () => jsonStringifyReplacer,
@@ -7527,7 +7626,7 @@ function slugify2(input) {
 function isObject(data) {
   return typeof data === "object" && data !== null && !Array.isArray(data);
 }
-function isPlainObject(o) {
+function isPlainObject2(o) {
   if (isObject(o) === false)
     return false;
   const ctor = o.constructor;
@@ -7544,7 +7643,7 @@ function isPlainObject(o) {
   return true;
 }
 function shallowClone(o) {
-  if (isPlainObject(o))
+  if (isPlainObject2(o))
     return { ...o };
   if (Array.isArray(o))
     return [...o];
@@ -7684,7 +7783,7 @@ function omit(schema, mask) {
   return clone(schema, def);
 }
 function extend(schema, shape) {
-  if (!isPlainObject(shape)) {
+  if (!isPlainObject2(shape)) {
     throw new Error("Invalid input to extend: expected a plain object");
   }
   const checks = schema._zod.def.checks;
@@ -7707,7 +7806,7 @@ function extend(schema, shape) {
   return clone(schema, def);
 }
 function safeExtend(schema, shape) {
-  if (!isPlainObject(shape)) {
+  if (!isPlainObject2(shape)) {
     throw new Error("Invalid input to safeExtend: expected a plain object");
   }
   const def = mergeDefs(schema._zod.def, {
@@ -9225,7 +9324,7 @@ function mergeValues(a, b) {
   if (a instanceof Date && b instanceof Date && +a === +b) {
     return { valid: true, data: a };
   }
-  if (isPlainObject(a) && isPlainObject(b)) {
+  if (isPlainObject2(a) && isPlainObject2(b)) {
     const bKeys = Object.keys(b);
     const sharedKeys = Object.keys(a).filter((key) => bKeys.indexOf(key) !== -1);
     const newObj = { ...a, ...b };
@@ -10492,7 +10591,7 @@ var init_schemas = __esm({
       $ZodType.init(inst, def);
       inst._zod.parse = (payload, ctx) => {
         const input = payload.value;
-        if (!isPlainObject(input)) {
+        if (!isPlainObject2(input)) {
           payload.issues.push({
             expected: "record",
             code: "invalid_type",
@@ -23254,7 +23353,7 @@ function parseTargetKind(value) {
 }
 function parseJsonObject(json2, label) {
   const parsed = parseJsonObjectOrValue(json2);
-  if (!isPlainObject2(parsed))
+  if (!isPlainObject3(parsed))
     throw new AgentMessagingError(`${label} must contain a JSON object.`);
   return parsed;
 }
@@ -23304,7 +23403,7 @@ function assertJsonValue(value, label) {
     value.forEach((entry, index) => assertJsonValue(entry, `${label}[${index}]`));
     return;
   }
-  if (isPlainObject2(value)) {
+  if (isPlainObject3(value)) {
     for (const [key, entry] of Object.entries(value)) {
       assertJsonValue(entry, `${label}.${key}`);
     }
@@ -23316,7 +23415,7 @@ function normalizeObject(value) {
   assertJsonValue(value, "object");
   return value;
 }
-function isPlainObject2(value) {
+function isPlainObject3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function requireText(label, value, maxLength) {
@@ -23527,7 +23626,8 @@ var init_schemas3 = __esm({
     ImportSchema = external_exports.object({
       data: ExportResultSchema,
       namespace: external_exports.enum(NAMESPACES).optional(),
-      merge_strategy: external_exports.enum(["skip", "overwrite", "append"])
+      merge_strategy: external_exports.enum(["skip", "overwrite", "append"]),
+      restore_archived: external_exports.boolean().optional()
     }).strict();
     LearnSchema = external_exports.object({
       error: external_exports.string().min(1).max(5e3),
@@ -23808,7 +23908,73 @@ function taskStateLines(state, project, now = /* @__PURE__ */ new Date()) {
   }
   return lines;
 }
-var TASK_STATE_TYPE, TASK_STATE_FIELDS, MAX_FIELD_CHARS, FIELD_LABELS;
+function isLeapYear(year) {
+  return year % 4 === 0 && year % 100 !== 0 || year % 400 === 0;
+}
+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 === void 0 ? 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 === void 0) {
+    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) / 36e5;
+  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} \u2014 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 \u2014 not shown as current. Run \`memesh task\` to see or update it.`;
+}
+function briefingTaskStateLines(state, project, now = /* @__PURE__ */ 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) : [];
+}
+var TASK_STATE_TYPE, TASK_STATE_FIELDS, MAX_FIELD_CHARS, FIELD_LABELS, STALE_TASK_STATE_HOURS, CLOCK_SKEW_ALLOWANCE_MINUTES, ZONED_INSTANT, DAYS_IN_MONTH;
 var init_task_state = __esm({
   "dist/core/task-state.js"() {
     "use strict";
@@ -23821,6 +23987,10 @@ var init_task_state = __esm({
       blocked: "Blocked",
       done: "Had just finished"
     };
+    STALE_TASK_STATE_HOURS = 72;
+    CLOCK_SKEW_ALLOWANCE_MINUTES = 5;
+    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}))$/;
+    DAYS_IN_MONTH = [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
   }
 });
 
@@ -23927,7 +24097,7 @@ function unreadInboxLines(count, project, recipient, everSeen) {
   const displayRecipient = JSON.stringify(recipient);
   if (count > 0) {
     const noun = count === 1 ? "message" : "messages";
-    return [`${count} ${noun} waiting for ${displayRecipient} in project ${displayProject} \u2014 poll the message tool with project ${displayProject} and recipient ${displayRecipient}, then fetch each message_id; fetching does not acknowledge.`];
+    return [`${count} ${noun} waiting for ${displayRecipient} in project ${displayProject} \u2014 poll the message tool with project ${displayProject} and recipient ${displayRecipient}, then fetch each message_id and record the intake action for it: fetching alone does not acknowledge, and only intake ends this line.`];
   }
   if (everSeen === false) {
     return [`No messages waiting for ${displayRecipient} in project ${displayProject} \u2014 and this recipient id has never been seen in this project (check for a typo).`];
@@ -24090,6 +24260,9 @@ function assembleTopologyBlock(stateLines, pools, projectName, budget = DEFAULT_
   lines.push(...globalLines);
   return lines;
 }
+function hasBriefingContent(lines) {
+  return lines.length > 0;
+}
 function buildReferenceContext(memoryLines) {
   const safeLines = memoryLines.map((line) => String(line ?? "").replace(/[\s\u0085\u001c-\u001e]+/g, " ").trim());
   let longestRun = 0;
@@ -24293,6 +24466,85 @@ var init_briefing_index = __esm({
   }
 });
 
+// dist/core/briefing-level.js
+function isBriefingLevel(value) {
+  return typeof value === "string" && BRIEFING_LEVELS.includes(value);
+}
+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 >= 55296 && lastKept <= 56319;
+  const nextUnitIsLowSurrogate = nextUnit >= 56320 && nextUnit <= 57343;
+  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("")}\u2026`);
+    if (candidate.length > INVALID_VALUE_SERIALIZED_MAX)
+      break;
+  }
+  return JSON.stringify(`${codePoints.slice(0, kept).join("")}\u2026`);
+}
+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);
+}
+function resolveBriefingLevel(envValue, configValue) {
+  if (envValue !== void 0) {
+    if (isBriefingLevel(envValue))
+      return { level: envValue, invalid: null };
+    return { level: DEFAULT_BRIEFING_LEVEL, invalid: { source: "env", value: describeInvalidValue(envValue) } };
+  }
+  if (configValue !== void 0) {
+    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 };
+}
+function briefingLevelPolicy(level) {
+  return POLICIES[level];
+}
+var BRIEFING_LEVELS, DEFAULT_BRIEFING_LEVEL, INVALID_VALUE_SERIALIZED_MAX, PRE_SLICE_RAW_MAX, POLICIES;
+var init_briefing_level = __esm({
+  "dist/core/briefing-level.js"() {
+    "use strict";
+    BRIEFING_LEVELS = ["minimal", "standard", "full"];
+    DEFAULT_BRIEFING_LEVEL = "standard";
+    INVALID_VALUE_SERIALIZED_MAX = 100;
+    PRE_SLICE_RAW_MAX = 256;
+    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 }
+    };
+  }
+});
+
 // dist/core/briefing.js
 function parseMetadata(raw) {
   if (!raw)
@@ -24358,10 +24610,23 @@ function readBriefingIndex(db2, projectName, now = Date.now()) {
 function assembleBriefing(project, recipient) {
   const projectName = project ?? getProjectName();
   const db2 = getDatabase();
+  const resolvedLevel = resolveBriefingLevel(process.env.MEMESH_BRIEFING, readConfig().briefing);
+  if (resolvedLevel.invalid) {
+    const { source, value } = resolvedLevel.invalid;
+    try {
+      process.stderr.write(`[memesh briefing] invalid ${source} briefing level ${value} \u2014 using "${resolvedLevel.level}"
+`);
+    } catch {
+    }
+  }
+  const level = resolvedLevel.level;
+  const policy = briefingLevelPolicy(level);
   const repoLines = project === void 0 || project === getProjectName() ? repoStateLines(readRepoState()) : [];
   let taskLines;
   try {
-    taskLines = taskStateLines(getTaskState(projectName).state, projectName);
+    taskLines = briefingTaskStateLines(getTaskState(projectName).state, projectName, /* @__PURE__ */ new Date(), {
+      includeFresh: policy.taskState
+    });
   } catch (err) {
     if (!(err instanceof TaskStateUnreadableError))
       throw err;
@@ -24382,17 +24647,17 @@ function assembleBriefing(project, recipient) {
      ORDER BY e.id DESC
      LIMIT ?`).all(`project:${projectName}`, TOPOLOGY_CANDIDATE_CAP);
   const projectPool = selectPool(projectRows, PROJECT_LIMIT);
-  const globalRows = hasNamespace ? db2.prepare(`SELECT ${CANDIDATE_COLUMNS}
+  const globalRows = policy.global && hasNamespace ? db2.prepare(`SELECT ${CANDIDATE_COLUMNS}
        FROM entities e
        WHERE e.namespace = 'global' AND e.status = 'active'
        ORDER BY e.id DESC
        LIMIT ?`).all(TOPOLOGY_CANDIDATE_CAP) : [];
   const globalPool = selectPool(globalRows, GLOBAL_TOPOLOGY_LIMIT);
-  const recentRows = db2.prepare(`SELECT ${CANDIDATE_COLUMNS}
-     FROM entities e
-     WHERE e.status = 'active'${nonGlobal}
-     ORDER BY e.id DESC
-     LIMIT ?`).all(TOPOLOGY_CANDIDATE_CAP);
+  const recentRows = policy.foreign ? db2.prepare(`SELECT ${CANDIDATE_COLUMNS}
+       FROM entities e
+       WHERE e.status = 'active'${nonGlobal}
+       ORDER BY e.id DESC
+       LIMIT ?`).all(TOPOLOGY_CANDIDATE_CAP) : [];
   const recentPool = selectPool(recentRows, RECENT_LIMIT);
   const survivorIds = [...new Set([...projectPool, ...globalPool, ...recentPool].map((row) => row.id))];
   const snippets = /* @__PURE__ */ new Map();
@@ -24417,13 +24682,17 @@ function assembleBriefing(project, recipient) {
   ], projectName);
   const withRepo = lines.length > 0 && repoLines.length > 0 ? [...repoLines, "", ...lines] : lines;
   const index = readBriefingIndex(db2, projectName);
-  const block = withRepo.length > 0 ? [...withRepo, "", ...index.lines] : index.lines;
+  const indexLines = policy.index ? index.lines : [];
+  const block = withRepo.length > 0 && indexLines.length > 0 ? [...withRepo, "", ...indexLines] : [...withRepo, ...indexLines];
+  const empty = !hasBriefingContent(block);
   return {
     project: projectName,
-    text: buildReferenceContext(block),
+    text: empty ? "" : buildReferenceContext(block),
     entityCount: lines.filter((l) => l.startsWith("- [")).length,
     hasTaskState: stateLines.length > 0,
-    index
+    index,
+    level,
+    empty
   };
 }
 var PROJECT_LIMIT, RECENT_LIMIT, CANDIDATE_COLUMNS;
@@ -24432,6 +24701,7 @@ var init_briefing = __esm({
     "use strict";
     init_db();
     init_paths();
+    init_config();
     init_repo_state();
     init_scoring();
     init_task_state_store();
@@ -24440,6 +24710,7 @@ var init_briefing = __esm({
     init_task_state();
     init_briefing_index();
     init_work_topology();
+    init_briefing_level();
     PROJECT_LIMIT = 30;
     RECENT_LIMIT = 5;
     CANDIDATE_COLUMNS = "e.id, e.name, e.type, e.title, e.metadata, e.access_count, e.last_accessed_at, e.confidence, e.recall_hits, e.recall_misses";
@@ -24791,9 +25062,9 @@ import fs15 from "node:fs";
 import net from "node:net";
 import path14 from "node:path";
 function isLegacyAgentRouterVersionMismatchResponse(value) {
-  if (!isPlainObject3(value) || value.version !== 1 || value.request_id !== "" || value.ok !== false)
+  if (!isPlainObject4(value) || value.version !== 1 || value.request_id !== "" || value.ok !== false)
     return false;
-  if (!isPlainObject3(value.error))
+  if (!isPlainObject4(value.error))
     return false;
   return value.error.code === "unsupported_type" || value.error.code === "unsupported_version";
 }
@@ -24852,7 +25123,7 @@ async function sendAgentRouterRequest(socketPath, request, timeoutMs = DEFAULT_C
         if (isLegacyAgentRouterVersionMismatchResponse(response)) {
           throw new AgentRouterProtocolError("router_version_mismatch", "router_version_mismatch: the configured router endpoint uses a stale protocol; restart that router with the current MeMesh version.");
         }
-        const uncorrelatedError = response.request_id === "" && response.ok === false && isPlainObject3(response.error) && typeof response.error.code === "string" && typeof response.error.message === "string";
+        const uncorrelatedError = response.request_id === "" && response.ok === false && isPlainObject4(response.error) && typeof response.error.code === "string" && typeof response.error.message === "string";
         if (response.version !== AGENT_ROUTER_PROTOCOL_VERSION || response.request_id !== request.request_id && !uncorrelatedError) {
           throw new AgentRouterProtocolError("invalid_response", "Router response identity does not match.");
         }
@@ -24871,7 +25142,7 @@ async function sendAgentRouterRequest(socketPath, request, timeoutMs = DEFAULT_C
   });
 }
 function validateRouterSuccessResult(request, value) {
-  if (!isPlainObject3(value)) {
+  if (!isPlainObject4(value)) {
     throw new AgentRouterProtocolError("invalid_response", "Router response result must be an object.");
   }
   const requireResultString = (field) => {
@@ -24929,7 +25200,7 @@ function validateRouterSuccessResult(request, value) {
   return value;
 }
 function isSelectionCard(value, project) {
-  if (!isPlainObject3(value))
+  if (!isPlainObject4(value))
     return false;
   return typeof value.session_id === "string" && typeof value.principal_id === "string" && ["codex", "claude", "gemini", "other"].includes(String(value.host_kind)) && value.project === project && (value.model === null || typeof value.model === "string") && (value.work_summary === null || typeof value.work_summary === "string") && value.active === true && Number.isSafeInteger(value.generation) && value.generation >= 1 && Number.isSafeInteger(value.lease_expires_at_ms) && value.lease_expires_at_ms >= 0;
 }
@@ -24939,7 +25210,7 @@ function validateSocketPath(socketPath) {
   }
   return socketPath;
 }
-function isPlainObject3(value) {
+function isPlainObject4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var AGENT_ROUTER_PROTOCOL_VERSION, AGENT_ROUTER_MAX_FRAME_BYTES, MAX_LEASE_MS, DEFAULT_CLIENT_TIMEOUT_MS, MAX_FIELD_LENGTH, MAX_ADAPTER_RECEIPT_BYTES, AgentRouterError, AgentRouterProtocolError;
@@ -25710,6 +25981,10 @@ function exportOpenAITools() {
               type: "string",
               enum: ["skip", "overwrite", "append"],
               description: "Required. How to handle existing entities: skip, overwrite (replace), or append (merge observations)."
+            },
+            restore_archived: {
+              type: "boolean",
+              description: "Optional, default false. With append or overwrite, an archived (forgotten) local entity is left untouched and counted in kept_archived; true brings it back to active and merges or overwrites it, and requires append or overwrite (an error with skip)."
             }
           },
           required: ["data", "merge_strategy"]
@@ -25755,7 +26030,7 @@ function exportOpenAITools() {
       type: "function",
       function: {
         name: "memesh_briefing",
-        description: "The assembled work topology for a project: where the work was left off, decisions, lessons, knowledge, recent activity. Call once at the start of a session to load project context.",
+        description: "The assembled work topology for a project: where the work was left off (by default), decisions, lessons, knowledge, recent activity. Call once at the start of a session to load project context.",
         parameters: {
           type: "object",
           properties: {
@@ -42232,10 +42507,10 @@ var require_object_inspect = __commonJS({
       }
       if (!isDate(obj) && !isRegExp(obj)) {
         var ys = arrObjKeys(obj, inspect);
-        var isPlainObject4 = gPO ? gPO(obj) === Object.prototype : obj instanceof Object || obj.constructor === Object;
+        var isPlainObject5 = gPO ? gPO(obj) === Object.prototype : obj instanceof Object || obj.constructor === Object;
         var protoTag = obj instanceof Object ? "" : "null prototype";
-        var stringTag = !isPlainObject4 && toStringTag && Object(obj) === obj && toStringTag in obj ? $slice.call(toStr(obj), 8, -1) : protoTag ? "Object" : "";
-        var constructorTag = isPlainObject4 || typeof obj.constructor !== "function" ? "" : obj.constructor.name ? obj.constructor.name + " " : "";
+        var stringTag = !isPlainObject5 && toStringTag && Object(obj) === obj && toStringTag in obj ? $slice.call(toStr(obj), 8, -1) : protoTag ? "Object" : "";
+        var constructorTag = isPlainObject5 || typeof obj.constructor !== "function" ? "" : obj.constructor.name ? obj.constructor.name + " " : "";
         var tag = constructorTag + (stringTag || protoTag ? "[" + $join.call($concat.call([], stringTag || [], protoTag || []), ": ") + "] " : "");
         if (ys.length === 0) {
           return tag + "{}";
@@ -55352,6 +55627,7 @@ var init_capture_liveness = __esm({
       noFilePath: "no file_path in the tool input",
       noDatabaseForRecall: "no database yet \u2014 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",
@@ -58343,7 +58619,7 @@ MeMesh HTTP: bearer token generated for remote access.
 function __setRemoteTokenForTest(value) {
   remoteToken = value;
 }
-var import_express, packageJsonPath, packageRoot, packageVersion, app, apiLimiter, remoteToken, serverAuthRequired, CROSS_SITE_REFUSAL, DoctorFixBody, HttpError, ConfigBody, TaskStateQuerySchema, DreamProposalsQuerySchema, RejectBodySchema, EntitiesQuerySchema, HOST, PORT, ALLOW_REMOTE_BY_ENV, isMain, shutdown;
+var import_express, packageJsonPath, packageRoot, packageVersion, app, apiLimiter, remoteToken, serverAuthRequired, CROSS_SITE_REFUSAL, DoctorFixBody, HttpError, ConfigReadBody, ConfigBody, TaskStateQuerySchema, DreamProposalsQuerySchema, RejectBodySchema, EntitiesQuerySchema, HOST, PORT, ALLOW_REMOTE_BY_ENV, isMain, shutdown;
 var init_server = __esm({
   "dist/transports/http/server.js"() {
     "use strict";
@@ -58354,6 +58630,7 @@ var init_server = __esm({
     init_operations();
     init_knowledge_graph();
     init_config();
+    init_briefing_level();
     init_doctor_fixes();
     init_patterns();
     init_analytics();
@@ -58553,14 +58830,22 @@ var init_server = __esm({
         limit: data.limit
       });
     }));
+    ConfigReadBody = external_exports.object({
+      autoCapture: external_exports.boolean().optional(),
+      sessionLimit: external_exports.number().int().min(1).max(100).optional(),
+      autoUpdate: external_exports.enum(["off", "patch", "minor", "major"]).optional(),
+      setupCompleted: external_exports.boolean().optional(),
+      briefing: external_exports.unknown().optional()
+    }).strip();
     app.get("/v1/config", (_req, res) => handleGet(res, () => ({
-      config: ConfigBody.strip().parse(readConfig())
+      config: ConfigReadBody.parse(readConfig())
     })));
     ConfigBody = external_exports.object({
       autoCapture: external_exports.boolean().optional(),
       sessionLimit: external_exports.number().int().min(1).max(100).optional(),
       autoUpdate: external_exports.enum(["off", "patch", "minor", "major"]).optional(),
-      setupCompleted: external_exports.boolean().optional()
+      setupCompleted: external_exports.boolean().optional(),
+      briefing: external_exports.enum(BRIEFING_LEVELS).optional()
     }).strict();
     app.post("/v1/config", (req, res) => handlePost(ConfigBody, req, res, (data) => ConfigBody.strip().parse(updateConfig(data))));
     app.get("/v1/update-status", (req, res) => handleGet(res, async () => {
@@ -60344,6 +60629,7 @@ function summarizeNoteIngest(r) {
 
 // dist/transports/cli/cli.js
 init_briefing();
+init_briefing_level();
 init_work_topology();
 
 // dist/core/session-insight.js
@@ -61290,15 +61576,15 @@ program2.command("export").description("Export memories as JSON. Defaults to std
     }
   });
 });
-program2.command("import").description("Import memories from a JSON export file, or a directory of note files (--notes)").argument("[file]", "Path to JSON export file").option("--namespace <ns>", "Override namespace for all imported entities").option("--merge <strategy>", "Merge strategy: skip | overwrite | append", "skip").option("--notes <dir>", "Ingest every frontmatter note file (*.md with name/description/metadata.type) under <dir>: one memory per file, tagged source:note-file; a changed file replaces its memory, a vanished one is tagged source:note-file:missing. Read-only on the directory.").option("--project <name>", "With --notes: the project tag for ingested memories (default: the current directory's project)").option("--json", "With --notes: output the ingestion result as JSON").action(async (file2, opts, cmd) => {
+program2.command("import").description("Import memories from a JSON export file, or a directory of note files (--notes)").argument("[file]", "Path to JSON export file").option("--namespace <ns>", "Override namespace for all imported entities").option("--merge <strategy>", "Merge strategy: skip | overwrite | append", "skip").option("--restore-archived", "Requires --merge append or overwrite (an error with skip, the default): bring back a local memory you archived (forgot) when the file names it. Without this it stays archived and untouched.").option("--notes <dir>", "Ingest every frontmatter note file (*.md with name/description/metadata.type) under <dir>: one memory per file, tagged source:note-file; a changed file replaces its memory, a vanished one is tagged source:note-file:missing. Read-only on the directory.").option("--project <name>", "With --notes: the project tag for ingested memories (default: the current directory's project)").option("--json", "With --notes: output the ingestion result as JSON").action(async (file2, opts, cmd) => {
   if (opts.notes !== void 0) {
     if (file2) {
       console.error("Error: pass either a JSON export file or --notes <dir>, not both.");
       process.exit(1);
     }
-    const ignored = ["namespace", "merge"].filter((k) => cmd.getOptionValueSource(k) === "cli");
+    const ignored = ["namespace", "merge", "restoreArchived"].filter((k) => cmd.getOptionValueSource(k) === "cli");
     if (ignored.length > 0) {
-      console.error(`Error: --notes does not take ${ignored.map((k) => `--${k}`).join(" or ")}. Note files always go to the personal namespace and a changed file replaces its memory.`);
+      console.error(`Error: --notes does not take ${ignored.map((k) => `--${k.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)}`).join(" or ")}. Note files always go to the personal namespace and a changed file replaces its memory.`);
       process.exit(1);
     }
     await withDatabase(() => {
@@ -61330,7 +61616,7 @@ program2.command("import").description("Import memories from a JSON export file,
   }
   const notesOnly = ["project", "json"].filter((k) => cmd.getOptionValueSource(k) === "cli");
   if (notesOnly.length > 0) {
-    console.error(`Error: ${notesOnly.map((k) => `--${k}`).join(" and ")} only appl${notesOnly.length > 1 ? "y" : "ies"} to --notes. A JSON export file is imported with --namespace and --merge.`);
+    console.error(`Error: ${notesOnly.map((k) => `--${k}`).join(" and ")} only appl${notesOnly.length > 1 ? "y" : "ies"} to --notes. A JSON export file is imported with --namespace, --merge and --restore-archived.`);
     process.exit(1);
   }
   requireOneOf(opts.merge, ["skip", "overwrite", "append"], "--merge");
@@ -61369,7 +61655,8 @@ program2.command("import").description("Import memories from a JSON export file,
       result = importMemories({
         data,
         namespace: opts.namespace,
-        merge_strategy: opts.merge
+        merge_strategy: opts.merge,
+        restore_archived: opts.restoreArchived === true
       });
     } catch (err) {
       console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
@@ -61377,6 +61664,9 @@ program2.command("import").description("Import memories from a JSON export file,
     }
     const overwriteNote = result.overwritten > 0 ? ` (${result.overwritten} overwritten)` : "";
     console.log(`Imported: ${result.imported}${overwriteNote}, Skipped: ${result.skipped}, Appended: ${result.appended}`);
+    if (result.kept_archived > 0) {
+      console.log(`Kept archived: ${result.kept_archived} (you archived these; the file names them, so they were left untouched). Add --restore-archived to bring them back.`);
+    }
     if (result.skipped_relations.length > 0) {
       console.error(`Note: ${result.skipped_relations.length} relation(s) not restored \u2014 the target is not in this bundle:
   ${result.skipped_relations.join("\n  ")}`);
@@ -61663,7 +61953,7 @@ agentCmd.command("setup").argument("<host>", "codex-session | codex | claude | g
     ]
   ].join("\n"));
 });
-program2.command("briefing").description("The assembled work topology for a project \u2014 task state, decisions, lessons, knowledge, recent activity").option("--project <name>", "Project name (default: the current directory\u2019s project)").option("--recipient <id>", "Exact recipient; enables recipient-scoped unread message guidance").option("--index", "Only the index of durable memories (decisions, lessons, patterns, references), newest first").option("--json", "Output as JSON").action(async (opts) => {
+program2.command("briefing").description("The assembled work topology for a project \u2014 decisions, lessons, knowledge and recent activity; task state and the durable-memory index are included at standard/full (the `briefing` setting)").option("--project <name>", "Project name (default: the current directory\u2019s project)").option("--recipient <id>", "Exact recipient; enables recipient-scoped unread message guidance").option("--index", "Only the index of durable memories (decisions, lessons, patterns, references), newest first").option("--json", "Output as JSON").action(async (opts) => {
   await withDatabase(() => {
     if (opts.index) {
       const project = opts.project ?? getProjectName();
@@ -61680,6 +61970,10 @@ program2.command("briefing").description("The assembled work topology for a proj
       console.log(JSON.stringify(result));
       return;
     }
+    if (result.empty) {
+      console.log(`Nothing to brief at level ${result.level} \u2014 no project memories yet.`);
+      return;
+    }
     console.log(result.text);
     if (result.entityCount === 0 && !result.hasTaskState && result.index.shown === 0 && result.index.older === 0) {
       console.log(`
@@ -61905,23 +62199,24 @@ configCmd.command("list").description("Show current configuration").action(() =>
       console.log(`  ${key}: ${value}`);
   }
 });
-var ALLOWED_KEYS = /* @__PURE__ */ new Set(["autoUpdate", "sessionLimit", "autoCapture", "updateCheck"]);
+var ALLOWED_KEYS = /* @__PURE__ */ new Set(["autoUpdate", "sessionLimit", "autoCapture", "updateCheck", "briefing"]);
 var KEY_VALIDATORS = {
   autoUpdate: (v) => ["off", "patch", "minor", "major"].includes(v) ? null : "must be one of: off, patch, minor, major",
   autoCapture: (v) => ["true", "false", "1", "0"].includes(v) ? null : "must be one of: true, false, 1, 0",
-  updateCheck: (v) => ["true", "false", "1", "0"].includes(v) ? null : "must be one of: true, false, 1, 0"
+  updateCheck: (v) => ["true", "false", "1", "0"].includes(v) ? null : "must be one of: true, false, 1, 0",
+  briefing: (v) => BRIEFING_LEVELS.includes(v) ? null : `must be one of: ${BRIEFING_LEVELS.join(", ")}`
 };
 function buildConfigListing(config2) {
   const rows = [];
   for (const key of Array.from(ALLOWED_KEYS).sort()) {
     const raw = config2[key];
-    if (raw === void 0 || raw === null)
+    if (raw === void 0)
       continue;
     rows.push({ key, value: String(raw) });
   }
   return rows;
 }
-configCmd.command("set").description("Set an ordinary config value (autoCapture, sessionLimit, autoUpdate, updateCheck)").argument("<key>", "Config key \u2014 see `memesh config list` for valid keys").argument("<value>", "Config value").action((key, value) => {
+configCmd.command("set").description("Set an ordinary config value (autoCapture, sessionLimit, autoUpdate, updateCheck, briefing)").argument("<key>", "Config key \u2014 see `memesh config list` for valid keys").argument("<value>", "Config value").action((key, value) => {
   const canonical = key;
   if (!ALLOWED_KEYS.has(canonical)) {
     console.error(`Unknown key: ${key}`);