@compr/opscontext-mcp 2.5.4 → 2.5.5

package/dist/cli.js

@@ -646,7 +646,7 @@ import { SERVER_COMMANDS, suggestCommands } from "./cli-commands.js";
 import { collectProjectOps, collectSystemOps } from "./collectors.js";
 import { scanCodeDir } from "./code-chunker.js";
 import { listProjects, runComplianceAudit, formatProjectList, formatPlan, scoreProject, runScoreCanary, formatScoreReport, generateScoreHTML, generateProjectScoreMD, } from "./agents.js";
-import { listLearnings, learningsToChunks, learningsStats, formatLearnings, saveLearning, deleteLearning, importLearningsFromFile, autoImportFromSources, LEARNING_CATEGORIES, } from "./learnings.js";
+import { listLearnings, parseSince, learningsToChunks, learningsStats, formatLearnings, saveLearning, deleteLearning, importLearningsFromFile, autoImportFromSources, LEARNING_CATEGORIES, } from "./learnings.js";
 import { saveSession, loadSession, listSessions, deleteSession, formatSession, formatSessionList, } from "./sessions.js";
 import { activate, deactivate, getActivationStatus, gateCheck, } from "./activation.js";
 import { syncTierA, syncTierB, loadCommunityStore, communityRulesToChunks, mergeWithDedup, STORE_PATH as COMMUNITY_STORE_PATH, } from "./community-sync.js";
@@ -755,12 +755,37 @@ async function cliListProjects() {
     const text = formatProjectList(projects);
     console.log(`\n${text}`);
 }
-async function cliListLearnings(category) {
+async function cliListLearnings(args) {
+    // list-learnings [category] [--since today|yesterday|ISO]. [LOCK] [LEARNINGS-LIST-SHOWS-CREATED]
+    let category;
+    let sinceSpec;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "--since") {
+            sinceSpec = args[i + 1];
+            if (!sinceSpec) {
+                console.error("--since needs a value: today, yesterday, or an ISO date");
+                process.exit(1);
+            }
+            i++;
+        }
+        else if (!category) {
+            category = args[i];
+        }
+    }
+    let since;
+    if (sinceSpec) {
+        const parsed = parseSince(sinceSpec);
+        if (!parsed) {
+            console.error(`--since "${sinceSpec}" is not today, yesterday, or an ISO date. Refusing to answer with a zero.`);
+            process.exit(1);
+        }
+        since = parsed;
+    }
     // Project-scoped: only show learnings for workspace projects + universal
     const projectDirs = loadProjectDirs();
     const projectNames = projectDirs.map((d) => d.name);
     const learnings = listLearnings(category, projectNames);
-    const text = formatLearnings(learnings);
+    const text = formatLearnings(learnings, { since, sinceSpec });
     console.log(`\n${text}`);
 }
 async function cliSaveLearning(args) {
@@ -2458,7 +2483,8 @@ Usage:
   contextengine search <query> [-n N]  Search indexed knowledge (default: top 5)
   contextengine list-sources           Show all indexed sources with chunk counts
   contextengine list-projects          Discover and analyze all projects (Pro)
-  contextengine list-learnings [cat]   List all learnings (optional: filter by category)
+  contextengine list-learnings [cat] [--since today|yesterday|ISO]
+                                       List learnings with their created instant (UTC + Europe/Zurich)
   contextengine save-learning <text> -c <category>  Save a learning
   contextengine delete-learning <id>   Delete a learning by ID
   contextengine import-learnings <file> [-c cat] [-p project]  Bulk-import learnings
@@ -2579,8 +2605,7 @@ else if (command === "list-projects") {
     });
 }
 else if (command === "list-learnings") {
-    const category = process.argv[3];
-    cliListLearnings(category).catch((err) => {
+    cliListLearnings(process.argv.slice(3)).catch((err) => {
         console.error("Error:", err);
         process.exit(1);
     });

package/dist/index.js

@@ -14,7 +14,7 @@ import { verifyChain, readAuditLog, filterByRange, autoRotateAuditLog } from "./
 import { startEventIngestServer } from "./http-server.js";
 import { detect } from "./detector.js";
 import { buildCostReport } from "./cost-report.js";
-import { saveLearning, searchLearnings, listLearnings, deleteLearning, learningsToChunks, learningsStats, formatLearnings, importLearningsFromFile, autoImportFromSources, LEARNING_CATEGORIES, } from "./learnings.js";
+import { saveLearning, searchLearnings, listLearnings, deleteLearning, learningsToChunks, learningsStats, formatLearnings, importLearningsFromFile, autoImportFromSources, LEARNING_CATEGORIES, parseSince } from "./learnings.js";
 import { communityRulesToChunks, mergeWithDedup, loadCommunityStore, } from "./community-sync.js";
 import { readFileSync, existsSync, watch, statSync, writeFileSync, mkdirSync } from "fs";
 import { basename, join, dirname } from "path";
@@ -919,10 +919,21 @@ server.tool("list_learnings", "List all permanent learnings, optionally filtered
         .string()
         .optional()
         .describe("Filter by category (deployment, api, database, etc.). Omit to show all."),
-}, async ({ category }) => {
+    since: z
+        .string()
+        .optional()
+        .describe("Only learnings created at or after this boundary: 'today', 'yesterday' (Europe/Zurich calendar days) or an ISO date/instant. Every entry shows its created instant, UTC plus Europe/Zurich."),
+}, async ({ category, since }) => {
     // Project-scoped: only show learnings for active workspace projects + universal (no project)
+    let sinceDate;
+    if (since) {
+        const parsed = parseSince(since);
+        if (!parsed)
+            return respond("list_learnings", `❌ since="${since}" is not today, yesterday, or an ISO date. No list rendered, so this is not a zero.`);
+        sinceDate = parsed;
+    }
     const learnings = listLearnings(category, activeProjectNames);
-    const text = formatLearnings(learnings);
+    const text = formatLearnings(learnings, { since: sinceDate, sinceSpec: since });
     return respond("list_learnings", text);
 });
 // ---------------------------------------------------------------------------

package/dist/learnings.d.ts

@@ -104,5 +104,18 @@ export declare function learningsStats(): {
 /**
  * Format learnings for display.
  */
-export declare function formatLearnings(learnings: Learning[]): string;
+export declare const LEARNINGS_LOCAL_TZ = "Europe/Zurich";
+/** `2026-09-05 10:30Z (12:30 CEST)`; `undated` when the record carries no usable instant. */
+export declare function formatLearnedAt(iso: string | undefined, tz?: string): string;
+/** `today` | `yesterday` (calendar days in `tz`) | any ISO date or instant. `null` when unparseable. */
+export declare function parseSince(spec: string, now?: Date, tz?: string): Date | null;
+/** Records created at or after `since`, oldest first. Undated records are excluded and counted by the caller. */
+export declare function filterSince(learnings: Learning[], since: Date): Learning[];
+export interface FormatLearningsOptions {
+    /** Already-parsed boundary; the caller resolves the spec so an invalid one errors before rendering. */
+    since?: Date;
+    /** The spec as typed, echoed in the header so the reader sees which boundary applied. */
+    sinceSpec?: string;
+}
+export declare function formatLearnings(learnings: Learning[], opts?: FormatLearningsOptions): string;
 //# sourceMappingURL=learnings.d.ts.map

package/dist/learnings.js

@@ -680,12 +680,76 @@ export function learningsStats() {
 /**
  * Format learnings for display.
  */
-export function formatLearnings(learnings) {
+// [LOCKED] [LEARNINGS-LIST-SHOWS-CREATED] 2026-09-05
+// [NEVER] print a learning without its `created` instant, and [NEVER] answer "what was
+//         saved since X" by probing learnings.json with a hand-written key.
+// WHY: on 2026-09-05 an agent read a date field the records do not have (`createdAt`),
+//      got an empty string for every record, and answered "0 saved today" with full
+//      confidence; a second agent made the same mistake the same morning. A probe on a
+//      missing key returns a confident zero, never an error. The store had 22 records
+//      from that day, under `created`. Until then the listing showed the date only,
+//      so "today" was also ambiguous around midnight between UTC and Yan's clock.
+// FIX: one renderer shows `created` as the UTC instant plus the Europe/Zurich wall
+//      time, and `--since today|yesterday|ISO` is a first-class filter whose empty
+//      result names the boundary it applied. An unparseable spec is an error, not zero.
+export const LEARNINGS_LOCAL_TZ = "Europe/Zurich";
+/** `2026-09-05 10:30Z (12:30 CEST)`; `undated` when the record carries no usable instant. */
+export function formatLearnedAt(iso, tz = LEARNINGS_LOCAL_TZ) {
+    if (!iso)
+        return "undated";
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return "undated";
+    const utc = d.toISOString().slice(0, 16).replace("T", " ") + "Z";
+    const local = new Intl.DateTimeFormat("en-GB", {
+        timeZone: tz, hour: "2-digit", minute: "2-digit", hour12: false, timeZoneName: "short",
+    }).format(d);
+    return `${utc} (${local})`;
+}
+/** Midnight of the given calendar day in `tz`, as a UTC instant. Offset read from Intl, never guessed. */
+function localMidnightUtc(y, m, d, tz) {
+    const guess = new Date(Date.UTC(y, m - 1, d, 0, 0, 0));
+    const off = new Intl.DateTimeFormat("en-US", { timeZone: tz, timeZoneName: "longOffset" })
+        .formatToParts(guess).find((p) => p.type === "timeZoneName")?.value ?? "GMT";
+    const mm = /GMT([+-])(\d{2}):(\d{2})/.exec(off);
+    const minutes = mm ? (mm[1] === "-" ? -1 : 1) * (parseInt(mm[2], 10) * 60 + parseInt(mm[3], 10)) : 0;
+    return new Date(guess.getTime() - minutes * 60_000);
+}
+/** `today` | `yesterday` (calendar days in `tz`) | any ISO date or instant. `null` when unparseable. */
+export function parseSince(spec, now = new Date(), tz = LEARNINGS_LOCAL_TZ) {
+    const s = spec.trim().toLowerCase();
+    if (s === "today" || s === "yesterday") {
+        const parts = new Intl.DateTimeFormat("en-CA", { timeZone: tz, year: "numeric", month: "2-digit", day: "2-digit" })
+            .formatToParts(now);
+        const get = (t) => parseInt(parts.find((p) => p.type === t)?.value ?? "0", 10);
+        const midnight = localMidnightUtc(get("year"), get("month"), get("day"), tz);
+        return s === "today" ? midnight : new Date(midnight.getTime() - 86_400_000);
+    }
+    if (!/^\d{4}-\d{2}-\d{2}/.test(spec.trim()))
+        return null;
+    const d = new Date(spec.trim());
+    return Number.isNaN(d.getTime()) ? null : d;
+}
+/** Records created at or after `since`, oldest first. Undated records are excluded and counted by the caller. */
+export function filterSince(learnings, since) {
+    return learnings
+        .filter((l) => l.created && !Number.isNaN(new Date(l.created).getTime()) && new Date(l.created).getTime() >= since.getTime())
+        .sort((a, b) => new Date(a.created).getTime() - new Date(b.created).getTime());
+}
+export function formatLearnings(learnings, opts = {}) {
+    let sinceNote = "";
+    if (opts.since) {
+        learnings = filterSince(learnings, opts.since);
+        sinceNote = ` since ${opts.sinceSpec ?? opts.since.toISOString()} = ${formatLearnedAt(opts.since.toISOString())}`;
+    }
     if (learnings.length === 0) {
+        if (opts.since) {
+            return `0 learnings${sinceNote}. The boundary above is the one that was applied; if that looks wrong, the store is at ~/.contextengine/learnings.json and its date field is \`created\`.`;
+        }
         return "No learnings stored yet. Use `save_learning` to add operational rules.";
     }
     const lines = [];
-    lines.push(`# 💡 Learnings Store (${learnings.length} rules)\n`);
+    lines.push(`# 💡 Learnings Store (${learnings.length} rules${sinceNote})\n`);
     // Group by category
     const byCategory = new Map();
     for (const l of learnings) {
@@ -704,8 +768,7 @@ export function formatLearnings(learnings) {
                 lines.push(`- **Context:** ${l.context}`);
             if (l.tags?.length)
                 lines.push(`- **Tags:** ${l.tags.join(", ")}`);
-            if (l.created)
-                lines.push(`- **Learned:** ${l.created.split("T")[0]}`);
+            lines.push(`- **Learned:** ${formatLearnedAt(l.created)}`);
             lines.push("");
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compr/opscontext-mcp",
-  "version": "2.5.4",
+  "version": "2.5.5",
   "description": "OpsContext for AI Agents — read-only fleet visibility (PM2/nginx/Docker/git/cron) + tamper-evident audit log + policy-as-code hooks. The ops + compliance layer Claude Code can't grow natively.",
   "type": "module",
   "main": "dist/index.js",