@ggailabs/cli-context 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 AI Coders
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,197 @@
+# cli-context
+
+[![npm version](https://badge.fury.io/js/cli-context.svg)](https://www.npmjs.com/package/cli-context)
+[![CI](https://github.com/vinilana/ai-coders-context/actions/workflows/ci.yml/badge.svg)](https://github.com/vinilana/ai-coders-context/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+<img width="663" height="192" alt="image" src="https://github.com/user-attachments/assets/4b07f61d-6800-420a-ae91-6e952cbc790d" />
+
+A lightweight CLI that scaffolds living documentation and AI-agent playbooks for any repository—no LLMs or API keys required. The generated structure gives teams a consistent starting point for knowledge sharing while keeping everything under version control.
+
+## ⚙️ Requirements
+
+- Node.js 20+ (we currently test on 20, 22, 23, and 24)
+
+## ✨ What You Get
+
+- 📚 `docs/` folder with a documentation index plus ready-to-edit guides (overview, architecture, workflow, testing)
+- 🤖 `agents/` folder containing playbooks for common engineering agents and a handy index
+- 🔁 Repeatable scaffolding that you can re-run as the project evolves
+- 🧭 Repository-aware templates that highlight top-level directories for quick orientation
+- 🧠 AI-ready front matter and `agent-update` markers so assistants know exactly what to refresh
+
+## 📦 Installation
+
+Use `npx` to run the CLI without installing globally:
+
+```bash
+npx cli-context
+```
+
+Or add it to your dev dependencies:
+
+```bash
+npm install --save-dev cli-context
+```
+
+## 🚀 Quick Start
+
+```bash
+# Launch the interactive wizard
+npx cli-context
+
+
+# Scaffold docs and agents into ./.context
+npx cli-context init ./my-repo
+
+# Only generate docs
+npx cli-context init ./my-repo docs
+
+# Only generate agent playbooks, with a custom output directory
+npx cli-context init ./my-repo agents --output ./knowledge-base
+
+# Fill docs and agents with the repo context (preview the first 3 updates)
+npx cli-context fill ./my-repo --output ./.context --limit 3
+
+# Draft a collaboration plan seeded with agent and doc touchpoints
+npx cli-context plan release-readiness --output ./.context
+
+# Let the LLM enrich an existing plan with the latest context
+npx cli-context plan release-readiness --output ./.context --fill --dry-run
+```
+
+> ℹ️ The CLI pings npm for fresh releases at startup. Set `AI_CONTEXT_DISABLE_UPDATE_CHECK=true` to skip the check.
+
+After running the command, inspect the generated structure:
+
+```
+.context/
+├── agents/
+│   ├── README.md
+│   ├── code-reviewer.md
+│   └── ...
+└── docs/
+    ├── README.md
+    ├── architecture.md
+    └── ...
+```
+
+Customize the Markdown files to reflect your project’s specifics and commit them alongside the code.
+
+## 🧠 Guided Updates for AI Assistants
+
+Need help filling in the scaffold? Use [`prompts/update_scaffold_prompt.md`](./prompts/update_scaffold_prompt.md) as the canonical instruction set for any LLM or CLI agent. It walks through:
+
+- Gathering repository context and locating `agent-update`/`agent-fill` markers.
+- Updating documentation sections while satisfying the YAML front matter criteria.
+- Aligning agent playbooks with the refreshed docs and recording evidence for maintainers.
+
+Share that prompt verbatim with your assistant to keep updates consistent across teams.
+
+### Available Doc Guides & Agent Types
+
+The scaffold includes the following guides and playbooks out of the box:
+
+- Docs: `project-overview`, `architecture`, `development-workflow`, `testing-strategy`, `glossary`, `data-flow`, `security`, `tooling`
+- Agents: `code-reviewer`, `bug-fixer`, `feature-developer`, `refactoring-specialist`, `test-writer`, `documentation-writer`, `performance-optimizer`, `security-auditor`, `backend-specialist`, `frontend-specialist`, `architect-specialist`
+
+### AI Marker Reference
+
+- `<!-- agent-update:start:section-id --> … <!-- agent-update:end -->` wrap the sections that AI assistants should rewrite with up-to-date project knowledge.
+- `<!-- agent-fill:slot-id --> … <!-- /agent-fill -->` highlight inline placeholders that must be replaced with concrete details before removing the wrapper.
+- `<!-- agent-readonly:context -->` flags guidance that should remain as-is; treat the adjacent content as instructions rather than editable prose.
+
+When contributing, focus edits inside `agent-update` regions or `agent-fill` placeholders and leave `agent-readonly` guidance untouched unless you have explicit maintainer approval.
+
+## 🛠 Commands
+
+### `init`
+Scaffold documentation and/or agent playbooks.
+
+```
+Usage: cli-context init <repo-path> [type]
+
+Arguments:
+  repo-path               Path to the repository you want to scan
+  type                    "docs", "agents", or "both" (default)
+
+Options:
+  -o, --output <dir>      Output directory (default: ./.context)
+  --exclude <patterns...> Glob patterns to skip during the scan
+  --include <patterns...> Glob patterns to explicitly include
+  -v, --verbose           Print detailed progress information
+  -h, --help              Display help for command
+```
+
+### `fill`
+Use an LLM to refresh scaffolded docs and agent playbooks automatically.
+
+```
+Usage: cli-context fill <repo-path>
+
+Options:
+  -o, --output <dir>      Scaffold directory containing docs/ and agents/ (default: ./.context)
+  -k, --api-key <key>     API key for the selected LLM provider
+  -m, --model <model>     LLM model to use (default: x-ai/grok-4-fast)
+  -p, --provider <name>   Provider (openrouter only)
+      --base-url <url>    Custom base URL for OpenRouter
+      --prompt <file>     Instruction prompt to follow (optional; uses bundled instructions when omitted)
+      --limit <number>    Maximum number of files to update in one run
+  -h, --help              Display help for command
+```
+
+Under the hood, the command loads the prompt above, iterates over every Markdown file in `.context/docs` and `.context/agents`, and asks the LLM to produce the fully updated content.
+
+### `plan`
+Create a collaboration plan that links documentation guides and agent playbooks, or fill an existing plan with LLM assistance.
+
+```
+Usage: cli-context plan <plan-name>
+
+Options:
+  -o, --output <dir>      Scaffold directory containing docs/ and agents/ (default: ./.context)
+      --title <title>     Custom title for the plan document
+      --summary <text>    Seed the plan with a short summary or goal statement
+  -f, --force             Overwrite the plan if it already exists (scaffold mode)
+      --fill              Use an LLM to fill or update the plan instead of scaffolding
+  -r, --repo <path>       Repository root to summarize for additional context (fill mode)
+  -k, --api-key <key>     API key for the selected LLM provider (fill mode)
+  -m, --model <model>     LLM model to use (default: x-ai/grok-4-fast)
+  -p, --provider <name>   Provider (openrouter only)
+      --base-url <url>    Custom base URL for OpenRouter
+      --prompt <file>     Instruction prompt to follow (optional; uses bundled instructions when omitted)
+      --dry-run           Preview changes without writing files
+      --include <patterns...>  Glob patterns to include during repository analysis
+      --exclude <patterns...>  Glob patterns to exclude from repository analysis
+  -h, --help              Display help for command
+```
+
+In scaffold mode the command creates `.context/plans/<plan-name>.md`, keeps a `plans/README.md` index, and reminds contributors to consult the agent handbook before delegating work to an AI assistant. In fill mode it will scaffold the plan automatically if it does not exist, then read the plan plus its referenced docs and agent playbooks, send that context to the LLM, and either preview or write the updated Markdown.
+
+💡 Tip: run `npx cli-context` with no arguments to enter an interactive mode that guides you through scaffold and LLM-fill options.
+
+Prefer driving the update elsewhere? Just grab [`prompts/update_scaffold_prompt.md`](./prompts/update_scaffold_prompt.md) and run it in your favorite playground or agent host. When you’re ready to automate, drop your API key in `.env` (for example `OPENROUTER_API_KEY` and `OPENROUTER_MODEL`) and let `fill` handle the edits inline.
+
+## 🧰 Local Development
+
+```bash
+git clone https://github.com/vinilana/ai-coders-context.git
+cd ai-coders-context
+npm install
+npm run build
+npm run test
+```
+
+During development you can run the CLI directly against TypeScript sources:
+
+```bash
+npm run dev -- ./path/to/repo
+```
+
+## 🤝 Contributing
+
+See [`AGENTS.md`](./AGENTS.md) for contributor guidelines, coding standards, and release tips. Pull requests are welcome!
+
+## 📄 License
+
+MIT © Vinícius Lana

package/dist/generators/agents/agentConfig.d.ts

@@ -0,0 +1,4 @@
+import { AgentType } from './agentTypes';
+export declare const AGENT_RESPONSIBILITIES: Record<AgentType, string[]>;
+export declare const AGENT_BEST_PRACTICES: Record<AgentType, string[]>;
+//# sourceMappingURL=agentConfig.d.ts.map

package/dist/generators/agents/agentConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentConfig.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/agentConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CA2F9D,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAmF5D,CAAC"}

package/dist/generators/agents/agentConfig.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_BEST_PRACTICES = exports.AGENT_RESPONSIBILITIES = void 0;
+exports.AGENT_RESPONSIBILITIES = {
+    'code-reviewer': [
+        'Review code changes for quality, style, and best practices',
+        'Identify potential bugs and security issues',
+        'Ensure code follows project conventions',
+        'Provide constructive feedback and suggestions'
+    ],
+    'bug-fixer': [
+        'Analyze bug reports and error messages',
+        'Identify root causes of issues',
+        'Implement targeted fixes with minimal side effects',
+        'Test fixes thoroughly before deployment'
+    ],
+    'feature-developer': [
+        'Implement new features according to specifications',
+        'Design clean, maintainable code architecture',
+        'Integrate features with existing codebase',
+        'Write comprehensive tests for new functionality'
+    ],
+    'refactoring-specialist': [
+        'Identify code smells and improvement opportunities',
+        'Refactor code while maintaining functionality',
+        'Improve code organization and structure',
+        'Optimize performance where applicable'
+    ],
+    'test-writer': [
+        'Write comprehensive unit and integration tests',
+        'Ensure good test coverage across the codebase',
+        'Create test utilities and fixtures',
+        'Maintain and update existing tests'
+    ],
+    'documentation-writer': [
+        'Create clear, comprehensive documentation',
+        'Update existing documentation as code changes',
+        'Write helpful code comments and examples',
+        'Maintain README and API documentation'
+    ],
+    'performance-optimizer': [
+        'Identify performance bottlenecks',
+        'Optimize code for speed and efficiency',
+        'Implement caching strategies',
+        'Monitor and improve resource usage'
+    ],
+    'security-auditor': [
+        'Identify security vulnerabilities',
+        'Implement security best practices',
+        'Review dependencies for security issues',
+        'Ensure data protection and privacy compliance'
+    ],
+    'backend-specialist': [
+        'Design and implement server-side architecture',
+        'Create and maintain APIs and microservices',
+        'Optimize database queries and data models',
+        'Implement authentication and authorization',
+        'Handle server deployment and scaling'
+    ],
+    'frontend-specialist': [
+        'Design and implement user interfaces',
+        'Create responsive and accessible web applications',
+        'Optimize client-side performance and bundle sizes',
+        'Implement state management and routing',
+        'Ensure cross-browser compatibility'
+    ],
+    'architect-specialist': [
+        'Design overall system architecture and patterns',
+        'Define technical standards and best practices',
+        'Evaluate and recommend technology choices',
+        'Plan system scalability and maintainability',
+        'Create architectural documentation and diagrams'
+    ],
+    'devops-specialist': [
+        'Design and maintain CI/CD pipelines',
+        'Implement infrastructure as code',
+        'Configure monitoring and alerting systems',
+        'Manage container orchestration and deployments',
+        'Optimize cloud resources and cost efficiency'
+    ],
+    'database-specialist': [
+        'Design and optimize database schemas',
+        'Create and manage database migrations',
+        'Optimize query performance and indexing',
+        'Ensure data integrity and consistency',
+        'Implement backup and recovery strategies'
+    ],
+    'mobile-specialist': [
+        'Develop native and cross-platform mobile applications',
+        'Optimize mobile app performance and battery usage',
+        'Implement mobile-specific UI/UX patterns',
+        'Handle app store deployment and updates',
+        'Integrate push notifications and offline capabilities'
+    ]
+};
+exports.AGENT_BEST_PRACTICES = {
+    'code-reviewer': [
+        'Focus on maintainability and readability',
+        'Consider the broader impact of changes',
+        'Be constructive and specific in feedback'
+    ],
+    'bug-fixer': [
+        'Reproduce the bug before fixing',
+        'Write tests to prevent regression',
+        'Document the fix for future reference'
+    ],
+    'feature-developer': [
+        'Follow existing patterns and conventions',
+        'Consider edge cases and error handling',
+        'Write tests alongside implementation'
+    ],
+    'refactoring-specialist': [
+        'Make small, incremental changes',
+        'Ensure tests pass after each refactor',
+        'Preserve existing functionality exactly'
+    ],
+    'test-writer': [
+        'Write tests that are clear and maintainable',
+        'Test both happy path and edge cases',
+        'Use descriptive test names'
+    ],
+    'documentation-writer': [
+        'Keep documentation up-to-date with code',
+        'Write from the user\'s perspective',
+        'Include practical examples'
+    ],
+    'performance-optimizer': [
+        'Measure before optimizing',
+        'Focus on actual bottlenecks',
+        'Don\'t sacrifice readability unnecessarily'
+    ],
+    'security-auditor': [
+        'Follow security best practices',
+        'Stay updated on common vulnerabilities',
+        'Consider the principle of least privilege'
+    ],
+    'backend-specialist': [
+        'Design APIs according the specification of the project',
+        'Implement proper error handling and logging',
+        'Use appropriate design patterns and clean architecture',
+        'Consider scalability and performance from the start',
+        'Implement comprehensive testing for business logic'
+    ],
+    'frontend-specialist': [
+        'Follow modern frontend development patterns',
+        'Optimize for accessibility and user experience',
+        'Implement responsive design principles',
+        'Use component-based architecture effectively',
+        'Optimize performance and loading times'
+    ],
+    'architect-specialist': [
+        'Consider long-term maintainability and scalability',
+        'Balance technical debt with business requirements',
+        'Document architectural decisions and rationale',
+        'Promote code reusability and modularity',
+        'Stay updated on industry trends and technologies'
+    ],
+    'devops-specialist': [
+        'Automate everything that can be automated',
+        'Implement infrastructure as code for reproducibility',
+        'Monitor system health proactively',
+        'Design for failure and implement proper fallbacks',
+        'Keep security and compliance in every deployment'
+    ],
+    'database-specialist': [
+        'Always benchmark queries before and after optimization',
+        'Plan migrations with rollback strategies',
+        'Use appropriate indexing strategies for workloads',
+        'Maintain data consistency across transactions',
+        'Document schema changes and their business impact'
+    ],
+    'mobile-specialist': [
+        'Test on real devices, not just simulators',
+        'Optimize for battery life and data usage',
+        'Follow platform-specific design guidelines',
+        'Implement proper offline-first strategies',
+        'Plan for app store review requirements early'
+    ]
+};
+//# sourceMappingURL=agentConfig.js.map

package/dist/generators/agents/agentConfig.js.map

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

package/dist/generators/agents/agentGenerator.d.ts

@@ -0,0 +1,9 @@
+import { RepoStructure } from '../../types';
+export declare class AgentGenerator {
+    private readonly docTouchpoints;
+    constructor(..._legacyArgs: unknown[]);
+    generateAgentPrompts(repoStructure: RepoStructure, outputDir: string, selectedAgentTypes?: string[], verbose?: boolean): Promise<number>;
+    private resolveAgentSelection;
+    private buildContext;
+}
+//# sourceMappingURL=agentGenerator.d.ts.map

package/dist/generators/agents/agentGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgB5C,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAW7B;gBAEU,GAAG,WAAW,EAAE,OAAO,EAAE;IAG/B,oBAAoB,CACxB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAC7B,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,MAAM,CAAC;IAuBlB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,YAAY;CAerB"}

package/dist/generators/agents/agentGenerator.js

@@ -0,0 +1,97 @@
+"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.AgentGenerator = void 0;
+const path = __importStar(require("path"));
+const shared_1 = require("../shared");
+const agentTypes_1 = require("./agentTypes");
+const templates_1 = require("./templates");
+const guideRegistry_1 = require("../documentation/guideRegistry");
+class AgentGenerator {
+    constructor(..._legacyArgs) {
+        this.docTouchpoints = [
+            {
+                title: 'Documentation Index',
+                path: '../docs/README.md',
+                marker: 'agent-update:docs-index'
+            },
+            ...guideRegistry_1.DOCUMENT_GUIDES.map(guide => ({
+                title: guide.title,
+                path: `../docs/${guide.file}`,
+                marker: guide.marker
+            }))
+        ];
+    }
+    async generateAgentPrompts(repoStructure, outputDir, selectedAgentTypes, verbose = false) {
+        const agentsDir = path.join(outputDir, 'agents');
+        await shared_1.GeneratorUtils.ensureDirectoryAndLog(agentsDir, verbose, 'Generating agent scaffold in');
+        const context = this.buildContext(repoStructure);
+        const agentTypes = this.resolveAgentSelection(selectedAgentTypes);
+        let created = 0;
+        for (const agentType of agentTypes) {
+            const content = (0, templates_1.renderAgentPlaybook)(agentType, context.topLevelDirectories, this.docTouchpoints);
+            const filePath = path.join(agentsDir, `${agentType}.md`);
+            await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, `Created ${agentType}.md`);
+            created += 1;
+        }
+        const indexPath = path.join(agentsDir, 'README.md');
+        const indexContent = (0, templates_1.renderAgentIndex)(agentTypes);
+        await shared_1.GeneratorUtils.writeFileWithLogging(indexPath, indexContent, verbose, 'Created README.md');
+        created += 1;
+        return created;
+    }
+    resolveAgentSelection(selected) {
+        if (!selected || selected.length === 0) {
+            return agentTypes_1.AGENT_TYPES;
+        }
+        const allowed = new Set(agentTypes_1.AGENT_TYPES);
+        const filtered = selected.filter((agent) => allowed.has(agent));
+        return (filtered.length > 0 ? filtered : agentTypes_1.AGENT_TYPES);
+    }
+    buildContext(repoStructure) {
+        const directorySet = new Set();
+        repoStructure.directories.forEach(dir => {
+            const [firstSegment] = dir.relativePath.split(/[\\/]/).filter(Boolean);
+            if (firstSegment) {
+                directorySet.add(firstSegment);
+            }
+        });
+        return {
+            topLevelDirectories: Array.from(directorySet).sort()
+        };
+    }
+}
+exports.AgentGenerator = AgentGenerator;
+//# sourceMappingURL=agentGenerator.js.map

package/dist/generators/agents/agentGenerator.js.map

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

package/dist/generators/agents/agentTypes.d.ts

@@ -0,0 +1,4 @@
+export declare const AGENT_TYPES: readonly ["code-reviewer", "bug-fixer", "feature-developer", "refactoring-specialist", "test-writer", "documentation-writer", "performance-optimizer", "security-auditor", "backend-specialist", "frontend-specialist", "architect-specialist", "devops-specialist", "database-specialist", "mobile-specialist"];
+export type AgentType = typeof AGENT_TYPES[number];
+export declare const IMPORTANT_FILES: string[];
+//# sourceMappingURL=agentTypes.d.ts.map

package/dist/generators/agents/agentTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentTypes.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/agentTypes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,kTAed,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;AAEnD,eAAO,MAAM,eAAe,UAI3B,CAAC"}

package/dist/generators/agents/agentTypes.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMPORTANT_FILES = exports.AGENT_TYPES = void 0;
+exports.AGENT_TYPES = [
+    'code-reviewer',
+    'bug-fixer',
+    'feature-developer',
+    'refactoring-specialist',
+    'test-writer',
+    'documentation-writer',
+    'performance-optimizer',
+    'security-auditor',
+    'backend-specialist',
+    'frontend-specialist',
+    'architect-specialist',
+    'devops-specialist',
+    'database-specialist',
+    'mobile-specialist'
+];
+exports.IMPORTANT_FILES = [
+    'package.json', 'tsconfig.json', 'webpack.config.js',
+    'next.config.js', 'tailwind.config.js', 'README.md',
+    '.gitignore', 'Dockerfile', 'docker-compose.yml'
+];
+//# sourceMappingURL=agentTypes.js.map

package/dist/generators/agents/agentTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentTypes.js","sourceRoot":"","sources":["../../../src/generators/agents/agentTypes.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG;IACzB,eAAe;IACf,WAAW;IACX,mBAAmB;IACnB,wBAAwB;IACxB,aAAa;IACb,sBAAsB;IACtB,uBAAuB;IACvB,kBAAkB;IAClB,oBAAoB;IACpB,qBAAqB;IACrB,sBAAsB;IACtB,mBAAmB;IACnB,qBAAqB;IACrB,mBAAmB;CACX,CAAC;AAIE,QAAA,eAAe,GAAG;IAC7B,cAAc,EAAE,eAAe,EAAE,mBAAmB;IACpD,gBAAgB,EAAE,oBAAoB,EAAE,WAAW;IACnD,YAAY,EAAE,YAAY,EAAE,oBAAoB;CACjD,CAAC"}

package/dist/generators/agents/index.d.ts

@@ -0,0 +1,4 @@
+export { AgentGenerator } from './agentGenerator';
+export { AGENT_TYPES, AgentType, IMPORTANT_FILES } from './agentTypes';
+export { AGENT_RESPONSIBILITIES, AGENT_BEST_PRACTICES } from './agentConfig';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/dist/generators/agents/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_BEST_PRACTICES = exports.AGENT_RESPONSIBILITIES = exports.IMPORTANT_FILES = exports.AGENT_TYPES = exports.AgentGenerator = void 0;
+var agentGenerator_1 = require("./agentGenerator");
+Object.defineProperty(exports, "AgentGenerator", { enumerable: true, get: function () { return agentGenerator_1.AgentGenerator; } });
+var agentTypes_1 = require("./agentTypes");
+Object.defineProperty(exports, "AGENT_TYPES", { enumerable: true, get: function () { return agentTypes_1.AGENT_TYPES; } });
+Object.defineProperty(exports, "IMPORTANT_FILES", { enumerable: true, get: function () { return agentTypes_1.IMPORTANT_FILES; } });
+var agentConfig_1 = require("./agentConfig");
+Object.defineProperty(exports, "AGENT_RESPONSIBILITIES", { enumerable: true, get: function () { return agentConfig_1.AGENT_RESPONSIBILITIES; } });
+Object.defineProperty(exports, "AGENT_BEST_PRACTICES", { enumerable: true, get: function () { return agentConfig_1.AGENT_BEST_PRACTICES; } });
+//# sourceMappingURL=index.js.map

package/dist/generators/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generators/agents/index.ts"],"names":[],"mappings":";;;AAAA,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,2CAAuE;AAA9D,yGAAA,WAAW,OAAA;AAAa,6GAAA,eAAe,OAAA;AAChD,6CAA6E;AAApE,qHAAA,sBAAsB,OAAA;AAAE,mHAAA,oBAAoB,OAAA"}

package/dist/generators/agents/templates/index.d.ts

@@ -0,0 +1,4 @@
+export { renderAgentPlaybook } from './playbookTemplate';
+export { renderAgentIndex } from './indexTemplate';
+export type { AgentTemplateContext, DocTouchpoint } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/agents/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/generators/agents/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/generators/agents/templates/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAgentIndex = exports.renderAgentPlaybook = void 0;
+var playbookTemplate_1 = require("./playbookTemplate");
+Object.defineProperty(exports, "renderAgentPlaybook", { enumerable: true, get: function () { return playbookTemplate_1.renderAgentPlaybook; } });
+var indexTemplate_1 = require("./indexTemplate");
+Object.defineProperty(exports, "renderAgentIndex", { enumerable: true, get: function () { return indexTemplate_1.renderAgentIndex; } });
+//# sourceMappingURL=index.js.map

package/dist/generators/agents/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/generators/agents/templates/index.ts"],"names":[],"mappings":";;;AAAA,uDAAyD;AAAhD,uHAAA,mBAAmB,OAAA;AAC5B,iDAAmD;AAA1C,iHAAA,gBAAgB,OAAA"}

package/dist/generators/agents/templates/indexTemplate.d.ts

@@ -0,0 +1,3 @@
+import { AgentType } from '../agentTypes';
+export declare function renderAgentIndex(agentTypes: readonly AgentType[]): string;
+//# sourceMappingURL=indexTemplate.d.ts.map

package/dist/generators/agents/templates/indexTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/agents/templates/indexTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAyBzE"}