@objectstack/cli 4.0.3 → 4.0.5

package/src/commands/lint.ts

@@ -1,315 +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 { normalizeStackInput } from '@objectstack/spec';
-import { loadConfig } from '../utils/config.js';
-import {
-  printHeader,
-  printSuccess,
-  printWarning,
-  printError,
-  printInfo,
-  printStep,
-  createTimer,
-} from '../utils/format.js';
-
-// ─── Types ──────────────────────────────────────────────────────────
-
-type Severity = 'error' | 'warning' | 'suggestion';
-
-interface LintIssue {
-  severity: Severity;
-  rule: string;
-  message: string;
-  path: string;
-  fix?: string;
-}
-
-// ─── Rules ──────────────────────────────────────────────────────────
-
-const SNAKE_CASE_RE = /^[a-z][a-z0-9_]*$/;
-
-function checkSnakeCase(value: string, path: string, label: string): LintIssue | null {
-  if (!SNAKE_CASE_RE.test(value)) {
-    return {
-      severity: 'error',
-      rule: 'naming/snake-case',
-      message: `${label} "${value}" must be snake_case`,
-      path,
-      fix: value.replace(/([A-Z]+)([A-Z][a-z])/g, '$1_$2').replace(/([a-z\d])([A-Z])/g, '$1_$2').toLowerCase().replace(/^_/, '').replace(/-/g, '_'),
-    };
-  }
-  return null;
-}
-
-function checkLabelExists(item: any, path: string, kind: string): LintIssue | null {
-  if (!item.label) {
-    return {
-      severity: 'error',
-      rule: 'required/label',
-      message: `${kind} "${item.name || '?'}" is missing a label`,
-      path,
-    };
-  }
-  return null;
-}
-
-function checkLabelCase(label: string, path: string): LintIssue | null {
-  if (label && label[0] !== label[0].toUpperCase()) {
-    return {
-      severity: 'warning',
-      rule: 'convention/label-case',
-      message: `Label "${label}" should start with an uppercase letter`,
-      path,
-      fix: label.charAt(0).toUpperCase() + label.slice(1),
-    };
-  }
-  return null;
-}
-
-// ─── Lint Engine ────────────────────────────────────────────────────
-
-function lintConfig(config: any): LintIssue[] {
-  const issues: LintIssue[] = [];
-
-  const push = (issue: LintIssue | null) => {
-    if (issue) issues.push(issue);
-  };
-
-  // ── Objects ──
-  const objects: any[] = Array.isArray(config.objects) ? config.objects : [];
-
-  for (let i = 0; i < objects.length; i++) {
-    const obj = objects[i];
-    const objPath = `objects[${i}]`;
-
-    // Object name must be snake_case
-    if (obj.name) {
-      push(checkSnakeCase(obj.name, `${objPath}.name`, 'Object name'));
-    }
-
-    // Object must have label
-    push(checkLabelExists(obj, `${objPath}.label`, 'Object'));
-
-    // Object label conventions
-    if (obj.label) {
-      push(checkLabelCase(obj.label, `${objPath}.label`));
-    }
-
-    // Fields
-    if (obj.fields && typeof obj.fields === 'object') {
-      const fieldNames = Object.keys(obj.fields);
-
-      if (fieldNames.length === 0) {
-        issues.push({
-          severity: 'warning',
-          rule: 'structure/empty-fields',
-          message: `Object "${obj.name || '?'}" has an empty fields map`,
-          path: `${objPath}.fields`,
-        });
-      }
-
-      for (const fieldName of fieldNames) {
-        const field = obj.fields[fieldName];
-        const fieldPath = `${objPath}.fields.${fieldName}`;
-
-        // Field key must be snake_case
-        push(checkSnakeCase(fieldName, fieldPath, 'Field name'));
-
-        // Field must have label
-        if (field && typeof field === 'object') {
-          push(checkLabelExists({ ...field, name: fieldName }, `${fieldPath}.label`, 'Field'));
-          if (field.label) {
-            push(checkLabelCase(field.label, `${fieldPath}.label`));
-          }
-        }
-      }
-    } else if (!obj.fields) {
-      issues.push({
-        severity: 'error',
-        rule: 'structure/no-fields',
-        message: `Object "${obj.name || '?'}" has no fields defined`,
-        path: `${objPath}.fields`,
-      });
-    }
-  }
-
-  // ── Views ──
-  const views: any[] = Array.isArray(config.views) ? config.views : [];
-  for (let i = 0; i < views.length; i++) {
-    const view = views[i];
-    const viewPath = `views[${i}]`;
-    if (view.name) {
-      push(checkSnakeCase(view.name, `${viewPath}.name`, 'View name'));
-    }
-    push(checkLabelExists(view, `${viewPath}.label`, 'View'));
-    if (view.label) {
-      push(checkLabelCase(view.label, `${viewPath}.label`));
-    }
-  }
-
-  // ── Apps ──
-  const apps: any[] = Array.isArray(config.apps) ? config.apps : [];
-  for (let i = 0; i < apps.length; i++) {
-    const app = apps[i];
-    const appPath = `apps[${i}]`;
-    if (app.name) {
-      push(checkSnakeCase(app.name, `${appPath}.name`, 'App name'));
-    }
-    push(checkLabelExists(app, `${appPath}.label`, 'App'));
-    if (app.label) {
-      push(checkLabelCase(app.label, `${appPath}.label`));
-    }
-  }
-
-  // ── Flows ──
-  const flows: any[] = Array.isArray(config.flows) ? config.flows : [];
-  for (let i = 0; i < flows.length; i++) {
-    const flow = flows[i];
-    const flowPath = `flows[${i}]`;
-    if (flow.name) {
-      push(checkSnakeCase(flow.name, `${flowPath}.name`, 'Flow name'));
-    }
-  }
-
-  // ── Agents ──
-  const agents: any[] = Array.isArray(config.agents) ? config.agents : [];
-  for (let i = 0; i < agents.length; i++) {
-    const agent = agents[i];
-    const agentPath = `agents[${i}]`;
-    if (agent.name) {
-      push(checkSnakeCase(agent.name, `${agentPath}.name`, 'Agent name'));
-    }
-  }
-
-  return issues;
-}
-
-// ─── Command ────────────────────────────────────────────────────────
-
-export default class Lint extends Command {
-  static override description = 'Check ObjectStack configuration for style and convention issues';
-
-  static override args = {
-    config: Args.string({ description: 'Configuration file path', required: false }),
-  };
-
-  static override flags = {
-    json: Flags.boolean({ description: 'Output as JSON' }),
-    fix: Flags.boolean({ description: 'Show what would be fixed (dry-run)' }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(Lint);
-    const configPath = args.config;
-    const timer = createTimer();
-
-    if (!flags.json) {
-      printHeader('Lint');
-      printStep('Loading configuration...');
-    }
-
-    try {
-      const { config, absolutePath } = await loadConfig(configPath);
-
-      if (!flags.json) {
-        printInfo(`Config: ${chalk.white(absolutePath)}`);
-      }
-
-      const normalized = normalizeStackInput(config as Record<string, unknown>);
-      const issues = lintConfig(normalized);
-
-      // ── JSON output ──
-      if (flags.json) {
-        const errors = issues.filter((i) => i.severity === 'error');
-        const warnings = issues.filter((i) => i.severity === 'warning');
-        const suggestions = issues.filter((i) => i.severity === 'suggestion');
-        console.log(JSON.stringify({
-          passed: errors.length === 0,
-          total: issues.length,
-          errors: errors.length,
-          warnings: warnings.length,
-          suggestions: suggestions.length,
-          issues,
-          duration: timer.elapsed(),
-        }, null, 2));
-        if (errors.length > 0) process.exit(1);
-        return;
-      }
-
-      console.log('');
-
-      if (issues.length === 0) {
-        printSuccess(`All checks passed ${chalk.dim(`(${timer.display()})`)}`);
-        console.log('');
-        return;
-      }
-
-      // Group by severity
-      const errors = issues.filter((i) => i.severity === 'error');
-      const warnings = issues.filter((i) => i.severity === 'warning');
-      const suggestions = issues.filter((i) => i.severity === 'suggestion');
-
-      const printIssue = (issue: LintIssue) => {
-        const color =
-          issue.severity === 'error' ? chalk.red :
-          issue.severity === 'warning' ? chalk.yellow :
-          chalk.blue;
-        const icon =
-          issue.severity === 'error' ? '✗' :
-          issue.severity === 'warning' ? '⚠' :
-          'ℹ';
-
-        console.log(`  ${color(icon)} ${color(issue.message)}`);
-        console.log(chalk.dim(`    ${issue.rule}  at ${issue.path}`));
-        if (flags.fix && issue.fix) {
-          console.log(chalk.green(`    → fix: ${issue.fix}`));
-        }
-      };
-
-      if (errors.length > 0) {
-        console.log(chalk.bold.red(`  Errors (${errors.length})`));
-        errors.forEach(printIssue);
-        console.log('');
-      }
-
-      if (warnings.length > 0) {
-        console.log(chalk.bold.yellow(`  Warnings (${warnings.length})`));
-        warnings.forEach(printIssue);
-        console.log('');
-      }
-
-      if (suggestions.length > 0) {
-        console.log(chalk.bold.blue(`  Suggestions (${suggestions.length})`));
-        suggestions.forEach(printIssue);
-        console.log('');
-      }
-
-      // Summary
-      const parts: string[] = [];
-      if (errors.length > 0) parts.push(chalk.red(`${errors.length} error(s)`));
-      if (warnings.length > 0) parts.push(chalk.yellow(`${warnings.length} warning(s)`));
-      if (suggestions.length > 0) parts.push(chalk.blue(`${suggestions.length} suggestion(s)`));
-      console.log(`  ${parts.join(', ')} ${chalk.dim(`(${timer.display()})`)}`);
-
-      if (flags.fix) {
-        console.log('');
-        printInfo('Dry-run mode: no files were modified.');
-      }
-
-      console.log('');
-
-      if (errors.length > 0) process.exit(1);
-
-    } catch (error: any) {
-      if (flags.json) {
-        console.log(JSON.stringify({ error: error.message }));
-        process.exit(1);
-      }
-      console.log('');
-      printError(error.message || String(error));
-      process.exit(1);
-    }
-  }
-}

package/src/commands/meta/delete.ts

@@ -1,79 +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 MetaDelete extends Command {
-  static override description = 'Delete a metadata item';
-
-  static override examples = [
-    '$ os meta delete object my_custom_object',
-    '$ os meta delete plugin my-plugin',
-    '$ os meta delete object my_custom_object --format json',
-  ];
-
-  static override args = {
-    type: Args.string({
-      description: 'Metadata type',
-      required: true,
-    }),
-    name: Args.string({
-      description: 'Item name (snake_case)',
-      required: true,
-    }),
-  };
-
-  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',
-    }),
-    format: Flags.string({
-      char: 'f',
-      description: 'Output format',
-      options: ['json', 'table', 'yaml'],
-      default: 'table',
-    }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(MetaDelete);
-
-    try {
-      const { client, token } = await createApiClient({
-        url: flags.url,
-        token: flags.token,
-      });
-
-      requireAuth(token);
-
-      const result = await client.meta.deleteItem(args.type, args.name);
-
-      if (flags.format === 'json') {
-        formatOutput({ success: true, type: args.type, name: args.name, deleted: result.deleted }, 'json');
-      } else if (flags.format === 'yaml') {
-        formatOutput({ success: true, type: args.type, name: args.name, deleted: result.deleted }, 'yaml');
-      } else {
-        printSuccess(`Metadata deleted: ${args.type}/${args.name}`);
-      }
-    } 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);
-    }
-  }
-}

package/src/commands/meta/get.ts

@@ -1,73 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { Args, Command, Flags } from '@oclif/core';
-import { printError } from '../../utils/format.js';
-import { createApiClient, requireAuth } from '../../utils/api-client.js';
-import { formatOutput } from '../../utils/output-formatter.js';
-
-export default class MetaGet extends Command {
-  static override description = 'Get a metadata item';
-
-  static override examples = [
-    '$ os meta get object project_task',
-    '$ os meta get plugin my-plugin --format json',
-  ];
-
-  static override args = {
-    type: Args.string({
-      description: 'Metadata type',
-      required: true,
-    }),
-    name: Args.string({
-      description: 'Item name (snake_case)',
-      required: true,
-    }),
-  };
-
-  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',
-    }),
-    format: Flags.string({
-      char: 'f',
-      description: 'Output format',
-      options: ['json', 'table', 'yaml'],
-      default: 'json',
-    }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(MetaGet);
-
-    try {
-      const { client, token } = await createApiClient({
-        url: flags.url,
-        token: flags.token,
-      });
-
-      requireAuth(token);
-
-      // Get the metadata item
-      const item = await client.meta.getItem(args.type, args.name);
-
-      formatOutput(item, flags.format as any);
-    } 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);
-    }
-  }
-}

package/src/commands/meta/list.ts

@@ -1,105 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { Args, Command, Flags } from '@oclif/core';
-import { printError } from '../../utils/format.js';
-import { createApiClient, requireAuth } from '../../utils/api-client.js';
-import { formatOutput } from '../../utils/output-formatter.js';
-
-export default class MetaList extends Command {
-  static override description = 'List metadata types or items';
-
-  static override examples = [
-    '$ os meta list',
-    '$ os meta list object',
-    '$ os meta list plugin --format json',
-  ];
-
-  static override args = {
-    type: Args.string({
-      description: 'Metadata type (object, plugin, view, etc.)',
-    }),
-  };
-
-  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',
-    }),
-    format: Flags.string({
-      char: 'f',
-      description: 'Output format',
-      options: ['json', 'table', 'yaml'],
-      default: 'table',
-    }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(MetaList);
-
-    try {
-      const { client, token } = await createApiClient({
-        url: flags.url,
-        token: flags.token,
-      });
-
-      requireAuth(token);
-
-      if (!args.type) {
-        // List all metadata types
-        const types = await client.meta.getTypes();
-
-        if (flags.format === 'json') {
-          formatOutput(types, 'json');
-        } else if (flags.format === 'yaml') {
-          formatOutput(types, 'yaml');
-        } else {
-          console.log('\nAvailable metadata types:\n');
-          if (Array.isArray(types)) {
-            types.forEach(type => console.log(`  • ${type}`));
-          } else {
-            console.log('No types available');
-          }
-          console.log('');
-        }
-      } else {
-        // List items of a specific type
-        const items = await client.meta.getItems(args.type);
-
-        if (flags.format === 'json') {
-          formatOutput(items, 'json');
-        } else if (flags.format === 'yaml') {
-          formatOutput(items, 'yaml');
-        } else {
-          console.log(`\n${args.type} items:\n`);
-          if (Array.isArray(items)) {
-            if (items.length === 0) {
-              console.log('  (no items)');
-            } else {
-              items.forEach(item => {
-                const name = item.name || item.id || JSON.stringify(item);
-                console.log(`  • ${name}`);
-              });
-            }
-          }
-          console.log('');
-        }
-      }
-    } 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);
-    }
-  }
-}

package/src/commands/meta/register.ts

@@ -1,97 +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 MetaRegister extends Command {
-  static override description = 'Register metadata (create or update)';
-
-  static override examples = [
-    '$ os meta register object --data object-def.json',
-    '$ os meta register plugin --data plugin-manifest.json',
-  ];
-
-  static override args = {
-    type: Args.string({
-      description: 'Metadata type',
-      required: true,
-    }),
-  };
-
-  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 metadata definition',
-      required: true,
-    }),
-    format: Flags.string({
-      char: 'f',
-      description: 'Output format',
-      options: ['json', 'table', 'yaml'],
-      default: 'table',
-    }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(MetaRegister);
-
-    try {
-      const { client, token } = await createApiClient({
-        url: flags.url,
-        token: flags.token,
-      });
-
-      requireAuth(token);
-
-      // Read metadata from file
-      const { readFile } = await import('node:fs/promises');
-      const fileContent = await readFile(flags.data, 'utf-8');
-      let metadata: any;
-
-      try {
-        metadata = JSON.parse(fileContent);
-      } catch (e) {
-        throw new Error(`Invalid JSON in file: ${(e as Error).message}`);
-      }
-
-      // Extract name from metadata
-      const name = metadata.name;
-      if (!name) {
-        throw new Error('Metadata definition must include a "name" field');
-      }
-
-      // Register the metadata
-      const result = await client.meta.saveItem(args.type, name, metadata);
-
-      if (flags.format === 'json') {
-        formatOutput(result, 'json');
-      } else if (flags.format === 'yaml') {
-        formatOutput(result, 'yaml');
-      } else {
-        printSuccess(`Metadata registered: ${args.type}/${name}`);
-      }
-    } 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);
-    }
-  }
-}