serpentstack 0.2.5 → 0.2.9

package/bin/serpentstack.js

@@ -1,6 +1,9 @@
 #!/usr/bin/env node
 
-import { error, bold, dim, green, cyan, getVersion, printHeader } from '../lib/utils/ui.js';
+import { error, bold, dim, green, cyan, yellow, getVersion, printHeader, divider } from '../lib/utils/ui.js';
+
+// Short flag aliases
+const FLAG_ALIASES = { f: 'force', h: 'help', v: 'version', a: 'all' };
 
 function parseArgs(args) {
   const flags = {};
@@ -9,6 +12,13 @@ function parseArgs(args) {
     if (arg.startsWith('--')) {
       const [key, val] = arg.slice(2).split('=');
       flags[key] = val ?? true;
+    } else if (arg.startsWith('-') && arg.length > 1 && !arg.startsWith('--')) {
+      // Short flags: -f, -h, -v, -a, or combined like -fa
+      for (const ch of arg.slice(1)) {
+        const long = FLAG_ALIASES[ch];
+        if (long) flags[long] = true;
+        else flags[ch] = true;
+      }
     } else {
       positional.push(arg);
     }
@@ -16,35 +26,67 @@ function parseArgs(args) {
   return { flags, positional };
 }
 
+// Known commands for fuzzy matching on typos
+const KNOWN_COMMANDS = ['stack', 'skills', 'persistent'];
+
+function suggestCommand(input) {
+  const lower = input.toLowerCase();
+  let best = null, bestDist = 3; // threshold: edit distance ≤ 2
+  for (const cmd of KNOWN_COMMANDS) {
+    if (cmd.startsWith(lower) || lower.startsWith(cmd)) return cmd;
+    const d = editDistance(lower, cmd);
+    if (d < bestDist) { bestDist = d; best = cmd; }
+  }
+  return best;
+}
+
+function editDistance(a, b) {
+  const m = a.length, n = b.length;
+  const dp = Array.from({ length: m + 1 }, () => new Array(n + 1));
+  for (let i = 0; i <= m; i++) dp[i][0] = i;
+  for (let j = 0; j <= n; j++) dp[0][j] = j;
+  for (let i = 1; i <= m; i++)
+    for (let j = 1; j <= n; j++)
+      dp[i][j] = Math.min(
+        dp[i - 1][j] + 1,
+        dp[i][j - 1] + 1,
+        dp[i - 1][j - 1] + (a[i - 1] !== b[j - 1] ? 1 : 0),
+      );
+  return dp[m][n];
+}
+
 function showHelp() {
   printHeader();
-  console.log(`  ${bold('Usage:')} serpentstack <command> [options]
-
-  ${bold(green('New projects'))}
-    ${cyan('stack new')} <name>              Scaffold a full project from the template
-    ${cyan('stack update')}                  Update template-level files to latest
-
-  ${bold(green('Any project'))}
-    ${cyan('skills')}                        Download base skills + persistent agent configs
-    ${cyan('skills update')}                 Update base skills to latest versions
-    ${cyan('persistent')}                    Manage and launch persistent agents
-    ${cyan('persistent')} --stop             Stop all running agents
-    ${cyan('persistent')} --reconfigure      Re-run setup (change models, enable/disable)
-
-  ${bold('Options:')}
-    --force                       Overwrite existing files
-    --all                         Include new files in updates (skills update)
-    --version                     Show version
-    --help                        Show this help
-
-  ${dim('Examples:')}
-    ${dim('$')} serpentstack stack new my-saas-app
-    ${dim('$')} serpentstack skills
-    ${dim('$')} serpentstack persistent
-    ${dim('$')} serpentstack persistent --stop
-
-  ${dim('Docs: https://github.com/Benja-Pauls/SerpentStack')}
-`);
+  console.log(`  ${dim('Deployable fullstack templates + AI agent skills for any project')}`);
+  console.log();
+
+  divider('New projects');
+  console.log(`    ${cyan('stack new')} ${dim('<name>')}             Scaffold a full project from the template`);
+  console.log(`    ${cyan('stack update')}                  Update template-level files to latest`);
+  console.log();
+
+  divider('Any project');
+  console.log(`    ${cyan('skills')}                        Download all skills + persistent agent configs`);
+  console.log(`    ${cyan('skills update')}                 Update base skills to latest versions`);
+  console.log(`    ${cyan('persistent')}                    Manage and launch persistent background agents`);
+  console.log(`    ${cyan('persistent')} ${dim('--stop')}            Stop all running agents`);
+  console.log(`    ${cyan('persistent')} ${dim('--reconfigure')}     Change models, enable/disable agents`);
+  console.log();
+
+  divider('Options');
+  console.log(`    ${bold('-f')}, ${bold('--force')}                   Overwrite existing files`);
+  console.log(`    ${bold('-a')}, ${bold('--all')}                     Include new files in updates`);
+  console.log(`    ${bold('-v')}, ${bold('--version')}                 Show version`);
+  console.log(`    ${bold('-h')}, ${bold('--help')}                    Show this help`);
+  console.log();
+
+  console.log(`  ${dim('Examples:')}`);
+  console.log(`    ${dim('$')} serpentstack stack new my-saas-app`);
+  console.log(`    ${dim('$')} serpentstack skills`);
+  console.log(`    ${dim('$')} serpentstack persistent`);
+  console.log();
+  console.log(`  ${dim('Docs:')} ${cyan('https://github.com/Benja-Pauls/SerpentStack')}`);
+  console.log();
 }
 
 async function main() {
@@ -95,7 +137,12 @@ async function main() {
     await persistent({ stop: !!flags.stop, reconfigure: !!flags.reconfigure });
   } else {
     error(`Unknown command: ${bold(noun)}`);
-    console.log(`\n  Run ${bold('serpentstack --help')} to see available commands.\n`);
+    const suggestion = suggestCommand(noun);
+    if (suggestion) {
+      console.log(`\n  Did you mean ${bold(suggestion)}? Run ${bold(`serpentstack ${suggestion}`)} or ${bold('serpentstack --help')}.\n`);
+    } else {
+      console.log(`\n  Run ${bold('serpentstack --help')} to see available commands.\n`);
+    }
     process.exit(1);
   }
 }