pan-stack-cli 0.1.0 → 0.1.1

package/README.md

@@ -58,12 +58,21 @@ commands:
     description: Deploy backend local
     exec: scripts/deploy.sh
 
+  install:
+    alias: i
+    description: Cài dependencies (pan i hoặc pan install)
+    shell: |
+      set -euo pipefail
+      pnpm install
+
   lint:
     shell: |
       set -euo pipefail
       pnpm lint
 ```
 
+Alias: `alias: i` hoặc `aliases: i, ins` (cách nhau bằng dấu phẩy).
+
 ### Schema `.pan.yaml` (workspace root)
 
 Lệnh orchestration — `cwd` tương đối workspace root; dùng `PAN_WORKSPACE_ROOT` trong shell:

package/bin/pan.js

@@ -95,8 +95,10 @@ function printAllCommands(sources) {
       const targetHint = command.hasTargets
         ? ` [${command.targets.join("|")}]`
         : "";
+      const aliasHint =
+        command.aliases.length > 0 ? ` (${command.aliases.join(", ")})` : "";
       const desc = command.description ? ` — ${command.description}` : "";
-      console.log(`    ${command.name}${targetHint}${desc}`);
+      console.log(`    ${command.name}${aliasHint}${targetHint}${desc}`);
     }
   }
 }
@@ -126,12 +128,13 @@ async function main() {
     return;
   }
 
+  const allSources = loadAllCommandSources();
   const matches = findSourcesWithCommand(command);
   if (matches.length > 1 && !project && process.stdin.isTTY) {
     console.log(formatProjectList(matches, command));
   }
 
-  await runWithProjectResolution(matches, command, args, project);
+  await runWithProjectResolution(matches, command, args, project, allSources);
 }
 
 main().catch((error) => {

package/lib/discover.js

@@ -6,6 +6,7 @@ const {
   loadManifest,
   loadPanConfig,
   getCommandDefinition,
+  commandAliases,
   validateRepo,
   cleanValue,
 } = require("./manifest");
@@ -166,9 +167,18 @@ function sourceMatchesProject(source, projectFlag) {
   );
 }
 
+function sourceHasCommand(source, commandName) {
+  if (source.commands[commandName]) {
+    return true;
+  }
+  return Object.values(source.commands || {}).some((def) =>
+    commandAliases(def).includes(commandName)
+  );
+}
+
 function findSourcesWithCommand(commandName, startDir = process.cwd()) {
-  return loadAllCommandSources(startDir).filter(
-    (source) => source.commands[commandName]
+  return loadAllCommandSources(startDir).filter((source) =>
+    sourceHasCommand(source, commandName)
   );
 }
 

package/lib/manifest.js

@@ -261,6 +261,57 @@ function loadPanConfig(configPath, meta = {}) {
   };
 }
 
+function commandAliases(def) {
+  if (!def) {
+    return [];
+  }
+  const result = [];
+  if (def.alias) {
+    result.push(cleanValue(def.alias));
+  }
+  if (def.aliases) {
+    const raw = def.aliases;
+    if (Array.isArray(raw)) {
+      result.push(...raw.map((item) => cleanValue(item)));
+    } else {
+      const value = cleanValue(raw);
+      if (value.startsWith("[") && value.endsWith("]")) {
+        result.push(
+          ...value
+            .slice(1, -1)
+            .split(",")
+            .map((item) => cleanValue(item))
+            .filter(Boolean)
+        );
+      } else if (value.includes(",")) {
+        result.push(
+          ...value
+            .split(",")
+            .map((item) => cleanValue(item))
+            .filter(Boolean)
+        );
+      } else if (value) {
+        result.push(value);
+      }
+    }
+  }
+  return [...new Set(result.filter(Boolean))];
+}
+
+function resolveCommandName(sources, commandName) {
+  if (sources.some((source) => source.commands[commandName])) {
+    return commandName;
+  }
+  for (const source of sources) {
+    for (const [primaryName, def] of Object.entries(source.commands || {})) {
+      if (commandAliases(def).includes(commandName)) {
+        return primaryName;
+      }
+    }
+  }
+  return commandName;
+}
+
 function getCommandDefinition(source, commandName, subArg) {
   const def = source.commands[commandName];
   if (!def) {
@@ -287,6 +338,7 @@ function getCommandDefinition(source, commandName, subArg) {
 function listCommands(source) {
   return Object.entries(source.commands || {}).map(([name, def]) => ({
     name,
+    aliases: commandAliases(def),
     description: def.description || "",
     hasTargets: Boolean(def.targets),
     targets: def.targets ? Object.keys(def.targets) : [],
@@ -306,6 +358,8 @@ module.exports = {
   loadPanConfig,
   manifestRepos,
   validateRepo,
+  commandAliases,
+  resolveCommandName,
   getCommandDefinition,
   listCommands,
   commandBaseDir,

package/lib/run-command.js

@@ -2,7 +2,11 @@ const fs = require("fs");
 const path = require("path");
 const { spawn, spawnSync } = require("child_process");
 const readline = require("readline");
-const { getCommandDefinition, commandBaseDir } = require("./manifest");
+const {
+  getCommandDefinition,
+  commandBaseDir,
+  resolveCommandName,
+} = require("./manifest");
 const { sourceMatchesProject } = require("./discover");
 
 function needDir(dir) {
@@ -134,7 +138,15 @@ function promptProjectChoice(matches, commandName) {
   });
 }
 
-async function runWithProjectResolution(matches, commandName, args, projectFlag) {
+async function runWithProjectResolution(
+  matches,
+  commandName,
+  args,
+  projectFlag,
+  allSources = matches
+) {
+  const resolvedName = resolveCommandName(allSources, commandName);
+
   if (matches.length === 0) {
     throw new Error(
       `Không tìm thấy lệnh '${commandName}' trong bất kỳ .pan.yaml nào.`
@@ -152,7 +164,7 @@ async function runWithProjectResolution(matches, commandName, args, projectFlag)
     source = matches[0];
   } else {
     const withTargetArg = matches.filter((item) => {
-      const def = item.commands[commandName];
+      const def = item.commands[resolvedName];
       return def?.targets && args[0] && def.targets[args[0]];
     });
     if (withTargetArg.length === 1) {
@@ -169,7 +181,7 @@ async function runWithProjectResolution(matches, commandName, args, projectFlag)
     }
   }
 
-  runProjectCommand(source, commandName, args);
+  runProjectCommand(source, resolvedName, args);
 }
 
 function runGitScript(scriptName, args) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pan-stack-cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI điều phối PAN Stack — git đa repo và lệnh dự án từ .project.yaml",
   "license": "MIT",
   "bin": {
@@ -24,4 +24,4 @@
     "url": "https://github.com/doiya46/pan-stack.git",
     "directory": ".pan/pan-stack-cli"
   }
-}
+}