@tokenoftrust/cli 3.3.0 → 3.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenoftrust/cli",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "Token of Trust developer CLI — clone a tenant store, run it locally with save→reload, and submit it for preview. Installs the `tot` command.",
   "license": "Apache-2.0",
   "author": "Token of Trust",

package/src/commands/report.mjs

@@ -176,7 +176,7 @@ export function evidenceFromDir({ pagesDir, stylePath = null, lint = null, confi
           ...buildReadinessChecks({
             aggregate: { ...summary, totals: { ...summary.totals, issues: summary.totals?.issues ?? { lowRiskOpen: 0 } } },
             styleJson: styleJson ?? (summary.style?.gates ? { gates: summary.style.gates } : null),
-            args: { manifest: summary.manifest ?? "(none supplied to the style-concept audit)" },
+            args: { manifest: summary.manifest ?? "(none supplied to the style-concept audit)", plan: summary.plan ?? null },
             config,
           }),
         ];

package/src/readiness-checks.mjs

@@ -45,7 +45,13 @@ export function gateProblem(label, counts) {
   return `All ${counts.total} page checks passed.`;
 }
 
-export function styleGuideCheck(styleJson, manifestPath) {
+/**
+ * @param {any} styleJson the style-concept audit output
+ * @param {string} manifestPath where the manifest was looked for
+ * @param {{ declared: boolean, routes: string[], approvalReceiptId: string|null }|null} [plan]
+ *   the store plan's style-guide declaration (null when the store has no plan)
+ */
+export function styleGuideCheck(styleJson, manifestPath, plan = null) {
   const gate = styleJson?.gates?.styleGuide;
   const manifest = styleJson?.manifest;
   const manifestPresent = manifest?.present === true;
@@ -58,6 +64,20 @@ export function styleGuideCheck(styleJson, manifestPath) {
       fix: "Run the style-concept audit with the store manifest so the guide index and per-theme guide records can be checked.",
     };
   }
+  if (!manifestPresent && plan) {
+    const approved = plan.declared && plan.approvalReceiptId;
+    return {
+      area: "Style guide",
+      status: approved ? "PASS" : "FAIL",
+      why: "The style guide is the approved visual contract for brand, accessibility states, responsive behavior, and reusable page patterns.",
+      problem: approved
+        ? `The store plan declares a style guide at ${plan.routes.length} route(s), approved by receipt ${plan.approvalReceiptId}.`
+        : `The store plan declares no ${plan.declared ? "style-guide approval receipt" : "style guide"}, and no migration manifest was found at ${manifestPath}.`,
+      fix: approved
+        ? "Keep the plan's style-guide routes and approval receipt current when the guide changes."
+        : "Declare styleGuide and styleGuideApprovalReceiptId in the store plan, or record the style guide in the migration manifest.",
+    };
+  }
   if (!manifestPresent) {
     return {
       area: "Style guide",
@@ -204,7 +224,7 @@ export function complianceNoticesCheck(results, config) {
 }
 
 /**
- * @param {{ aggregate: any, styleJson: any, args: { manifest: string }, config?: Record<string, any> | null }} input
+ * @param {{ aggregate: any, styleJson: any, args: { manifest: string, plan?: object|null }, config?: Record<string, any> | null }} input
  *   `config` is the store's `.tot/config.json`, which decides the compliance notices row.
  */
 export function buildReadinessChecks({ aggregate, styleJson, args, config = null }) {
@@ -222,7 +242,7 @@ export function buildReadinessChecks({ aggregate, styleJson, args, config = null
 
   return [
     ...(compliance ? [compliance] : []),
-    styleGuideCheck(styleJson, args.manifest),
+    styleGuideCheck(styleJson, args.manifest, args.plan ?? null),
     ecommerceStyleGuideCheck(styleJson),
     styleQualityCheck(styleJson),
     {