@fiodos/cli 0.1.23 → 0.1.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiodos/cli",
-  "version": "0.1.23",
+  "version": "0.1.26",
   "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": {
@@ -14,13 +14,14 @@
     "README.md"
   ],
   "scripts": {
-    "analyze": "node src/index.js"
+    "analyze": "node src/index.js",
+    "test": "node --test test/*.test.js"
   },
   "engines": {
     "node": ">=18"
   },
   "dependencies": {
-    "@fiodos/core": "^0.1.2",
+    "@fiodos/core": "^0.1.10",
     "esbuild": "^0.28.1",
     "jsdom": "^24.0.0",
     "typescript": "^5.6.0"

package/src/aiAnalyze.js

@@ -141,7 +141,9 @@ function buildUserPrompt(appMeta, files, omitted, staticRoutes, surface = null,
     : '';
   const routeBlock = staticRoutes.length
     ? `Statically-scanned routes (existence is verified — use these hrefs):\n${routeHint}\n`
-    : `No static route list (web app): infer routes/views from the router and navigation calls in the code below.\n`;
+    : opts.platform === 'shopify'
+      ? 'Shopify storefront: derive routes from the PUBLIC STOREFRONT SNAPSHOT files under _fyodos/storefront/ (universal pages + one route per real collection/page handle) and from the theme templates below.\n'
+      : `No static route list (web app): infer routes/views from the router and navigation calls in the code below.\n`;
 
   // Detected interactive link elements on the product surface — concrete hrefs
   // the model should turn into LINK actions (verified later against the file).
@@ -171,7 +173,7 @@ function buildUserPrompt(appMeta, files, omitted, staticRoutes, surface = null,
     routeBlock +
     linkBlock +
     omittedNote +
-    (includeSchema && LOCAL_PROMPTS ? `\nManifest schema:\n${LOCAL_PROMPTS.manifestSchemaDoc()}\n\n` : '\n') +
+    (includeSchema && LOCAL_PROMPTS ? `\nManifest schema:\n${LOCAL_PROMPTS.manifestSchemaDoc(opts.platform === 'shopify')}\n\n` : '\n') +
     `FULL SOURCE CODE (${files.length} files):\n\n${codeBlob}`
   );
 }
@@ -383,7 +385,7 @@ async function analyzeWithAI({
   if (useProxy) {
     // Server prompt mode: the backend builds the system prompt (with the
     // manifest schema embedded), so the user payload carries only the inputs.
-    user = buildUserPrompt(appMeta, files, omitted, staticRoutes, surface, spec, { includeSchema: false });
+    user = buildUserPrompt(appMeta, files, omitted, staticRoutes, surface, spec, { includeSchema: false, platform });
     ({ parsed, usage, serverModel, analysisToken } = await analyzeViaProxy({
       apiKey, apiUrl, model: resolved, user, task: 'analysis', platform, hasUserSpec: Boolean(spec),
     }));
@@ -391,7 +393,7 @@ async function analyzeWithAI({
     const sp = await resolveOwnKeySystemPrompt({
       task: 'analysis', platform, hasUserSpec: Boolean(spec), apiKey, apiUrl,
     });
-    user = buildUserPrompt(appMeta, files, omitted, staticRoutes, surface, spec, { includeSchema: sp.schemaInUser });
+    user = buildUserPrompt(appMeta, files, omitted, staticRoutes, surface, spec, { includeSchema: sp.schemaInUser, platform });
     ({ parsed, usage } = isAnthropicModel(resolved)
       ? await completeAnthropic({ model: resolved, system: sp.system, user })
       : await completeOpenAI({ model: resolved, system: sp.system, user }));

package/src/changeRegistry.js

@@ -214,8 +214,54 @@ function summarizeEnv(result) {
   return { ...base, applied: false };
 }
 
+function summarizeSession(result) {
+  if (!result) return { status: 'skipped', applied: false };
+  const base = { status: result.status, strategy: result.strategy || null };
+  switch (result.status) {
+    case 'applied':
+    case 'applied-untested':
+      return {
+        ...base,
+        applied: true,
+        what: 'Connected the orb to the app\'s real session state (isAuthenticated/getUserId) automatically.',
+        revert: 'Delete session.generated.* and remove the FYODOS:SESSION blocks + mount props.',
+      };
+    case 'review':
+      return { ...base, applied: false, note: `Session left for review: ${result.reason || ''}` };
+    case 'reverted':
+      return { ...base, applied: false, note: `Session wiring reverted: ${result.reason || ''}` };
+    case 'no-session':
+      return { ...base, applied: false, note: 'No login detected — session wiring not needed.' };
+    default:
+      return { ...base, applied: false };
+  }
+}
+
+function summarizeScreen(result) {
+  if (!result) return { status: 'skipped', applied: false };
+  const base = { status: result.status };
+  switch (result.status) {
+    case 'applied':
+    case 'applied-untested':
+      return {
+        ...base,
+        applied: true,
+        what: 'Connected the app\'s ACTIVE screen state to the orb (state-driven screens, no URL change).',
+        revert: 'Delete screen.generated.* and remove the FYODOS:SCREEN blocks + mount prop.',
+      };
+    case 'review':
+      return { ...base, applied: false, note: `Screen wiring left for review: ${result.reason || ''}` };
+    case 'reverted':
+      return { ...base, applied: false, note: `Screen wiring reverted: ${result.reason || ''}` };
+    case 'url-screens':
+      return { ...base, applied: false, note: 'Screens are URL-driven — no screen wiring needed.' };
+    default:
+      return { ...base, applied: false };
+  }
+}
+
 function collectFileEntries(appRoot, ctx) {
-  const { orbResult, handlerResult, registryResult, envResult } = ctx;
+  const { orbResult, handlerResult, registryResult, sessionResult, screenResult, envResult } = ctx;
   const created = [];
   const modified = [];
   const docs = [];
@@ -291,6 +337,66 @@ function collectFileEntries(appRoot, ctx) {
     });
   }
 
+  // Session wiring (auth awareness — automatic)
+  if (
+    sessionResult &&
+    (sessionResult.status === 'applied' || sessionResult.status === 'applied-untested')
+  ) {
+    if (sessionResult.sessionFile) {
+      created.push({
+        path: normRel(appRoot, sessionResult.sessionFile),
+        phase: 'session',
+        what: 'Generated session module (`session.generated.*`): isAuthenticated/getUserId for the orb.',
+        revert: 'Safe to delete; re-run the installer to regenerate.',
+      });
+    }
+    if (sessionResult.editedFile) {
+      modified.push({
+        path: sessionResult.editedFile,
+        phase: 'session',
+        what: 'Registered the live session in the bridge (reversible FYODOS:SESSION block).',
+        revert: 'Remove the FYODOS:SESSION blocks.',
+      });
+    }
+    if (sessionResult.docPath) {
+      docs.push({
+        path: normRel(appRoot, sessionResult.docPath),
+        phase: 'session',
+        what: 'Session wiring summary: strategy, honesty contract, security notes.',
+      });
+    }
+  }
+
+  // Screen-truth wiring (state-driven screens — automatic)
+  if (
+    screenResult &&
+    (screenResult.status === 'applied' || screenResult.status === 'applied-untested')
+  ) {
+    if (screenResult.screenFile) {
+      created.push({
+        path: normRel(appRoot, screenResult.screenFile),
+        phase: 'screen',
+        what: 'Generated screen module (`screen.generated.*`): reports the ACTIVE screen to the orb.',
+        revert: 'Safe to delete; re-run the installer to regenerate.',
+      });
+    }
+    if (screenResult.editedFile) {
+      modified.push({
+        path: screenResult.editedFile,
+        phase: 'screen',
+        what: 'Registered the live active-screen state in the bridge (reversible FYODOS:SCREEN block).',
+        revert: 'Remove the FYODOS:SCREEN blocks.',
+      });
+    }
+    if (screenResult.docPath) {
+      docs.push({
+        path: normRel(appRoot, screenResult.docPath),
+        phase: 'screen',
+        what: 'Screen-truth wiring summary: why it was needed, honesty contract.',
+      });
+    }
+  }
+
   // Env (never record values)
   if (envResult?.status === 'written' && envResult.writePlan?.targetRel) {
     modified.push({
@@ -379,6 +485,8 @@ function buildRunRecord(appRoot, ctx) {
       orb: summarizeOrb(ctx.orbResult),
       handlers: summarizeHandlers(ctx.handlerResult, appRoot),
       registries: summarizeRegistries(ctx.registryResult),
+      session: summarizeSession(ctx.sessionResult),
+      screen: summarizeScreen(ctx.screenResult),
       env: summarizeEnv(ctx.envResult),
     },
     files: collectFileEntries(appRoot, ctx),

package/src/collect.js

@@ -47,6 +47,12 @@ const PROFILES = {
     exts: ['.kt'],
     skipDirs: ['.git', '.gradle', 'build', '.idea'],
   },
+  // Shopify theme repo (GitHub-synced Liquid theme). The "code" is the theme's
+  // Liquid templates + JSON templates/settings; heavy static assets are noise.
+  shopify: {
+    exts: ['.liquid', '.json'],
+    skipDirs: ['.git', 'node_modules', 'assets', 'dist', 'build'],
+  },
 };
 
 const SKIP_FILES = /\.(d\.ts|test\.|spec\.)|babel\.config|metro\.config|tailwind\.config|postcss\.config|jest\.config|eslint/;
@@ -64,8 +70,16 @@ const CHARS_PER_TOKEN = 3.0;
 
 /** Lower tier = higher priority when the budget forces choices. Generalized so
  *  it ranks screens/state/services first across web, RN AND native naming. */
-function tierFor(rel) {
+function tierFor(rel, platform) {
   const p = rel.replace(/\\/g, '/');
+  if (platform === 'shopify') {
+    // Shopify theme layout: templates define the store's pages; layout + locales
+    // carry structure and language; sections/snippets are secondary UI.
+    if (/^(layout|templates)\//.test(p)) return 0;
+    if (/^locales\//.test(p)) return 1;
+    if (/^sections\//.test(p)) return 2;
+    return 3; // snippets/, config/ (settings_data.json can be huge), rest
+  }
   if (/^(src\/)?app\//.test(p)) return 0; // expo-router / Next screens
   if (/(^|\/)(screens?|pages?|views?|routes?|activities|fragments)\//i.test(p)) return 0;
   if (/(screen|page|view|activity|fragment)\.(dart|kt|swift)$/i.test(p)) return 0;
@@ -95,7 +109,7 @@ function collectFiles(appRoot, { maxInputTokens = 150_000, platform = 'mobile' }
       if (SKIP_FILES.test(rel)) continue;
       if (isNative && SKIP_NATIVE_FILES.test(rel)) continue;
       const content = fs.readFileSync(full, 'utf8');
-      files.push({ rel, content, tier: tierFor(rel), chars: content.length });
+      files.push({ rel, content, tier: tierFor(rel, platform), chars: content.length });
     }
   };
   walk(appRoot);