hoolix 0.0.1-beta.19

package/dist/core/registry.d.ts

@@ -0,0 +1,474 @@
+import { z } from 'zod';
+import { type ServerDefinition } from '../sources/types.js';
+export declare const ServerMetadataSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    sourceUrl: z.ZodString;
+    sourceType: z.ZodDefault<z.ZodEnum<["llms.txt", "github", "generic", "manual"]>>;
+    ingestionVersion: z.ZodDefault<z.ZodString>;
+    embeddingModel: z.ZodDefault<z.ZodCatch<z.ZodEnum<z.Writeable<any>>>>;
+    chunkCount: z.ZodNumber;
+    ingestionStats: z.ZodOptional<z.ZodObject<{
+        totalChunks: z.ZodNumber;
+        totalChars: z.ZodNumber;
+        pagesProcessed: z.ZodNumber;
+        pagesDiscovered: z.ZodOptional<z.ZodNumber>;
+        durationMs: z.ZodNumber;
+        truncated: z.ZodBoolean;
+        maxChunks: z.ZodNumber;
+        maxPages: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        totalChars: number;
+        totalChunks: number;
+        pagesProcessed: number;
+        durationMs: number;
+        truncated: boolean;
+        maxChunks: number;
+        maxPages: number;
+        pagesDiscovered?: number | undefined;
+    }, {
+        totalChars: number;
+        totalChunks: number;
+        pagesProcessed: number;
+        durationMs: number;
+        truncated: boolean;
+        maxChunks: number;
+        maxPages: number;
+        pagesDiscovered?: number | undefined;
+    }>>;
+    vectorIndexed: z.ZodDefault<z.ZodBoolean>;
+    createdAt: z.ZodString;
+    lastUpdatedAt: z.ZodString;
+    lastStartedAt: z.ZodOptional<z.ZodString>;
+    authKey: z.ZodString;
+    desiredState: z.ZodDefault<z.ZodEnum<["running", "stopped"]>>;
+    serverKind: z.ZodDefault<z.ZodEnum<["docs-rag", "mcp-server"]>>;
+    credentialKeys: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    definition: z.ZodOptional<z.ZodObject<{
+        version: z.ZodDefault<z.ZodLiteral<1>>;
+        sources: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"docs">;
+            url: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cookie: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "docs";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        }, {
+            type: "docs";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"llms">;
+            url: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cookie: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "llms";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        }, {
+            type: "llms";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"web">;
+            url: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cookie: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "web";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        }, {
+            type: "web";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"github">;
+            repo: z.ZodString;
+            ref: z.ZodOptional<z.ZodString>;
+            paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            label: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "github";
+            repo: string;
+            label?: string | undefined;
+            ref?: string | undefined;
+            paths?: string[] | undefined;
+        }, {
+            type: "github";
+            repo: string;
+            label?: string | undefined;
+            ref?: string | undefined;
+            paths?: string[] | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"manual">;
+            url: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cookie: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "manual";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        }, {
+            type: "manual";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"custom">;
+            provider: z.ZodString;
+            value: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cookie: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            type: "custom";
+            provider: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        }, {
+            value: string;
+            type: "custom";
+            provider: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        }>]>, "many">>;
+        template: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            version: z.ZodString;
+            inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            version: string;
+            name: string;
+            id: string;
+            inputs?: Record<string, string> | undefined;
+        }, {
+            version: string;
+            name: string;
+            id: string;
+            inputs?: Record<string, string> | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        version: 1;
+        sources: ({
+            type: "docs";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            type: "llms";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            type: "web";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            type: "github";
+            repo: string;
+            label?: string | undefined;
+            ref?: string | undefined;
+            paths?: string[] | undefined;
+        } | {
+            type: "manual";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            value: string;
+            type: "custom";
+            provider: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        })[];
+        template?: {
+            version: string;
+            name: string;
+            id: string;
+            inputs?: Record<string, string> | undefined;
+        } | undefined;
+    }, {
+        version?: 1 | undefined;
+        sources?: ({
+            type: "docs";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            type: "llms";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            type: "web";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            type: "github";
+            repo: string;
+            label?: string | undefined;
+            ref?: string | undefined;
+            paths?: string[] | undefined;
+        } | {
+            type: "manual";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            value: string;
+            type: "custom";
+            provider: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        })[] | undefined;
+        template?: {
+            version: string;
+            name: string;
+            id: string;
+            inputs?: Record<string, string> | undefined;
+        } | undefined;
+    }>>;
+    sourceFingerprint: z.ZodOptional<z.ZodString>;
+    lastReindexAt: z.ZodOptional<z.ZodString>;
+    reindexSchedule: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        intervalHours: z.ZodDefault<z.ZodNumber>;
+        nextRunAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        intervalHours: number;
+        nextRunAt?: string | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        intervalHours?: number | undefined;
+        nextRunAt?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    slug: string;
+    sourceUrl: string;
+    sourceType: "llms.txt" | "github" | "generic" | "manual";
+    ingestionVersion: string;
+    chunkCount: number;
+    vectorIndexed: boolean;
+    createdAt: string;
+    lastUpdatedAt: string;
+    authKey: string;
+    desiredState: "running" | "stopped";
+    serverKind: "docs-rag" | "mcp-server";
+    credentialKeys: string[];
+    embeddingModel?: any;
+    ingestionStats?: {
+        totalChars: number;
+        totalChunks: number;
+        pagesProcessed: number;
+        durationMs: number;
+        truncated: boolean;
+        maxChunks: number;
+        maxPages: number;
+        pagesDiscovered?: number | undefined;
+    } | undefined;
+    lastStartedAt?: string | undefined;
+    definition?: {
+        version: 1;
+        sources: ({
+            type: "docs";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            type: "llms";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            type: "web";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            type: "github";
+            repo: string;
+            label?: string | undefined;
+            ref?: string | undefined;
+            paths?: string[] | undefined;
+        } | {
+            type: "manual";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            value: string;
+            type: "custom";
+            provider: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        })[];
+        template?: {
+            version: string;
+            name: string;
+            id: string;
+            inputs?: Record<string, string> | undefined;
+        } | undefined;
+    } | undefined;
+    sourceFingerprint?: string | undefined;
+    lastReindexAt?: string | undefined;
+    reindexSchedule?: {
+        enabled: boolean;
+        intervalHours: number;
+        nextRunAt?: string | undefined;
+    } | undefined;
+}, {
+    name: string;
+    slug: string;
+    sourceUrl: string;
+    chunkCount: number;
+    createdAt: string;
+    lastUpdatedAt: string;
+    authKey: string;
+    sourceType?: "llms.txt" | "github" | "generic" | "manual" | undefined;
+    ingestionVersion?: string | undefined;
+    embeddingModel?: unknown;
+    ingestionStats?: {
+        totalChars: number;
+        totalChunks: number;
+        pagesProcessed: number;
+        durationMs: number;
+        truncated: boolean;
+        maxChunks: number;
+        maxPages: number;
+        pagesDiscovered?: number | undefined;
+    } | undefined;
+    vectorIndexed?: boolean | undefined;
+    lastStartedAt?: string | undefined;
+    desiredState?: "running" | "stopped" | undefined;
+    serverKind?: "docs-rag" | "mcp-server" | undefined;
+    credentialKeys?: string[] | undefined;
+    definition?: {
+        version?: 1 | undefined;
+        sources?: ({
+            type: "docs";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            type: "llms";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            type: "web";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            type: "github";
+            repo: string;
+            label?: string | undefined;
+            ref?: string | undefined;
+            paths?: string[] | undefined;
+        } | {
+            type: "manual";
+            url: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        } | {
+            value: string;
+            type: "custom";
+            provider: string;
+            label?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            cookie?: string | undefined;
+        })[] | undefined;
+        template?: {
+            version: string;
+            name: string;
+            id: string;
+            inputs?: Record<string, string> | undefined;
+        } | undefined;
+    } | undefined;
+    sourceFingerprint?: string | undefined;
+    lastReindexAt?: string | undefined;
+    reindexSchedule?: {
+        enabled?: boolean | undefined;
+        intervalHours?: number | undefined;
+        nextRunAt?: string | undefined;
+    } | undefined;
+}>;
+export type ServerMetadata = z.infer<typeof ServerMetadataSchema>;
+export type { EmbeddingModel } from '../rag/models.js';
+export interface RegistryIndex {
+    version: string;
+    servers: Record<string, {
+        slug: string;
+        path: string;
+    }>;
+}
+export declare function listServers(): Promise<ServerMetadata[]>;
+export declare function getServerMetadata(slug: string): Promise<ServerMetadata>;
+export declare function saveServerMetadata(meta: ServerMetadata): Promise<void>;
+export declare function registerServer(meta: Omit<ServerMetadata, 'createdAt' | 'lastUpdatedAt'>): Promise<ServerMetadata>;
+export declare function deleteServer(slug: string, { removeData }?: {
+    removeData?: boolean;
+}): Promise<void>;
+export declare function updateServerMetadata(slug: string, updates: Partial<ServerMetadata>): Promise<ServerMetadata>;
+export declare function getServerDefinition(meta: ServerMetadata): ServerDefinition;
+export declare function slugify(name: string): string;
+/**
+ * On-disk chunk count (or null). Used by validateServerState (no full RAG load).
+ */
+export declare function getOnDiskChunkCount(slug: string): Promise<number | null>;
+/** Lightweight state validation (chunk count match + readable metadata) for list/info/verify. */
+export declare function validateServerState(slug: string): Promise<{
+    valid: boolean;
+    issues: string[];
+}>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGpF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoC/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAsBD,wBAAsB,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAe7D;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAe7E;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5E;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,eAAe,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAiBvH;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,UAAiB,EAAE,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAapH;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAWlH;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB,CAE1E;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAU9E;AAED,iGAAiG;AACjG,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAgBrG"}

package/dist/core/registry.js

@@ -0,0 +1,186 @@
+import { z } from 'zod';
+import fs from 'fs-extra';
+import path from 'node:path';
+import { getPaths, getServerDir, getServerMetadataPath, getServerDataDir, ensureDirectories } from './paths.js';
+import { logger } from './logger.js';
+import { ServerNotFoundError, ServerAlreadyExistsError } from './errors.js';
+import { SUPPORTED_EMBEDDING_MODELS } from '../rag/models.js';
+import { ServerDefinitionSchema } from '../sources/types.js';
+import { createLegacyServerDefinition } from '../sources/registry.js';
+export const ServerMetadataSchema = z.object({
+    name: z.string(),
+    slug: z.string().regex(/^[a-z0-9-]{1,64}$/),
+    sourceUrl: z.string().url(),
+    sourceType: z.enum(['llms.txt', 'github', 'generic', 'manual']).default('generic'),
+    ingestionVersion: z.string().default('1.0.0'),
+    // Embedding model for the server. Source of truth + supported list is in src/rag/models.ts (DRY).
+    // 'fuse' = default zero-dep. 'hybrid-bge-*' = optional semantic via lazy transformers + cosine/RRF.
+    embeddingModel: z.enum(SUPPORTED_EMBEDDING_MODELS).catch('fuse').default('fuse'),
+    chunkCount: z.number().int().nonnegative(),
+    ingestionStats: z.object({
+        totalChunks: z.number().int().nonnegative(),
+        totalChars: z.number().int().nonnegative(),
+        pagesProcessed: z.number().int().nonnegative(),
+        pagesDiscovered: z.number().int().nonnegative().optional(),
+        durationMs: z.number().int().nonnegative(),
+        truncated: z.boolean(),
+        maxChunks: z.number().int().positive(),
+        maxPages: z.number().int().positive(),
+    }).optional(),
+    vectorIndexed: z.boolean().default(false),
+    createdAt: z.string().datetime(),
+    lastUpdatedAt: z.string().datetime(),
+    lastStartedAt: z.string().datetime().optional(),
+    authKey: z.string().min(16), // crypto-generated at create; only returned at start time
+    desiredState: z.enum(['running', 'stopped']).default('stopped'),
+    serverKind: z.enum(['docs-rag', 'mcp-server']).default('docs-rag'),
+    credentialKeys: z.array(z.string()).default([]), // names of stored credentials (values in credentials.json)
+    definition: ServerDefinitionSchema.optional(),
+    sourceFingerprint: z.string().optional(),
+    lastReindexAt: z.string().datetime().optional(),
+    reindexSchedule: z.object({
+        enabled: z.boolean().default(false),
+        intervalHours: z.number().int().positive().default(24),
+        nextRunAt: z.string().datetime().optional(),
+    }).optional(),
+});
+const REGISTRY_FILE = 'registry.json';
+async function loadRegistryIndex() {
+    const { data } = getPaths();
+    const registryPath = path.join(data, REGISTRY_FILE);
+    if (!(await fs.pathExists(registryPath))) {
+        const fresh = { version: '1.0.0', servers: {} };
+        await fs.writeJson(registryPath, fresh, { spaces: 2 });
+        return fresh;
+    }
+    return fs.readJson(registryPath);
+}
+async function saveRegistryIndex(index) {
+    const { data } = getPaths();
+    await fs.writeJson(path.join(data, REGISTRY_FILE), index, { spaces: 2 });
+}
+export async function listServers() {
+    await ensureDirectories();
+    const index = await loadRegistryIndex();
+    const results = [];
+    for (const { slug } of Object.values(index.servers)) {
+        try {
+            const meta = await getServerMetadata(slug);
+            results.push(meta);
+        }
+        catch (err) {
+            logger.warn(`Skipping corrupt server entry for ${slug}`);
+        }
+    }
+    return results.sort((a, b) => a.name.localeCompare(b.name));
+}
+export async function getServerMetadata(slug) {
+    const metaPath = getServerMetadataPath(slug);
+    if (!(await fs.pathExists(metaPath))) {
+        throw new ServerNotFoundError(slug);
+    }
+    const raw = await fs.readJson(metaPath);
+    const parsed = ServerMetadataSchema.parse(raw);
+    if (parsed.definition)
+        return parsed;
+    const migrated = {
+        ...parsed,
+        definition: createLegacyServerDefinition(parsed.sourceUrl, parsed.sourceType),
+    };
+    await fs.writeJson(metaPath, migrated, { spaces: 2 }).catch(() => { });
+    return migrated;
+}
+export async function saveServerMetadata(meta) {
+    const dir = getServerDir(meta.slug);
+    await fs.ensureDir(dir);
+    await fs.ensureDir(path.join(dir, 'data'));
+    const metaPath = getServerMetadataPath(meta.slug);
+    await fs.writeJson(metaPath, meta, { spaces: 2 });
+    const index = await loadRegistryIndex();
+    index.servers[meta.slug] = { slug: meta.slug, path: dir };
+    await saveRegistryIndex(index);
+}
+export async function registerServer(meta) {
+    const now = new Date().toISOString();
+    const full = {
+        ...meta,
+        createdAt: now,
+        lastUpdatedAt: now,
+    };
+    const index = await loadRegistryIndex();
+    if (index.servers[full.slug]) {
+        throw new ServerAlreadyExistsError(full.slug);
+    }
+    await saveServerMetadata(full);
+    logger.success(`Registered server "${full.name}" (${full.slug})`);
+    return full;
+}
+export async function deleteServer(slug, { removeData = true } = {}) {
+    const dir = getServerDir(slug);
+    const index = await loadRegistryIndex();
+    delete index.servers[slug];
+    await saveRegistryIndex(index);
+    if (removeData && (await fs.pathExists(dir))) {
+        await fs.remove(dir);
+        logger.info(`Removed data directory for ${slug}`);
+    }
+    logger.success(`Deleted server "${slug}"`);
+}
+export async function updateServerMetadata(slug, updates) {
+    const current = await getServerMetadata(slug);
+    const next = {
+        ...current,
+        ...updates,
+        lastUpdatedAt: new Date().toISOString(),
+    };
+    const validated = ServerMetadataSchema.parse(next);
+    await saveServerMetadata(validated);
+    return validated;
+}
+export function getServerDefinition(meta) {
+    return meta.definition || createLegacyServerDefinition(meta.sourceUrl, meta.sourceType);
+}
+export function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64) || `server-${Date.now()}`;
+}
+/**
+ * On-disk chunk count (or null). Used by validateServerState (no full RAG load).
+ */
+export async function getOnDiskChunkCount(slug) {
+    try {
+        const dataDir = getServerDataDir(slug);
+        const chunksPath = path.join(dataDir, 'chunks.json');
+        if (!(await fs.pathExists(chunksPath)))
+            return null;
+        const data = await fs.readJson(chunksPath);
+        return Array.isArray(data) ? data.length : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Lightweight state validation (chunk count match + readable metadata) for list/info/verify. */
+export async function validateServerState(slug) {
+    const issues = [];
+    let meta = null;
+    try {
+        meta = await getServerMetadata(slug);
+    }
+    catch {
+        issues.push('metadata unreadable or corrupt');
+        return { valid: false, issues };
+    }
+    const onDisk = await getOnDiskChunkCount(slug);
+    if (onDisk === null) {
+        issues.push('chunks.json missing — RAG will return no results (run "hoolix reindex ' + slug + '")');
+    }
+    else if (meta && onDisk !== meta.chunkCount) {
+        issues.push(`chunk count mismatch (registry claims ${meta.chunkCount}, disk has ${onDisk})`);
+    }
+    return { valid: issues.length === 0, issues };
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

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