antigravity-flow 1.0.0

package/README.md

@@ -0,0 +1,182 @@
+# 🚀 Antigravity Workflow CLI
+
+**Enforce strict, agentic workflows in your development projects.**
+
+Antigravity Flow (`ag-flow`) is a CLI tool originally built to prepare projects for **Google Antigravity**. It has since evolved into a **universal context generator** that standardizes development workflows for all AI-native IDEs, including **Cursor**, **Windsurf**, **Gemini Code Assist**, and **GitHub Copilot**.
+
+It generates context-aware rules, workflows, and CI/CD pipelines tailored to your project's technology stack and architecture.
+
+## ✨ Features
+
+- **🎭 Role-Based Workflows**: Generate specific prompt instructions for:
+  - Developers, QA, Lead Devs, Architects, POs, BAs
+  - **NEW**: DevOps, Security Engineers, Tech Writers, Data Engineers
+- **🏗️ Architecture-Aware**: Supports **Hexagonal**, **Clean**, **Vertical Slice (FSD)**, **MVC**, **Layered**, **Microservices**.
+- **🌐 Internationalization (I18n)**: Fully localized in **English** 🇺🇸 and **French** 🇫🇷.
+- **📏 Rigor Modes**:
+  - **Strict**: Enforces TDD, 100% coverage, no `any`, mandatory docs.
+  - **Standard**: Balanced approach with 80% coverage target.
+  - **Prototype**: Speed-focused, allows `// TODO` debt, optional TDD.
+  - **Legacy**: For maintaining older codebases with characterization tests.
+- **🤖 Agent Context**: Generates `.agent/project-context.md` to prime your AI agent.
+- **🔌 IDE Integration**: Automatically configures:
+  - **Cursor** (`.cursor/rules/*.mdc`)
+  - **Windsurf** (`.windsurfrules`, `.windsurf/rules/`)
+  - **Gemini Code Assist** (`.gemini/settings.json`)
+  - **GitHub Copilot**
+- **🚀 Generators**:
+  - **CI/CD**: GitHub Actions pipelines.
+  - **Dockerfile**: Production-ready, multi-stage builds.
+  - **.gitignore**: Optimized rules for your stack.
+- **💡 Intelligent Discovery**: Auto-detects your tech stack to pre-fill prompts.
+- **💾 Configuration Persistence**: Saves your choices to `.agent/antigravity.json`.
+- **📦 Monorepo Support**: Turborepo, Nx, Lerna, pnpm/yarn workspaces.
+
+## 📦 Installation
+
+```bash
+npm install -g antigravity-flow
+# Or run without installing:
+npx antigravity-flow init
+```
+
+## 🚀 Usage
+
+Navigate to your project root and run:
+
+```bash
+ag-flow init
+# or with configuration file (Non-interactive):
+ag-flow init --config ./antigravity.json
+# or
+npx antigravity-flow init
+```
+
+To view the comprehensive user guide directly in your terminal:
+
+```bash
+ag-flow guide
+# or for French:
+ag-flow guide fr
+```
+
+### Interactive Prompts
+
+The CLI will guide you through:
+
+1.  **Language**: English (en) or French (fr).
+2.  **Project Description**: Brief overview of your project.
+3.  **Tech Stack**:
+    - Frontend, Backend, Mobile, Smart Contracts
+4.  **Database & ORM**: PostgreSQL, MySQL, SQL Server, Oracle, MongoDB, etc.
+5.  **Architecture**: Hexagonal, Clean, MVC, Feature-Sliced, Microservices.
+6.  **Rigor Mode**: Strict, Standard, Prototype, Legacy.
+7.  **Version Control**: GitHub, GitLab, Azure DevOps, Bitbucket.
+8.  **Branching Strategy**: GitFlow, GitHub Flow, Trunk-Based.
+9.  **Package Manager**: npm, yarn, pnpm, bun, pip, poetry, cargo, etc.
+10. **Testing Framework**: Jest, Vitest, Playwright, Cypress, pytest, etc.
+11. **Deployment Platform**: Vercel, Netlify, AWS, Azure, GCP, Railway, etc.
+12. **Security Scanning**: Snyk, Dependabot, Renovate, SonarQube.
+13. **Monorepo**: Turborepo, Nx, Lerna, pnpm/yarn workspaces.
+14. **Roles**: Select which workflows to generate.
+15. **IDE Integration**: Cursor, Windsurf, Gemini, Copilot.
+
+## 📂 Output Structure
+
+```
+.
+├── .github/workflows/
+│   └── ci.yml                  # Generated CI/CD pipeline
+├── .agent/
+│   ├── workflows/              # Role-specific prompt templates
+│   │   ├── dev.md              # Developer workflow
+│   │   ├── qa.md               # QA workflow
+│   │   ├── architect.md        # Architect workflow
+│   │   ├── devops.md           # DevOps workflow (NEW)
+│   │   ├── security.md         # Security Engineer (NEW)
+│   │   ├── techwriter.md       # Tech Writer (NEW)
+│   │   └── data.md             # Data Engineer (NEW)
+│   ├── rules/
+│   │   └── coding-standards.md # Dynamic rules based on stack & rigor
+│   ├── project-context.md      # High-level context for AI
+│   └── antigravity.json        # Persisted configuration
+├── .cursor/rules/              # Cursor IDE rules (if selected)
+├── .windsurf/rules/            # Windsurf IDE rules (if selected)
+└── .gemini/settings.json       # Gemini Code Assist (if selected)
+```
+
+## 🛠️ Supported Stacks
+
+### Frontend
+
+| Framework        | Type       |
+| ---------------- | ---------- |
+| React            | SPA        |
+| Next.js          | SSR/SSG    |
+| Vue.js           | SPA        |
+| Nuxt.js          | SSR/SSG    |
+| Angular          | SPA        |
+| Svelte/SvelteKit | SPA/SSR    |
+| Remix            | SSR        |
+| Astro            | SSG        |
+| Flutter          | Mobile/Web |
+| React Native     | Mobile     |
+
+### Backend
+
+| Framework      | Language   |
+| -------------- | ---------- |
+| NestJS         | TypeScript |
+| Express        | JavaScript |
+| Fastify        | TypeScript |
+| FastAPI        | Python     |
+| Django         | Python     |
+| Flask          | Python     |
+| ASP.NET Core   | C#         |
+| Spring Boot    | Java       |
+| Go/Gin         | Go         |
+| Rust           | Rust       |
+| Elixir/Phoenix | Elixir     |
+
+### Databases
+
+| Relational | NoSQL     | Cloud       |
+| ---------- | --------- | ----------- |
+| PostgreSQL | MongoDB   | Supabase    |
+| MySQL      | Redis     | Firebase    |
+| SQL Server | Cassandra | DynamoDB    |
+| Oracle     |           | PlanetScale |
+| SQLite     |           | Neon        |
+
+### Smart Contracts
+
+| Platform  | Framework |
+| --------- | --------- |
+| Radix     | Scrypto   |
+| Ethereum  | Solidity  |
+| Solana    | Anchor    |
+| Sui/Aptos | Move      |
+| Polkadot  | ink!      |
+
+## 🎭 Available Roles
+
+| Role              | Description                         |
+| ----------------- | ----------------------------------- |
+| Developer         | Standard development loop with TDD  |
+| QA                | Testing, coverage, security testing |
+| Lead Developer    | Code review, standards, mentoring   |
+| Architect         | System design, ADRs, observability  |
+| Product Owner     | Backlog, INVEST, DoD/DoR            |
+| Business Analyst  | DDD, Event Storming, specs          |
+| **DevOps**        | CI/CD, IaC, monitoring              |
+| **Security**      | Audits, pentesting, compliance      |
+| **Tech Writer**   | API docs, guides, standards         |
+| **Data Engineer** | Pipelines, ETL, data quality        |
+
+## 🤝 Contributing
+
+Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
+
+## 📄 License
+
+[MIT](https://choosealicense.com/licenses/mit/)

package/dist/bin/ag-flow.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const commands_1 = require("../src/commands");
+const core_1 = require("../src/core");
+const adapters_1 = require("../src/adapters");
+const program = new commander_1.Command();
+// Wired Dependencies (Pure DI)
+const logger = new adapters_1.ConsoleLoggerAdapter();
+const fileSystem = new adapters_1.NodeFileSystemAdapter();
+const templatesDir = path.join(__dirname, '../src/templates');
+const localesDir = path.join(__dirname, '../src/locales');
+const localizationService = new adapters_1.JsonLocalizationAdapter(localesDir);
+// Allow override from .agent/templates
+const customTemplatesDir = path.join(process.cwd(), '.agent/templates');
+const templateProvider = new adapters_1.EjsTemplateAdapter(templatesDir, customTemplatesDir);
+const rulesComposer = new core_1.RulesComposer(templateProvider, localizationService);
+const contextGenerator = new core_1.ContextGenerator(templateProvider, localizationService);
+const pipelineGenerator = new core_1.PipelineGenerator(fileSystem, templateProvider, logger);
+const configService = new core_1.ConfigService(fileSystem, logger);
+const stackDetector = new core_1.StackDetector(fileSystem, logger);
+const gitignoreGenerator = new core_1.GitignoreGenerator(fileSystem, logger);
+const dockerfileGenerator = new core_1.DockerfileGenerator(fileSystem, templateProvider, logger);
+const workflowGenerator = new core_1.WorkflowGenerator(fileSystem, templateProvider, logger, localizationService, rulesComposer, contextGenerator);
+const initCommand = new commands_1.InitCommand(workflowGenerator, logger, localizationService, pipelineGenerator, configService, stackDetector, gitignoreGenerator, dockerfileGenerator, fileSystem);
+const guideCommand = new commands_1.GuideCommand(logger, localizationService, templateProvider, configService);
+const templatesCommand = new commands_1.TemplatesCommand(logger, localizationService, templatesDir, customTemplatesDir);
+program
+    .name('antigravity-flow')
+    .description('Antigravity Agent Workflow CLI')
+    .version('1.0.0');
+program
+    .command('init')
+    .description('Initialize agent workflows in the current directory')
+    .addHelpText('after', `
+    
+    Examples:
+      $ ag-flow init
+      
+    Description:
+      Starts an interactive wizard to configure the project.
+      It will ask for:
+      - Project Description
+      - Tech Stack (Frontend, Backend, Contracts)
+      - Rigor Mode (Strict vs Prototype)
+      - Monorepo Configuration
+      
+      It saves configuration to .agent/antigravity.json
+      It saves configuration to .agent/antigravity.json
+  `)
+    .option('-c, --config <path>', 'Path to configuration file')
+    .action(async (options) => {
+    await initCommand.execute(options);
+});
+program
+    .command('guide')
+    .description('Show comprehensive usage guide')
+    .argument('[lang]', 'Language (en/fr)', 'en')
+    .addHelpText('after', `
+
+    Examples:
+      $ ag-flow guide
+      $ ag-flow guide fr
+      
+    Description:
+      Displays the full user manual in the terminal.
+      If .agent/antigravity.json exists, it tries to use the configured language.
+      Otherwise, it defaults to English (or the provided argument).
+  `)
+    .action(async (lang) => {
+    await guideCommand.execute(lang);
+    await guideCommand.execute(lang);
+});
+program
+    .command('templates')
+    .description('Manage and customize templates')
+    .argument('[action]', 'Action to perform (list, update)', 'list')
+    .argument('[template]', 'Template name (for update action)')
+    .addHelpText('after', `
+    
+    Examples:
+      $ ag-flow templates list
+      $ ag-flow templates update docker/django.Dockerfile.ejs
+      
+    Description:
+      - list: Shows all available templates and indicates if they are customized.
+      - update: Opens the template in your default editor and saves a custom copy to .agent/templates/.
+  `)
+    .action(async (action, template) => {
+    await templatesCommand.execute(action, template);
+});
+program.parse(process.argv);

package/dist/src/adapters/ConsoleLoggerAdapter.js

@@ -0,0 +1,52 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleLoggerAdapter = void 0;
+const chalk = __importStar(require("chalk"));
+class ConsoleLoggerAdapter {
+    info(message) {
+        console.log(chalk.blue('ℹ'), message);
+    }
+    warn(message) {
+        console.log(chalk.yellow('⚠'), message);
+    }
+    error(message) {
+        console.error(chalk.red('✖'), message);
+    }
+    success(message) {
+        console.log(chalk.green('✔'), message);
+    }
+}
+exports.ConsoleLoggerAdapter = ConsoleLoggerAdapter;

package/dist/src/adapters/EjsTemplateAdapter.js

@@ -0,0 +1,66 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EjsTemplateAdapter = void 0;
+const ejs = __importStar(require("ejs"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+class EjsTemplateAdapter {
+    templatesDir;
+    customTemplatesDir;
+    constructor(templatesDir, customTemplatesDir) {
+        this.templatesDir = templatesDir;
+        this.customTemplatesDir = customTemplatesDir;
+    }
+    async getTemplate(templatePath) {
+        // 1. Check custom override
+        if (this.customTemplatesDir) {
+            const customPath = path.join(this.customTemplatesDir, templatePath);
+            if (await fs.pathExists(customPath)) {
+                return fs.readFile(customPath, 'utf8');
+            }
+        }
+        // 2. Fallback to built-in
+        const fullPath = path.join(this.templatesDir, templatePath);
+        if (!(await fs.pathExists(fullPath))) {
+            throw new Error(`Template not found: ${fullPath}`);
+        }
+        return fs.readFile(fullPath, 'utf8');
+    }
+    render(templateContent, data) {
+        return ejs.render(templateContent, data);
+    }
+}
+exports.EjsTemplateAdapter = EjsTemplateAdapter;

package/dist/src/adapters/JsonLocalizationAdapter.js

@@ -0,0 +1,81 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonLocalizationAdapter = void 0;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+class JsonLocalizationAdapter {
+    localesPath;
+    currentLang = 'en';
+    translations = {};
+    constructor(localesPath) {
+        this.localesPath = localesPath;
+    }
+    setLanguage(lang) {
+        this.currentLang = lang;
+        this.loadTranslations();
+    }
+    getLanguage() {
+        return this.currentLang;
+    }
+    translate(key, args) {
+        const keys = key.split('.');
+        let value = this.translations;
+        for (const k of keys) {
+            value = value?.[k];
+        }
+        if (typeof value !== 'string') {
+            console.warn(`Translation key '${key}' returned non-string value.`, value);
+            return key;
+        }
+        if (args) {
+            for (const [k, v] of Object.entries(args)) {
+                value = value.replace(`{{${k}}}`, v);
+            }
+        }
+        return value;
+    }
+    loadTranslations() {
+        const filePath = path.join(this.localesPath, `${this.currentLang}.json`);
+        if (fs.existsSync(filePath)) {
+            this.translations = fs.readJSONSync(filePath);
+        }
+        else {
+            console.warn(`Locale file not found: ${filePath}`);
+            this.translations = {};
+        }
+    }
+}
+exports.JsonLocalizationAdapter = JsonLocalizationAdapter;

package/dist/src/adapters/NodeFileSystemAdapter.js

@@ -0,0 +1,52 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeFileSystemAdapter = void 0;
+const fs = __importStar(require("fs-extra"));
+class NodeFileSystemAdapter {
+    async exists(path) {
+        return fs.pathExists(path);
+    }
+    async readFile(path) {
+        return fs.readFile(path, 'utf8');
+    }
+    async writeFile(path, content) {
+        await fs.writeFile(path, content, 'utf8');
+    }
+    async createDirectory(path) {
+        await fs.ensureDir(path);
+    }
+}
+exports.NodeFileSystemAdapter = NodeFileSystemAdapter;

package/dist/src/adapters/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./NodeFileSystemAdapter"), exports);
+__exportStar(require("./ConsoleLoggerAdapter"), exports);
+__exportStar(require("./EjsTemplateAdapter"), exports);
+__exportStar(require("./JsonLocalizationAdapter"), exports);

package/dist/src/commands/guide.js

@@ -0,0 +1,89 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GuideCommand = void 0;
+const path = __importStar(require("path"));
+class GuideCommand {
+    logger;
+    localizationService;
+    templateProvider;
+    configService;
+    constructor(logger, localizationService, templateProvider, configService) {
+        this.logger = logger;
+        this.localizationService = localizationService;
+        this.templateProvider = templateProvider;
+        this.configService = configService;
+    }
+    async execute(language) {
+        try {
+            // 1. Determine Language
+            let lang = language;
+            if (!lang) {
+                // Try to load from config
+                const projectRoot = process.cwd();
+                try {
+                    const config = await this.configService.loadConfig(projectRoot);
+                    if (config && config.language) {
+                        lang = config.language;
+                    }
+                }
+                catch (e) {
+                    // Ignore config load error, default to English
+                }
+            }
+            lang = lang || 'en';
+            this.localizationService.setLanguage(lang);
+            // 2. Load Guide Template
+            // Template provider usually expects paths relative to templates dir
+            // e.g. "en/guide.txt"
+            const templatePath = path.join(lang, 'guide.txt');
+            try {
+                const content = await this.templateProvider.getTemplate(templatePath);
+                // 3. Print
+                console.log(content);
+            }
+            catch (e) {
+                this.logger.error(`Could not load guide for language '${lang}'. Falling back to English.`);
+                const fallbackPath = path.join('en', 'guide.txt');
+                const content = await this.templateProvider.getTemplate(fallbackPath);
+                console.log(content);
+            }
+        }
+        catch (error) {
+            this.logger.error(`Failed to show guide: ${error.message}`);
+        }
+    }
+}
+exports.GuideCommand = GuideCommand;