@spekn/cli 1.0.2 → 1.0.5

package/dist/main.js

@@ -6123,8 +6123,8 @@ var require_SpecificationGeneration = __commonJS({
       status;
       content;
       frontmatter;
-      lockedBy;
-      lockedAt;
+      activatedBy;
+      activatedAt;
       qualityScore;
       qualityGrade;
       qualityBreakdown;
@@ -6171,13 +6171,13 @@ var require_SpecificationGeneration = __commonJS({
         nullable: true
       }),
       __metadata("design:type", String)
-    ], SpecificationGeneration.prototype, "lockedBy", void 0);
+    ], SpecificationGeneration.prototype, "activatedBy", void 0);
     __decorate([
       (0, typeorm_1.Column)("timestamp", {
         nullable: true
       }),
       __metadata("design:type", Date)
-    ], SpecificationGeneration.prototype, "lockedAt", void 0);
+    ], SpecificationGeneration.prototype, "activatedAt", void 0);
     __decorate([
       (0, typeorm_1.Column)("integer", {
         nullable: true
@@ -6274,7 +6274,7 @@ var require_Specification = __commonJS({
     (function(SpecificationStatus2) {
       SpecificationStatus2["DRAFT"] = "draft";
       SpecificationStatus2["REVIEW"] = "review";
-      SpecificationStatus2["LOCKED"] = "locked";
+      SpecificationStatus2["ACTIVE"] = "active";
       SpecificationStatus2["ARCHIVED"] = "archived";
     })(SpecificationStatus || (exports2.SpecificationStatus = SpecificationStatus = {}));
     var Specification2 = class Specification {
@@ -6287,9 +6287,6 @@ var require_Specification = __commonJS({
       status;
       version;
       specRef;
-      isLocked;
-      lockedBy;
-      lockedAt;
       frontmatter;
       project;
       projectId;
@@ -6343,24 +6340,6 @@ var require_Specification = __commonJS({
       }),
       __metadata("design:type", String)
     ], Specification2.prototype, "specRef", void 0);
-    __decorate([
-      (0, typeorm_1.Column)("boolean", {
-        default: false
-      }),
-      __metadata("design:type", Boolean)
-    ], Specification2.prototype, "isLocked", void 0);
-    __decorate([
-      (0, typeorm_1.Column)("text", {
-        nullable: true
-      }),
-      __metadata("design:type", String)
-    ], Specification2.prototype, "lockedBy", void 0);
-    __decorate([
-      (0, typeorm_1.Column)("timestamp", {
-        nullable: true
-      }),
-      __metadata("design:type", Date)
-    ], Specification2.prototype, "lockedAt", void 0);
     __decorate([
       (0, typeorm_1.Column)("jsonb", {
         nullable: true
@@ -7305,6 +7284,8 @@ var require_BridgeDevice = __commonJS({
       lastBridgeVersion;
       /** Last time the device was seen online (heartbeat). */
       lastSeenAt;
+      /** Local HTTP port the bridge is listening on, reported during WS auth. */
+      localPort;
       metadata;
       createdAt;
       updatedAt;
@@ -7361,6 +7342,12 @@ var require_BridgeDevice = __commonJS({
       }),
       __metadata("design:type", Object)
     ], BridgeDevice.prototype, "lastSeenAt", void 0);
+    __decorate([
+      (0, typeorm_1.Column)("integer", {
+        nullable: true
+      }),
+      __metadata("design:type", Object)
+    ], BridgeDevice.prototype, "localPort", void 0);
     __decorate([
       (0, typeorm_1.Column)("jsonb", {
         nullable: true
@@ -10344,7 +10331,7 @@ var require_skill_packs = __commonJS({
       {
         name: "spekn-spec-manager",
         namespace: "spekn",
-        description: "Manage the specification lifecycle \u2014 create, update, lock, generate, review, and refine specs.",
+        description: "Manage the specification lifecycle \u2014 create, update, activate, generate, review, and refine specs.",
         author: "spekn",
         tags: [
           "specification",
@@ -10836,10 +10823,11 @@ var require_specification_frontmatter = __commonJS({
     Object.defineProperty(exports2, "__esModule", {
       value: true
     });
-    exports2.SpecificationFrontmatterSchema = exports2.ANCHOR_COMPLEXITIES = exports2.ANCHOR_STATUSES = exports2.ACP_POLICY_MODES = exports2.CATEGORY_TYPE_MAP = exports2.SPECIFICATION_DEPTHS = exports2.SPECIFICATION_CATEGORIES = exports2.SPECIFICATION_STATUSES = exports2.SPECIFICATION_TYPES = exports2.HINT_MAX_LENGTH = exports2.FRONTMATTER_MAX_SIZE_BYTES = void 0;
+    exports2.SpecificationFrontmatterSchema = exports2.ANCHOR_COMPLEXITIES = exports2.ANCHOR_STATUSES = exports2.ACP_POLICY_MODES = exports2.CATEGORY_TYPE_MAP = exports2.SPECIFICATION_DEPTHS = exports2.SPECIFICATION_CATEGORIES = exports2.SPECIFICATION_STATUSES = exports2.SPECIFICATION_TYPES = exports2.HINT_MAX_LENGTH = exports2.FRONTMATTER_MAX_SIZE_BYTES = exports2.FRONTMATTER_MAX_TOKENS = void 0;
     exports2.validateFrontmatterSize = validateFrontmatterSize;
     var zod_1 = require("zod");
-    exports2.FRONTMATTER_MAX_SIZE_BYTES = 2048;
+    exports2.FRONTMATTER_MAX_TOKENS = 1024;
+    exports2.FRONTMATTER_MAX_SIZE_BYTES = exports2.FRONTMATTER_MAX_TOKENS * 4;
     exports2.HINT_MAX_LENGTH = 200;
     exports2.SPECIFICATION_TYPES = [
       "intent",
@@ -11029,7 +11017,7 @@ var require_frontmatter_parser = __commonJS({
           hasFrontmatter: true,
           autoGenerated: false,
           errors: [
-            `Frontmatter exceeds ${specification_frontmatter_1.FRONTMATTER_MAX_SIZE_BYTES} byte size limit`
+            `Frontmatter exceeds ${specification_frontmatter_1.FRONTMATTER_MAX_TOKENS} token limit (${specification_frontmatter_1.FRONTMATTER_MAX_SIZE_BYTES} bytes). Trim hints and remove optional fields.`
           ]
         };
       }
@@ -15761,9 +15749,9 @@ var require_dist4 = __commonJS({
     });
     exports2.SystemRole = exports2.SpecificationVersion = exports2.GenerationStatus = exports2.SpecificationGeneration = exports2.SpecificationStatus = exports2.Specification = exports2.RunUsage = exports2.WorkerAgentType = exports2.RunStatus = exports2.Run = exports2.Project = exports2.OrganizationCreditLedgerEntryType = exports2.OrganizationCreditLedger = exports2.OrganizationCreditWalletStatus = exports2.OrganizationCreditWallet = exports2.OrganizationApiKey = exports2.OrgMemberRole = exports2.OrganizationPlan = exports2.Organization = exports2.OrchestrationTemplate = exports2.OrchestrationPolicy = exports2.NoteType = exports2.Note = exports2.MergeRequestStatus = exports2.MergeRequest = exports2.GitRepository = exports2.EM_ACTION_TYPES = exports2.EMActionStatus = exports2.EMActionExecutionStatus = exports2.EMActionLog = exports2.validateDecisionChains = exports2.validateRollbackChain = exports2.validateSupersessionChain = exports2.MAX_CHAIN_DEPTH = exports2.DecisionType = exports2.DecisionStatus = exports2.Decision = exports2.AiProviderType = exports2.AiProvider = exports2.ModelType = exports2.CapabilityTier = exports2.AiModel = exports2.BridgePairingCode = exports2.BridgeDeviceRepository = exports2.BridgeDeviceStatus = exports2.BridgeDevice = exports2.ACPCompatMode = exports2.AgentInstallLocation = exports2.AgentSource = exports2.AgentConfig = void 0;
     exports2.seedOrchestrationTemplates = exports2.MANAGED_SKILL_PACKS = exports2.seedManagedSkillPacks = exports2.SkillProposalStateMachine = exports2.ACTIVITY_EVENT_TYPE = exports2.ACTIVITY_SOURCE = exports2.ActivityEvent = exports2.ExportScopeMapping = exports2.ExportDeliveryMode = exports2.ExportArtifactRecord = exports2.GitHubDeadLetter = exports2.GitHubEvent = exports2.GitHubRepoMapping = exports2.RepositorySelection = exports2.GitHubAccountType = exports2.GitHubInstallation = exports2.PluginArtifact = exports2.SkillProposalType = exports2.SkillProposalStatus = exports2.SkillProposal = exports2.SkillTriggerType = exports2.SkillVersionStatus = exports2.SkillVersion = exports2.SkillPackStatus = exports2.SkillPack = exports2.DeviationStatus = exports2.DeviationSeverity = exports2.DeviationType = exports2.DeviationRecord = exports2.DecisionSeverity = exports2.RunDecisionType = exports2.DecisionRecord = exports2.RunReportStatus = exports2.RunReport = exports2.WorktreeStatus = exports2.Worktree = exports2.SpecificationLockStatus = exports2.WorkflowPhase = exports2.WorkflowState = exports2.WaitlistEntry = exports2.VerificationStatus = exports2.VerificationType = exports2.Verification = exports2.McpApiKey = exports2.UserApiKey = exports2.UserRole = exports2.User = exports2.TaskPriority = exports2.TaskStatus = exports2.Task = void 0;
-    exports2.PluginDeprecationRequestSchema = exports2.PluginInstallResponseSchema = exports2.PluginInstallRequestSchema = exports2.PluginPublishResponseSchema = exports2.PluginPublishRequestSchema = exports2.MarketplaceSearchResultSchema = exports2.MarketplaceSearchParamsSchema = exports2.MarketplaceCatalogEntrySchema = exports2.EXPORT_FORMAT_IDS = exports2.CONTEXT_LAYER_TYPES = exports2.DecisionTypeSchema = exports2.DecisionStatusTypeSchema = exports2.DecisionFetchResponseSchema = exports2.DecisionChainLinkSchema = exports2.DecisionFetchScopeSchema = exports2.ContextBundleResponseSchema = exports2.ContextBundleRequestSchema = exports2.clearPromptCache = exports2.resolveIncludes = exports2.interpolateTemplate = exports2.loadPromptTemplate = exports2.resolveSpecCategory = exports2.inferTypeFromContent = exports2.extractAnchorPaths = exports2.autoGenerateFrontmatter = exports2.serializeFrontmatter = exports2.parseSpecificationFrontmatter = exports2.CATEGORY_TYPE_MAP = exports2.SPECIFICATION_DEPTHS = exports2.SPECIFICATION_CATEGORIES = exports2.SPECIFICATION_STATUSES = exports2.SPECIFICATION_TYPES = exports2.HINT_MAX_LENGTH = exports2.FRONTMATTER_MAX_SIZE_BYTES = exports2.validateFrontmatterSize = exports2.SpecificationFrontmatterSchema = exports2.SkillProposalStatusType = exports2.SkillPackStatusType = exports2.parseLegacyFrontmatter = exports2.RESERVED_SKILL_PREFIXES = exports2.SKILL_NAME_PATTERN = exports2.SkillSearchResultSchema = exports2.SkillSearchParamsSchema = exports2.SkillLintResultSchema = exports2.SkillProposalSchema = exports2.SkillVersionSchema = exports2.SkillPackSchema = exports2.SkillFrontmatterSchemaOriginal = exports2.SkillFrontmatterSchema = exports2.DEFAULT_GOVERNANCE_POLICY = void 0;
-    exports2.ORG_MEMBER_LIMITS = exports2.ORG_CREATION_LIMITS = exports2.VECTOR_MEMORY_QUOTAS = exports2.FEATURE_TO_MIN_PLAN = exports2.getSatisfyingPlans = exports2.meetsMinimumTier = exports2.TIER_ORDER = exports2.hasPermissions = exports2.requirePermission = exports2.PERMISSIONS = exports2.extractUserIdentity = exports2.extractOrgRoles = exports2.decodeJwtPayload = exports2.CredentialsStore = exports2.AuthUserSchema = exports2.BRIDGE_RECONNECT_MAX_MS = exports2.BRIDGE_RECONNECT_BASE_MS = exports2.BRIDGE_HEARTBEAT_TIMEOUT_MS = exports2.BRIDGE_HEARTBEAT_INTERVAL_MS = exports2.BRIDGE_WS_PATH = exports2.emitRunStarted = exports2.emitRunFailed = exports2.emitRunCompleted = exports2.RUN_EVENTS = exports2.runEventEmitter = exports2.ensureCoreProjectSchema = exports2.resolvePgAdminClientConfig = exports2.resolvePgClientConfig = exports2.resolveDatabaseConfig = exports2.AppDataSource = exports2.DEFAULT_PLUGIN_LAYOUT = exports2.DEFAULT_MIGRATION_POLICY = exports2.DEFAULT_UPDATE_POLICY = exports2.DEFAULT_SCOPE_MAPPING = exports2.DEFAULT_NAMESPACE_POLICY = exports2.PluginRepositoryLayoutSchema = exports2.SpeknPluginManifestSchema = exports2.ClaudeCodeMarketplaceSchema = exports2.ClaudeCodeMarketplaceMetadataSchema = exports2.ClaudeCodePluginEntrySchema = exports2.ClaudeCodePluginAuthorSchema = exports2.ClaudeCodeHookMatcherSchema = exports2.ClaudeCodeHookEntrySchema = exports2.ClaudeCodePluginSourceSchema = exports2.ClaudeCodeOwnerSchema = exports2.PLUGIN_DEPRECATION_REASONS = exports2.MARKETPLACE_SORT_ORDERS = exports2.MARKETPLACE_SORT_FIELDS = exports2.MarketplaceCatalogManifestSchema = exports2.VersionCompatibilitySchema = void 0;
-    exports2.createCallerFactory = exports2.procedure = exports2.router = exports2.t = exports2.SpecQualityScorer = exports2.scoreSpecification = exports2.getRequiredPlan = exports2.PROJECT_CREATION_LIMITS = void 0;
+    exports2.PluginInstallResponseSchema = exports2.PluginInstallRequestSchema = exports2.PluginPublishResponseSchema = exports2.PluginPublishRequestSchema = exports2.MarketplaceSearchResultSchema = exports2.MarketplaceSearchParamsSchema = exports2.MarketplaceCatalogEntrySchema = exports2.EXPORT_FORMAT_IDS = exports2.CONTEXT_LAYER_TYPES = exports2.DecisionTypeSchema = exports2.DecisionStatusTypeSchema = exports2.DecisionFetchResponseSchema = exports2.DecisionChainLinkSchema = exports2.DecisionFetchScopeSchema = exports2.ContextBundleResponseSchema = exports2.ContextBundleRequestSchema = exports2.clearPromptCache = exports2.resolveIncludes = exports2.interpolateTemplate = exports2.loadPromptTemplate = exports2.resolveSpecCategory = exports2.inferTypeFromContent = exports2.extractAnchorPaths = exports2.autoGenerateFrontmatter = exports2.serializeFrontmatter = exports2.parseSpecificationFrontmatter = exports2.CATEGORY_TYPE_MAP = exports2.SPECIFICATION_DEPTHS = exports2.SPECIFICATION_CATEGORIES = exports2.SPECIFICATION_STATUSES = exports2.SPECIFICATION_TYPES = exports2.HINT_MAX_LENGTH = exports2.FRONTMATTER_MAX_TOKENS = exports2.FRONTMATTER_MAX_SIZE_BYTES = exports2.validateFrontmatterSize = exports2.SpecificationFrontmatterSchema = exports2.SkillProposalStatusType = exports2.SkillPackStatusType = exports2.parseLegacyFrontmatter = exports2.RESERVED_SKILL_PREFIXES = exports2.SKILL_NAME_PATTERN = exports2.SkillSearchResultSchema = exports2.SkillSearchParamsSchema = exports2.SkillLintResultSchema = exports2.SkillProposalSchema = exports2.SkillVersionSchema = exports2.SkillPackSchema = exports2.SkillFrontmatterSchemaOriginal = exports2.SkillFrontmatterSchema = exports2.DEFAULT_GOVERNANCE_POLICY = void 0;
+    exports2.ORG_CREATION_LIMITS = exports2.VECTOR_MEMORY_QUOTAS = exports2.FEATURE_TO_MIN_PLAN = exports2.getSatisfyingPlans = exports2.meetsMinimumTier = exports2.TIER_ORDER = exports2.hasPermissions = exports2.requirePermission = exports2.PERMISSIONS = exports2.extractUserIdentity = exports2.extractOrgRoles = exports2.decodeJwtPayload = exports2.CredentialsStore = exports2.AuthUserSchema = exports2.BRIDGE_RECONNECT_MAX_MS = exports2.BRIDGE_RECONNECT_BASE_MS = exports2.BRIDGE_HEARTBEAT_TIMEOUT_MS = exports2.BRIDGE_HEARTBEAT_INTERVAL_MS = exports2.BRIDGE_WS_PATH = exports2.emitRunStarted = exports2.emitRunFailed = exports2.emitRunCompleted = exports2.RUN_EVENTS = exports2.runEventEmitter = exports2.ensureCoreProjectSchema = exports2.resolvePgAdminClientConfig = exports2.resolvePgClientConfig = exports2.resolveDatabaseConfig = exports2.AppDataSource = exports2.DEFAULT_PLUGIN_LAYOUT = exports2.DEFAULT_MIGRATION_POLICY = exports2.DEFAULT_UPDATE_POLICY = exports2.DEFAULT_SCOPE_MAPPING = exports2.DEFAULT_NAMESPACE_POLICY = exports2.PluginRepositoryLayoutSchema = exports2.SpeknPluginManifestSchema = exports2.ClaudeCodeMarketplaceSchema = exports2.ClaudeCodeMarketplaceMetadataSchema = exports2.ClaudeCodePluginEntrySchema = exports2.ClaudeCodePluginAuthorSchema = exports2.ClaudeCodeHookMatcherSchema = exports2.ClaudeCodeHookEntrySchema = exports2.ClaudeCodePluginSourceSchema = exports2.ClaudeCodeOwnerSchema = exports2.PLUGIN_DEPRECATION_REASONS = exports2.MARKETPLACE_SORT_ORDERS = exports2.MARKETPLACE_SORT_FIELDS = exports2.MarketplaceCatalogManifestSchema = exports2.VersionCompatibilitySchema = exports2.PluginDeprecationRequestSchema = void 0;
+    exports2.createCallerFactory = exports2.procedure = exports2.router = exports2.t = exports2.SpecQualityScorer = exports2.scoreSpecification = exports2.getRequiredPlan = exports2.PROJECT_CREATION_LIMITS = exports2.ORG_MEMBER_LIMITS = void 0;
     var AgentConfig_1 = require_AgentConfig();
     Object.defineProperty(exports2, "AgentConfig", {
       enumerable: true,
@@ -16523,6 +16511,12 @@ var require_dist4 = __commonJS({
         return specification_frontmatter_1.FRONTMATTER_MAX_SIZE_BYTES;
       }, "get")
     });
+    Object.defineProperty(exports2, "FRONTMATTER_MAX_TOKENS", {
+      enumerable: true,
+      get: /* @__PURE__ */ __name(function() {
+        return specification_frontmatter_1.FRONTMATTER_MAX_TOKENS;
+      }, "get")
+    });
     Object.defineProperty(exports2, "HINT_MAX_LENGTH", {
       enumerable: true,
       get: /* @__PURE__ */ __name(function() {
@@ -41232,8 +41226,7 @@ ${spec2.content}`).join("\n\n");
             projectId: payload.project_id,
             title: payload.title,
             content: payload.content,
-            status: shared_1.SpecificationStatus.DRAFT,
-            isLocked: false
+            status: shared_1.SpecificationStatus.DRAFT
           });
           const created = await dataSource.getRepository(shared_1.Specification).save(spec2);
           return {
@@ -41268,11 +41261,11 @@ ${payload.content}`;
           });
           if (!specification) throw new Error("Specification not found");
           assertProjectScope(specification.projectId, context2.projectId);
-          specification.status = shared_1.SpecificationStatus.LOCKED;
+          specification.status = shared_1.SpecificationStatus.ACTIVE;
           const saved = await dataSource.getRepository(shared_1.Specification).save(specification);
           return {
             specification_id: saved.id,
-            locked: true
+            activated: true
           };
         }, "spec_lock"),
         task_create: /* @__PURE__ */ __name(async (action, context2) => {
@@ -81115,6 +81108,25 @@ __export(export_exports, {
   parseArgs: () => parseArgs7,
   runExportCli: () => runExportCli
 });
+function mergeJsonConfig(existingContent, newContent) {
+  try {
+    const existing = JSON.parse(existingContent);
+    const incoming = JSON.parse(newContent);
+    for (const [key, value] of Object.entries(incoming)) {
+      if (typeof value === "object" && value !== null && !Array.isArray(value) && typeof existing[key] === "object" && existing[key] !== null && !Array.isArray(existing[key])) {
+        existing[key] = {
+          ...existing[key],
+          ...value
+        };
+      } else {
+        existing[key] = value;
+      }
+    }
+    return JSON.stringify(existing, null, 2) + "\n";
+  } catch {
+    return newContent;
+  }
+}
 function normalizeTrpcUrl(apiUrl) {
   if (apiUrl.endsWith("/trpc")) {
     return apiUrl;
@@ -81157,6 +81169,7 @@ function parseArgs7(args) {
   const parseArgs22 = command === "generate" ? args : args.slice(1);
   let projectId = "";
   let format = "";
+  let platforms;
   let output;
   let anchors;
   let mode = "global";
@@ -81194,6 +81207,14 @@ function parseArgs7(args) {
       format = arg.slice("--format=".length);
       continue;
     }
+    if (arg === "--platforms" && parseArgs22[index + 1]) {
+      platforms = parseArgs22[++index].split(",").map((p) => p.trim()).filter(Boolean);
+      continue;
+    }
+    if (arg.startsWith("--platforms=")) {
+      platforms = arg.slice("--platforms=".length).split(",").map((p) => p.trim()).filter(Boolean);
+      continue;
+    }
     if (arg === "--output" && parseArgs22[index + 1]) {
       output = parseArgs22[++index];
       continue;
@@ -81283,7 +81304,23 @@ function parseArgs7(args) {
       continue;
     }
   }
-  if (command !== "discover" && ![
+  const validPlatforms = [
+    "claude-code",
+    "codex",
+    "gemini",
+    "opencode",
+    "vibe"
+  ];
+  if (platforms?.length) {
+    if (format) {
+      throw new Error("--format and --platforms are mutually exclusive");
+    }
+    for (const p of platforms) {
+      if (!validPlatforms.includes(p)) {
+        throw new Error(`Invalid platform "${p}". Allowed values: ${validPlatforms.join(", ")}`);
+      }
+    }
+  } else if (command !== "discover" && ![
     "agents-md",
     "claude-md",
     "cursorrules",
@@ -81312,6 +81349,7 @@ function parseArgs7(args) {
     command,
     projectId,
     format,
+    platforms,
     output,
     anchors,
     mode,
@@ -81488,7 +81526,13 @@ async function runExportCli(args, deps = defaultDeps) {
       }
       return 0;
     }
-    const plan = await client.export.delivery.previewTarget.query({
+    const plan = options.platforms?.length ? await client.export.delivery.previewMultiPlatform.query({
+      projectId: context2.projectId,
+      platformTargets: options.platforms,
+      mode: options.mode,
+      scopePath: options.scope,
+      anchorFilter: options.anchors
+    }) : await client.export.delivery.previewTarget.query({
       projectId: context2.projectId,
       formatId: options.format,
       mode: options.mode,
@@ -81554,7 +81598,7 @@ async function main7() {
   const exitCode = await runExportCli(process.argv.slice(2));
   process.exit(exitCode);
 }
-var fs7, path7, defaultDeps;
+var fs7, path7, MERGEABLE_CONFIG_FILES, defaultDeps;
 var init_export = __esm({
   "src/commands/export.ts"() {
     "use strict";
@@ -81564,6 +81608,12 @@ var init_export = __esm({
     init_credentials_store();
     init_project_context();
     init_structured_log();
+    MERGEABLE_CONFIG_FILES = /* @__PURE__ */ new Set([
+      ".mcp.json",
+      ".gemini/settings.json",
+      "opencode.jsonc"
+    ]);
+    __name(mergeJsonConfig, "mergeJsonConfig");
     defaultDeps = {
       createClient: /* @__PURE__ */ __name((apiUrl, organizationId, authToken) => createTRPCProxyClient({
         links: [
@@ -81581,6 +81631,14 @@ var init_export = __esm({
         fs7.mkdirSync(dir, {
           recursive: true
         });
+        const relativePath = path7.relative(process.cwd(), filePath);
+        const normalizedRelative = relativePath.replace(/\\/g, "/");
+        if (MERGEABLE_CONFIG_FILES.has(normalizedRelative) && fs7.existsSync(filePath)) {
+          const existingContent = fs7.readFileSync(filePath, "utf-8");
+          const merged = mergeJsonConfig(existingContent, content);
+          fs7.writeFileSync(filePath, merged, "utf-8");
+          return;
+        }
         fs7.writeFileSync(filePath, content, "utf-8");
       }, "writeFile"),
       stdout: /* @__PURE__ */ __name((content) => process.stdout.write(content), "stdout"),
@@ -105917,7 +105975,8 @@ var require_dist18 = __commonJS({
         "archived"
       ];
       var HINT_MAX_LENGTH2 = 200;
-      var FRONTMATTER_MAX_SIZE = 2048;
+      var FRONTMATTER_MAX_TOKENS = 1024;
+      var FRONTMATTER_MAX_SIZE = FRONTMATTER_MAX_TOKENS * 4;
       function parseFrontmatter(content) {
         const match = FRONTMATTER_REGEX.exec(content);
         if (!match) return null;
@@ -106019,7 +106078,7 @@ var require_dist18 = __commonJS({
               findings.push({
                 checkId,
                 severity: "error",
-                message: `Frontmatter exceeds 2KB limit (${sizeBytes} bytes): ${file.relativePath}`,
+                message: `Frontmatter exceeds ${FRONTMATTER_MAX_TOKENS}-token limit (${sizeBytes} bytes): ${file.relativePath}`,
                 file: file.relativePath,
                 autoFixable: false,
                 speknCta: "Spekn enforces frontmatter size limits during validation"
@@ -110671,9 +110730,9 @@ AI enhancement skipped: ${aiResult.error}
             });
             return;
           }
-          if (!body.formatId) {
+          if (!body.formatId && !body.platformTargets?.length) {
             sendJson(res, 400, {
-              error: "formatId is required"
+              error: "formatId or platformTargets is required"
             });
             return;
           }
@@ -110682,6 +110741,7 @@ AI enhancement skipped: ${aiResult.error}
             exportId,
             projectId: body.projectId,
             formatId: body.formatId,
+            platformTargets: body.platformTargets,
             apiUrl: body.apiUrl ?? "http://localhost:3001",
             mode: body.mode,
             scopePath: body.scopePath,
@@ -112366,17 +112426,20 @@ AI enhancement skipped: ${aiResult.error}
         }
       }
       buildCliArgs(payload) {
-        const { projectId, formatId, mode, scopePath, anchorFilter } = payload;
+        const { projectId, formatId, platformTargets, mode, scopePath, anchorFilter } = payload;
         const args = [
           "export",
           "--project",
           projectId,
-          "--format",
-          formatId,
           "--delivery",
           "download",
           "--json"
         ];
+        if (platformTargets?.length) {
+          args.push("--platforms", platformTargets.join(","));
+        } else if (formatId) {
+          args.push("--format", formatId);
+        }
         if (mode === "scoped") {
           args.push("--mode", "scoped");
         }
@@ -112478,7 +112541,8 @@ AI enhancement skipped: ${aiResult.error}
         const payload = {
           deviceId: pairing.deviceId,
           credential: pairing.credential,
-          bridgeVersion: BRIDGE_VERSION2
+          bridgeVersion: BRIDGE_VERSION2,
+          port: this.config.get().port
         };
         this.send("bridge.auth", payload);
       }
@@ -112490,7 +112554,8 @@ AI enhancement skipped: ${aiResult.error}
             const payload = {
               deviceId: pairing?.deviceId ?? "unknown",
               timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-              uptime: Math.floor((Date.now() - this.startedAt.getTime()) / 1e3)
+              uptime: Math.floor((Date.now() - this.startedAt.getTime()) / 1e3),
+              port: this.config.get().port
             };
             this.send("bridge.heartbeat", payload);
             this.ws.ping();
@@ -115949,7 +116014,8 @@ var require_frontmatter_quality = __commonJS({
       "archived"
     ];
     var HINT_MAX_LENGTH2 = 200;
-    var FRONTMATTER_MAX_SIZE = 2048;
+    var FRONTMATTER_MAX_TOKENS = 1024;
+    var FRONTMATTER_MAX_SIZE = FRONTMATTER_MAX_TOKENS * 4;
     function parseFrontmatter(content) {
       const match = FRONTMATTER_REGEX.exec(content);
       if (!match) return null;
@@ -116047,7 +116113,7 @@ var require_frontmatter_quality = __commonJS({
             findings.push({
               checkId,
               severity: "error",
-              message: `Frontmatter exceeds 2KB limit (${sizeBytes} bytes): ${file.relativePath}`,
+              message: `Frontmatter exceeds ${FRONTMATTER_MAX_TOKENS}-token limit (${sizeBytes} bytes): ${file.relativePath}`,
               file: file.relativePath,
               autoFixable: false,
               speknCta: "Spekn enforces frontmatter size limits during validation"
@@ -123312,7 +123378,7 @@ function registerVoidAction(command, pathSegments, runner) {
   });
 }
 __name(registerVoidAction, "registerVoidAction");
-var cliVersion = true ? "1.0.2" : "0.0.0-dev";
+var cliVersion = true ? "1.0.5" : "0.0.0-dev";
 checkForUpdates(cliVersion);
 var program = new import_commander.Command();
 program.name("spekn").description("Spekn CLI \u2014 Spec-Driven Development toolchain").version(cliVersion);

package/dist/resources/prompts/repo-sync-analysis.prompt.md

@@ -42,7 +42,7 @@ RULES:
 - ALWAYS use MCP tools (spekn_spec_create / spekn_spec_update / spekn_decision_create) — never just describe what you would create
 - Every spec MUST follow the format from spekn-spec-format
 - Every spec MUST score at least B (75+) per the spekn-quality-scoring checklist
-- Frontmatter MUST stay under 2048 bytes — if a tool call fails with size limit, trim and retry
+- Frontmatter MUST stay under ~1024 tokens (~4KB) — if a tool call fails with size limit, trim and retry
 - Minimize churn — prefer updates over new specs
 - Respect existing canonical spec set
 - If a tool call fails for other reasons, report the error and continue with the next item