@aifabrix/builder 2.32.3 → 2.33.0

package/.cursor/rules/project-rules.mdc

@@ -24,6 +24,8 @@ Technologies:
 
 ## Architecture Patterns
 
+> **Visual Documentation**: When documenting architecture, workflows, or command flows, use the canonical Mermaid diagram templates from [flows-and-visuals.md](flows-and-visuals.md). These templates ensure consistent styling and accurate representation of Builder architecture.
+
 ### Module Structure
 - All modules use CommonJS (`require`/`module.exports`)
 - Main entry point: `bin/aifabrix.js`
@@ -506,6 +508,12 @@ function resolveSecret(key) {
 - Document error conditions
 - Add examples in comments for complex methods
 - Document security considerations
+- **Visual Documentation**: Use canonical Mermaid diagram templates from [flows-and-visuals.md](flows-and-visuals.md) for architecture diagrams and workflow visualizations
+  - Use Template 1 for overall Builder architecture
+  - Use Template 2 for application creation flows
+  - Use Template 3 for development lifecycle workflows
+  - Use Template 4 for wizard/external system flows
+  - Follow strict styling guidelines (colors, fonts, spacing) defined in flows-and-visuals.md
 
 ### Code Comments
 - Use JSDoc format for function documentation

package/README.md

@@ -69,15 +69,43 @@ aifabrix run miso-controller
 5. **Deploy** - Push to ACR and deploy via controller
 
 ```mermaid
+%%{init: {
+  "theme": "base",
+  "themeVariables": {
+    "fontFamily": "Poppins, Arial Rounded MT Bold, Arial, sans-serif",
+    "fontSize": "16px",
+    "background": "#FFFFFF",
+    "primaryColor": "#F8FAFC",
+    "primaryTextColor": "#0B0E15",
+    "primaryBorderColor": "#E2E8F0",
+    "lineColor": "#E2E8F0",
+    "textColor": "#0B0E15",
+    "borderRadius": 16
+  },
+  "flowchart": {
+    "curve": "linear",
+    "nodeSpacing": 34,
+    "rankSpacing": 34,
+    "padding": 10
+  }
+}}%%
+
 flowchart TD
-    Install[Install CLI] --> Up[Start Infrastructure]
-    Up --> Create[Create App]
-    Create --> Build[Build Image]
-    Build --> Run[Run Locally]
-    Run --> Deploy[Deploy to Azure]
-    
-    style Install fill:#0062FF,color:#FFFFFF
-    style Deploy fill:#10B981,color:#FFFFFF
+
+%% =======================
+%% Styles
+%% =======================
+classDef base fill:#FFFFFF,color:#0B0E15,stroke:#E2E8F0,stroke-width:1.5px;
+classDef primary fill:#0062FF,color:#ffffff,stroke-width:0px;
+
+%% =======================
+%% Flow
+%% =======================
+Install[Install CLI]:::primary --> Up[Start Infrastructure]:::base
+Up --> Create[Create App]:::base
+Create --> Build[Build Image]:::base
+Build --> Run[Run Locally]:::base
+Run --> Deploy[Deploy to Azure]:::primary
 ```
 
 ## Requirements

package/bin/aifabrix.js

@@ -15,9 +15,8 @@
 
 const { Command } = require('commander');
 const cli = require('../lib/cli');
-const { setupAppCommands } = require('../lib/commands/app');
-const { setupDatasourceCommands } = require('../lib/commands/datasource');
 const logger = require('../lib/utils/logger');
+const { buildCategorizedHelp } = require('../lib/utils/help-builder');
 const packageJson = require('../package.json');
 
 /**
@@ -31,14 +30,13 @@ function initializeCLI() {
     .version(packageJson.version)
     .description('AI Fabrix Local Fabric & Deployment SDK');
 
-  // Delegate command setup to lib/cli.js
+  // Delegate command setup to lib/cli.js (order matches help categories for consistency)
   cli.setupCommands(program);
 
-  // Add application management commands
-  setupAppCommands(program);
-
-  // Add datasource management commands
-  setupDatasourceCommands(program);
+  // Use categorized help for a more user-friendly command list
+  program.helpInformation = function() {
+    return buildCategorizedHelp(program);
+  };
 
   // Parse command line arguments
   program.parse();

package/integration/hubspot/README.md

@@ -9,10 +9,11 @@ This integration connects to HubSpot CRM API and exposes companies, contacts, an
 ## Files
 
 - `variables.yaml` - Application configuration with externalIntegration block
-- `hubspot-deploy.json` - External system definition with OAuth2 authentication
-- `hubspot-deploy-company.json` - Companies datasource with field mappings
-- `hubspot-deploy-contact.json` - Contacts datasource with field mappings
-- `hubspot-deploy-deal.json` - Deals datasource with field mappings
+- `hubspot-system.json` - External system definition with OAuth2 authentication
+- `hubspot-datasource-company.json` - Companies datasource with field mappings
+- `hubspot-datasource-contact.json` - Contacts datasource with field mappings
+- `hubspot-datasource-deal.json` - Deals datasource with field mappings
+- `hubspot-deploy.json` - Deployment manifest (generated)
 - `env.template` - Environment variables template with kv:// references
 
 ## Setup
@@ -57,9 +58,9 @@ aifabrix app register hubspot --environment dev
 aifabrix deploy hubspot --controller http://localhost:3100 --environment dev
 
 # Or deploy individual datasources for testing
-aifabrix datasource deploy hubspot-company --environment dev --file integration/hubspot/hubspot-deploy-company.json
-aifabrix datasource deploy hubspot-contact --environment dev --file integration/hubspot/hubspot-deploy-contact.json
-aifabrix datasource deploy hubspot-deal --environment dev --file integration/hubspot/hubspot-deploy-deal.json
+aifabrix datasource deploy hubspot-company --environment dev --file integration/hubspot/hubspot-datasource-company.json
+aifabrix datasource deploy hubspot-contact --environment dev --file integration/hubspot/hubspot-datasource-contact.json
+aifabrix datasource deploy hubspot-deal --environment dev --file integration/hubspot/hubspot-datasource-deal.json
 ```
 
 ## Field Mappings