@h2nguyen/arc42-node-mcp-server 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -5,6 +5,35 @@ All notable changes to the arc42 MCP Server will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0] - 2026-03-09
+
+### Added
+- **Claude Skill for Arc42**: Pre-built Claude skill (`.claude/skills/arc42-docs-mcp/`) that teaches Claude how to effectively use the arc42 MCP server tools
+  - `SKILL.md` with workflows, tool reference, and behavioral guidelines
+  - Reference documents for setup and practical usage examples (8 scenarios)
+  - Can be copied or symlinked into other projects for automatic arc42 documentation assistance
+- **Project CLAUDE.md**: Added project-level instructions for Claude Code with build commands, code conventions, architecture overview, and key constraints
+- **Dependency Review Configuration**: Added `.github/dependency-review-config.yml` with allowed license list (Apache-2.0, MIT, ISC, BSD, CC-BY-SA-4.0, CC0-1.0, 0BSD)
+
+### Changed
+- Updated license metadata in `package.json` to SPDX expression `(Apache-2.0 AND CC-BY-SA-4.0)` with explicit dual-license entries for Apache-2.0 (code) and CC-BY-SA-4.0 (arc42 template content)
+
+### Security
+- Bump `express-rate-limit` from 8.2.1 to 8.3.1 in the npm_and_yarn group
+- Bump `hono` from 4.12.3 to 4.12.5 and `@hono/node-server` from 1.19.9 to 1.19.10
+
+### Documentation
+- Added "Claude Skill for Arc42" section to README with installation instructions, skill triggers, and benefits comparison table
+
+## [2.1.1] - 2026-02-26
+
+### Security
+- Remove direct system shell access to eliminate code execution risk
+
+### Changed
+- Mark dependencies as peer in package-lock.json
+- Update dependencies in package-lock.json (balanced-match, brace-expansion, minimatch) to latest versions
+
 ## [2.1.0] - 2026-02-14
 
 ### Added

package/README.md

@@ -49,6 +49,11 @@ A Model Context Protocol (MCP) server that helps you create comprehensive archit
 * [🎯 Best Practices](#-best-practices)
   * [For AI Assistants](#for-ai-assistants)
   * [For Users](#for-users)
+* [🧠 Claude Skill for Arc42](#-claude-skill-for-arc42)
+  * [What Is the Arc42 Skill?](#what-is-the-arc42-skill)
+  * [Installing the Skill in Other Projects](#installing-the-skill-in-other-projects)
+  * [Skill Triggers](#skill-triggers)
+  * [Benefits for Your Projects](#benefits-for-your-projects)
 * [🔧 Development](#-development)
   * [Development Methodology](#development-methodology)
   * [Documentation Quality Assurance](#documentation-quality-assurance)
@@ -705,6 +710,77 @@ your-project/
 4. **Keep it current**: Update as architecture evolves
 5. **Use version control**: Commit your arc42-docs directory to Git
 
+## 🧠 Claude Skill for Arc42
+
+This project includes a pre-built **Claude Skill** that teaches Claude (via [Claude Code](https://docs.anthropic.com/en/docs/claude-code) or any skill-aware Claude integration) how to effectively use the arc42 MCP server tools for architecture documentation — without manual prompting.
+
+### What Is the Arc42 Skill?
+
+The skill is a structured knowledge package located at `.claude/skills/arc42-docs-mcp/` containing:
+
+```
+.claude/skills/arc42-docs-mcp/
+├── SKILL.md              # Skill definition with workflows, tool reference, and behavioral guidelines
+└── references/
+    ├── setup.md          # MCP server installation and configuration for all clients
+    └── examples.md       # Practical usage examples (8 scenarios)
+```
+
+When present in a project, Claude automatically loads the skill and understands:
+
+- The correct **workflow order** for arc42 documentation (guide → init → status → template → write → review)
+- **All 6 MCP tools**, their parameters, and expected responses
+- **Best practices** such as always generating a template before writing, using append mode for ADRs, and asking clarifying questions before assuming project details
+- The **recommended documentation order** (Section 1 → 3 → 4 → 5 → 9, then fill the remaining sections)
+
+### Installing the Skill in Other Projects
+
+To enable the arc42 skill in any project where Claude Code is used:
+
+**Option 1: Copy the skill directory**
+
+```bash
+# From your project root
+mkdir -p .claude/skills
+cp -r /path/to/Arc42-Node-MCP-Server/.claude/skills/arc42-docs-mcp .claude/skills/
+```
+
+**Option 2: Symlink (keeps the skill up-to-date)**
+
+```bash
+# From your project root
+mkdir -p .claude/skills
+ln -s /path/to/Arc42-Node-MCP-Server/.claude/skills/arc42-docs-mcp .claude/skills/arc42-docs-mcp
+```
+
+> **Prerequisite**: The arc42 MCP server must also be configured in your project's MCP settings (`.mcp.json`, Claude Desktop config, etc.). The skill teaches Claude *how* to use the tools, but the MCP server must be running to provide them. See [Setup in Claude Desktop](#setup-in-claude-desktop), [Setup in Cursor](#setup-in-cursor), or [Setup in Cline](#setup-in-cline) for server configuration.
+
+After installation, commit the `.claude/skills/arc42-docs-mcp/` directory to version control so all team members benefit from the skill automatically.
+
+### Skill Triggers
+
+Claude activates the arc42 skill when it detects any of the following in conversation:
+
+| Trigger                             | Examples                                                                                     |
+|-------------------------------------|----------------------------------------------------------------------------------------------|
+| Architecture documentation keywords | "create architecture documentation", "document the architecture", "update architecture docs" |
+| Arc42 references                    | "arc42", "initialize arc42", "arc42 template"                                                |
+| Section-specific requests           | "document the deployment view", "add quality requirements", "describe the building blocks"   |
+| ADR mentions                        | "add an Architecture Decision Record", "document why we chose PostgreSQL"                    |
+| Any of the 12 arc42 sections        | Introduction and Goals, Constraints, Context and Scope, Solution Strategy, etc.              |
+
+### Benefits for Your Projects
+
+| Benefit                | Without Skill                                     | With Skill                                                                        |
+|------------------------|---------------------------------------------------|-----------------------------------------------------------------------------------|
+| **Workflow knowledge** | Must manually prompt Claude to follow arc42 order | Claude automatically follows guide → init → template → write workflow             |
+| **Tool usage**         | May call tools incorrectly or skip steps          | Calls the right tools with correct parameters in the right sequence               |
+| **Content quality**    | Generic documentation output                      | Generates templates first, asks clarifying questions, documents WHY not just WHAT |
+| **ADR handling**       | Risk of overwriting existing decisions            | Always reads existing ADRs first and uses append mode                             |
+| **Format awareness**   | May mix AsciiDoc and Markdown syntax              | Checks `arc42-status` for configured format and writes consistently               |
+| **Multi-language**     | Defaults to English only                          | Respects configured language across all tool calls                                |
+| **Team consistency**   | Each developer gets different results             | Shared skill in version control ensures consistent documentation quality          |
+
 ## 🔧 Development
 
 ### Development Methodology
@@ -958,7 +1034,8 @@ This project is licensed under the Apache License 2.0 – see the [LICENSE](LICE
 - **arc42 GitHub**: https://github.com/arc42
 - **arc42 Examples**: https://arc42.org/examples (Additional examples are embedded within the documentation at https://docs.arc42.org/)
 - **arc42 FAQ**: https://faq.arc42.org/
-- **arc42 Node MCP Server Github**: https://github.com/h2nguyen/Arc42-Node-MCP-Server
+- **arc42 Node MCP Server on Github**: https://github.com/h2nguyen/Arc42-Node-MCP-Server
+- **arc42 Node MCP Server on NPM**: https://www.npmjs.com/package/@h2nguyen/arc42-node-mcp-server/v/latest
 - **MCP Specification**: https://modelcontextprotocol.io/specification/
 
 ---

package/dist/templates/arc42-reference.d.ts

@@ -5,8 +5,14 @@
  * When the submodule is updated, this file automatically reflects the new version.
  *
  * Source: https://github.com/arc42/arc42-template
- * Version file: vendor/arc42-template/EN/version.properties
+ * Version file: vendor/arc42-template/{LANG}/version.properties
  */
+/** Supported languages in the arc42 template */
+export type Arc42Language = 'EN' | 'DE' | 'ES' | 'FR' | 'IT' | 'NL' | 'PT' | 'RU' | 'CZ' | 'UKR' | 'ZH';
+/** Default language for arc42 templates */
+export declare const DEFAULT_LANGUAGE: Arc42Language;
+/** List of all supported languages */
+export declare const SUPPORTED_LANGUAGES: Arc42Language[];
 export interface Arc42Reference {
     /** The arc42 template version (e.g., "9.0-EN") */
     version: string;
@@ -18,6 +24,8 @@ export interface Arc42Reference {
     sourceRepo: string;
     /** Whether the submodule is available */
     submoduleAvailable: boolean;
+    /** Language code used for this reference */
+    language: Arc42Language;
     /** Notes about any deviations from the original template */
     notes: string[];
 }
@@ -30,29 +38,39 @@ export declare function parseVersionProperties(content: string): {
     revdate: string;
 };
 /**
- * Get commit SHA from git submodule
+ * Get commit SHA from git submodule by reading .git files directly
+ * (Avoids shell access for security - no execSync required)
  * @internal Exported for testing purposes
  */
 export declare function getSubmoduleCommitSha(): string;
 /**
  * Reference information for the arc42 template version this MCP server is based on.
- * This is loaded dynamically from the submodule at module initialization.
+ * This is loaded dynamically from the submodule at module initialization (default: English).
  */
 export declare const ARC42_REFERENCE: Arc42Reference;
+/**
+ * Get arc42 reference information for a specific language
+ * @param language - Language code (defaults to EN)
+ */
+export declare function getArc42ReferenceForLanguage(language?: Arc42Language): Arc42Reference;
 /**
  * Get a formatted string describing the arc42 reference version
+ * @param language - Language code (defaults to EN)
  */
-export declare function getArc42ReferenceString(): string;
+export declare function getArc42ReferenceString(language?: Arc42Language): string;
 /**
  * Get the full reference information as a Markdown block
+ * @param language - Language code (defaults to EN)
  */
-export declare function getArc42ReferenceMarkdown(): string;
+export declare function getArc42ReferenceMarkdown(language?: Arc42Language): string;
 /**
  * Get reference info suitable for config.yaml
+ * @param language - Language code (defaults to EN)
  */
-export declare function getArc42ReferenceConfig(): Record<string, string>;
+export declare function getArc42ReferenceConfig(language?: Arc42Language): Record<string, string>;
 /**
  * Force reload the reference from submodule (useful for testing)
+ * @param language - Language code (defaults to EN)
  */
-export declare function reloadArc42Reference(): Arc42Reference;
+export declare function reloadArc42Reference(language?: Arc42Language): Arc42Reference;
 //# sourceMappingURL=arc42-reference.d.ts.map

package/dist/templates/arc42-reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arc42-reference.d.ts","sourceRoot":"","sources":["../../src/templates/arc42-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAeH,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,4DAA4D;IAC5D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAkB9F;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAwB9C;AAwDD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,cAAqC,CAAC;AAEpE;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAQlD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}
+{"version":3,"file":"arc42-reference.d.ts","sourceRoot":"","sources":["../../src/templates/arc42-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;AAExG,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,EAAE,aAAoB,CAAC;AAEpD,sCAAsC;AACtC,eAAO,MAAM,mBAAmB,EAAE,aAAa,EAAwE,CAAC;AASxH,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,4CAA4C;IAC5C,QAAQ,EAAE,aAAa,CAAC;IACxB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAkB9F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAiD9C;AA6DD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,cAAqC,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,GAAE,aAAgC,GAAG,cAAc,CAEvG;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,MAAM,CAGxE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,MAAM,CAU1E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASxF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,cAAc,CAE7E"}

package/dist/templates/arc42-reference.js

@@ -5,18 +5,26 @@
  * When the submodule is updated, this file automatically reflects the new version.
  *
  * Source: https://github.com/arc42/arc42-template
- * Version file: vendor/arc42-template/EN/version.properties
+ * Version file: vendor/arc42-template/{LANG}/version.properties
  */
 import { existsSync, readFileSync } from 'fs';
-import { execSync } from 'child_process';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 // Path to submodule (relative to src/templates/)
 const SUBMODULE_PATH = join(__dirname, '../../vendor/arc42-template');
-const VERSION_FILE = join(SUBMODULE_PATH, 'EN/version.properties');
 const SOURCE_REPO = 'https://github.com/arc42/arc42-template';
+/** Default language for arc42 templates */
+export const DEFAULT_LANGUAGE = 'EN';
+/** List of all supported languages */
+export const SUPPORTED_LANGUAGES = ['EN', 'DE', 'ES', 'FR', 'IT', 'NL', 'PT', 'RU', 'CZ', 'UKR', 'ZH'];
+/**
+ * Get the version file path for a specific language
+ */
+function getVersionFilePath(language = DEFAULT_LANGUAGE) {
+    return join(SUBMODULE_PATH, language, 'version.properties');
+}
 /**
  * Parse version.properties file content
  * @internal Exported for testing purposes
@@ -39,64 +47,88 @@ export function parseVersionProperties(content) {
     };
 }
 /**
- * Get commit SHA from git submodule
+ * Get commit SHA from git submodule by reading .git files directly
+ * (Avoids shell access for security - no execSync required)
  * @internal Exported for testing purposes
  */
 export function getSubmoduleCommitSha() {
     try {
-        // Try to get commit from the submodule itself
-        const result = execSync('git rev-parse HEAD', {
-            cwd: SUBMODULE_PATH,
-            encoding: 'utf-8',
-            stdio: ['pipe', 'pipe', 'pipe']
-        });
-        return result.trim();
-    }
-    catch {
-        // Fallback: try to get from parent repo's submodule status
-        try {
-            const projectRoot = join(__dirname, '../..');
-            const result = execSync('git submodule status vendor/arc42-template', {
-                cwd: projectRoot,
-                encoding: 'utf-8',
-                stdio: ['pipe', 'pipe', 'pipe']
-            });
-            const match = result.match(/^\s*([a-f0-9]+)\s+vendor/);
-            return match ? match[1] : 'unknown';
+        // Method 1: Read from submodule's .git file (gitdir reference)
+        const submoduleGitPath = join(SUBMODULE_PATH, '.git');
+        if (existsSync(submoduleGitPath)) {
+            const gitContent = readFileSync(submoduleGitPath, 'utf-8').trim();
+            // .git file in submodule contains "gitdir: ../../.git/modules/vendor/arc42-template"
+            if (gitContent.startsWith('gitdir:')) {
+                const gitDir = gitContent.replace('gitdir:', '').trim();
+                const resolvedGitDir = join(SUBMODULE_PATH, gitDir);
+                const headPath = join(resolvedGitDir, 'HEAD');
+                if (existsSync(headPath)) {
+                    const headContent = readFileSync(headPath, 'utf-8').trim();
+                    // HEAD can be a direct commit SHA or a ref
+                    if (headContent.startsWith('ref:')) {
+                        const refPath = join(resolvedGitDir, headContent.replace('ref:', '').trim());
+                        if (existsSync(refPath)) {
+                            return readFileSync(refPath, 'utf-8').trim();
+                        }
+                    }
+                    else {
+                        // Direct commit SHA
+                        return headContent;
+                    }
+                }
+            }
         }
-        catch {
-            return 'unknown';
+        // Method 2: Read from parent repo's .git/modules directory
+        const projectRoot = join(__dirname, '../..');
+        const modulesHeadPath = join(projectRoot, '.git/modules/vendor/arc42-template/HEAD');
+        if (existsSync(modulesHeadPath)) {
+            const headContent = readFileSync(modulesHeadPath, 'utf-8').trim();
+            if (!headContent.startsWith('ref:')) {
+                return headContent;
+            }
+            // If it's a ref, resolve it
+            const refPath = join(projectRoot, '.git/modules/vendor/arc42-template', headContent.replace('ref:', '').trim());
+            if (existsSync(refPath)) {
+                return readFileSync(refPath, 'utf-8').trim();
+            }
         }
+        return 'unknown';
+    }
+    catch {
+        return 'unknown';
     }
 }
 /**
- * Read arc42 reference info from the submodule
+ * Read arc42 reference info from the submodule for a specific language
  * Falls back to hardcoded values if submodule is not available
+ * @param language - Language code (defaults to EN)
  */
-function loadArc42Reference() {
+function loadArc42Reference(language = DEFAULT_LANGUAGE) {
     // Default/fallback values (used when submodule not available, e.g., npm install)
     const fallback = {
-        version: '9.0-EN',
+        version: `9.0-${language}`,
         date: 'July 2025',
         commitSha: 'b29e08928644af7ae49f51d729d14313db0d934c',
         sourceRepo: SOURCE_REPO,
         submoduleAvailable: false,
+        language,
         notes: [
             'Templates adapted from AsciiDoc to Markdown format',
             'Section guidance text customized for AI-assisted documentation',
             'Fallback values used - submodule not available'
         ]
     };
+    const versionFile = getVersionFilePath(language);
     // Check if submodule exists
-    if (!existsSync(SUBMODULE_PATH) || !existsSync(VERSION_FILE)) {
+    if (!existsSync(SUBMODULE_PATH) || !existsSync(versionFile)) {
         return fallback;
     }
     try {
         // Read version.properties
-        const content = readFileSync(VERSION_FILE, 'utf-8');
+        const content = readFileSync(versionFile, 'utf-8');
         const { revnumber, revdate } = parseVersionProperties(content);
         if (!revnumber || !revdate) {
-            console.warn('Warning: Could not parse version.properties, using fallback');
+            console.warn(`Warning: Could not parse version.properties for ${language}, using fallback`);
             return fallback;
         }
         // Get commit SHA
@@ -107,6 +139,7 @@ function loadArc42Reference() {
             commitSha,
             sourceRepo: SOURCE_REPO,
             submoduleAvailable: true,
+            language,
             notes: [
                 'Templates adapted from AsciiDoc to Markdown format',
                 'Section guidance text customized for AI-assisted documentation'
@@ -114,48 +147,64 @@ function loadArc42Reference() {
         };
     }
     catch (error) {
-        console.warn('Warning: Failed to read from submodule, using fallback:', error);
+        console.warn(`Warning: Failed to read from submodule for ${language}, using fallback:`, error);
         return fallback;
     }
 }
 /**
  * Reference information for the arc42 template version this MCP server is based on.
- * This is loaded dynamically from the submodule at module initialization.
+ * This is loaded dynamically from the submodule at module initialization (default: English).
  */
 export const ARC42_REFERENCE = loadArc42Reference();
+/**
+ * Get arc42 reference information for a specific language
+ * @param language - Language code (defaults to EN)
+ */
+export function getArc42ReferenceForLanguage(language = DEFAULT_LANGUAGE) {
+    return loadArc42Reference(language);
+}
 /**
  * Get a formatted string describing the arc42 reference version
+ * @param language - Language code (defaults to EN)
  */
-export function getArc42ReferenceString() {
-    return `arc42 Template v${ARC42_REFERENCE.version} (${ARC42_REFERENCE.date})`;
+export function getArc42ReferenceString(language) {
+    const ref = language ? loadArc42Reference(language) : ARC42_REFERENCE;
+    return `arc42 Template v${ref.version} (${ref.date})`;
 }
 /**
  * Get the full reference information as a Markdown block
+ * @param language - Language code (defaults to EN)
  */
-export function getArc42ReferenceMarkdown() {
+export function getArc42ReferenceMarkdown(language) {
+    const ref = language ? loadArc42Reference(language) : ARC42_REFERENCE;
     return `---
 **arc42 Template Reference**
-- Version: ${ARC42_REFERENCE.version}
-- Date: ${ARC42_REFERENCE.date}
-- Source: [arc42-template](${ARC42_REFERENCE.sourceRepo})
-- Commit: \`${ARC42_REFERENCE.commitSha.substring(0, 7)}\`
+- Version: ${ref.version}
+- Date: ${ref.date}
+- Language: ${ref.language}
+- Source: [arc42-template](${ref.sourceRepo})
+- Commit: \`${ref.commitSha.substring(0, 7)}\`
 ---`;
 }
 /**
  * Get reference info suitable for config.yaml
+ * @param language - Language code (defaults to EN)
  */
-export function getArc42ReferenceConfig() {
+export function getArc42ReferenceConfig(language) {
+    const ref = language ? loadArc42Reference(language) : ARC42_REFERENCE;
     return {
-        arc42_template_version: ARC42_REFERENCE.version,
-        arc42_template_date: ARC42_REFERENCE.date,
-        arc42_template_source: ARC42_REFERENCE.sourceRepo,
-        arc42_template_commit: ARC42_REFERENCE.commitSha
+        arc42_template_version: ref.version,
+        arc42_template_date: ref.date,
+        arc42_template_language: ref.language,
+        arc42_template_source: ref.sourceRepo,
+        arc42_template_commit: ref.commitSha
     };
 }
 /**
  * Force reload the reference from submodule (useful for testing)
+ * @param language - Language code (defaults to EN)
  */
-export function reloadArc42Reference() {
-    return loadArc42Reference();
+export function reloadArc42Reference(language) {
+    return loadArc42Reference(language);
 }
 //# sourceMappingURL=arc42-reference.js.map

package/dist/templates/arc42-reference.js.map

@@ -1 +1 @@
-{"version":3,"file":"arc42-reference.js","sourceRoot":"","sources":["../../src/templates/arc42-reference.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"arc42-reference.js","sourceRoot":"","sources":["../../src/templates/arc42-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,iDAAiD;AACjD,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,6BAA6B,CAAC,CAAC;AACtE,MAAM,WAAW,GAAG,yCAAyC,CAAC;AAK9D,2CAA2C;AAC3C,MAAM,CAAC,MAAM,gBAAgB,GAAkB,IAAI,CAAC;AAEpD,sCAAsC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AAExH;;GAEG;AACH,SAAS,kBAAkB,CAAC,WAA0B,gBAAgB;IACpE,OAAO,IAAI,CAAC,cAAc,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;AAC9D,CAAC;AAmBD;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAA2B,EAAE,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAChD,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE;QACnC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE;KAChC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC;QACH,+DAA+D;QAC/D,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAElE,qFAAqF;YACrF,IAAI,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBACrC,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACxD,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;gBACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;gBAE9C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACzB,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;oBAE3D,2CAA2C;oBAC3C,IAAI,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;wBACnC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;wBAC7E,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;4BACxB,OAAO,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;wBAC/C,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,oBAAoB;wBACpB,OAAO,WAAW,CAAC;oBACrB,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,2DAA2D;QAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,yCAAyC,CAAC,CAAC;QACrF,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;YAChC,MAAM,WAAW,GAAG,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAClE,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpC,OAAO,WAAW,CAAC;YACrB,CAAC;YACD,4BAA4B;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,oCAAoC,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAChH,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxB,OAAO,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,WAA0B,gBAAgB;IACpE,iFAAiF;IACjF,MAAM,QAAQ,GAAmB;QAC/B,OAAO,EAAE,OAAO,QAAQ,EAAE;QAC1B,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,0CAA0C;QACrD,UAAU,EAAE,WAAW;QACvB,kBAAkB,EAAE,KAAK;QACzB,QAAQ;QACR,KAAK,EAAE;YACL,oDAAoD;YACpD,gEAAgE;YAChE,gDAAgD;SACjD;KACF,CAAC;IAEF,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAEjD,4BAA4B;IAC5B,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5D,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAE/D,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,mDAAmD,QAAQ,kBAAkB,CAAC,CAAC;YAC5F,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,iBAAiB;QACjB,MAAM,SAAS,GAAG,qBAAqB,EAAE,CAAC;QAE1C,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,IAAI,EAAE,OAAO;YACb,SAAS;YACT,UAAU,EAAE,WAAW;YACvB,kBAAkB,EAAE,IAAI;YACxB,QAAQ;YACR,KAAK,EAAE;gBACL,oDAAoD;gBACpD,gEAAgE;aACjE;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,8CAA8C,QAAQ,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAC/F,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAmB,kBAAkB,EAAE,CAAC;AAEpE;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,WAA0B,gBAAgB;IACrF,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAwB;IAC9D,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;IACtE,OAAO,mBAAmB,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAwB;IAChE,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;IACtE,OAAO;;aAEI,GAAG,CAAC,OAAO;UACd,GAAG,CAAC,IAAI;cACJ,GAAG,CAAC,QAAQ;6BACG,GAAG,CAAC,UAAU;cAC7B,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAwB;IAC9D,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;IACtE,OAAO;QACL,sBAAsB,EAAE,GAAG,CAAC,OAAO;QACnC,mBAAmB,EAAE,GAAG,CAAC,IAAI;QAC7B,uBAAuB,EAAE,GAAG,CAAC,QAAQ;QACrC,qBAAqB,EAAE,GAAG,CAAC,UAAU;QACrC,qBAAqB,EAAE,GAAG,CAAC,SAAS;KACrC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAwB;IAC3D,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h2nguyen/arc42-node-mcp-server",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "MCP server for arc42 architecture documentation - AI-assisted architecture documentation following arc42 template",
   "main": "dist/index.js",
   "type": "module",
@@ -44,7 +44,17 @@
     "email": "me@viethainguyen.de",
     "url": "https://github.com/h2nguyen"
   },
-  "license": "Apache-2.0",
+  "license": "(Apache-2.0 AND CC-BY-SA-4.0)",
+  "licenses": [
+    {
+      "type": "Apache-2.0",
+      "url": "https://github.com/h2nguyen/Arc42-Node-MCP-Server/blob/main/LICENSE"
+    },
+    {
+      "type": "CC-BY-SA-4.0",
+      "url": "https://github.com/h2nguyen/Arc42-Node-MCP-Server/blob/main/LICENSE-ARC42"
+    }
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/h2nguyen/Arc42-Node-MCP-Server.git"