@zlooks.cn/global-config-server 1.0.0

package/dist/command/index.d.ts

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

package/dist/command/index.d.ts.map

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

package/dist/command/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { fileURLToPath } from 'node:url';
+import { createRegistryDatabaseDataSource, registerDatabaseCommands, } from '@zlooks.cn/database-command';
+import { runServiceCommand } from '@zlooks.cn/service-command';
+import { globalConfigMigrations } from '../migrations/index.js';
+import { SitePresentationEntity, SiteProfileEntity } from '../persistence/entities.js';
+await runServiceCommand({
+    packageRoot: fileURLToPath(new URL('../../', import.meta.url)),
+    requiresReactServer: false,
+    configure(program) {
+        registerDatabaseCommands(program, {
+            createDataSource: (envFile) => createRegistryDatabaseDataSource(envFile, {
+                commandNamespace: 'cn.zlooks.global.config.db.command',
+                entities: [SitePresentationEntity, SiteProfileEntity],
+            }),
+            migrations: globalConfigMigrations,
+        });
+    },
+}).catch(reportStartupFailure);
+function reportStartupFailure(error) {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=index.js.map

package/dist/command/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,gCAAgC,EAChC,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEvF,MAAM,iBAAiB,CAAC;IACtB,WAAW,EAAE,aAAa,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9D,mBAAmB,EAAE,KAAK;IAC1B,SAAS,CAAC,OAAO;QACf,wBAAwB,CAAC,OAAO,EAAE;YAChC,gBAAgB,EAAE,CAAC,OAAO,EAAE,EAAE,CAC5B,gCAAgC,CAAC,OAAO,EAAE;gBACxC,gBAAgB,EAAE,oCAAoC;gBACtD,QAAQ,EAAE,CAAC,sBAAsB,EAAE,iBAAiB,CAAC;aACtD,CAAC;YACJ,UAAU,EAAE,sBAAsB;SACnC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;AAE/B,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/config/global-config-revision-conflict-error.d.ts

@@ -0,0 +1,5 @@
+export declare class GlobalConfigRevisionConflictError extends Error {
+    readonly currentRevision: number;
+    constructor(currentRevision: number);
+}
+//# sourceMappingURL=global-config-revision-conflict-error.d.ts.map

package/dist/config/global-config-revision-conflict-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-config-revision-conflict-error.d.ts","sourceRoot":"","sources":["../../src/config/global-config-revision-conflict-error.ts"],"names":[],"mappings":"AAAA,qBAAa,iCAAkC,SAAQ,KAAK;aACvB,eAAe,EAAE,MAAM;IAA1D,YAAmC,eAAe,EAAE,MAAM,EAGzD;CACF"}

package/dist/config/global-config-revision-conflict-error.js

@@ -0,0 +1,9 @@
+export class GlobalConfigRevisionConflictError extends Error {
+    currentRevision;
+    constructor(currentRevision) {
+        super(`Global configuration revision conflict; current revision is ${currentRevision}`);
+        this.currentRevision = currentRevision;
+        this.name = 'GlobalConfigRevisionConflictError';
+    }
+}
+//# sourceMappingURL=global-config-revision-conflict-error.js.map

package/dist/config/global-config-revision-conflict-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-config-revision-conflict-error.js","sourceRoot":"","sources":["../../src/config/global-config-revision-conflict-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iCAAkC,SAAQ,KAAK;IACvB,eAAe;IAAlD,YAAmC,eAAuB;QACxD,KAAK,CAAC,+DAA+D,eAAe,EAAE,CAAC,CAAC;+BADvD,eAAe;QAEhD,IAAI,CAAC,IAAI,GAAG,mCAAmC,CAAC;IAClD,CAAC;CACF"}

package/dist/config/schema.d.ts

@@ -0,0 +1,14 @@
+import { type PostgresConfig } from '@zlooks.cn/infrastructure';
+export interface GlobalConfigServerConfigSources {
+    readonly postgres: unknown;
+}
+export interface GlobalConfigServerConfig {
+    readonly infrastructure: {
+        readonly postgres: PostgresConfig;
+    };
+    readonly publisher: {
+        readonly refreshIntervalMs: number;
+    };
+}
+export declare function parseGlobalConfigServerConfig(input: GlobalConfigServerConfigSources): GlobalConfigServerConfig;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAErF,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,cAAc,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;KAAE,CAAC;IAC/D,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,+BAA+B,GACrC,wBAAwB,CAK1B"}

package/dist/config/schema.js

@@ -0,0 +1,8 @@
+import { parsePostgresConfig } from '@zlooks.cn/infrastructure';
+export function parseGlobalConfigServerConfig(input) {
+    return Object.freeze({
+        infrastructure: Object.freeze({ postgres: parsePostgresConfig(input.postgres) }),
+        publisher: Object.freeze({ refreshIntervalMs: 1_000 }),
+    });
+}
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAuB,MAAM,2BAA2B,CAAC;AAWrF,MAAM,UAAU,6BAA6B,CAC3C,KAAsC;IAEtC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,mBAAmB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChF,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;KACvD,CAAC,CAAC;AACL,CAAC"}

package/dist/config/typeorm-site-presentation-store.d.ts

@@ -0,0 +1,17 @@
+import { type SitePresentation, type SitePresentationSnapshot } from '@zlooks.cn/global-config-shared';
+import type { DataSource } from 'typeorm';
+export { GlobalConfigRevisionConflictError } from './global-config-revision-conflict-error.js';
+export declare class TypeOrmSitePresentationStore {
+    #private;
+    private readonly dataSource;
+    constructor(dataSource: DataSource, options?: {
+        readonly clock?: () => Date;
+    });
+    read(): Promise<SitePresentationSnapshot>;
+    update(input: {
+        readonly expectedRevision: number;
+        readonly updatedBy: string;
+        readonly value: SitePresentation;
+    }): Promise<SitePresentationSnapshot>;
+}
+//# sourceMappingURL=typeorm-site-presentation-store.d.ts.map

package/dist/config/typeorm-site-presentation-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeorm-site-presentation-store.d.ts","sourceRoot":"","sources":["../../src/config/typeorm-site-presentation-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAkB1C,OAAO,EAAE,iCAAiC,EAAE,MAAM,4CAA4C,CAAC;AAiB/F,qBAAa,4BAA4B;;IAIrC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAD7B,YACmB,UAAU,EAAE,UAAU,EACvC,OAAO,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO,EAG9C;IAEY,IAAI,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAGrD;IAEY,MAAM,CAAC,KAAK,EAAE;QACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;KAClC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAiBpC;CA+EF"}

package/dist/config/typeorm-site-presentation-store.js

@@ -0,0 +1,131 @@
+import { parseSitePresentation, parseSitePresentationSnapshot, } from '@zlooks.cn/global-config-shared';
+import { z } from 'zod';
+import { SitePresentationEntity } from '../persistence/entities.js';
+import { GlobalConfigRevisionConflictError } from './global-config-revision-conflict-error.js';
+const DOCUMENT_ID = 'site.presentation';
+const DEFAULT_BACKGROUND_VIDEO_URL = 'https://assets.mixkit.co/videos/47650/47650-720.mp4';
+const DEFAULT_SITE_PRESENTATION = parseSitePresentation({
+    identity: {
+        name: 'ZLOOKS',
+        homeHref: '/',
+        backgroundVideoUrl: DEFAULT_BACKGROUND_VIDEO_URL,
+        description: '让服务独立演进，让体验自然汇聚。',
+    },
+    linkGroups: [],
+    legal: { copyright: '© Zlooks.cn', registrations: [] },
+});
+export { GlobalConfigRevisionConflictError } from './global-config-revision-conflict-error.js';
+const legacyPresentationSchema = z.strictObject({
+    identity: z.strictObject({
+        name: z.string(),
+        homeHref: z.string(),
+        logoUrl: z.string().optional(),
+        description: z.string().optional(),
+    }),
+    linkGroups: z.array(z.unknown()),
+    legal: z.strictObject({
+        copyright: z.string().optional(),
+        registration: z.string().optional(),
+        registrationHref: z.string().optional(),
+    }),
+});
+export class TypeOrmSitePresentationStore {
+    dataSource;
+    #clock;
+    constructor(dataSource, options = {}) {
+        this.dataSource = dataSource;
+        this.#clock = options.clock ?? (() => new Date());
+    }
+    async read() {
+        await this.#ensureInitialDocument();
+        return this.#readExisting();
+    }
+    async update(input) {
+        const value = parseSitePresentation(input.value);
+        await this.#ensureInitialDocument();
+        const updatedAt = this.#clock();
+        const result = await this.dataSource.getRepository(SitePresentationEntity).update({ id: DOCUMENT_ID, revision: input.expectedRevision }, {
+            revision: input.expectedRevision + 1,
+            value,
+            updatedAt,
+            updatedBy: input.updatedBy,
+        });
+        if (result.affected !== 1) {
+            throw new GlobalConfigRevisionConflictError((await this.#readExisting()).revision);
+        }
+        return this.#readExisting();
+    }
+    async #ensureInitialDocument() {
+        const now = this.#clock();
+        await this.dataSource.getRepository(SitePresentationEntity)
+            .createQueryBuilder()
+            .insert()
+            .into(SitePresentationEntity)
+            .values({
+            id: DOCUMENT_ID,
+            schemaVersion: 2,
+            revision: 0,
+            value: DEFAULT_SITE_PRESENTATION,
+            updatedAt: now,
+            updatedBy: 'bootstrap',
+        })
+            .orIgnore()
+            .execute();
+    }
+    async #readExisting() {
+        const row = await this.dataSource.getRepository(SitePresentationEntity).findOneByOrFail({
+            id: DOCUMENT_ID,
+        });
+        if (row.schemaVersion === 1)
+            return this.#migrateLegacy(row);
+        const snapshot = parseSitePresentationSnapshot({
+            schemaVersion: row.schemaVersion,
+            revision: row.revision,
+            value: row.value,
+            updatedAt: row.updatedAt.toISOString(),
+            updatedBy: row.updatedBy,
+        });
+        if (snapshot.value.identity.backgroundVideoUrl !== undefined)
+            return snapshot;
+        return parseSitePresentationSnapshot({
+            ...snapshot,
+            value: {
+                ...snapshot.value,
+                identity: {
+                    ...snapshot.value.identity,
+                    backgroundVideoUrl: DEFAULT_BACKGROUND_VIDEO_URL,
+                },
+            },
+        });
+    }
+    async #migrateLegacy(row) {
+        const legacy = legacyPresentationSchema.parse(row.value);
+        const registrationNumber = legacy.legal.registration ?? legacy.legal.registrationHref;
+        const value = parseSitePresentation({
+            identity: { ...legacy.identity, backgroundVideoUrl: DEFAULT_BACKGROUND_VIDEO_URL },
+            linkGroups: legacy.linkGroups,
+            legal: {
+                ...(legacy.legal.copyright ? { copyright: legacy.legal.copyright } : {}),
+                registrations: registrationNumber ? [{
+                        id: 'legacy-registration',
+                        kind: 'other',
+                        number: registrationNumber,
+                        ...(legacy.legal.registration && legacy.legal.registrationHref
+                            ? { verificationUrl: legacy.legal.registrationHref }
+                            : {}),
+                    }] : [],
+            },
+        });
+        const result = await this.dataSource.getRepository(SitePresentationEntity).update({ id: DOCUMENT_ID, schemaVersion: 1, revision: row.revision }, {
+            schemaVersion: 2,
+            revision: row.revision + 1,
+            value,
+            updatedAt: this.#clock(),
+            updatedBy: 'migration:v2',
+        });
+        if (result.affected !== 1)
+            return this.#readExisting();
+        return this.#readExisting();
+    }
+}
+//# sourceMappingURL=typeorm-site-presentation-store.js.map

package/dist/config/typeorm-site-presentation-store.js.map

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

package/dist/config/typeorm-site-profile-store.d.ts

@@ -0,0 +1,16 @@
+import { type SiteProfile, type SiteProfileSnapshot } from '@zlooks.cn/global-config-shared';
+import type { DataSource } from 'typeorm';
+export declare class TypeOrmSiteProfileStore {
+    #private;
+    private readonly dataSource;
+    constructor(dataSource: DataSource, options?: {
+        readonly clock?: () => Date;
+    });
+    read(): Promise<SiteProfileSnapshot>;
+    update(input: {
+        readonly expectedRevision: number;
+        readonly updatedBy: string;
+        readonly value: SiteProfile;
+    }): Promise<SiteProfileSnapshot>;
+}
+//# sourceMappingURL=typeorm-site-profile-store.d.ts.map

package/dist/config/typeorm-site-profile-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeorm-site-profile-store.d.ts","sourceRoot":"","sources":["../../src/config/typeorm-site-profile-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAoB1C,qBAAa,uBAAuB;;IAIhC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAD7B,YACmB,UAAU,EAAE,UAAU,EACvC,OAAO,GAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO,EAG9C;IAEY,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAGhD;IAEY,MAAM,CAAC,KAAK,EAAE;QACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;KAC7B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgB/B;CAgCF"}

package/dist/config/typeorm-site-profile-store.js

@@ -0,0 +1,74 @@
+import { parseSiteProfile, parseSiteProfileSnapshot, } from '@zlooks.cn/global-config-shared';
+import { SiteProfileEntity } from '../persistence/entities.js';
+import { GlobalConfigRevisionConflictError } from './global-config-revision-conflict-error.js';
+const DOCUMENT_ID = 'site.profile';
+const DEFAULT_SITE_PROFILE = parseSiteProfile({
+    profile: {
+        displayName: 'ZLOOKS',
+        headline: '保持好奇，认真生活。',
+        biography: '这里是我的个人网站。我把值得记住的想法、作品与生活片刻留在这里，不急着更新，也不急着给每件事情下结论。',
+    },
+    topics: [
+        { id: 'thoughts', name: '想法', summary: '观察、记录与继续思考' },
+        { id: 'works', name: '作品', summary: '完成的作品与进行中的尝试' },
+        { id: 'life', name: '生活', summary: '普通但值得记住的片刻' },
+        { id: 'travel', name: '远方', summary: '旅行、见闻与仍在保持的好奇' },
+    ],
+    featuredLinks: [{ id: 'blog', label: '阅读文章', href: '/blog', external: false }],
+});
+export class TypeOrmSiteProfileStore {
+    dataSource;
+    #clock;
+    constructor(dataSource, options = {}) {
+        this.dataSource = dataSource;
+        this.#clock = options.clock ?? (() => new Date());
+    }
+    async read() {
+        await this.#ensureInitialDocument();
+        return this.#readExisting();
+    }
+    async update(input) {
+        const value = parseSiteProfile(input.value);
+        await this.#ensureInitialDocument();
+        const result = await this.dataSource.getRepository(SiteProfileEntity).update({ id: DOCUMENT_ID, revision: input.expectedRevision }, {
+            revision: input.expectedRevision + 1,
+            value,
+            updatedAt: this.#clock(),
+            updatedBy: input.updatedBy,
+        });
+        if (result.affected !== 1) {
+            throw new GlobalConfigRevisionConflictError((await this.#readExisting()).revision);
+        }
+        return this.#readExisting();
+    }
+    async #ensureInitialDocument() {
+        const now = this.#clock();
+        await this.dataSource.getRepository(SiteProfileEntity)
+            .createQueryBuilder()
+            .insert()
+            .into(SiteProfileEntity)
+            .values({
+            id: DOCUMENT_ID,
+            schemaVersion: 1,
+            revision: 0,
+            value: DEFAULT_SITE_PROFILE,
+            updatedAt: now,
+            updatedBy: 'bootstrap',
+        })
+            .orIgnore()
+            .execute();
+    }
+    async #readExisting() {
+        const row = await this.dataSource.getRepository(SiteProfileEntity).findOneByOrFail({
+            id: DOCUMENT_ID,
+        });
+        return parseSiteProfileSnapshot({
+            schemaVersion: row.schemaVersion,
+            revision: row.revision,
+            value: row.value,
+            updatedAt: row.updatedAt.toISOString(),
+            updatedBy: row.updatedBy,
+        });
+    }
+}
+//# sourceMappingURL=typeorm-site-profile-store.js.map

package/dist/config/typeorm-site-profile-store.js.map

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

package/dist/mcp/global-config-provider.d.ts

@@ -0,0 +1,10 @@
+import { type SitePresentationSnapshot, type SiteProfileSnapshot } from '@zlooks.cn/global-config-shared';
+interface GlobalConfigMcpOperations {
+    readPresentation(): Promise<SitePresentationSnapshot>;
+    updatePresentationFromMcp(input: unknown): Promise<SitePresentationSnapshot>;
+    readProfile(): Promise<SiteProfileSnapshot>;
+    updateProfileFromMcp(input: unknown): Promise<SiteProfileSnapshot>;
+}
+export declare function createGlobalConfigMcpProvider(operations: GlobalConfigMcpOperations): import("@hile/mcp").McpProviderDefinition;
+export {};
+//# sourceMappingURL=global-config-provider.d.ts.map

package/dist/mcp/global-config-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-config-provider.d.ts","sourceRoot":"","sources":["../../src/mcp/global-config-provider.ts"],"names":[],"mappings":"AAOA,OAAO,EAeL,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AAGzC,UAAU,yBAAyB;IACjC,gBAAgB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACtD,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC7E,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC5C,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACpE;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,yBAAyB,6CAyGlF"}

package/dist/mcp/global-config-provider.js

@@ -0,0 +1,160 @@
+import { defineMcpPrompt, defineMcpProvider, defineMcpTool, } from '@hile/mcp';
+import { GLOBAL_CONFIG_MCP_EDIT_PROFILE_PROMPT, GLOBAL_CONFIG_MCP_EDIT_PROMPT, GLOBAL_CONFIG_MCP_PROVIDER_ID, GLOBAL_CONFIG_MCP_READ_PROFILE_TOOL, GLOBAL_CONFIG_MCP_READ_SCOPE, GLOBAL_CONFIG_MCP_READ_TOOL, GLOBAL_CONFIG_MCP_UPDATE_PROFILE_TOOL, GLOBAL_CONFIG_MCP_UPDATE_TOOL, GLOBAL_CONFIG_MCP_WRITE_SCOPE, globalConfigMcpEditPromptSchema, globalConfigMcpProfileUpdateSchema, globalConfigMcpUpdateSchema, sitePresentationSnapshotSchema, siteProfileSnapshotSchema, } from '@zlooks.cn/global-config-shared';
+import { z } from 'zod';
+export function createGlobalConfigMcpProvider(operations) {
+    const readPresentation = defineMcpTool({
+        name: GLOBAL_CONFIG_MCP_READ_TOOL,
+        title: '读取站点展示配置',
+        description: '读取当前完整的站点展示配置快照及 revision，包括站点身份、链接分组、版权、备案和背景资源等公开字段。此工具只读且不会修改配置；执行更新前应先调用它，以最新快照为基础保留未要求变更的字段并取得 expectedRevision。',
+        inputSchema: z.strictObject({}),
+        outputSchema: sitePresentationSnapshotSchema,
+        annotations: { readOnlyHint: true, idempotentHint: true, destructiveHint: false },
+        access: { scopes: [GLOBAL_CONFIG_MCP_READ_SCOPE] },
+        execution: { timeoutMs: 10_000, retry: 'idempotent-failover' },
+    }, async (_input, context) => cancellableRead(context.signal, operations.readPresentation));
+    const updatePresentation = defineMcpTool({
+        name: GLOBAL_CONFIG_MCP_UPDATE_TOOL,
+        title: '修改站点展示配置',
+        description: '使用完整 value 替换站点身份、链接分组、版权、备案和背景资源配置，成功后返回新的完整快照与 revision。该操作不是局部补丁，会影响首页及博客页脚等读取这些投影的位置；必须传入刚读取的 expectedRevision，写入前确认完整内容，版本冲突时重新读取且不得自动重试覆盖。',
+        inputSchema: globalConfigMcpUpdateSchema,
+        outputSchema: sitePresentationSnapshotSchema,
+        annotations: { readOnlyHint: false, idempotentHint: false, destructiveHint: true },
+        access: { scopes: [GLOBAL_CONFIG_MCP_WRITE_SCOPE] },
+        execution: { timeoutMs: 10_000, retry: 'never' },
+    }, async (input, context) => {
+        context.signal.throwIfAborted();
+        const snapshot = await operations.updatePresentationFromMcp({
+            ...input,
+            updatedBy: actorFrom(context.principal),
+        });
+        await bestEffortUpdateNotice(context.emit, {
+            event: 'global-config.site-presentation.updated',
+            revision: snapshot.revision,
+            updatedBy: snapshot.updatedBy,
+        });
+        return result(snapshot, `站点展示配置已更新到 revision ${snapshot.revision}`);
+    });
+    const readProfile = defineMcpTool({
+        name: GLOBAL_CONFIG_MCP_READ_PROFILE_TOOL,
+        title: '读取站点资料',
+        description: '读取当前完整的语义站点资料快照及 revision，包括主体资料、长期关注主题、重点链接和审计信息。此工具只读且不包含页面布局、样式或组件配置；执行资料更新前应先调用它，以最新快照保留未要求变更的字段并取得 expectedRevision。',
+        inputSchema: z.strictObject({}),
+        outputSchema: siteProfileSnapshotSchema,
+        annotations: { readOnlyHint: true, idempotentHint: true, destructiveHint: false },
+        access: { scopes: [GLOBAL_CONFIG_MCP_READ_SCOPE] },
+        execution: { timeoutMs: 10_000, retry: 'idempotent-failover' },
+    }, async (_input, context) => cancellableRead(context.signal, operations.readProfile));
+    const updateProfile = defineMcpTool({
+        name: GLOBAL_CONFIG_MCP_UPDATE_PROFILE_TOOL,
+        title: '修改站点资料',
+        description: '使用完整 value 替换主体资料、长期关注主题和重点链接，成功后返回新的完整快照与 revision。该操作不是局部补丁，也不接受 hero、布局、样式或组件字段；必须传入刚读取的 expectedRevision，写入前确认完整内容，版本冲突时重新读取且不得自动重试覆盖。',
+        inputSchema: globalConfigMcpProfileUpdateSchema,
+        outputSchema: siteProfileSnapshotSchema,
+        annotations: { readOnlyHint: false, idempotentHint: false, destructiveHint: true },
+        access: { scopes: [GLOBAL_CONFIG_MCP_WRITE_SCOPE] },
+        execution: { timeoutMs: 10_000, retry: 'never' },
+    }, async (input, context) => {
+        context.signal.throwIfAborted();
+        const snapshot = await operations.updateProfileFromMcp({
+            ...input,
+            updatedBy: actorFrom(context.principal),
+        });
+        await bestEffortUpdateNotice(context.emit, {
+            event: 'global-config.site-profile.updated',
+            revision: snapshot.revision,
+            updatedBy: snapshot.updatedBy,
+        });
+        return result(snapshot, `站点资料已更新到 revision ${snapshot.revision}`);
+    });
+    const editPresentation = defineMcpPrompt({
+        name: GLOBAL_CONFIG_MCP_EDIT_PROMPT,
+        title: '修改站点展示配置',
+        description: '读取当前快照，安全修改站点身份、favicon、链接、版权或备案，经确认后提交并验证。',
+        argsSchema: globalConfigMcpEditPromptSchema,
+        access: { scopes: [GLOBAL_CONFIG_MCP_READ_SCOPE, GLOBAL_CONFIG_MCP_WRITE_SCOPE] },
+    }, ({ changeRequest }, context) => {
+        context.signal.throwIfAborted();
+        return promptResult('安全修改站点展示配置', editPresentationMessage(changeRequest));
+    });
+    const editProfile = defineMcpPrompt({
+        name: GLOBAL_CONFIG_MCP_EDIT_PROFILE_PROMPT,
+        title: '修改站点资料',
+        description: '读取当前快照，安全修改主体资料、关注主题或重点链接，经确认后提交并验证。',
+        argsSchema: globalConfigMcpEditPromptSchema,
+        access: { scopes: [GLOBAL_CONFIG_MCP_READ_SCOPE, GLOBAL_CONFIG_MCP_WRITE_SCOPE] },
+    }, ({ changeRequest }, context) => {
+        context.signal.throwIfAborted();
+        return promptResult('安全修改站点资料', editProfileMessage(changeRequest));
+    });
+    return defineMcpProvider({
+        id: GLOBAL_CONFIG_MCP_PROVIDER_ID,
+        displayName: '全局配置',
+        tools: {
+            [GLOBAL_CONFIG_MCP_READ_TOOL]: readPresentation,
+            [GLOBAL_CONFIG_MCP_UPDATE_TOOL]: updatePresentation,
+            [GLOBAL_CONFIG_MCP_READ_PROFILE_TOOL]: readProfile,
+            [GLOBAL_CONFIG_MCP_UPDATE_PROFILE_TOOL]: updateProfile,
+        },
+        prompts: {
+            [GLOBAL_CONFIG_MCP_EDIT_PROMPT]: editPresentation,
+            [GLOBAL_CONFIG_MCP_EDIT_PROFILE_PROMPT]: editProfile,
+        },
+    });
+}
+async function bestEffortUpdateNotice(emit, data) {
+    try {
+        await emit.log('notice', data);
+    }
+    catch {
+        // Observability must not turn a committed configuration update into a reported failure.
+    }
+}
+async function cancellableRead(signal, read) {
+    signal.throwIfAborted();
+    const snapshot = await read();
+    signal.throwIfAborted();
+    return result(snapshot);
+}
+function result(snapshot, message) {
+    return {
+        content: [{ type: 'text', text: message ?? JSON.stringify(snapshot) }],
+        structuredContent: snapshot,
+    };
+}
+function promptResult(description, text) {
+    return {
+        description,
+        messages: [{ role: 'user', content: { type: 'text', text } }],
+    };
+}
+function editPresentationMessage(changeRequest) {
+    return `请按以下要求修改站点展示配置：${changeRequest}
+1. 先调用 global-config.${GLOBAL_CONFIG_MCP_READ_TOOL} 获取当前完整配置和 revision；不得凭旧上下文构造更新。
+2. 只修改 identity、linkGroups、legal 中用户明确要求的字段，保留所有未提及字段。backgroundVideoUrl、logoUrl、faviconUrl 只能是站内绝对路径或 HTTP/HTTPS URL；backgroundVideoUrl 设为 null 表示关闭动态背景。legal 会同步投影到首页和博客页脚；registrations 必须使用 id、kind、number、可选 verificationUrl/iconUrl 的结构。
+3. 修改备案信息时，number、kind 和 verificationUrl 必须来自用户提供或已核验的权威来源；缺失的事实不得推断、猜测或编造。
+4. 不得加入密钥、令牌、任意 HTML、脚本或未经核验的法律登记信息。
+5. 向用户展示字段级变更摘要和即将提交的完整配置，并在写入前取得明确确认。
+6. 确认后调用 global-config.${GLOBAL_CONFIG_MCP_UPDATE_TOOL}，传入完整 value 和刚读取到的 expectedRevision。
+7. 若版本冲突，重新读取最新快照，只重新应用原始变更要求并再次确认；不得覆盖并发修改。
+8. 更新成功后再次调用 global-config.${GLOBAL_CONFIG_MCP_READ_TOOL}，核对 revision 和目标字段，再报告结果。`;
+}
+function editProfileMessage(changeRequest) {
+    return `请按以下要求修改站点资料：${changeRequest}
+1. 先调用 global-config.${GLOBAL_CONFIG_MCP_READ_PROFILE_TOOL} 获取当前完整配置和 revision；不得凭旧上下文构造更新。
+2. 只修改用户明确要求的 profile、topics、featuredLinks，保留所有未提及字段。profile 表达主体资料，topics 表达长期关注主题，featuredLinks 表达重点目的地；不得加入 hero、orbit、card、布局、样式或组件配置。
+3. 不得加入密钥、令牌、任意 HTML、脚本或未经用户提供的个人资料。
+4. 向用户展示字段级变更摘要和即将提交的完整配置，并在写入前取得明确确认。
+5. 确认后调用 global-config.${GLOBAL_CONFIG_MCP_UPDATE_PROFILE_TOOL}，传入完整 value 和刚读取到的 expectedRevision。
+6. 若版本冲突，重新读取最新快照，只重新应用原始变更要求并再次确认；不得覆盖并发修改。
+7. 更新成功后再次调用 global-config.${GLOBAL_CONFIG_MCP_READ_PROFILE_TOOL}，核对 revision 和目标字段，再报告结果。`;
+}
+function actorFrom(principal) {
+    if (!principal)
+        throw new Error('Verified MCP principal is required');
+    const identity = principal.clientId ?? principal.subject;
+    const actor = `mcp:${identity}`;
+    if (actor.length > 256)
+        throw new Error('MCP principal identity is too long');
+    return actor;
+}
+//# sourceMappingURL=global-config-provider.js.map

package/dist/mcp/global-config-provider.js.map

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

package/dist/migrations/index.d.ts

@@ -0,0 +1,3 @@
+import type { DatabaseMigration } from '@zlooks.cn/database-command';
+export declare const globalConfigMigrations: readonly DatabaseMigration[];
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,eAAO,MAAM,sBAAsB,EAAE,SAAS,iBAAiB,EAAO,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,2 @@
+export const globalConfigMigrations = [];
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAiC,EAAE,CAAC"}

package/dist/persistence/entities.d.ts

@@ -0,0 +1,21 @@
+import type { SiteProfile, SitePresentation } from '@zlooks.cn/global-config-shared';
+import { EntitySchema } from 'typeorm';
+export interface SitePresentationRow {
+    id: 'site.presentation';
+    schemaVersion: number;
+    revision: number;
+    value: SitePresentation | unknown;
+    updatedAt: Date;
+    updatedBy: string;
+}
+export declare const SitePresentationEntity: EntitySchema<SitePresentationRow>;
+export interface SiteProfileRow {
+    id: 'site.profile';
+    schemaVersion: 1;
+    revision: number;
+    value: SiteProfile;
+    updatedAt: Date;
+    updatedBy: string;
+}
+export declare const SiteProfileEntity: EntitySchema<SiteProfileRow>;
+//# sourceMappingURL=entities.d.ts.map

package/dist/persistence/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/persistence/entities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,mBAAmB,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,sBAAsB,mCAWjC,CAAC;AAEH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,cAAc,CAAC;IACnB,aAAa,EAAE,CAAC,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,iBAAiB,8BAW5B,CAAC"}

package/dist/persistence/entities.js

@@ -0,0 +1,26 @@
+import { EntitySchema } from 'typeorm';
+export const SitePresentationEntity = new EntitySchema({
+    name: 'SitePresentation',
+    tableName: 'global_config_site_presentation',
+    columns: {
+        id: { type: 'varchar', length: 64, primary: true },
+        schemaVersion: { name: 'schema_version', type: 'integer' },
+        revision: { type: 'integer' },
+        value: { type: 'jsonb' },
+        updatedAt: { name: 'updated_at', type: 'timestamptz' },
+        updatedBy: { name: 'updated_by', type: 'varchar', length: 256 },
+    },
+});
+export const SiteProfileEntity = new EntitySchema({
+    name: 'SiteProfile',
+    tableName: 'global_config_site_profile',
+    columns: {
+        id: { type: 'varchar', length: 64, primary: true },
+        schemaVersion: { name: 'schema_version', type: 'integer' },
+        revision: { type: 'integer' },
+        value: { type: 'jsonb' },
+        updatedAt: { name: 'updated_at', type: 'timestamptz' },
+        updatedBy: { name: 'updated_by', type: 'varchar', length: 256 },
+    },
+});
+//# sourceMappingURL=entities.js.map

package/dist/persistence/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/persistence/entities.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAWvC,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,YAAY,CAAsB;IAC1E,IAAI,EAAE,kBAAkB;IACxB,SAAS,EAAE,iCAAiC;IAC5C,OAAO,EAAE;QACP,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAClD,aAAa,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE;QAC1D,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QACxB,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE;QACtD,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE;KAChE;CACF,CAAC,CAAC;AAWH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,YAAY,CAAiB;IAChE,IAAI,EAAE,aAAa;IACnB,SAAS,EAAE,4BAA4B;IACvC,OAAO,EAAE;QACP,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAClD,aAAa,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE;QAC1D,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QAC7B,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QACxB,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE;QACtD,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE;KAChE;CACF,CAAC,CAAC"}