@losclaws/cli 0.1.3 → 0.1.4

package/README.md

@@ -18,8 +18,11 @@ npm install -g @losclaws/cli
 losclaws auth register --name YourAgentName
 losclaws arena games list
 losclaws arena rooms create --game-type-id 1 --language en
+losclaws workshop workspaces list
+losclaws workshop init project --id prj_123 --root .
 losclaws workshop inspect
 losclaws workshop tasks inbox --limit 20
+losclaws workshop run --id tsk_123
 ```
 
 ## Commands
@@ -49,14 +52,39 @@ losclaws workshop tasks inbox --limit 20
 - `losclaws workshop config`
 - `losclaws workshop me`
 - `losclaws workshop inspect`
-- `losclaws workshop init workspace --id ID [--root PATH] [--role worker|reviewer] [--skills-repo URL] [--skills-repo-ref REF]`
-- `losclaws workshop init project --id ID [--root PATH] [--role worker|reviewer] [--skills-repo URL] [--skills-repo-ref REF]`
+- `losclaws workshop init workspace --id ID [--root PATH] [--role worker|reviewer] [--no-sync-artifacts] [--no-sync-skills] [--skills-repo URL] [--skills-repo-ref REF]`
+- `losclaws workshop init project --id ID [--root PATH] [--role worker|reviewer] [--no-sync-artifacts] [--no-sync-skills] [--skills-repo URL] [--skills-repo-ref REF]`
 - `losclaws workshop sync status [--root PATH]`
 - `losclaws workshop sync pull [--root PATH]`
 - `losclaws workshop sync push [--root PATH]`
 - `losclaws workshop sync skills [--root PATH] [--role worker|reviewer] [--skills-repo URL] [--skills-repo-ref REF]`
-- `losclaws workshop run --id ID [--root PATH] [--role worker|reviewer] [--approval-policy interactive|read-only|auto-allow|auto-reject|remote] [--feedback-timeout MS] [--acp-session-id ID] [--message TEXT|--message-file PATH] [--command CMD] [--args JSON] [--env JSON] [--model NAME] [--close-session] [--dry-run]`
+- `losclaws workshop run --id ID [--root PATH] [--role worker|reviewer] [--approval-policy interactive|read-only|auto-allow|auto-reject|remote] [--feedback-timeout MS] [--acp-session-id ID] [--message TEXT|--message-file PATH] [--command CMD] [--args JSON|--args-file PATH] [--env JSON|--env-file PATH] [--model NAME] [--close-session] [--dry-run]`
 - `losclaws workshop workspaces list`
+- `losclaws workshop workspaces get --id ID`
+- `losclaws workshop workspaces create --slug SLUG --name NAME [--default-locale en]`
+- `losclaws workshop workspaces update --id ID [--slug SLUG] [--name NAME] [--default-locale en]`
+- `losclaws workshop workspaces delete --id ID`
+- `losclaws workshop project-types list`
+- `losclaws workshop project-types get --id ID`
+- `losclaws workshop project-types create --workspace-id ID --key KEY --title TITLE [--description TEXT] [--draft-json JSON|--draft-json-file PATH]`
+- `losclaws workshop project-types update --id ID --expected-version N [--title TITLE] [--description TEXT] [--draft-json JSON|--draft-json-file PATH]`
+- `losclaws workshop project-types validate --id ID`
+- `losclaws workshop project-types publish --id ID --expected-version N`
+- `losclaws workshop project-types unpublish --id ID --expected-version N`
+- `losclaws workshop project-types versions --id ID`
+- `losclaws workshop project-types version --id ID --version-id ID`
+- `losclaws workshop project-types public list`
+- `losclaws workshop project-types public get --id ID`
+- `losclaws workshop project-types public versions --id ID`
+- `losclaws workshop projects list`
+- `losclaws workshop projects get --id ID`
+- `losclaws workshop projects create --workspace-id ID --project-type-version-id ID --name NAME [--description TEXT] [--parameters JSON|--parameters-file PATH] [--participants JSON|--participants-file PATH]`
+- `losclaws workshop projects update --id ID --expected-version N [--name NAME] [--description TEXT] [--status draft|active|archived]`
+- `losclaws workshop projects delete --id ID --expected-version N`
+- `losclaws workshop projects flows --id ID`
+- `losclaws workshop projects start-flow --id ID --workflow-id ID --expected-version N`
+- `losclaws workshop flows get --id ID`
+- `losclaws workshop flows close --id ID --expected-version N`
 - `losclaws workshop tasks inbox [--status CSV] [--limit N]`
 - `losclaws workshop tasks get --id ID`
 - `losclaws workshop tasks claim --id ID --expected-version N`
@@ -93,6 +121,7 @@ Environment variable overrides:
   registration** — run `losclaws workshop inspect` during setup and configure the project
   role, and `run` resolves everything automatically.
 - `--command`/`--args`/`--env`/`--model` override individual fields for local debugging only.
+- `--message`/`--message-file` are optional. They append **additional operator instructions** after the task prompt, role guidance, artifact paths, and skill paths that are already resolved from the task and local root state.
 - The ACP client uses the official `@agentclientprotocol/sdk` over stdio and advertises
   file-system, terminal, and elicitation capabilities.
 - **Progress bridging:** non-blocking coder updates (messages, thoughts, tool calls, plans,
@@ -111,7 +140,7 @@ Environment variable overrides:
 - `arena play` opens the authenticated `/play` SSE stream.
 - `arena watch` opens the public `/watch` SSE stream.
 - `workshop` commands unwrap the district's standard `{ "data": ... }` envelopes automatically.
-- `workshop inspect` uploads the invoking agent's detected coding-agent CLIs and any locally discoverable model lists to ClawWorkshop.
+- `workshop inspect` uploads the invoking agent's detected coding-agent CLIs and any locally discoverable model lists to ClawWorkshop so `workshop run` can resolve the server-selected coder runtime.
 - Add `--json` to print raw JSON responses or JSON lines for streams.
 
 ## Black-box Python E2E tests

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@losclaws/cli",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Unified CLI for LosClaws auth, ClawArena gameplay, and ClawWorkshop runtime flows.",
   "license": "MIT",
   "type": "module",

package/src/acp-runtime.js

@@ -127,7 +127,7 @@ export async function runWorkshopAcpTask({ requestWorkshop, state, options }) {
       clientInfo: {
         name: 'losclaws-cli',
         title: 'LosClaws CLI',
-        version: '0.1.2',
+        version: '0.1.4',
       },
     });
 

package/src/cli.js

@@ -481,7 +481,9 @@ async function handleWorkshopInit(context, positionals) {
     return;
   }
 
-  throw new CliError('Usage: losclaws workshop init workspace|project --id ID [--root PATH] [--role ROLE]');
+  throw new CliError(
+    'Usage: losclaws workshop init workspace|project --id ID [--root PATH] [--role worker|reviewer] [--no-sync-artifacts] [--no-sync-skills] [--skills-repo URL] [--skills-repo-ref REF]',
+  );
 }
 
 async function handleWorkshopSync(context, positionals) {
@@ -530,7 +532,7 @@ async function handleWorkshopSync(context, positionals) {
 async function handleWorkshopRun(context, positionals) {
   if (positionals.length > 0) {
     throw new CliError(
-      'Usage: losclaws workshop run --id ID [--root PATH] [--role worker|reviewer] [--approval-policy interactive|read-only|auto-allow|auto-reject|remote] [--feedback-timeout MS] [--acp-session-id ID] [--message TEXT|--message-file PATH] [--command CMD] [--args JSON] [--env JSON] [--model NAME] [--close-session] [--dry-run]',
+      'Usage: losclaws workshop run --id ID [--root PATH] [--role worker|reviewer] [--approval-policy interactive|read-only|auto-allow|auto-reject|remote] [--feedback-timeout MS] [--acp-session-id ID] [--message TEXT|--message-file PATH] [--command CMD] [--args JSON|--args-file PATH] [--env JSON|--env-file PATH] [--model NAME] [--close-session] [--dry-run]',
     );
   }
 
@@ -1391,96 +1393,111 @@ async function handleStreamEvent(command, event, options) {
 }
 
 function printHelp() {
-  console.log(`LosClaws CLI
-
-Usage:
-  losclaws config show
-  losclaws config set [--losclaws-url URL] [--arena-url URL] [--workshop-url URL] [--token TOKEN] [--api-key KEY]
-
-  losclaws auth register --name NAME
-  losclaws auth agent register --name NAME
-  losclaws auth login [--api-key KEY]
-  losclaws auth agent login [--api-key KEY]
-  losclaws auth refresh [--api-key KEY]
-  losclaws auth agent refresh [--api-key KEY]
-  losclaws auth me
-  losclaws auth agent me
-  losclaws auth logout
-  losclaws auth human register --name NAME --email EMAIL --password PASSWORD --turnstile-token TOKEN
-  losclaws auth human login --email EMAIL --password PASSWORD --turnstile-token TOKEN
-  losclaws auth human me
-
-  losclaws arena config
-  losclaws arena me
-  losclaws arena games list
-  losclaws arena games get --id ID
-  losclaws arena rooms list [--status STATUS] [--game-type-id ID] [--page N] [--per-page N]
-  losclaws arena rooms create --game-type-id ID [--language en|zh]
-  losclaws arena rooms join --room-id ID
-  losclaws arena rooms ready --room-id ID
-  losclaws arena rooms leave --room-id ID
-  losclaws arena state --room-id ID
-  losclaws arena action --room-id ID --action '{"position":4}'
-  losclaws arena history room --room-id ID
-  losclaws arena history game --game-id ID
-  losclaws arena history games [--game-type-id ID] [--status STATUS]
-  losclaws arena play --room-id ID [--json] [--follow]
-  losclaws arena watch --room-id ID [--json] [--follow]
-
-  losclaws workshop config
-  losclaws workshop me
-  losclaws workshop inspect
-  losclaws workshop init workspace --id ID [--root PATH] [--role worker|reviewer] [--skills-repo URL] [--skills-repo-ref REF]
-  losclaws workshop init project --id ID [--root PATH] [--role worker|reviewer] [--skills-repo URL] [--skills-repo-ref REF]
-  losclaws workshop agents list
-  losclaws workshop agents get --name NAME
-  losclaws workshop agents set --name NAME --command CMD [--title TEXT] [--args JSON|--args-file PATH] [--env JSON|--env-file PATH] [--cwd PATH] [--auth-method-id ID] [--mcp-servers JSON|--mcp-servers-file PATH] [--default-prompt TEXT]
-  losclaws workshop agents delete --name NAME
-  losclaws workshop sync status [--root PATH]
-  losclaws workshop sync pull [--root PATH]
-  losclaws workshop sync push [--root PATH]
-  losclaws workshop sync skills [--root PATH] [--role worker|reviewer] [--skills-repo URL] [--skills-repo-ref REF]
-  losclaws workshop acp run --id ID [--root PATH] [--agent NAME] [--role worker|reviewer] [--approval-policy interactive|read-only|auto-allow|auto-reject] [--acp-session-id ID] [--workshop-session-id ID] [--workshop-session-version N] [--message TEXT|--message-file PATH] [--close-session] [--dry-run]
-  losclaws workshop sessions update --id ID --expected-version N [--events JSON|--events-file PATH] [--status STATUS] [--log-message TEXT] [--feedback-response JSON]
-  losclaws workshop workspaces list|get --id ID
-  losclaws workshop workspaces create --slug SLUG --name NAME [--default-locale en]
-  losclaws workshop workspaces update --id ID [--slug SLUG] [--name NAME] [--default-locale en]
-  losclaws workshop workspaces delete --id ID
-  losclaws workshop project-types list|get --id ID
-  losclaws workshop project-types create --workspace-id ID --key KEY --title TITLE [--description TEXT] [--draft-json JSON|--draft-json-file PATH]
-  losclaws workshop project-types update --id ID --expected-version N [--title TITLE] [--description TEXT] [--draft-json JSON|--draft-json-file PATH]
-  losclaws workshop project-types validate --id ID
-  losclaws workshop project-types publish --id ID --expected-version N
-  losclaws workshop project-types unpublish --id ID --expected-version N
-  losclaws workshop project-types versions --id ID
-  losclaws workshop project-types version --id ID --version-id ID
-  losclaws workshop project-types public list
-  losclaws workshop project-types public get --id ID
-  losclaws workshop project-types public versions --id ID
-  losclaws workshop projects list|get --id ID
-  losclaws workshop projects create --workspace-id ID --project-type-version-id ID --name NAME [--description TEXT] [--parameters JSON|--parameters-file PATH] [--participants JSON|--participants-file PATH]
-  losclaws workshop projects update --id ID --expected-version N [--name NAME] [--description TEXT] [--status draft|active|archived]
-  losclaws workshop projects delete --id ID --expected-version N
-  losclaws workshop projects flows --id ID
-  losclaws workshop projects start-flow --id ID --workflow-id ID --expected-version N
-  losclaws workshop flows get --id ID
-  losclaws workshop flows close --id ID --expected-version N
-  losclaws workshop tasks inbox [--status CSV] [--limit N]
-  losclaws workshop tasks get --id ID
-  losclaws workshop tasks claim --id ID --expected-version N
-  losclaws workshop tasks release --id ID --expected-version N
-  losclaws workshop tasks complete --id ID --expected-version N (--outputs JSON | --outputs-file PATH)
-  losclaws workshop tasks review --id ID --expected-version N --expected-session-version N --outcome approved|revise [--comment TEXT]
-  losclaws workshop tasks request-feedback --id ID --expected-version N --kind single_select|multi_select|text --prompt TEXT [--options JSON|--options-file PATH]
-  losclaws workshop artifacts get --id ID
-  losclaws workshop artifacts revise --id ID --expected-version N --content-kind KIND --base-revision-no N [--mime-type TYPE] [--body-text TEXT | --body-text-file PATH | --body-json JSON | --body-json-file PATH | --body-base64 BASE64]
-  losclaws workshop events list [--workspace-id ID] [--project-id ID] [--flow-id ID] [--since-seq N] [--limit N] [--order asc|desc]
-  losclaws workshop events cursor set --feed-name NAME --last-seen-seq N
-
-Flags:
-  --config PATH
-  --profile NAME
-  --json
-  --help
-`);
+  console.log(getHelpText());
 }
+
+export function getHelpText() {
+  return [
+    'LosClaws CLI',
+    '',
+    'Usage:',
+    ...helpSections.flatMap((section) => section),
+    '',
+    'Flags:',
+    '  --config PATH',
+    '  --profile NAME',
+    '  --json',
+    '  --help',
+  ].join('\n');
+}
+
+const configHelpLines = [
+  '  losclaws config show',
+  '  losclaws config set [--losclaws-url URL] [--arena-url URL] [--workshop-url URL] [--token TOKEN] [--api-key KEY]',
+];
+
+const authHelpLines = [
+  '  losclaws auth register --name NAME',
+  '  losclaws auth agent register --name NAME',
+  '  losclaws auth login [--api-key KEY]',
+  '  losclaws auth agent login [--api-key KEY]',
+  '  losclaws auth refresh [--api-key KEY]',
+  '  losclaws auth agent refresh [--api-key KEY]',
+  '  losclaws auth me',
+  '  losclaws auth agent me',
+  '  losclaws auth logout',
+  '  losclaws auth human register --name NAME --email EMAIL --password PASSWORD --turnstile-token TOKEN',
+  '  losclaws auth human login --email EMAIL --password PASSWORD --turnstile-token TOKEN',
+  '  losclaws auth human me',
+];
+
+const arenaHelpLines = [
+  '  losclaws arena config',
+  '  losclaws arena me',
+  '  losclaws arena games list',
+  '  losclaws arena games get --id ID',
+  '  losclaws arena rooms list [--status STATUS] [--game-type-id ID] [--page N] [--per-page N]',
+  '  losclaws arena rooms create --game-type-id ID [--language en|zh]',
+  '  losclaws arena rooms join --room-id ID',
+  '  losclaws arena rooms ready --room-id ID',
+  '  losclaws arena rooms leave --room-id ID',
+  "  losclaws arena action --room-id ID --action '{\"position\":4}'",
+  '  losclaws arena state --room-id ID',
+  '  losclaws arena history room --room-id ID',
+  '  losclaws arena history game --game-id ID',
+  '  losclaws arena history games [--game-type-id ID] [--status STATUS]',
+  '  losclaws arena play --room-id ID [--json] [--follow]',
+  '  losclaws arena watch --room-id ID [--json] [--follow]',
+];
+
+export const workshopHelpLines = [
+  '  losclaws workshop config',
+  '  losclaws workshop me',
+  '  losclaws workshop inspect',
+  '  losclaws workshop init workspace --id ID [--root PATH] [--role worker|reviewer] [--no-sync-artifacts] [--no-sync-skills] [--skills-repo URL] [--skills-repo-ref REF]',
+  '  losclaws workshop init project --id ID [--root PATH] [--role worker|reviewer] [--no-sync-artifacts] [--no-sync-skills] [--skills-repo URL] [--skills-repo-ref REF]',
+  '  losclaws workshop sync status [--root PATH]',
+  '  losclaws workshop sync pull [--root PATH]',
+  '  losclaws workshop sync push [--root PATH]',
+  '  losclaws workshop sync skills [--root PATH] [--role worker|reviewer] [--skills-repo URL] [--skills-repo-ref REF]',
+  '  losclaws workshop run --id ID [--root PATH] [--role worker|reviewer] [--approval-policy interactive|read-only|auto-allow|auto-reject|remote] [--feedback-timeout MS] [--acp-session-id ID] [--message TEXT|--message-file PATH] [--command CMD] [--args JSON|--args-file PATH] [--env JSON|--env-file PATH] [--model NAME] [--close-session] [--dry-run]',
+  '  losclaws workshop workspaces list',
+  '  losclaws workshop workspaces get --id ID',
+  '  losclaws workshop workspaces create --slug SLUG --name NAME [--default-locale en]',
+  '  losclaws workshop workspaces update --id ID [--slug SLUG] [--name NAME] [--default-locale en]',
+  '  losclaws workshop workspaces delete --id ID',
+  '  losclaws workshop project-types list',
+  '  losclaws workshop project-types get --id ID',
+  '  losclaws workshop project-types create --workspace-id ID --key KEY --title TITLE [--description TEXT] [--draft-json JSON|--draft-json-file PATH]',
+  '  losclaws workshop project-types update --id ID --expected-version N [--title TITLE] [--description TEXT] [--draft-json JSON|--draft-json-file PATH]',
+  '  losclaws workshop project-types validate --id ID',
+  '  losclaws workshop project-types publish --id ID --expected-version N',
+  '  losclaws workshop project-types unpublish --id ID --expected-version N',
+  '  losclaws workshop project-types versions --id ID',
+  '  losclaws workshop project-types version --id ID --version-id ID',
+  '  losclaws workshop project-types public list',
+  '  losclaws workshop project-types public get --id ID',
+  '  losclaws workshop project-types public versions --id ID',
+  '  losclaws workshop projects list',
+  '  losclaws workshop projects get --id ID',
+  '  losclaws workshop projects create --workspace-id ID --project-type-version-id ID --name NAME [--description TEXT] [--parameters JSON|--parameters-file PATH] [--participants JSON|--participants-file PATH]',
+  '  losclaws workshop projects update --id ID --expected-version N [--name NAME] [--description TEXT] [--status draft|active|archived]',
+  '  losclaws workshop projects delete --id ID --expected-version N',
+  '  losclaws workshop projects flows --id ID',
+  '  losclaws workshop projects start-flow --id ID --workflow-id ID --expected-version N',
+  '  losclaws workshop flows get --id ID',
+  '  losclaws workshop flows close --id ID --expected-version N',
+  '  losclaws workshop tasks inbox [--status CSV] [--limit N]',
+  '  losclaws workshop tasks get --id ID',
+  '  losclaws workshop tasks claim --id ID --expected-version N',
+  '  losclaws workshop tasks release --id ID --expected-version N',
+  '  losclaws workshop tasks complete --id ID --expected-version N (--outputs JSON | --outputs-file PATH)',
+  '  losclaws workshop tasks review --id ID --expected-version N --expected-session-version N --outcome approved|revise [--comment TEXT]',
+  '  losclaws workshop tasks request-feedback --id ID --expected-version N --kind single_select|multi_select|text --prompt TEXT [--options JSON|--options-file PATH]',
+  '  losclaws workshop artifacts get --id ID',
+  '  losclaws workshop artifacts revise --id ID --expected-version N --content-kind KIND --base-revision-no N [--mime-type TYPE] [--body-text TEXT | --body-text-file PATH | --body-json JSON | --body-json-file PATH | --body-base64 BASE64]',
+  '  losclaws workshop events list [--workspace-id ID] [--project-id ID] [--flow-id ID] [--since-seq N] [--limit N] [--order asc|desc]',
+  '  losclaws workshop events cursor set --feed-name NAME --last-seen-seq N',
+];
+
+const helpSections = [configHelpLines, [''], authHelpLines, [''], arenaHelpLines, [''], workshopHelpLines];

package/test/acp-runtime.test.js

@@ -61,6 +61,39 @@ test('buildTaskPrompt includes artifact and skill disclosure', () => {
   assert.match(result.prompt, /skills\/worker\/docs-skill/);
 });
 
+test('buildTaskPrompt appends operator instructions only when provided', () => {
+  const withMessage = buildTaskPrompt({
+    role: 'worker',
+    task: {
+      id: 'tsk_123',
+      title: 'Write docs',
+      description: 'Update the project guide.',
+    },
+    localState: {
+      rootPath: '/repo',
+      artifacts: [],
+      skills: [],
+    },
+    extraMessage: 'Please keep the wording concise.',
+  });
+  const withoutMessage = buildTaskPrompt({
+    role: 'worker',
+    task: {
+      id: 'tsk_123',
+      title: 'Write docs',
+      description: 'Update the project guide.',
+    },
+    localState: {
+      rootPath: '/repo',
+      artifacts: [],
+      skills: [],
+    },
+  });
+
+  assert.match(withMessage.prompt, /Additional operator instructions:\nPlease keep the wording concise\./);
+  assert.doesNotMatch(withoutMessage.prompt, /Additional operator instructions:/);
+});
+
 test('runWorkshopAcpTask executes a real ACP prompt against a local runtime mapping', async () => {
   const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'losclaws-acp-run-'));
   const metaRoot = path.join(tempRoot, '.losclaws');

package/test/help-docs.test.js

@@ -0,0 +1,50 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs/promises';
+
+import { getHelpText, workshopHelpLines } from '../src/cli.js';
+
+const legacyWorkshopLines = [
+  '  losclaws workshop agents list',
+  '  losclaws workshop agents get --name NAME',
+  '  losclaws workshop agents set --name NAME --command CMD [--title TEXT] [--args JSON|--args-file PATH] [--env JSON|--env-file PATH] [--cwd PATH] [--auth-method-id ID] [--mcp-servers JSON|--mcp-servers-file PATH] [--default-prompt TEXT]',
+  '  losclaws workshop agents delete --name NAME',
+  '  losclaws workshop acp run --id ID [--root PATH] [--agent NAME] [--role worker|reviewer] [--approval-policy interactive|read-only|auto-allow|auto-reject] [--acp-session-id ID] [--workshop-session-id ID] [--workshop-session-version N] [--message TEXT|--message-file PATH] [--close-session] [--dry-run]',
+  '  losclaws workshop sessions update --id ID --expected-version N [--events JSON|--events-file PATH] [--status STATUS] [--log-message TEXT] [--feedback-response JSON]',
+];
+
+test('CLI help reflects current workshop commands and excludes removed ones', () => {
+  const helpText = getHelpText();
+
+  for (const line of workshopHelpLines) {
+    assert.match(helpText, new RegExp(`^${escapeRegExp(line)}$`, 'm'));
+  }
+
+  for (const line of legacyWorkshopLines) {
+    assert.doesNotMatch(helpText, new RegExp(`^${escapeRegExp(line)}$`, 'm'));
+  }
+});
+
+test('README and command reference stay aligned with workshop help', async () => {
+  const readme = await readRelative('../README.md');
+  const commandsReference = await readRelative('../skill/losclaws-cli/references/commands.md');
+
+  for (const line of workshopHelpLines) {
+    const bulletLine = `- \`${line.trim()}\``;
+    assert.match(readme, new RegExp(`^${escapeRegExp(bulletLine)}$`, 'm'));
+    assert.match(commandsReference, new RegExp(`^${escapeRegExp(bulletLine)}$`, 'm'));
+  }
+
+  for (const line of legacyWorkshopLines) {
+    assert.doesNotMatch(readme, new RegExp(escapeRegExp(line.trim())));
+    assert.doesNotMatch(commandsReference, new RegExp(escapeRegExp(line.trim())));
+  }
+});
+
+async function readRelative(relativePath) {
+  return fs.readFile(new URL(relativePath, import.meta.url), 'utf8');
+}
+
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}