spiralcord-full 2.5.0 → 2.6.0

package/bin/spiral.js

@@ -131,9 +131,33 @@ async function loadConfig() {
     return null;
   }
 
-  if (!config.token || config.token === '') {
-    console.error('Error: Set your bot token in spiral.json');
-    return null;
+  if (!config.token || config.token === '' || config.token === 'YOUR_DISCORD_TOKEN_HERE' || (typeof config.token === 'string' && config.token.length < 50)) {
+    console.error('[runtime] Bot token is missing or invalid.');
+
+    const { password, isCancel, intro, outro, log } = require('@clack/prompts');
+    const { saveSpiralConfig } = require('../src/onboard/config-scanner');
+
+    intro('Token Setup');
+
+    const token = await password({
+      message: 'Enter your bot token:',
+      mask: '▪',
+      validate(value) {
+        if (!value || value.length < 50) return 'Token seems too short. Discord tokens are 70+ characters.';
+      }
+    });
+
+    if (isCancel(token)) {
+      console.error('Operation cancelled.');
+      return null;
+    }
+
+    config.token = token;
+    await saveSpiralConfig(configPath, config);
+    log.success('Token saved to spiral.json');
+
+    outro('Token configured. Restarting...');
+    return config;
   }
 
   if (!Array.isArray(config.intents)) {
@@ -767,4 +791,24 @@ program
     }
   });
 
+program
+  .command('onboard')
+  .description('Interactive bot setup wizard')
+  .action(async () => {
+    const { onboard } = require('../src/onboard');
+    const configPath = path.join(process.cwd(), 'spiral.json');
+    const pluginsDir = path.join(process.cwd(), 'plugins');
+    await onboard(configPath, pluginsDir);
+  });
+
+program
+  .command('add <field>')
+  .description('Add or edit a field in spiral.json')
+  .option('--value <value>', 'Value to set (non-interactive)')
+  .action(async (field, options) => {
+    const { addField } = require('../src/onboard');
+    const configPath = path.join(process.cwd(), 'spiral.json');
+    await addField(configPath, field, options.value);
+  });
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spiralcord-full",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "Spiralcord Full - Discord Bot Runtime with Voice, Music, AI, Database & Image Support",
   "main": "src/index.js",
   "types": "src/types/index.d.ts",
@@ -24,8 +24,8 @@
     "database",
     "canvas"
   ],
-  "author": "",
-  "license": "MIT",
+  "author": "Isam Ahmed",
+  "license": "custom",
   "dependencies": {
     "commander": "^12.1.0",
     "discord.js": "^14.16.3",
@@ -45,7 +45,8 @@
     "chalk": "^4.1.2",
     "ms": "^2.1.3",
     "uuid": "^9.0.0",
-    "chokidar": "^3.6.0"
+    "chokidar": "^3.6.0",
+    "@clack/prompts": "^1.7.0"
   },
   "engines": {
     "node": ">=16.0.0"

package/src/onboard/config-scanner.js

@@ -0,0 +1,92 @@
+const fs = require('fs').promises;
+const path = require('path');
+
+const SPIRAL_FIELDS = [
+  { key: 'name', type: 'string', description: 'Bot display name', default: 'My Spiral Bot' },
+  { key: 'token', type: 'password', description: 'Discord bot token', default: '' },
+  { key: 'prefix', type: 'string', description: 'Command prefix', default: '!' },
+  { key: 'clientId', type: 'string', description: 'Discord application client ID', default: '' },
+  { key: 'intents', type: 'multiselect', description: 'Gateway intents', default: ['Guilds', 'GuildMessages', 'MessageContent'] },
+  { key: 'perGuildSlash', type: 'confirm', description: 'Register slash commands per-guild (instant vs ~1h)', default: false },
+  { key: 'disabledCommands', type: 'text', description: 'Commands to disable (comma-separated)', default: [] }
+];
+
+const ALL_INTENTS = [
+  'Guilds', 'GuildMembers', 'GuildModeration', 'GuildEmojisAndStickers',
+  'GuildIntegrations', 'GuildWebhooks', 'GuildInvites', 'GuildVoiceStates',
+  'GuildPresences', 'GuildMessages', 'GuildMessageReactions', 'GuildMessageTyping',
+  'DirectMessages', 'DirectMessageReactions', 'DirectMessageTyping', 'MessageContent',
+  'GuildScheduledEvents', 'AutoModerationConfiguration', 'AutoModerationExecution',
+  'GuildMessagePolls', 'UserThreads'
+];
+
+async function loadSpiralConfig(configPath) {
+  try {
+    const data = await fs.readFile(configPath, 'utf-8');
+    return JSON.parse(data);
+  } catch {
+    return null;
+  }
+}
+
+async function saveSpiralConfig(configPath, config) {
+  await fs.writeFile(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+
+async function scanPluginConfigs(pluginsDir) {
+  const fields = [];
+
+  let plugins;
+  try {
+    plugins = await fs.readdir(pluginsDir);
+  } catch {
+    return fields;
+  }
+
+  for (const plugin of plugins) {
+    const schemaPath = path.join(pluginsDir, plugin, 'config.schema.json');
+    try {
+      const data = await fs.readFile(schemaPath, 'utf-8');
+      const schema = JSON.parse(data);
+      if (!schema.properties) continue;
+
+      const pluginFields = [];
+      for (const [key, prop] of Object.entries(schema.properties)) {
+        pluginFields.push({
+          plugin,
+          key,
+          type: prop.type === 'boolean' ? 'confirm' :
+                prop.type === 'number' ? 'number' :
+                prop.enum ? 'select' :
+                'text',
+          description: prop.description || key,
+          default: prop.default,
+          enum: prop.enum
+        });
+      }
+
+      if (pluginFields.length > 0) {
+        fields.push({ plugin, fields: pluginFields });
+      }
+    } catch {}
+  }
+
+  return fields;
+}
+
+function hasTokenIssue(config) {
+  if (!config) return true;
+  if (!config.token || config.token === '') return true;
+  if (config.token === 'YOUR_DISCORD_TOKEN_HERE') return true;
+  if (typeof config.token === 'string' && config.token.length < 50) return true;
+  return false;
+}
+
+module.exports = {
+  SPIRAL_FIELDS,
+  ALL_INTENTS,
+  loadSpiralConfig,
+  saveSpiralConfig,
+  scanPluginConfigs,
+  hasTokenIssue
+};

package/src/onboard/index.js

@@ -0,0 +1,370 @@
+const path = require('path');
+const {
+  intro, outro, checkCancel,
+  text, password, confirm, select, selectKey,
+  multiselect, spinner, log, note
+} = require('./prompts');
+const {
+  SPIRAL_FIELDS, ALL_INTENTS,
+  loadSpiralConfig, saveSpiralConfig,
+  scanPluginConfigs, hasTokenIssue
+} = require('./config-scanner');
+
+async function onboard(configPath, pluginsDir) {
+  const existing = await loadSpiralConfig(configPath);
+
+  if (!existing) {
+    await fullWizard(configPath, pluginsDir, null);
+    return;
+  }
+
+  intro('Spiralcord Onboard');
+
+  const action = await selectKey({
+    message: 'What would you like to do?',
+    options: [
+      { value: '1', label: 'Set up new bot', hint: 'Full onboarding wizard' },
+      { value: '2', label: 'Modify config', hint: 'Edit existing settings' },
+      { value: '3', label: 'Re-onboard', hint: 'Start fresh' }
+    ]
+  });
+  checkCancel(action);
+
+  switch (action) {
+    case '1':
+      await fullWizard(configPath, pluginsDir, null);
+      break;
+    case '2':
+      await modifyWizard(configPath, pluginsDir, existing);
+      break;
+    case '3':
+      const yes = await confirm({ message: 'Wipe current config and start fresh?' });
+      checkCancel(yes);
+      if (yes) {
+        await fullWizard(configPath, pluginsDir, null);
+      } else {
+        log.info('Keeping current config.');
+      }
+      break;
+  }
+
+  outro('Done!');
+}
+
+async function fullWizard(configPath, pluginsDir, existing) {
+  intro('Spiralcord Setup');
+
+  const config = existing || {};
+
+  // Step 1: Token
+  const token = await password({
+    message: 'Bot token:',
+    mask: '▪',
+    validate(value) {
+      if (!value || value.length < 50) return 'Token seems too short. Discord tokens are 70+ characters.';
+    }
+  });
+  checkCancel(token);
+  config.token = token;
+
+  // Step 2: Bot Name
+  const name = await text({
+    message: 'Bot name:',
+    defaultValue: 'My Spiral Bot',
+    initialValue: config.name || 'My Spiral Bot'
+  });
+  checkCancel(name);
+  config.name = name || 'My Spiral Bot';
+
+  // Step 3: Prefix
+  const prefix = await text({
+    message: 'Command prefix:',
+    defaultValue: '!',
+    initialValue: config.prefix || '!'
+  });
+  checkCancel(prefix);
+  config.prefix = prefix || '!';
+
+  // Step 4: Client ID
+  const clientId = await text({
+    message: 'Client ID (for slash commands, optional):',
+    initialValue: config.clientId || '',
+    placeholder: 'Leave empty to skip'
+  });
+  checkCancel(clientId);
+  config.clientId = clientId || '';
+
+  // Step 5: Intents
+  const currentIntents = Array.isArray(config.intents) ? config.intents : ['Guilds', 'GuildMessages', 'MessageContent'];
+  const intents = await multiselect({
+    message: 'Select gateway intents:',
+    options: ALL_INTENTS.map(i => ({
+      value: i,
+      label: i,
+      hint: currentIntents.includes(i) ? 'selected' : undefined
+    })),
+    initialValues: currentIntents
+  });
+  checkCancel(intents);
+  config.intents = intents;
+
+  // Step 6: Per-Guild Slash
+  const perGuildSlash = await confirm({
+    message: 'Register slash commands per-guild? (instant vs ~1h propagation)',
+    initialValue: config.perGuildSlash || false
+  });
+  checkCancel(perGuildSlash);
+  config.perGuildSlash = perGuildSlash;
+
+  // Step 7: Plugin Config
+  if (pluginsDir) {
+    await pluginConfigWizard(pluginsDir, config);
+  }
+
+  // Step 8: Review
+  await reviewAndSave(configPath, config);
+}
+
+async function pluginConfigWizard(pluginsDir, config) {
+  const pluginConfigs = await scanPluginConfigs(pluginsDir);
+
+  if (pluginConfigs.length === 0) {
+    log.info('No plugin configurations found.');
+    return;
+  }
+
+  note('Configure plugin settings below. Press Esc to skip a field.', 'Plugin Configuration');
+
+  for (const { plugin, fields } of pluginConfigs) {
+    log.step(plugin);
+
+    for (const field of fields) {
+      const fieldKey = `${plugin}.${field.key}`;
+      const currentVal = config[fieldKey] !== undefined ? config[fieldKey] : field.default;
+
+      if (field.type === 'confirm') {
+        const val = await confirm({
+          message: `${field.key}: ${field.description}`,
+          initialValue: currentVal !== undefined ? currentVal : field.default
+        });
+        if (val !== undefined && val !== null) {
+          config[fieldKey] = val;
+        }
+      } else if (field.type === 'select' && field.enum) {
+        const val = await select({
+          message: `${field.key}: ${field.description}`,
+          options: field.enum.map(e => ({ value: e, label: e })),
+          initialValue: currentVal || field.default
+        });
+        if (val !== undefined) {
+          config[fieldKey] = val;
+        }
+      } else if (field.type === 'number') {
+        const val = await text({
+          message: `${field.key}: ${field.description} (${field.default !== undefined ? field.default : 'none'})`,
+          initialValue: currentVal !== undefined ? String(currentVal) : '',
+          placeholder: String(field.default || '')
+        });
+        if (val !== undefined && val !== '') {
+          config[fieldKey] = Number(val);
+        }
+      } else {
+        const val = await text({
+          message: `${field.key}: ${field.description} (${field.default !== undefined ? field.default : 'none'})`,
+          initialValue: currentVal !== undefined ? String(currentVal) : '',
+          placeholder: String(field.default || '')
+        });
+        if (val !== undefined && val !== '') {
+          config[fieldKey] = val;
+        }
+      }
+    }
+  }
+}
+
+async function reviewAndSave(configPath, config) {
+  note(formatConfig(config), 'Review Configuration');
+
+  const save = await confirm({ message: 'Save this configuration?' });
+  checkCancel(save);
+
+  if (save) {
+    const s = spinner();
+    s.start('Saving configuration...');
+    await saveSpiralConfig(configPath, config);
+    s.stop('Configuration saved!');
+    log.success(`Wrote ${configPath}`);
+  } else {
+    log.info('Configuration not saved.');
+  }
+}
+
+async function modifyWizard(configPath, pluginsDir, config) {
+  intro('Modify Configuration');
+
+  const allFields = [...SPIRAL_FIELDS];
+
+  if (pluginsDir) {
+    const pluginConfigs = await scanPluginConfigs(pluginsDir);
+    for (const { plugin, fields } of pluginConfigs) {
+      for (const field of fields) {
+        allFields.push({
+          key: `${plugin}.${field.key}`,
+          type: field.type,
+          description: `[${plugin}] ${field.description}`,
+          default: field.default,
+          enum: field.enum
+        });
+      }
+    }
+  }
+
+  const fieldOptions = allFields.map((f, i) => ({
+    value: String(i + 1),
+    label: f.key,
+    hint: f.description
+  }));
+
+  const choice = await selectKey({
+    message: 'Select a field to edit:',
+    options: fieldOptions
+  });
+  checkCancel(choice);
+
+  const idx = parseInt(choice) - 1;
+  const field = allFields[idx];
+  if (!field) {
+    log.error('Invalid selection.');
+    return;
+  }
+
+  const currentVal = config[field.key] !== undefined ? config[field.key] : field.default;
+
+  if (field.type === 'confirm') {
+    const val = await confirm({
+      message: `${field.key}: ${field.description}`,
+      initialValue: currentVal !== undefined ? currentVal : false
+    });
+    if (val !== undefined && val !== null) {
+      config[field.key] = val;
+    }
+  } else if (field.type === 'password') {
+    const val = await password({
+      message: `${field.key}: ${field.description}`,
+      mask: '▪'
+    });
+    checkCancel(val);
+    config[field.key] = val;
+  } else if (field.type === 'select' && field.enum) {
+    const val = await select({
+      message: `${field.key}: ${field.description}`,
+      options: field.enum.map(e => ({ value: e, label: e })),
+      initialValue: currentVal || field.default
+    });
+    if (val !== undefined) {
+      config[field.key] = val;
+    }
+  } else if (field.type === 'multiselect') {
+    const val = await multiselect({
+      message: `${field.key}: ${field.description}`,
+      options: ALL_INTENTS.map(i => ({ value: i, label: i })),
+      initialValues: Array.isArray(currentVal) ? currentVal : field.default || []
+    });
+    if (val !== undefined) {
+      config[field.key] = val;
+    }
+  } else if (field.type === 'number') {
+    const val = await text({
+      message: `${field.key}: ${field.description}`,
+      initialValue: currentVal !== undefined ? String(currentVal) : '',
+      placeholder: String(field.default || '')
+    });
+    if (val !== undefined && val !== '') {
+      config[field.key] = Number(val);
+    }
+  } else {
+    const val = await text({
+      message: `${field.key}: ${field.description}`,
+      initialValue: currentVal !== undefined ? String(currentVal) : '',
+      placeholder: String(field.default || '')
+    });
+    if (val !== undefined) {
+      config[field.key] = val;
+    }
+  }
+
+  const save = await confirm({ message: 'Save changes?' });
+  checkCancel(save);
+
+  if (save) {
+    const s = spinner();
+    s.start('Saving...');
+    await saveSpiralConfig(configPath, config);
+    s.stop('Saved!');
+    log.success(`Updated ${configPath}`);
+  }
+}
+
+async function addField(configPath, fieldName, fieldValue) {
+  const config = await loadSpiralConfig(configPath);
+  if (!config) {
+    log.error('No spiral.json found. Run "spiral onboard" first.');
+    process.exit(1);
+  }
+
+  if (fieldValue !== undefined) {
+    config[fieldName] = parseValue(fieldValue);
+    await saveSpiralConfig(configPath, config);
+    log.success(`Set ${fieldName} = ${JSON.stringify(config[fieldName])}`);
+    return;
+  }
+
+  intro(`Add / Edit: ${fieldName}`);
+
+  const current = config[fieldName];
+  const initial = current !== undefined ? String(current) : '';
+
+  const val = await text({
+    message: `Enter value for ${fieldName}:`,
+    initialValue: initial,
+    placeholder: current !== undefined ? String(current) : 'Enter value'
+  });
+
+  if (val === undefined) {
+    cancel('Cancelled.');
+    return;
+  }
+
+  config[fieldName] = val === '' ? initial : parseValue(val);
+  await saveSpiralConfig(configPath, config);
+  log.success(`Set ${fieldName} = ${JSON.stringify(config[fieldName])}`);
+}
+
+function parseValue(val) {
+  if (val === 'true') return true;
+  if (val === 'false') return false;
+  if (/^-?\d+(\.\d+)?$/.test(val)) return Number(val);
+  try {
+    const parsed = JSON.parse(val);
+    if (Array.isArray(parsed)) return parsed;
+  } catch {}
+  return val;
+}
+
+function formatConfig(config) {
+  const lines = [];
+  for (const [key, val] of Object.entries(config)) {
+    if (key === 'token') {
+      lines.push(`  ${key}: ${val ? '▪▪▪▪▪▪▪▪' + val.slice(-4) : '(empty)'}`);
+    } else if (Array.isArray(val)) {
+      lines.push(`  ${key}: ${val.join(', ')}`);
+    } else if (typeof val === 'object' && val !== null) {
+      lines.push(`  ${key}: ${JSON.stringify(val)}`);
+    } else {
+      lines.push(`  ${key}: ${val}`);
+    }
+  }
+  return lines.join('\n');
+}
+
+module.exports = { onboard, addField, fullWizard };

package/src/onboard/prompts.js

@@ -0,0 +1,20 @@
+const {
+  intro, outro, cancel, isCancel,
+  text, password, confirm, select, selectKey,
+  multiselect, group, spinner, log, note
+} = require('@clack/prompts');
+
+function checkCancel(value) {
+  if (isCancel(value)) {
+    cancel('Operation cancelled.');
+    process.exit(0);
+  }
+  return value;
+}
+
+module.exports = {
+  intro, outro, cancel, isCancel,
+  text, password, confirm, select, selectKey,
+  multiselect, group, spinner, log, note,
+  checkCancel
+};