adonisjs-maestro 0.0.1 → 0.1.0

package/README.md

@@ -57,6 +57,13 @@ Restart your agent after installing so the new skills are loaded.
 | `inertia-react` | React frontend patterns in AdonisJS + Inertia projects |
 | `japa` | Japa testing in AdonisJS apps: API tests, browser tests, console tests, fakes, swaps, and database setup |
 
+### In Progress
+
+| Skill | Stack | Use it for |
+| --- | --- | --- |
+| `edge` | `hypermedia` | Edge.js server-side templates: layouts, components, partials, tags, and view helpers |
+| `tuyau` | `api-monorepo` | Tuyau end-to-end type-safe API client: codegen, typed routes, and RPC-style calls |
+
 ## Recommended Entry Point
 
 Use `maestro` when the task is broader than a single framework question.

package/build/bin/run.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   kernel
-} from "../chunk-ZWBJVZPB.js";
+} from "../chunk-73R5GXO2.js";
 
 // bin/run.ts
 kernel.handle(["adonisjs-maestro", ...process.argv.slice(2)]).catch((error) => {

package/build/chunk-73R5GXO2.js

@@ -0,0 +1,341 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+
+// index.ts
+import { HelpCommand, Kernel } from "@adonisjs/ace";
+
+// commands/main.ts
+import { fileURLToPath } from "url";
+import { execa } from "execa";
+import { BaseCommand, flags } from "@adonisjs/ace";
+
+// src/stacks.ts
+var SKILLS_REPOSITORY = "lncitador/adonisjs-maestro";
+var AVAILABLE_AGENTS = [
+  { name: "claude-code", label: "Claude Code" },
+  { name: "codex", label: "Codex" },
+  { name: "cursor", label: "Cursor" },
+  { name: "gemini-cli", label: "Gemini CLI" },
+  { name: "github-copilot", label: "GitHub Copilot" },
+  { name: "opencode", label: "OpenCode" },
+  { name: "windsurf", label: "Windsurf" },
+  { name: "cline", label: "Cline" },
+  { name: "roo", label: "Roo Code" },
+  { name: "continue", label: "Continue" },
+  { name: "amp", label: "Amp" },
+  { name: "aider-desk", label: "AiderDesk" },
+  { name: "antigravity", label: "Antigravity" },
+  { name: "augment", label: "Augment" },
+  { name: "bob", label: "IBM Bob" },
+  { name: "codearts-agent", label: "CodeArts Agent" },
+  { name: "codebuddy", label: "CodeBuddy" },
+  { name: "codemaker", label: "Codemaker" },
+  { name: "codestudio", label: "Code Studio" },
+  { name: "command-code", label: "Command Code" },
+  { name: "cortex", label: "Cortex Code" },
+  { name: "crush", label: "Crush" },
+  { name: "deepagents", label: "Deep Agents" },
+  { name: "devin", label: "Devin for Terminal" },
+  { name: "dexto", label: "Dexto" },
+  { name: "droid", label: "Droid (Factory AI)" },
+  { name: "firebender", label: "Firebender" },
+  { name: "forgecode", label: "ForgeCode" },
+  { name: "goose", label: "Goose" },
+  { name: "hermes-agent", label: "Hermes Agent" },
+  { name: "iflow-cli", label: "iFlow CLI" },
+  { name: "junie", label: "Junie" },
+  { name: "kilo", label: "Kilo Code" },
+  { name: "kimi-cli", label: "Kimi Code CLI" },
+  { name: "kiro-cli", label: "Kiro CLI" },
+  { name: "kode", label: "Kode" },
+  { name: "mcpjam", label: "MCPJam" },
+  { name: "mistral-vibe", label: "Mistral Vibe" },
+  { name: "mux", label: "Mux" },
+  { name: "neovate", label: "Neovate" },
+  { name: "openclaw", label: "OpenClaw" },
+  { name: "openhands", label: "OpenHands" },
+  { name: "pi", label: "Pi" },
+  { name: "pochi", label: "Pochi" },
+  { name: "qoder", label: "Qoder" },
+  { name: "qwen-code", label: "Qwen Code" },
+  { name: "replit", label: "Replit" },
+  { name: "rovodev", label: "Rovo Dev" },
+  { name: "tabnine-cli", label: "Tabnine CLI" },
+  { name: "trae", label: "Trae" },
+  { name: "trae-cn", label: "Trae CN" },
+  { name: "universal", label: "Universal" },
+  { name: "warp", label: "Warp" },
+  { name: "zencoder", label: "Zencoder" },
+  { name: "adal", label: "AdaL" }
+];
+var AVAILABLE_SKILLS = [
+  "maestro",
+  "adonisjs",
+  "lucid",
+  "japa",
+  "inertia-react",
+  "inertia-vue"
+];
+var SKILL_METADATA = {
+  maestro: {
+    label: "Maestro",
+    hint: "Orchestration: intake \u2192 plan \u2192 build \u2192 verify \u2192 publish"
+  },
+  adonisjs: {
+    label: "AdonisJS",
+    hint: "Controllers, routes, auth, middleware, services, events"
+  },
+  lucid: {
+    label: "Lucid",
+    hint: "Migrations, models, relationships, query builders, factories"
+  },
+  japa: {
+    label: "Japa",
+    hint: "API, browser, and console tests with fakes and database setup"
+  },
+  "inertia-react": {
+    label: "Inertia React",
+    hint: "React frontend patterns for AdonisJS + Inertia projects"
+  },
+  "inertia-vue": {
+    label: "Inertia Vue",
+    hint: "Vue 3 frontend patterns for AdonisJS + Inertia projects"
+  }
+};
+var STACKS = [
+  {
+    name: "hypermedia",
+    label: "Hypermedia app",
+    hint: "A full-stack app using server-side templates",
+    starterKit: "github:adonisjs/starter-kits/hypermedia",
+    skills: ["maestro", "adonisjs", "lucid", "japa"]
+  },
+  {
+    name: "react",
+    label: "React app (using Inertia)",
+    hint: "A full-stack React app with end-to-end type safety",
+    starterKit: "github:adonisjs/starter-kits/inertia-react",
+    skills: ["maestro", "adonisjs", "lucid", "japa", "inertia-react"]
+  },
+  {
+    name: "vue",
+    label: "Vue app (using Inertia)",
+    hint: "A full-stack Vue app with end-to-end type safety",
+    starterKit: "github:adonisjs/starter-kits/inertia-vue",
+    skills: ["maestro", "adonisjs", "lucid", "japa", "inertia-vue"]
+  },
+  {
+    name: "api",
+    label: "API",
+    hint: "A type-safe REST API with session and access token auth",
+    starterKit: "github:adonisjs/starter-kits/api",
+    skills: ["maestro", "adonisjs", "lucid", "japa"]
+  },
+  {
+    name: "api-monorepo",
+    label: "API (monorepo)",
+    hint: "A monorepo setup with a type-safe REST API",
+    starterKit: "github:adonisjs/starter-kits/api-monorepo",
+    skills: ["maestro", "adonisjs", "lucid", "japa"]
+  },
+  {
+    name: "custom",
+    label: "Custom",
+    hint: "Choose individual skills",
+    starterKit: null,
+    skills: []
+  }
+];
+function getStack(name) {
+  return STACKS.find((stack) => stack.name === name);
+}
+function parseSkills(value) {
+  const requested = value.split(",").map((skill) => skill.trim()).filter(Boolean);
+  const invalid = requested.filter((skill) => !AVAILABLE_SKILLS.includes(skill));
+  if (invalid.length > 0) {
+    throw new Error(`Unknown skill(s): ${invalid.join(", ")}`);
+  }
+  return [...new Set(requested)];
+}
+function buildSkillsAddArgs(options) {
+  const args = ["skills", "add", SKILLS_REPOSITORY];
+  for (const skill of options.skills) {
+    args.push("--skill", skill);
+  }
+  if (options.global) {
+    args.push("--global");
+  }
+  for (const agent of options.agents ?? []) {
+    args.push("--agent", agent);
+  }
+  if (options.yes) {
+    args.push("--yes");
+  }
+  return args;
+}
+
+// commands/main.ts
+var skillsBin = fileURLToPath(import.meta.resolve("skills/bin/cli.mjs"));
+var InstallSkills = class extends BaseCommand {
+  static commandName = "adonisjs-maestro";
+  static description = "Install AdonisJS Maestro agent skills for your stack";
+  async #promptForStack() {
+    if (this.stack) {
+      return this.stack;
+    }
+    const selected = await this.prompt.choice(
+      "Which AdonisJS stack are you using?",
+      STACKS.map((stack) => ({
+        name: stack.name,
+        message: stack.label,
+        hint: stack.hint
+      }))
+    );
+    return selected;
+  }
+  async #promptForCustomSkills() {
+    const selected = await this.prompt.multiple(
+      "Which skills should be installed?",
+      AVAILABLE_SKILLS.map((skill) => ({
+        name: skill,
+        message: SKILL_METADATA[skill].label,
+        hint: SKILL_METADATA[skill].hint
+      })),
+      {
+        validate: (values) => values.length > 0 || "Select at least one skill"
+      }
+    );
+    return selected;
+  }
+  async #promptForScope() {
+    if (this.global !== void 0 || this.yes) {
+      return this.global ?? false;
+    }
+    return this.prompt.toggle("Install scope", ["Global (~/.claude/skills)", "Project (.claude/skills)"], {
+      default: false
+    });
+  }
+  async #resolveAgents() {
+    if (this.agent) {
+      return this.agent.split(",").map((agent) => agent.trim()).filter(Boolean);
+    }
+    if (this.yes) {
+      return ["universal"];
+    }
+    const chooseSpecific = await this.prompt.confirm("Choose specific agents?", { default: false });
+    if (!chooseSpecific) {
+      return ["universal"];
+    }
+    const selected = await this.prompt.multiple(
+      "Which agents should receive the skills?",
+      AVAILABLE_AGENTS.map((agent) => ({ name: agent.name, message: agent.label })),
+      { hint: "Space to toggle, Enter to confirm" }
+    );
+    return selected.length > 0 ? selected : ["universal"];
+  }
+  async #resolveSkills() {
+    if (this.skills) {
+      return parseSkills(this.skills);
+    }
+    const stackName = await this.#promptForStack();
+    const stack = getStack(stackName);
+    if (!stack) {
+      throw new Error(`Unknown stack "${stackName}". Expected one of: ${STACKS.map((item) => item.name).join(", ")}`);
+    }
+    if (stack.name === "custom") {
+      return this.#promptForCustomSkills();
+    }
+    return stack.skills;
+  }
+  #renderCommand(args) {
+    return ["npx", ...args].join(" ");
+  }
+  async run() {
+    this.logger.log("\n>_ AdonisJS Maestro\n");
+    const skills = await this.#resolveSkills();
+    if (skills.length === 0) {
+      throw new Error("No skills selected");
+    }
+    const isGlobal = await this.#promptForScope();
+    const agents = await this.#resolveAgents();
+    const args = buildSkillsAddArgs({
+      skills,
+      global: isGlobal,
+      agents,
+      yes: true
+    });
+    this.logger.info(`Installing skills: ${skills.join(", ")}`);
+    this.logger.info(this.#renderCommand(args));
+    if (this.dryRun) {
+      return;
+    }
+    await execa("node", [skillsBin, ...args.slice(1)], {
+      stdio: "inherit"
+    });
+    this.logger.success("AdonisJS Maestro skills installed");
+  }
+};
+__decorateClass([
+  flags.string({
+    description: "Stack preset to install: monorepo, hypermedia, react, vue, or custom"
+  })
+], InstallSkills.prototype, "stack", 2);
+__decorateClass([
+  flags.string({
+    description: "Comma-separated list of skills to install"
+  })
+], InstallSkills.prototype, "skills", 2);
+__decorateClass([
+  flags.string({
+    description: 'Target agent. Repeat by comma-separating values, or use "*" for all agents',
+    alias: "a"
+  })
+], InstallSkills.prototype, "agent", 2);
+__decorateClass([
+  flags.boolean({
+    description: "Install globally instead of the current project",
+    alias: "g"
+  })
+], InstallSkills.prototype, "global", 2);
+__decorateClass([
+  flags.boolean({
+    description: "Skip skills CLI confirmation prompts",
+    alias: "y"
+  })
+], InstallSkills.prototype, "yes", 2);
+__decorateClass([
+  flags.boolean({
+    description: "Print the generated npx skills command without running it"
+  })
+], InstallSkills.prototype, "dryRun", 2);
+__decorateClass([
+  flags.boolean({
+    description: "Show command output from the skills CLI",
+    alias: "v"
+  })
+], InstallSkills.prototype, "verbose", 2);
+
+// index.ts
+Kernel.defaultCommand = InstallSkills;
+var kernel = Kernel.create();
+kernel.defineFlag("help", {
+  type: "boolean",
+  description: HelpCommand.description
+});
+kernel.on("help", async (command, $kernel, parsed) => {
+  parsed.args.unshift(command.commandName);
+  await new HelpCommand($kernel, parsed, kernel.ui, kernel.prompt).exec();
+  return $kernel.shortcircuit();
+});
+
+export {
+  kernel
+};

package/build/index.js

@@ -1,6 +1,6 @@
 import {
   kernel
-} from "./chunk-ZWBJVZPB.js";
+} from "./chunk-73R5GXO2.js";
 export {
   kernel
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "adonisjs-maestro",
   "description": "Install AdonisJS Maestro agent skills by stack",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "type": "module",
   "main": "build/index.js",
   "bin": {
@@ -25,7 +25,8 @@
   },
   "dependencies": {
     "@adonisjs/ace": "^14.1.0",
-    "execa": "^9.6.1"
+    "execa": "^9.6.1",
+    "skills": "^1.5.5"
   },
   "devDependencies": {
     "@japa/assert": "^4.2.0",

package/build/chunk-ZWBJVZPB.js

@@ -1,217 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __decorateClass = (decorators, target, key, kind) => {
-  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
-  for (var i = decorators.length - 1, decorator; i >= 0; i--)
-    if (decorator = decorators[i])
-      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-  if (kind && result) __defProp(target, key, result);
-  return result;
-};
-
-// index.ts
-import { HelpCommand, Kernel } from "@adonisjs/ace";
-
-// commands/main.ts
-import { execa } from "execa";
-import { BaseCommand, flags } from "@adonisjs/ace";
-
-// src/stacks.ts
-var SKILLS_REPOSITORY = "lncitador/adonisjs-maestro";
-var AVAILABLE_SKILLS = [
-  "maestro",
-  "adonisjs",
-  "lucid",
-  "japa",
-  "inertia-react",
-  "inertia-vue"
-];
-var STACKS = [
-  {
-    name: "monorepo",
-    label: "Monorepo: API + TanStack",
-    hint: "API/backend workflow without Inertia frontend skills",
-    skills: ["maestro", "adonisjs", "lucid", "japa"]
-  },
-  {
-    name: "hypermedia",
-    label: "Hypermedia",
-    hint: "Server-rendered or hypermedia-oriented AdonisJS app",
-    skills: ["maestro", "adonisjs", "lucid", "japa"]
-  },
-  {
-    name: "react",
-    label: "Fullstack: Inertia React",
-    hint: "AdonisJS + Lucid + Inertia React",
-    skills: ["maestro", "adonisjs", "lucid", "japa", "inertia-react"]
-  },
-  {
-    name: "vue",
-    label: "Fullstack: Inertia Vue",
-    hint: "AdonisJS + Lucid + Inertia Vue",
-    skills: ["maestro", "adonisjs", "lucid", "japa", "inertia-vue"]
-  },
-  {
-    name: "custom",
-    label: "Custom",
-    hint: "Choose individual skills",
-    skills: []
-  }
-];
-function getStack(name) {
-  return STACKS.find((stack) => stack.name === name);
-}
-function parseSkills(value) {
-  const requested = value.split(",").map((skill) => skill.trim()).filter(Boolean);
-  const invalid = requested.filter((skill) => !AVAILABLE_SKILLS.includes(skill));
-  if (invalid.length > 0) {
-    throw new Error(`Unknown skill(s): ${invalid.join(", ")}`);
-  }
-  return [...new Set(requested)];
-}
-function buildSkillsAddArgs(options) {
-  const args = ["skills", "add", SKILLS_REPOSITORY];
-  for (const skill of options.skills) {
-    args.push("--skill", skill);
-  }
-  if (options.global) {
-    args.push("--global");
-  }
-  for (const agent of options.agents ?? []) {
-    args.push("--agent", agent);
-  }
-  if (options.yes) {
-    args.push("--yes");
-  }
-  return args;
-}
-
-// commands/main.ts
-var InstallSkills = class extends BaseCommand {
-  static commandName = "adonisjs-maestro";
-  static description = "Install AdonisJS Maestro agent skills for your stack";
-  async #promptForStack() {
-    if (this.stack) {
-      return this.stack;
-    }
-    const selected = await this.prompt.choice(
-      "Which AdonisJS stack are you using?",
-      STACKS.map((stack) => ({
-        name: stack.name,
-        message: stack.label,
-        hint: stack.hint
-      }))
-    );
-    return selected;
-  }
-  async #promptForCustomSkills() {
-    const answer = await this.prompt.ask(
-      [
-        "Which skills should be installed?",
-        `Available: ${AVAILABLE_SKILLS.join(", ")}`,
-        "Enter a comma-separated list"
-      ].join("\n")
-    );
-    return parseSkills(answer);
-  }
-  #parseAgents() {
-    if (!this.agent) {
-      return [];
-    }
-    return this.agent.split(",").map((agent) => agent.trim()).filter(Boolean);
-  }
-  async #resolveSkills() {
-    if (this.skills) {
-      return parseSkills(this.skills);
-    }
-    const stackName = await this.#promptForStack();
-    const stack = getStack(stackName);
-    if (!stack) {
-      throw new Error(`Unknown stack "${stackName}". Expected one of: ${STACKS.map((item) => item.name).join(", ")}`);
-    }
-    if (stack.name === "custom") {
-      return this.#promptForCustomSkills();
-    }
-    return stack.skills;
-  }
-  #renderCommand(args) {
-    return ["npx", ...args].join(" ");
-  }
-  async run() {
-    const skills = await this.#resolveSkills();
-    if (skills.length === 0) {
-      throw new Error("No skills selected");
-    }
-    const args = buildSkillsAddArgs({
-      skills,
-      global: this.global,
-      agents: this.#parseAgents(),
-      yes: this.yes
-    });
-    this.logger.info(`Installing skills: ${skills.join(", ")}`);
-    this.logger.info(this.#renderCommand(args));
-    if (this.dryRun) {
-      return;
-    }
-    await execa("npx", args, {
-      stdio: this.verbose ? "inherit" : "pipe"
-    });
-    this.logger.success("AdonisJS Maestro skills installed");
-  }
-};
-__decorateClass([
-  flags.string({
-    description: "Stack preset to install: monorepo, hypermedia, react, vue, or custom"
-  })
-], InstallSkills.prototype, "stack", 2);
-__decorateClass([
-  flags.string({
-    description: "Comma-separated list of skills to install"
-  })
-], InstallSkills.prototype, "skills", 2);
-__decorateClass([
-  flags.string({
-    description: 'Target agent. Repeat by comma-separating values, or use "*" for all agents',
-    alias: "a"
-  })
-], InstallSkills.prototype, "agent", 2);
-__decorateClass([
-  flags.boolean({
-    description: "Install globally instead of the current project",
-    alias: "g"
-  })
-], InstallSkills.prototype, "global", 2);
-__decorateClass([
-  flags.boolean({
-    description: "Skip skills CLI confirmation prompts",
-    alias: "y"
-  })
-], InstallSkills.prototype, "yes", 2);
-__decorateClass([
-  flags.boolean({
-    description: "Print the generated npx skills command without running it"
-  })
-], InstallSkills.prototype, "dryRun", 2);
-__decorateClass([
-  flags.boolean({
-    description: "Show command output from the skills CLI",
-    alias: "v"
-  })
-], InstallSkills.prototype, "verbose", 2);
-
-// index.ts
-Kernel.defaultCommand = InstallSkills;
-var kernel = Kernel.create();
-kernel.defineFlag("help", {
-  type: "boolean",
-  description: HelpCommand.description
-});
-kernel.on("help", async (command, $kernel, parsed) => {
-  parsed.args.unshift(command.commandName);
-  await new HelpCommand($kernel, parsed, kernel.ui, kernel.prompt).exec();
-  return $kernel.shortcircuit();
-});
-
-export {
-  kernel
-};