@flowmind/cli 0.3.6 → 0.3.7

package/dist/index.js

@@ -23,6 +23,7 @@ var ERROR_CODES = {
   INVALID_API_RESPONSE: "INVALID_API_RESPONSE",
   MAX_ACTIVE_JOBS_REACHED: "MAX_ACTIVE_JOBS_REACHED",
   NOT_FOUND: "NOT_FOUND",
+  PLAN_LIMIT_REACHED: "PLAN_LIMIT_REACHED",
   QUOTA_EXCEEDED: "QUOTA_EXCEEDED",
   RATE_LIMIT_EXCEEDED: "RATE_LIMIT_EXCEEDED",
   SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE",
@@ -455,10 +456,10 @@ async function writeIgnore(start, reason) {
 }
 
 // ../../packages/contracts/src/generated/revision.ts
-var contractRevision = "601655633e35e0cc9e849f50cb39df507ee6112f56a9bfff4ce2c8db526b8d45";
+var contractRevision = "bbd616246f8533ef25c4f4889cea85dde03967c231740071c89597c025853d6b";
 
 // ../../packages/contracts/src/generated/validators/apiError.js
-var m = { additionalProperties: false, properties: { data: { enum: [null], nullable: true, type: "object" }, details: {}, error: { enum: ["BAD_REQUEST", "PUBLICATION_REVISION_CONFLICT", "PUBLICATION_STALE_ENTRIES", "SHARE_STALE_ENTRIES", "SLUG_TAKEN", "CONFLICT", "EXPIRED", "FORBIDDEN", "HUMAN_SESSION_REQUIRED", "INTERNAL_ERROR", "INVALID_API_RESPONSE", "MAX_ACTIVE_JOBS_REACHED", "NOT_FOUND", "QUOTA_EXCEEDED", "RATE_LIMIT_EXCEEDED", "SERVICE_UNAVAILABLE", "UNDECLARED_API_OPERATION", "UNAUTHENTICATED", "VALIDATION_FAILED"], type: "string" }, message: { type: "string" }, requestId: { minLength: 1, type: "string" }, status: { maximum: 599, minimum: 400, type: "integer" }, success: { enum: [false], type: "boolean" } }, required: ["success", "status", "message", "data", "requestId", "error", "details"], type: "object" };
+var m = { additionalProperties: false, properties: { data: { enum: [null], nullable: true, type: "object" }, details: {}, error: { enum: ["BAD_REQUEST", "PUBLICATION_REVISION_CONFLICT", "PUBLICATION_STALE_ENTRIES", "SHARE_STALE_ENTRIES", "SLUG_TAKEN", "CONFLICT", "EXPIRED", "FORBIDDEN", "HUMAN_SESSION_REQUIRED", "INTERNAL_ERROR", "INVALID_API_RESPONSE", "MAX_ACTIVE_JOBS_REACHED", "NOT_FOUND", "PLAN_LIMIT_REACHED", "QUOTA_EXCEEDED", "RATE_LIMIT_EXCEEDED", "SERVICE_UNAVAILABLE", "UNDECLARED_API_OPERATION", "UNAUTHENTICATED", "VALIDATION_FAILED"], type: "string" }, message: { type: "string" }, requestId: { minLength: 1, type: "string" }, status: { maximum: 599, minimum: 400, type: "integer" }, success: { enum: [false], type: "boolean" } }, required: ["success", "status", "message", "data", "requestId", "error", "details"], type: "object" };
 function t2(r2, { instancePath: i4 = "", parentData: E, parentDataProperty: d5, rootData: f2 = r2 } = {}) {
   let p7 = null, s6 = 0;
   if (s6 === 0) if (r2 && typeof r2 == "object" && !Array.isArray(r2)) {
@@ -481,7 +482,7 @@ function t2(r2, { instancePath: i4 = "", parentData: E, parentDataProperty: d5,
           if (r2.error !== void 0) {
             let e4 = r2.error, o10 = s6;
             if (typeof e4 != "string") return t2.errors = [{ instancePath: i4 + "/error", schemaPath: "#/properties/error/type", keyword: "type", params: { type: "string" }, message: "must be string" }], false;
-            if (!(e4 === "BAD_REQUEST" || e4 === "PUBLICATION_REVISION_CONFLICT" || e4 === "PUBLICATION_STALE_ENTRIES" || e4 === "SHARE_STALE_ENTRIES" || e4 === "SLUG_TAKEN" || e4 === "CONFLICT" || e4 === "EXPIRED" || e4 === "FORBIDDEN" || e4 === "HUMAN_SESSION_REQUIRED" || e4 === "INTERNAL_ERROR" || e4 === "INVALID_API_RESPONSE" || e4 === "MAX_ACTIVE_JOBS_REACHED" || e4 === "NOT_FOUND" || e4 === "QUOTA_EXCEEDED" || e4 === "RATE_LIMIT_EXCEEDED" || e4 === "SERVICE_UNAVAILABLE" || e4 === "UNDECLARED_API_OPERATION" || e4 === "UNAUTHENTICATED" || e4 === "VALIDATION_FAILED")) return t2.errors = [{ instancePath: i4 + "/error", schemaPath: "#/properties/error/enum", keyword: "enum", params: { allowedValues: m.properties.error.enum }, message: "must be equal to one of the allowed values" }], false;
+            if (!(e4 === "BAD_REQUEST" || e4 === "PUBLICATION_REVISION_CONFLICT" || e4 === "PUBLICATION_STALE_ENTRIES" || e4 === "SHARE_STALE_ENTRIES" || e4 === "SLUG_TAKEN" || e4 === "CONFLICT" || e4 === "EXPIRED" || e4 === "FORBIDDEN" || e4 === "HUMAN_SESSION_REQUIRED" || e4 === "INTERNAL_ERROR" || e4 === "INVALID_API_RESPONSE" || e4 === "MAX_ACTIVE_JOBS_REACHED" || e4 === "NOT_FOUND" || e4 === "PLAN_LIMIT_REACHED" || e4 === "QUOTA_EXCEEDED" || e4 === "RATE_LIMIT_EXCEEDED" || e4 === "SERVICE_UNAVAILABLE" || e4 === "UNDECLARED_API_OPERATION" || e4 === "UNAUTHENTICATED" || e4 === "VALIDATION_FAILED")) return t2.errors = [{ instancePath: i4 + "/error", schemaPath: "#/properties/error/enum", keyword: "enum", params: { allowedValues: m.properties.error.enum }, message: "must be equal to one of the allowed values" }], false;
             var a4 = o10 === s6;
           } else var a4 = true;
           if (a4) {
@@ -621,7 +622,7 @@ var U = c((r2) => {
 // ../../packages/contracts/src/generated/validators/shared/774NGUAG.js
 var t3 = U().fullFormats.date;
 
-// ../../packages/contracts/src/generated/validators/shared/2JZBIP7E.js
+// ../../packages/contracts/src/generated/validators/shared/53EW46KW.js
 function s(e4, { instancePath: a4 = "", parentData: n7, parentDataProperty: u4, rootData: l4 = e4 } = {}) {
   let m5 = null, r2 = 0;
   if (r2 === 0) if (e4 && typeof e4 == "object" && !Array.isArray(e4)) {
@@ -2794,9 +2795,23 @@ var ApiRejectionError = class extends BridgeError {
     return this.#rejectionMessage;
   }
 };
+var PlanLimitError = class extends BridgeError {
+  constructor(error, details) {
+    super(error.code, error.context);
+    this.details = details;
+  }
+};
+var readPlanLimitDetails = (details) => {
+  const value = details;
+  if (typeof value !== "object" || value === null || typeof value.limitKey !== "string" || !Number.isInteger(value.limit) || !Number.isInteger(value.used) || !(value.resetAt === null || typeof value.resetAt === "string")) {
+    throw new Error("Flowmind sent a plan limit error without its details");
+  }
+  return { limitKey: value.limitKey, limit: value.limit, used: value.used, resetAt: value.resetAt };
+};
 async function apiRequest(endpoint, args, options = {}) {
   const apiKey = options.authOptional ? void 0 : requireApiKey();
   let rejectionResponse;
+  let planLimitResponse;
   try {
     return await requestEndpoint(toleratingAdditions(endpoint), API_URL, args, {
       headers: {
@@ -2804,17 +2819,21 @@ async function apiRequest(endpoint, args, options = {}) {
         ...options.headers
       },
       ...options.signal ? { signal: options.signal } : {},
-      ...options.preserveRejectionMessage ? {
-        fetch: async (input2, init) => {
-          const response = await fetch(input2, init);
-          if (response.status >= 400 && response.status < 500 && response.status !== 408) {
-            rejectionResponse = response.clone();
-          }
-          return response;
+      fetch: async (input2, init) => {
+        const response = await fetch(input2, init);
+        if (response.status === 402) planLimitResponse = response.clone();
+        if (options.preserveRejectionMessage && response.status >= 400 && response.status < 500 && response.status !== 408) {
+          rejectionResponse = response.clone();
         }
-      } : {}
+        return response;
+      }
     });
   } catch (error) {
+    if (error instanceof BridgeError && error.context.kind === "api" && error.code === "PLAN_LIMIT_REACHED" && planLimitResponse) {
+      const envelope = await planLimitResponse.json();
+      assertApiEnvelope(envelope);
+      throw new PlanLimitError(error, readPlanLimitDetails(envelope.details));
+    }
     if (error instanceof BridgeError && error.context.kind === "api" && rejectionResponse) {
       const envelope = await rejectionResponse.json();
       assertApiEnvelope(envelope);
@@ -3498,8 +3517,25 @@ async function resolveSession(explicit, cwd, now = /* @__PURE__ */ new Date()) {
 }
 
 // src/command-error.ts
+var LIMIT_WORDS = {
+  "projects.active": (limit) => `${limit} active projects`,
+  "logs.personal.month": (limit) => `${limit} personal logs this month`,
+  "logs.agent.month": (limit) => `${limit} agent logs this month`
+};
+var describePlanLimit = ({ limit, limitKey, resetAt }) => {
+  const what = (LIMIT_WORDS[limitKey] ?? ((count) => `${count} of ${limitKey}`))(limit);
+  const frees = resetAt === null ? "Archiving a finished project frees a slot (archiving is final), or upgrade to Pro." : `It resets on ${new Date(resetAt).toLocaleDateString("en-GB", { day: "numeric", month: "long", year: "numeric", timeZone: "UTC" })}, or upgrade to Pro.`;
+  return `Your plan allows ${what}. ${frees} Everything you already logged stays. Upgrade in the Flowmind web app under Settings > Plan.`;
+};
 var printCommandError = (action, error, json = false, extra) => {
   let diagnostic;
+  if (error instanceof PlanLimitError) {
+    const message = describePlanLimit(error.details);
+    console.error(json ? JSON.stringify({ error: message, code: error.code, ...error.details, ...extra }) : `${message}${extra ? `
+${extra.message}` : ""}`);
+    process.exitCode = 1;
+    return;
+  }
   if (error instanceof BridgeError) {
     const context2 = error.context;
     const schema = `${context2.schemaId ?? "unavailable"}${context2.schemaPath ?? ""}`;
@@ -5053,7 +5089,7 @@ ${box}
   }
 });
 
-// ../../packages/contracts/src/generated/validators/shared/FSQ24WG2.js
+// ../../packages/contracts/src/generated/validators/shared/2AOOQGDJ.js
 var b2 = { description: "A project", properties: { archivedAt: { format: "date-time", nullable: true, type: "string" }, category: { type: "string" }, color: { type: "string" }, completedAt: { format: "date-time", nullable: true, type: "string" }, createdAt: { format: "date-time", type: "string" }, description: { nullable: true, type: "string" }, details: { description: "Private details for lastOutcome, or an empty array when no outcome exists.", items: { type: "string" }, type: "array" }, estimatedHours: { nullable: true, type: "integer" }, icon: { type: "string" }, id: { format: "uuid", type: "string" }, lastActiveDay: { format: "date", nullable: true, type: "string" }, lastOutcome: { nullable: true, type: "string" }, launchDescription: { nullable: true, type: "string" }, launchUrl: { nullable: true, type: "string" }, launchedAt: { format: "date-time", nullable: true, type: "string" }, name: { type: "string" }, nextStep: { anyOf: [{ $ref: "urn:flowmind:schema:ProjectNextStep" }, { enum: [null], nullable: true, type: "object" }] }, updatedAt: { format: "date-time", type: "string" } }, required: ["id", "name", "description", "color", "icon", "category", "estimatedHours", "launchedAt", "completedAt", "launchDescription", "launchUrl", "createdAt", "updatedAt", "archivedAt", "nextStep", "lastOutcome", "details", "lastActiveDay"], type: "object" };
 function n6(r2, { instancePath: i4 = "", parentData: k3, parentDataProperty: _, rootData: w3 = r2 } = {}) {
   let l4 = null, e4 = 0;
@@ -6224,7 +6260,7 @@ import { Command as Command10 } from "commander";
 // ../../packages/contracts/src/generated/validators/shared/VVGMHJLN.js
 var e3 = new RegExp("^[a-f0-9]{64}$", "u");
 
-// ../../packages/contracts/src/generated/validators/shared/32ECWY24.js
+// ../../packages/contracts/src/generated/validators/shared/LVEL2FHK.js
 var K2 = new RegExp("^[a-z0-9]+(-[a-z0-9]+)*$", "u");
 var w2 = { additionalProperties: false, properties: { candidates: { items: { additionalProperties: false, properties: { agentLabel: { nullable: true, type: "string" }, artifactUrl: { nullable: true, type: "string" }, captureSource: { type: "string" }, details: { items: { type: "string" }, type: "array" }, digest: { pattern: "^[a-f0-9]{64}$", type: "string" }, durationSeconds: { minimum: 0, type: "integer" }, entryId: { format: "uuid", type: "string" }, fieldVersion: { minimum: 0, type: "integer" }, localDay: { pattern: "^\\d{4}-\\d{2}-\\d{2}$", type: "string" }, loggedLate: { type: "boolean" }, outcome: { type: "string" }, provenance: { enum: ["personal", "agent"], type: "string" }, selection: { additionalProperties: false, nullable: true, properties: { artifactKind: { enum: ["code", "design", "document", "demo", "other", null], nullable: true, type: "string" }, selectedAt: { format: "date-time", type: "string" } }, required: ["artifactKind", "selectedAt"], type: "object" }, state: { enum: ["public", "changed", "new", "private"], type: "string" }, suggestedArtifactKind: { enum: ["code", "design", "document", "demo", "other", null], nullable: true, type: "string" } }, required: ["entryId", "localDay", "outcome", "details", "artifactUrl", "durationSeconds", "provenance", "captureSource", "loggedLate", "digest", "fieldVersion", "agentLabel", "suggestedArtifactKind", "state", "selection"], type: "object" }, type: "array" }, candidatesTruncated: { type: "boolean" }, counts: { additionalProperties: false, properties: { changed: { minimum: 0, type: "integer" }, eligible: { minimum: 0, type: "integer" }, new: { minimum: 0, type: "integer" }, public: { minimum: 0, type: "integer" } }, required: ["public", "changed", "new", "eligible"], type: "object" }, project: { additionalProperties: false, properties: { archived: { type: "boolean" }, color: { type: "string" }, id: { format: "uuid", type: "string" }, name: { type: "string" } }, required: ["id", "name", "color", "archived"], type: "object" }, publication: { additionalProperties: false, nullable: true, properties: { hiddenByModeration: { type: "boolean" }, id: { format: "uuid", type: "string" }, links: { additionalProperties: false, properties: { badgeMarkdown: { type: "string" }, card: { type: "string" }, feed: { type: "string" }, page: { type: "string" } }, required: ["page", "card", "feed", "badgeMarkdown"], type: "object" }, publicSummary: { nullable: true, type: "string" }, publicTitle: { type: "string" }, publishedAt: { format: "date-time", nullable: true, type: "string" }, reviewedAt: { format: "date-time", type: "string" }, slug: { maxLength: 60, minLength: 3, pattern: "^[a-z0-9]+(-[a-z0-9]+)*$", type: "string" }, status: { enum: ["published", "unpublished"], type: "string" }, updatedAt: { format: "date-time", type: "string" } }, required: ["id", "slug", "publicTitle", "publicSummary", "status", "hiddenByModeration", "publishedAt", "reviewedAt", "updatedAt", "links"], type: "object" }, revision: { minimum: 0, type: "integer" }, suggestedSlug: { maxLength: 60, minLength: 3, pattern: "^[a-z0-9]+(-[a-z0-9]+)*$", type: "string" }, suggestedTitle: { type: "string" }, username: { type: "string" } }, required: ["project", "username", "revision", "suggestedSlug", "suggestedTitle", "publication", "counts", "candidates", "candidatesTruncated"], type: "object" };
 function s5(l4, { instancePath: i4 = "", parentData: x4, parentDataProperty: I2, rootData: B = l4 } = {}) {
@@ -6793,7 +6829,7 @@ var shipLogCommand = new Command10("ship-log").description("Read a project ship
 
 // src/index.ts
 var program = new Command11();
-program.name("flowmind").description("Flowmind CLI (also installed as fm)").version("0.3.6").enablePositionalOptions();
+program.name("flowmind").description("Flowmind CLI (also installed as fm)").version("0.3.7").enablePositionalOptions();
 program.addCommand(agentCommand);
 program.addCommand(authCommand);
 program.addCommand(logCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowmind/cli",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "description": "Flowmind CLI: log what you and your coding agents ship, with the outcome and the link that proves it. Works with Codex and Claude Code.",
   "license": "MIT",
   "keywords": [
@@ -37,8 +37,15 @@
     "flowmind": "dist/index.js"
   },
   "type": "module",
+  "imports": {
+    "#contracts": {
+      "types": "./src/contracts.ts",
+      "default": "./dist/contracts.js"
+    }
+  },
   "scripts": {
     "build": "tsc --noEmit && node build.mjs",
+    "typecheck:tests": "tsc -p tsconfig.tests.json",
     "prepack": "npm run build",
     "test": "pnpm run build && node --test test/*.test.mjs && tsx --test src/*.test.ts && node test/pack-install.mjs",
     "dev": "npm run build && node dist/index.js"