@aopslab/domain-pg-bootstrap-docman 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,6 @@
+AOPS Community
+
+Copyright 2026 Mehmet Zeki Sönmez
+
+Licensed under the Apache License, Version 2.0.
+Source: https://github.com/eeemzs/aops-community

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './pg-bootstrap.js';

package/dist/index.js

@@ -0,0 +1 @@
+export * from './pg-bootstrap.js';

package/dist/pg-bootstrap.d.ts

@@ -0,0 +1,13 @@
+export type DocmanPgBootstrapPaths = {
+    domainRoot: string;
+    migrationsDir: string;
+    migrationsDirExists: boolean;
+    journalPath: string;
+    journalExists: boolean;
+};
+export declare function resolveDocmanPgBootstrapPaths(domainRoot?: string): DocmanPgBootstrapPaths;
+export declare function applyDocmanPgSchema(params: {
+    repoUrl: string;
+    domainRoot?: string;
+    logs?: string[];
+}): Promise<DocmanPgBootstrapPaths>;

package/dist/pg-bootstrap.js

@@ -0,0 +1,240 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Client } from 'pg';
+const STATEMENT_BREAKPOINT = '--> statement-breakpoint';
+const MIGRATION_TABLE = 'docman_schema_migrations';
+const TRACKED_TABLES = [
+    'docman_documents',
+    'docman_document_groups',
+    'docman_document_versions',
+    'docman_sections',
+    'docman_pages',
+    'docman_page_versions',
+    'docman_document_index_entries',
+    'docman_document_section_links',
+    'docman_section_page_links',
+    'docman_snippets',
+    'docman_page_snippet_links',
+    'docman_assets',
+    'docman_asset_versions',
+    'docman_embeds',
+    'docman_page_embed_links',
+];
+function resolveDocmanDomainRoot(domainRoot) {
+    const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+    const explicitDomainRoot = domainRoot ? path.resolve(domainRoot) : null;
+    const explicitWorkspaceDomainRoots = explicitDomainRoot
+        ? [path.join(explicitDomainRoot, 'domains', 'docman'), path.join(explicitDomainRoot, 'docman')]
+        : [];
+    const workspaceDomainRoot = path.resolve(packageRoot, '..');
+    const candidates = [packageRoot, explicitDomainRoot, ...explicitWorkspaceDomainRoots, workspaceDomainRoot];
+    for (const candidate of candidates) {
+        if (candidate && existsSync(path.join(candidate, 'drizzle-out', 'docman'))) {
+            return candidate;
+        }
+    }
+    return packageRoot;
+}
+export function resolveDocmanPgBootstrapPaths(domainRoot) {
+    const resolvedDomainRoot = resolveDocmanDomainRoot(domainRoot);
+    const migrationsDir = path.join(resolvedDomainRoot, 'drizzle-out', 'docman');
+    const journalPath = path.join(migrationsDir, 'meta', '_journal.json');
+    return {
+        domainRoot: resolvedDomainRoot,
+        migrationsDir,
+        migrationsDirExists: existsSync(migrationsDir),
+        journalPath,
+        journalExists: existsSync(journalPath),
+    };
+}
+function splitMigrationStatements(sql) {
+    return sql
+        .split(STATEMENT_BREAKPOINT)
+        .map((statement) => statement.trim())
+        .filter(Boolean);
+}
+function readMigrationJournal(paths) {
+    if (!paths.journalExists) {
+        throw new Error(`docman_pg_bootstrap_journal_missing:${paths.journalPath}`);
+    }
+    const payload = JSON.parse(readFileSync(paths.journalPath, 'utf8'));
+    const entries = Array.isArray(payload.entries) ? payload.entries : [];
+    return entries
+        .map((entry) => ({
+        idx: Number(entry.idx ?? 0),
+        tag: String(entry.tag ?? '').trim(),
+    }))
+        .filter((entry) => entry.tag.length > 0)
+        .sort((left, right) => left.idx - right.idx);
+}
+function resolveMigrationSqlPath(paths, tag) {
+    return path.join(paths.migrationsDir, `${tag}.sql`);
+}
+async function withPgClient(repoUrl, fn) {
+    const client = new Client({ connectionString: repoUrl });
+    await client.connect();
+    try {
+        return await fn(client);
+    }
+    finally {
+        await client.end().catch(() => undefined);
+    }
+}
+async function ensureMigrationTable(client) {
+    await client.query(`CREATE TABLE IF NOT EXISTS public.${MIGRATION_TABLE} (
+      tag text PRIMARY KEY,
+      applied_at timestamp with time zone NOT NULL DEFAULT now()
+    )`);
+}
+async function readAppliedTags(client) {
+    const result = await client.query(`SELECT tag FROM public.${MIGRATION_TABLE}`);
+    return new Set(result.rows.map((row) => row.tag));
+}
+async function queryExistingTables(client) {
+    const result = await client.query(`SELECT table_name
+       FROM information_schema.tables
+      WHERE table_schema = 'public'
+        AND table_name = ANY($1::text[])`, [TRACKED_TABLES]);
+    return new Set(result.rows.map((row) => row.table_name));
+}
+async function hasColumn(client, tableName, columnName, expectedType) {
+    const result = await client.query(`SELECT data_type, udt_name
+       FROM information_schema.columns
+      WHERE table_schema = 'public'
+        AND table_name = $1
+        AND column_name = $2`, [tableName, columnName]);
+    const row = result.rows[0];
+    if (!row)
+        return false;
+    if (!expectedType)
+        return true;
+    return row.data_type === expectedType || row.udt_name === expectedType;
+}
+async function lacksColumn(client, tableName, columnName) {
+    const result = await client.query(`SELECT COUNT(*)::text AS count
+       FROM information_schema.columns
+      WHERE table_schema = 'public'
+        AND table_name = $1
+        AND column_name = $2`, [tableName, columnName]);
+    return String(result.rows[0]?.count ?? '0') === '0';
+}
+async function schemaLooksCurrent(client) {
+    const existingTables = await queryExistingTables(client);
+    if (existingTables.size !== TRACKED_TABLES.length) {
+        return false;
+    }
+    const checks = [
+        () => hasColumn(client, 'docman_documents', 'scopeId', 'uuid'),
+        () => hasColumn(client, 'docman_document_groups', 'scopeId', 'uuid'),
+        () => hasColumn(client, 'docman_sections', 'scopeId', 'uuid'),
+        () => hasColumn(client, 'docman_pages', 'scopeId', 'uuid'),
+        () => hasColumn(client, 'docman_snippets', 'scopeId', 'uuid'),
+        () => hasColumn(client, 'docman_embeds', 'scopeId', 'uuid'),
+        () => hasColumn(client, 'docman_assets', 'scopeId', 'uuid'),
+        () => hasColumn(client, 'docman_documents', 'titleMl', 'jsonb'),
+        () => hasColumn(client, 'docman_document_versions', 'releaseNotesMl', 'jsonb'),
+        () => hasColumn(client, 'docman_page_versions', 'contentData', 'jsonb'),
+        () => hasColumn(client, 'docman_document_index_entries', 'searchText', 'text'),
+        () => hasColumn(client, 'docman_document_index_entries', 'summaryText', 'text'),
+        () => hasColumn(client, 'docman_document_index_entries', 'sourceCharCount', 'int4'),
+        () => hasColumn(client, 'docman_document_index_entries', 'sourceWordCount', 'int4'),
+        () => hasColumn(client, 'docman_document_index_entries', 'summaryCharCount', 'int4'),
+        () => hasColumn(client, 'docman_document_index_entries', 'summaryWordCount', 'int4'),
+        () => hasColumn(client, 'docman_document_index_entries', 'embeddingProvider', 'text'),
+        () => hasColumn(client, 'docman_document_index_entries', 'embeddingModel', 'text'),
+        () => hasColumn(client, 'docman_document_index_entries', 'embeddingHash', 'text'),
+        () => hasColumn(client, 'docman_document_index_entries', 'embeddingDimensions', 'int4'),
+        () => hasColumn(client, 'docman_document_index_entries', 'embeddingVector', 'text'),
+        () => hasColumn(client, 'docman_document_section_links', 'directives', 'jsonb'),
+        () => hasColumn(client, 'docman_page_snippet_links', 'showLineNumbers'),
+        () => hasColumn(client, 'docman_assets', 'currentVersionId', 'uuid'),
+        () => hasColumn(client, 'docman_asset_versions', 'contentHash', 'text'),
+        () => lacksColumn(client, 'docman_sections', 'description'),
+        () => lacksColumn(client, 'docman_sections', 'descriptionMl'),
+    ];
+    for (const check of checks) {
+        if (!(await check()))
+            return false;
+    }
+    return true;
+}
+async function adoptExistingCurrentSchema(client, missingEntries, logs) {
+    if (missingEntries.length === 0)
+        return true;
+    const looksCurrent = await schemaLooksCurrent(client);
+    if (!looksCurrent)
+        return false;
+    logs.push('Existing docman PostgreSQL schema detected without complete migration journal. Adopting current schema state.');
+    for (const entry of missingEntries) {
+        await client.query(`INSERT INTO public.${MIGRATION_TABLE} (tag) VALUES ($1) ON CONFLICT (tag) DO NOTHING`, [entry.tag]);
+    }
+    logs.push(`Adopted ${String(missingEntries.length)} migration tag(s) without reapplying SQL.`);
+    return true;
+}
+async function applyMigrationEntry(client, paths, entry, logs) {
+    const sqlPath = resolveMigrationSqlPath(paths, entry.tag);
+    if (!existsSync(sqlPath)) {
+        throw new Error(`docman_pg_bootstrap_sql_missing:${sqlPath}`);
+    }
+    const sql = readFileSync(sqlPath, 'utf8');
+    const statements = splitMigrationStatements(sql);
+    if (statements.length === 0) {
+        logs.push(`Skipping ${entry.tag}: migration file contains no executable statements.`);
+        await client.query(`INSERT INTO public.${MIGRATION_TABLE} (tag) VALUES ($1) ON CONFLICT (tag) DO NOTHING`, [entry.tag]);
+        return;
+    }
+    logs.push(`Applying Docman PostgreSQL migration: ${entry.tag}`);
+    await client.query('BEGIN');
+    try {
+        for (const statement of statements) {
+            await client.query(statement);
+        }
+        await client.query(`INSERT INTO public.${MIGRATION_TABLE} (tag) VALUES ($1) ON CONFLICT (tag) DO NOTHING`, [entry.tag]);
+        await client.query('COMMIT');
+    }
+    catch (error) {
+        await client.query('ROLLBACK').catch(() => undefined);
+        throw error;
+    }
+}
+async function assertSchemaMatchesAppliedMigrations(client, entries) {
+    const appliedTags = await readAppliedTags(client);
+    const hasFullJournal = entries.every((entry) => appliedTags.has(entry.tag));
+    if (!hasFullJournal)
+        return;
+    const looksCurrent = await schemaLooksCurrent(client);
+    if (looksCurrent)
+        return;
+    throw new Error('docman_pg_bootstrap_schema_drift_detected:all_migrations_marked_applied_but_schema_is_incomplete');
+}
+export async function applyDocmanPgSchema(params) {
+    const logs = params.logs ?? [];
+    const paths = resolveDocmanPgBootstrapPaths(params.domainRoot);
+    if (!paths.migrationsDirExists) {
+        throw new Error(`docman_pg_bootstrap_migrations_dir_missing:${paths.migrationsDir}`);
+    }
+    const entries = readMigrationJournal(paths);
+    logs.push('Applying Docman PostgreSQL schema via owned SQL migration runner...');
+    await withPgClient(params.repoUrl, async (client) => {
+        await client.query('CREATE EXTENSION IF NOT EXISTS pgcrypto');
+        await ensureMigrationTable(client);
+        await assertSchemaMatchesAppliedMigrations(client, entries);
+        let appliedTags = await readAppliedTags(client);
+        const missingEntries = entries.filter((entry) => !appliedTags.has(entry.tag));
+        const adopted = await adoptExistingCurrentSchema(client, missingEntries, logs);
+        if (adopted) {
+            appliedTags = await readAppliedTags(client);
+        }
+        for (const entry of entries) {
+            if (appliedTags.has(entry.tag)) {
+                logs.push(`Skipping ${entry.tag}: already applied.`);
+                continue;
+            }
+            await applyMigrationEntry(client, paths, entry, logs);
+            appliedTags.add(entry.tag);
+        }
+    });
+    logs.push('Docman PostgreSQL schema is ready.');
+    return paths;
+}

package/drizzle-out/docman/0000_curvy_valeria_richards.sql

@@ -0,0 +1,257 @@
+CREATE TABLE "docman_documents" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"scopeId" uuid NOT NULL,
+	"documentUid" text NOT NULL,
+	"groupId" uuid,
+	"groupUid" text,
+	"slug" text,
+	"title" text NOT NULL,
+	"titleMl" jsonb,
+	"summary" text,
+	"summaryMl" jsonb,
+	"description" text,
+	"descriptionMl" jsonb,
+	"status" text NOT NULL,
+	"visibility" text NOT NULL,
+	"tags" jsonb,
+	"pageSize" text,
+	"meta" jsonb,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE TABLE "docman_document_groups" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"scopeId" uuid NOT NULL,
+	"groupUid" text NOT NULL,
+	"parentGroupId" uuid,
+	"parentGroupUid" text,
+	"title" text NOT NULL,
+	"description" text,
+	"meta" jsonb,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE TABLE "docman_document_versions" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"documentId" uuid NOT NULL,
+	"version" integer NOT NULL,
+	"label" text,
+	"status" text NOT NULL,
+	"title" text,
+	"summary" text,
+	"releaseNotes" text,
+	"releaseNotesMl" jsonb,
+	"isCurrent" boolean DEFAULT false NOT NULL,
+	"basedOnVersionId" uuid,
+	"publishedAt" timestamp with time zone,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE TABLE "docman_sections" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"scopeId" uuid NOT NULL,
+	"sectionUid" text NOT NULL,
+	"title" text NOT NULL,
+	"titleMl" jsonb,
+	"description" text,
+	"descriptionMl" jsonb,
+	"kind" text,
+	"slug" text,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE TABLE "docman_pages" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"scopeId" uuid NOT NULL,
+	"pageUid" text NOT NULL,
+	"title" text NOT NULL,
+	"titleMl" jsonb,
+	"kind" text,
+	"meta" jsonb,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE TABLE "docman_page_versions" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"pageId" uuid NOT NULL,
+	"version" integer NOT NULL,
+	"title" text,
+	"format" text NOT NULL,
+	"content" text,
+	"contentMl" jsonb,
+	"contentData" jsonb,
+	"directives" jsonb,
+	"status" text NOT NULL,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE TABLE "docman_document_section_links" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"documentVersionId" uuid NOT NULL,
+	"kind" text NOT NULL,
+	"sectionId" uuid,
+	"pageVersionId" uuid,
+	"parentLinkId" uuid,
+	"position" integer NOT NULL,
+	"depth" integer,
+	"titleOverride" text,
+	"titleVisible" boolean DEFAULT true NOT NULL,
+	"numbering" text,
+	"pageBreakBefore" boolean DEFAULT false NOT NULL,
+	"pageBreakAfter" boolean DEFAULT false NOT NULL,
+	"directives" jsonb,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE TABLE "docman_section_page_links" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"sectionId" uuid NOT NULL,
+	"pageVersionId" uuid NOT NULL,
+	"position" integer NOT NULL,
+	"numbering" text,
+	"titleOverride" text,
+	"titleVisible" boolean DEFAULT true NOT NULL,
+	"pageBreakBefore" boolean DEFAULT false NOT NULL,
+	"pageBreakAfter" boolean DEFAULT false NOT NULL,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE TABLE "docman_snippets" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"scopeId" uuid NOT NULL,
+	"snippetUid" text NOT NULL,
+	"title" text,
+	"language" text NOT NULL,
+	"code" text NOT NULL,
+	"description" text,
+	"meta" jsonb,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE TABLE "docman_page_snippet_links" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"pageVersionId" uuid NOT NULL,
+	"snippetId" uuid NOT NULL,
+	"position" integer NOT NULL,
+	"caption" text,
+	"showLineNumbers" boolean,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE TABLE "docman_embeds" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"scopeId" uuid NOT NULL,
+	"embedUid" text NOT NULL,
+	"type" text NOT NULL,
+	"title" text,
+	"content" text,
+	"url" text,
+	"path" text,
+	"mime" text,
+	"meta" jsonb,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE TABLE "docman_page_embed_links" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"pageVersionId" uuid NOT NULL,
+	"embedId" uuid NOT NULL,
+	"position" integer NOT NULL,
+	"caption" text,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX "document_uid_unique" ON "docman_documents" USING btree ("tenantId","scopeId","documentUid");--> statement-breakpoint
+CREATE INDEX "document_idx_tenant" ON "docman_documents" USING btree ("tenantId");--> statement-breakpoint
+CREATE INDEX "document_idx_scope" ON "docman_documents" USING btree ("tenantId","scopeId");--> statement-breakpoint
+CREATE INDEX "document_idx_status" ON "docman_documents" USING btree ("tenantId","status");--> statement-breakpoint
+CREATE INDEX "document_idx_scope_slug" ON "docman_documents" USING btree ("tenantId","scopeId","slug");--> statement-breakpoint
+CREATE INDEX "document_idx_scope_group_id" ON "docman_documents" USING btree ("tenantId","scopeId","groupId");--> statement-breakpoint
+CREATE INDEX "document_idx_scope_group_uid" ON "docman_documents" USING btree ("tenantId","scopeId","groupUid");--> statement-breakpoint
+CREATE UNIQUE INDEX "document_group_uid_unique" ON "docman_document_groups" USING btree ("tenantId","scopeId","groupUid");--> statement-breakpoint
+CREATE INDEX "document_group_idx_tenant" ON "docman_document_groups" USING btree ("tenantId");--> statement-breakpoint
+CREATE INDEX "document_group_idx_scope" ON "docman_document_groups" USING btree ("tenantId","scopeId");--> statement-breakpoint
+CREATE INDEX "document_group_idx_parent" ON "docman_document_groups" USING btree ("tenantId","parentGroupId");--> statement-breakpoint
+CREATE UNIQUE INDEX "document_version_unique" ON "docman_document_versions" USING btree ("tenantId","documentId","version");--> statement-breakpoint
+CREATE INDEX "document_version_idx_doc" ON "docman_document_versions" USING btree ("tenantId","documentId");--> statement-breakpoint
+CREATE INDEX "document_version_idx_status" ON "docman_document_versions" USING btree ("tenantId","status");--> statement-breakpoint
+CREATE INDEX "document_version_idx_current" ON "docman_document_versions" USING btree ("tenantId","documentId","isCurrent");--> statement-breakpoint
+CREATE UNIQUE INDEX "section_uid_unique" ON "docman_sections" USING btree ("tenantId","scopeId","sectionUid");--> statement-breakpoint
+CREATE INDEX "section_idx_tenant" ON "docman_sections" USING btree ("tenantId");--> statement-breakpoint
+CREATE INDEX "section_idx_scope" ON "docman_sections" USING btree ("tenantId","scopeId");--> statement-breakpoint
+CREATE UNIQUE INDEX "page_uid_unique" ON "docman_pages" USING btree ("tenantId","scopeId","pageUid");--> statement-breakpoint
+CREATE INDEX "page_idx_tenant" ON "docman_pages" USING btree ("tenantId");--> statement-breakpoint
+CREATE INDEX "page_idx_scope" ON "docman_pages" USING btree ("tenantId","scopeId");--> statement-breakpoint
+CREATE UNIQUE INDEX "page_version_unique" ON "docman_page_versions" USING btree ("tenantId","pageId","version");--> statement-breakpoint
+CREATE INDEX "page_version_idx_page" ON "docman_page_versions" USING btree ("tenantId","pageId");--> statement-breakpoint
+CREATE INDEX "page_version_idx_status" ON "docman_page_versions" USING btree ("tenantId","status");--> statement-breakpoint
+CREATE UNIQUE INDEX "doc_section_pos_unique" ON "docman_document_section_links" USING btree ("tenantId","documentVersionId","parentLinkId","position");--> statement-breakpoint
+CREATE INDEX "doc_section_idx_doc_version" ON "docman_document_section_links" USING btree ("tenantId","documentVersionId");--> statement-breakpoint
+CREATE INDEX "doc_section_idx_section" ON "docman_document_section_links" USING btree ("tenantId","sectionId");--> statement-breakpoint
+CREATE INDEX "doc_section_idx_page_version" ON "docman_document_section_links" USING btree ("tenantId","pageVersionId");--> statement-breakpoint
+CREATE INDEX "doc_section_idx_parent" ON "docman_document_section_links" USING btree ("tenantId","parentLinkId");--> statement-breakpoint
+CREATE UNIQUE INDEX "section_page_pos_unique" ON "docman_section_page_links" USING btree ("tenantId","sectionId","position");--> statement-breakpoint
+CREATE INDEX "section_page_idx_section" ON "docman_section_page_links" USING btree ("tenantId","sectionId");--> statement-breakpoint
+CREATE INDEX "section_page_idx_page_version" ON "docman_section_page_links" USING btree ("tenantId","pageVersionId");--> statement-breakpoint
+CREATE UNIQUE INDEX "snippet_uid_unique" ON "docman_snippets" USING btree ("tenantId","scopeId","snippetUid");--> statement-breakpoint
+CREATE INDEX "snippet_idx_tenant" ON "docman_snippets" USING btree ("tenantId");--> statement-breakpoint
+CREATE INDEX "snippet_idx_scope" ON "docman_snippets" USING btree ("tenantId","scopeId");--> statement-breakpoint
+CREATE INDEX "snippet_idx_scope_language" ON "docman_snippets" USING btree ("tenantId","scopeId","language");--> statement-breakpoint
+CREATE UNIQUE INDEX "page_snippet_pos_unique" ON "docman_page_snippet_links" USING btree ("tenantId","pageVersionId","position");--> statement-breakpoint
+CREATE INDEX "page_snippet_idx_page_version" ON "docman_page_snippet_links" USING btree ("tenantId","pageVersionId");--> statement-breakpoint
+CREATE INDEX "page_snippet_idx_snippet" ON "docman_page_snippet_links" USING btree ("tenantId","snippetId");--> statement-breakpoint
+CREATE UNIQUE INDEX "embed_uid_unique" ON "docman_embeds" USING btree ("tenantId","scopeId","embedUid");--> statement-breakpoint
+CREATE INDEX "embed_idx_tenant" ON "docman_embeds" USING btree ("tenantId");--> statement-breakpoint
+CREATE INDEX "embed_idx_scope" ON "docman_embeds" USING btree ("tenantId","scopeId");--> statement-breakpoint
+CREATE INDEX "embed_idx_scope_type" ON "docman_embeds" USING btree ("tenantId","scopeId","type");--> statement-breakpoint
+CREATE UNIQUE INDEX "page_embed_pos_unique" ON "docman_page_embed_links" USING btree ("tenantId","pageVersionId","position");--> statement-breakpoint
+CREATE INDEX "page_embed_idx_page_version" ON "docman_page_embed_links" USING btree ("tenantId","pageVersionId");--> statement-breakpoint
+CREATE INDEX "page_embed_idx_embed" ON "docman_page_embed_links" USING btree ("tenantId","embedId");

package/drizzle-out/docman/0001_massive_risque.sql

@@ -0,0 +1,2 @@
+ALTER TABLE "docman_sections" DROP COLUMN "description";--> statement-breakpoint
+ALTER TABLE "docman_sections" DROP COLUMN "descriptionMl";

package/drizzle-out/docman/0002_simple_logan.sql

@@ -0,0 +1,50 @@
+CREATE TABLE "docman_assets" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"scopeId" uuid NOT NULL,
+	"assetUid" text NOT NULL,
+	"kind" text NOT NULL,
+	"title" text,
+	"slug" text,
+	"altText" text,
+	"currentVersionId" uuid,
+	"meta" jsonb,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE TABLE "docman_asset_versions" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"assetId" uuid NOT NULL,
+	"version" integer NOT NULL,
+	"label" text,
+	"status" text NOT NULL,
+	"storageKey" text,
+	"sourcePath" text,
+	"sourceUrl" text,
+	"filename" text,
+	"mime" text NOT NULL,
+	"contentHash" text NOT NULL,
+	"byteSize" integer,
+	"width" integer,
+	"height" integer,
+	"variants" jsonb,
+	"meta" jsonb,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX "asset_uid_unique" ON "docman_assets" USING btree ("tenantId","scopeId","assetUid");--> statement-breakpoint
+CREATE INDEX "asset_idx_tenant" ON "docman_assets" USING btree ("tenantId");--> statement-breakpoint
+CREATE INDEX "asset_idx_scope" ON "docman_assets" USING btree ("tenantId","scopeId");--> statement-breakpoint
+CREATE INDEX "asset_idx_scope_kind" ON "docman_assets" USING btree ("tenantId","scopeId","kind");--> statement-breakpoint
+CREATE INDEX "asset_idx_scope_current_version" ON "docman_assets" USING btree ("tenantId","scopeId","currentVersionId");--> statement-breakpoint
+CREATE UNIQUE INDEX "asset_version_unique" ON "docman_asset_versions" USING btree ("tenantId","assetId","version");--> statement-breakpoint
+CREATE INDEX "asset_version_idx_asset" ON "docman_asset_versions" USING btree ("tenantId","assetId");--> statement-breakpoint
+CREATE INDEX "asset_version_idx_status" ON "docman_asset_versions" USING btree ("tenantId","status");--> statement-breakpoint
+CREATE INDEX "asset_version_idx_hash" ON "docman_asset_versions" USING btree ("tenantId","contentHash");

package/drizzle-out/docman/0003_quick_index.sql

@@ -0,0 +1,45 @@
+CREATE TABLE "docman_document_index_entries" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"tenantId" text NOT NULL,
+	"documentVersionId" uuid NOT NULL,
+	"documentId" uuid NOT NULL,
+	"locale" text DEFAULT '' NOT NULL,
+	"fallbackLocale" text DEFAULT '' NOT NULL,
+	"itemKind" text NOT NULL,
+	"sortOrder" integer NOT NULL,
+	"buildFingerprint" text NOT NULL,
+	"linkId" uuid,
+	"parentLinkId" uuid,
+	"anchor" text NOT NULL,
+	"parentAnchor" text,
+	"number" text,
+	"depth" integer NOT NULL,
+	"position" integer NOT NULL,
+	"title" text NOT NULL,
+	"breadcrumb" text NOT NULL,
+	"titleVisible" boolean DEFAULT true NOT NULL,
+	"pageBreakBefore" boolean DEFAULT false NOT NULL,
+	"pageBreakAfter" boolean DEFAULT false NOT NULL,
+	"sectionId" uuid,
+	"sectionUid" text,
+	"sectionSlug" text,
+	"pageId" uuid,
+	"pageUid" text,
+	"pageVersionId" uuid,
+	"format" text,
+	"pageNumberStart" integer,
+	"pageNumberEnd" integer,
+	"bodyText" text,
+	"searchText" text NOT NULL,
+	"createdBy" text,
+	"updatedBy" text,
+	"createdAt" timestamp with time zone DEFAULT now(),
+	"updatedAt" timestamp with time zone DEFAULT now()
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX "doc_index_entry_sort_unique" ON "docman_document_index_entries" USING btree ("tenantId","documentVersionId","locale","fallbackLocale","sortOrder");--> statement-breakpoint
+CREATE UNIQUE INDEX "doc_index_entry_anchor_unique" ON "docman_document_index_entries" USING btree ("tenantId","documentVersionId","locale","fallbackLocale","anchor");--> statement-breakpoint
+CREATE INDEX "doc_index_entry_idx_doc_version" ON "docman_document_index_entries" USING btree ("tenantId","documentVersionId","locale","fallbackLocale");--> statement-breakpoint
+CREATE INDEX "doc_index_entry_idx_link" ON "docman_document_index_entries" USING btree ("tenantId","linkId");--> statement-breakpoint
+CREATE INDEX "doc_index_entry_idx_page_version" ON "docman_document_index_entries" USING btree ("tenantId","pageVersionId");--> statement-breakpoint
+CREATE INDEX "doc_index_entry_idx_section" ON "docman_document_index_entries" USING btree ("tenantId","sectionId");

package/drizzle-out/docman/0004_known_summary.sql

@@ -0,0 +1,9 @@
+ALTER TABLE "docman_document_index_entries" ADD COLUMN "summaryText" text;
+--> statement-breakpoint
+ALTER TABLE "docman_document_index_entries" ADD COLUMN "sourceCharCount" integer DEFAULT 0 NOT NULL;
+--> statement-breakpoint
+ALTER TABLE "docman_document_index_entries" ADD COLUMN "sourceWordCount" integer DEFAULT 0 NOT NULL;
+--> statement-breakpoint
+ALTER TABLE "docman_document_index_entries" ADD COLUMN "summaryCharCount" integer DEFAULT 0 NOT NULL;
+--> statement-breakpoint
+ALTER TABLE "docman_document_index_entries" ADD COLUMN "summaryWordCount" integer DEFAULT 0 NOT NULL;

package/drizzle-out/docman/0005_vector_signal.sql

@@ -0,0 +1,9 @@
+ALTER TABLE "docman_document_index_entries" ADD COLUMN "embeddingProvider" text;
+--> statement-breakpoint
+ALTER TABLE "docman_document_index_entries" ADD COLUMN "embeddingModel" text;
+--> statement-breakpoint
+ALTER TABLE "docman_document_index_entries" ADD COLUMN "embeddingHash" text;
+--> statement-breakpoint
+ALTER TABLE "docman_document_index_entries" ADD COLUMN "embeddingDimensions" integer;
+--> statement-breakpoint
+ALTER TABLE "docman_document_index_entries" ADD COLUMN "embeddingVector" text;

package/drizzle-out/docman/0006_document_version_current_invariant.sql

@@ -0,0 +1,15 @@
+-- Step 8 of docman set-current-version slice (consensus topic
+-- aops-cli-doc-set-current-version-sugar-2026-05-18).
+--
+-- Enforces "at most one isCurrent=true row per (tenantId, documentId)" at the
+-- database level. The new docman.document-version.set-current service op
+-- already maintains this invariant inside its transaction, but a partial
+-- unique index makes the invariant robust against future migrations, manual
+-- SQL, or concurrent writers that might bypass the service path.
+--
+-- PostgreSQL supports partial unique indexes natively. SQLite supports the
+-- same syntax, so the drizzle SQLite mirror can carry the same index.
+
+CREATE UNIQUE INDEX IF NOT EXISTS "document_version_unique_current"
+  ON "docman_document_versions" ("tenantId", "documentId")
+  WHERE "isCurrent" = true;

package/drizzle-out/docman/meta/_journal.json

@@ -0,0 +1,55 @@
+{
+  "version": "7",
+  "dialect": "postgresql",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "7",
+      "when": 1772831979646,
+      "tag": "0000_curvy_valeria_richards",
+      "breakpoints": true
+    },
+    {
+      "idx": 1,
+      "version": "7",
+      "when": 1772833453900,
+      "tag": "0001_massive_risque",
+      "breakpoints": true
+    },
+    {
+      "idx": 2,
+      "version": "7",
+      "when": 1773831701245,
+      "tag": "0002_simple_logan",
+      "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "7",
+      "when": 1773837600000,
+      "tag": "0003_quick_index",
+      "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "7",
+      "when": 1773839700000,
+      "tag": "0004_known_summary",
+      "breakpoints": true
+    },
+    {
+      "idx": 5,
+      "version": "7",
+      "when": 1773842400000,
+      "tag": "0005_vector_signal",
+      "breakpoints": true
+    },
+    {
+      "idx": 6,
+      "version": "7",
+      "when": 1779113693327,
+      "tag": "0006_document_version_current_invariant",
+      "breakpoints": true
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@aopslab/domain-pg-bootstrap-docman",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "description": "Owned PostgreSQL bootstrap/migration runner for Docman standalone/runtime flows.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "drizzle-out",
+    "!**/*.tsbuildinfo",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "pg": "8.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "25.3.0",
+    "@types/pg": "8.20.0",
+    "typescript": "5.9.3"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eeemzs/docman.git",
+    "directory": "docman-pg-bootstrap"
+  },
+  "scripts": {
+    "build": "node ./scripts/sync-migrations.mjs && tsc -b tsconfig.lib.json",
+    "typecheck": "tsc -p tsconfig.lib.json --noEmit"
+  }
+}