opensip-cli 0.1.0

package/dist/commands/plugin/domain-resolution.d.ts

@@ -0,0 +1,38 @@
+/**
+ * plugin/domain-resolution — pure validation + routing logic for the
+ * `plugin add/remove/sync` commands.
+ *
+ * Extracted from `commands/plugin.ts` to keep that file focused on the
+ * command bodies. Everything here decides WHICH host dir / domain a spec
+ * targets — it reads package markers but performs no install. The
+ * plugin-supporting domains are NOT hardcoded: they come from the
+ * registered tools' `pluginLayout` descriptors (threaded in as
+ * `PluginLayout[]`), so the kernel stays tool-agnostic and the tools
+ * remain the single source of truth (ADR-0009 corollary 1).
+ */
+import { type PluginLayout } from '@opensip-cli/core';
+/**
+ * Pseudo-domain for full Tool plugins (whole subcommands). Distinct from
+ * the fit/sim plugin DOMAINS (which are project-committed + listed in
+ * `plugins.<domain>` config): a Tool plugin auto-discovers by its
+ * `opensipTools.kind: "tool"` marker, needs NO config entry, and installs
+ * user-global by default (`~/.opensip-cli/plugins/tool`) so the
+ * subcommand is available in every project — or project-local
+ * (`.runtime/plugins/tool`) with `--project`.
+ */
+export declare const TOOL_DOMAIN = "tool";
+/** The set of plugin-supporting domain names from the contributed layouts. */
+export declare function domainNames(layouts: readonly PluginLayout[]): string[];
+/**
+ * Resolve the target domain, rejecting arbitrary strings from --domain.
+ * A bare cast would let a caller pass '../../etc' and drive path
+ * construction outside opensip-cli/.runtime/.
+ */
+export declare function resolveDomain(override: string | undefined, packageName: string, domains: readonly string[]): string | undefined;
+/**
+ * Decide whether `plugin add/remove <spec>` targets a Tool plugin:
+ * explicit `--domain tool`, or (when no `--domain` is given) a detected
+ * `kind: "tool"` marker. An explicit fit/sim `--domain` is honoured as-is.
+ */
+export declare function isToolTarget(domainOverride: string | undefined, spec: string, cwd: string): boolean;
+//# sourceMappingURL=domain-resolution.d.ts.map

package/dist/commands/plugin/domain-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-resolution.d.ts","sourceRoot":"","sources":["../../../src/commands/plugin/domain-resolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIxE;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,SAAS,CAAC;AAElC,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,EAAE,CAEtE;AAaD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,MAAM,GAAG,SAAS,CAGpB;AAqCD;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAIT"}

package/dist/commands/plugin/domain-resolution.js

@@ -0,0 +1,98 @@
+/**
+ * plugin/domain-resolution — pure validation + routing logic for the
+ * `plugin add/remove/sync` commands.
+ *
+ * Extracted from `commands/plugin.ts` to keep that file focused on the
+ * command bodies. Everything here decides WHICH host dir / domain a spec
+ * targets — it reads package markers but performs no install. The
+ * plugin-supporting domains are NOT hardcoded: they come from the
+ * registered tools' `pluginLayout` descriptors (threaded in as
+ * `PluginLayout[]`), so the kernel stays tool-agnostic and the tools
+ * remain the single source of truth (ADR-0009 corollary 1).
+ */
+import { execFileSync } from 'node:child_process';
+import { isAbsolute, join } from 'node:path';
+import { readDeclaredKind } from '@opensip-cli/core';
+import { extractNameFromSpec } from './host-dir.js';
+/**
+ * Pseudo-domain for full Tool plugins (whole subcommands). Distinct from
+ * the fit/sim plugin DOMAINS (which are project-committed + listed in
+ * `plugins.<domain>` config): a Tool plugin auto-discovers by its
+ * `opensipTools.kind: "tool"` marker, needs NO config entry, and installs
+ * user-global by default (`~/.opensip-cli/plugins/tool`) so the
+ * subcommand is available in every project — or project-local
+ * (`.runtime/plugins/tool`) with `--project`.
+ */
+export const TOOL_DOMAIN = 'tool';
+/** The set of plugin-supporting domain names from the contributed layouts. */
+export function domainNames(layouts) {
+    return layouts.map((l) => l.domain);
+}
+/**
+ * Infer a target domain from a package name when --domain is omitted: the
+ * first declared domain whose name appears as a word in the package name,
+ * else the first declared domain. Domain names come from trusted
+ * first-party layouts, so building a RegExp from them is safe.
+ */
+function inferDomain(packageName, domains) {
+    const match = domains.find((d) => new RegExp(String.raw `\b${d}\b`).test(packageName));
+    return match ?? domains[0];
+}
+/**
+ * Resolve the target domain, rejecting arbitrary strings from --domain.
+ * A bare cast would let a caller pass '../../etc' and drive path
+ * construction outside opensip-cli/.runtime/.
+ */
+export function resolveDomain(override, packageName, domains) {
+    if (override === undefined)
+        return inferDomain(packageName, domains);
+    return domains.includes(override) ? override : undefined;
+}
+/**
+ * Detect a package's `opensipTools.kind` BEFORE installing, so `plugin add`
+ * can route a Tool plugin to its host dir rather than a fit/sim domain.
+ *
+ *  - Local-path specs (`.`/`/`/`file:`): read the target's package.json
+ *    directly — free and offline.
+ *  - Registry specs: `npm view <name> opensipTools.kind` (one network
+ *    call; `plugin add` is already online for the install).
+ *
+ * Returns undefined when undetectable (offline, private registry, no
+ * marker) — the caller then falls back to fit/sim domain inference. The raw
+ * declared kind is returned as a string (the only thing the caller checks is
+ * `=== 'tool'`); domain markers are no longer a compiled-in host union.
+ */
+function detectPluginKind(spec, cwd) {
+    if (spec.startsWith('/') || spec.startsWith('.') || spec.startsWith('file:')) {
+        const raw = spec.startsWith('file:') ? spec.slice('file:'.length) : spec;
+        return readDeclaredKind(isAbsolute(raw) ? raw : join(cwd, raw));
+    }
+    try {
+        const name = extractNameFromSpec(spec) ?? spec;
+        const out = execFileSync('npm', ['view', name, 'opensipTools.kind'], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        })
+            .toString()
+            .trim();
+        return out === '' ? undefined : out;
+    }
+    catch {
+        // @fitness-ignore-next-line error-handling-quality -- `npm view` failure (offline, private registry, or no such package) means the kind is undetectable; returning undefined routes the caller to fit/sim domain inference — the documented fallback, not a swallowed error.
+        return undefined;
+    }
+}
+/**
+ * Decide whether `plugin add/remove <spec>` targets a Tool plugin:
+ * explicit `--domain tool`, or (when no `--domain` is given) a detected
+ * `kind: "tool"` marker. An explicit fit/sim `--domain` is honoured as-is.
+ */
+export function isToolTarget(domainOverride, spec, cwd) {
+    if (domainOverride === TOOL_DOMAIN)
+        return true;
+    if (domainOverride !== undefined)
+        return false;
+    return detectPluginKind(spec, cwd) === 'tool';
+}
+//# sourceMappingURL=domain-resolution.js.map

package/dist/commands/plugin/domain-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-resolution.js","sourceRoot":"","sources":["../../../src/commands/plugin/domain-resolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,gBAAgB,EAAqB,MAAM,mBAAmB,CAAC;AAExE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAElC,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,OAAgC;IAC1D,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,WAAmB,EAAE,OAA0B;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IACtF,OAAO,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,QAA4B,EAC5B,WAAmB,EACnB,OAA0B;IAE1B,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACrE,OAAO,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,SAAS,gBAAgB,CAAC,IAAY,EAAE,GAAW;IACjD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACzE,OAAO,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;QAC/C,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,mBAAmB,CAAC,EAAE;YACnE,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC;aACC,QAAQ,EAAE;aACV,IAAI,EAAE,CAAC;QACV,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,6QAA6Q;QAC7Q,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,cAAkC,EAClC,IAAY,EACZ,GAAW;IAEX,IAAI,cAAc,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC;AAChD,CAAC"}

package/dist/commands/plugin/host-dir.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Plugin host directory + installed-package introspection.
+ *
+ * Each plugin domain owns a `node_modules` tree under
+ * `<project>/opensip-cli/.runtime/plugins/<domain>/`. This module
+ * creates the host package.json, peeks at installed packages to
+ * resolve real package names (for local-path specs that don't carry a
+ * name), and walks peerDependencies for auto-install.
+ *
+ * Extracted from `commands/plugin.ts` so the install/uninstall flows
+ * there stay focused on Commander + npm orchestration.
+ */
+/** Filename of the host package.json that pins plugin installs. */
+export declare const HOST_PACKAGE_JSON = "package.json";
+/**
+ * Guard against argv-injection through npm. execFileSync doesn't spawn
+ * a shell, so shell metacharacters are safe, but any arg starting with
+ * '-' would be consumed by npm as a flag (e.g. '-g', '--prefix=/etc').
+ */
+export declare function isSafeNpmSpec(spec: string): boolean;
+/** Create the host package.json (if absent) for a plugin host dir + return the dir. */
+/** Create (if absent) a plugin host dir + its host package.json; returns `dir`. */
+export declare function ensureHostDir(dir: string, domain: string): string;
+/** Project-local plugin host dir: `<project>/opensip-cli/.runtime/plugins/<domain>`. */
+export declare function ensurePluginHostDir(domain: string, cwd: string): string;
+/**
+ * User-global plugin host dir: `~/.opensip-cli/plugins/<domain>`. Used by
+ * the `tool` domain so a `plugin add <tool>` makes the subcommand available
+ * across every project (the cross-project analogue of `npm i -g`).
+ */
+export declare function ensureUserPluginHostDir(domain: string): string;
+/**
+ * After installing a plugin, look at its peerDependencies and install
+ * any missing ones into the same plugin directory. Best-effort: missing
+ * peers produce no error here, the loader will surface a clear error if
+ * the plugin can't resolve its imports.
+ */
+export declare function installMissingPeers(dir: string, requestedSpec: string, depsBefore: Set<string>): void;
+export declare function findInstalledName(dir: string, requestedSpec: string, depsBefore: Set<string>): string | undefined;
+export declare function readHostDependencies(dir: string): Set<string>;
+export declare function extractNameFromSpec(spec: string): string | undefined;
+//# sourceMappingURL=host-dir.d.ts.map

package/dist/commands/plugin/host-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-dir.d.ts","sourceRoot":"","sources":["../../../src/commands/plugin/host-dir.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAQH,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAInD;AAED,uFAAuF;AACvF,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAoBjE;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,IAAI,CAsBN;AAED,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,MAAM,GAAG,SAAS,CAEpB;AA2BD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAG7D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAapE"}

package/dist/commands/plugin/host-dir.js

@@ -0,0 +1,168 @@
+// @fitness-ignore-file error-handling-quality -- package.json walks / npm-install probes where unreadable/malformed entries mean "not installable" / "not a candidate" — same as absent; npm errors already stream to stderr via inherited stdio.
+// @fitness-ignore-file unbounded-memory -- reads package.json files; bounded by standard npm package metadata shape.
+/**
+ * @fileoverview Plugin host directory + installed-package introspection.
+ *
+ * Each plugin domain owns a `node_modules` tree under
+ * `<project>/opensip-cli/.runtime/plugins/<domain>/`. This module
+ * creates the host package.json, peeks at installed packages to
+ * resolve real package names (for local-path specs that don't carry a
+ * name), and walks peerDependencies for auto-install.
+ *
+ * Extracted from `commands/plugin.ts` so the install/uninstall flows
+ * there stay focused on Commander + npm orchestration.
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveProjectPaths, resolveUserPaths } from '@opensip-cli/core';
+/** Filename of the host package.json that pins plugin installs. */
+export const HOST_PACKAGE_JSON = 'package.json';
+/**
+ * Guard against argv-injection through npm. execFileSync doesn't spawn
+ * a shell, so shell metacharacters are safe, but any arg starting with
+ * '-' would be consumed by npm as a flag (e.g. '-g', '--prefix=/etc').
+ */
+export function isSafeNpmSpec(spec) {
+    if (spec.length === 0)
+        return false;
+    if (spec.startsWith('-'))
+        return false;
+    return true;
+}
+/** Create the host package.json (if absent) for a plugin host dir + return the dir. */
+/** Create (if absent) a plugin host dir + its host package.json; returns `dir`. */
+export function ensureHostDir(dir, domain) {
+    mkdirSync(dir, { recursive: true });
+    const pkgJsonPath = join(dir, HOST_PACKAGE_JSON);
+    if (!existsSync(pkgJsonPath)) {
+        writeFileSync(pkgJsonPath, JSON.stringify({
+            name: `opensip-cli-${domain}-plugins`,
+            version: '0.0.0',
+            private: true,
+            type: 'module',
+            dependencies: {},
+        }, null, 2));
+    }
+    return dir;
+}
+/** Project-local plugin host dir: `<project>/opensip-cli/.runtime/plugins/<domain>`. */
+export function ensurePluginHostDir(domain, cwd) {
+    return ensureHostDir(resolveProjectPaths(cwd).pluginsDir(domain), domain);
+}
+/**
+ * User-global plugin host dir: `~/.opensip-cli/plugins/<domain>`. Used by
+ * the `tool` domain so a `plugin add <tool>` makes the subcommand available
+ * across every project (the cross-project analogue of `npm i -g`).
+ */
+export function ensureUserPluginHostDir(domain) {
+    return ensureHostDir(resolveUserPaths().pluginsDir(domain), domain);
+}
+/**
+ * After installing a plugin, look at its peerDependencies and install
+ * any missing ones into the same plugin directory. Best-effort: missing
+ * peers produce no error here, the loader will surface a clear error if
+ * the plugin can't resolve its imports.
+ */
+export function installMissingPeers(dir, requestedSpec, depsBefore) {
+    const installed = findInstalledPackage(dir, requestedSpec, depsBefore);
+    if (!installed)
+        return;
+    const peerDeps = installed.peerDependencies ?? {};
+    const installedAtRoot = new Set(safeReaddirScopedAndFlat(join(dir, 'node_modules')));
+    const missing = Object.entries(peerDeps).filter(([name]) => !installedAtRoot.has(name));
+    if (missing.length === 0)
+        return;
+    for (const [name, range] of missing) {
+        if (!isSafeNpmSpec(name))
+            continue;
+        if (typeof range !== 'string' || !isSafeNpmSpec(range))
+            continue;
+        try {
+            execFileSync('npm', ['install', '--ignore-scripts', '--no-save', `${name}@${range}`], {
+                cwd: dir,
+                stdio: ['ignore', process.stderr, process.stderr],
+            });
+        }
+        catch {
+            // Loader will surface unresolved imports; swallow here.
+        }
+    }
+}
+export function findInstalledName(dir, requestedSpec, depsBefore) {
+    return findInstalledPackage(dir, requestedSpec, depsBefore)?.name;
+}
+function findInstalledPackage(dir, requestedSpec, depsBefore) {
+    const nodeModulesDir = join(dir, 'node_modules');
+    if (!existsSync(nodeModulesDir))
+        return undefined;
+    const namedSpec = extractNameFromSpec(requestedSpec);
+    if (namedSpec) {
+        const pkg = readPackageJson(join(nodeModulesDir, namedSpec, HOST_PACKAGE_JSON));
+        if (pkg)
+            return pkg;
+    }
+    // Local-path installs: the new dep key is whichever entry is in the
+    // host package.json now that wasn't there before.
+    const depsAfter = readHostDependencies(dir);
+    for (const name of depsAfter) {
+        if (depsBefore.has(name))
+            continue;
+        const pkg = readPackageJson(join(nodeModulesDir, name, HOST_PACKAGE_JSON));
+        if (pkg?.name === name)
+            return pkg;
+    }
+    return undefined;
+}
+export function readHostDependencies(dir) {
+    const hostPkg = readPackageJson(join(dir, HOST_PACKAGE_JSON));
+    return new Set(Object.keys(hostPkg?.dependencies ?? {}));
+}
+export function extractNameFromSpec(spec) {
+    if (spec.startsWith('/') || spec.startsWith('.') || spec.startsWith('file:'))
+        return undefined;
+    if (spec.startsWith('@')) {
+        const withoutScope = spec.slice(1);
+        const slashIdx = withoutScope.indexOf('/');
+        if (slashIdx === -1)
+            return undefined;
+        const rest = withoutScope.slice(slashIdx + 1);
+        const atIdx = rest.indexOf('@');
+        const name = atIdx === -1 ? rest : rest.slice(0, atIdx);
+        return `@${withoutScope.slice(0, slashIdx)}/${name}`;
+    }
+    const atIdx = spec.indexOf('@');
+    return atIdx === -1 ? spec : spec.slice(0, atIdx);
+}
+function readPackageJson(path) {
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+function safeReaddirScopedAndFlat(nodeModulesDir) {
+    if (!existsSync(nodeModulesDir))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(nodeModulesDir)) {
+        if (entry.startsWith('@')) {
+            const scopeDir = join(nodeModulesDir, entry);
+            try {
+                for (const scoped of readdirSync(scopeDir))
+                    out.push(`${entry}/${scoped}`);
+            }
+            catch {
+                /* unreadable scope */
+            }
+        }
+        else if (!entry.startsWith('.')) {
+            out.push(entry);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=host-dir.js.map

package/dist/commands/plugin/host-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-dir.js","sourceRoot":"","sources":["../../../src/commands/plugin/host-dir.ts"],"names":[],"mappings":"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"}

package/dist/commands/plugin-host-ops.d.ts

@@ -0,0 +1,41 @@
+/**
+ * plugin-host-ops — host-mutation helpers for the `plugin` command.
+ *
+ * The npm install/uninstall primitives and the Tool-plugin add/remove
+ * wrappers that mutate a plugin host dir. Extracted from `plugin.ts` so the
+ * command bodies (`pluginList`/`pluginAdd`/`pluginRemove`/`pluginSync`) stay
+ * focused on argument validation and config wiring; this module owns the
+ * side-effecting npm + host-dir mutation.
+ */
+import type { PluginResult } from '@opensip-cli/contracts';
+export { editPluginList } from './plugin/config-edit.js';
+/** Outcome of an npm install into a host dir: the resolved installed name, or an error message. */
+export type InstallOutcome = {
+    readonly ok: true;
+    readonly installedName: string;
+} | {
+    readonly ok: false;
+    readonly error: string;
+};
+/**
+ * `npm install --ignore-scripts <spec>` into a plugin host dir, then
+ * resolve the real installed name and auto-install peers. Shared by the
+ * fit/sim domain path and the Tool-plugin path.
+ *
+ * --ignore-scripts: plugins run via dynamic import() at tool time; they
+ * don't legitimately need install-time code execution. Blocks supply-chain
+ * attacks via postinstall hooks. npm's stdout is routed to stderr so JSON
+ * renderers (which own process stdout) are not contaminated.
+ */
+export declare function npmInstallIntoHost(dir: string, packageName: string): InstallOutcome;
+/**
+ * Install a Tool plugin into its host dir (user-global by default,
+ * project-local with `--project`). No `plugins.<domain>` config entry —
+ * Tool plugins auto-discover by their `kind: "tool"` marker.
+ */
+export declare function addToolPlugin(packageName: string, cwd: string, project: boolean): PluginResult;
+/** npm-uninstall a package from a host dir. Pure of config concerns. */
+export declare function npmUninstallFromHost(dir: string, packageName: string): boolean;
+/** Remove a Tool plugin from its host dir (user-global by default, --project otherwise). */
+export declare function removeToolPlugin(packageName: string, cwd: string, project: boolean): PluginResult;
+//# sourceMappingURL=plugin-host-ops.d.ts.map

package/dist/commands/plugin-host-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-host-ops.d.ts","sourceRoot":"","sources":["../../src/commands/plugin-host-ops.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAkBH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAUzD,mGAAmG;AACnG,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CAwBnF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,YAAY,CAS9F;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAU9E;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,YAAY,CAsBjG"}

package/dist/commands/plugin-host-ops.js

@@ -0,0 +1,114 @@
+// @fitness-ignore-file error-handling-quality -- npm install failures already stream to stderr via inherited stdio (downstream loader surfaces unresolved imports), and the package.json / node_modules walks are probes where unreadable/malformed entries mean "not installable" or "not a candidate" — same as absent.
+/**
+ * plugin-host-ops — host-mutation helpers for the `plugin` command.
+ *
+ * The npm install/uninstall primitives and the Tool-plugin add/remove
+ * wrappers that mutate a plugin host dir. Extracted from `plugin.ts` so the
+ * command bodies (`pluginList`/`pluginAdd`/`pluginRemove`/`pluginSync`) stay
+ * focused on argument validation and config wiring; this module owns the
+ * side-effecting npm + host-dir mutation.
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveProjectPaths, resolveUserPaths } from '@opensip-cli/core';
+import { TOOL_DOMAIN } from './plugin/domain-resolution.js';
+import { ensurePluginHostDir, ensureUserPluginHostDir, findInstalledName, HOST_PACKAGE_JSON, installMissingPeers, readHostDependencies, } from './plugin/host-dir.js';
+// Re-exported so the test hook (`__test.editPluginList`) and any host-ops
+// consumer have a single import home for the host-mutation surface.
+export { editPluginList } from './plugin/config-edit.js';
+/**
+ * CommandResult discriminator literals. `as const` keeps the literal type
+ * (so the PluginResult union still narrows) while satisfying
+ * sonarjs/no-duplicate-string — no scattered eslint-disable needed.
+ */
+const PLUGIN_ADD = 'plugin-add';
+const PLUGIN_REMOVE = 'plugin-remove';
+/**
+ * `npm install --ignore-scripts <spec>` into a plugin host dir, then
+ * resolve the real installed name and auto-install peers. Shared by the
+ * fit/sim domain path and the Tool-plugin path.
+ *
+ * --ignore-scripts: plugins run via dynamic import() at tool time; they
+ * don't legitimately need install-time code execution. Blocks supply-chain
+ * attacks via postinstall hooks. npm's stdout is routed to stderr so JSON
+ * renderers (which own process stdout) are not contaminated.
+ */
+export function npmInstallIntoHost(dir, packageName) {
+    const depsBefore = readHostDependencies(dir);
+    try {
+        execFileSync('npm', ['install', '--ignore-scripts', packageName], {
+            cwd: dir,
+            stdio: ['ignore', process.stderr, process.stderr],
+        });
+        const resolvedName = findInstalledName(dir, packageName, depsBefore);
+        const isLocalPathSpec = packageName.startsWith('/') || packageName.startsWith('.') || packageName.startsWith('file:');
+        if (!resolvedName && isLocalPathSpec) {
+            return {
+                ok: false,
+                error: `Installed '${packageName}' but could not resolve the installed package name from package.json. The install was not recorded; remove and retry.`,
+            };
+        }
+        installMissingPeers(dir, packageName, depsBefore);
+        return { ok: true, installedName: resolvedName ?? packageName };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            error: `Failed to add ${packageName}: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+/**
+ * Install a Tool plugin into its host dir (user-global by default,
+ * project-local with `--project`). No `plugins.<domain>` config entry —
+ * Tool plugins auto-discover by their `kind: "tool"` marker.
+ */
+export function addToolPlugin(packageName, cwd, project) {
+    const dir = project
+        ? ensurePluginHostDir(TOOL_DOMAIN, cwd)
+        : ensureUserPluginHostDir(TOOL_DOMAIN);
+    const outcome = npmInstallIntoHost(dir, packageName);
+    if (!outcome.ok) {
+        return { type: PLUGIN_ADD, packageName, success: false, error: outcome.error };
+    }
+    return { type: PLUGIN_ADD, packageName: outcome.installedName, success: true };
+}
+/** npm-uninstall a package from a host dir. Pure of config concerns. */
+export function npmUninstallFromHost(dir, packageName) {
+    try {
+        execFileSync('npm', ['uninstall', packageName], {
+            cwd: dir,
+            stdio: ['ignore', process.stderr, process.stderr],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Remove a Tool plugin from its host dir (user-global by default, --project otherwise). */
+export function removeToolPlugin(packageName, cwd, project) {
+    const dir = project
+        ? resolveProjectPaths(cwd).pluginsDir(TOOL_DOMAIN)
+        : resolveUserPaths().pluginsDir(TOOL_DOMAIN);
+    if (!existsSync(join(dir, HOST_PACKAGE_JSON))) {
+        return {
+            type: PLUGIN_REMOVE,
+            packageName,
+            success: false,
+            error: `No tool plugins installed in ${dir}`,
+        };
+    }
+    if (!npmUninstallFromHost(dir, packageName)) {
+        return {
+            type: PLUGIN_REMOVE,
+            packageName,
+            success: false,
+            error: `Failed to remove ${packageName}`,
+        };
+    }
+    // No config entry to clean up — tool plugins auto-discover by marker.
+    return { type: PLUGIN_REMOVE, packageName, success: true };
+}
+//# sourceMappingURL=plugin-host-ops.js.map

package/dist/commands/plugin-host-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-host-ops.js","sourceRoot":"","sources":["../../src/commands/plugin-host-ops.ts"],"names":[],"mappings":"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"}

package/dist/commands/plugin.d.ts

@@ -0,0 +1,81 @@
+/**
+ * plugin command — manage project-local npm-installed plugins.
+ *
+ * Layout (no user-global plugin dir):
+ *
+ *   <project>/opensip-cli/.runtime/plugins/<domain>/
+ *   ├── package.json       — host package; "dependencies" is the
+ *   │                        plugin install state for this domain
+ *   └── node_modules/      — npm-installed plugin packages
+ *
+ *   <project>/opensip-cli.config.yml
+ *   plugins:
+ *     fit:
+ *       - "@org/fitness-checks"   — declares which installed packages
+ *                                   discovery should LOAD. Required;
+ *                                   discovery does not auto-load every
+ *                                   installed package (silent loads
+ *                                   would surprise users).
+ *
+ * `plugin add <pkg>` is the one-step install: writes the package to
+ * .runtime/plugins/<domain>/node_modules AND adds it to plugins.<domain>
+ * in the project config. After: `opensip fit` loads it on next run.
+ *
+ * `plugin remove <pkg>` is the inverse: removes from node_modules AND
+ * deletes from plugins.<domain>.
+ *
+ * `plugin list` walks .runtime/plugins/<domain>/node_modules + the
+ * config to show what's installed and what's currently loaded.
+ *
+ * `plugin sync` is the post-clone bootstrap: reads plugins.<domain> from
+ * the config and `npm install`s everything declared. Used by CI and
+ * by users who clone a repo with custom plugins.
+ *
+ * Module layout
+ * -------------
+ * - This file owns the `plugin {list,add,remove,sync}` command bodies.
+ * - `plugin/config-edit.ts` — YAML round-trip edits to plugins.<domain>.
+ * - `plugin/domain-resolution.ts` — TOOL_DOMAIN + the pure validation
+ *   logic that routes a spec to a domain / Tool host dir (no install).
+ * - `plugin/host-dir.ts` — host package.json creation + installed-
+ *   package introspection (incl. peer-dependency auto-install).
+ */
+import { type PluginLayout, type ToolProvenance } from '@opensip-cli/core';
+import { editPluginList } from './plugin-host-ops.js';
+import type { PluginResult } from '@opensip-cli/contracts';
+/** Options shared by `plugin add`/`remove` for Tool-plugin scope selection. */
+export interface PluginScopeOpts {
+    /** Install/remove a Tool plugin in the project-local host dir instead of user-global. */
+    readonly project?: boolean;
+}
+/**
+ * Test-only export for the YAML-driven config edit so unit tests can
+ * exercise the round-trip behaviour without spawning npm. Intentionally
+ * not part of the public CLI API surface.
+ */
+export declare const __test: {
+    editPluginList: typeof editPluginList;
+};
+export declare function pluginList(cwd?: string, layouts?: readonly PluginLayout[], toolProvenance?: readonly ToolProvenance[]): Promise<PluginResult>;
+/**
+ * Install a plugin AND add it to the project config in one step.
+ *
+ * Without the config update, the package wouldn't get loaded — making
+ * "install" alone always incomplete. Single-step is the only sensible
+ * default.
+ */
+export declare function pluginAdd(packageName: string | undefined, cwd?: string, domainOverride?: string, layouts?: readonly PluginLayout[], scope?: PluginScopeOpts): Promise<PluginResult>;
+export declare function pluginRemove(packageName: string | undefined, cwd?: string, domainOverride?: string, layouts?: readonly PluginLayout[], scope?: PluginScopeOpts): Promise<PluginResult>;
+/**
+ * Install every plugin declared in `plugins.<domain>` for a given
+ * domain (or all domains when none specified). Idempotent — re-running
+ * after `git pull` updates the install state.
+ *
+ * The post-clone story: a developer clones a repo with declared
+ * plugins, runs `opensip plugin sync`, and the
+ * .runtime/plugins/<domain>/node_modules trees are populated. Without
+ * this, the first `opensip fit` would warn about every declared
+ * plugin being uninstalled.
+ */
+export declare function pluginSync(cwd?: string, domainOverride?: string, layouts?: readonly PluginLayout[]): Promise<PluginResult>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/commands/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/commands/plugin.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAMH,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAU3B,OAAO,EAEL,cAAc,EAIf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAc,YAAY,EAAa,MAAM,wBAAwB,CAAC;AAUlF,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,yFAAyF;IACzF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM;;CAAqB,CAAC;AAMzC,wBAAsB,UAAU,CAC9B,GAAG,GAAE,MAAsB,EAC3B,OAAO,GAAE,SAAS,YAAY,EAAO,EAGrC,cAAc,GAAE,SAAS,cAAc,EAAO,GAC7C,OAAO,CAAC,YAAY,CAAC,CA2CvB;AAUD;;;;;;GAMG;AAEH,wBAAsB,SAAS,CAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,GAAG,GAAE,MAAsB,EAC3B,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,GAAE,SAAS,YAAY,EAAO,EACrC,KAAK,GAAE,eAAoB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA6CvB;AAOD,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,GAAG,GAAE,MAAsB,EAC3B,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,GAAE,SAAS,YAAY,EAAO,EACrC,KAAK,GAAE,eAAoB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA0DvB;AAMD;;;;;;;;;;GAUG;AAKH,wBAAsB,UAAU,CAC9B,GAAG,GAAE,MAAsB,EAC3B,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,GAAE,SAAS,YAAY,EAAO,GACpC,OAAO,CAAC,YAAY,CAAC,CA4CvB"}