@liquidmetal-ai/raindrop 0.13.0 → 0.15.0

package/bundle/commands/query/search.js

@@ -1,14 +1,14 @@
 import {
   ulid
-} from "../../chunk-6MIGCNUO.js";
+} from "../../chunk-VOT5MMEY.js";
 import {
   BaseCommand
-} from "../../chunk-LDFYPOXJ.js";
+} from "../../chunk-TFQY5TSY.js";
 import {
   __toESM,
   init_cjs_shims,
   require_lib
-} from "../../chunk-V5LHJTYS.js";
+} from "../../chunk-KLOYSTZY.js";
 
 // src/commands/query/search.ts
 init_cjs_shims();
@@ -37,26 +37,6 @@ Get page 2 of previous search results.
       multiple: true,
       required: false
     }),
-    "module-ids": import_core.Flags.string({
-      description: "Module IDs to search in (deprecated, use --buckets with smartbucket names)",
-      multiple: true,
-      required: false,
-      hidden: true,
-      deprecated: {
-        message: "use --buckets with smartbucket names instead",
-        version: "3.0.0"
-      }
-    }),
-    moduleIds: import_core.Flags.string({
-      description: "Module IDs to search in (deprecated, use --module-ids)",
-      multiple: true,
-      required: false,
-      hidden: true,
-      deprecated: {
-        message: "use --module-ids instead",
-        version: "2.0.0"
-      }
-    }),
     "request-id": import_core.Flags.string({
       description: "request ID for pagination",
       required: false
@@ -94,11 +74,7 @@ Get page 2 of previous search results.
     })
   };
   async run() {
-    const moduleIds = this.flags["module-ids"] || this.flags.moduleIds;
     const requestIdValue = this.flags["request-id"] || this.flags.requestId;
-    if (this.flags.buckets?.length && moduleIds?.length) {
-      this.error("Cannot specify both --buckets and --module-ids flags. Please use only one type of filter.");
-    }
     if (this.flags.buckets?.some((bucket) => !bucket.includes("#"))) {
       await this.loadConfig();
     }
@@ -133,27 +109,19 @@ Get page 2 of previous search results.
       response = await searchAgentService.runSupervisorAgent({
         requestId,
         input: args.query,
-        bucketLocations: [
-          ...(this.flags.buckets || []).map((bucket) => {
-            const [bucketName, version] = bucket.split("#");
-            return {
-              bucketLocation: {
-                case: "bucket",
-                value: {
-                  name: bucketName,
-                  version: version || this.raindropConfig?.versionId || "",
-                  applicationName
-                }
-              }
-            };
-          }),
-          ...(moduleIds || []).map((moduleId) => ({
+        bucketLocations: (this.flags.buckets || []).map((bucket) => {
+          const [bucketName, version] = bucket.split("#");
+          return {
             bucketLocation: {
-              case: "moduleId",
-              value: moduleId
+              case: "bucket",
+              value: {
+                name: bucketName,
+                version: version || this.raindropConfig?.versionId || "",
+                applicationName
+              }
             }
-          }))
-        ],
+          };
+        }),
         userId,
         organizationId
       });

package/bundle/commands/tail.js

@@ -1,9 +1,9 @@
 import {
   BaseCommand
-} from "../chunk-LDFYPOXJ.js";
+} from "../chunk-TFQY5TSY.js";
 import {
   init_cjs_shims
-} from "../chunk-V5LHJTYS.js";
+} from "../chunk-KLOYSTZY.js";
 
 // src/commands/tail.ts
 init_cjs_shims();

package/bundle/index.js

@@ -25,7 +25,7 @@ import {
   stripeIntegrationService,
   versionInterceptor,
   workosIntegrationService
-} from "./chunk-V5LHJTYS.js";
+} from "./chunk-KLOYSTZY.js";
 var export_run = import_core.run;
 export {
   EPOCH_TS,

package/dist/commands/build/actor/setup.d.ts

@@ -0,0 +1,22 @@
+import { BaseCommand } from '../../../base-command.js';
+export default class ActorSetup extends BaseCommand<typeof ActorSetup> {
+    static args: {};
+    static description: string;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthService: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        raindropCatalogService: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthToken: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowOrganizationId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowUserId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sendVersionMetadata: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private toPascalCase;
+    private generateActorFile;
+    private updateManifest;
+}
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/build/actor/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/actor/setup.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW,CAAC,OAAO,UAAU,CAAC;IACpE,MAAM,CAAC,IAAI,KAAM;IAEjB,MAAM,CAAC,WAAW,SAAgE;IAElF,MAAM,CAAC,QAAQ,WAOb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;MAUV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAuD1B,OAAO,CAAC,YAAY;YAON,iBAAiB;YAKjB,cAAc;CA6B7B"}

package/dist/commands/build/actor/setup.js

@@ -0,0 +1,116 @@
+import { Flags } from '@oclif/core';
+import chalk from 'chalk';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { BaseCommand } from '../../../base-command.js';
+import { renderTemplateFromFile, TEMPLATES_DIR } from '../../../codegen.js';
+export default class ActorSetup extends BaseCommand {
+    static args = {};
+    static description = 'Add a stateful actor (Durable Object) to your Raindrop app';
+    static examples = [
+        `<%= config.bin %> <%= command.id %>
+Add actor with default name "my-actor"
+
+<%= config.bin %> <%= command.id %> --name counter
+Add actor with custom name "counter"
+`,
+    ];
+    static flags = {
+        ...BaseCommand.HIDDEN_FLAGS,
+        name: Flags.string({
+            description: 'Name for the actor',
+            default: 'my-actor',
+        }),
+        'dry-run': Flags.boolean({
+            description: 'Preview changes without applying them',
+            default: false,
+        }),
+    };
+    async run() {
+        const actorName = this.flags.name;
+        const className = this.toPascalCase(actorName);
+        const dryRun = this.flags['dry-run'];
+        if (dryRun) {
+            this.log(chalk.blue.bold('DRY RUN - Preview of changes (no files will be modified)'));
+            this.log('');
+            this.log(chalk.blue('Would create:') + ' ' + chalk.bold(`src/${actorName}/index.ts`));
+            this.log(chalk.dim('  - 70 lines of actor code'));
+            this.log(chalk.dim('  - State management, counter, data storage'));
+            this.log('');
+            this.log(chalk.blue('Would update:') + ' ' + chalk.bold('raindrop.manifest'));
+            this.log(chalk.dim(`  + actor "${actorName}" {}`));
+            this.log('');
+            this.log(chalk.blue('Environment binding:') + ' ' + chalk.bold(`this.env.${className.toUpperCase()}`));
+            this.log('');
+            this.log(chalk.yellow('Run without --dry-run to apply these changes'));
+            return;
+        }
+        try {
+            // Step 1: Create actor directory
+            const actorDir = path.join(process.cwd(), 'src', actorName);
+            await fs.mkdir(actorDir, { recursive: true });
+            // Step 2: Generate actor file
+            const actorContent = await this.generateActorFile(className);
+            const actorPath = path.join(actorDir, 'index.ts');
+            await fs.writeFile(actorPath, actorContent);
+            this.log(chalk.green('✓') + ' Created ' + chalk.bold(`src/${actorName}/index.ts`));
+            // Step 3: Update manifest
+            await this.updateManifest(actorName);
+            this.log(chalk.green('✓') + ' Updated ' + chalk.bold('raindrop.manifest'));
+            // Step 4: Show next steps
+            this.log('');
+            this.log(chalk.bold.cyan('Next Steps:'));
+            this.log('');
+            this.log('1. Run ' + chalk.bold('raindrop build generate') + ' to update types');
+            this.log('2. Check out ' + chalk.bold(`src/${actorName}/index.ts`) + ' for the actor code');
+            this.log('3. Call actor methods from your services:');
+            this.log('');
+            this.log(chalk.dim('Example usage:'));
+            this.log(chalk.dim(`  const actorId = this.env.${className.toUpperCase()}.idFromName('user-123');`));
+            this.log(chalk.dim(`  const actor = this.env.${className.toUpperCase()}.get(actorId);`));
+            this.log(chalk.dim(`  const count = await actor.increment();`));
+            this.log('');
+        }
+        catch (error) {
+            this.error(`Failed to set up actor: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    toPascalCase(str) {
+        return str
+            .split(/[-_]/)
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+            .join('');
+    }
+    async generateActorFile(className) {
+        const templatePath = path.join(TEMPLATES_DIR, 'handlers', 'actor', 'index.ts.hbs');
+        return renderTemplateFromFile(templatePath, { actorClassName: className });
+    }
+    async updateManifest(actorName) {
+        const manifestPath = path.join(process.cwd(), 'raindrop.manifest');
+        try {
+            let content = await fs.readFile(manifestPath, 'utf-8');
+            // Check if actor already exists
+            if (content.includes(`actor "${actorName}"`)) {
+                this.log(chalk.yellow('⚠') + ' Actor already exists in manifest');
+                return;
+            }
+            // Find the application block and add the actor
+            const appMatch = content.match(/application\s+"[^"]+"\s+\{/);
+            if (appMatch) {
+                const insertPos = appMatch.index + appMatch[0].length;
+                const binding = `\n  actor "${actorName}" {}\n`;
+                content = content.slice(0, insertPos) + binding + content.slice(insertPos);
+                await fs.writeFile(manifestPath, content);
+            }
+            else {
+                throw new Error('Could not find application block in raindrop.manifest');
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new Error('raindrop.manifest not found. Are you in a Raindrop project directory?');
+            }
+            throw error;
+        }
+    }
+}

package/dist/commands/build/bucket-events/setup.d.ts

@@ -0,0 +1,22 @@
+import { BaseCommand } from '../../../base-command.js';
+export default class BucketEventsSetup extends BaseCommand<typeof BucketEventsSetup> {
+    static args: {};
+    static description: string;
+    static examples: string[];
+    static flags: {
+        bucket: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        observer: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthService: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        raindropCatalogService: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthToken: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowOrganizationId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowUserId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sendVersionMetadata: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private generateObserverFile;
+    private updateManifest;
+}
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/build/bucket-events/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/bucket-events/setup.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,WAAW,CAAC,OAAO,iBAAiB,CAAC;IAClF,MAAM,CAAC,IAAI,KAAM;IAEjB,MAAM,CAAC,WAAW,SAAoE;IAEtF,MAAM,CAAC,QAAQ,WAOb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;;MAcV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YA2DZ,oBAAoB;YAKpB,cAAc;CAiD7B"}

package/dist/commands/build/bucket-events/setup.js

@@ -0,0 +1,134 @@
+import { Flags } from '@oclif/core';
+import chalk from 'chalk';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { BaseCommand } from '../../../base-command.js';
+import { renderTemplateFromFile, TEMPLATES_DIR } from '../../../codegen.js';
+export default class BucketEventsSetup extends BaseCommand {
+    static args = {};
+    static description = 'Add bucket event notifications (observer) to your Raindrop app';
+    static examples = [
+        `<%= config.bin %> <%= command.id %>
+Add bucket event observer with default names
+
+<%= config.bin %> <%= command.id %> --bucket uploads --observer file-processor
+Add bucket event observer with custom names
+`,
+    ];
+    static flags = {
+        ...BaseCommand.HIDDEN_FLAGS,
+        bucket: Flags.string({
+            description: 'Name of the bucket to watch',
+            default: 'my-bucket',
+        }),
+        observer: Flags.string({
+            description: 'Name for the event observer',
+            default: 'bucket-events',
+        }),
+        'dry-run': Flags.boolean({
+            description: 'Preview changes without applying them',
+            default: false,
+        }),
+    };
+    async run() {
+        const bucketName = this.flags.bucket;
+        const observerName = this.flags.observer;
+        const dryRun = this.flags['dry-run'];
+        if (dryRun) {
+            this.log(chalk.blue.bold('DRY RUN - Preview of changes (no files will be modified)'));
+            this.log('');
+            this.log(chalk.blue('Would create:') + ' ' + chalk.bold(`src/${observerName}/index.ts`));
+            this.log(chalk.dim('  - 68 lines of bucket event handler code'));
+            this.log(chalk.dim('  - Upload, delete, multipart event handling'));
+            this.log('');
+            this.log(chalk.blue('Would update:') + ' ' + chalk.bold('raindrop.manifest'));
+            this.log(chalk.dim(`  + bucket "${bucketName}" {} (if not exists)`));
+            this.log(chalk.dim(`  + observer "${observerName}" {`));
+            this.log(chalk.dim(`      source { bucket = "${bucketName}" ... }`));
+            this.log(chalk.dim(`    }`));
+            this.log('');
+            this.log(chalk.blue('Environment binding:') + ' ' + chalk.bold(`this.env.${bucketName.toUpperCase().replace(/-/g, '_')}`));
+            this.log('');
+            this.log(chalk.yellow('Run without --dry-run to apply these changes'));
+            return;
+        }
+        try {
+            // Step 1: Create observer directory
+            const observerDir = path.join(process.cwd(), 'src', observerName);
+            await fs.mkdir(observerDir, { recursive: true });
+            // Step 2: Generate observer file
+            const observerContent = await this.generateObserverFile(bucketName);
+            const observerPath = path.join(observerDir, 'index.ts');
+            await fs.writeFile(observerPath, observerContent);
+            this.log(chalk.green('✓') + ' Created ' + chalk.bold(`src/${observerName}/index.ts`));
+            // Step 3: Update manifest
+            await this.updateManifest(bucketName, observerName);
+            this.log(chalk.green('✓') + ' Updated ' + chalk.bold('raindrop.manifest'));
+            // Step 4: Show next steps
+            this.log('');
+            this.log(chalk.bold.cyan('Next Steps:'));
+            this.log('');
+            this.log('1. Run ' + chalk.bold('raindrop build generate') + ' to update types');
+            this.log('2. Check out ' + chalk.bold(`src/${observerName}/index.ts`) + ' for the event handler');
+            this.log('3. Ensure the bucket exists in your manifest:');
+            this.log('');
+            this.log(chalk.dim(`  bucket "${bucketName}" {}`));
+            this.log('');
+            this.log('4. Upload files to the bucket to trigger events:');
+            this.log('');
+            this.log(chalk.dim(`  await this.env.${bucketName.toUpperCase().replace(/-/g, '_')}.put('file.txt', data);`));
+            this.log('');
+        }
+        catch (error) {
+            this.error(`Failed to set up bucket events: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async generateObserverFile(bucketName) {
+        const templatePath = path.join(TEMPLATES_DIR, 'handlers', 'bucket-event-observer.ts.hbs');
+        return renderTemplateFromFile(templatePath, { bucketName });
+    }
+    async updateManifest(bucketName, observerName) {
+        const manifestPath = path.join(process.cwd(), 'raindrop.manifest');
+        try {
+            let content = await fs.readFile(manifestPath, 'utf-8');
+            // Check if observer already exists
+            if (content.includes(`observer "${observerName}"`)) {
+                this.log(chalk.yellow('⚠') + ' Observer already exists in manifest');
+                return;
+            }
+            // Check if bucket exists
+            const hasBucket = content.includes(`bucket "${bucketName}"`);
+            // Find the application block and add the bucket (if needed) and observer
+            const appMatch = content.match(/application\s+"[^"]+"\s+\{/);
+            if (appMatch) {
+                const insertPos = appMatch.index + appMatch[0].length;
+                let binding = '';
+                if (!hasBucket) {
+                    binding += `\n  bucket "${bucketName}" {}\n`;
+                    this.log(chalk.green('✓') + ' Added bucket to manifest');
+                }
+                binding += `\n  observer "${observerName}" {
+    source {
+      bucket = "${bucketName}"
+      max_retries = 5
+      batch_size = 1
+      rule {
+        actions = ["PutObject", "DeleteObject"]
+      }
+    }
+  }\n`;
+                content = content.slice(0, insertPos) + binding + content.slice(insertPos);
+                await fs.writeFile(manifestPath, content);
+            }
+            else {
+                throw new Error('Could not find application block in raindrop.manifest');
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new Error('raindrop.manifest not found. Are you in a Raindrop project directory?');
+            }
+            throw error;
+        }
+    }
+}

package/dist/commands/build/features.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../base-command.js';
+export default class Features extends BaseCommand<typeof Features> {
+    static args: {};
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'available-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthService: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        raindropCatalogService: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthToken: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowOrganizationId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowUserId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sendVersionMetadata: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=features.d.ts.map

package/dist/commands/build/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../../src/commands/build/features.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW,CAAC,OAAO,QAAQ,CAAC;IAChE,MAAM,CAAC,IAAI,KAAM;IAEjB,MAAM,CAAC,WAAW,SAAgE;IAElF,MAAM,CAAC,QAAQ,WAUb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;MAYV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA2E3B"}

package/dist/commands/build/features.js

@@ -0,0 +1,97 @@
+import { Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { BaseCommand } from '../../base-command.js';
+import { getFeaturesByCategory, getFeatures } from '../../feature-catalog.js';
+export default class Features extends BaseCommand {
+    static args = {};
+    static description = 'List available features and integrations for Raindrop apps';
+    static examples = [
+        `<%= config.bin %> <%= command.id %>
+List all available features grouped by category
+
+<%= config.bin %> <%= command.id %> --available-only
+Show only features that are currently ready to use
+
+<%= config.bin %> <%= command.id %> --output json
+Get machine-readable JSON output
+`,
+    ];
+    static flags = {
+        ...BaseCommand.HIDDEN_FLAGS,
+        'available-only': Flags.boolean({
+            description: 'show only features that are currently available',
+            default: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'output format',
+            default: 'text',
+            options: ['text', 'json'],
+        }),
+    };
+    async run() {
+        const onlyAvailable = this.flags['available-only'];
+        if (this.flags.output === 'json') {
+            const features = getFeatures(onlyAvailable);
+            console.log(JSON.stringify(features, null, 2));
+            return;
+        }
+        // Text output
+        this.log('');
+        this.log(chalk.bold.underline('Available Features for Raindrop Apps'));
+        this.log('');
+        const grouped = getFeaturesByCategory();
+        // Data & Storage
+        this.log(chalk.bold.cyan('📦 Data & Storage'));
+        this.log('');
+        for (const feature of grouped.data) {
+            if (onlyAvailable && !feature.available)
+                continue;
+            const command = feature.command
+                ? chalk.dim(`\n      $ ${feature.command}`)
+                : chalk.yellow(' (planned)');
+            this.log(`  ${chalk.bold(feature.name.padEnd(20))} ${feature.description}${command}`);
+            this.log('');
+        }
+        // Architecture
+        this.log(chalk.bold.magenta('🏗  Architecture Patterns'));
+        this.log('');
+        for (const feature of grouped.architecture) {
+            if (onlyAvailable && !feature.available)
+                continue;
+            const command = feature.command
+                ? chalk.dim(`\n      $ ${feature.command}`)
+                : chalk.yellow(' (planned)');
+            this.log(`  ${chalk.bold(feature.name.padEnd(20))} ${feature.description}${command}`);
+            this.log('');
+        }
+        // Integrations
+        this.log(chalk.bold.blue('🔌 Integrations'));
+        this.log('');
+        for (const feature of grouped.integration) {
+            if (onlyAvailable && !feature.available)
+                continue;
+            const command = feature.command
+                ? chalk.dim(`\n      $ ${feature.command}`)
+                : chalk.yellow(' (planned)');
+            this.log(`  ${chalk.bold(feature.name.padEnd(20))} ${feature.description}${command}`);
+            this.log('');
+        }
+        this.log(chalk.dim('─'.repeat(60)));
+        const availableCount = getFeatures(true).length;
+        const totalCount = getFeatures(false).length;
+        this.log(chalk.dim(`${availableCount} available, ${totalCount - availableCount} planned`));
+        this.log('');
+        this.log(chalk.bold('How to add features:'));
+        this.log(chalk.dim('   Use the setup command for any feature above, for example:'));
+        this.log(chalk.dim('   $ raindrop build smartmemory setup'));
+        this.log(chalk.dim('   $ raindrop build smartsql setup'));
+        this.log(chalk.dim('   $ raindrop build smartbucket setup'));
+        this.log('');
+        this.log(chalk.bold('Common combinations:'));
+        this.log(chalk.dim('   Chatbot:   smartmemory + smartsql + ai'));
+        this.log(chalk.dim('   File API:   smartbucket + queue'));
+        this.log(chalk.dim('   Auth App:  workos + smartmemory'));
+        this.log('');
+    }
+}

package/dist/commands/build/generate.d.ts

@@ -10,5 +10,7 @@ export default class Generate extends BaseCommand<typeof Generate> {
         output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
+    private suggestFeatures;
+    private hasExampleFile;
 }
 //# sourceMappingURL=generate.d.ts.map

package/dist/commands/build/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/commands/build/generate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAUpD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW,CAAC,OAAO,QAAQ,CAAC;IAChE,OAAgB,IAAI,KAAM;IAE1B,OAAgB,WAAW,SAAwD;IAEnF,OAAgB,QAAQ,WAA2C;IAEnE,OAAgB,KAAK;;;;;MAgBnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgClC"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/commands/build/generate.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAUpD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW,CAAC,OAAO,QAAQ,CAAC;IAChE,OAAgB,IAAI,KAAM;IAE1B,OAAgB,WAAW,SAAwD;IAEnF,OAAgB,QAAQ,WAA2C;IAEnE,OAAgB,KAAK;;;;;MAgBnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YAoCnB,eAAe;YA6Cf,cAAc;CAQ7B"}

package/dist/commands/build/generate.js

@@ -1,5 +1,6 @@
 import { valueOf } from '@liquidmetal-ai/drizzle/appify/build';
 import { Flags } from '@oclif/core';
+import chalk from 'chalk';
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { BaseCommand } from '../../base-command.js';
@@ -49,5 +50,56 @@ export default class Generate extends BaseCommand {
             await fs.mkdir(path.dirname(dest), { recursive: true });
             await fs.writeFile(dest, gatherEnvForHandler(handler, app));
         }
+        // Check for smart components in manifest and suggest features
+        await this.suggestFeatures();
+    }
+    async suggestFeatures() {
+        // Read manifest file to check for features (simpler than using app API)
+        const manifestPath = path.join(this.flags.root, this.flags.manifest);
+        let manifestContent = '';
+        try {
+            manifestContent = await fs.readFile(manifestPath, 'utf-8');
+        }
+        catch {
+            return; // Silently skip if can't read manifest
+        }
+        const hasSmartMemory = /^\s*smartmemory\s+"/m.test(manifestContent);
+        const hasSmartSQL = /^\s*smartsql\s+"/m.test(manifestContent);
+        const hasSmartBucket = /^\s*smartbucket\s+"/m.test(manifestContent);
+        const hasQueue = /^\s*queue\s+"/m.test(manifestContent);
+        const suggestions = [];
+        if (hasSmartMemory && !await this.hasExampleFile('smartmemory-minimal.ts')) {
+            suggestions.push('raindrop build smartmemory setup');
+        }
+        if (hasSmartSQL && !await this.hasExampleFile('smartsql-minimal.ts')) {
+            suggestions.push('raindrop build smartsql setup');
+        }
+        if (hasSmartBucket && !await this.hasExampleFile('smartbucket-minimal.ts')) {
+            suggestions.push('raindrop build smartbucket setup');
+        }
+        if (hasQueue && !await this.hasExampleFile('queue-minimal.ts')) {
+            suggestions.push('raindrop build queue setup');
+        }
+        if (suggestions.length > 0) {
+            console.log('');
+            console.log(chalk.bold('Tip:') + ' Get working examples with setup commands:');
+            suggestions.forEach(cmd => console.log(chalk.dim(`   ${cmd}`)));
+            console.log('');
+        }
+        // Show features command if no suggestions
+        if (suggestions.length === 0 && (hasSmartMemory || hasSmartSQL || hasSmartBucket || hasQueue)) {
+            console.log('');
+            console.log(chalk.dim('Tip: Explore available features with: raindrop build features'));
+            console.log('');
+        }
+    }
+    async hasExampleFile(filename) {
+        try {
+            await fs.access(path.join(this.flags.root, 'src', 'examples', filename));
+            return true;
+        }
+        catch {
+            return false;
+        }
     }
 }

package/dist/commands/build/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/build/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW,CAAC,OAAO,IAAI,CAAC;IACxD,MAAM,CAAC,IAAI;;;;MAET;IAEF,MAAM,CAAC,WAAW,SAAwC;IAE1D,MAAM,CAAC,QAAQ,WAIb;IAEF,MAAM,CAAC,KAAK;;MAEV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA6C3B"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/build/init.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIpD,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,WAAW,CAAC,OAAO,IAAI,CAAC;IACxD,MAAM,CAAC,IAAI;;;;MAET;IAEF,MAAM,CAAC,WAAW,SAAwC;IAE1D,MAAM,CAAC,QAAQ,WAIb;IAEF,MAAM,CAAC,KAAK;;MAEV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAsD3B"}

package/dist/commands/build/init.js

@@ -1,5 +1,6 @@
 import { mustManifestFromString } from '@liquidmetal-ai/drizzle/appify/index';
 import { Args, Flags } from '@oclif/core';
+import chalk from 'chalk';
 import fs from 'node:fs/promises';
 import * as path from 'node:path';
 import { BaseCommand } from '../../base-command.js';
@@ -55,5 +56,14 @@ Initialize a project in the current directory.
             this.error(`Could not initialize project at ${this.args.path}: ${error}`, { exit: 1 });
         }
         console.log(`Initialized LiquidMetal.AI in ${this.args.path}`);
+        console.log('');
+        console.log(chalk.bold('Next steps:'));
+        console.log('  1. cd', this.args.path);
+        console.log('  2. npm install');
+        console.log('  3. raindrop build generate');
+        console.log('  4. raindrop build features');
+        console.log('  5. raindrop build deploy --start');
+        console.log('');
+        console.log(chalk.dim('Tip: Discover available features with "raindrop build features"'));
     }
 }