@flareum/mcp 0.5.0 → 0.5.1

package/dist/cli.js

@@ -69,7 +69,9 @@ try {
         // The server reads this lock to decide whether to pull. Without it a CLI pull was invisible,
         // and the next connection fetched the same version again.
         if (!isRetryable(result))
-            await writeLock(process.cwd(), makeLock(projectIdFromToken(config.token), result.publishedVersionId, outDir, new Date().toISOString()));
+            // An explicit pull is the deliberate act applying.md ends on, so it advances BOTH: these
+            // stylesheets, and the version the code is now written against.
+            await writeLock(process.cwd(), makeLock(projectIdFromToken(config.token), result.publishedVersionId, outDir, new Date().toISOString(), result.publishedVersionId));
         console.log(pullReport(result, outDir));
         return result;
     };

package/dist/first-pull.js

@@ -128,12 +128,15 @@ export const runFirstPull = async (client, cwd, env, configuredOut, knownVersion
         // Claimed BEFORE the first write: an interrupted pull leaves files with no completed version,
         // and without this it would read as somebody else's folder and never be finished.
         await mkdir(resolve(cwd, dir), { recursive: true });
-        await writeLock(cwd, makeLock(projectId, IN_FLIGHT, dir, now()));
+        // The applied version is carried across every write here: this pull is unattended, and
+        // advancing it would consume the diff window before an agent could read it.
+        const applied = lock?.appliedVersionId ?? syncedVersion(lock, dir) ?? undefined;
+        await writeLock(cwd, makeLock(projectId, IN_FLIGHT, dir, now(), applied));
         const result = await pullStyles(client, fileWriter(resolve(cwd, dir)));
         // Recorded only when the WHOLE version landed: pullStyles resolves even when files failed, so
         // stamping on its return marked a half-pulled folder complete and never retried it.
         if (!isRetryable(result))
-            await writeLock(cwd, makeLock(projectId, result.publishedVersionId, dir, now()));
+            await writeLock(cwd, makeLock(projectId, result.publishedVersionId, dir, now(), applied));
         return { ran: true, dir, result };
     }
     catch (error) {

package/dist/lock.d.ts

@@ -2,6 +2,7 @@ export declare const LOCK_PATH = ".flareum/lock.json";
 export type Lock = {
     projectId: string;
     syncedVersionId: string;
+    appliedVersionId?: string;
     syncedAt: string;
     out: string;
     prefix?: string;
@@ -12,7 +13,8 @@ export declare const readLock: (cwd: string) => Lock | null;
 export declare const owns: (lock: Lock | null, dir: string) => boolean;
 export declare const syncedVersion: (lock: Lock | null, dir: string) => string | null;
 export declare const writeLock: (cwd: string, lock: Lock) => Promise<void>;
-export declare const makeLock: (projectId: string, syncedVersionId: string, out: string, at: string, prefix?: string) => Lock;
+export declare const makeLock: (projectId: string, syncedVersionId: string, out: string, at: string, appliedVersionId?: string, prefix?: string) => Lock;
+export declare const appliedVersion: (lock: Lock | null) => string;
 export declare const LEGACY_STAMP = ".flareum-version";
 export declare const legacyVersion: (cwd: string, dir: string) => string | null;
 export declare const legacyStampExists: (cwd: string, dir: string) => boolean;

package/dist/lock.js

@@ -20,7 +20,17 @@ export const writeLock = async (cwd, lock) => {
     await mkdir(dirname(path), { recursive: true });
     await writeFile(path, `${JSON.stringify(lock, null, 2)}\n`, 'utf8');
 };
-export const makeLock = (projectId, syncedVersionId, out, at, prefix) => ({ projectId, syncedVersionId, syncedAt: at, out, ...(prefix ? { prefix } : {}) });
+export const makeLock = (projectId, syncedVersionId, out, at, appliedVersionId, prefix) => ({
+    projectId, syncedVersionId, syncedAt: at, out,
+    ...(appliedVersionId ? { appliedVersionId } : {}),
+    ...(prefix ? { prefix } : {}),
+});
+// What an agent diffs FROM. Falls back to the stylesheets for a lock written before this field, and
+// never returns the in-flight sentinel — a pull half-done is not a version anything was applied to.
+export const appliedVersion = (lock) => {
+    const applied = lock?.appliedVersionId ?? lock?.syncedVersionId;
+    return !applied || applied === IN_FLIGHT ? '' : applied;
+};
 // A project pulled by 0.2.x recorded the version in a stamp beside the stylesheets. Adopted rather
 // than ignored, so an upgrade does not re-pull a version already on disk.
 export const LEGACY_STAMP = '.flareum-version';

package/dist/server.js

@@ -11,10 +11,10 @@ import { installSkill, skillInstallReport } from './skill.js';
 import { configuredOut, firstPullReport, runFirstPull } from './first-pull.js';
 import { projectConfigReport, writeProjectConfig } from './project-config.js';
 import { checkKey } from './key-check.js';
-import { readLock } from './lock.js';
+import { appliedVersion, readLock } from './lock.js';
 // The agent should not have to be told which version to diff from — the lock in the project is the
 // answer, and asking the model to supply it invites a guess.
-const lockedVersion = () => readLock(process.cwd())?.syncedVersionId ?? '';
+const lockedVersion = () => appliedVersion(readLock(process.cwd()));
 // A missing key threw at module load, and an editor shows that as a Node stack trace with the
 // message buried in it. Say it in one line and exit, the way the CLI already does.
 let client;
@@ -75,8 +75,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     try {
         if (request.params.name === 'flareum_search')
             return text(formatSearch(await client.search(String(args.query ?? ''), Number(args.limit) || undefined)));
-        if (request.params.name === 'flareum_changes_since')
-            return text(formatChanges(await client.changes(String(args.since ?? '')), lockedVersion()));
+        if (request.params.name === 'flareum_changes_since') {
+            // Defaulted here, not left to the model: the lock is the answer, and asking for it invites a guess.
+            const locked = lockedVersion();
+            const since = String(args.since ?? '') || locked;
+            return text(formatChanges(await client.changes(since), locked));
+        }
         if (request.params.name === 'flareum_get')
             return text(formatVariable(await client.variable(String(args.path ?? ''))));
         return text(`Unknown tool: ${request.params.name}`);

package/dist/tools.js

@@ -80,14 +80,14 @@ export const TOOL_DESCRIPTIONS = {
 // Written for a model that is about to EDIT files: the CSS names first, because those are what it
 // greps for, and the action stated per line so a rename is never applied as a delete plus an add.
 export const formatChanges = ({ since, totalChanges, entries, truncated, liveVersionId }, lockedVersion = '') => {
-    if (!totalChanges)
+    if (!totalChanges || !entries.length)
         return since
             ? `No changes since ${since}. The project is at ${liveVersionId}.`
             : `This project has no tokens yet.`;
     const lines = [
         since
-            ? `${totalChanges} change(s) since ${since}. The project is now at ${liveVersionId}.`
-            : `${totalChanges} change(s). No baseline was given, so this is everything the project has.`,
+            ? `${entries.length} change(s) since ${since}. The project is now at ${liveVersionId}.`
+            : `${entries.length} change(s). No baseline was given, so this is everything the project has.`,
         '',
     ];
     if (lockedVersion && since && lockedVersion !== since)
@@ -114,7 +114,8 @@ const changeLine = (entry) => {
     if (change === 'typeChanged')
         return `${kind} type: ${nameOf(before)} is now ${after?.type} (was ${before?.type})`;
     if (change === 'valueChanged')
-        return `${kind} value${mode}: ${nameOf(before)}  ${before?.value} → ${after?.value}`;
+        return `${kind} value${mode}: ${nameOf(before)}  ${before?.value ?? '(not set)'} → `
+            + `${after?.value ?? '(not set)'}`;
     if (change === 'movedCollection')
         return `${kind} moved collection: ${nameOf(before)} → ${nameOf(after)}`;
     return `${kind} ${change}: ${nameOf(after ?? before)}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flareum/mcp",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Connect a coding agent to a Flareum project's design tokens.",
   "license": "MIT",
   "author": "Flareum",