@impulselab/directory 2.7.4 → 2.7.5

package/README.md

@@ -38,16 +38,16 @@ If the remote version changed first, `push` keeps your file and asks you to sync
 
 | Command | Description |
 | --- | --- |
-| `impulse login [--key <key>] [--url <baseUrl>]` | Browser device-flow login; `--key` is the headless/CI fallback |
-| `impulse logout` | Remove the saved API key |
-| `impulse whoami` | Show the authenticated user |
-| `impulse sync [--project] [--prune] [--force] [--dry-run] [--json]` | Install or update synced artifacts |
-| `impulse status [--project] [--json]` | Show synced, modified, outdated and missing files |
-| `impulse push <path> [-m <changelog>]` | Publish a local edit as a new artifact version |
-| `impulse add <owner/slug> [--target <target>]` | Public install without lock tracking; interactive picker in a TTY |
-| `impulse add stack <id> [--target <target>]` | One-shot public stack install |
-| `impulse agents` | List enabled agents |
-| `impulse agents enable\|disable <claude\|codex\|cursor>` | Update agent targets |
+| `npx @impulselab/directory login [--key <key>] [--url <baseUrl>]` | Browser device-flow login; `--key` is the headless/CI fallback |
+| `npx @impulselab/directory logout` | Remove the saved API key |
+| `npx @impulselab/directory whoami` | Show the authenticated user |
+| `npx @impulselab/directory sync [--project] [--prune] [--force] [--dry-run] [--json]` | Install or update synced artifacts |
+| `npx @impulselab/directory status [--project] [--json]` | Show synced, modified, outdated and missing files |
+| `npx @impulselab/directory push <path> [-m <changelog>]` | Publish a local edit as a new artifact version |
+| `npx @impulselab/directory add <owner/slug> [--target <target>]` | Public install without lock tracking; interactive picker in a TTY |
+| `npx @impulselab/directory add stack <id> [--target <target>]` | One-shot public stack install |
+| `npx @impulselab/directory agents` | List enabled agents |
+| `npx @impulselab/directory agents enable\|disable <claude\|codex\|cursor>` | Update agent targets |
 
 ## Installing an artifact
 
@@ -71,9 +71,9 @@ npx @impulselab/directory <owner>/<slug> --target claude-slash
 The picker is skipped automatically when stdin/stdout is not a TTY, when `--target`
 is set, or when `CI` is set. Legacy
 `npx @impulselab/directory user/slug --target claude-slash` still works and is
-treated as `impulse add user/slug`.
+treated as `npx @impulselab/directory add user/slug`.
 
-> Note: `impulse add stack <id>` installs are non-interactive and use each
+> Note: `npx @impulselab/directory add stack <id>` installs are non-interactive and use each
 > artifact's per-target default for now.
 
 ## Target Mapping
@@ -85,4 +85,4 @@ treated as `impulse add user/slug`.
 | `agent` | `~/.claude/agents/<slug>.md` | `.claude/agents/<slug>.md` | - | - |
 | `rule` | - | - | - | `.cursor/rules/<slug>.mdc` |
 
-Global sync covers Claude Code and Claude Cowork because both read `~/.claude`. Codex slash commands sync to `~/.codex/prompts`. Cursor artifacts are project-scoped, so run `impulse sync --project` from inside the project.
+Global sync covers Claude Code and Claude Cowork because both read `~/.claude`. Codex slash commands sync to `~/.codex/prompts`. Cursor artifacts are project-scoped, so run `npx @impulselab/directory sync --project` from inside the project.

package/dist/index.js

@@ -151,6 +151,12 @@ function resolveInstallPaths(kind, slug, agents2, scope) {
 // src/commands/add.ts
 import pc from "picocolors";
 
+// src/lib/cli-invocation.ts
+var cliInvocation = "npx @impulselab/directory";
+function cliCommand(args) {
+  return `${cliInvocation} ${args}`;
+}
+
 // src/lib/config.ts
 import { chmod, mkdir, readFile, rename, writeFile } from "fs/promises";
 import { homedir } from "os";
@@ -326,13 +332,13 @@ async function readPayload(response) {
 }
 function errorMessage(status, payload) {
   if (status === 401) {
-    return "Invalid or missing API key - run `impulse login`";
+    return `Invalid or missing API key - run \`${cliCommand("login")}\``;
   }
   if (status === 403) {
     return "You do not have permission to perform this action";
   }
   if (status === 409 && isObject(payload) && payload.error === "version_conflict") {
-    return `Remote is at v${payload.currentVersion}, run \`impulse sync\` first (your file is kept)`;
+    return `Remote is at v${payload.currentVersion}, run \`${cliCommand("sync")}\` first (your file is kept)`;
   }
   if (status === 422) {
     return "The server rejected the request as invalid";
@@ -431,7 +437,11 @@ async function addCommand(identifier, options) {
     }
     return;
   }
-  throw new Error("Use `impulse add <owner/slug>` or `impulse add stack <id>`");
+  throw new Error(
+    `Use \`${cliCommand("add <owner/slug>")}\` or \`${cliCommand(
+      "add stack <id>"
+    )}\``
+  );
 }
 function shouldRunInteractive(options) {
   return Boolean(
@@ -755,19 +765,21 @@ async function pollForToken(baseUrl, device) {
     }
     if (errorCode === "access_denied") {
       throw new Error(
-        "Authorization was denied. Run `impulse login` to retry."
+        `Authorization was denied. Run \`${cliCommand("login")}\` to retry.`
       );
     }
     if (errorCode === "expired_token") {
       throw new Error(
-        "The code expired. Run `impulse login` to get a new one."
+        `The code expired. Run \`${cliCommand("login")}\` to get a new one.`
       );
     }
     throw new Error(
       errorDescription(payload) ?? `Device login failed (${errorCode})`
     );
   }
-  throw new Error("The code expired. Run `impulse login` to get a new one.");
+  throw new Error(
+    `The code expired. Run \`${cliCommand("login")}\` to get a new one.`
+  );
 }
 async function createApiKey(baseUrl, accessToken) {
   const { status, payload } = await authRequest(baseUrl, "/api-key/create", {
@@ -926,7 +938,9 @@ function isNotFound2(error) {
 async function pushCommand(filePath, options) {
   const config = await loadConfig();
   if (!config.apiKey) {
-    throw new Error("Invalid or missing API key - run `impulse login`");
+    throw new Error(
+      `Invalid or missing API key - run \`${cliCommand("login")}\``
+    );
   }
   const absPath = path5.resolve(filePath);
   const match = await findLockedFile(absPath);
@@ -1329,7 +1343,9 @@ function prefixForAction(type) {
 async function statusCommand(options) {
   const config = await loadConfig();
   if (!config.apiKey) {
-    throw new Error("Invalid or missing API key - run `impulse login`");
+    throw new Error(
+      `Invalid or missing API key - run \`${cliCommand("login")}\``
+    );
   }
   const scope = options.project ? "project" : "global";
   const scopeRoot = options.project ? await resolveProjectRoot() : homedir6();
@@ -1396,7 +1412,9 @@ import pc7 from "picocolors";
 async function syncCommand(options) {
   const config = await loadConfig();
   if (!config.apiKey) {
-    throw new Error("Invalid or missing API key - run `impulse login`");
+    throw new Error(
+      `Invalid or missing API key - run \`${cliCommand("login")}\``
+    );
   }
   const scope = options.project ? "project" : "global";
   const scopeRoot = options.project ? await resolveProjectRoot() : homedir7();
@@ -1450,7 +1468,9 @@ async function syncCommand(options) {
   }
   if (skipped.length > 0) {
     console.info(
-      "Run `impulse push <path>` to publish, or `impulse sync --force`."
+      `Run \`${cliCommand("push <path>")}\` to publish, or \`${cliCommand(
+        "sync --force"
+      )}\`.`
     );
   }
   const conflicts = actions.filter((action) => action.type === "skip-conflict");
@@ -1513,7 +1533,7 @@ import pc8 from "picocolors";
 async function whoamiCommand() {
   const config = await loadConfig();
   if (!config.apiKey) {
-    throw new Error("Not logged in - run `impulse login`");
+    throw new Error(`Not logged in - run \`${cliCommand("login")}\``);
   }
   const me = await createApiClient(config.baseUrl, config.apiKey).me();
   console.info(`${pc8.green("\u2713")} ${me.user.slug} <${me.user.email}>`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@impulselab/directory",
-  "version": "2.7.4",
+  "version": "2.7.5",
   "description": "Sync versioned skills, commands and agent configs across Claude Code, Cursor and Codex",
   "license": "MIT",
   "type": "module",