@deneb-ui/cli 2.0.21 → 2.0.23

package/README.md

@@ -1,138 +1,86 @@
-# DENEB
-
-### The official developer CLI for DENEB UI.
-
-> **DENEB UI — Build beautiful interfaces, effortlessly.**  
-> The premier visual-first React component ecosystem.  
-> Proudly presented by **DENEB-UI Collaborate with FIVORA**.
-
-[![Framework: DENEB UI](https://img.shields.io/badge/Framework-DENEB_UI_v2.0-blue.svg)](https://github.com/deneb-ui/ui)
-[![License: MIT](https://img.shields.io/badge/License-MIT-teal.svg)](https://opensource.org/licenses/MIT)
-
----
-
-## Installation
-
-You can run commands directly using `npx`:
-```bash
-npx @deneb-ui/cli <command>
-```
-
-Or install as a project devDependency:
-```bash
-npm install -D @deneb-ui/cli
-```
-
-Or install globally:
-```bash
-npm install -g @deneb-ui/cli
-```
-
-The CLI command is available as `deneb` (with alias `denebui`).
+<p align="center">
+  <a href="https://deneb.fivora.site">
+    <img src="https://img.shields.io/badge/DENEB_CLI-Storefront_Authoring_Toolkit-6366F1?style=for-the-badge&labelColor=0f172a" alt="DENEB CLI" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@deneb-ui/cli"><img src="https://img.shields.io/npm/v/@deneb-ui/cli.svg?style=flat-square&color=6366F1" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/@deneb-ui/cli"><img src="https://img.shields.io/npm/dm/@deneb-ui/cli.svg?style=flat-square&color=6366F1" alt="npm downloads" /></a>
+  <img src="https://img.shields.io/badge/Node-%3E%3D18-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node.js" />
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-emerald?style=flat-square" alt="MIT License" /></a>
+</p>
+
+<p align="center">
+  <strong>Scaffold, convert, validate, and ship Fivora-ready storefront templates.</strong>
+</p>
+
+<p align="center">
+  <a href="https://deneb.fivora.site/docs/cli"><strong>CLI Reference</strong></a> ·
+  <a href="https://deneb.fivora.site/docs/installation"><strong>Installation</strong></a> ·
+  <a href="https://github.com/deneb-ui/core"><strong>GitHub</strong></a>
+</p>
 
 ---
 
-## Commands
-
-### 1. `deneb add <component>` (Component Registry)
-Add production-ready DENEB UI components into `src/components/ui/`:
-
-```bash
-# List available components:
-npx @deneb-ui/cli add list
-
-# Add specific components:
-npx @deneb-ui/cli add product-card
-npx @deneb-ui/cli add contact-actions
-npx @deneb-ui/cli add location-card
-npx @deneb-ui/cli add whatsapp-button
-npx @deneb-ui/cli add dialog
-npx @deneb-ui/cli add all
-```
-
-### 1. `deneb init` (Initialize Existing Project)
-Converts and configures any **ongoing Next.js project** for the Fivora platform:
-- Generates `fivora-template.json` (Version 2 contract with strict visual editing)
-- Creates `src/data/site-data.json` with merchant defaults
-- Injects npm scripts (`lab`, `validate`, `zip`, `validate-and-zip`, `update:deneb`)
-- Installs `@deneb-ui/ui` and `@deneb-ui/cli`
+## Quick start
 
 ```bash
+# Convert an existing Next.js app (Deneb ARC — default engine)
 npx @deneb-ui/cli init
-# Or: deneb init
-```
-
-### 2. `deneb update` (Update Packages & DENEB Components)
-Keeps your project up to date by updating both npm packages and installed DENEB components:
-- Updates `@deneb-ui/ui` and `@deneb-ui/cli` to the latest releases
-- Automatically scans `src/components/ui/` and synchronizes existing DENEB UI components with the latest definitions
 
-```bash
-npm run update:deneb
-# Or: deneb update
-```
+# Preview the transformation plan without writing files
+npx @deneb-ui/cli init --explain
 
-### 3. `deneb validate` (Preflight Contract Validator)
-Runs Fivora preflight verification against manifest contracts, static export fixtures, and visual editing markers (`data-fivora-path`, `data-fivora-page`):
+# Validate Fivora contract compliance
+npx @deneb-ui/cli validate .
 
-```bash
-npm run validate
-# Or: deneb validate .
-# Or validate and immediately bundle on success:
-deneb validate --zip
+# Package a clean upload ZIP
+npx @deneb-ui/cli validate --zip
 ```
 
-### 4. `deneb zip` / `deneb pack` (Clean Package Generator)
-Creates a clean, upload-ready `fivora-template.zip` excluding unnecessary directories and secret files (`node_modules`, `.next`, `.git`, `.env*`, `.cache`, `.turbo`, logs):
+Install as a dev dependency:
 
 ```bash
-npm run zip
-# Or: deneb zip .
-```
-
-### 5. `deneb validate-and-zip` (One-Step Preflight Check & Clean ZIP)
-The safest, recommended command for releasing templates. Runs full preflight validation; if and only if all platform checks pass 100%, it bundles a clean `fivora-template.zip`:
-
-```bash
-npm run validate-and-zip
-# Or: deneb validate-and-zip .
-# Or: deneb validate and zip
+npm install -D @deneb-ui/cli
+# Command: deneb
 ```
 
-### 6. `deneb add <component>` (Component Registry)
-Add or update production-ready DENEB UI components into `src/components/ui/`:
+---
 
-```bash
-# List available components:
-npx @deneb-ui/cli add list
-
-# Add specific components:
-npx @deneb-ui/cli add product-card
-npx @deneb-ui/cli add contact-actions
-npx @deneb-ui/cli add location-card
-npx @deneb-ui/cli add whatsapp-button
-npx @deneb-ui/cli add dialog
-npx @deneb-ui/cli add all
-```
+## Commands
 
-### 7. `deneb create <project-name>` (Start from Scratch)
-Scaffolds a brand-new Next.js App Router storefront pre-configured with Tailwind CSS and `@deneb-ui/ui`:
+| Command | Description |
+| :--- | :--- |
+| `deneb init` | Run **Deneb ARC** — AST conversion of React/Next.js apps into Fivora-editable templates |
+| `deneb init --legacy` | Use the legacy regex converter instead of ARC |
+| `deneb init --dry-run` | Simulate conversion; print field paths without writing |
+| `deneb init --explain` | Show transformation plan with confidence scores |
+| `deneb validate` | Preflight manifest + visual editing contract checks |
+| `deneb zip` | Create upload-ready `fivora-template.zip` |
+| `deneb doctor` | Environment, dependency, and export diagnostics |
+| `deneb add <component>` | Copy DENEB UI components into your project |
+| `deneb lab` | Launch local visual editing preview lab |
+| `deneb update` | Update `@deneb-ui/*` packages and synced components |
+
+Full reference: [deneb.fivora.site/docs/cli](https://deneb.fivora.site/docs/cli)
 
-```bash
-npx @deneb-ui/cli create my-store
-```
+---
 
-### 8. `deneb lab` (Local Visual Editing Lab)
-Launches the interactive visual editing test lab simulating Fivora editor messages:
+## What `deneb init` does (ARC)
 
-```bash
-npm run lab
-# Or: deneb lab .
-```
+1. **Scans** your Next.js project — routes, dependencies, reachable pages  
+2. **Analyzes** JSX for editable text, images, URLs, collections, CTAs  
+3. **Transforms** source via AST — injects preview markers and `site-data` bindings  
+4. **Generates** `fivora-template.json` + `site-data.json` with strict self-validation  
+5. **Backs up** changed files to `.deneb-backup-*` for safe rollback  
 
 ---
 
-## 👤 Author & Credits
+## Authors
+
+Created and maintained by **[Chamika Gayashan](https://github.com/chamikathereal)** and **[Induranga Kawishwara](https://github.com/Induranga-kawishwara)**.
 
-Created and architected by **Chamika Gayashan & Induranga Kawishwara**.  
-Part of the **DENEB UI** ecosystem.
+<p align="center">
+  <sub>MIT © DENEB UI</sub>
+</p>

package/bin/index.js

@@ -444,6 +444,31 @@ function getComponentRegistry(importPkg) {
       component: 'EditableProductCard',
       code: `'use client';\n\nimport { EditableProductCard, type EditableProductCardProps } from '${importPkg}';\n\nexport function ProductCard(props: EditableProductCardProps) {\n  return <EditableProductCard {...props} />;\n}\n`,
     },
+    'product-grid': {
+      file: 'ProductGrid.tsx',
+      component: 'EditableProductGrid',
+      code: `'use client';\n\nimport { EditableProductGrid, ProductGrid, type EditableProductGridProps, type ProductGridItem } from '${importPkg}';\n\nexport { EditableProductGrid, ProductGrid, type EditableProductGridProps, type ProductGridItem };\n`,
+    },
+    'product-detail': {
+      file: 'ProductDetail.tsx',
+      component: 'EditableProductDetail',
+      code: `'use client';\n\nimport { EditableProductDetail, ProductDetail, type EditableProductDetailProps, type ProductDetailItem } from '${importPkg}';\n\nexport { EditableProductDetail, ProductDetail, type EditableProductDetailProps, type ProductDetailItem };\n`,
+    },
+    'customer-reviews': {
+      file: 'CustomerReviews.tsx',
+      component: 'EditableCustomerReviews',
+      code: `'use client';\n\nimport { EditableCustomerReviews, CustomerReviews, type EditableCustomerReviewsProps, type CustomerReviewItem } from '${importPkg}';\n\nexport { EditableCustomerReviews, CustomerReviews, type EditableCustomerReviewsProps, type CustomerReviewItem };\n`,
+    },
+    'cart-drawer': {
+      file: 'CartDrawer.tsx',
+      component: 'EditableCartDrawer',
+      code: `'use client';\n\nimport { EditableCartDrawer, CartDrawer, type EditableCartDrawerProps } from '${importPkg}';\n\nexport { EditableCartDrawer, CartDrawer, type EditableCartDrawerProps };\n`,
+    },
+    'filter-sidebar': {
+      file: 'FilterSidebar.tsx',
+      component: 'EditableFilterSidebar',
+      code: `'use client';\n\nimport { EditableFilterSidebar, FilterSidebar, type EditableFilterSidebarProps, type FilterOptionGroup } from '${importPkg}';\n\nexport { EditableFilterSidebar, FilterSidebar, type EditableFilterSidebarProps, type FilterOptionGroup };\n`,
+    },
     'pricing-card': {
       file: 'PricingCard.tsx',
       component: 'EditablePricingCard',
@@ -572,13 +597,13 @@ function getComponentRegistry(importPkg) {
   };
 }
 
-function initProject(targetInput) {
+function initProject(targetInput, options = {}) {
   const targetDir = path.resolve(process.cwd(), targetInput || '.');
   const pkgPath = path.join(targetDir, 'package.json');
 
   console.log('\n' + createBox([
-    '\x1b[1m\x1b[37mDENEB TEMPLATE INITIALIZER\x1b[0m',
-    '\x1b[90mConfigure existing Next.js project for Fivora Platform\x1b[0m',
+    '\x1b[1m\x1b[37mDENEB ARC\x1b[0m',
+    '\x1b[90mAdaptive Refactoring Compiler for Fivora-editable UI\x1b[0m',
     '\x1b[90mPowered by DENEB-UI Collaborate with FIVORA\x1b[0m'
   ], 58) + '\n');
 
@@ -612,20 +637,27 @@ function initProject(targetInput) {
   // 1. Scan / Detect Pages
   const detectedPages = detectPages(targetDir);
 
-  // 2. Run Universal Template Conversion Engine
-  // Automatically detects CSS/UI frameworks (shadcn/ui, HeroUI, Tailwind CSS),
-  // creates safe backup, instruments Root Layout with SiteDataProvider,
-  // extracts hardcoded text/images/buttons/placeholders,
-  // injects data-preview-field-path markers, harmonizes UI components,
-  // and builds synchronized site-data.json & fivora-template.json.
+  // 2. Deneb ARC (default) or legacy regex converter (--legacy)
   let conversionRes = null;
   try {
-    const { runUniversalTemplateConversion } = require('../src/tools/template-converter.cjs');
-    conversionRes = runUniversalTemplateConversion(targetDir, projectName, detectedPages);
+    if (options.legacy) {
+      const { runUniversalTemplateConversion } = require('../src/tools/template-converter.cjs');
+      conversionRes = runUniversalTemplateConversion(targetDir, projectName, detectedPages, options);
+    } else {
+      const { runDenebArc } = require('../src/arc/index.cjs');
+      conversionRes = runDenebArc(targetDir, projectName, {
+        ...options,
+        detectedPages,
+      });
+    }
   } catch (err) {
     console.error(`\x1b[33m⚠ Note:\x1b[0m Automated conversion encountered an issue: ${err.message}. Falling back to default generation.`);
   }
 
+  if (options.dryRun) {
+    return conversionRes;
+  }
+
   // 3. Fallback: Generate fivora-template.json if not yet present
   const manifestPath = path.join(targetDir, 'fivora-template.json');
   if (!fs.existsSync(manifestPath)) {
@@ -957,198 +989,9 @@ Options:
   ], 58) + '\n');
 }
 
-function runDoctor(targetDirInput) {
-  const targetDir = path.resolve(targetDirInput || '.');
-
-  console.log('\n' + createBox([
-    '\x1b[1m\x1b[36m🩺 DENEB SYSTEM & TEMPLATE DOCTOR\x1b[0m',
-    '\x1b[90mComprehensive diagnostic analysis for Fivora & Next.js\x1b[0m',
-    `\x1b[37mTarget:\x1b[0m ${targetDir}`
-  ], 60) + '\n');
-
-  let passed = 0;
-  let warnings = 0;
-  let errors = 0;
-
-  function report(type, title, detail) {
-    if (type === 'pass') {
-      passed++;
-      console.log(`  \x1b[32m✔\x1b[0m \x1b[1m${title}\x1b[0m${detail ? ` \x1b[90m(${detail})\x1b[0m` : ''}`);
-    } else if (type === 'warn') {
-      warnings++;
-      console.log(`  \x1b[33m⚠\x1b[0m \x1b[33m${title}\x1b[0m${detail ? ` \x1b[90m- ${detail}\x1b[0m` : ''}`);
-    } else {
-      errors++;
-      console.log(`  \x1b[31m✖\x1b[0m \x1b[31m${title}\x1b[0m${detail ? ` \x1b[90m- ${detail}\x1b[0m` : ''}`);
-    }
-  }
-
-  console.log('\x1b[1m[1/6] System & Runtime Environment:\x1b[0m');
-  const nodeVersion = process.version;
-  const majorNode = parseInt(nodeVersion.replace(/^v/, '').split('.')[0], 10);
-  if (majorNode >= 18) {
-    report('pass', 'Node.js Runtime', `${nodeVersion} (Supported)`);
-  } else {
-    report('err', 'Node.js Runtime', `${nodeVersion} (Requires Node.js >= 18.0.0)`);
-  }
-
-  const npmBin = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-  const npmCheck = spawnSync(npmBin, ['--version'], { encoding: 'utf-8', shell: process.platform === 'win32' });
-  if (!npmCheck.error && npmCheck.status === 0) {
-    report('pass', 'Package Manager', `npm v${npmCheck.stdout.trim()}`);
-  } else {
-    report('warn', 'Package Manager', 'npm not found in system PATH');
-  }
-
-  console.log('\n\x1b[1m[2/6] Project Package Configuration:\x1b[0m');
-  const pkgPath = path.join(targetDir, 'package.json');
-  let pkg = null;
-  if (fs.existsSync(pkgPath)) {
-    try {
-      pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-      report('pass', 'package.json', `Found "${pkg.name || 'unnamed'}"`);
-      const allDeps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
-
-      if (allDeps['next']) {
-        report('pass', 'Next.js Framework', allDeps['next']);
-      } else {
-        report('err', 'Next.js Framework', 'next dependency missing in package.json');
-      }
-
-      if (allDeps['@deneb-ui/ui']) {
-        report('pass', '@deneb-ui/ui Library', allDeps['@deneb-ui/ui']);
-      } else {
-        report('warn', '@deneb-ui/ui Library', 'Not installed (run "npm i @deneb-ui/ui")');
-      }
-
-      if (allDeps['@deneb-ui/cli']) {
-        report('pass', '@deneb-ui/cli Tooling', allDeps['@deneb-ui/cli']);
-      } else {
-        report('warn', '@deneb-ui/cli Tooling', 'Recommended for local CLI scripts');
-      }
-    } catch (e) {
-      report('err', 'package.json Syntax', e.message);
-    }
-  } else {
-    report('err', 'package.json', `Not found at ${pkgPath}`);
-  }
-
-  console.log('\n\x1b[1m[3/6] Static Export Configuration:\x1b[0m');
-  const nextConfigTs = path.join(targetDir, 'next.config.ts');
-  const nextConfigMjs = path.join(targetDir, 'next.config.mjs');
-  const nextConfigJs = path.join(targetDir, 'next.config.js');
-  let nextConfigFile = [nextConfigTs, nextConfigMjs, nextConfigJs].find((p) => fs.existsSync(p));
-
-  if (nextConfigFile) {
-    const content = fs.readFileSync(nextConfigFile, 'utf-8');
-    if (content.includes("output: 'export'") || content.includes('output: "export"')) {
-      report('pass', 'Next.js Static Export', `output: 'export' verified in ${path.basename(nextConfigFile)}`);
-    } else {
-      report('err', 'Next.js Static Export', `Missing output: 'export' in ${path.basename(nextConfigFile)} (Required by Fivora)`);
-    }
-  } else {
-    report('err', 'Next.js Config', 'No next.config.ts, next.config.mjs, or next.config.js found');
-  }
-
-  console.log('\n\x1b[1m[4/6] Fivora Manifest v2 Contract:\x1b[0m');
-  const manifestPath = path.join(targetDir, 'fivora-template.json');
-  let manifestData = null;
-  if (fs.existsSync(manifestPath)) {
-    try {
-      manifestData = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
-      report('pass', 'fivora-template.json', `Valid JSON (strict=${manifestData.strict !== false})`);
-
-      if (manifestData.version === 2 || manifestData.version === '2') {
-        report('pass', 'Manifest Version', 'Version 2 (Current standard)');
-      } else {
-        report('warn', 'Manifest Version', `Version ${manifestData.version} detected (Recommend version 2)`);
-      }
-
-      const hasHome = Array.isArray(manifestData.pages) && manifestData.pages.some((p) =>
-        p.route === '/' || p.slug === '/' || p.path === '/' || p.id === 'home'
-      );
-      if (hasHome) {
-        report('pass', 'Home Page Entry', 'Home page ("/") declared in manifest');
-      } else {
-        report('err', 'Home Page Entry', 'Manifest pages array missing root slug or route: "/"');
-      }
-
-      if (manifestData.theme && (manifestData.theme.primary || manifestData.theme.accent)) {
-        report('pass', 'Theme Configuration', 'Primary and accent color tokens declared');
-      } else {
-        // Will check site-data.json below as alternative
-      }
-    } catch (e) {
-      report('err', 'fivora-template.json Syntax', e.message);
-    }
-  } else {
-    report('err', 'fivora-template.json', 'File not found. Run "deneb init" to generate it');
-  }
-
-  console.log('\n\x1b[1m[5/6] Reactive Site Data & Visual Editing:\x1b[0m');
-  const siteDataPath = path.join(targetDir, 'src', 'data', 'site-data.json');
-  if (fs.existsSync(siteDataPath)) {
-    try {
-      const siteData = JSON.parse(fs.readFileSync(siteDataPath, 'utf-8'));
-      report('pass', 'site-data.json', 'src/data/site-data.json exists & valid');
-      const merchantName = (siteData.merchant && (siteData.merchant.businessName || siteData.merchant.name)) || null;
-      if (merchantName) {
-        report('pass', 'Merchant Metadata', `Name: "${merchantName}"`);
-      } else {
-        report('warn', 'Merchant Metadata', 'Missing merchant name in site-data.json');
-      }
-
-      const themeTokens = manifestData?.theme || siteData?.template?.structure?.theme;
-      if (themeTokens && (themeTokens.primaryColor || themeTokens.primary || themeTokens.accentColor || themeTokens.accent)) {
-        report('pass', 'Theme Design Tokens', 'Theme color tokens declared');
-      } else {
-        report('warn', 'Theme Design Tokens', 'No theme color tokens found in manifest or site-data.json');
-      }
-
-      if (siteData.content) {
-        report('pass', 'Visual Content Bindings', 'Content section ready for live sync');
-      } else {
-        report('warn', 'Visual Content Bindings', 'Missing content section in site-data.json');
-      }
-    } catch (e) {
-      report('err', 'site-data.json Syntax', e.message);
-    }
-  } else {
-    report('warn', 'site-data.json', 'src/data/site-data.json not found. Recommended for Fivora live editor');
-  }
-
-  console.log('\n\x1b[1m[6/6] Cleanliness & Security Check:\x1b[0m');
-  const envFiles = ['.env', '.env.local', '.env.production', '.env.development'];
-  const foundEnv = envFiles.filter((f) => fs.existsSync(path.join(targetDir, f)));
-  if (foundEnv.length === 0) {
-    report('pass', 'Secrets Isolation', 'No raw .env files detected in root directory');
-  } else {
-    report('warn', 'Secrets Isolation', `Active env files: ${foundEnv.join(', ')} (Excluded during packaging)`);
-  }
-
-  const previewExists = fs.existsSync(path.join(targetDir, 'preview.png')) ||
-    fs.existsSync(path.join(targetDir, 'thumbnail.png')) ||
-    fs.existsSync(path.join(targetDir, 'public', 'fivora-logo.png'));
-  if (previewExists) {
-    report('pass', 'Storefront Assets', 'Brand/preview graphics verified');
-  } else {
-    report('warn', 'Storefront Assets', 'preview.png not found in template root');
-  }
-
-  // Summary
-  console.log('\n' + createBox([
-    '\x1b[1mDOCTOR DIAGNOSTIC SUMMARY\x1b[0m',
-    `\x1b[32m✔ Passed:\x1b[0m   ${passed}`,
-    `\x1b[33m⚠ Warnings:\x1b[0m ${warnings}`,
-    `\x1b[31m✖ Errors:\x1b[0m   ${errors}`,
-    errors === 0
-      ? '\x1b[32mStatus: HEALTHY — Ready for Fivora packaging & build!\x1b[0m'
-      : '\x1b[31mStatus: ATTENTION REQUIRED — Fix errors before deployment\x1b[0m'
-  ], 58) + '\n');
-
-  if (errors > 0) {
-    process.exit(1);
-  }
+function runDoctor(targetDirInput, options = {}) {
+  const { runDoctor: executeDoctor } = require('../src/tools/deneb-doctor.cjs');
+  return executeDoctor(targetDirInput, options);
 }
 
 // Normalize multi-word "validate and zip" or "validate & zip"
@@ -1161,13 +1004,55 @@ if (command === 'validate' && (commandArgs[0] === 'and' || commandArgs[0] === '&
 }
 
 if (command === 'init') {
-  initProject(commandArgs[0]);
+  let targetInput = '.';
+  let recipeName = null;
+  let dryRun = false;
+  let explain = false;
+  let legacy = false;
+  let telemetry = 'off';
+  for (let i = 0; i < commandArgs.length; i++) {
+    const arg = commandArgs[i];
+    if (arg === '--recipe' || arg === '-r') {
+      recipeName = commandArgs[++i];
+    } else if (arg.startsWith('--recipe=')) {
+      recipeName = arg.split('=')[1];
+    } else if (arg === '--dry-run' || arg === '--dryrun') {
+      dryRun = true;
+    } else if (arg === '--explain') {
+      explain = true;
+    } else if (arg === '--legacy') {
+      legacy = true;
+    } else if (arg === '--telemetry' && commandArgs[i + 1]) {
+      telemetry = commandArgs[++i];
+    } else if (arg.startsWith('--telemetry=')) {
+      telemetry = arg.split('=')[1] || 'off';
+    } else if (!arg.startsWith('-')) {
+      targetInput = arg;
+    }
+  }
+  initProject(targetInput, { recipeName, dryRun, explain, legacy, telemetry });
 } else if (command === 'create') {
   createTemplate(commandArgs[0]);
 } else if (command === 'add') {
   addComponent(commandArgs[0], commandArgs[1]);
 } else if (command === 'doctor' || command === 'check') {
-  runDoctor(commandArgs[0]);
+  let targetInput = '.';
+  let fix = false;
+  let json = false;
+  for (let i = 0; i < commandArgs.length; i++) {
+    const arg = commandArgs[i];
+    if (arg === '--fix' || arg === '-f') {
+      fix = true;
+    } else if (arg === '--json') {
+      json = true;
+    } else if (!arg.startsWith('-')) {
+      targetInput = arg;
+    }
+  }
+  const res = runDoctor(targetInput, { fix, json });
+  if (res && res.errors > 0) {
+    process.exit(1);
+  }
 } else if (command === 'lab') {
   const script = path.join(toolsDir, 'local-template-lab.cjs');
   const res = spawnSync(process.execPath, [script, ...commandArgs], { stdio: 'inherit' });
@@ -1208,12 +1093,13 @@ if (command === 'init') {
   DENEB UI Framework — Powered by DENEB-UI Collaborate with FIVORA
 
 Core Commands:
-  init              Auto-convert & configure existing Next.js (shadcn/HeroUI/Tailwind) into editable Fivora template
+  init              Deneb ARC: convert an existing React/Next.js app into a Fivora-editable storefront
+                    flags: --dry-run  --explain  --recipe <name>  --legacy  --telemetry off|anonymous|enhanced
+  doctor            Run comprehensive environment, manifest, visual editing AST & asset diagnostic checks (flags: --fix, --json)
   save-recipe       Learn and save calibrated fixes & schemas into reusable recipe bank (e.g. deneb save-recipe . shoes-store)
   learn             Alias for save-recipe
   update            Update DENEB packages (@deneb-ui/ui, @deneb-ui/cli) and UI components
   validate          Validate website configuration and visual editing contracts with Fivora platform
-  doctor            Run comprehensive environment, manifest & asset diagnostic checks
   zip               Zip the project without unnecessary folders or files (node_modules, .next, .git, .env)
   validate-and-zip  Validate website configuration and immediately package clean upload-ready ZIP
 
@@ -1226,7 +1112,15 @@ Development & Scaffolding:
 
 Examples:
   deneb doctor
+  deneb doctor --fix
+  deneb doctor --json
   deneb init
+  deneb init --dry-run
+  deneb init --explain
+  deneb init --recipe fashion
+  deneb init --recipe electronics
+  deneb init --recipe cosmetics
+  deneb init --legacy
   deneb update
   deneb validate .
   deneb validate --zip

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deneb-ui/cli",
-  "version": "2.0.21",
-  "description": "Official developer CLI for DENEB UI — Validating, scaffolding, testing, and packaging storefront templates. Created by Chamika Gayashan & Induranga Kawishwara.",
+  "version": "2.0.23",
+  "description": "Official DENEB CLI — scaffold, convert, validate, and package Fivora-ready storefront templates.",
   "bin": {
     "deneb": "bin/index.js",
     "denebui": "bin/index.js",
@@ -15,7 +15,7 @@
     "url": "git+https://github.com/deneb-ui/core.git",
     "directory": "cli/deneb-cli"
   },
-  "homepage": "https://github.com/deneb-ui/core#readme",
+  "homepage": "https://deneb.fivora.site/docs/cli",
   "bugs": {
     "url": "https://github.com/deneb-ui/core/issues"
   },
@@ -24,16 +24,31 @@
     "src",
     "README.md"
   ],
+  "scripts": {
+    "test": "node --test src/arc/__tests__/arc.test.cjs"
+  },
   "keywords": [
     "deneb",
     "deneb-ui",
     "cli",
+    "fivora",
+    "nextjs",
+    "template",
     "validator",
-    "packager"
+    "packager",
+    "visual-editing",
+    "storefront",
+    "scaffold"
   ],
   "author": "Chamika Gayashan & Induranga Kawishwara",
+  "contributors": [
+    "Chamika Gayashan <https://github.com/chamikathereal>",
+    "Induranga Kawishwara <https://github.com/Induranga-kawishwara>"
+  ],
   "license": "MIT",
   "dependencies": {
-    "adm-zip": "^0.6.0"
+    "@babel/parser": "^7.28.0",
+    "adm-zip": "^0.6.0",
+    "recast": "^0.23.11"
   }
 }

package/src/arc/__fixtures__/next-app-basic/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "arc-fixture-next-app",
+  "private": true,
+  "dependencies": {
+    "next": "16.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwindcss": "^3.4.0"
+  }
+}

package/src/arc/__fixtures__/next-app-basic/src/app/globals.css

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

package/src/arc/__fixtures__/next-app-basic/src/app/layout.tsx

@@ -0,0 +1,9 @@
+import './globals.css';
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/src/arc/__fixtures__/next-app-basic/src/app/page.tsx

@@ -0,0 +1,11 @@
+import { Hero } from '../components/Hero';
+import { Header } from '../components/Header';
+
+export default function HomePage() {
+  return (
+    <main>
+      <Header />
+      <Hero />
+    </main>
+  );
+}