@venizia/ignis-docs 0.0.1-1 → 0.0.1-10

package/dist/mcp-server/tools/github/verify-dependencies.tool.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerifyDependenciesTool = void 0;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const base_tool_1 = require("../base.tool");
+const helpers_1 = require("../../../mcp-server/helpers");
+// ----------------------------------------------------------------------------
+// DESCRIPTIONS
+// ----------------------------------------------------------------------------
+const TOOL_DESCRIPTION = `
+Verifies dependencies of a package within the Ignis monorepo against NPM registry.
+
+PURPOSE:
+Check for outdated dependencies. Reads package.json from a specific package,
+fetches latest version for each dependency from NPM registry, and reports
+which packages may need updating.
+
+WHEN TO USE:
+- To assess maintenance status of a package
+- To identify potential security risks from outdated dependencies
+- Before starting development, to see what needs updating
+- To answer user questions about package dependencies
+
+WHEN NOT TO USE:
+- This tool can be slow as it makes multiple network requests to NPM
+- For workspace dependencies (e.g., "workspace:*") - these are internal references
+
+NOTE: Version comparison is simplified (string comparison). Complex version ranges
+or intentionally pinned versions may show as "outdated" even when correct.
+`;
+const PACKAGE_PATH_DESCRIPTION = `
+The path to the package directory from the repository root.
+This directory must contain a 'package.json' file.
+
+EXAMPLES:
+- "packages/core"
+- "packages/helpers"
+- "examples/5-mins-qs"
+`;
+// ----------------------------------------------------------------------------
+// SCHEMAS
+// ----------------------------------------------------------------------------
+const DependencyInfoSchema = zod_1.z.object({
+    name: zod_1.z.string(),
+    currentVersion: zod_1.z.string(),
+    latestVersion: zod_1.z.string(),
+    isOutdated: zod_1.z.boolean(),
+});
+const InputSchema = zod_1.z.object({
+    packagePath: zod_1.z.string().describe(PACKAGE_PATH_DESCRIPTION),
+});
+const OutputSchema = zod_1.z.object({
+    packageName: zod_1.z.string().optional(),
+    dependencies: zod_1.z.array(DependencyInfoSchema).optional(),
+    devDependencies: zod_1.z.array(DependencyInfoSchema).optional(),
+    error: zod_1.z.string().optional(),
+});
+// ----------------------------------------------------------------------------
+// TOOL CLASS
+// ----------------------------------------------------------------------------
+class VerifyDependenciesTool extends base_tool_1.BaseTool {
+    constructor() {
+        super(...arguments);
+        this.id = 'verifyDependencies';
+        this.description = TOOL_DESCRIPTION;
+        this.inputSchema = InputSchema;
+        this.outputSchema = OutputSchema;
+    }
+    async getLatestVersion(opts) {
+        try {
+            const url = `https://registry.npmjs.org/${opts.packageName}/latest`;
+            const response = await fetch(url);
+            if (!response.ok) {
+                return 'unknown';
+            }
+            const data = (await response.json());
+            return data.version || 'unknown';
+        }
+        catch (error) {
+            helpers_1.Logger.warn(`Could not fetch latest version for ${opts.packageName}:`, error);
+            return 'unknown';
+        }
+    }
+    /**
+     * Extracts a clean semver version from various version specifiers.
+     * Returns null for non-standard versions that can't be compared.
+     */
+    parseVersion(opts) {
+        // Skip workspace, file, git, and URL references
+        if (opts.version.startsWith('workspace:') ||
+            opts.version.startsWith('file:') ||
+            opts.version.startsWith('git') ||
+            opts.version.startsWith('http') ||
+            opts.version === '*' ||
+            opts.version === 'latest') {
+            return null;
+        }
+        // Remove common prefixes: ^, ~, >=, >, <=, <, =
+        const cleaned = opts.version.replace(/^[\^~>=<]+/, '').trim();
+        // Handle version ranges (e.g., "1.0.0 || 2.0.0", ">=1.0.0 <2.0.0")
+        // Just take the first version-like string
+        const semverMatch = cleaned.match(/(\d+\.\d+\.\d+(?:-[\w.]+)?)/);
+        return semverMatch ? semverMatch[1] : null;
+    }
+    async processDependencies(opts) {
+        if (!opts.deps) {
+            return [];
+        }
+        const results = [];
+        for (const [name, version] of Object.entries(opts.deps)) {
+            const parsedVersion = this.parseVersion({ version });
+            // Skip non-standard versions
+            if (!parsedVersion) {
+                results.push({
+                    name,
+                    currentVersion: version,
+                    latestVersion: 'N/A',
+                    isOutdated: false,
+                });
+                continue;
+            }
+            const latestVersion = await this.getLatestVersion({ packageName: name });
+            results.push({
+                name,
+                currentVersion: parsedVersion,
+                latestVersion,
+                isOutdated: latestVersion !== 'unknown' && parsedVersion !== latestVersion,
+            });
+        }
+        return results;
+    }
+    async execute(opts) {
+        const packageJsonPath = `${opts.packagePath}/package.json`;
+        const result = await helpers_1.GithubHelper.getFileContent({ filePath: packageJsonPath });
+        if ('error' in result) {
+            return { error: `Could not read package.json at ${packageJsonPath}. Error: ${result.error}` };
+        }
+        try {
+            const packageJson = JSON.parse(result.content);
+            const [dependencies, devDependencies] = await Promise.all([
+                this.processDependencies({ deps: packageJson.dependencies }),
+                this.processDependencies({ deps: packageJson.devDependencies }),
+            ]);
+            return {
+                packageName: packageJson.name,
+                dependencies,
+                devDependencies,
+            };
+        }
+        catch (error) {
+            helpers_1.Logger.error('[execute] Failed to execute | Error: ', error);
+            return { error: `Failed to parse package.json at ${packageJsonPath}.` };
+        }
+    }
+    getTool() {
+        return (0, tools_1.createTool)({
+            id: this.id,
+            description: this.description,
+            inputSchema: this.inputSchema,
+            outputSchema: this.outputSchema,
+            execute: async ({ context }) => this.execute(context),
+        });
+    }
+}
+exports.VerifyDependenciesTool = VerifyDependenciesTool;
+//# sourceMappingURL=verify-dependencies.tool.js.map

package/dist/mcp-server/tools/github/verify-dependencies.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-dependencies.tool.js","sourceRoot":"","sources":["../../../../mcp-server/tools/github/verify-dependencies.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/github/view-source-file.tool.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { BaseTool, TMastraTool } from '../base.tool';
+declare const InputSchema: z.ZodObject<{
+    filePath: z.ZodString;
+}, z.core.$strip>;
+declare const OutputSchema: z.ZodObject<{
+    filePath: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare class ViewSourceFileTool extends BaseTool<typeof InputSchema, typeof OutputSchema> {
+    readonly id = "viewSourceFile";
+    readonly description = "\nRetrieves the full source code content of a specific file from the Ignis GitHub repository.\n\nPURPOSE:\nRead contents of a source file. Primary method for inspecting implementation details,\nunderstanding logic, and viewing exact code.\n\nWHEN TO USE:\n- After finding a relevant file with listProjectFiles or searchCode\n- When you need to see implementation of a specific class, function, or component\n- To verify details not present in documentation\n- To extract specific code examples or snippets\n\nWHEN NOT TO USE:\n- For discovering files (use listProjectFiles to browse, or searchCode to find by keyword)\n- Do not use on non-text files (images, binaries) or very large files unless necessary\n- For documentation content (use getDocContent instead)\n";
+    readonly inputSchema: z.ZodObject<{
+        filePath: z.ZodString;
+    }, z.core.$strip>;
+    readonly outputSchema: z.ZodObject<{
+        filePath: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    execute(opts: z.infer<typeof InputSchema>): Promise<z.infer<typeof OutputSchema>>;
+    getTool(): TMastraTool;
+}
+export {};
+//# sourceMappingURL=view-source-file.tool.d.ts.map

package/dist/mcp-server/tools/github/view-source-file.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-source-file.tool.d.ts","sourceRoot":"","sources":["../../../../mcp-server/tools/github/view-source-file.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA4CrD,QAAA,MAAM,WAAW;;iBAEf,CAAC;AAEH,QAAA,MAAM,YAAY;;;;iBAOhB,CAAC;AAMH,qBAAa,kBAAmB,SAAQ,QAAQ,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,CAAC;IACvF,QAAQ,CAAC,EAAE,oBAAoB;IAC/B,QAAQ,CAAC,WAAW,kwBAAoB;IACxC,QAAQ,CAAC,WAAW;;sBAAe;IACnC,QAAQ,CAAC,YAAY;;;;sBAAgB;IAE/B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IAgBvF,OAAO,IAAI,WAAW;CASvB"}

package/dist/mcp-server/tools/github/view-source-file.tool.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewSourceFileTool = void 0;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const base_tool_1 = require("../base.tool");
+const helpers_1 = require("../../../mcp-server/helpers");
+// ----------------------------------------------------------------------------
+// DESCRIPTIONS
+// ----------------------------------------------------------------------------
+const TOOL_DESCRIPTION = `
+Retrieves the full source code content of a specific file from the Ignis GitHub repository.
+
+PURPOSE:
+Read contents of a source file. Primary method for inspecting implementation details,
+understanding logic, and viewing exact code.
+
+WHEN TO USE:
+- After finding a relevant file with listProjectFiles or searchCode
+- When you need to see implementation of a specific class, function, or component
+- To verify details not present in documentation
+- To extract specific code examples or snippets
+
+WHEN NOT TO USE:
+- For discovering files (use listProjectFiles to browse, or searchCode to find by keyword)
+- Do not use on non-text files (images, binaries) or very large files unless necessary
+- For documentation content (use getDocContent instead)
+`;
+const FILE_PATH_DESCRIPTION = `
+The full path to the file from the root of the repository.
+
+HOW TO OBTAIN:
+- Use listProjectFiles to browse the project and find valid file paths
+- Use searchCode to find files containing specific keywords or patterns
+- Navigate from root directory down to the specific file
+
+EXAMPLES:
+- "packages/core/src/application.ts"
+- "examples/5-mins-qs/src/index.ts"
+- "package.json"
+`;
+// ----------------------------------------------------------------------------
+// SCHEMAS
+// ----------------------------------------------------------------------------
+const InputSchema = zod_1.z.object({
+    filePath: zod_1.z.string().min(1).describe(FILE_PATH_DESCRIPTION),
+});
+const OutputSchema = zod_1.z.object({
+    filePath: zod_1.z.string(),
+    content: zod_1.z.string().optional().describe('The full source code content of the file.'),
+    error: zod_1.z
+        .string()
+        .optional()
+        .describe('An error message if the file could not be read (e.g., not found).'),
+});
+// ----------------------------------------------------------------------------
+// TOOL CLASS
+// ----------------------------------------------------------------------------
+class ViewSourceFileTool extends base_tool_1.BaseTool {
+    constructor() {
+        super(...arguments);
+        this.id = 'viewSourceFile';
+        this.description = TOOL_DESCRIPTION;
+        this.inputSchema = InputSchema;
+        this.outputSchema = OutputSchema;
+    }
+    async execute(opts) {
+        const result = await helpers_1.GithubHelper.getFileContent({ filePath: opts.filePath });
+        if ('error' in result) {
+            return {
+                filePath: opts.filePath,
+                error: result.error,
+            };
+        }
+        return {
+            filePath: opts.filePath,
+            content: result.content,
+        };
+    }
+    getTool() {
+        return (0, tools_1.createTool)({
+            id: this.id,
+            description: this.description,
+            inputSchema: this.inputSchema,
+            outputSchema: this.outputSchema,
+            execute: async ({ context }) => this.execute(context),
+        });
+    }
+}
+exports.ViewSourceFileTool = ViewSourceFileTool;
+//# sourceMappingURL=view-source-file.tool.js.map

package/dist/mcp-server/tools/github/view-source-file.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-source-file.tool.js","sourceRoot":"","sources":["../../../../mcp-server/tools/github/view-source-file.tool.ts"],"names":[],"mappings":";;;AAAA,8CAAgD;AAChD,6BAAwB;AACxB,4CAAqD;AACrD,kDAAoD;AAEpD,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;CAiBxB,CAAC;AAEF,MAAM,qBAAqB,GAAG;;;;;;;;;;;;CAY7B,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACpF,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;CACjF,CAAC,CAAC;AAEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAa,kBAAmB,SAAQ,oBAAiD;IAAzF;;QACW,OAAE,GAAG,gBAAgB,CAAC;QACtB,gBAAW,GAAG,gBAAgB,CAAC;QAC/B,gBAAW,GAAG,WAAW,CAAC;QAC1B,iBAAY,GAAG,YAAY,CAAC;IA2BvC,CAAC;IAzBC,KAAK,CAAC,OAAO,CAAC,IAAiC;QAC7C,MAAM,MAAM,GAAG,MAAM,sBAAY,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE9E,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACtB,OAAO;gBACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;aACpB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,IAAA,kBAAU,EAAC;YAChB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;CACF;AA/BD,gDA+BC"}

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

@@ -0,0 +1,4 @@
+export * from './base.tool';
+export * from './docs';
+export * from './github';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../mcp-server/tools/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAG5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/mcp-server/tools/index.js

@@ -0,0 +1,22 @@
+"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 });
+// Base class
+__exportStar(require("./base.tool"), exports);
+// Tool classes
+__exportStar(require("./docs"), exports);
+__exportStar(require("./github"), exports);
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../mcp-server/tools/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,aAAa;AACb,8CAA4B;AAE5B,eAAe;AACf,yCAAuB;AACvB,2CAAyB"}

package/package.json

@@ -1,41 +1,61 @@
 {
   "name": "@venizia/ignis-docs",
-  "version": "0.0.1-1",
+  "version": "0.0.1-10",
   "description": "Documentation and MCP Server for Ignis Framework",
   "keywords": [
     "ignis",
+    "documentation",
+    "docs",
+    "guide",
+    "wiki",
+    "examples",
+    "vitepress",
     "mcp",
     "model-context-protocol",
-    "documentation",
+    "mastra",
+    "mastra-mcp",
     "ai",
-    "framework"
+    "ai-gateway",
+    "llm-gateway",
+    "model-router",
+    "ai-development",
+    "llm-development",
+    "server",
+    "cli",
+    "tooling",
+    "dev-tools",
+    "framework",
+    "venizia"
   ],
-  "main": "./mcp-server/dist/index.js",
-  "types": "./mcp-server/dist/index.d.ts",
+  "main": "./dist/mcp-server/index.js",
+  "types": "./dist/mcp-server/index.d.ts",
   "exports": {
     ".": {
-      "types": "./mcp-server/dist/index.d.ts",
-      "default": "./mcp-server/dist/index.js"
+      "types": "./dist/mcp-server/index.d.ts",
+      "default": "./dist/mcp-server/index.js"
     },
     "./tools": {
-      "types": "./mcp-server/dist/tools/index.d.ts",
-      "default": "./mcp-server/dist/tools/index.js"
+      "types": "./dist/mcp-server/tools/index.d.ts",
+      "default": "./dist/mcp-server/tools/index.js"
     },
     "./helpers": {
-      "types": "./mcp-server/dist/helpers/index.d.ts",
-      "default": "./mcp-server/dist/helpers/index.js"
+      "types": "./dist/mcp-server/helpers/index.d.ts",
+      "default": "./dist/mcp-server/helpers/index.js"
     },
     "./common": {
-      "types": "./mcp-server/dist/common/index.d.ts",
-      "default": "./mcp-server/dist/common/index.js"
+      "types": "./dist/mcp-server/common/index.d.ts",
+      "default": "./dist/mcp-server/common/index.js"
     }
   },
   "bin": {
-    "ignis-docs-mcp": "./mcp-server/dist/index.js"
+    "ignis-docs-mcp": "./dist/mcp-server/index.js"
   },
   "files": [
-    "mcp-server/dist",
-    "wiki"
+    "README.md",
+    "LICENSE.md",
+    "dist/mcp-server",
+    "wiki",
+    "!**/*.tsbuildinfo"
   ],
   "publishConfig": {
     "access": "public"
@@ -44,6 +64,7 @@
     "bun": ">=1.3"
   },
   "scripts": {
+    "force-update": "sh ./scripts/force-update.sh",
     "eslint": "eslint --report-unused-disable-directives .",
     "lint": "bun run eslint && bun run prettier:cli",
     "lint:fix": "bun run eslint --fix && bun run prettier:fix",
@@ -51,18 +72,19 @@
     "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",
-    "url": "https://github.com/venizia-ai/ignis.git",
+    "url": "git+https://github.com/VENIZIA-AI/ignis.git",
     "directory": "packages/docs"
   },
   "author": {
@@ -73,7 +95,7 @@
   "bugs": {
     "url": "https://github.com/VENIZIA-AI/ignis/issues"
   },
-  "homepage": "https://github.com/VENIZIA-AI/ignis/wiki",
+  "homepage": "https://venizia-ai.github.io/ignis",
   "license": "MIT",
   "dependencies": {
     "@mastra/core": "^0.24.6",
@@ -89,10 +111,11 @@
     "@braintree/sanitize-url": "^7.1.1",
     "@types/bun": "^1.3.4",
     "@types/glob": "^8.1.0",
-    "@venizia/dev-configs": "latest",
+    "@venizia/dev-configs": "^0.0.1-4",
     "eslint": "^9.36.0",
     "glob": "^10.4.2",
     "prettier": "^3.6.2",
+    "tsc-alias": "^1.8.16",
     "tsx": "^4.16.2",
     "typescript": "^5.5.4",
     "vitepress": "^1.6.4",

package/wiki/changelogs/2025-12-16-initial-architecture.md

@@ -0,0 +1,145 @@
+---
+title: Initial Architecture
+description: Documentation of the original Ignis architecture before the Model-Repository-DataSource refactor
+---
+
+# Changelog - 2025-12-16
+
+## Initial Architecture (Pre-Refactor)
+
+This documents the original architecture of the Ignis framework before the Model-Repository-DataSource refactor. This version required manual schema registration and explicit constructor parameters.
+
+## Overview
+
+- **Model Definition**: Three separate declarations (table, relations, class) for each model.
+- **DataSource Definition**: Required manual schema registration.
+- **Repository Definition**: Required explicit constructor injection.
+
+## Architecture Pattern
+
+### Model Definition
+
+Models were defined in three separate steps:
+
+```typescript
+// Step 1: Define table schema
+const TABLE_NAME = 'Configuration';
+
+export const configurationTable = pgTable(TABLE_NAME, {
+  ...generateIdColumnDefs({ id: { dataType: 'string' } }),
+  ...generateTzColumnDefs(),
+  code: text('code').notNull(),
+  group: text('group').notNull(),
+});
+
+// Step 2: Define relations separately
+export const configurationRelations = createRelations({
+  source: configurationTable,
+  relations: [
+    {
+      name: 'creator',
+      type: RelationTypes.ONE,
+      schema: userTable,
+      metadata: {
+        fields: [configurationTable.createdBy],
+        references: [userTable.id],
+      },
+    },
+  ],
+});
+
+// Step 3: Create model class
+@model({ type: 'entity', skipMigrate: false })
+export class Configuration extends BaseEntity<typeof configurationTable> {
+  static readonly TABLE_NAME = Configuration.name;
+
+  constructor() {
+    super({
+      name: Configuration.TABLE_NAME,
+      schema: configurationTable,
+    });
+  }
+}
+```
+
+### DataSource Definition
+
+DataSources required manual schema registration:
+
+```typescript
+@datasource({})
+export class PostgresDataSource extends BaseDataSource<TNodePostgresConnector, IDSConfigs> {
+  constructor() {
+    super({
+      name: PostgresDataSource.name,
+      driver: 'node-postgres',
+      config: { /* connection config */ },
+
+      // Manual schema registration - verbose and error-prone
+      schema: Object.assign(
+        {},
+        {
+          [User.TABLE_NAME]: userTable,
+          [Configuration.TABLE_NAME]: configurationTable,
+        },
+        {
+          userRelations: userRelations.relations,
+          configurationRelations: configurationRelations.relations,
+        },
+      ),
+    });
+  }
+}
+```
+
+### Repository Definition
+
+Repositories required explicit constructor injection:
+
+```typescript
+@repository({})
+export class ConfigurationRepository extends DefaultCRUDRepository<typeof configurationTable> {
+  constructor(@inject({ key: 'datasources.PostgresDataSource' }) dataSource: IDataSource) {
+    super({
+      dataSource,
+      entityClass: Configuration,
+      relations: configurationRelations.definitions,
+    });
+  }
+}
+```
+
+## Pain Points
+
+- **Verbose Model Definition**: Three separate declarations (table, relations, class) for each model
+- **Manual Schema Registration**: DataSource required explicit registration of every model and relation
+- **Unclear Repository Role**: Repository just wrapped datasource without defining the model-datasource binding
+- **Declaration Order Issues**: Had to declare table before relations, relations before class
+- **No Auto-Discovery**: Adding a new model required updates in multiple places
+- **Tight Coupling**: Changes to model structure required updates in datasource configuration
+
+## File Structure
+
+```
+src/
+├── models/
+│   └── entities/
+│       ├── user.model.ts          # Table + Relations + Class
+│       └── configuration.model.ts # Table + Relations + Class
+├── datasources/
+│   └── postgres.datasource.ts     # Manual schema assembly
+└── repositories/
+    ├── user.repository.ts         # Explicit constructor injection
+    └── configuration.repository.ts
+```
+
+## Dependencies
+
+- `@venizia/ignis-helpers`: Core utilities and types
+- `@venizia/ignis-inversion`: Dependency injection
+- `drizzle-orm`: ORM layer
+- `drizzle-zod`: Schema validation
+
+## No Breaking Changes
+
+This document describes the initial state of the architecture.