@venizia/ignis-docs 0.0.1-2 → 0.0.1-4

package/README.md

@@ -21,13 +21,15 @@ Add to your Claude Desktop config (`claude_desktop_config.json`):
 {
   "mcpServers": {
     "ignis-docs": {
-      "command": "npx",
-      "args": ["@venizia/ignis-docs"]
+      "command": "bunx",
+      "args": ["@venizia/ignis-docs@latest"]
     }
   }
 }
 ```
 
+You can also `npx` for alternative
+
 ## Available MCP Tools
 
 | Tool | Description |
@@ -51,3 +53,407 @@ Ignis brings together the structured, enterprise development experience of **Loo
 ## License
 
 MIT
+
+---
+
+## MCP Docs Server | PROMP REQUEST: 
+
+**Question:** With Bun runtime + package management, create a monorepo project, "packages" is root folder of contain another project folder. Inside "packages" have two folder "be" and "fe". Just implement be with best practice ignis framework.
+
+---
+## Plan: Create Bun Workspace Monorepo with Production-Ready Ignis Backend
+
+## User Requirements ✅
+- **Backend Scope**: Production Starter Kit (CRUD API + Authentication + Components)
+- **Components**: Swagger (API Docs), Health Check, Authentication (JWT)
+- **Frontend**: Empty placeholder with basic package.json
+- **Architecture**: Follow Ignis best practices
+
+---
+
+## Implementation Plan
+
+### 1. Root Monorepo Setup
+
+**Files to create:**
+- `package.json` - Root workspace configuration
+- `.gitignore` - Ignore node_modules, dist, .env files
+- `README.md` - Project documentation
+
+**Root package.json structure:**
+```json
+{
+  "name": "ignis-monorepo",
+  "version": "1.0.0",
+  "private": true,
+  "workspaces": ["packages/*"],
+  "scripts": {
+    "be:dev": "bun --cwd packages/be run server:dev",
+    "be:build": "bun --cwd packages/be run build",
+    "be:lint": "bun --cwd packages/be run lint"
+  }
+}
+```
+
+---
+
+### 2. Backend Package Structure (`packages/be/`)
+
+**Directory structure:**
+```
+packages/be/
+├── package.json
+├── tsconfig.json
+├── .prettierrc.mjs
+├── .prettierignore
+├── eslint.config.mjs
+├── .env.example
+├── scripts/
+│   └── clean.sh
+└── src/
+    ├── index.ts              # Entry point
+    ├── application.ts        # Main application class
+    ├── migration.ts          # Drizzle migration config
+    ├── controllers/
+    │   ├── hello.controller.ts
+    │   └── todo.controller.ts
+    ├── services/
+    │   └── authentication.service.ts
+    ├── repositories/
+    │   └── todo.repository.ts
+    ├── datasources/
+    │   └── postgres.datasource.ts
+    └── models/
+        └── todo.model.ts
+```
+
+**Key decisions:**
+- PostgreSQL for database (as recommended in Ignis docs)
+- Todo CRUD as example implementation
+- JWT authentication with custom AuthenticationService
+- All three components: Swagger, Health Check, Authentication
+
+---
+
+### 3. Backend Dependencies
+
+**Production dependencies:**
+```bash
+bun add hono @hono/zod-openapi @scalar/hono-api-reference @venizia/ignis dotenv-flow
+bun add drizzle-orm drizzle-zod pg lodash
+```
+
+**Development dependencies:**
+```bash
+bun add -d typescript @types/bun @venizia/dev-configs tsc-alias tsconfig-paths
+bun add -d drizzle-kit @types/pg @types/lodash
+```
+
+---
+
+### 4. Configuration Files
+
+**tsconfig.json:**
+- Extend from `@venizia/dev-configs/tsconfig.common.json`
+- Configure path aliases: `@/*` → `src/*`
+- Output to `dist/`
+
+**.prettierrc.mjs:**
+- Import from `@venizia/dev-configs`
+
+**eslint.config.mjs:**
+- Import from `@venizia/dev-configs`
+
+**.env.example:**
+```env
+# Application
+HOST=0.0.0.0
+PORT=3000
+APP_ENV_APPLICATION_NAME=ignis-backend
+
+# Database
+APP_ENV_POSTGRES_HOST=localhost
+APP_ENV_POSTGRES_PORT=5432
+APP_ENV_POSTGRES_USERNAME=postgres
+APP_ENV_POSTGRES_PASSWORD=your_password
+APP_ENV_POSTGRES_DATABASE=ignis_db
+
+# Authentication (REQUIRED - Generate strong secrets!)
+APP_ENV_APPLICATION_SECRET=your-strong-application-secret-here
+APP_ENV_JWT_SECRET=your-strong-jwt-secret-here
+APP_ENV_JWT_EXPIRES_IN=86400
+```
+
+---
+
+### 5. Core Implementation Files
+
+#### `src/application.ts`
+**Features:**
+- Register PostgresDataSource
+- Register TodoRepository
+- Register TodoController, HelloController
+- Register AuthenticationService
+- Register all 3 components: HealthCheckComponent, SwaggerComponent, AuthenticateComponent
+- Register JWTAuthenticationStrategy
+- Configure app with base path `/api`
+
+#### `src/models/todo.model.ts`
+**Schema:**
+- `id` (UUID, auto-generated)
+- `title` (text, required)
+- `description` (text, optional)
+- `isCompleted` (boolean, default false)
+- `createdAt`, `modifiedAt` (timestamps, auto-generated)
+
+#### `src/datasources/postgres.datasource.ts`
+**Features:**
+- Connect to PostgreSQL using environment variables
+- Register Todo model schema
+- Implement connect/disconnect lifecycle
+
+#### `src/repositories/todo.repository.ts`
+**Features:**
+- Extend `DefaultCRUDRepository<TTodoSchema>`
+- Inject PostgresDataSource
+
+#### `src/controllers/todo.controller.ts`
+**Features:**
+- Use `ControllerFactory.defineCrudController()` for auto-generated CRUD endpoints
+- Base path: `/todos`
+- All operations protected by JWT (optional - can be added later)
+
+#### `src/controllers/hello.controller.ts`
+**Features:**
+- Simple GET `/hello` endpoint
+- Returns `{ message: "Hello, World!" }`
+- OpenAPI schema with Zod
+
+#### `src/services/authentication.service.ts`
+**Features:**
+- Implement `IAuthService` interface
+- `signIn()` method with hardcoded test credentials (test_username / test_password)
+- Generate JWT using JWTTokenService
+- TODO comments for production implementation (database lookup, password hashing)
+
+#### `src/migration.ts`
+**Features:**
+- Drizzle Kit configuration
+- Point to todo.model.ts
+- Use PostgreSQL dialect
+- Connection from environment variables
+
+#### `src/index.ts`
+**Features:**
+- Import dotenv-flow
+- Create Application instance
+- Start server
+
+---
+
+### 6. Frontend Package Structure (`packages/fe/`)
+
+**Minimal setup:**
+```
+packages/fe/
+├── package.json
+└── README.md
+```
+
+**package.json:**
+```json
+{
+  "name": "@ignis-monorepo/fe",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Frontend application - framework to be determined"
+}
+```
+
+**README.md:**
+```markdown
+# Frontend Application
+
+This folder is prepared for the frontend application.
+
+## Next Steps
+- Choose your framework (React, Vue, Svelte, etc.)
+- Run framework setup command
+- Configure to work with backend at http://localhost:3000/api
+```
+
+---
+
+### 7. Scripts and Utilities
+
+**packages/be/scripts/clean.sh:**
+- Remove `dist/`, `*.tsbuildinfo`, `.eslintcache`
+- Remove `artifact.zip`
+
+**packages/be/package.json scripts:**
+```json
+{
+  "lint": "bun run eslint && bun run prettier:cli",
+  "lint:fix": "bun run eslint --fix && bun run prettier:fix",
+  "prettier:cli": "prettier \"**/*.{js,ts}\" -l",
+  "prettier:fix": "bun run prettier:cli --write",
+  "eslint": "eslint --report-unused-disable-directives .",
+  "build": "tsc -p tsconfig.json && tsc-alias -p tsconfig.json",
+  "clean": "sh ./scripts/clean.sh",
+  "rebuild": "bun run clean && bun run build",
+  "migrate:dev": "NODE_ENV=development drizzle-kit push --config=src/migration.ts",
+  "generate-migration:dev": "NODE_ENV=development drizzle-kit generate --config=src/migration.ts",
+  "preserver:dev": "bun run rebuild",
+  "server:dev": "NODE_ENV=development bun .",
+  "server:prod": "NODE_ENV=production bun ."
+}
+```
+
+---
+
+### 8. Post-Setup Instructions
+
+**After implementation, user needs to:**
+
+1. **Create PostgreSQL database:**
+   ```bash
+   psql -U postgres
+   CREATE DATABASE ignis_db;
+   \q
+   ```
+
+2. **Copy .env.example to .env and configure:**
+   ```bash
+   cd packages/be
+   cp .env.example .env
+   # Edit .env with your database credentials and secrets
+   ```
+
+3. **Generate strong secrets:**
+   ```bash
+   # Use these commands to generate secrets:
+   openssl rand -base64 32  # For APP_ENV_APPLICATION_SECRET
+   openssl rand -base64 32  # For APP_ENV_JWT_SECRET
+   ```
+
+4. **Install dependencies:**
+   ```bash
+   bun install
+   ```
+
+5. **Run database migration:**
+   ```bash
+   bun run be:dev  # This will run migration automatically via preserver:dev
+   ```
+
+6. **Test the API:**
+   - Health check: `http://localhost:3000/health`
+   - API docs: `http://localhost:3000/doc/explorer`
+   - Hello endpoint: `http://localhost:3000/api/hello`
+   - Sign in: `POST http://localhost:3000/api/auth/sign-in` with `{"identifier": {"value": "test_username"}, "credential": {"value": "test_password"}}`
+   - Todos CRUD: `http://localhost:3000/api/todos`
+
+---
+
+### 9. Available Endpoints
+
+After setup, the following endpoints will be available:
+
+| Method | Path | Description | Auth Required |
+|--------|------|-------------|---------------|
+| `GET` | `/health` | Health check | No |
+| `POST` | `/health/ping` | Ping-pong test | No |
+| `GET` | `/doc/explorer` | Swagger UI (Scalar) | No |
+| `GET` | `/doc/openapi.json` | OpenAPI spec | No |
+| `GET` | `/api/hello` | Hello world | No |
+| `POST` | `/api/auth/sign-in` | JWT login | No |
+| `GET` | `/api/todos` | List todos | No* |
+| `POST` | `/api/todos` | Create todo | No* |
+| `GET` | `/api/todos/:id` | Get todo | No* |
+| `PATCH` | `/api/todos/:id` | Update todo | No* |
+| `DELETE` | `/api/todos/:id` | Delete todo | No* |
+
+*Note: Todo endpoints can be easily protected with JWT by adding `authStrategies: [Authentication.STRATEGY_JWT]` to route configs*
+
+---
+
+### 10. Critical Files to Create
+
+**Root level:**
+1. `package.json` - Workspace config
+2. `.gitignore` - Git ignore patterns
+3. `README.md` - Project documentation
+
+**packages/be/:**
+1. `package.json` - Backend dependencies and scripts
+2. `tsconfig.json` - TypeScript configuration
+3. `.prettierrc.mjs` - Prettier config
+4. `.prettierignore` - Prettier ignore patterns
+5. `eslint.config.mjs` - ESLint config
+6. `.env.example` - Environment variable template
+7. `scripts/clean.sh` - Cleanup script
+8. `src/index.ts` - Entry point
+9. `src/application.ts` - Main application class
+10. `src/migration.ts` - Database migration config
+11. `src/models/todo.model.ts` - Todo model
+12. `src/datasources/postgres.datasource.ts` - Database connection
+13. `src/repositories/todo.repository.ts` - Todo data access
+14. `src/controllers/todo.controller.ts` - Todo API endpoints
+15. `src/controllers/hello.controller.ts` - Hello endpoint
+16. `src/services/authentication.service.ts` - Auth logic
+
+**packages/fe/:**
+1. `package.json` - Frontend package placeholder
+2. `README.md` - Frontend setup instructions
+
+---
+
+## Architecture Summary
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     HTTP Requests                           │
+└──────────────────────┬──────────────────────────────────────┘
+                       │
+                       ▼
+         ┌─────────────────────────┐
+         │  Components Layer       │
+         │  • HealthCheckComponent │
+         │  • SwaggerComponent     │
+         │  • AuthenticateComponent│
+         └────────────┬────────────┘
+                      │
+                      ▼
+         ┌─────────────────────────┐
+         │  Controllers Layer      │
+         │  • HelloController      │
+         │  • TodoController       │
+         │  • (Auth auto-registered)│
+         └────────────┬────────────┘
+                      │
+                      ▼
+         ┌─────────────────────────┐
+         │  Services Layer         │
+         │  • AuthenticationService│
+         │  • (Business logic)     │
+         └────────────┬────────────┘
+                      │
+                      ▼
+         ┌─────────────────────────┐
+         │  Repositories Layer     │
+         │  • TodoRepository       │
+         └────────────┬────────────┘
+                      │
+                      ▼
+         ┌─────────────────────────┐
+         │  DataSources Layer      │
+         │  • PostgresDataSource   │
+         └────────────┬────────────┘
+                      │
+                      ▼
+         ┌─────────────────────────┐
+         │     PostgreSQL DB       │
+         └─────────────────────────┘
+```
+
+This follows Ignis layered architecture best practices with clear separation of concerns.

package/mcp-server/dist/common/config.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MCP_CONFIG = void 0;
 exports.MCP_CONFIG = {
     server: {
-        name: "ignis-docs",
-        version: "0.0.1",
+        name: 'ignis-docs',
+        version: '0.0.1',
     },
     search: {
         snippetLength: 300,
@@ -19,8 +19,8 @@ exports.MCP_CONFIG = {
         findAllMatches: true,
         ignoreLocation: true,
         keys: [
-            { name: "title", weight: 0.7 },
-            { name: "content", weight: 0.3 },
+            { name: 'title', weight: 0.7 },
+            { name: 'content', weight: 0.3 },
         ],
     },
 };

package/mcp-server/dist/common/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./paths";
-export * from "./config";
+export * from './paths';
+export * from './config';
 //# sourceMappingURL=index.d.ts.map

package/mcp-server/dist/common/paths.js

@@ -8,18 +8,18 @@ const node_path_1 = __importDefault(require("node:path"));
 const MCP_ROOT = __dirname;
 // When compiled, __dirname is mcp-server/dist/common
 // Go up 3 levels to reach package root: common -> dist -> mcp-server -> docs
-const DOCS_ROOT = node_path_1.default.resolve(MCP_ROOT, "..", "..", "..");
+const DOCS_ROOT = node_path_1.default.resolve(MCP_ROOT, '..', '..', '..');
 class Paths {
-    static { this.WIKI = node_path_1.default.join(DOCS_ROOT, "wiki"); }
-    static { this.GET_STARTED = node_path_1.default.join(this.WIKI, "get-started"); }
-    static { this.BEST_PRACTICES = node_path_1.default.join(this.GET_STARTED, "best-practices"); }
-    static { this.CORE_CONCEPTS = node_path_1.default.join(this.GET_STARTED, "core-concepts"); }
-    static { this.REFERENCES = node_path_1.default.join(this.WIKI, "references"); }
-    static { this.BASE = node_path_1.default.join(this.REFERENCES, "base"); }
-    static { this.COMPONENTS = node_path_1.default.join(this.REFERENCES, "components"); }
-    static { this.HELPERS = node_path_1.default.join(this.REFERENCES, "helpers"); }
-    static { this.SOURCE_DETAILS = node_path_1.default.join(this.REFERENCES, "src-details"); }
-    static { this.UTILITIES = node_path_1.default.join(this.REFERENCES, "utilities"); }
+    static { this.WIKI = node_path_1.default.join(DOCS_ROOT, 'wiki'); }
+    static { this.GET_STARTED = node_path_1.default.join(this.WIKI, 'get-started'); }
+    static { this.BEST_PRACTICES = node_path_1.default.join(this.GET_STARTED, 'best-practices'); }
+    static { this.CORE_CONCEPTS = node_path_1.default.join(this.GET_STARTED, 'core-concepts'); }
+    static { this.REFERENCES = node_path_1.default.join(this.WIKI, 'references'); }
+    static { this.BASE = node_path_1.default.join(this.REFERENCES, 'base'); }
+    static { this.COMPONENTS = node_path_1.default.join(this.REFERENCES, 'components'); }
+    static { this.HELPERS = node_path_1.default.join(this.REFERENCES, 'helpers'); }
+    static { this.SOURCE_DETAILS = node_path_1.default.join(this.REFERENCES, 'src-details'); }
+    static { this.UTILITIES = node_path_1.default.join(this.REFERENCES, 'utilities'); }
 }
 exports.Paths = Paths;
 //# sourceMappingURL=paths.js.map

package/mcp-server/dist/helpers/docs.helper.js

@@ -22,23 +22,23 @@ class DocsHelper {
             return this._docs;
         }
         try {
-            const files = await (0, fast_glob_1.default)("**/*.md", {
+            const files = await (0, fast_glob_1.default)('**/*.md', {
                 cwd: common_1.Paths.WIKI,
                 absolute: true,
-                ignore: ["node_modules"],
+                ignore: ['node_modules'],
             });
             if (files.length === 0) {
                 logger_helper_1.Logger.warn(`No documentation files found in ${common_1.Paths.WIKI}`);
                 return [];
             }
             this._docs = await Promise.all(files.map(async (file) => {
-                const rawContent = await promises_1.default.readFile(file, "utf-8");
+                const rawContent = await promises_1.default.readFile(file, 'utf-8');
                 const { data, content } = (0, gray_matter_1.default)(rawContent);
                 return {
                     id: node_path_1.default.relative(common_1.Paths.WIKI, file),
-                    title: data.title || node_path_1.default.basename(file, ".md"),
+                    title: data.title || node_path_1.default.basename(file, '.md'),
                     content,
-                    category: data.category || "Uncategorized",
+                    category: data.category || 'Uncategorized',
                     filePath: file,
                 };
             }));
@@ -50,8 +50,8 @@ class DocsHelper {
             return this._docs;
         }
         catch (error) {
-            logger_helper_1.Logger.error("Failed to load documentation:", error);
-            throw new Error(`Documentation loading failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+            logger_helper_1.Logger.error('Failed to load documentation:', error);
+            throw new Error(`Documentation loading failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
         }
     }
     /**
@@ -60,7 +60,7 @@ class DocsHelper {
     static clearCache() {
         this._docs = [];
         this._fuse = null;
-        logger_helper_1.Logger.debug("Documentation cache cleared");
+        logger_helper_1.Logger.debug('Documentation cache cleared');
     }
     /**
      * Generates a smart snippet from content.
@@ -70,8 +70,8 @@ class DocsHelper {
             return content;
         }
         const trimmed = content.substring(0, maxLength);
-        const lastSpace = trimmed.lastIndexOf(" ");
-        return (lastSpace > 0 ? trimmed.substring(0, lastSpace) : trimmed) + "...";
+        const lastSpace = trimmed.lastIndexOf(' ');
+        return (lastSpace > 0 ? trimmed.substring(0, lastSpace) : trimmed) + '...';
     }
     /**
      * Searches the loaded documentation.

package/mcp-server/dist/helpers/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./docs.helper";
-export * from "./logger.helper";
+export * from './docs.helper';
+export * from './logger.helper';
 //# sourceMappingURL=index.d.ts.map

package/mcp-server/dist/index.js

@@ -8,8 +8,8 @@ const tools_1 = require("./tools");
 // MCP SERVER CONFIGURATION
 // ----------------------------------------------------------------------------
 const mcpServer = new mcp_1.MCPServer({
-    name: "ignis-docs",
-    version: "0.0.1",
+    name: 'ignis-docs',
+    version: '0.0.1',
     // Register tools using singleton instances
     tools: {
         search: new tools_1.SearchDocsTool().getTool(),
@@ -28,12 +28,12 @@ const mcpServer = new mcp_1.MCPServer({
                     uri: `ignis://docs/${doc.id}`,
                     name: doc.title,
                     description: `${doc.category} - ${wordCount} words`,
-                    mimeType: "text/markdown",
+                    mimeType: 'text/markdown',
                 };
             });
         },
         getResourceContent: async ({ uri }) => {
-            const id = uri.replace("ignis://docs/", "");
+            const id = uri.replace('ignis://docs/', '');
             const content = await helpers_1.DocsHelper.getDocContent({ id });
             if (content === null) {
                 return { text: `Resource not found: ${id}` };
@@ -46,15 +46,15 @@ const mcpServer = new mcp_1.MCPServer({
 // SERVER INITIALIZATION
 // ----------------------------------------------------------------------------
 const main = async () => {
-    helpers_1.Logger.info("[main] Initializing Ignis MCP Documentation Server...");
+    helpers_1.Logger.info('[main] Initializing Ignis MCP Documentation Server...');
     try {
         await helpers_1.DocsHelper.loadDocumentation();
-        helpers_1.Logger.info("[main] Documentation loaded successfully.");
+        helpers_1.Logger.info('[main] Documentation loaded successfully.');
         await mcpServer.startStdio();
-        helpers_1.Logger.info("[main] Server started in Stdio mode.");
+        helpers_1.Logger.info('[main] Server started in Stdio mode.');
     }
     catch (error) {
-        helpers_1.Logger.error("Fatal error:", error);
+        helpers_1.Logger.error('Fatal error:', error);
         process.exit(1);
     }
 };

package/mcp-server/dist/tools/base.tool.d.ts

@@ -1,5 +1,5 @@
-import { createTool } from "@mastra/core/tools";
-import type { z } from "zod";
+import { createTool } from '@mastra/core/tools';
+import type { z } from 'zod';
 /**
  * The tool type returned by createTool.
  */

package/mcp-server/dist/tools/get-doc-content.tool.d.ts

@@ -1,5 +1,5 @@
-import { z } from "zod";
-import { BaseTool, type TMastraTool } from "./base.tool";
+import { z } from 'zod';
+import { BaseTool, type TMastraTool } from './base.tool';
 declare const InputSchema: z.ZodObject<{
     id: z.ZodString;
 }, z.core.$strip>;

package/mcp-server/dist/tools/get-doc-content.tool.js

@@ -85,12 +85,12 @@ const InputSchema = zod_1.z.object({
     id: zod_1.z.string().min(1).describe(ID_DESCRIPTION),
 });
 const OutputSchema = zod_1.z.object({
-    id: zod_1.z.string().describe("The document ID that was requested."),
+    id: zod_1.z.string().describe('The document ID that was requested.'),
     content: zod_1.z.string().optional().describe(CONTENT_DESCRIPTION),
     error: zod_1.z
         .string()
         .optional()
-        .describe("Error message if document not found. Verify the ID using listDocs or searchDocs."),
+        .describe('Error message if document not found. Verify the ID using listDocs or searchDocs.'),
 });
 // ----------------------------------------------------------------------------
 // TOOL CLASS
@@ -98,7 +98,7 @@ const OutputSchema = zod_1.z.object({
 class GetDocContentTool extends base_tool_1.BaseTool {
     constructor() {
         super(...arguments);
-        this.id = "getDocContent";
+        this.id = 'getDocContent';
         this.description = TOOL_DESCRIPTION;
         this.inputSchema = InputSchema;
         this.outputSchema = OutputSchema;
@@ -106,7 +106,7 @@ class GetDocContentTool extends base_tool_1.BaseTool {
     async execute(input) {
         const content = await helpers_1.DocsHelper.getDocContent({ id: input.id });
         if (!content) {
-            return { error: "Document not found", id: input.id };
+            return { error: 'Document not found', id: input.id };
         }
         return { content, id: input.id };
     }

package/mcp-server/dist/tools/get-doc-metadata.tool.d.ts

@@ -1,5 +1,5 @@
-import { z } from "zod";
-import { BaseTool, type TMastraTool } from "./base.tool";
+import { z } from 'zod';
+import { BaseTool, type TMastraTool } from './base.tool';
 declare const InputSchema: z.ZodObject<{
     id: z.ZodString;
 }, z.core.$strip>;

package/mcp-server/dist/tools/get-doc-metadata.tool.js

@@ -74,8 +74,8 @@ const InputSchema = zod_1.z.object({
     id: zod_1.z.string().min(1).describe(ID_DESCRIPTION),
 });
 const OutputSchema = zod_1.z.object({
-    id: zod_1.z.string().describe("The document ID that was requested."),
-    title: zod_1.z.string().optional().describe("Document title from frontmatter or filename."),
+    id: zod_1.z.string().describe('The document ID that was requested.'),
+    title: zod_1.z.string().optional().describe('Document title from frontmatter or filename.'),
     category: zod_1.z
         .string()
         .optional()
@@ -84,14 +84,14 @@ const OutputSchema = zod_1.z.object({
         .number()
         .int()
         .optional()
-        .describe("Total words. Useful for reading time estimation."),
-    charCount: zod_1.z.number().int().optional().describe("Total characters. Useful for token estimation."),
+        .describe('Total words. Useful for reading time estimation.'),
+    charCount: zod_1.z.number().int().optional().describe('Total characters. Useful for token estimation.'),
     lastModified: zod_1.z
         .string()
         .optional()
-        .describe("Last modified timestamp (ISO string). May be undefined."),
-    size: zod_1.z.number().int().optional().describe("File size in bytes. May be undefined."),
-    error: zod_1.z.string().optional().describe("Error message if document not found."),
+        .describe('Last modified timestamp (ISO string). May be undefined.'),
+    size: zod_1.z.number().int().optional().describe('File size in bytes. May be undefined.'),
+    error: zod_1.z.string().optional().describe('Error message if document not found.'),
 });
 // ----------------------------------------------------------------------------
 // TOOL CLASS
@@ -99,7 +99,7 @@ const OutputSchema = zod_1.z.object({
 class GetDocMetadataTool extends base_tool_1.BaseTool {
     constructor() {
         super(...arguments);
-        this.id = "getDocMetadata";
+        this.id = 'getDocMetadata';
         this.description = TOOL_DESCRIPTION;
         this.inputSchema = InputSchema;
         this.outputSchema = OutputSchema;
@@ -107,7 +107,7 @@ class GetDocMetadataTool extends base_tool_1.BaseTool {
     async execute(input) {
         const metadata = await helpers_1.DocsHelper.getDocMetadata({ id: input.id });
         if (!metadata) {
-            return { error: "Document not found", id: input.id };
+            return { error: 'Document not found', id: input.id };
         }
         return {
             ...metadata,

package/mcp-server/dist/tools/index.d.ts

@@ -1,8 +1,8 @@
-export { BaseTool } from "./base.tool";
-export type { TMastraTool as MastraTool } from "./base.tool";
-export { SearchDocsTool } from "./search-docs.tool";
-export { GetDocContentTool } from "./get-doc-content.tool";
-export { GetDocMetadataTool } from "./get-doc-metadata.tool";
-export { ListDocsTool } from "./list-docs.tool";
-export { ListCategoriesTool } from "./list-categories.tool";
+export { BaseTool } from './base.tool';
+export type { TMastraTool as MastraTool } from './base.tool';
+export { SearchDocsTool } from './search-docs.tool';
+export { GetDocContentTool } from './get-doc-content.tool';
+export { GetDocMetadataTool } from './get-doc-metadata.tool';
+export { ListDocsTool } from './list-docs.tool';
+export { ListCategoriesTool } from './list-categories.tool';
 //# sourceMappingURL=index.d.ts.map

package/mcp-server/dist/tools/list-categories.tool.d.ts

@@ -1,5 +1,5 @@
-import { z } from "zod";
-import { BaseTool, type TMastraTool } from "./base.tool";
+import { z } from 'zod';
+import { BaseTool, type TMastraTool } from './base.tool';
 declare const InputSchema: z.ZodObject<{}, z.core.$strip>;
 declare const OutputSchema: z.ZodObject<{
     count: z.ZodNumber;

package/mcp-server/dist/tools/list-categories.tool.js

@@ -68,9 +68,9 @@ Pass any category name to listDocs(category) to filter documents by that categor
 // ----------------------------------------------------------------------------
 // SCHEMAS
 // ----------------------------------------------------------------------------
-const InputSchema = zod_1.z.object({}).describe("No input parameters required.");
+const InputSchema = zod_1.z.object({}).describe('No input parameters required.');
 const OutputSchema = zod_1.z.object({
-    count: zod_1.z.number().int().describe("Total number of unique categories."),
+    count: zod_1.z.number().int().describe('Total number of unique categories.'),
     categories: zod_1.z.array(zod_1.z.string()).describe(CATEGORIES_DESCRIPTION),
 });
 // ----------------------------------------------------------------------------
@@ -79,7 +79,7 @@ const OutputSchema = zod_1.z.object({
 class ListCategoriesTool extends base_tool_1.BaseTool {
     constructor() {
         super(...arguments);
-        this.id = "listCategories";
+        this.id = 'listCategories';
         this.description = TOOL_DESCRIPTION;
         this.inputSchema = InputSchema;
         this.outputSchema = OutputSchema;

package/mcp-server/dist/tools/list-docs.tool.d.ts

@@ -1,5 +1,5 @@
-import { z } from "zod";
-import { BaseTool, type TMastraTool } from "./base.tool";
+import { z } from 'zod';
+import { BaseTool, type TMastraTool } from './base.tool';
 declare const InputSchema: z.ZodObject<{
     category: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/mcp-server/dist/tools/list-docs.tool.js

@@ -78,16 +78,16 @@ TIP: If unsure of exact category name, call listCategories first or omit this pa
 const DocEntrySchema = zod_1.z.object({
     id: zod_1.z
         .string()
-        .describe("Document ID (relative file path). Use with getDocContent or getDocMetadata."),
-    title: zod_1.z.string().describe("Document title from frontmatter or filename."),
-    category: zod_1.z.string().describe("Document category for organizational grouping."),
+        .describe('Document ID (relative file path). Use with getDocContent or getDocMetadata.'),
+    title: zod_1.z.string().describe('Document title from frontmatter or filename.'),
+    category: zod_1.z.string().describe('Document category for organizational grouping.'),
 });
 const InputSchema = zod_1.z.object({
     category: zod_1.z.string().optional().describe(CATEGORY_DESCRIPTION),
 });
 const OutputSchema = zod_1.z.object({
-    count: zod_1.z.number().int().describe("Total documents returned. Reflects filter if applied."),
-    docs: zod_1.z.array(DocEntrySchema).describe("Document entries with id, title, and category."),
+    count: zod_1.z.number().int().describe('Total documents returned. Reflects filter if applied.'),
+    docs: zod_1.z.array(DocEntrySchema).describe('Document entries with id, title, and category.'),
 });
 // ----------------------------------------------------------------------------
 // TOOL CLASS
@@ -95,7 +95,7 @@ const OutputSchema = zod_1.z.object({
 class ListDocsTool extends base_tool_1.BaseTool {
     constructor() {
         super(...arguments);
-        this.id = "listDocs";
+        this.id = 'listDocs';
         this.description = TOOL_DESCRIPTION;
         this.inputSchema = InputSchema;
         this.outputSchema = OutputSchema;

package/mcp-server/dist/tools/search-docs.tool.d.ts

@@ -1,5 +1,5 @@
-import { z } from "zod";
-import { BaseTool, type TMastraTool } from "./base.tool";
+import { z } from 'zod';
+import { BaseTool, type TMastraTool } from './base.tool';
 declare const InputSchema: z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;

package/mcp-server/dist/tools/search-docs.tool.js

@@ -70,11 +70,11 @@ RECOMMENDATIONS:
 const SearchResultSchema = zod_1.z.object({
     id: zod_1.z
         .string()
-        .describe("Unique document identifier (relative file path). Use with getDocContent to retrieve full document."),
-    title: zod_1.z.string().describe("Human-readable document title from frontmatter or filename."),
+        .describe('Unique document identifier (relative file path). Use with getDocContent to retrieve full document.'),
+    title: zod_1.z.string().describe('Human-readable document title from frontmatter or filename.'),
     category: zod_1.z.string().describe('Document category (e.g., "Getting Started", "References").'),
-    snippet: zod_1.z.string().describe("Content preview (max 300 chars) for quick assessment."),
-    score: zod_1.z.number().optional().describe("Relevance score 0-1 (lower = better match)."),
+    snippet: zod_1.z.string().describe('Content preview (max 300 chars) for quick assessment.'),
+    score: zod_1.z.number().optional().describe('Relevance score 0-1 (lower = better match).'),
 });
 const InputSchema = zod_1.z.object({
     query: zod_1.z.string().min(common_1.MCP_CONFIG.search.minQueryLength).describe(QUERY_DESCRIPTION),
@@ -89,7 +89,7 @@ const InputSchema = zod_1.z.object({
 const OutputSchema = zod_1.z.object({
     results: zod_1.z
         .array(SearchResultSchema)
-        .describe("Search results sorted by relevance. Empty array if no matches."),
+        .describe('Search results sorted by relevance. Empty array if no matches.'),
 });
 // ----------------------------------------------------------------------------
 // TOOL CLASS
@@ -97,7 +97,7 @@ const OutputSchema = zod_1.z.object({
 class SearchDocsTool extends base_tool_1.BaseTool {
     constructor() {
         super(...arguments);
-        this.id = "searchDocs";
+        this.id = 'searchDocs';
         this.description = TOOL_DESCRIPTION;
         this.inputSchema = InputSchema;
         this.outputSchema = OutputSchema;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis-docs",
-  "version": "0.0.1-2",
+  "version": "0.0.1-4",
   "description": "Documentation and MCP Server for Ignis Framework",
   "keywords": [
     "ignis",
@@ -53,14 +53,15 @@
     "prettier:fix": "bun run prettier:cli --write",
     "docs:dev": "vitepress dev site",
     "docs:clean": "sh ./scripts/docs-clean.sh",
-    "docs:build": "vitepress build site",
+    "docs:build": "sh ./scripts/docs-build.sh",
     "docs:preview": "vitepress preview site",
-    "premcp:build": "bun run mcp:clean",
-    "mcp:build": "tsc -p tsconfig.json",
+    "rebuild": "sh ./scripts/mcp-rebuild.sh no-version",
+    "mcp:rebuild": "bun run rebuild",
+    "mcp:build": "sh ./scripts/mcp-build.sh",
     "mcp:clean": "sh ./scripts/mcp-clean.sh",
     "mcp:start": "bun run mcp-server/index.ts",
     "mcp:dev": "bun --watch mcp-server/index.ts",
-    "prepublishOnly": "bun run mcp:build"
+    "prepublishOnly": "bun run mcp:rebuild"
   },
   "repository": {
     "type": "git",