siteplane 0.1.46 → 0.1.47

package/README.md

@@ -39,6 +39,11 @@ activation, import, reporting, booking or publishing rights. Standalone bootstra
 `setup prepare` installs the task's exact packages and creates the narrow official runtime integration.
 The agent chooses and instruments content, then persists a separate, bounded summary:
 
+For a direct field ID, put `siteplane.attrs(fieldId, { routeKey })` on the visible
+element using the same canonical route pattern as its value call. The value call
+does not attach DOM metadata. Missing or mismatched DOM routes block apply and
+the Next build; dynamic pages use their pattern, such as `/services/[slug]`.
+
 ```bash
 siteplane setup apply --definition editor-definition.json --selection-summary-file selection.txt
 siteplane setup deploy --wait

package/dist/bin/siteplane.js

@@ -2195,8 +2195,8 @@ var EARLY_ACCESS_PLAN = {
   customAdminDomainsEnabled: true,
   agentMcpEnabled: true,
   emailNotificationsEnabled: true,
-  analyticsEnabled: false,
-  analyticsSitesLimit: 0,
+  analyticsEnabled: true,
+  analyticsSitesLimit: 3,
   analyticsPortalPerformanceEnabled: false,
   analyticsMonthlyReportsEnabled: false,
   analyticsAiSummaryEnabled: false,
@@ -4309,6 +4309,7 @@ function scanSourceFacts(files) {
   const hardErrors = [];
   const warnings = [];
   const suggestions = [];
+  const directAttrs = [];
   const eventPreviewAttrs = [];
   const eventPreviewComponentPropConsumers = [];
   const eventPreviewComponentPropUsages = [];
@@ -4316,6 +4317,7 @@ function scanSourceFacts(files) {
   let hasGenericEventPreviewConsumer = false;
   for (const file of files) {
     const facts = scanSourceFile2(file, fields, hardErrors);
+    directAttrs.push(...facts.directAttrs);
     eventPreviewAttrs.push(...facts.eventPreviewAttrs);
     eventPreviewComponentPropConsumers.push(...facts.eventPreviewComponentPropConsumers);
     eventPreviewComponentPropUsages.push(...facts.eventPreviewComponentPropUsages);
@@ -4329,6 +4331,18 @@ function scanSourceFacts(files) {
       eventPreviewConsumerFieldIds.add(usage.fieldId);
     }
   }
+  for (const attr of directAttrs) {
+    const field = fields.find((candidate) => candidate.fieldId === attr.fieldId);
+    const expectedRoute = field?.technicalRouteKey ?? field?.routeHint;
+    if (!attr.routeKey || expectedRoute && attr.routeKey !== expectedRoute) {
+      hardErrors.push({
+        code: attr.routeKey ? "field_scan.attrs_route_key_mismatch" : "field_scan.attrs_route_key_missing",
+        message: `DOM attrs for ${attr.fieldId} must include the same canonical routeKey as its value call${expectedRoute ? ` (${expectedRoute})` : ""}. Pass it explicitly to siteplane.attrs(fieldId, { routeKey }); the value call does not attach DOM metadata.`,
+        fieldId: attr.fieldId,
+        filePath: attr.filePath
+      });
+    }
+  }
   markMissingEventPreviewHandlerErrors(eventPreviewAttrs, eventPreviewConsumerFieldIds, hasGenericEventPreviewConsumer, hardErrors);
   validateScannedFields(fields, hardErrors, warnings, suggestions);
   return {
@@ -4354,6 +4368,7 @@ function scanSourceFile2(file, fields, hardErrors) {
   const fieldsInFile = [];
   const attrFieldIds = /* @__PURE__ */ new Set();
   const attrRouteRefs = /* @__PURE__ */ new Set();
+  const directAttrs = [];
   const eventPreviewAttrs = [];
   const eventPreviewAttrVariables = /* @__PURE__ */ new Map();
   const eventPreviewComponentPropConsumers = [];
@@ -4375,7 +4390,7 @@ function scanSourceFile2(file, fields, hardErrors) {
       collectEventPreviewComponentPropUsages(node, eventPreviewAttrVariables, eventPreviewComponentPropUsages, file);
     }
     if (ts2.isCallExpression(node)) {
-      collectAttrsCall(node, attrFieldIds, attrRouteRefs, eventPreviewAttrs, eventPreviewAttrVariables, file);
+      collectAttrsCall(node, attrFieldIds, attrRouteRefs, eventPreviewAttrs, eventPreviewAttrVariables, directAttrs, file);
       collectUnusedValueCallError(node, hardErrors, file);
       const extractedFields = extractFunctionFields(node, file);
       for (const field of extractedFields) {
@@ -4403,6 +4418,7 @@ function scanSourceFile2(file, fields, hardErrors) {
   visit(sourceFile);
   markMissingAttrsWarnings(fieldsInFile, attrFieldIds, attrRouteRefs);
   return {
+    directAttrs,
     eventPreviewAttrs,
     eventPreviewComponentPropConsumers,
     eventPreviewComponentPropUsages,
@@ -4583,7 +4599,7 @@ function createFallbackHash(fieldType, fallback) {
     return void 0;
   }
 }
-function collectAttrsCall(node, attrFieldIds, attrRouteRefs, eventPreviewAttrs, eventPreviewAttrVariables, file) {
+function collectAttrsCall(node, attrFieldIds, attrRouteRefs, eventPreviewAttrs, eventPreviewAttrVariables, directAttrs, file) {
   if (!ts2.isPropertyAccessExpression(node.expression)) {
     return;
   }
@@ -4595,6 +4611,11 @@ function collectAttrsCall(node, attrFieldIds, attrRouteRefs, eventPreviewAttrs,
   const directFieldId = staticExpressionValue2(firstArg);
   if (typeof directFieldId === "string") {
     attrFieldIds.add(directFieldId);
+    directAttrs.push({
+      fieldId: directFieldId,
+      routeKey: secondArg && typeof secondArg === "object" && "routeKey" in secondArg ? stringValue2(secondArg.routeKey) : void 0,
+      filePath: file.filePath
+    });
     if (hasEventPreviewStrategy(secondArg)) {
       eventPreviewAttrs.push({
         fieldId: directFieldId,

package/dist/index.js

@@ -1923,8 +1923,8 @@ var EARLY_ACCESS_PLAN = {
   customAdminDomainsEnabled: true,
   agentMcpEnabled: true,
   emailNotificationsEnabled: true,
-  analyticsEnabled: false,
-  analyticsSitesLimit: 0,
+  analyticsEnabled: true,
+  analyticsSitesLimit: 3,
   analyticsPortalPerformanceEnabled: false,
   analyticsMonthlyReportsEnabled: false,
   analyticsAiSummaryEnabled: false,

package/dist/next.js

@@ -2126,8 +2126,8 @@ var EARLY_ACCESS_PLAN = {
   customAdminDomainsEnabled: true,
   agentMcpEnabled: true,
   emailNotificationsEnabled: true,
-  analyticsEnabled: false,
-  analyticsSitesLimit: 0,
+  analyticsEnabled: true,
+  analyticsSitesLimit: 3,
   analyticsPortalPerformanceEnabled: false,
   analyticsMonthlyReportsEnabled: false,
   analyticsAiSummaryEnabled: false,
@@ -3054,6 +3054,7 @@ function scanSourceFacts(files) {
   const hardErrors = [];
   const warnings = [];
   const suggestions = [];
+  const directAttrs = [];
   const eventPreviewAttrs = [];
   const eventPreviewComponentPropConsumers = [];
   const eventPreviewComponentPropUsages = [];
@@ -3061,6 +3062,7 @@ function scanSourceFacts(files) {
   let hasGenericEventPreviewConsumer = false;
   for (const file of files) {
     const facts = scanSourceFile(file, fields, hardErrors);
+    directAttrs.push(...facts.directAttrs);
     eventPreviewAttrs.push(...facts.eventPreviewAttrs);
     eventPreviewComponentPropConsumers.push(...facts.eventPreviewComponentPropConsumers);
     eventPreviewComponentPropUsages.push(...facts.eventPreviewComponentPropUsages);
@@ -3074,6 +3076,18 @@ function scanSourceFacts(files) {
       eventPreviewConsumerFieldIds.add(usage.fieldId);
     }
   }
+  for (const attr of directAttrs) {
+    const field = fields.find((candidate) => candidate.fieldId === attr.fieldId);
+    const expectedRoute = field?.technicalRouteKey ?? field?.routeHint;
+    if (!attr.routeKey || expectedRoute && attr.routeKey !== expectedRoute) {
+      hardErrors.push({
+        code: attr.routeKey ? "field_scan.attrs_route_key_mismatch" : "field_scan.attrs_route_key_missing",
+        message: `DOM attrs for ${attr.fieldId} must include the same canonical routeKey as its value call${expectedRoute ? ` (${expectedRoute})` : ""}. Pass it explicitly to siteplane.attrs(fieldId, { routeKey }); the value call does not attach DOM metadata.`,
+        fieldId: attr.fieldId,
+        filePath: attr.filePath
+      });
+    }
+  }
   markMissingEventPreviewHandlerErrors(eventPreviewAttrs, eventPreviewConsumerFieldIds, hasGenericEventPreviewConsumer, hardErrors);
   validateScannedFields(fields, hardErrors, warnings, suggestions);
   return {
@@ -3099,6 +3113,7 @@ function scanSourceFile(file, fields, hardErrors) {
   const fieldsInFile = [];
   const attrFieldIds = /* @__PURE__ */ new Set();
   const attrRouteRefs = /* @__PURE__ */ new Set();
+  const directAttrs = [];
   const eventPreviewAttrs = [];
   const eventPreviewAttrVariables = /* @__PURE__ */ new Map();
   const eventPreviewComponentPropConsumers = [];
@@ -3120,7 +3135,7 @@ function scanSourceFile(file, fields, hardErrors) {
       collectEventPreviewComponentPropUsages(node, eventPreviewAttrVariables, eventPreviewComponentPropUsages, file);
     }
     if (ts2.isCallExpression(node)) {
-      collectAttrsCall(node, attrFieldIds, attrRouteRefs, eventPreviewAttrs, eventPreviewAttrVariables, file);
+      collectAttrsCall(node, attrFieldIds, attrRouteRefs, eventPreviewAttrs, eventPreviewAttrVariables, directAttrs, file);
       collectUnusedValueCallError(node, hardErrors, file);
       const extractedFields = extractFunctionFields(node, file);
       for (const field of extractedFields) {
@@ -3148,6 +3163,7 @@ function scanSourceFile(file, fields, hardErrors) {
   visit(sourceFile);
   markMissingAttrsWarnings(fieldsInFile, attrFieldIds, attrRouteRefs);
   return {
+    directAttrs,
     eventPreviewAttrs,
     eventPreviewComponentPropConsumers,
     eventPreviewComponentPropUsages,
@@ -3328,7 +3344,7 @@ function createFallbackHash(fieldType, fallback) {
     return void 0;
   }
 }
-function collectAttrsCall(node, attrFieldIds, attrRouteRefs, eventPreviewAttrs, eventPreviewAttrVariables, file) {
+function collectAttrsCall(node, attrFieldIds, attrRouteRefs, eventPreviewAttrs, eventPreviewAttrVariables, directAttrs, file) {
   if (!ts2.isPropertyAccessExpression(node.expression)) {
     return;
   }
@@ -3340,6 +3356,11 @@ function collectAttrsCall(node, attrFieldIds, attrRouteRefs, eventPreviewAttrs,
   const directFieldId = staticExpressionValue(firstArg);
   if (typeof directFieldId === "string") {
     attrFieldIds.add(directFieldId);
+    directAttrs.push({
+      fieldId: directFieldId,
+      routeKey: secondArg && typeof secondArg === "object" && "routeKey" in secondArg ? stringValue(secondArg.routeKey) : void 0,
+      filePath: file.filePath
+    });
     if (hasEventPreviewStrategy(secondArg)) {
       eventPreviewAttrs.push({
         fieldId: directFieldId,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "siteplane",
   "private": false,
-  "version": "0.1.46",
+  "version": "0.1.47",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {