@flareum/mcp 0.2.9 → 0.2.11

package/dist/first-pull.d.ts

@@ -8,11 +8,12 @@ export type Probe = (path: string) => boolean;
  */
 export declare const chooseStylesDir: (exists: Probe, configured?: string) => string;
 export declare const autoPullEnabled: (env: Record<string, string | undefined>) => boolean;
-/** Only ever the FIRST time: an existing directory is the developer's, and `flareum pull` owns updates. */
-export declare const needsFirstPull: (exists: Probe, dir: string) => boolean;
+export declare const STAMP = ".flareum-version";
+export declare const pulledVersion: (read: (path: string) => string | null, dir: string) => string | null;
+export declare const needsPull: (exists: Probe, read: (path: string) => string | null, dir: string, published: string | null) => boolean;
 export type FirstPull = {
     ran: false;
-    reason: 'disabled' | 'already-pulled';
+    reason: 'disabled' | 'up-to-date';
     dir: string;
 } | {
     ran: true;
@@ -28,4 +29,4 @@ export declare const firstPullReport: (outcome: FirstPull) => string | null;
 /** Writes under `root`, refusing nothing the pull already refuses (see isWritablePath). */
 export declare const fileWriter: (root: string) => (path: string, contents: string) => Promise<void>;
 export declare const configuredOut: (cwd: string, env: Record<string, string | undefined>) => string | undefined;
-export declare const runFirstPull: (client: Pick<FlareumClient, "files" | "file">, cwd: string, env: Record<string, string | undefined>, configuredOut?: string) => Promise<FirstPull>;
+export declare const runFirstPull: (client: Pick<FlareumClient, "files" | "file" | "published">, cwd: string, env: Record<string, string | undefined>, configuredOut?: string) => Promise<FirstPull>;

package/dist/first-pull.js

@@ -2,7 +2,7 @@ import { existsSync, readFileSync } from 'node:fs';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { dirname, join, resolve } from 'node:path';
 import { CONFIG_PATH } from './config.js';
-import { pullStyles } from './pull.js';
+import { isRetryable, pullStyles } from './pull.js';
 // Most specific first. A repo that keeps stylesheets in app/styles gets them there rather than in a
 // src/styles nobody in that project looks at.
 const STYLE_ROOTS = [
@@ -29,8 +29,18 @@ export const chooseStylesDir = (exists, configured) => {
 // Opt-out, not opt-in: a project with no stylesheets is the case this exists for, and a stdio server
 // has nobody to ask at startup. Anything but an explicit off means on.
 export const autoPullEnabled = (env) => !['off', 'false', '0', 'no'].includes((env.FLAREUM_AUTO_PULL ?? '').trim().toLowerCase());
-/** Only ever the FIRST time: an existing directory is the developer's, and `flareum pull` owns updates. */
-export const needsFirstPull = (exists, dir) => !exists(dir);
+// A stamp beside the files, not in config.json: config is the developer's, this is bookkeeping.
+export const STAMP = '.flareum-version';
+export const pulledVersion = (read, dir) => read(join(dir, STAMP))?.trim() || null;
+// Pull when there is nothing here, or when what is published is not what is on disk. Connecting
+// used to be a one-time event, so a project pulled once never saw another push.
+export const needsPull = (exists, read, dir, published) => {
+    if (!exists(dir))
+        return true;
+    if (!published)
+        return false;
+    return pulledVersion(read, dir) !== published;
+};
 export const firstPullReport = (outcome) => {
     // Silence is right for a start that did nothing — this prints on every server start.
     if (!outcome.ran && outcome.reason !== 'failed')
@@ -68,13 +78,27 @@ export const configuredOut = (cwd, env) => {
 };
 export const runFirstPull = async (client, cwd, env, configuredOut) => {
     const exists = path => existsSync(resolve(cwd, path));
+    const read = (path) => {
+        try {
+            return readFileSync(resolve(cwd, path), 'utf8');
+        }
+        catch {
+            return null;
+        }
+    };
     const dir = chooseStylesDir(exists, configuredOut);
     if (!autoPullEnabled(env))
         return { ran: false, reason: 'disabled', dir };
-    if (!needsFirstPull(exists, dir))
-        return { ran: false, reason: 'already-pulled', dir };
     try {
-        return { ran: true, dir, result: await pullStyles(client, fileWriter(resolve(cwd, dir))) };
+        const published = await client.published().then(r => r.publishedVersionId).catch(() => null);
+        if (!needsPull(exists, read, dir, published))
+            return { ran: false, reason: 'up-to-date', dir };
+        const result = await pullStyles(client, fileWriter(resolve(cwd, dir)));
+        // Stamped only when the WHOLE version landed. pullStyles resolves even when files failed, so
+        // stamping on its return recorded a half-pulled folder as complete and never retried it.
+        if (!isRetryable(result))
+            await writeFile(resolve(cwd, dir, STAMP), `${result.publishedVersionId}\n`, 'utf8');
+        return { ran: true, dir, result };
     }
     catch (error) {
         // A project with nothing published, an expired key, no network — none of them may stop the server.

package/package.json

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