agent-ctx 1.0.0

package/dist/lib/wizard.js

@@ -0,0 +1,197 @@
+/**
+ * @fileoverview Wizard interactivo para configuración de proyectos
+ * @module lib/wizard
+ */
+import inquirer from 'inquirer';
+import { logger } from './logger.js';
+const frameworksByType = {
+    frontend: [
+        { name: 'React', value: 'react' },
+        { name: 'Vue.js', value: 'vue' },
+        { name: 'Next.js', value: 'nextjs' },
+        { name: 'Nuxt.js', value: 'nuxt' },
+        { name: 'Astro', value: 'astro' },
+        { name: 'Angular', value: 'angular' },
+        { name: 'Svelte/SvelteKit', value: 'svelte' },
+        { name: 'Vanilla JS/HTML', value: 'vanilla' }
+    ],
+    backend: [
+        { name: 'Node.js (Express)', value: 'express' },
+        { name: 'Node.js (Fastify)', value: 'fastify' },
+        { name: 'Node.js (NestJS)', value: 'nestjs' },
+        { name: 'Python (FastAPI)', value: 'fastapi' },
+        { name: 'Python (Django)', value: 'django' },
+        { name: 'PHP (Laravel)', value: 'laravel' },
+        { name: 'Go', value: 'go' },
+        { name: 'Rust', value: 'rust' }
+    ],
+    fullstack: [
+        { name: 'Next.js', value: 'nextjs' },
+        { name: 'Nuxt.js', value: 'nuxt' },
+        { name: 'Remix', value: 'remix' },
+        { name: 'T3 Stack', value: 't3' },
+        { name: 'Laravel + Vue/React', value: 'laravel-inertia' },
+        { name: 'Ruby on Rails', value: 'rails' }
+    ],
+    library: [
+        { name: 'TypeScript/JavaScript', value: 'ts-lib' },
+        { name: 'Python', value: 'python-lib' },
+        { name: 'Rust', value: 'rust-lib' }
+    ],
+    cli: [
+        { name: 'Node.js', value: 'node-cli' },
+        { name: 'Python', value: 'python-cli' },
+        { name: 'Bash/Shell', value: 'bash' },
+        { name: 'Go', value: 'go-cli' }
+    ]
+};
+/**
+ * Ejecuta el wizard interactivo para configurar el proyecto
+ */
+export async function runWizard() {
+    logger.header('🧙 Asistente de Configuración');
+    const answers = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'type',
+            message: '¿Qué tipo de proyecto es?',
+            choices: [
+                { name: '🎨 Frontend (web, mobile)', value: 'frontend' },
+                { name: '⚙️  Backend (API, servicios)', value: 'backend' },
+                { name: '🔄 Fullstack (ambos)', value: 'fullstack' },
+                { name: '📦 Librería/Package', value: 'library' },
+                { name: '🤖 CLI / Scripts', value: 'cli' }
+            ]
+        },
+        {
+            type: 'list',
+            name: 'framework',
+            message: '¿Cuál es el framework principal?',
+            choices: (prevAnswers) => {
+                return frameworksByType[prevAnswers.type] || [{ name: 'Otro', value: 'other' }];
+            }
+        },
+        {
+            type: 'confirm',
+            name: 'typescript',
+            message: '¿Usas TypeScript?',
+            default: true,
+            when: (prevAnswers) => ['frontend', 'backend', 'fullstack', 'library', 'cli'].includes(prevAnswers.type)
+        },
+        {
+            type: 'list',
+            name: 'styling',
+            message: '¿Qué usas para estilos?',
+            choices: [
+                { name: 'Tailwind CSS', value: 'tailwind' },
+                { name: 'CSS Modules', value: 'css-modules' },
+                { name: 'Styled Components', value: 'styled-components' },
+                { name: 'Sass/SCSS', value: 'sass' },
+                { name: 'CSS Vanilla', value: 'css' },
+                { name: 'N/A (Backend)', value: 'none' }
+            ],
+            when: (prevAnswers) => ['frontend', 'fullstack'].includes(prevAnswers.type)
+        },
+        {
+            type: 'checkbox',
+            name: 'features',
+            message: '¿Qué características adicionales usas?',
+            choices: [
+                { name: 'Base de datos (SQL)', value: 'sql' },
+                { name: 'Base de datos (NoSQL)', value: 'nosql' },
+                { name: 'Autenticación', value: 'auth' },
+                { name: 'API REST', value: 'rest' },
+                { name: 'GraphQL', value: 'graphql' },
+                { name: 'Testing (Jest/Vitest)', value: 'testing' },
+                { name: 'Docker', value: 'docker' },
+                { name: 'CI/CD', value: 'cicd' },
+                { name: 'Monorepo (Turborepo/Nx)', value: 'monorepo' }
+            ]
+        }
+    ]);
+    return answers;
+}
+const typeLabels = {
+    frontend: 'Frontend',
+    backend: 'Backend',
+    fullstack: 'Fullstack',
+    library: 'Librería',
+    cli: 'CLI'
+};
+const frameworkLabels = {
+    react: 'React',
+    vue: 'Vue.js',
+    nextjs: 'Next.js',
+    nuxt: 'Nuxt.js',
+    express: 'Express.js',
+    fastify: 'Fastify',
+    nestjs: 'NestJS',
+    fastapi: 'FastAPI',
+    django: 'Django',
+    laravel: 'Laravel'
+};
+/**
+ * Genera contenido de architecture.md basado en la configuración
+ */
+export function generateArchitecture(config) {
+    const { type, framework, typescript = false, styling, features } = config;
+    let content = `# 🏗️ Arquitectura del Proyecto
+
+## Objetivo
+<!-- Describe brevemente qué hace tu proyecto -->
+[Pendiente de completar]
+
+## Stack Tecnológico
+
+| Categoría | Tecnología |
+|-----------|------------|
+| Tipo | ${typeLabels[type] || type} |
+| Framework | ${frameworkLabels[framework] || framework} |
+| Lenguaje | ${typescript ? 'TypeScript' : 'JavaScript'} |
+`;
+    if (styling && styling !== 'none') {
+        content += `| Estilos | ${styling} |\n`;
+    }
+    if (features && features.length > 0) {
+        content += `| Features | ${features.join(', ')} |\n`;
+    }
+    content += `
+## Estructura de Directorios
+
+\`\`\`
+${framework === 'nextjs' ? `src/
+├── app/          # App Router
+├── components/   # Componentes React
+├── lib/          # Utilidades
+└── styles/       # CSS/Tailwind` :
+        framework === 'express' || framework === 'fastify' ? `src/
+├── routes/       # Endpoints API
+├── controllers/  # Lógica de negocio
+├── services/     # Servicios externos
+├── models/       # Modelos de datos
+└── middleware/   # Middleware` :
+            `src/
+├── components/   # Componentes
+├── lib/          # Utilidades
+├── services/     # Servicios
+└── types/        # Tipos TypeScript`}
+\`\`\`
+
+## Patrones Clave
+
+${typescript ? '- **TypeScript estricto**: Sin `any`, interfaces para todo\n' : ''}
+${features?.includes('testing') ? '- **Testing**: Jest/Vitest para unit tests\n' : ''}
+${features?.includes('auth') ? '- **Auth**: JWT / OAuth 2.0\n' : ''}
+${features?.includes('docker') ? '- **Docker**: Contenedores para desarrollo y producción\n' : ''}
+
+## Variables de Entorno
+
+\`\`\`bash
+# .env.example
+DATABASE_URL=
+API_KEY=
+\`\`\`
+`;
+    return content;
+}
+//# sourceMappingURL=wizard.js.map

package/dist/lib/wizard.js.map

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

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "agent-ctx",
+  "version": "1.0.0",
+  "description": "CLI tool to initialize and manage AI agent context for your projects",
+  "keywords": [
+    "ai",
+    "agent",
+    "context",
+    "cursor",
+    "antigravity",
+    "claude",
+    "copilot",
+    "cline",
+    "cli"
+  ],
+  "author": "avicdro",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "agent-ctx": "./dist/bin/agent-ctx.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src/templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "npm run build && node --test",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "figlet": "^1.10.0",
+    "inquirer": "^9.2.23",
+    "ora": "^8.0.1",
+    "tar": "^7.5.7"
+  },
+  "devDependencies": {
+    "@types/figlet": "^1.7.0",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^25.1.0",
+    "@types/tar": "^6.1.13",
+    "eslint": "^9.39.2",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/avicdro/agent-ctx"
+  },
+  "bugs": {
+    "url": "https://github.com/avicdro/agent-ctx/issues"
+  },
+  "homepage": "https://github.com/avicdro/agent-ctx#readme"
+}

package/src/templates/en/base/_agents.md

@@ -0,0 +1,62 @@
+# AI Agent Context
+
+> **READ THIS FIRST** — This file is the entry point for any AI agent working on this project.
+
+You are a senior expert developer joining this project.
+Your goal is to help build, refactor, and maintain this code by strictly following our architecture and rules.
+
+---
+
+## Knowledge Index
+
+Before writing **any** code, you **MUST** read and understand:
+
+| Priority | File | Purpose |
+|----------|------|---------|
+| 1 | `.context/architecture.md` | Full tech stack, project structure, data flow |
+| 2 | `.context/rules/coding-standards.md` | Coding conventions, TypeScript rules, naming |
+| 3 | `.context/project_state.md` | Current tasks, TODOs, blockers |
+| 4 | `.context/skills/` | Patterns for React, APIs, testing, etc. |
+
+---
+
+## Memory Bank
+
+For session persistence and context continuity, check:
+
+- `.context/memory/project_brief.md` — High-level project overview
+- `.context/memory/tech_context.md` — Technical decisions and their rationale
+- `.context/memory/active_context.md` — Current focus and recent changes
+- `.context/memory/progress.md` — Completed work and milestones
+
+---
+
+## Quick Start for Agents
+
+1. **Read** this file completely
+2. **Open** `.context/architecture.md` to understand the stack
+3. **Review** `.context/rules/coding-standards.md` for conventions
+4. **Check** `.context/project_state.md` for current priorities
+5. **Follow** all patterns in `.context/skills/` when applicable
+
+---
+
+## Project-Specific Instructions
+
+<!-- 
+TODO: Add your project-specific instructions here.
+Examples:
+- "Always use pnpm, not npm"
+- "Run `pnpm test` before committing"
+- "The main branch is protected, use feature branches"
+-->
+
+[Add your project-specific instructions here]
+
+---
+
+## Notes
+
+- This file was generated by [agent-ctx](https://github.com/avicdro/agent-ctx)
+- Customize all `.context/` files to match your project
+- Keep this file updated as your project evolves

package/src/templates/en/base/_architecture.md

@@ -0,0 +1,90 @@
+# Project Architecture
+
+## Project Goal
+
+[Describe in 2-3 lines what your application does and its main purpose.]
+
+## Tech Stack
+
+### Frontend
+| Technology | Version | Purpose |
+|------------|---------|---------|
+| [Framework] | vX.X | [Purpose] |
+| [UI Library] | vX.X | [Purpose] |
+| [State Mgmt] | vX.X | [Purpose] |
+
+### Backend
+| Technology | Version | Purpose |
+|------------|---------|---------|
+| [Runtime/Framework] | vX.X | [Purpose] |
+| [ORM/DB Client] | vX.X | [Purpose] |
+| [Auth] | vX.X | [Purpose] |
+
+### Database
+| Type | Technology | Purpose |
+|------|------------|---------|
+| Primary | [PostgreSQL/MySQL/MongoDB] | App data |
+| Cache | [Redis] | Sessions, cache |
+
+### Infrastructure
+| Service | Purpose |
+|---------|---------|
+| [Vercel/AWS/etc] | Hosting |
+| [Cloudflare/etc] | CDN |
+
+## Directory Structure
+
+```
+project/
+├── src/               # [Describe what it contains]
+│   ├── components/    # [Describe]
+│   ├── lib/           # [Describe]
+│   ├── pages/         # [Describe]
+│   └── styles/        # [Describe]
+├── public/            # Static assets
+├── tests/             # Tests
+└── config/            # Configurations
+```
+
+## Data Flow
+
+```
+[User] → [UI] → [API/Actions] → [DB] → [Response] → [UI Update]
+```
+
+1. The user interacts with [component/page]
+2. [Action/API call] is triggered
+3. [Service/ORM] processes the request
+4. [UI update mechanism]
+
+## Authentication and Authorization
+
+- **Method**: [JWT/Session/OAuth/etc]
+- **Provider**: [Auth0/Clerk/NextAuth/Custom]
+- **Roles**: [Admin, User, Guest, etc]
+
+## APIs and Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/xxx` | Description |
+| POST | `/api/xxx` | Description |
+
+## Critical Dependencies
+
+| Package | Why it's important |
+|---------|-------------------|
+| `package-name` | Reason why it's critical |
+
+## Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `DATABASE_URL` | DB connection | ✅ |
+| `API_KEY` | Service X key | ✅ |
+
+## Project Conventions
+
+- **Branches**: `main`, `develop`, `feature/*`, `fix/*`
+- **Commits**: Conventional Commits
+- **Code**: See `.context/rules/coding-standards.md`

package/src/templates/en/base/_bootstrap.md

@@ -0,0 +1,89 @@
+# AI Bootstrap Prompt
+
+> **DELETE THIS FILE** after your AI agent has completed the setup.
+> This is a one-time configuration helper.
+
+---
+
+## Mission
+
+You are helping me set up the AI context for this project. Your goal is to **analyze the existing code** and **populate the `.context/` files** with accurate information.
+
+---
+
+## Tasks
+
+Please complete the following tasks in order:
+
+### 1. Analyze the Project
+
+Scan the codebase and identify:
+- [ ] Programming languages used
+- [ ] Frameworks and libraries (check `package.json`, `requirements.txt`, `go.mod`, etc.)
+- [ ] Directory structure and its purpose
+- [ ] Entry points and main files
+- [ ] Database and external services
+- [ ] Build and test commands
+
+### 2. Update `.context/architecture.md`
+
+Based on your analysis, fill in:
+- **Project Goal**: What does this application do?
+- **Tech Stack**: Complete the tables with actual technologies
+- **Directory Structure**: Replace the example with the real structure
+- **Data Flow**: How do requests flow through the system?
+- **APIs**: Document the main endpoints
+- **Environment Variables**: List required env vars
+
+### 3. Update `.context/rules/coding-standards.md`
+
+Analyze the existing code style and document:
+- Naming conventions actually used
+- TypeScript/JavaScript patterns
+- Code formatting (tabs vs spaces, line length, etc.)
+- Testing patterns
+- Any linting rules (ESLint, Prettier config)
+
+### 4. Update `.context/project_state.md`
+
+Look for TODOs, FIXMEs, and pending work:
+- Current priorities
+- Known issues or bugs
+- Technical debt
+- Planned features
+
+### 5. Populate Memory Bank
+
+Update the files in `.context/memory/`:
+- `project_brief.md` — Summarize the project in a few paragraphs
+- `tech_context.md` — Why were these technologies chosen?
+- `active_context.md` — What's being worked on right now?
+- `progress.md` — What's already done?
+
+---
+
+## Completion Checklist
+
+When you're done, verify:
+
+- [ ] `AGENTS.md` has project-specific instructions added
+- [ ] `.context/architecture.md` reflects the actual stack
+- [ ] `.context/rules/coding-standards.md` matches the codebase style
+- [ ] `.context/project_state.md` has current TODOs
+- [ ] `.context/memory/` files are populated
+- [ ] All `[placeholder]` text has been replaced
+
+---
+
+## After Completion
+
+Once setup is complete:
+
+1. Review all generated files
+2. Make any manual adjustments
+3. **Delete this file** (`AI_BOOTSTRAP.md`)
+4. Commit the `.context/` directory to version control
+
+---
+
+*This file was generated by agent-ctx. It's a one-time helper and should be deleted after use.*

package/src/templates/en/base/_doc.md

@@ -0,0 +1,65 @@
+---
+type: doc-template
+target: .context/docs/{name}.md
+---
+
+# AI Guide
+
+You are helping the user create a documentation file. Follow these steps:
+1. Ask the user about the topic they want to document
+2. Determine the type of documentation (README, API docs, guide, etc.)
+3. Gather the necessary information
+4. Fill in the appropriate template
+
+# Questions to Ask
+
+1. What is the purpose of this documentation?
+2. Who is the target audience (developers, users, ops)?
+3. What are the main sections you want to include?
+4. Are there any code examples or commands to include?
+5. Are there any prerequisites or dependencies to mention?
+
+# Template Output - README Style
+
+```markdown
+# {Project/Feature Name}
+
+> {Brief description}
+
+## Overview
+
+{Detailed description of what this is and why it exists}
+
+## Prerequisites
+
+- {Prerequisite 1}
+- {Prerequisite 2}
+
+## Installation
+
+{Installation steps}
+
+## Usage
+
+{Basic usage examples}
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `option1` | string | - | Description |
+
+## Examples
+
+{Code examples with explanations}
+
+## Troubleshooting
+
+### Common Issue 1
+{Solution}
+
+## Related Documentation
+
+- [Link 1](url)
+- [Link 2](url)
+```

package/src/templates/en/base/_mcp.md

@@ -0,0 +1,81 @@
+---
+type: mcp-template
+target: .context/mcp/{name}.md
+---
+
+# AI Guide
+
+You are helping the user document an MCP (Model Context Protocol) server configuration. Follow these steps:
+1. Ask about the MCP server they're using or creating
+2. Gather the tools/resources it provides
+3. Document usage patterns and examples
+
+# Questions to Ask
+
+1. What is the name of the MCP server?
+2. What capabilities does it provide (tools, resources, prompts)?
+3. How is it configured/initialized?
+4. What are the main commands or tools available?
+5. Are there any environment variables or secrets needed?
+
+# Template Output
+
+```markdown
+# 🔌 MCP Server: {name}
+
+> {Brief description of what this server does}
+
+## Overview
+
+{What this MCP server provides and why it's useful}
+
+## Installation
+
+{How to install or enable this server}
+
+## Configuration
+
+```json
+{
+  "mcpServers": {
+    "{name}": {
+      "command": "{command}",
+      "args": ["{args}"],
+      "env": {
+        "VAR_NAME": "value"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+| Tool | Description | Parameters |
+|------|-------------|------------|
+| `tool_name` | What it does | `param1`, `param2` |
+
+## Available Resources
+
+| Resource | URI Pattern | Description |
+|----------|-------------|-------------|
+| `resource_name` | `protocol://path` | What it provides |
+
+## Usage Examples
+
+### Example 1: {Description}
+{How to use a specific tool or resource}
+
+### Example 2: {Description}
+{Another usage example}
+
+## Best Practices
+
+- {Best practice 1}
+- {Best practice 2}
+
+## Troubleshooting
+
+### {Common Issue}
+{Solution}
+```