@opensip-cli/external-tool-adapter 0.1.15

package/dist/version-command.js

@@ -0,0 +1,74 @@
+/**
+ * @fileoverview The standardized `version` command (ADR-0090 §4.9).
+ *
+ * Resolves + probes the wrapped binary and prints its version (and path).
+ * Output mode `raw-stream`/`'diagnostic-gate'` for the same reason as `doctor`
+ * (a structured `--json` shape AND a human line): the handler owns its output.
+ * The probe runs worker-side for an installed adapter.
+ */
+import { defineNestedCommand } from '@opensip-cli/core';
+import { defaultBinaryEnvVar, resolveBinary } from './binary-resolver.js';
+import { asObject, getString } from './ingest-json.js';
+import { defaultBinaryDeps, probeBinaryVersion } from './process-exec.js';
+const VERSION_PROBE_TIMEOUT_MS = 15_000;
+const DEFAULT_PROBE_DEPS = {
+    binaryDeps: defaultBinaryDeps,
+    probeVersion: probeBinaryVersion,
+    env: process.env,
+};
+/** Resolve + probe the binary into an {@link AdapterVersionReport}. Pure given deps. */
+export function probeVersionReport(input, deps) {
+    const { tool, binary } = input;
+    const resolution = resolveBinary({
+        command: binary.command,
+        configuredPath: getString(asObject(input.config.binaries)?.[tool], 'path'),
+        envPath: deps.env[binary.envVar ?? defaultBinaryEnvVar(tool)],
+    }, deps.binaryDeps);
+    const detected = resolution.found
+        ? deps.probeVersion({
+            path: resolution.path,
+            versionArgs: binary.versionArgs,
+            parse: binary.versionParse,
+            timeoutMs: VERSION_PROBE_TIMEOUT_MS,
+        })
+        : undefined;
+    return {
+        tool,
+        found: resolution.found,
+        command: binary.command,
+        ...(resolution.found ? { path: resolution.path, layer: resolution.layer } : {}),
+        ...(detected === undefined ? {} : { version: detected }),
+    };
+}
+/** Build the nested `version` command (prints the resolved binary version). */
+export function buildVersionCommand(input, probeDeps) {
+    const deps = probeDeps ?? DEFAULT_PROBE_DEPS;
+    return defineNestedCommand({
+        name: 'version',
+        description: `Print the resolved ${input.tool} binary version`,
+        commonFlags: ['json', 'cwd'],
+        scope: 'none',
+        output: 'raw-stream',
+        rawStreamReason: 'diagnostic-gate',
+        handler: async (rawOpts, cli) => {
+            const opts = rawOpts;
+            const config = (cli.scope.toolConfig?.[input.tool] ?? {});
+            const report = probeVersionReport({ tool: input.tool, binary: input.binary, config }, deps);
+            if (opts.json === true) {
+                cli.emitJson(report);
+            }
+            else {
+                await cli.render({
+                    type: 'text-lines',
+                    title: `${input.tool} version`,
+                    lines: [
+                        report.found
+                            ? `${input.tool} ${report.version ?? 'unknown'} (${report.path ?? ''})`
+                            : `${input.tool}: binary not found (${report.command})`,
+                    ],
+                });
+            }
+        },
+    });
+}
+//# sourceMappingURL=version-command.js.map

package/dist/version-command.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@opensip-cli/external-tool-adapter",
+  "version": "0.1.15",
+  "license": "Apache-2.0",
+  "description": "Substrate for External Tool Adapters — wrap a CLI scanner (gitleaks/osv-scanner/trivy/…) as an opensip-cli Tool: binary resolution, run loop, SARIF/JSON ingest, severity mapping, exit modeling, doctor/version, provenance",
+  "keywords": [
+    "opensip-cli",
+    "static-analysis",
+    "code-quality",
+    "security",
+    "scanners",
+    "adapters",
+    "sarif"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opensip-ai/opensip-cli.git",
+    "directory": "packages/external-tool-adapter"
+  },
+  "homepage": "https://github.com/opensip-ai/opensip-cli",
+  "bugs": {
+    "url": "https://github.com/opensip-ai/opensip-cli/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "typescript": "~6.0.3",
+    "zod": "^4.4.3",
+    "@opensip-cli/core": "0.1.15",
+    "@opensip-cli/contracts": "0.1.15"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.2",
+    "vitest": "^4.1.8",
+    "@opensip-cli/output": "0.1.15"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}