@crewhaus/slash-commands 0.3.1 → 0.3.2

package/dist/index.d.ts

@@ -17,6 +17,15 @@ export type LoadCommandsOptions = {
      * (`<cwd>/.crewhaus/commands`) commands override builtins by name.
      */
     readonly builtinDirs?: ReadonlyArray<string>;
+    /**
+     * Pre-parsed builtin commands, seeded at the LOWEST precedence of all —
+     * below `builtinDirs`, user, and project. This is the disk-free path for
+     * shipped defaults (`@crewhaus/default-skills`' `DEFAULT_COMMANDS`): a
+     * `bun build --compile` binary has no on-disk `commands/` directory to
+     * point `builtinDirs` at, so without this the builtin slash commands would
+     * silently vanish from compiled binaries.
+     */
+    readonly builtinCommands?: ReadonlyArray<SlashCommand>;
 };
 export type ExpandResult = {
     readonly handled: boolean;
@@ -29,11 +38,12 @@ export declare class SlashCommandError extends CrewhausError {
     constructor(message: string, cause?: unknown);
 }
 /**
- * Read every `.md` file directly under each command root — builtin dirs
- * first, then `~/.crewhaus/commands/`, then `<cwd>/.crewhaus/commands/` —
- * so later roots override earlier ones by name. Each file's basename (sans
- * extension) becomes its key in the returned map. Subdirectories are not
- * currently walked (v1 keeps the namespace flat).
+ * Read every `.md` file directly under each command root — pre-parsed
+ * `builtinCommands` first, then builtin dirs, then `~/.crewhaus/commands/`,
+ * then `<cwd>/.crewhaus/commands/` — so later sources override earlier ones
+ * by name. Each file's basename (sans extension) becomes its key in the
+ * returned map. Subdirectories are not currently walked (v1 keeps the
+ * namespace flat).
  */
 export declare function loadCommands(opts?: LoadCommandsOptions): Promise<Map<string, SlashCommand>>;
 type ParsedCommand = {

package/dist/index.js

@@ -49,11 +49,12 @@ export class SlashCommandError extends CrewhausError {
     }
 }
 /**
- * Read every `.md` file directly under each command root — builtin dirs
- * first, then `~/.crewhaus/commands/`, then `<cwd>/.crewhaus/commands/` —
- * so later roots override earlier ones by name. Each file's basename (sans
- * extension) becomes its key in the returned map. Subdirectories are not
- * currently walked (v1 keeps the namespace flat).
+ * Read every `.md` file directly under each command root — pre-parsed
+ * `builtinCommands` first, then builtin dirs, then `~/.crewhaus/commands/`,
+ * then `<cwd>/.crewhaus/commands/` — so later sources override earlier ones
+ * by name. Each file's basename (sans extension) becomes its key in the
+ * returned map. Subdirectories are not currently walked (v1 keeps the
+ * namespace flat).
  */
 export async function loadCommands(opts = {}) {
     const cwd = opts.cwd ?? process.cwd();
@@ -64,6 +65,11 @@ export async function loadCommands(opts = {}) {
     if (projectRoot !== userRoot)
         roots.push(projectRoot);
     const out = new Map();
+    // Lowest precedence: pre-parsed builtins (disk-free, so they survive in a
+    // compiled binary). On-disk roots below override them by name.
+    for (const command of opts.builtinCommands ?? []) {
+        out.set(command.name, command);
+    }
     for (const root of roots) {
         readCommandsUnder(root, out);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewhaus/slash-commands",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "type": "module",
   "description": "Markdown-templated slash commands with $ARGUMENTS substitution",
   "main": "dist/index.js",
@@ -15,7 +15,7 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@crewhaus/errors": "0.3.1",
+    "@crewhaus/errors": "0.3.2",
     "yaml": "^2.6.0"
   },
   "license": "Apache-2.0",