@h2nguyen/arc42-node-mcp-server 1.0.2 → 2.0.0

package/dist/templates/locales/template-provider.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Localized Template Provider
+ *
+ * Provides language-aware template access with config.yaml integration.
+ * Acts as a facade simplifying the complexity of language selection and configuration.
+ *
+ * @module templates/locales/template-provider
+ *
+ * S.O.L.I.D Principles:
+ * - SRP (Single Responsibility Principle): Only retrieves templates
+ * - ISP (Interface Segregation Principle): Implements focused TemplateProvider interface
+ * - DIP (Dependency Inversion Principle): Depends on LanguageFactory abstraction
+ *
+ * Design Patterns:
+ * - Facade Pattern: Simplifies language/config complexity for tool handlers
+ */
+import type { Arc42Section } from '../../types.js';
+import type { LanguageCode, LanguageInfo } from './language-strategy.js';
+import type { LanguageFactory } from './language-factory.js';
+/**
+ * Section metadata with localized content
+ */
+export interface LocalizedSectionMetadata {
+    /** The section identifier */
+    section: Arc42Section;
+    /** Localized section title */
+    title: string;
+    /** Localized section description */
+    description: string;
+    /** The language code used */
+    languageCode: LanguageCode;
+}
+/**
+ * Localized Template Provider Class
+ *
+ * Provides a simplified interface for accessing templates in different languages.
+ * Integrates with config.yaml to read default language settings.
+ *
+ * @example
+ * ```typescript
+ * const provider = new LocalizedTemplateProvider(factory);
+ *
+ * // Get template with explicit language
+ * const deTemplate = provider.getTemplate('01_introduction_and_goals', 'DE');
+ *
+ * // Get template using config.yaml language
+ * const template = provider.getTemplateWithConfig('01_introduction_and_goals', workspacePath);
+ * ```
+ */
+export declare class LocalizedTemplateProvider {
+    /**
+     * The factory for creating language strategies
+     */
+    private readonly factory;
+    /**
+     * Create a new LocalizedTemplateProvider
+     *
+     * @param factory - The language factory for strategy creation
+     */
+    constructor(factory: LanguageFactory);
+    /**
+     * Get the template for a section in a specific language
+     *
+     * @param section - The arc42 section
+     * @param language - The language code (defaults to English)
+     * @returns The template content
+     */
+    getTemplate(section: Arc42Section, language?: string): string;
+    /**
+     * Get the template using config.yaml for default language
+     *
+     * @param section - The arc42 section
+     * @param workspacePath - Path to the workspace (or parent containing config.yaml)
+     * @param language - Optional override language (takes precedence over config)
+     * @returns The template content
+     */
+    getTemplateWithConfig(section: Arc42Section, workspacePath: string, language?: string): string;
+    /**
+     * Get section metadata in a specific language
+     *
+     * @param section - The arc42 section
+     * @param language - The language code (defaults to English)
+     * @returns The section metadata
+     */
+    getSectionMetadata(section: Arc42Section, language?: string): LocalizedSectionMetadata;
+    /**
+     * Get the workflow guide in a specific language
+     *
+     * @param language - The language code (defaults to English)
+     * @returns The workflow guide content
+     */
+    getWorkflowGuide(language?: string): string;
+    /**
+     * Get README content in a specific language
+     *
+     * @param language - The language code (defaults to English)
+     * @param projectName - Optional project name for README header
+     * @returns The README content
+     */
+    getReadmeContent(language?: string, projectName?: string): string;
+    /**
+     * Get all available languages
+     *
+     * @returns Array of language information objects
+     */
+    getAvailableLanguages(): LanguageInfo[];
+    /**
+     * Check if a language is supported
+     *
+     * @param language - The language code to check
+     * @returns True if the language is supported
+     */
+    isSupported(language: string): boolean;
+    /**
+     * Read the language setting from config.yaml
+     *
+     * @param workspacePath - Path to the workspace directory
+     * @returns The language code from config, or undefined if not found
+     */
+    readLanguageFromConfig(workspacePath: string): string | undefined;
+}
+//# sourceMappingURL=template-provider.d.ts.map

package/dist/templates/locales/template-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-provider.d.ts","sourceRoot":"","sources":["../../../src/templates/locales/template-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,6BAA6B;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,yBAAyB;IACpC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAE1C;;;;OAIG;gBACS,OAAO,EAAE,eAAe;IAIpC;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAO7D;;;;;;;OAOG;IACH,qBAAqB,CACnB,OAAO,EAAE,YAAY,EACrB,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;IAKT;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,wBAAwB;IAgBtF;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAO3C;;;;;;OAMG;IACH,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM;IAOjE;;;;OAIG;IACH,qBAAqB,IAAI,YAAY,EAAE;IAYvC;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAItC;;;;;OAKG;IACH,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAwBlE"}

package/dist/templates/locales/template-provider.js

@@ -0,0 +1,173 @@
+/**
+ * Localized Template Provider
+ *
+ * Provides language-aware template access with config.yaml integration.
+ * Acts as a facade simplifying the complexity of language selection and configuration.
+ *
+ * @module templates/locales/template-provider
+ *
+ * S.O.L.I.D Principles:
+ * - SRP (Single Responsibility Principle): Only retrieves templates
+ * - ISP (Interface Segregation Principle): Implements focused TemplateProvider interface
+ * - DIP (Dependency Inversion Principle): Depends on LanguageFactory abstraction
+ *
+ * Design Patterns:
+ * - Facade Pattern: Simplifies language/config complexity for tool handlers
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { parse as parseYaml } from 'yaml';
+/**
+ * Localized Template Provider Class
+ *
+ * Provides a simplified interface for accessing templates in different languages.
+ * Integrates with config.yaml to read default language settings.
+ *
+ * @example
+ * ```typescript
+ * const provider = new LocalizedTemplateProvider(factory);
+ *
+ * // Get template with explicit language
+ * const deTemplate = provider.getTemplate('01_introduction_and_goals', 'DE');
+ *
+ * // Get template using config.yaml language
+ * const template = provider.getTemplateWithConfig('01_introduction_and_goals', workspacePath);
+ * ```
+ */
+export class LocalizedTemplateProvider {
+    /**
+     * The factory for creating language strategies
+     */
+    factory;
+    /**
+     * Create a new LocalizedTemplateProvider
+     *
+     * @param factory - The language factory for strategy creation
+     */
+    constructor(factory) {
+        this.factory = factory;
+    }
+    /**
+     * Get the template for a section in a specific language
+     *
+     * @param section - The arc42 section
+     * @param language - The language code (defaults to English)
+     * @returns The template content
+     */
+    getTemplate(section, language) {
+        const strategy = language
+            ? this.factory.createWithFallback(language)
+            : this.factory.getDefault();
+        return strategy.getTemplate(section);
+    }
+    /**
+     * Get the template using config.yaml for default language
+     *
+     * @param section - The arc42 section
+     * @param workspacePath - Path to the workspace (or parent containing config.yaml)
+     * @param language - Optional override language (takes precedence over config)
+     * @returns The template content
+     */
+    getTemplateWithConfig(section, workspacePath, language) {
+        const effectiveLanguage = language || this.readLanguageFromConfig(workspacePath) || 'EN';
+        return this.getTemplate(section, effectiveLanguage);
+    }
+    /**
+     * Get section metadata in a specific language
+     *
+     * @param section - The arc42 section
+     * @param language - The language code (defaults to English)
+     * @returns The section metadata
+     */
+    getSectionMetadata(section, language) {
+        const strategy = language
+            ? this.factory.createWithFallback(language)
+            : this.factory.getDefault();
+        const title = strategy.getSectionTitle(section);
+        const description = strategy.getSectionDescription(section);
+        return {
+            section,
+            title: title.title,
+            description: description.description,
+            languageCode: strategy.code
+        };
+    }
+    /**
+     * Get the workflow guide in a specific language
+     *
+     * @param language - The language code (defaults to English)
+     * @returns The workflow guide content
+     */
+    getWorkflowGuide(language) {
+        const strategy = language
+            ? this.factory.createWithFallback(language)
+            : this.factory.getDefault();
+        return strategy.getWorkflowGuide();
+    }
+    /**
+     * Get README content in a specific language
+     *
+     * @param language - The language code (defaults to English)
+     * @param projectName - Optional project name for README header
+     * @returns The README content
+     */
+    getReadmeContent(language, projectName) {
+        const strategy = language
+            ? this.factory.createWithFallback(language)
+            : this.factory.getDefault();
+        return strategy.getReadmeContent(projectName);
+    }
+    /**
+     * Get all available languages
+     *
+     * @returns Array of language information objects
+     */
+    getAvailableLanguages() {
+        const codes = this.factory.getAvailableCodes();
+        return codes.map(code => {
+            const strategy = this.factory.create(code);
+            return {
+                code: strategy.code,
+                name: strategy.name,
+                nativeName: strategy.nativeName
+            };
+        });
+    }
+    /**
+     * Check if a language is supported
+     *
+     * @param language - The language code to check
+     * @returns True if the language is supported
+     */
+    isSupported(language) {
+        return this.factory.isSupported(language);
+    }
+    /**
+     * Read the language setting from config.yaml
+     *
+     * @param workspacePath - Path to the workspace directory
+     * @returns The language code from config, or undefined if not found
+     */
+    readLanguageFromConfig(workspacePath) {
+        const configPath = join(workspacePath, 'config.yaml');
+        if (!existsSync(configPath)) {
+            return undefined;
+        }
+        try {
+            const content = readFileSync(configPath, 'utf-8');
+            const config = parseYaml(content);
+            if (config && typeof config === 'object' && 'language' in config) {
+                const language = config.language;
+                if (typeof language === 'string') {
+                    return language.trim().toUpperCase();
+                }
+            }
+        }
+        catch {
+            // Config file exists but couldn't be parsed
+            return undefined;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=template-provider.js.map

package/dist/templates/locales/template-provider.js.map

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

package/dist/templates/locales/ukr/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Ukrainian Language Strategy
+ * @module templates/locales/ukr
+ */
+import type { LanguageStrategy } from '../language-strategy.js';
+export declare const ukrainianStrategy: LanguageStrategy;
+export { getSectionTitle, getSectionDescription } from './sections.js';
+export { getTemplate, getWorkflowGuide, getReadmeContent } from './templates.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/locales/ukr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/templates/locales/ukr/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAoC,MAAM,yBAAyB,CAAC;AAIlG,eAAO,MAAM,iBAAiB,EAAE,gBAwB/B,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/templates/locales/ukr/index.js

@@ -0,0 +1,29 @@
+/**
+ * Ukrainian Language Strategy
+ * @module templates/locales/ukr
+ */
+import { getSectionTitle, getSectionDescription } from './sections.js';
+import { getTemplate, getWorkflowGuide, getReadmeContent } from './templates.js';
+export const ukrainianStrategy = {
+    code: 'UKR',
+    name: 'Ukrainian',
+    nativeName: 'Українська',
+    getSectionTitle(section) {
+        return { title: getSectionTitle(section), section };
+    },
+    getSectionDescription(section) {
+        return { description: getSectionDescription(section), section };
+    },
+    getTemplate(section) {
+        return getTemplate(section);
+    },
+    getWorkflowGuide() {
+        return getWorkflowGuide();
+    },
+    getReadmeContent(projectName) {
+        return getReadmeContent(projectName);
+    }
+};
+export { getSectionTitle, getSectionDescription } from './sections.js';
+export { getTemplate, getWorkflowGuide, getReadmeContent } from './templates.js';
+//# sourceMappingURL=index.js.map

package/dist/templates/locales/ukr/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/templates/locales/ukr/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEjF,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,WAAW;IACjB,UAAU,EAAE,YAAY;IAExB,eAAe,CAAC,OAAqB;QACnC,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACtD,CAAC;IAED,qBAAqB,CAAC,OAAqB;QACzC,OAAO,EAAE,WAAW,EAAE,qBAAqB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IAClE,CAAC;IAED,WAAW,CAAC,OAAqB;QAC/B,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,gBAAgB;QACd,OAAO,gBAAgB,EAAE,CAAC;IAC5B,CAAC;IAED,gBAAgB,CAAC,WAAoB;QACnC,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;CACF,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/templates/locales/ukr/sections.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Ukrainian Section Titles and Descriptions
+ * @module templates/locales/ukr/sections
+ */
+import type { Arc42Section } from '../../../types.js';
+export declare const SECTION_TITLES: Record<Arc42Section, string>;
+export declare const SECTION_DESCRIPTIONS: Record<Arc42Section, string>;
+export declare function getSectionTitle(section: Arc42Section): string;
+export declare function getSectionDescription(section: Arc42Section): string;
+//# sourceMappingURL=sections.d.ts.map

package/dist/templates/locales/ukr/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../../../src/templates/locales/ukr/sections.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAavD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAa7D,CAAC;AAEF,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAE7D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAEnE"}

package/dist/templates/locales/ukr/sections.js

@@ -0,0 +1,39 @@
+/**
+ * Ukrainian Section Titles and Descriptions
+ * @module templates/locales/ukr/sections
+ */
+export const SECTION_TITLES = {
+    '01_introduction_and_goals': 'Вступ та цілі',
+    '02_architecture_constraints': 'Обмеження архітектури',
+    '03_context_and_scope': 'Контекст та обсяг',
+    '04_solution_strategy': 'Стратегія рішення',
+    '05_building_block_view': 'Вигляд будівельних блоків',
+    '06_runtime_view': 'Вигляд часу виконання',
+    '07_deployment_view': 'Вигляд розгортання',
+    '08_concepts': 'Наскрізні концепції',
+    '09_architecture_decisions': 'Архітектурні рішення',
+    '10_quality_requirements': 'Вимоги до якості',
+    '11_technical_risks': 'Ризики та технічний борг',
+    '12_glossary': 'Глосарій'
+};
+export const SECTION_DESCRIPTIONS = {
+    '01_introduction_and_goals': 'Постановка завдання, цілі якості та зацікавлені сторони',
+    '02_architecture_constraints': 'Технічні та організаційні обмеження',
+    '03_context_and_scope': 'Бізнес та технічний контекст, зовнішні інтерфейси',
+    '04_solution_strategy': 'Основні рішення та стратегії',
+    '05_building_block_view': 'Статична декомпозиція системи',
+    '06_runtime_view': 'Динамічна поведінка та важливі сценарії',
+    '07_deployment_view': 'Інфраструктура та розгортання',
+    '08_concepts': 'Наскрізні правила та підходи до рішення',
+    '09_architecture_decisions': 'Важливі, дорогі, критичні або ризиковані рішення',
+    '10_quality_requirements': 'Дерево якості та сценарії якості',
+    '11_technical_risks': 'Відомі проблеми, ризики та технічний борг',
+    '12_glossary': 'Важливі бізнес та технічні терміни'
+};
+export function getSectionTitle(section) {
+    return SECTION_TITLES[section];
+}
+export function getSectionDescription(section) {
+    return SECTION_DESCRIPTIONS[section];
+}
+//# sourceMappingURL=sections.js.map

package/dist/templates/locales/ukr/sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.js","sourceRoot":"","sources":["../../../../src/templates/locales/ukr/sections.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,cAAc,GAAiC;IAC1D,2BAA2B,EAAE,eAAe;IAC5C,6BAA6B,EAAE,uBAAuB;IACtD,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,wBAAwB,EAAE,2BAA2B;IACrD,iBAAiB,EAAE,uBAAuB;IAC1C,oBAAoB,EAAE,oBAAoB;IAC1C,aAAa,EAAE,qBAAqB;IACpC,2BAA2B,EAAE,sBAAsB;IACnD,yBAAyB,EAAE,kBAAkB;IAC7C,oBAAoB,EAAE,0BAA0B;IAChD,aAAa,EAAE,UAAU;CAC1B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,2BAA2B,EAAE,yDAAyD;IACtF,6BAA6B,EAAE,qCAAqC;IACpE,sBAAsB,EAAE,mDAAmD;IAC3E,sBAAsB,EAAE,8BAA8B;IACtD,wBAAwB,EAAE,+BAA+B;IACzD,iBAAiB,EAAE,yCAAyC;IAC5D,oBAAoB,EAAE,+BAA+B;IACrD,aAAa,EAAE,yCAAyC;IACxD,2BAA2B,EAAE,kDAAkD;IAC/E,yBAAyB,EAAE,kCAAkC;IAC7D,oBAAoB,EAAE,2CAA2C;IACjE,aAAa,EAAE,oCAAoC;CACpD,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,OAAqB;IACnD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAqB;IACzD,OAAO,oBAAoB,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/templates/locales/ukr/templates.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Ukrainian Templates
+ * @module templates/locales/ukr/templates
+ */
+import type { Arc42Section } from '../../../types.js';
+export declare function getTemplate(section: Arc42Section): string;
+export declare function getWorkflowGuide(): string;
+export declare function getReadmeContent(projectName?: string): string;
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates/locales/ukr/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../../src/templates/locales/ukr/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA8LzD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CA0BzC;AAED,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB7D"}

package/dist/templates/locales/ukr/templates.js

@@ -0,0 +1,242 @@
+/**
+ * Ukrainian Templates
+ * @module templates/locales/ukr/templates
+ */
+export function getTemplate(section) {
+    const templates = {
+        '01_introduction_and_goals': () => `# 1. Вступ та цілі
+
+## Огляд вимог
+
+**Мета**: Описати відповідні вимоги та рушійні сили.
+
+### Ключові вимоги
+
+| ID | Вимога | Пріоритет |
+|----|--------|-----------|
+| REQ-1 | [Короткий опис] | Високий |
+| REQ-2 | [Короткий опис] | Середній |
+
+## Цілі якості
+
+| Пріоритет | Ціль якості | Мотивація |
+|-----------|-------------|-----------|
+| 1 | [напр., Продуктивність] | [Чому це критично] |
+| 2 | [напр., Безпека] | [Чому це критично] |
+
+## Зацікавлені сторони
+
+| Роль/Ім'я | Контакт | Очікування |
+|-----------|---------|------------|
+| Власник продукту | [Ім'я/Email] | [Очікування від архітектури] |
+`,
+        '02_architecture_constraints': () => `# 2. Обмеження архітектури
+
+## Технічні обмеження
+
+| Обмеження | Обґрунтування |
+|-----------|---------------|
+| [напр., Хмарна платформа] | [Чому існує це обмеження] |
+
+## Організаційні обмеження
+
+| Обмеження | Обґрунтування |
+|-----------|---------------|
+| [напр., Структура команди] | [Як це впливає на архітектуру] |
+`,
+        '03_context_and_scope': () => `# 3. Контекст та обсяг
+
+## Бізнес-контекст
+
+### Діаграма контексту
+
+\`\`\`
+[Створіть діаграму, що показує вашу систему та зовнішні системи/користувачів]
+\`\`\`
+
+### Зовнішні інтерфейси
+
+| Зовнішня сутність | Інтерфейс | Призначення |
+|-------------------|-----------|-------------|
+| [Зовнішня система 1] | [API/Протокол] | [Які дані/функції обмінюються] |
+`,
+        '04_solution_strategy': () => `# 4. Стратегія рішення
+
+## Ключові рішення
+
+### Архітектурні патерни
+
+| Патерн | Мотивація | Наслідки |
+|--------|-----------|----------|
+| [напр., Мікросервіси] | [Чому обраний цей патерн] | [Переваги та компроміси] |
+
+### Технологічні рішення
+
+| Компонент | Технологія | Причина |
+|-----------|------------|---------|
+| Бекенд | [напр., Node.js] | [Чому обрано] |
+`,
+        '05_building_block_view': () => `# 5. Вигляд будівельних блоків
+
+## Рівень 1: Контекст системи
+
+\`\`\`
+[Діаграма компонентів з основними будівельними блоками]
+\`\`\`
+
+| Компонент | Відповідальність |
+|-----------|------------------|
+| [Компонент 1] | [Що робить] |
+`,
+        '06_runtime_view': () => `# 6. Вигляд часу виконання
+
+## Ключові сценарії
+
+### Сценарій 1: [Назва]
+
+**Опис**: [Що відбувається в цьому сценарії]
+
+\`\`\`mermaid
+sequenceDiagram
+    participant Користувач
+    participant Фронтенд
+    participant API
+\`\`\`
+`,
+        '07_deployment_view': () => `# 7. Вигляд розгортання
+
+## Огляд інфраструктури
+
+\`\`\`
+[Діаграма з серверами, контейнерами, мережами]
+\`\`\`
+
+| Компонент | Технологія | Конфігурація |
+|-----------|------------|--------------|
+| [Сервер додатків] | [AWS ECS] | [Специфікації] |
+`,
+        '08_concepts': () => `# 8. Наскрізні концепції
+
+## Доменні моделі
+
+| Сутність | Відповідальність | Зв'язки |
+|----------|------------------|---------|
+| [Сутність 1] | [Призначення] | [Пов'язані сутності] |
+
+## Безпека
+
+### Автентифікація
+- Метод: [JWT, OAuth2, тощо]
+`,
+        '09_architecture_decisions': () => `# 9. Архітектурні рішення
+
+### ADR-001: [Назва рішення]
+
+**Дата**: [РРРР-ММ-ДД]
+**Статус**: [Запропоновано | Прийнято | Застаріло]
+
+**Контекст**: [Опис проблеми]
+
+**Рішення**: [Що ми вирішили]
+
+**Наслідки**:
+- Позитивні: [Перевага 1]
+- Негативні: [Компроміс 1]
+`,
+        '10_quality_requirements': () => `# 10. Вимоги до якості
+
+## Дерево якості
+
+\`\`\`
+Якість
+├── Продуктивність
+├── Безпека
+├── Надійність
+└── Підтримуваність
+\`\`\`
+
+## Сценарії якості
+
+| Аспект | Опис |
+|--------|------|
+| Сценарій | Користувач запитує дані при нормальному навантаженні |
+| Міра | 95-й персентиль часу відповіді < 200мс |
+`,
+        '11_technical_risks': () => `# 11. Ризики та технічний борг
+
+## Ризики
+
+| Ризик | Ймовірність | Вплив | Статус |
+|-------|-------------|-------|--------|
+| [Ризик 1] | [Високий/Середній/Низький] | [Високий/Середній/Низький] | [Відкритий/Пом'якшений] |
+
+## Технічний борг
+
+| Елемент | Тип | Вплив | Пріоритет |
+|---------|-----|-------|-----------|
+| [Борг 1] | [Код/Архітектура] | [Високий/Середній/Низький] | [1-5] |
+`,
+        '12_glossary': () => `# 12. Глосарій
+
+## Бізнес-терміни
+
+| Термін | Визначення |
+|--------|------------|
+| [Бізнес-термін 1] | [Чітке, коротке визначення] |
+
+## Технічні терміни
+
+| Термін | Визначення | Синоніми |
+|--------|------------|----------|
+| [Технічний термін 1] | [Визначення] | [Альтернативні назви] |
+`
+    };
+    return templates[section]();
+}
+export function getWorkflowGuide() {
+    return `# Посібник з документування архітектури arc42
+
+## Огляд
+
+Цей посібник допоможе вам документувати архітектуру програмного забезпечення за допомогою шаблону arc42.
+
+## 12 розділів arc42
+
+1. **Вступ та цілі** - Визначте, що ви будуєте і чому
+2. **Обмеження архітектури** - Що вам НЕ дозволено робити?
+3. **Контекст та обсяг** - Що всередині, а що ззовні?
+4. **Стратегія рішення** - Високорівневий підхід
+5. **Вигляд будівельних блоків** - Статична структура
+6. **Вигляд часу виконання** - Динамічна поведінка
+7. **Вигляд розгортання** - Інфраструктура
+8. **Наскрізні концепції** - Патерни
+9. **Архітектурні рішення** - Важливі рішення
+10. **Вимоги до якості** - Сценарії якості
+11. **Ризики та технічний борг** - Що може піти не так?
+12. **Глосарій** - Визначення термінів
+
+## Ресурси
+
+- [arc42 Веб-сайт](https://arc42.org/)
+`;
+}
+export function getReadmeContent(projectName) {
+    const name = projectName || 'Проект';
+    return `# ${name} - Документація архітектури
+
+Цей каталог містить документацію архітектури для ${name}, засновану на шаблоні arc42.
+
+## Структура
+
+- \`sections/\` - Окремі markdown-файли розділів (12 розділів)
+- \`images/\` - Діаграми та зображення
+- \`config.yaml\` - Конфігурація
+
+## Початок роботи
+
+1. Почніть з розділу 1: Вступ та цілі
+2. Опрацьовуйте розділи ітеративно
+3. Використовуйте діаграми для ілюстрації концепцій
+`;
+}
+//# sourceMappingURL=templates.js.map