@venizia/ignis-atlas 0.1.0-1

package/LICENSE.md

@@ -0,0 +1,104 @@
+# Ignis Framework License
+
+Ignis is a TypeScript Server Infrastructure framework built on [Hono](https://hono.dev/).
+
+## MIT License
+
+Copyright (c) 2025 VENIZIA Ltd. Co.
+
+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.
+
+---
+
+## Packages
+
+This monorepo contains the following packages, all licensed under MIT:
+
+| Package | Description |
+|---------|-------------|
+| `@venizia/ignis` | Core framework - controllers, services, decorators |
+| `@venizia/ignis-boot` | Application bootstrapping & artifact auto-discovery |
+| `@venizia/ignis-helpers` | Utility helpers - logging, cron, Redis, queues, storage |
+| `@venizia/ignis-inversion` | Dependency Injection & IoC container |
+| `@venizia/dev-configs` | Shared ESLint, Prettier, TypeScript configurations |
+| `@venizia/ignis-docs` | Documentation and MCP Server |
+
+---
+
+## Third-Party Dependencies
+
+Ignis uses the following open-source libraries. We are grateful to the authors and contributors of these projects.
+
+### Core Dependencies
+
+| Library | License | Description |
+|---------|---------|-------------|
+| [Hono](https://github.com/honojs/hono) | MIT | Ultrafast web framework |
+| [Zod](https://github.com/colinhacks/zod) | MIT | TypeScript-first schema validation |
+| [Drizzle ORM](https://github.com/drizzle-team/drizzle-orm) | Apache-2.0 | TypeScript ORM |
+| [Jose](https://github.com/panva/jose) | MIT | JavaScript Object Signing and Encryption |
+
+### Helpers Dependencies
+
+| Library | License | Description |
+|---------|---------|-------------|
+| [Winston](https://github.com/winstonjs/winston) | MIT | Universal logging library |
+| [BullMQ](https://github.com/taskforcesh/bullmq) | MIT | Message queue and job scheduling |
+| [IORedis](https://github.com/redis/ioredis) | MIT | Redis client for Node.js |
+| [MinIO](https://github.com/minio/minio-js) | Apache-2.0 | S3-compatible object storage client |
+| [Axios](https://github.com/axios/axios) | MIT | HTTP client |
+| [Day.js](https://github.com/iamkun/dayjs) | MIT | Date manipulation library |
+| [Cron](https://github.com/kelektiv/node-cron) | MIT | Cron job scheduler |
+| [Socket.IO](https://github.com/socketio/socket.io) | MIT | Real-time bidirectional communication |
+| [MQTT.js](https://github.com/mqttjs/MQTT.js) | MIT | MQTT client |
+
+### Utility Dependencies
+
+| Library | License | Description |
+|---------|---------|-------------|
+| [Lodash](https://github.com/lodash/lodash) | MIT | Utility library |
+| [reflect-metadata](https://github.com/rbuckton/reflect-metadata) | Apache-2.0 | Metadata reflection API |
+| [glob](https://github.com/isaacs/node-glob) | ISC | File pattern matching (used by boot) |
+
+### Documentation Dependencies
+
+| Library | License | Description |
+|---------|---------|-------------|
+| [VitePress](https://github.com/vuejs/vitepress) | MIT | Static site generator |
+| [Fuse.js](https://github.com/krisk/fuse) | Apache-2.0 | Fuzzy search library |
+| [gray-matter](https://github.com/jonschlinkert/gray-matter) | MIT | Front-matter parser |
+
+---
+
+## Acknowledgments
+
+Ignis Framework is inspired by and built upon the work of many open-source projects:
+
+- **[Hono](https://hono.dev/)** by Yusuke Wada - The ultrafast web framework that powers Ignis
+- **[LoopBack 4](https://loopback.io/)** by IBM/StrongLoop - Inspiration for the enterprise architecture patterns
+- **[NestJS](https://nestjs.com/)** by Kamil Mysliwiec - Inspiration for decorator-based controllers
+- **[InversifyJS](https://inversify.io/)** - Inspiration for the IoC container design
+
+We thank all the maintainers and contributors of these projects for their excellent work.
+
+---
+
+## Contributing
+
+By contributing to Ignis, you agree that your contributions will be licensed under the MIT License.

package/README.md

@@ -0,0 +1,144 @@
+<div align="center">
+
+<br />
+
+# :fire: IGNIS - `@venizia/ignis-atlas`
+
+**MCP server for IGNIS: search and read the wiki, changelogs and knowledge bundle by section.**
+
+[![Docs](https://img.shields.io/badge/Docs-ignis.venizia.ai-2563EB.svg?style=flat-square)](https://ignis.venizia.ai/extensions/atlas)
+[![npm](https://img.shields.io/npm/v/@venizia/ignis-atlas.svg?style=flat-square&color=cb3837&label=@venizia/ignis-atlas)](https://www.npmjs.com/package/@venizia/ignis-atlas)
+[![License: MIT](https://img.shields.io/badge/License-MIT-3DA639.svg?style=flat-square)](LICENSE.md)
+
+[Atlas on the wiki](https://ignis.venizia.ai/extensions/atlas) &#8226;
+[Changelog](https://ignis.venizia.ai/changelogs/2026-09-06-ignis-atlas)
+
+</div>
+
+---
+
+`@venizia/ignis-atlas` answers "what does the manual say" over three corpora - the wiki, the
+changelogs and the agent-facing knowledge bundle - with a citation on every hit, over stdio
+JSON-RPC.
+
+**Bun-only.** The index runs on `bun:sqlite` FTS5, so a Node host cannot start this server.
+
+## Add it to an MCP client
+
+For a published release, run it with `bunx`:
+
+```json
+{
+  "mcpServers": {
+    "ignis-atlas": {
+      "command": "bunx",
+      "args": ["@venizia/ignis-atlas", "mcp"]
+    }
+  }
+}
+```
+
+This reads the wiki and the changelogs packaged with the release you installed, not your working
+tree.
+
+Working inside the IGNIS monorepo, point `command` at the checkout instead:
+
+```json
+{
+  "mcpServers": {
+    "ignis-atlas": {
+      "command": "bun",
+      "args": ["packages/atlas/src/cli.ts", "mcp"]
+    }
+  }
+}
+```
+
+A checkout also indexes the knowledge bundle, and re-checks the corpus for changes before every
+call.
+
+## Tools
+
+### `search`
+
+Search for chunks matching a keyword query, ranked by relevance.
+
+```
+search({ query: "hidden fields on write" })
+```
+
+```json
+{
+  "total": 395,
+  "returned": 3,
+  "hits": [
+    {
+      "id": "okf:architecture/search-typesense.md#hidden-fields-on-the-write-path",
+      "corpus": "knowledge",
+      "title": "Hidden fields on the write path",
+      "headingPath": "Typesense search connector > Hidden fields on the write path",
+      "anchor": "hidden-fields-on-the-write-path",
+      "snippet": "... Search [write] responses therefore used to leak [hidden] properties ...",
+      "score": -16.03
+    }
+  ]
+}
+```
+
+| Input | Type | Default |
+| :--- | :--- | :--- |
+| `query` | string, 2+ characters | required |
+| `corpus` | `all`, `wiki`, `changelog`, `knowledge` | `all` |
+| `limit` | integer, 1-50 | `10` |
+| `offset` | integer, 0+ | `0` |
+
+The reply-size budget can return fewer hits than `limit`. Page with `offset: nextOffset`, not
+`offset + limit` - a page the budget trimmed would otherwise be skipped.
+
+### `get`
+
+Read one chunk's body by an id a search hit returned, or a whole document with its `#anchor`
+dropped.
+
+```
+get({ id: "okf:architecture/search-typesense.md#hidden-fields-on-the-write-path" })
+```
+
+```json
+{
+  "id": "okf:architecture/search-typesense.md#hidden-fields-on-the-write-path",
+  "title": "Hidden fields on the write path",
+  "headingPath": "Typesense search connector > Hidden fields on the write path",
+  "body": "This is the non-derivable one. Reads exclude `@model({ settings: { hiddenProperties } })` at query time via the engine's exclude-fields parameter - but a write response comes back from the write itself and never passes through that filter. ..."
+}
+```
+
+| Input | Type | Default |
+| :--- | :--- | :--- |
+| `id` | string, from a search hit | required |
+| `maxChars` | integer, 500-50000 | `8000` |
+| `cursor` | string, from a previous reply's `next` | start of the body |
+
+A body longer than `maxChars` returns `next`; pass it back as `cursor` for the following page.
+
+## `--root`
+
+`--root <dir>` points the server at an IGNIS checkout, or a directory holding a packaged snapshot.
+It defaults to the current working directory.
+
+## Exit codes
+
+| Code | Meaning |
+| :--- | :--- |
+| `0` | The client closed the connection. |
+| `1` | An error during startup, or while running a tool call. |
+| `2` | Bad arguments, or neither a checkout nor a packaged snapshot was found. |
+
+## Links
+
+[Documentation](https://ignis.venizia.ai) &#8226;
+[Atlas on the wiki](https://ignis.venizia.ai/extensions/atlas) &#8226;
+[Changelog](https://ignis.venizia.ai/changelogs/2026-09-06-ignis-atlas)
+
+MIT licensed - see [LICENSE.md](LICENSE.md).
+Questions: [GitHub Issues](https://github.com/VENIZIA-AI/ignis/issues) &#8226; developer@venizia.ai

package/dist/cjs/cli/modes.d.ts

@@ -0,0 +1,29 @@
+import type { TAtlasMode } from '../common';
+/** A `root`/`packageDirectory` pair that satisfies neither repo mode nor snapshot mode. */
+export declare class ModeUsageError extends Error {
+}
+export interface IResolvedMode {
+    mode: TAtlasMode;
+    root: string;
+}
+/** The located package's own `version` - read fresh so a release bump is never stale in the running server. */
+export declare const readPackageVersion: (opts: {
+    directory: string;
+}) => string | undefined;
+/**
+ * Walks up from `startDirectory` (source runs from `src/`, the built CLI from `dist/cjs/` - a
+ * fixed number of `..` segments is wrong for one of the two) until it finds the directory whose
+ * `package.json` names this package. Never guesses from path shape; always reads and compares.
+ */
+export declare const findPackageDirectory: (opts: {
+    startDirectory: string;
+}) => string;
+/**
+ * Repo mode wins when `root` is a checkout; otherwise the packaged snapshot next to
+ * `packageDirectory`; otherwise a `ModeUsageError` naming both paths it checked.
+ */
+export declare const resolveMode: (opts: {
+    root: string;
+    packageDirectory: string;
+}) => IResolvedMode;
+//# sourceMappingURL=modes.d.ts.map

package/dist/cjs/cli/modes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modes.d.ts","sourceRoot":"","sources":["../../../src/cli/modes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAa3C,2FAA2F;AAC3F,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD,+GAA+G;AAC/G,eAAO,MAAM,kBAAkB,GAAI,MAAM;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,KAAG,MAAM,GAAG,SAC7C,CAAC;AAc9B;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,KAAG,MAYvE,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,KAAG,aAc9E,CAAC"}

package/dist/cjs/cli/modes.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveMode = exports.findPackageDirectory = exports.readPackageVersion = exports.ModeUsageError = void 0;
+const common_1 = require("../common");
+const core_1 = require("@venizia/ignis-helpers/core");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+// The npm package name, not `AtlasConstants.SERVER_NAME` (`ignis-atlas`, the bin/MCP server name) -
+// this is what identifies the package directory itself, from its own `package.json`.
+const PACKAGE_NAME = '@venizia/ignis-atlas';
+const REPOSITORY_WIKI_MARKER = 'docs/wiki/content';
+const REPOSITORY_KNOWLEDGE_MARKER = '.agents/knowledge';
+const SNAPSHOT_DIRECTORY = 'dist/corpus';
+/** A `root`/`packageDirectory` pair that satisfies neither repo mode nor snapshot mode. */
+class ModeUsageError extends Error {
+}
+exports.ModeUsageError = ModeUsageError;
+const readManifest = (opts) => {
+    const manifestPath = (0, node_path_1.join)(opts.directory, 'package.json');
+    if (!(0, node_fs_1.existsSync)(manifestPath)) {
+        return undefined;
+    }
+    return JSON.parse((0, node_fs_1.readFileSync)(manifestPath, 'utf8'));
+};
+const readPackageName = (opts) => readManifest(opts)?.name;
+/** The located package's own `version` - read fresh so a release bump is never stale in the running server. */
+const readPackageVersion = (opts) => readManifest(opts)?.version;
+exports.readPackageVersion = readPackageVersion;
+/** `startDirectory` and every directory above it, up to and including the filesystem root. */
+const ancestorsOf = (opts) => {
+    const { root } = (0, node_path_1.parse)(opts.startDirectory);
+    const chain = [opts.startDirectory];
+    while (chain[chain.length - 1] !== root) {
+        chain.push((0, node_path_1.dirname)(chain[chain.length - 1]));
+    }
+    return chain;
+};
+/**
+ * Walks up from `startDirectory` (source runs from `src/`, the built CLI from `dist/cjs/` - a
+ * fixed number of `..` segments is wrong for one of the two) until it finds the directory whose
+ * `package.json` names this package. Never guesses from path shape; always reads and compares.
+ */
+const findPackageDirectory = (opts) => {
+    const found = ancestorsOf({ startDirectory: opts.startDirectory }).find(directory => readPackageName({ directory }) === PACKAGE_NAME);
+    if (!found) {
+        throw (0, core_1.getError)({
+            message: `[findPackageDirectory] no ${PACKAGE_NAME} package.json found | started at: ${opts.startDirectory}`,
+        });
+    }
+    return found;
+};
+exports.findPackageDirectory = findPackageDirectory;
+const isRepositoryCheckout = (opts) => (0, node_fs_1.existsSync)((0, node_path_1.join)(opts.root, REPOSITORY_WIKI_MARKER)) &&
+    (0, node_fs_1.existsSync)((0, node_path_1.join)(opts.root, REPOSITORY_KNOWLEDGE_MARKER));
+/**
+ * Repo mode wins when `root` is a checkout; otherwise the packaged snapshot next to
+ * `packageDirectory`; otherwise a `ModeUsageError` naming both paths it checked.
+ */
+const resolveMode = (opts) => {
+    const { root, packageDirectory } = opts;
+    if (isRepositoryCheckout({ root })) {
+        return { mode: common_1.AtlasModes.REPOSITORY, root };
+    }
+    if ((0, node_fs_1.existsSync)((0, node_path_1.join)(packageDirectory, SNAPSHOT_DIRECTORY))) {
+        return { mode: common_1.AtlasModes.SNAPSHOT, root: (0, node_path_1.join)(packageDirectory, 'dist') };
+    }
+    throw new ModeUsageError(`no IGNIS checkout at ${root} and no packaged snapshot under ${packageDirectory} - pass --root <dir> pointing at a checkout`);
+};
+exports.resolveMode = resolveMode;
+//# sourceMappingURL=modes.js.map

package/dist/cjs/cli/modes.js.map

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

package/dist/cjs/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cjs/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":""}

package/dist/cjs/cli.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env bun
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const common_1 = require("./common");
+const modes_1 = require("./cli/modes");
+const logger_1 = require("./common/logger");
+const server_1 = require("./server");
+// Must run before any code that could log: this is the only place a provider is ever registered.
+ignis_helpers_1.LoggerFactory.use({ provider: logger_1.StderrLogger });
+const USAGE = `usage: ${common_1.AtlasConstants.SERVER_NAME} [mcp] [--root <dir>]`;
+const messageOf = (error) => error instanceof Error ? error.message : String(error);
+const usageError = (message) => {
+    console.error(`${common_1.AtlasConstants.SERVER_NAME}: ${message}\n${USAGE}`);
+    process.exit(2);
+};
+const readSubcommand = (opts) => {
+    const [first] = opts.argv;
+    return first === undefined || first.startsWith('--') ? 'mcp' : first;
+};
+const readRoot = (opts) => {
+    const index = opts.argv.indexOf('--root');
+    return index === -1 ? process.cwd() : (opts.argv[index + 1] ?? process.cwd());
+};
+// package.json has no version yet only in a manifest hand-edited before its first publish.
+const FALLBACK_VERSION = '0.0.0';
+/** Resolves `{ mode, root, version }` from `argv`, or prints usage and exits 2 - never throws. */
+const resolveServerOptions = (opts) => {
+    try {
+        const packageDirectory = (0, modes_1.findPackageDirectory)({ startDirectory: __dirname });
+        const { mode, root } = (0, modes_1.resolveMode)({ root: readRoot({ argv: opts.argv }), packageDirectory });
+        const version = (0, modes_1.readPackageVersion)({ directory: packageDirectory }) ?? FALLBACK_VERSION;
+        return { mode, root, version };
+    }
+    catch (error) {
+        if (error instanceof modes_1.ModeUsageError) {
+            return usageError(error.message);
+        }
+        throw error;
+    }
+};
+const argv = process.argv.slice(2);
+const subcommand = readSubcommand({ argv });
+if (subcommand !== 'mcp') {
+    usageError(`unknown subcommand: ${subcommand}`);
+}
+const { mode, root, version } = resolveServerOptions({ argv });
+try {
+    (0, server_1.buildServer)({ mode, root, version })
+        .run()
+        .catch((error) => {
+        console.error(`${common_1.AtlasConstants.SERVER_NAME}: ${messageOf(error)}`);
+        process.exit(1);
+    });
+}
+catch (error) {
+    console.error(`${common_1.AtlasConstants.SERVER_NAME}: ${messageOf(error)}`);
+    process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cjs/cli.js.map

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

package/dist/cjs/common/constants.d.ts

@@ -0,0 +1,22 @@
+export declare class AtlasConstants {
+    static readonly SERVER_NAME = "ignis-atlas";
+    static readonly PROTOCOL_VERSION = "2025-06-18";
+    static readonly SEARCH_BUDGET_CHARS = 2000;
+    static readonly GET_BUDGET_CHARS = 8000;
+    static readonly SNIPPET_MAX_CHARS = 300;
+    static readonly SEARCH_DEFAULT_LIMIT = 10;
+}
+export declare class AtlasModes {
+    static readonly REPOSITORY = "repo";
+    static readonly SNAPSHOT = "snapshot";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+export declare class Corpora {
+    static readonly WIKI = "wiki";
+    static readonly CHANGELOG = "changelog";
+    static readonly KNOWLEDGE = "knowledge";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): boolean;
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/common/constants.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAc;IACzB,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAC5C,MAAM,CAAC,QAAQ,CAAC,gBAAgB,gBAAgB;IAChD,MAAM,CAAC,QAAQ,CAAC,mBAAmB,QAAQ;IAC3C,MAAM,CAAC,QAAQ,CAAC,gBAAgB,QAAQ;IACxC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,OAAO;IACxC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,MAAM;CAC3C;AAED,qBAAa,UAAU;IACrB,MAAM,CAAC,QAAQ,CAAC,UAAU,UAAU;IACpC,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAqD;IAC/E,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC;AAED,qBAAa,OAAO;IAClB,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;IAC9B,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAgE;IAC1F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC"}

package/dist/cjs/common/constants.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Corpora = exports.AtlasModes = exports.AtlasConstants = void 0;
+class AtlasConstants {
+    static { this.SERVER_NAME = 'ignis-atlas'; }
+    static { this.PROTOCOL_VERSION = '2025-06-18'; }
+    static { this.SEARCH_BUDGET_CHARS = 2000; }
+    static { this.GET_BUDGET_CHARS = 8000; }
+    static { this.SNIPPET_MAX_CHARS = 300; }
+    static { this.SEARCH_DEFAULT_LIMIT = 10; }
+}
+exports.AtlasConstants = AtlasConstants;
+class AtlasModes {
+    static { this.REPOSITORY = 'repo'; }
+    static { this.SNAPSHOT = 'snapshot'; }
+    static { this.SCHEME_SET = new Set([this.REPOSITORY, this.SNAPSHOT]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+exports.AtlasModes = AtlasModes;
+class Corpora {
+    static { this.WIKI = 'wiki'; }
+    static { this.CHANGELOG = 'changelog'; }
+    static { this.KNOWLEDGE = 'knowledge'; }
+    static { this.SCHEME_SET = new Set([this.WIKI, this.CHANGELOG, this.KNOWLEDGE]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+}
+exports.Corpora = Corpora;
+//# sourceMappingURL=constants.js.map

package/dist/cjs/common/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/common/constants.ts"],"names":[],"mappings":";;;AAAA,MAAa,cAAc;aACT,gBAAW,GAAG,aAAa,CAAC;aAC5B,qBAAgB,GAAG,YAAY,CAAC;aAChC,wBAAmB,GAAG,IAAI,CAAC;aAC3B,qBAAgB,GAAG,IAAI,CAAC;aACxB,sBAAiB,GAAG,GAAG,CAAC;aACxB,yBAAoB,GAAG,EAAE,CAAC;;AAN5C,wCAOC;AAED,MAAa,UAAU;aACL,eAAU,GAAG,MAAM,CAAC;aACpB,aAAQ,GAAG,UAAU,CAAC;aACtB,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/E,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AANH,gCAOC;AAED,MAAa,OAAO;aACF,SAAI,GAAG,MAAM,CAAC;aACd,cAAS,GAAG,WAAW,CAAC;aACxB,cAAS,GAAG,WAAW,CAAC;aACxB,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1F,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAPH,0BAQC"}

package/dist/cjs/common/index.d.ts

@@ -0,0 +1,3 @@
+export * from './constants';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/cjs/common/index.js

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

package/dist/cjs/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB"}

package/dist/cjs/common/logger.d.ts

@@ -0,0 +1,21 @@
+import type { ILogger, TLogLevel } from '@venizia/ignis-helpers/core';
+/**
+ * Registered via `LoggerFactory.use({ provider: StderrLogger })` at the CLI entrypoint, before any
+ * other import runs. Every level lands on `console.error` - stdout must carry only JSON-RPC frames.
+ */
+export declare class StderrLogger implements ILogger {
+    private readonly scope;
+    private static readonly cache;
+    private readonly prefix;
+    private constructor();
+    static get(scope: string): ILogger;
+    private write;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    emerg(message: string, ...args: unknown[]): void;
+    log(_level: TLogLevel, message: string, ...args: unknown[]): void;
+    for(methodName: string): ILogger;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/cjs/common/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/common/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;GAGG;AACH,qBAAa,YAAa,YAAW,OAAO;IAItB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAH1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAmC;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO;IAIP,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAWlC,OAAO,CAAC,KAAK;IAIb,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIjE,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;CAIjC"}

package/dist/cjs/common/logger.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StderrLogger = void 0;
+/**
+ * Registered via `LoggerFactory.use({ provider: StderrLogger })` at the CLI entrypoint, before any
+ * other import runs. Every level lands on `console.error` - stdout must carry only JSON-RPC frames.
+ */
+class StderrLogger {
+    static { this.cache = new Map(); }
+    constructor(scope) {
+        this.scope = scope;
+        this.prefix = scope !== '' ? `[${scope}] ` : '';
+    }
+    static get(scope) {
+        const cached = this.cache.get(scope);
+        if (cached) {
+            return cached;
+        }
+        const created = new StderrLogger(scope);
+        this.cache.set(scope, created);
+        return created;
+    }
+    write(opts) {
+        console.error(`${this.prefix}${opts.message}`, ...opts.args);
+    }
+    debug(message, ...args) {
+        this.write({ message, args });
+    }
+    info(message, ...args) {
+        this.write({ message, args });
+    }
+    warn(message, ...args) {
+        this.write({ message, args });
+    }
+    error(message, ...args) {
+        this.write({ message, args });
+    }
+    emerg(message, ...args) {
+        this.write({ message, args });
+    }
+    log(_level, message, ...args) {
+        this.write({ message, args });
+    }
+    for(methodName) {
+        const childScope = this.scope !== '' ? `${this.scope}-${methodName}` : methodName;
+        return StderrLogger.get(childScope);
+    }
+}
+exports.StderrLogger = StderrLogger;
+//# sourceMappingURL=logger.js.map

package/dist/cjs/common/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/common/logger.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,MAAa,YAAY;aACC,UAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAGhE,YAAqC,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;QAChD,IAAI,CAAC,MAAM,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,KAAa;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,IAA0C;QACtD,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,MAAiB,EAAE,OAAe,EAAE,GAAG,IAAe;QACxD,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;QAClF,OAAO,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;;AAlDH,oCAmDC"}

package/dist/cjs/common/types.d.ts

@@ -0,0 +1,5 @@
+import type { TConstValue } from '@venizia/ignis-helpers/common';
+import type { AtlasModes, Corpora } from './constants';
+export type TAtlasMode = TConstValue<typeof AtlasModes>;
+export type TCorpus = TConstValue<typeof Corpora>;
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,UAAU,CAAC,CAAC;AACxD,MAAM,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,OAAO,CAAC,CAAC"}

package/dist/cjs/common/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/common/types.ts"],"names":[],"mappings":""}

package/dist/cjs/corpus/chunker.d.ts

@@ -0,0 +1,12 @@
+import { BaseHelper } from '@venizia/ignis-helpers/core';
+import type { IChunk, IDocument } from './common';
+/** Splits a document into H2/H3 sections: never inside a fence, tiny siblings merged, oversized ones paged. */
+export declare class Chunker extends BaseHelper {
+    private static instance?;
+    private constructor();
+    static getInstance(): Chunker;
+    chunk(opts: {
+        document: IDocument;
+    }): IChunk[];
+}
+//# sourceMappingURL=chunker.d.ts.map