@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
|
|
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.
|
|
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",
|
package/skills/archlens/SKILL.md
CHANGED
|
@@ -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.
|
|
10
|
+
version: 1.1.2-dev.65
|
|
11
11
|
metadata:
|
|
12
12
|
author: fmatar
|
|
13
|
-
version: "1.1.2-dev.
|
|
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.
|
|
9
|
+
version: 1.1.2-dev.65
|
|
10
10
|
metadata:
|
|
11
11
|
author: fmatar
|
|
12
|
-
version: "1.1.2-dev.
|
|
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.
|
|
9
|
+
version: 1.1.2-dev.65
|
|
10
10
|
metadata:
|
|
11
11
|
author: fmatar
|
|
12
|
-
version: "1.1.2-dev.
|
|
12
|
+
version: "1.1.2-dev.65"
|
|
13
13
|
---
|
|
14
14
|
|
|
15
15
|
# UML Workbench Companion Skill (`uml-workbench-companion`)
|
package/src/mcp-registry.js
CHANGED
|
@@ -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
|
|
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(
|
|
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') {
|