@swmansion/argent 0.14.1-next.9 → 0.15.0

package/README.md

@@ -114,14 +114,41 @@ npm install -g @swmansion/argent
 argent init
 ```
 
+#### Share Argent with your team (committable install)
+
+By default Argent installs **globally**. To version Argent _with your repo_ so every
+teammate gets the same setup on `npm install` — no per-developer global install, no
+`argent init` — choose the local mode:
+
+```bash
+npx @swmansion/argent init --local
+```
+
+This adds `@swmansion/argent` to your project's `devDependencies` and writes MCP
+configs that launch the project-local copy (`node node_modules/@swmansion/argent/dist/cli.js mcp`).
+Commit `package.json` + your lockfile, the generated MCP config (`.mcp.json`,
+`.cursor/mcp.json`, …), `.argent/install.json`, and the skills/rules/agents files.
+Teammates then just run `npm install`.
+
+Pass `--global` to force the default mode in scripts; `--local` and `--global` are
+mutually exclusive. A non-interactive (`--yes`) run defaults to global unless the
+project already opted into local mode (a committed `.argent/install.json`, or
+`@swmansion/argent` declared in the project's own `package.json`).
+
+> In local mode the committed MCP config runs the project-local copy, so the bare
+> `argent` command is **not** on teammates' `PATH`. Note that `npm install` builds
+> Argent's native deps (`tree-sitter`) on each machine — prebuilt for macOS, Linux
+> x64, and Windows x64; other targets (Linux arm64, Windows arm) compile from source
+> and need a C/C++ toolchain.
+
 ## CLI Reference
 
 | Command            | Description                                                                                                                                                                                               |
 | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `argent init`      | Install globally and configure MCP in the current workspace                                                                                                                                               |
+| `argent init`      | Install and configure MCP in the current workspace (`--global` default, `--local` for a committable devDependency)                                                                                        |
 | `argent install`   | Alias for `init` command                                                                                                                                                                                  |
-| `argent update`    | Pull the latest version and refresh workspace configuration                                                                                                                                               |
-| `argent remove`    | Unregister the MCP server and uninstall the package                                                                                                                                                       |
+| `argent update`    | Pull the latest version and refresh workspace configuration (acts on the present install — both when a global install and a project devDependency coexist; `--global`/`--local` select explicitly)        |
+| `argent remove`    | Unregister the MCP server and uninstall the package (`--global`/`--local` choose which install — and its configs — is removed; non-interactive runs never remove a coexisting global install)             |
 | `argent uninstall` | Alias for `remove` command                                                                                                                                                                                |
 | `argent mcp`       | Start MCP server instance, used internally by agent                                                                                                                                                       |
 | `argent tools`     | List tools exposed by the tool-server (`describe <name>` for details)                                                                                                                                     |
@@ -133,7 +160,7 @@ argent init
 | `argent enable`    | Enable a predefined feature flag (`--scope project` for project-local)                                                                                                                                    |
 | `argent disable`   | Disable a feature flag (`--scope project` for project-local)                                                                                                                                              |
 | `argent flags`     | List available feature flags and their state                                                                                                                                                              |
-| `argent telemetry` | Manage anonymous telemetry: `status` / `enable` / `disable`                                                                                                                                               |
+| `argent telemetry` | Manage telemetry: `status` / `enable` / `disable`                                                                                                                                                         |
 
 ## Supported Editors
 
@@ -154,7 +181,7 @@ argent init
 
 ## Privacy
 
-Argent collects anonymous, opt-out usage and diagnostic telemetry to help us prioritise features and fix what breaks. It is minimal by design.
+Argent collects opt-out usage and diagnostic telemetry to help us prioritise features and fix what breaks.
 
 You can opt out at any time:
 

package/dist/bundled-paths.d.ts

@@ -1,2 +1,3 @@
 import type { ToolsServerPaths } from "@argent/tools-client";
+export declare function findStablePackageDir(startDir: string, packageRoot: string): string | undefined;
 export declare const BUNDLED_RUNTIME_PATHS: ToolsServerPaths;

package/dist/bundled-paths.js

@@ -1,9 +1,140 @@
+import * as fs from "node:fs";
 import * as path from "node:path";
-// __dirname in ESM (compiled from TS) will be dist/.
-// Bundle artifacts ship next to the compiled launcher.
+// Installed package version, read from the shipped package.json. Lets the
+// launcher detect a stale tool-server after an in-place version bump (a local
+// devDependency update rewrites tool-server.cjs at the same path) and respawn
+// it — without relying on the postinstall script, which is frequently disabled
+// (--ignore-scripts, pnpm onlyBuiltDependencies, Yarn PnP, locked-down CI).
+function readPackageVersion() {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(import.meta.dirname, "..", "package.json"), "utf8"));
+        return pkg.version;
+    }
+    catch {
+        return undefined;
+    }
+}
+const PACKAGE_NAME = "@swmansion/argent";
+// The project a local install belongs to: the nearest ancestor of cwd that
+// DECLARES the package (any dependency field, matching the installer's
+// readManifestDeclaration) or carries a committed .argent/install.json. Can
+// sit BELOW the physical hoist root — npm workspaces hoist a member's
+// devDependency, but update/uninstall must act on the declaring member.
+function findDeclaringRoot(startDir) {
+    let dir = startDir;
+    for (;;) {
+        if (fs.existsSync(path.join(dir, ".argent", "install.json")))
+            return dir;
+        try {
+            const manifest = JSON.parse(fs.readFileSync(path.join(dir, "package.json"), "utf8"));
+            if (manifest.devDependencies?.[PACKAGE_NAME] ||
+                manifest.dependencies?.[PACKAGE_NAME] ||
+                manifest.optionalDependencies?.[PACKAGE_NAME]) {
+                return dir;
+            }
+        }
+        catch {
+            // no/unreadable manifest at this level — keep walking up
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+// The version-STABLE package dir: the conventional <dir>/node_modules/<pkg>
+// symlink closest to cwd that resolves to the running package. Unlike
+// import.meta's realpath — pnpm's version-pinned .pnpm store dir, pruned on a
+// bump — this symlink survives an in-place update. In a pnpm WORKSPACE the
+// symlink sits in the DECLARING member's node_modules, a level below the root
+// where the .pnpm store lives, so scan every level from cwd up rather than
+// only the level where the store matched. Only ever returns a path whose
+// realpath equals the running package, so it can never point at a different
+// install — just a different (stable) alias of the same real dir.
+export function findStablePackageDir(startDir, packageRoot) {
+    let dir = startDir;
+    for (;;) {
+        const candidate = path.join(dir, "node_modules", PACKAGE_NAME);
+        try {
+            if (fs.realpathSync(candidate) === packageRoot)
+                return candidate;
+        }
+        catch {
+            // no symlink at this level — keep walking up
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+// Install topology of this running package: a project's local devDependency
+// (package root inside a node_modules found by walking up from cwd) or the
+// global PATH install — and, for local, WHICH project. Classified at process
+// start, the moment cwd is trustworthy (a committed local MCP command only
+// resolves with cwd at the project root); the launcher forwards both as
+// ARGENT_INSTALL_KIND / ARGENT_PROJECT_ROOT so update-argent doesn't re-infer
+// them from the detached server's editor-chosen cwd.
+function classifyInstall() {
+    let packageRoot;
+    let dir;
+    let cwd;
+    try {
+        packageRoot = fs.realpathSync(path.join(import.meta.dirname, ".."));
+        // cwd can throw (ENOENT) when the shell's directory was deleted — and this
+        // runs at module import, before any fatal handler is installed.
+        cwd = process.cwd();
+        dir = cwd;
+    }
+    catch {
+        return { kind: "global" };
+    }
+    for (;;) {
+        try {
+            const nmReal = fs.realpathSync(path.join(dir, "node_modules"));
+            if (packageRoot === nmReal || packageRoot.startsWith(nmReal + path.sep)) {
+                // Local install. Prefer the DECLARING root over this physical hoist
+                // root: in a hoisted workspace the declaring manifest sits at cwd
+                // (the member root) or an ancestor below `dir`. The version-stable
+                // package dir (used for runtime paths that must survive a pnpm store
+                // prune) is found by its own cwd-up scan — see findStablePackageDir.
+                return {
+                    kind: "local",
+                    projectRoot: findDeclaringRoot(cwd) ?? dir,
+                    stablePackageDir: findStablePackageDir(cwd, packageRoot),
+                };
+            }
+        }
+        catch {
+            // no node_modules at this level — keep walking up
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Yarn PnP local installs have no node_modules anywhere: the package runs
+    // from the project's .yarn dir (unplugged/cache). Falling through to
+    // "global" would make the agent-triggered update target a global install
+    // the user may not even have.
+    if (packageRoot.includes(`${path.sep}.yarn${path.sep}`)) {
+        const declRoot = findDeclaringRoot(cwd);
+        if (declRoot)
+            return { kind: "local", projectRoot: declRoot };
+    }
+    return { kind: "global" };
+}
+const classifiedInstall = classifyInstall();
+// __dirname in ESM (compiled from TS) will be dist/. Bundle artifacts ship
+// next to the compiled launcher; prefer the version-stable package dir when
+// the classification found one (see classifyInstall).
+const packageDir = classifiedInstall.stablePackageDir ?? path.join(import.meta.dirname, "..");
 export const BUNDLED_RUNTIME_PATHS = {
-    bundlePath: path.join(import.meta.dirname, "tool-server.cjs"),
-    simulatorServerDir: path.join(import.meta.dirname, "..", "bin"),
-    nativeDevtoolsDir: path.join(import.meta.dirname, "..", "dylibs"),
+    bundlePath: path.join(packageDir, "dist", "tool-server.cjs"),
+    simulatorServerDir: path.join(packageDir, "bin"),
+    nativeDevtoolsDir: path.join(packageDir, "dylibs"),
+    version: readPackageVersion(),
+    installKind: classifiedInstall.kind,
+    installProjectRoot: classifiedInstall.projectRoot,
 };
 //# sourceMappingURL=bundled-paths.js.map

package/dist/bundled-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundled-paths.js","sourceRoot":"","sources":["../src/bundled-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,qDAAqD;AACrD,uDAAuD;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAqB;IACrD,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC;IAC7D,kBAAkB,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC;IAC/D,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC;CAClE,CAAC"}
+{"version":3,"file":"bundled-paths.js","sourceRoot":"","sources":["../src/bundled-paths.ts"],"names":[],"mappings":"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"}