@objectstack/cli 4.0.4 → 4.1.0

package/src/commands/codemod/v2-to-v3.ts

@@ -1,171 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { Command, Flags } from '@oclif/core';
-import chalk from 'chalk';
-import fs from 'fs';
-import path from 'path';
-import { printHeader, printSuccess, printError, printInfo, printStep, createTimer } from '../../utils/format.js';
-
-// ─── Transform Definitions ──────────────────────────────────────────
-
-interface Transform {
-  pattern: RegExp;
-  replacement: string;
-  description: string;
-}
-
-const V2_TO_V3_TRANSFORMS: Transform[] = [
-  {
-    pattern: /\bEnhancedObjectKernel\b/g,
-    replacement: 'ObjectKernel',
-    description: 'EnhancedObjectKernel → ObjectKernel',
-  },
-  {
-    pattern: /\bmax_length\b/g,
-    replacement: 'maxLength',
-    description: 'max_length → maxLength',
-  },
-  {
-    pattern: /\breference_filters\b/g,
-    replacement: 'referenceFilters',
-    description: 'reference_filters → referenceFilters',
-  },
-  {
-    pattern: /\bdefault_value\b/g,
-    replacement: 'defaultValue',
-    description: 'default_value → defaultValue',
-  },
-  {
-    pattern: /\bmin_length\b/g,
-    replacement: 'minLength',
-    description: 'min_length → minLength',
-  },
-  {
-    pattern: /\bunique_name\b/g,
-    replacement: 'uniqueName',
-    description: 'unique_name → uniqueName',
-  },
-  {
-    pattern: /from\s+['"]@objectstack\/core\/enhanced['"]/g,
-    replacement: "from '@objectstack/core'",
-    description: 'Update import from @objectstack/core/enhanced',
-  },
-  {
-    pattern: /from\s+['"]@objectstack\/spec\/dist\/[^'"]+['"]/g,
-    replacement: "from '@objectstack/spec'",
-    description: 'Update deep import from @objectstack/spec/dist/',
-  },
-];
-
-// ─── Helpers ────────────────────────────────────────────────────────
-
-function walkDir(dir: string, ext: string): string[] {
-  const results: string[] = [];
-  if (!fs.existsSync(dir)) return results;
-
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  for (const entry of entries) {
-    if (entry.name === 'node_modules') continue;
-    const fullPath = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      results.push(...walkDir(fullPath, ext));
-    } else if (entry.name.endsWith(ext)) {
-      results.push(fullPath);
-    }
-  }
-  return results;
-}
-
-// ─── Command ────────────────────────────────────────────────────────
-
-export default class V2ToV3 extends Command {
-  static override description = 'Migrate ObjectStack v2 config to v3 format';
-
-  static override flags = {
-    dir: Flags.string({ description: 'Directory to scan', default: 'src/' }),
-    'dry-run': Flags.boolean({ description: 'Show changes without writing files' }),
-  };
-
-  async run(): Promise<void> {
-    const { flags } = await this.parse(V2ToV3);
-
-    printHeader('Codemod: v2 → v3');
-
-    const timer = createTimer();
-    const dir = path.resolve(process.cwd(), flags.dir);
-
-    if (!fs.existsSync(dir)) {
-      printError(`Directory not found: ${dir}`);
-      process.exit(1);
-    }
-
-    console.log(`  ${chalk.dim('Directory:')} ${chalk.white(flags.dir)}`);
-    console.log(`  ${chalk.dim('Dry run:')}   ${chalk.white(flags['dry-run'] ? 'yes' : 'no')}`);
-    console.log('');
-
-    printStep('Scanning TypeScript files...');
-    const files = walkDir(dir, '.ts');
-
-    if (files.length === 0) {
-      printInfo('No .ts files found in directory');
-      return;
-    }
-
-    printInfo(`Found ${files.length} TypeScript file(s)`);
-    console.log('');
-
-    let totalTransforms = 0;
-    let filesModified = 0;
-    const transformCounts: Record<string, number> = {};
-
-    for (const file of files) {
-      const original = fs.readFileSync(file, 'utf-8');
-      let content = original;
-      let fileTransforms = 0;
-
-      for (const transform of V2_TO_V3_TRANSFORMS) {
-        const matches = content.match(transform.pattern);
-        if (matches) {
-          const count = matches.length;
-          content = content.replace(transform.pattern, transform.replacement);
-          fileTransforms += count;
-          transformCounts[transform.description] = (transformCounts[transform.description] || 0) + count;
-        }
-      }
-
-      if (fileTransforms > 0) {
-        const relPath = path.relative(process.cwd(), file);
-        filesModified++;
-        totalTransforms += fileTransforms;
-
-        if (flags['dry-run']) {
-          printInfo(`${relPath} — ${fileTransforms} change(s)`);
-        } else {
-          fs.writeFileSync(file, content);
-          printSuccess(`${relPath} — ${fileTransforms} change(s)`);
-        }
-      }
-    }
-
-    console.log('');
-
-    if (totalTransforms === 0) {
-      printSuccess('No v2 patterns found — code is already v3 compatible');
-    } else {
-      console.log(chalk.bold('  Summary:'));
-      for (const [desc, count] of Object.entries(transformCounts)) {
-        console.log(`    ${chalk.dim(desc)}: ${chalk.white(count)}`);
-      }
-      console.log('');
-
-      if (flags['dry-run']) {
-        printInfo(`Would modify ${filesModified} file(s) with ${totalTransforms} total change(s)`);
-        console.log(chalk.dim('  Run without --dry-run to apply changes'));
-      } else {
-        printSuccess(`Modified ${filesModified} file(s) with ${totalTransforms} total change(s) (${timer.display()})`);
-      }
-    }
-
-    console.log('');
-  }
-}

package/src/commands/compile.ts

@@ -1,114 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { Args, Command, Flags } from '@oclif/core';
-import path from 'path';
-import fs from 'fs';
-import chalk from 'chalk';
-import { ZodError } from 'zod';
-import { ObjectStackDefinitionSchema, normalizeStackInput } from '@objectstack/spec';
-import { loadConfig } from '../utils/config.js';
-import {
-  printHeader,
-  printKV,
-  printSuccess,
-  printError,
-  printStep,
-  createTimer,
-  formatZodErrors,
-  collectMetadataStats,
-  printMetadataStats,
-} from '../utils/format.js';
-
-export default class Compile extends Command {
-  static override description = 'Compile ObjectStack configuration to JSON artifact';
-
-  static override args = {
-    config: Args.string({ description: 'Source configuration file', required: false }),
-  };
-
-  static override flags = {
-    output: Flags.string({ char: 'o', description: 'Output JSON file', default: 'dist/objectstack.json' }),
-    json: Flags.boolean({ description: 'Output compile result as JSON (for CI)' }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(Compile);
-    const timer = createTimer();
-
-    if (!flags.json) {
-      printHeader('Compile');
-    }
-
-    try {
-      // 1. Load Configuration
-      if (!flags.json) printStep('Loading configuration...');
-      const { config, absolutePath, duration } = await loadConfig(args.config);
-
-      if (!flags.json) {
-        printKV('Config', path.relative(process.cwd(), absolutePath));
-        printKV('Load time', `${duration}ms`);
-      }
-
-      // 2. Normalize map-formatted stack definition and validate against Protocol
-      if (!flags.json) printStep('Validating protocol compliance...');
-      const normalized = normalizeStackInput(config as Record<string, unknown>);
-      const result = ObjectStackDefinitionSchema.safeParse(normalized);
-
-      if (!result.success) {
-        if (flags.json) {
-          console.log(JSON.stringify({ success: false, errors: (result.error as unknown as ZodError).issues }));
-          this.exit(1);
-        }
-        console.log('');
-        printError('Validation failed');
-        formatZodErrors(result.error as unknown as ZodError);
-        this.exit(1);
-      }
-
-      // 3. Generate Artifact
-      if (!flags.json) printStep('Writing artifact...');
-      const output = flags.output!;
-      const artifactPath = path.resolve(process.cwd(), output);
-      const artifactDir = path.dirname(artifactPath);
-
-      if (!fs.existsSync(artifactDir)) {
-        fs.mkdirSync(artifactDir, { recursive: true });
-      }
-
-      const jsonContent = JSON.stringify(result.data, null, 2);
-      fs.writeFileSync(artifactPath, jsonContent);
-
-      const sizeKB = (jsonContent.length / 1024).toFixed(1);
-      const stats = collectMetadataStats(config);
-
-      if (flags.json) {
-        console.log(JSON.stringify({
-          success: true,
-          output: artifactPath,
-          size: jsonContent.length,
-          stats,
-          duration: timer.elapsed(),
-        }));
-        return;
-      }
-
-      // 4. Summary
-      console.log('');
-      printSuccess(`Build complete ${chalk.dim(`(${timer.display()})`)}`);
-      console.log('');
-      printMetadataStats(stats);
-      console.log('');
-      printKV('Artifact', `${output} ${chalk.dim(`(${sizeKB} KB`)})`);
-      console.log('');
-
-    } catch (error: any) {
-      if (flags.json) {
-        console.log(JSON.stringify({ success: false, error: error.message }));
-        this.exit(1);
-      }
-      console.log('');
-      printError(error.message || String(error));
-      this.error(error.message || String(error));
-    }
-  }
-}

package/src/commands/create.ts

@@ -1,281 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { Args, Command, Flags } from '@oclif/core';
-import chalk from 'chalk';
-import fs from 'fs';
-import path from 'path';
-import { execSync } from 'child_process';
-
-export const templates = {
-  plugin: {
-    description: 'Create a new ObjectStack plugin',
-    files: {
-      'package.json': (name: string) => ({
-        name: `@objectstack/plugin-${name}`,
-        version: '0.1.0',
-        description: `ObjectStack Plugin: ${name}`,
-        main: 'dist/index.js',
-        types: 'dist/index.d.ts',
-        scripts: {
-          build: 'tsc',
-          dev: 'tsc --watch',
-          test: 'vitest',
-        },
-        keywords: ['objectstack', 'plugin', name],
-        author: '',
-        license: 'MIT',
-        dependencies: {
-          '@objectstack/spec': 'workspace:*',
-          zod: '^4.3.6',
-        },
-        devDependencies: {
-          '@types/node': '^22.0.0',
-          typescript: '^5.8.0',
-          vitest: '^4.0.0',
-        },
-      }),
-      'tsconfig.json': () => ({
-        extends: '../../tsconfig.json',
-        compilerOptions: {
-          outDir: 'dist',
-          rootDir: 'src',
-        },
-        include: ['src/**/*'],
-      }),
-      'src/index.ts': (name: string) => `import type { Plugin } from '@objectstack/spec';
-
-/**
- * ${name} Plugin for ObjectStack
- */
-export const ${toCamelCase(name)}Plugin: Plugin = {
-  name: '${name}',
-  version: '0.1.0',
-  
-  async initialize(context) {
-    console.log('Initializing ${name} plugin...');
-    // Plugin initialization logic
-  },
-  
-  async destroy() {
-    console.log('Destroying ${name} plugin...');
-    // Plugin cleanup logic
-  },
-};
-
-export default ${toCamelCase(name)}Plugin;
-`,
-      'README.md': (name: string) => `# @objectstack/plugin-${name}
-
-ObjectStack Plugin: ${name}
-
-## Installation
-
-\`\`\`bash
-pnpm add @objectstack/plugin-${name}
-\`\`\`
-
-## Usage
-
-\`\`\`typescript
-import { ${toCamelCase(name)}Plugin } from '@objectstack/plugin-${name}';
-
-// Use the plugin in your ObjectStack configuration
-export default {
-  plugins: [
-    ${toCamelCase(name)}Plugin,
-  ],
-};
-\`\`\`
-
-## License
-
-MIT
-`,
-    },
-  },
-  
-  example: {
-    description: 'Create a new ObjectStack example application',
-    files: {
-      'package.json': (name: string) => ({
-        name: `@example/${name}`,
-        version: '0.1.0',
-        private: true,
-        description: `ObjectStack Example: ${name}`,
-        scripts: {
-          build: 'objectstack compile',
-          dev: 'objectstack dev',
-          test: 'vitest',
-        },
-        dependencies: {
-          '@objectstack/spec': 'workspace:*',
-          '@objectstack/cli': 'workspace:*',
-          zod: '^4.3.6',
-        },
-        devDependencies: {
-          '@types/node': '^22.0.0',
-          tsx: '^4.21.0',
-          typescript: '^5.8.0',
-          vitest: '^4.0.0',
-        },
-      }),
-      'objectstack.config.ts': (name: string) => `import { defineStack } from '@objectstack/spec';
-
-// Barrel imports — add more as you create new type folders
-// import * as objects from './src/objects';
-// import * as actions from './src/actions';
-// import * as apps from './src/apps';
-
-export default defineStack({
-  manifest: {
-    name: '${name}',
-    version: '0.1.0',
-    description: '${name} example application',
-  },
-  
-  objects: [
-    // Object.values(objects),  // Uncomment after creating src/objects/index.ts
-  ],
-  
-  apps: [
-    // Object.values(apps),     // Uncomment after creating src/apps/index.ts
-  ],
-});
-`,
-      'README.md': (name: string) => `# ${name} Example
-
-ObjectStack example application: ${name}
-
-## Quick Start
-
-\`\`\`bash
-# Build the configuration
-pnpm build
-
-# Run in development mode
-pnpm dev
-\`\`\`
-
-## Structure
-
-- \`objectstack.config.ts\` - Main configuration file
-- \`dist/objectstack.json\` - Compiled artifact
-
-## Learn More
-
-- [ObjectStack Documentation](../../content/docs)
-- [Examples](../)
-`,
-      'tsconfig.json': () => ({
-        extends: '../../tsconfig.json',
-        compilerOptions: {
-          outDir: 'dist',
-          rootDir: '.',
-        },
-        include: ['*.ts', 'src/**/*'],
-      }),
-    },
-  },
-};
-
-function toCamelCase(str: string): string {
-  return str.replace(/-([a-z])/g, (g) => g[1].toUpperCase());
-}
-
-export default class Create extends Command {
-  static override description = 'Create a new package, plugin, or example from template';
-
-  static override args = {
-    type: Args.string({ description: 'Type of project to create (plugin, example)', required: true }),
-    name: Args.string({ description: 'Name of the project', required: false }),
-  };
-
-  static override flags = {
-    dir: Flags.string({ char: 'd', description: 'Target directory' }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(Create);
-
-    console.log(chalk.bold(`\n📦 ObjectStack Project Creator`));
-    console.log(chalk.dim(`-------------------------------`));
-    
-    if (!templates[args.type as keyof typeof templates]) {
-      console.error(chalk.red(`\n❌ Unknown type: ${args.type}`));
-      console.log(chalk.dim('Available types: plugin, example'));
-      process.exit(1);
-    }
-    
-    if (!args.name) {
-      console.error(chalk.red('\n❌ Project name is required'));
-      console.log(chalk.dim(`Usage: objectstack create ${args.type} <name>`));
-      process.exit(1);
-    }
-    
-    const template = templates[args.type as keyof typeof templates];
-    const cwd = process.cwd();
-    
-    // Determine target directory
-    let targetDir: string;
-    if (flags.dir) {
-      targetDir = path.resolve(cwd, flags.dir);
-    } else {
-      const baseDir = args.type === 'plugin' ? 'packages/plugins' : 'examples';
-      const projectName = args.type === 'plugin' ? `plugin-${args.name}` : args.name;
-      targetDir = path.join(cwd, baseDir, projectName);
-    }
-    
-    // Check if directory already exists
-    if (fs.existsSync(targetDir)) {
-      console.error(chalk.red(`\n❌ Directory already exists: ${targetDir}`));
-      process.exit(1);
-    }
-    
-    console.log(`📁 Creating ${args.type}: ${chalk.blue(args.name)}`);
-    console.log(`📂 Location: ${chalk.dim(targetDir)}`);
-    console.log('');
-    
-    try {
-      // Create directory
-      fs.mkdirSync(targetDir, { recursive: true });
-      
-      // Create files from template
-      for (const [filePath, contentFn] of Object.entries(template.files)) {
-        const fullPath = path.join(targetDir, filePath);
-        const dir = path.dirname(fullPath);
-        
-        if (!fs.existsSync(dir)) {
-          fs.mkdirSync(dir, { recursive: true });
-        }
-        
-        const content = contentFn(args.name);
-        const fileContent = typeof content === 'string' 
-          ? content 
-          : JSON.stringify(content, null, 2);
-        
-        fs.writeFileSync(fullPath, fileContent);
-        console.log(chalk.green(`✓ Created ${filePath}`));
-      }
-      
-      console.log('');
-      console.log(chalk.green('✅ Project created successfully!'));
-      console.log('');
-      console.log(chalk.bold('Next steps:'));
-      console.log(chalk.dim(`  cd ${path.relative(cwd, targetDir)}`));
-      console.log(chalk.dim('  pnpm install'));
-      console.log(chalk.dim('  pnpm build'));
-      console.log('');
-      
-    } catch (error: any) {
-      console.error(chalk.red('\n❌ Failed to create project:'));
-      console.error(error.message || error);
-      
-      // Clean up on error
-      if (fs.existsSync(targetDir)) {
-        fs.rmSync(targetDir, { recursive: true });
-      }
-      
-      process.exit(1);
-    }
-  }
-}

package/src/commands/data/create.ts

@@ -1,110 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { Args, Command, Flags } from '@oclif/core';
-import { printError, printSuccess } from '../../utils/format.js';
-import { createApiClient, requireAuth } from '../../utils/api-client.js';
-import { formatOutput } from '../../utils/output-formatter.js';
-
-export default class DataCreate extends Command {
-  static override description = 'Create a new record';
-
-  static override examples = [
-    '$ os data create project_task \'{"name":"New Task","status":"open"}\'',
-    '$ os data create project_task --data task-data.json',
-    '$ os data create project_task --data task-data.json --format json',
-  ];
-
-  static override args = {
-    object: Args.string({
-      description: 'Object name (snake_case)',
-      required: true,
-    }),
-    data: Args.string({
-      description: 'Record data as JSON string (or use --data flag for file)',
-    }),
-  };
-
-  static override flags = {
-    url: Flags.string({
-      char: 'u',
-      description: 'Server URL',
-      env: 'OBJECTSTACK_URL',
-    }),
-    token: Flags.string({
-      char: 't',
-      description: 'Authentication token',
-      env: 'OBJECTSTACK_TOKEN',
-    }),
-    data: Flags.string({
-      char: 'd',
-      description: 'Path to JSON file containing record data',
-    }),
-    format: Flags.string({
-      char: 'f',
-      description: 'Output format',
-      options: ['json', 'table', 'yaml'],
-      default: 'table',
-    }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(DataCreate);
-
-    try {
-      const { client, token } = await createApiClient({
-        url: flags.url,
-        token: flags.token,
-      });
-
-      requireAuth(token);
-
-      // Parse record data
-      let recordData: any;
-
-      if (flags.data) {
-        // Read from file
-        const { readFile } = await import('node:fs/promises');
-        const fileContent = await readFile(flags.data, 'utf-8');
-        try {
-          recordData = JSON.parse(fileContent);
-        } catch (e) {
-          throw new Error(`Invalid JSON in file: ${(e as Error).message}`);
-        }
-      } else if (args.data) {
-        // Parse from argument
-        try {
-          recordData = JSON.parse(args.data);
-        } catch (e) {
-          throw new Error(`Invalid JSON: ${(e as Error).message}`);
-        }
-      } else {
-        throw new Error('Record data is required (provide JSON string or use --data flag)');
-      }
-
-      // Create the record
-      const result = await client.data.create(args.object, recordData);
-
-      if (flags.format === 'json') {
-        formatOutput(result, 'json');
-      } else if (flags.format === 'yaml') {
-        formatOutput(result, 'yaml');
-      } else {
-        printSuccess(`Record created: ${result.id}`);
-        if (result.record) {
-          console.log('');
-          formatOutput(result.record, 'table');
-        }
-      }
-    } catch (error: any) {
-      if (flags.format === 'json') {
-        console.log(JSON.stringify({
-          success: false,
-          error: error.message,
-        }, null, 2));
-        this.exit(1);
-      }
-      printError(error.message || String(error));
-      this.exit(1);
-    }
-  }
-}