@fml-inc/fml 0.8.0 → 0.8.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "fml",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "FML agent tools for Claude Code",
   "mcpServers": {
     "fml": {

package/dist/cli.js

@@ -124,7 +124,7 @@ var POLL_INTERVAL_MS = 50;
 var LOG_ROTATE_BYTES = 10 * 1024 * 1024;
 var LOG_ROTATE_FILES = 3;
 function expectedObserverVersion() {
-  return true ? "0.8.0+246af775" : "dev";
+  return true ? "0.8.1+532464ef" : "dev";
 }
 function delay(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
@@ -7895,7 +7895,7 @@ async function handleUninstall(opts) {
 // src/commands/update.ts
 var SEMVER_PATTERN = /^(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)\.(?:0|[1-9][0-9]*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
 function getCurrentVersion() {
-  return true ? "0.8.0+246af775" : "unknown";
+  return true ? "0.8.1+532464ef" : "unknown";
 }
 function resolveUpdateChannel(version) {
   const match = SEMVER_PATTERN.exec(version);
@@ -8929,7 +8929,7 @@ async function handleConfigDetail(opts) {
 // src/commands/tools.ts
 import { readFileSync } from "fs";
 import path29 from "path";
-var pluginVersion = true ? "0.8.0+246af775" : void 0;
+var pluginVersion = true ? "0.8.1+532464ef" : void 0;
 async function getApi() {
   const api = await getAuthenticatedClient();
   if (!api) {
@@ -9086,7 +9086,7 @@ if (process.argv.length <= 2 || process.argv.includes("--help") || process.argv.
   printBanner();
 }
 var program = new Command().name("fml").description("FML CLI and agent tools").version(
-  true ? "0.8.0+246af775" : "dev"
+  true ? "0.8.1+532464ef" : "dev"
 );
 function formatCommandInventory(cmd, prefix = "") {
   const name = prefix ? `${prefix} ${cmd.name()}` : cmd.name();

package/dist/hook-handler.js

@@ -35,7 +35,15 @@ import fs from "fs";
 import path from "path";
 var HOOK_CONTEXT_ENDPOINT = "/v1/panopticon/hook-context";
 var HOOK_CONTEXT_TIMEOUT_MS = 2e3;
-var MAX_ADDITIONAL_CONTEXT_CHARS = 4e3;
+var MAX_ADDITIONAL_CONTEXT_CHARS = 3700;
+var MAX_RECEIPT_ITEMS = 5;
+var MAX_RECEIPT_LABEL_CHARS = 48;
+var MAX_RECEIPT_SUMMARY_CHARS = 240;
+var MAX_RECEIPT_PRIORITY = 100;
+var MAX_RECEIPT_TIMESTAMP_MS = 864e13;
+var MAX_RENDERED_RECEIPT_ITEMS = 3;
+var MODEL_CONTEXT_GUIDANCE = "If this FML context materially informs your work, naturally mention FML, the specific context used, and how it informed your work in the final response. Otherwise, do not mention it. Do not claim causal impact or time savings.";
+var CONTEXT_GUIDANCE_SEPARATOR = "\n\n";
 var MAX_PROMPT_CHARS = 2e4;
 var STATE_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1e3;
 var EDIT_TOOL_NAMES = /* @__PURE__ */ new Set([
@@ -184,11 +192,246 @@ function buildServerHookContextRequest(target2, event, stateDir = FML_HOOK_CONTE
   }
   return { ...base, eventType: "PreToolUse", filePath, fileOperation };
 }
-function hookOutput(request, additionalContext) {
+var RECEIPT_LABELS = /* @__PURE__ */ new Set([
+  "Recent work",
+  "Relevant history",
+  "File history",
+  "Related files"
+]);
+function isSanitizedInlineText(value, maxChars) {
+  return value.length > 0 && value.length <= maxChars && !/[\u0000-\u001F\u007F-\u009F\u061C\u200E\u200F\u202A-\u202E\u2066-\u2069]/u.test(
+    value
+  ) && value === value.replace(/\s+/g, " ").trim();
+}
+function isReceiptItem(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const item = value;
+  return typeof item.label === "string" && RECEIPT_LABELS.has(item.label) && isSanitizedInlineText(item.label, MAX_RECEIPT_LABEL_CHARS) && typeof item.summary === "string" && isSanitizedInlineText(item.summary, MAX_RECEIPT_SUMMARY_CHARS) && typeof item.priority === "number" && Number.isSafeInteger(item.priority) && item.priority >= 0 && item.priority <= MAX_RECEIPT_PRIORITY && (item.occurredAtMs === void 0 || typeof item.occurredAtMs === "number" && Number.isSafeInteger(item.occurredAtMs) && item.occurredAtMs >= 0 && item.occurredAtMs <= MAX_RECEIPT_TIMESTAMP_MS);
+}
+function receiptItemsFromResponse(value) {
+  if (value === void 0) return [];
+  if (!Array.isArray(value) || value.length > MAX_RECEIPT_ITEMS) return null;
+  if (!value.every(isReceiptItem)) return null;
+  return value;
+}
+var RECEIPT_LINE_WIDTH = 88;
+var RECEIPT_SEGMENTER = new Intl.Segmenter(void 0, {
+  granularity: "grapheme"
+});
+function isFullWidthCodePoint(codePoint) {
+  return codePoint >= 4352 && (codePoint <= 4447 || codePoint === 9001 || codePoint === 9002 || codePoint >= 11904 && codePoint <= 42191 && codePoint !== 12351 || codePoint >= 44032 && codePoint <= 55203 || codePoint >= 63744 && codePoint <= 64255 || codePoint >= 65040 && codePoint <= 65049 || codePoint >= 65072 && codePoint <= 65135 || codePoint >= 65280 && codePoint <= 65376 || codePoint >= 65504 && codePoint <= 65510 || // Supplementary CJK-adjacent scripts and Japanese kana are rendered
+  // double-width by terminals. Keep these deliberately conservative:
+  // wrapping early is safer than emitting a line beyond the receipt bound.
+  codePoint >= 94176 && codePoint <= 94207 || codePoint >= 94208 && codePoint <= 100351 || codePoint >= 100352 && codePoint <= 101887 || codePoint >= 110592 && codePoint <= 111359 || codePoint >= 127488 && codePoint <= 127569 || codePoint >= 131072 && codePoint <= 262141);
+}
+function isDefaultIgnorableOrMark(value) {
+  return /^[\p{Mark}\p{Default_Ignorable_Code_Point}]+$/u.test(value);
+}
+function isEmojiGrapheme(value) {
+  return new RegExp("\\p{Extended_Pictographic}", "u").test(value) || /[\u{1F1E6}-\u{1F1FF}]/u.test(value) || value.includes("\u20E3");
+}
+function receiptDisplayWidth(value) {
+  let width = 0;
+  for (const { segment } of RECEIPT_SEGMENTER.segment(value)) {
+    if (isDefaultIgnorableOrMark(segment)) continue;
+    if (isEmojiGrapheme(segment)) {
+      width += 2;
+      continue;
+    }
+    const codePoints = [...segment].map(
+      (character) => character.codePointAt(0)
+    );
+    width += codePoints.some(
+      (codePoint) => codePoint !== void 0 && isFullWidthCodePoint(codePoint)
+    ) ? 2 : 1;
+  }
+  return width;
+}
+function takeGraphemesToWidth(value, maxWidth) {
+  let rendered = "";
+  let renderedWidth = 0;
+  for (const { segment } of RECEIPT_SEGMENTER.segment(value)) {
+    const segmentWidth = receiptDisplayWidth(segment);
+    if (renderedWidth + segmentWidth > maxWidth) break;
+    rendered += segment;
+    renderedWidth += segmentWidth;
+  }
+  return rendered;
+}
+function splitAtDisplayWidth(value, maxWidth) {
+  let renderedWidth = 0;
+  let end = 0;
+  let lastWhitespaceEnd = 0;
+  for (const { segment, index } of RECEIPT_SEGMENTER.segment(value)) {
+    const segmentWidth = receiptDisplayWidth(segment);
+    if (renderedWidth + segmentWidth > maxWidth) break;
+    renderedWidth += segmentWidth;
+    end = index + segment.length;
+    if (/^\s$/u.test(segment)) lastWhitespaceEnd = end;
+  }
+  if (end === value.length) return { head: value, tail: "" };
+  if (lastWhitespaceEnd > 0) {
+    return {
+      head: value.slice(0, lastWhitespaceEnd).trimEnd(),
+      tail: value.slice(lastWhitespaceEnd).trimStart()
+    };
+  }
+  return { head: value.slice(0, end), tail: value.slice(end) };
+}
+function isSafeInlineCode(value) {
+  if (!/^[A-Za-z0-9@._/$-]+$/u.test(value)) return false;
+  const segments = value.split("/");
+  if (segments.some(
+    (segment) => segment === "" || segment === "." || segment === ".."
+  )) {
+    return false;
+  }
+  return value.includes("/") || /^[^.]+\.[A-Za-z0-9_-]+$/u.test(value) || /^[A-Za-z_$][A-Za-z0-9_$]*$/u.test(value);
+}
+function removeMarkdownEmphasis(value) {
+  return value.replace(/(\*\*|__)(.+?)\1/gu, "$2").replace(/~~(.+?)~~/gu, "$1").replace(/(?<!\w)\*([^*]+)\*(?!\w)/gu, "$1").replace(/(?<!\w)_([^_]+)_(?!\w)/gu, "$1");
+}
+var UNSAFE_RECEIPT_CHARACTERS = /[\u0000-\u001F\u007F-\u009F\u061C\u200E\u200F\u202A-\u202E\u2066-\u2069]/gu;
+var HTML_CHARACTER_REFERENCE = /&(?:#(?:[xX][0-9A-Fa-f]+|\d+)|[A-Za-z][A-Za-z0-9]+);/gu;
+function renderReceiptPlainText(value) {
+  return removeMarkdownEmphasis(value).replace(HTML_CHARACTER_REFERENCE, "character reference").replace(/\\([\\`*_{}\[\]<>()[\]#+\-=!|])/gu, "$1").replace(/`/gu, "");
+}
+function renderReceiptSummary(summary) {
+  const withoutLinks = summary.replace(UNSAFE_RECEIPT_CHARACTERS, "").replace(/!?\[([^\]]*)\]\([^)]*\)/gu, "$1").replace(/!?\[([^\]]*)\]\[[^\]]*\]/gu, "$1").replace(/<https?:\/\/[^>\s]+>/gu, "link").replace(/https?:\/\/[^\s<>()]+/gu, "link").replace(/<[^>]*>/gu, "");
+  let rendered = "";
+  let cursor = 0;
+  for (const match of withoutLinks.matchAll(/`([^`\r\n]+)`/gu)) {
+    const matchIndex = match.index ?? 0;
+    rendered += renderReceiptPlainText(withoutLinks.slice(cursor, matchIndex));
+    const content = match[1] ?? "";
+    rendered += isSafeInlineCode(content) ? `\`${content}\`` : renderReceiptPlainText(content);
+    cursor = matchIndex + match[0].length;
+  }
+  return `${rendered}${renderReceiptPlainText(withoutLinks.slice(cursor))}`.replace(/\s+/gu, " ").trim();
+}
+function truncateInlineCodeToken(token, maxWidth) {
+  const content = token.slice(1, -1);
+  const ellipsisWidth = receiptDisplayWidth("\u2026");
+  const contentWidth = maxWidth - 2 - ellipsisWidth;
+  if (contentWidth < 1) return "";
+  return `\`${takeGraphemesToWidth(content, contentWidth)}\u2026\``;
+}
+function splitInlineCodeToken(token) {
+  const match = /^(`[^`]+`)([.,;:!?)}\]]*)$/u.exec(token);
+  if (!match) return null;
+  return {
+    inlineCode: match[1] ?? "",
+    trailingPunctuation: match[2] ?? ""
+  };
+}
+function wrapReceiptDetail(label, detail) {
+  const firstPrefix = `\u2502 ${label}: `;
+  const continuationPrefix = "\u2502   ";
+  const lines = [];
+  let remaining = detail;
+  let prefix = firstPrefix;
+  while (remaining) {
+    const available = RECEIPT_LINE_WIDTH - receiptDisplayWidth(prefix);
+    if (receiptDisplayWidth(remaining) <= available) {
+      lines.push(`${prefix}${remaining}`);
+      break;
+    }
+    const tokenEnd = remaining.search(/\s/u);
+    const token = tokenEnd === -1 ? remaining : remaining.slice(0, tokenEnd);
+    const inlineCodeToken = splitInlineCodeToken(token);
+    const inlineCodeWidth = inlineCodeToken ? receiptDisplayWidth(inlineCodeToken.inlineCode) + receiptDisplayWidth(inlineCodeToken.trailingPunctuation) : 0;
+    if (inlineCodeToken && inlineCodeWidth > available) {
+      const codeWidth = available - receiptDisplayWidth(inlineCodeToken.trailingPunctuation);
+      if (codeWidth >= 3) {
+        lines.push(
+          `${prefix}${truncateInlineCodeToken(
+            inlineCodeToken.inlineCode,
+            codeWidth
+          )}${inlineCodeToken.trailingPunctuation}`
+        );
+        remaining = tokenEnd === -1 ? "" : remaining.slice(tokenEnd).trimStart();
+      } else {
+        lines.push(
+          `${prefix}${truncateInlineCodeToken(
+            inlineCodeToken.inlineCode,
+            available
+          )}`
+        );
+        remaining = `${inlineCodeToken.trailingPunctuation}${tokenEnd === -1 ? "" : ` ${remaining.slice(tokenEnd).trimStart()}`}`;
+      }
+    } else {
+      const { head, tail } = splitAtDisplayWidth(remaining, available);
+      if (!head) return [];
+      lines.push(`${prefix}${head}`);
+      remaining = tail;
+    }
+    prefix = continuationPrefix;
+  }
+  return lines;
+}
+function formatReceiptTime(occurredAtMs, nowMs) {
+  const elapsedMs = nowMs - occurredAtMs;
+  const dayMs = 24 * 60 * 60 * 1e3;
+  if (elapsedMs >= 0 && elapsedMs < 30 * dayMs) {
+    const days = Math.floor(elapsedMs / dayMs);
+    if (days === 0) return "today";
+    if (days === 1) return "yesterday";
+    if (days < 7) return `${days} days ago`;
+    const weeks = Math.floor(days / 7);
+    return `${weeks} week${weeks === 1 ? "" : "s"} ago`;
+  }
+  try {
+    return new Intl.DateTimeFormat(void 0, {
+      month: "short",
+      day: "numeric",
+      year: "numeric"
+    }).format(new Date(occurredAtMs));
+  } catch {
+    return "";
+  }
+}
+function renderHookContextReceipt(receiptItems, nowMs) {
+  try {
+    const displayedDetails = [];
+    for (const { item } of receiptItems.map((item2, index) => ({ item: item2, index })).sort(
+      (left, right) => right.item.priority - left.item.priority || left.index - right.index
+    )) {
+      const summary = renderReceiptSummary(item.summary);
+      if (!summary) continue;
+      const time = item.occurredAtMs === void 0 ? "" : formatReceiptTime(item.occurredAtMs, nowMs);
+      const detailLines = wrapReceiptDetail(
+        item.label,
+        `${summary}${time ? ` (${time})` : ""}`
+      );
+      if (detailLines.length === 0) continue;
+      displayedDetails.push(detailLines);
+      if (displayedDetails.length === MAX_RENDERED_RECEIPT_ITEMS) break;
+    }
+    const displayedItemCount = displayedDetails.length;
+    const remainingItemCount = receiptItems.length - displayedItemCount;
+    return receiptItems.length > 0 ? [
+      "",
+      "\u256D\u2500 FML provided context:",
+      ...displayedDetails.flat(),
+      ...remainingItemCount > 0 ? [
+        `\u2502 +${remainingItemCount} more context item${remainingItemCount === 1 ? "" : "s"}`
+      ] : [],
+      "\u2570\u2500"
+    ].join("\n") : null;
+  } catch {
+    return null;
+  }
+}
+function appendModelContextGuidance(additionalContext) {
+  return `${additionalContext}${CONTEXT_GUIDANCE_SEPARATOR}${MODEL_CONTEXT_GUIDANCE}`;
+}
+function hookOutput(request, additionalContext, receiptItems) {
+  const receipt = renderHookContextReceipt(receiptItems, request.nowMs);
   return {
+    ...receipt ? { systemMessage: receipt } : {},
     hookSpecificOutput: {
       hookEventName: request.eventType,
-      additionalContext
+      additionalContext: appendModelContextGuidance(additionalContext)
     }
   };
 }
@@ -231,7 +474,8 @@ async function requestServerHookContext(target2, event, destination, opts = {})
     if (!response.ok) return {};
     const body = await response.json();
     if (!body || typeof body !== "object" || Array.isArray(body)) return {};
-    const additionalContext = body.additionalContext;
+    const responseBody = body;
+    const additionalContext = responseBody.additionalContext;
     if (request.eventType === "PreToolUse" && request.filePath && additionalContext === null) {
       claimPathContext(
         `${target2}:${request.sessionId}`,
@@ -243,6 +487,7 @@ async function requestServerHookContext(target2, event, destination, opts = {})
     if (typeof additionalContext !== "string" || additionalContext.length === 0 || additionalContext.length > MAX_ADDITIONAL_CONTEXT_CHARS) {
       return {};
     }
+    const receiptItems = receiptItemsFromResponse(responseBody.receiptItems);
     if (request.eventType === "PreToolUse" && request.filePath && !claimPathContext(
       `${target2}:${request.sessionId}`,
       `${request.repository}:${request.filePath}`,
@@ -250,7 +495,7 @@ async function requestServerHookContext(target2, event, destination, opts = {})
     )) {
       return {};
     }
-    return hookOutput(request, additionalContext);
+    return hookOutput(request, additionalContext, receiptItems ?? []);
   } catch {
     return {};
   }

package/dist/observer-server.js

@@ -1239,7 +1239,7 @@ var hookRejectionStatus = () => ({
   ...lastRejectedReason !== void 0 ? { lastRejectedReason } : {},
   ...lastRejectedTarget !== void 0 ? { lastRejectedTarget } : {}
 });
-var packageVersion = true ? "0.8.0+246af775" : "dev";
+var packageVersion = true ? "0.8.1+532464ef" : "dev";
 var health = () => ({
   status: "ok",
   service: OBSERVER_SERVICE_NAME,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fml-inc/fml",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "FML CLI and agent tools",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",