@fmatar/archlens-skill 1.1.2-dev.64 → 1.1.2-dev.65

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -137,6 +137,9 @@ Configures detected AI client manifests or launches an interactive stdio bridge:
137
137
  # Auto-configure Claude Desktop, Google Antigravity, Claude Code, Cursor, and VS Code
138
138
  npx @fmatar/archlens-skill --mcp
139
139
 
140
+ # Auto-configure pure ephemeral Docker MCP container (docker run -i --rm -e QUARKUS_PROFILE=mcp-stdio)
141
+ npx @fmatar/archlens-skill --mcp --docker
142
+
140
143
  # Launch MCP stdio transport bridge (spins up Docker container automatically when needed)
141
144
  npx @fmatar/archlens-skill mcp
142
145
  ```
@@ -175,7 +178,7 @@ npx @fmatar/archlens-skill start --path /path/to/project --port 8088 --open
175
178
  | `--format <FMT>` | | Output format for `check` (`text`, `json`, `sarif`) | `text` |
176
179
  | `--output <FILE>` | `-O` | Write `check` output report (e.g. SARIF) to file | |
177
180
  | `--native` | | Force native JVM runner mode on `start` | `false` |
178
- | `--docker` | | Force Docker container mode on `start` | `false` |
181
+ | `--docker` | | Force Docker container mode on `start` or configure ephemeral `mcp-stdio` manifests with `--mcp` | `false` |
179
182
  | `--jar <PATH>` | | Custom path to `quarkus-run.jar` for native mode | Auto-detected |
180
183
  | `--open` | `-o` | Open visual workbench in default browser upon startup | `false` |
181
184
  | `--port <PORT>` | | Workbench HTTP port | `8088` |
package/bin/index.js CHANGED
@@ -77,7 +77,7 @@ ${ui.colors.bold}OPTIONS:${ui.colors.reset}
77
77
  --server-url <URL> Archlens visual workbench URL (default: http://localhost:8088)
78
78
  --port <PORT> Workbench HTTP port (default: 8088)
79
79
  --native Prefer running workbench via native Java Quarkus runner (default)
80
- --docker Force running workbench via Docker container
80
+ --docker Force Docker container mode on start or ephemeral MCP STDIO with --mcp
81
81
  --jar <PATH> Custom path to Archlens Quarkus runner JAR
82
82
  -o, --open Open visual workbench in default browser upon startup
83
83
  -m, --mcp Auto-configure MCP server manifests in AI clients (Claude, Antigravity, Cursor)
@@ -101,6 +101,9 @@ ${ui.colors.bold}EXAMPLES:${ui.colors.reset}
101
101
  ${ui.colors.dim}# Configure MCP manifests across Claude, Antigravity, and Cursor:${ui.colors.reset}
102
102
  npx @fmatar/archlens-skill --mcp
103
103
 
104
+ ${ui.colors.dim}# Configure ephemeral Docker MCP container (docker run -i --rm):${ui.colors.reset}
105
+ npx @fmatar/archlens-skill --mcp --docker
106
+
104
107
  ${ui.colors.dim}# Launch MCP stdio bridge server for AI coding assistants:${ui.colors.reset}
105
108
  npx @fmatar/archlens-skill mcp
106
109
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fmatar/archlens-skill",
3
- "version": "1.1.2-dev.64",
3
+ "version": "1.1.2-dev.65",
4
4
  "description": "Cross-platform CLI and installer for Archlens Clean Architecture governance policies and AI assistant skills",
5
5
  "main": "src/installer.js",
6
6
  "type": "module",
@@ -7,10 +7,10 @@ description: >-
7
7
  layer boundaries, inverting outward dependencies (DIP), or running Archlens.
8
8
  license: Apache-2.0
9
9
  compatibility: "Node.js >= 18"
10
- version: 1.1.2-dev.64
10
+ version: 1.1.2-dev.65
11
11
  metadata:
12
12
  author: fmatar
13
- version: "1.1.2-dev.64"
13
+ version: "1.1.2-dev.65"
14
14
  ---
15
15
 
16
16
  # Archlens — Clean Architecture Governance & Workbench Companion
@@ -88,6 +88,9 @@ npx @fmatar/archlens-skill upgrade --path .
88
88
  # Auto-configure MCP manifests for AI assistants (Antigravity, Claude, Cursor):
89
89
  npx @fmatar/archlens-skill --mcp
90
90
 
91
+ # Auto-configure pure ephemeral Docker MCP container (docker run -i --rm -e QUARKUS_PROFILE=mcp-stdio):
92
+ npx @fmatar/archlens-skill --mcp --docker
93
+
91
94
  # Launch Model Context Protocol (MCP) stdio server:
92
95
  npx @fmatar/archlens-skill mcp
93
96
  ```
@@ -6,10 +6,10 @@ description: >-
6
6
  agent workbench companion integration. Use when setting up or upgrading Archlens.
7
7
  license: Apache-2.0
8
8
  compatibility: "Node.js >= 18"
9
- version: 1.1.2-dev.64
9
+ version: 1.1.2-dev.65
10
10
  metadata:
11
11
  author: fmatar
12
- version: "1.1.2-dev.64"
12
+ version: "1.1.2-dev.65"
13
13
  ---
14
14
 
15
15
  # Archlens Policy & Companion Installer (`archlens-install-policy`)
@@ -6,10 +6,10 @@ description: >-
6
6
  evaluates Clean Architecture violations, runs builds and tests, and signals live diagram reloads.
7
7
  license: Apache-2.0
8
8
  compatibility: "Node.js >= 18"
9
- version: 1.1.2-dev.64
9
+ version: 1.1.2-dev.65
10
10
  metadata:
11
11
  author: fmatar
12
- version: "1.1.2-dev.64"
12
+ version: "1.1.2-dev.65"
13
13
  ---
14
14
 
15
15
  # UML Workbench Companion Skill (`uml-workbench-companion`)
@@ -8,6 +8,7 @@
8
8
  import * as fs from 'node:fs';
9
9
  import * as path from 'node:path';
10
10
  import * as os from 'node:os';
11
+ import { DEFAULT_DOCKER_IMAGE } from './docker-runner.js';
11
12
 
12
13
  export const ARCHLENS_TOOL_SCHEMAS = {
13
14
  inspectArchitecture: {
@@ -360,7 +361,49 @@ export function getClientConfigLocations(projectRoot = '.', homedir = os.homedir
360
361
  ];
361
362
  }
362
363
 
363
- export function getMcpManifestEntry(serverUrl = 'http://localhost:8088') {
364
+ export function resolveDockerHostWorkspace(options = {}) {
365
+ if (options.hostWorkspace) {
366
+ return path.resolve(options.hostWorkspace);
367
+ }
368
+ const exists = options.existsSync || fs.existsSync;
369
+ const projectRoot = path.resolve(options.path || '.');
370
+ if (options.scope === 'global' && options.homedir) {
371
+ const sharedWorkspace = path.resolve(options.homedir, 'workspace');
372
+ if (
373
+ exists(sharedWorkspace) &&
374
+ (projectRoot === sharedWorkspace || projectRoot.startsWith(sharedWorkspace + path.sep))
375
+ ) {
376
+ return sharedWorkspace;
377
+ }
378
+ }
379
+ return projectRoot;
380
+ }
381
+
382
+ export function getMcpManifestEntry(serverUrl = 'http://localhost:8088', options = {}) {
383
+ if (options.preferDocker || options.docker) {
384
+ const hostWorkspace = resolveDockerHostWorkspace(options);
385
+ const image = options.image || DEFAULT_DOCKER_IMAGE;
386
+ return {
387
+ command: 'docker',
388
+ args: [
389
+ 'run',
390
+ '-i',
391
+ '--rm',
392
+ '-e',
393
+ 'QUARKUS_PROFILE',
394
+ '-e',
395
+ 'ARCHLENS_HOST_WORKSPACE',
396
+ '-v',
397
+ `${hostWorkspace}:/workspace`,
398
+ image
399
+ ],
400
+ env: {
401
+ QUARKUS_PROFILE: 'mcp-stdio',
402
+ ARCHLENS_HOST_WORKSPACE: hostWorkspace
403
+ }
404
+ };
405
+ }
406
+
364
407
  return {
365
408
  command: 'npx',
366
409
  args: ['-y', '@fmatar/archlens-skill', 'mcp'],
@@ -419,19 +462,26 @@ export function installMcpConfigs(options = {}) {
419
462
  }
420
463
  }
421
464
 
465
+ const entryOptions = {
466
+ ...options,
467
+ path: projectRoot,
468
+ homedir,
469
+ scope: target.scope
470
+ };
471
+
422
472
  if (target.id === 'vscode') {
423
473
  if (!manifest.servers || typeof manifest.servers !== 'object') {
424
474
  manifest.servers = {};
425
475
  }
426
476
  manifest.servers.archlens = {
427
477
  type: 'stdio',
428
- ...getMcpManifestEntry(serverUrl)
478
+ ...getMcpManifestEntry(serverUrl, entryOptions)
429
479
  };
430
480
  } else {
431
481
  if (!manifest.mcpServers || typeof manifest.mcpServers !== 'object') {
432
482
  manifest.mcpServers = {};
433
483
  }
434
- manifest.mcpServers.archlens = getMcpManifestEntry(serverUrl);
484
+ manifest.mcpServers.archlens = getMcpManifestEntry(serverUrl, entryOptions);
435
485
  }
436
486
 
437
487
  if (!dryRun) {
package/src/mcp-server.js CHANGED
@@ -166,7 +166,17 @@ export async function executeToolCall(toolName, args = {}, options = {}, deps =
166
166
  const runner = deps.ensureServerRunning || ensureServerRunning;
167
167
 
168
168
  // Attempt server readiness inspection
169
- const serverStatus = await runner({ serverUrl, workspace: projectRoot }, deps);
169
+ const serverStatus = await runner(
170
+ {
171
+ serverUrl,
172
+ workspace: projectRoot,
173
+ preferDocker: options.preferDocker,
174
+ preferNative: options.preferNative,
175
+ jarPath: options.jarPath,
176
+ binaryPath: options.binaryPath
177
+ },
178
+ deps
179
+ );
170
180
  const isOnline = serverStatus.status === 'running';
171
181
 
172
182
  if (toolName === 'exportLlmDossier') {