@staff0rd/assist 0.99.0 → 0.100.1

package/README.md

@@ -74,7 +74,7 @@ After installation, the `assist` command will be available globally. You can als
 - `assist backlog delete <id>` - Delete a backlog item
 - `assist backlog web [-p, --port <number>]` - Start a web view of the backlog (default port 3000)
 - `assist roam auth` - Authenticate with Roam via OAuth (opens browser, saves tokens to ~/.assist.yml)
-- `assist run <name>` - Run a configured command from assist.yml
+- `assist run <name> [params...]` - Run a configured command from assist.yml (positional params are matched to `params` config)
 - `assist run add` - Add a new run configuration to assist.yml and create a Claude command file
 - `assist config set <key> <value>` - Set a config value (e.g. commit.push true)
 - `assist config get <key>` - Get a config value

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.99.0",
+  version: "0.100.1",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -99,10 +99,17 @@ function loadRawYaml(path35) {
 
 // src/shared/types.ts
 import { z } from "zod";
+var runParamSchema = z.strictObject({
+  name: z.string(),
+  required: z.boolean().optional(),
+  default: z.string().optional(),
+  description: z.string().optional()
+});
 var runConfigSchema = z.strictObject({
   name: z.string(),
   command: z.string(),
   args: z.array(z.string()).optional(),
+  params: z.array(runParamSchema).optional(),
   env: z.record(z.string(), z.string()).optional(),
   filter: z.string().optional()
 });
@@ -6727,6 +6734,30 @@ function registerRoam(program2) {
 // src/commands/run/index.ts
 import { spawn as spawn5 } from "child_process";
 
+// src/commands/run/resolveParams.ts
+function resolveParams(params, cliArgs) {
+  if (!params || params.length === 0) return cliArgs;
+  const resolved = [];
+  const missing = [];
+  for (let i = 0; i < params.length; i++) {
+    const param = params[i];
+    const value = cliArgs[i] ?? param.default;
+    if (value !== void 0) {
+      resolved.push(value);
+    } else if (param.required) {
+      missing.push(param.name);
+    }
+  }
+  if (missing.length > 0) {
+    const s = missing.length > 1 ? "s" : "";
+    const names = missing.map((n) => `"${n}"`).join(", ");
+    console.error(`Missing required param${s}: ${names}`);
+    process.exit(1);
+  }
+  resolved.push(...cliArgs.slice(params.length));
+  return resolved;
+}
+
 // src/commands/run/add.ts
 import { mkdirSync as mkdirSync11, writeFileSync as writeFileSync22 } from "fs";
 import { join as join30 } from "path";
@@ -6855,8 +6886,9 @@ function listRunConfigs() {
 }
 function run2(name, args) {
   const runConfig = findRunConfig(name);
+  const resolved = resolveParams(runConfig.params, args);
   spawnCommand2(
-    buildCommand(runConfig.command, runConfig.args ?? [], args),
+    buildCommand(runConfig.command, runConfig.args ?? [], resolved),
     runConfig.env
   );
 }
@@ -7034,7 +7066,10 @@ var runCommand = program.command("run").description("Run a configured command fr
   run2(name, args);
 });
 runCommand.command("list").description("List configured run commands").action(listRunConfigs);
-runCommand.command("add").description("Add a new run configuration to assist.yml").allowUnknownOption().allowExcessArguments().action(() => add2());
+runCommand.command("add").description("Add a new run configuration to assist.yml").argument("<name>", "Name for the run configuration").argument("<command>", "Command to execute").argument("[args...]", "Static args to pass to the command").addHelpText(
+  "after",
+  '\nPositional params can be added to the config manually:\n  params:\n    - name: env        # assist run deploy prod \u2192 appends "prod"\n      required: true\n    - name: tag\n      default: latest'
+).allowUnknownOption().allowExcessArguments().action(() => add2());
 registerNew(program);
 var lintCommand = program.command("lint").description("Run lint checks for conventions not enforced by biomejs").action(lint);
 lintCommand.command("init").description("Initialize Biome with standard linter config").action(init);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@staff0rd/assist",
-	"version": "0.99.0",
+	"version": "0.100.1",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {