aios-core/.aios-core/development/templates/squad/script-template.js

Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework

#!/usr/bin/env node

/**
 * {{COMPONENTNAME}} Script
 *
 * {{DESCRIPTION}}
 *
 * Squad: {{SQUADNAME}}
 * Created: {{CREATEDAT}}
 *
 * Usage:
 *   node {{COMPONENTNAME}}.js [options]
 *
 * Options:
 *   --help, -h     Show this help message
 *   --verbose, -v  Enable verbose output
 *   --dry-run      Preview changes without applying
 *
 * @module {{COMPONENTNAME}}
 * @version 1.0.0
 * @see {{STORYID}}
 */

'use strict';

const fs = require('fs').promises;
const path = require('path');

/**
 * Script configuration
 */
const CONFIG = {
  name: '{{COMPONENTNAME}}',
  version: '1.0.0',
};

/**
 * Parse command line arguments
 *
 * @param {string[]} args - Command line arguments
 * @returns {Object} Parsed options
 */
function parseArgs(args) {
  const options = {
    help: false,
    verbose: false,
    dryRun: false,
    args: [],
  };

  for (let i = 0; i < args.length; i++) {
    const arg = args[i];

    if (arg === '--help' || arg === '-h') {
      options.help = true;
    } else if (arg === '--verbose' || arg === '-v') {
      options.verbose = true;
    } else if (arg === '--dry-run') {
      options.dryRun = true;
    } else if (!arg.startsWith('-')) {
      options.args.push(arg);
    }
  }

  return options;
}

/**
 * Show help message
 */
function showHelp() {
  console.log(`
${CONFIG.name} v${CONFIG.version}

{{DESCRIPTION}}

Usage:
  node ${CONFIG.name}.js [options] [arguments]

Options:
  --help, -h     Show this help message
  --verbose, -v  Enable verbose output
  --dry-run      Preview changes without applying

Examples:
  node ${CONFIG.name}.js
  node ${CONFIG.name}.js --verbose
  node ${CONFIG.name}.js --dry-run
`);
}

/**
 * Log message if verbose mode is enabled
 *
 * @param {string} message - Message to log
 * @param {boolean} verbose - Verbose mode flag
 */
function log(message, verbose) {
  if (verbose) {
    console.log(`[${CONFIG.name}] ${message}`);
  }
}

/**
 * Main script execution
 *
 * @param {Object} options - Script options
 * @returns {Promise<Object>} Execution result
 */
async function execute(options) {
  log('Starting execution...', options.verbose);

  // Implementation here
  const result = {
    success: true,
    message: 'Script completed successfully',
    data: {},
  };

  // Step 1: Initialize
  log('Step 1: Initializing...', options.verbose);

  // Step 2: Process
  log('Step 2: Processing...', options.verbose);

  if (options.dryRun) {
    log('Dry run mode - no changes applied', options.verbose);
  }

  // Step 3: Complete
  log('Step 3: Completing...', options.verbose);

  return result;
}

/**
 * Main entry point
 *
 * @param {string[]} args - Command line arguments
 */
async function main(args) {
  const options = parseArgs(args);

  if (options.help) {
    showHelp();
    return;
  }

  console.log(`${CONFIG.name} v${CONFIG.version}`);
  console.log('');

  try {
    const result = await execute(options);

    if (result.success) {
      console.log('Success:', result.message);
    } else {
      console.error('Failed:', result.message);
      process.exit(1);
    }
  } catch (error) {
    console.error('Error:', error.message);
    if (options.verbose) {
      console.error(error.stack);
    }
    process.exit(1);
  }
}

// Run if called directly
if (require.main === module) {
  main(process.argv.slice(2));
}

module.exports = {
  main,
  execute,
  parseArgs,
};