@fiodos/cli 0.1.31 → 0.1.33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiodos/cli",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "description": "Fiodos CLI — analyzes your app's source code and generates the in-app voice-agent manifest, then wires the orb. Powers `npx @fiodos/cli analyze`.",
   "type": "commonjs",
   "bin": {

package/src/index.js

@@ -102,6 +102,7 @@ const {
 const { wireReactNativeOrb, reportReactNativeWire, connectRnSession } = require('./wireReactNative');
 const {
   isShopifyThemeRoot, fetchStorefrontSnapshot, wireShopifyTheme, reportShopifyWire,
+  normalizeStoreDomain,
 } = require('./shopifyTheme');
 const { wireFlutterOrb, writeFlutterEnv, reportFlutterWire } = require('./wireFlutter');
 const { wireHandlers, reportHandlerResult } = require('./wireHandlers');
@@ -404,13 +405,22 @@ async function main() {
   // so the analysis personalizes routes/bubbles/examples to the REAL catalog
   // — and so evidence verification has concrete files to point at. Fail-open:
   // an unreachable store still gets the universal surface file.
+  // Hoisted out of the `if` so it also reaches analysisMeta below: persisting
+  // the store domain in the published meta (not just using it locally for the
+  // snapshot) is what lets the DASHBOARD reconstruct the exact `--platform
+  // shopify --store <domain>` re-analysis command from the BACKEND record —
+  // no dependency on this browser's localStorage remembering how the project
+  // was first set up. Without it, a project analyzed before this field existed
+  // (or from a different browser/machine) shows the generic web command,
+  // silently missing the flags a Shopify re-analysis needs.
+  let shopifyStoreDomain = '';
   if (platform === 'shopify') {
-    const storeDomain = arg('--store', process.env.FYODOS_SHOPIFY_STORE || '');
-    if (!storeDomain) {
+    shopifyStoreDomain = normalizeStoreDomain(arg('--store', process.env.FYODOS_SHOPIFY_STORE || ''));
+    if (!shopifyStoreDomain) {
       logUser('Tip: add --store your-store.com so the analysis reads your live catalog (collections & products).');
     }
     const snapshot = await withSpinner('Reading your store\u2019s public catalog', () =>
-      fetchStorefrontSnapshot(storeDomain, { log: logDev }),
+      fetchStorefrontSnapshot(shopifyStoreDomain, { log: logDev }),
     );
     included.push(...snapshot.files);
   }
@@ -466,6 +476,13 @@ async function main() {
     ({ manifest, provenance } = routesOnlyManifest(appMeta, routes));
     logDev('[no-llm] static-only manifest (routes only, no actions)');
     logUser('Static analysis complete');
+    // Still record platform (+ store, when given) so the dashboard's
+    // re-analysis command stays correct even for a free/no-key smoke pass.
+    analysisMeta = {
+      ...analysisMeta,
+      platform,
+      ...(platform === 'shopify' && shopifyStoreDomain ? { store: shopifyStoreDomain } : {}),
+    };
   } else {
     // Hybrid AI-key model. DEFAULT: hosted analysis via the Fiodos backend
     // proxy (Fiodos's AI key, no key needed by the developer). With
@@ -552,6 +569,7 @@ async function main() {
       costUSD: Number(costUSD.toFixed(4)),
       droppedActions,
       droppedRoutes,
+      ...(platform === 'shopify' && shopifyStoreDomain ? { store: shopifyStoreDomain } : {}),
     };
   }
 

package/src/shopifyTheme.js

@@ -108,6 +108,10 @@ function universalSurfaceDoc(storeDomain) {
     universalRoutes: ['/', '/collections/all', '/search', '/cart'],
     universalActions: [
       { intent: 'search_products', handler: 'shopifySearchProducts', api: '{baseUrl}/search/suggest.json' },
+      // The search→cart bridge: suggest.json returns product ids/handles but
+      // NEVER variant ids, and cart/add.js only accepts variant ids. This
+      // endpoint (universal on every store) turns a handle into its variants.
+      { intent: 'get_product_details', handler: 'shopifyGetProductDetails', api: '{baseUrl}/products/{handle}.js' },
       { intent: 'add_to_cart', handler: 'shopifyAddToCart', api: '{baseUrl}/cart/add.js' },
       { intent: 'get_cart', handler: 'shopifyGetCart', api: '{baseUrl}/cart.js' },
       { intent: 'update_cart_item', handler: 'shopifyUpdateCartItem', api: '{baseUrl}/cart/change.js' },
@@ -194,11 +198,41 @@ async function fetchStorefrontSnapshot(storeRaw, { log = () => {} } = {}) {
   return { files, store, collections, products, warnings };
 }
 
+/**
+ * The Liquid-rendered SCREEN CONTEXT lines shared by the CLI and dashboard
+ * snippets. One branch per storefront template the agent can act on, each
+ * exposing the visible items WITH their add-to-cart variantIds.
+ *
+ * Why every branch matters: with product-only context (the original version)
+ * the agent was BLIND on collection/search/cart pages — "add it to the cart"
+ * said next to a perfectly visible product degenerated into a text search
+ * with the user's phrasing, zero results, and an apology. The agent must be
+ * able to act on whatever the customer is LOOKING AT, on every page type.
+ */
+function shopifyScreenContextLiquidLines() {
+  return [
+    "  {% if template contains 'product' and product %}",
+    '  {% capture fyodos_screen_text %}The customer is viewing the product page of: {{ product.title }} (price {{ product.price | money | strip_html }}). Add-to-cart variantId: {{ product.selected_or_first_available_variant.id }}.{% endcapture %}',
+    "  window.__fyodosScreen = { kind: 'product', text: {{ fyodos_screen_text | json }} };",
+    "  {% elsif template contains 'collection' and collection %}",
+    '  {% capture fyodos_screen_text %}The customer is browsing the collection "{{ collection.title }}". Products visible on screen (title — price — add-to-cart variantId): {% for fyodos_p in collection.products limit: 16 %}{{ fyodos_p.title }} — {{ fyodos_p.price | money | strip_html }} — variantId {{ fyodos_p.selected_or_first_available_variant.id }}; {% endfor %}To add one to the cart, call add_to_cart with its variantId from this list.{% endcapture %}',
+    "  window.__fyodosScreen = { kind: 'collection', text: {{ fyodos_screen_text | json }} };",
+    "  {% elsif template contains 'search' and search.performed %}",
+    '  {% capture fyodos_screen_text %}The customer is viewing search results for "{{ search.terms }}". Products visible on screen (title — price — add-to-cart variantId): {% for fyodos_r in search.results limit: 12 %}{% if fyodos_r.object_type == \'product\' %}{{ fyodos_r.title }} — {{ fyodos_r.price | money | strip_html }} — variantId {{ fyodos_r.selected_or_first_available_variant.id }}; {% endif %}{% endfor %}To add one to the cart, call add_to_cart with its variantId from this list.{% endcapture %}',
+    "  window.__fyodosScreen = { kind: 'search', text: {{ fyodos_screen_text | json }} };",
+    "  {% elsif template contains 'cart' %}",
+    '  {% capture fyodos_screen_text %}The customer is viewing their cart: {{ cart.item_count }} item(s), total {{ cart.total_price | money | strip_html }}. Lines (title × quantity — variantId): {% for fyodos_i in cart.items %}{{ fyodos_i.product.title }} × {{ fyodos_i.quantity }} — variantId {{ fyodos_i.variant_id }}; {% endfor %}Use update_cart_item with a variantId from this list to change quantities.{% endcapture %}',
+    "  window.__fyodosScreen = { kind: 'cart', text: {{ fyodos_screen_text | json }} };",
+    '  {% endif %}',
+  ];
+}
+
 /**
  * The theme.liquid block: loads the embed, fetches the published manifest and
  * mounts the orb with API-wired registries. Mirrors the dashboard's
- * buildShopifySnippet, plus a Liquid-rendered PRODUCT screen context so the
- * agent knows the visible variant id (what add_to_cart needs by voice).
+ * buildShopifySnippet, plus a Liquid-rendered screen context (product,
+ * collection, search and cart pages) so the agent knows the visible items and
+ * their variant ids (what add_to_cart / update_cart_item need by voice).
  */
 function buildShopifySnippet({ apiKey, apiUrl }) {
   const key = apiKey || '<your-api-key>';
@@ -207,10 +241,7 @@ function buildShopifySnippet({ apiKey, apiUrl }) {
     ORB_START,
     `<script src="${FIODOS_EMBED_CDN_URL}" defer></script>`,
     '<script>',
-    "  {% if template contains 'product' and product %}",
-    '  {% capture fyodos_screen_text %}The customer is viewing the product page of: {{ product.title }} (price {{ product.price | money | strip_html }}). Add-to-cart variantId: {{ product.selected_or_first_available_variant.id }}.{% endcapture %}',
-    "  window.__fyodosScreen = { kind: 'product', text: {{ fyodos_screen_text | json }} };",
-    '  {% endif %}',
+    ...shopifyScreenContextLiquidLines(),
     "  window.addEventListener('DOMContentLoaded', function () {",
     `    var FYODOS_API_KEY = '${key}';`,
     `    var FYODOS_API_URL = '${url}';`,
@@ -330,6 +361,7 @@ module.exports = {
   isShopifyThemeRoot,
   readThemeMeta,
   fetchStorefrontSnapshot,
+  shopifyScreenContextLiquidLines,
   buildShopifySnippet,
   wireShopifyTheme,
   reportShopifyWire,