@aopslab/domain-cli-docman 0.1.4

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@aopslab/domain-cli-docman",
+  "version": "0.1.4",
+  "private": false,
+  "type": "module",
+  "description": "Docman CLI (canonical invoke + generated sugar + optional hooks).",
+  "bin": {
+    "docman": "dist/main.js",
+    "docman-cli": "dist/main.js"
+  },
+  "files": [
+    "dist",
+    "resources",
+    "src",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "@aopslab/xf-core": "0.1.69",
+    "@aopslab/xf-db-drizzle": "0.1.81",
+    "dotenv": "^17.3.1",
+    "@aopslab/domain-pg-bootstrap-docman": "0.1.0",
+    "@aopslab/domain-runtime-config-docman": "0.1.0",
+    "@aopslab/domain-host-plugin-docman": "0.1.4",
+    "@aopslab/domain-ops-docman": "0.1.4",
+    "@aopslab/domain-tooling-docman": "0.1.4"
+  },
+  "main": "dist/main.js",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eeemzs/docman.git",
+    "directory": "docman-cli"
+  },
+  "scripts": {
+    "prebuild": "pnpm -C .. --filter @aopslab/domain-runtime-config-docman run build && pnpm -C .. --filter @aopslab/domain-pg-bootstrap-docman run build",
+    "pretypecheck": "pnpm -C .. --filter @aopslab/domain-runtime-config-docman run build && pnpm -C .. --filter @aopslab/domain-pg-bootstrap-docman run build",
+    "build": "tsc -p tsconfig.app.json",
+    "postbuild": "pnpm run manifest:emit",
+    "build:all": "pnpm run build",
+    "start:node": "node dist/main.js",
+    "start:tsx": "tsx src/main.ts",
+    "typecheck": "tsc -p tsconfig.app.json --noEmit",
+    "manifest:print": "tsx scripts/manifest-cli.ts print",
+    "manifest:emit": "tsx scripts/manifest-cli.ts emit --out-dir dist/manifests",
+    "manifest:check": "tsx scripts/manifest-cli.ts check --out-dir dist/manifests"
+  }
+}

package/resources/sqlite-bootstrap.sql

@@ -0,0 +1,361 @@
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE IF NOT EXISTS "docman_document_groups" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "scopeId" TEXT NOT NULL,
+  "groupUid" TEXT NOT NULL,
+  "parentGroupId" TEXT,
+  "parentGroupUid" TEXT,
+  "title" TEXT NOT NULL,
+  "description" TEXT,
+  "meta" TEXT,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "document_group_uid_unique" ON "docman_document_groups" ("tenantId", "scopeId", "groupUid");
+CREATE INDEX IF NOT EXISTS "document_group_idx_tenant" ON "docman_document_groups" ("tenantId");
+CREATE INDEX IF NOT EXISTS "document_group_idx_scope" ON "docman_document_groups" ("tenantId", "scopeId");
+CREATE INDEX IF NOT EXISTS "document_group_idx_parent" ON "docman_document_groups" ("tenantId", "parentGroupId");
+
+CREATE TABLE IF NOT EXISTS "docman_documents" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "scopeId" TEXT NOT NULL,
+  "documentUid" TEXT NOT NULL,
+  "groupId" TEXT,
+  "groupUid" TEXT,
+  "slug" TEXT,
+  "title" TEXT NOT NULL,
+  "titleMl" TEXT,
+  "summary" TEXT,
+  "summaryMl" TEXT,
+  "description" TEXT,
+  "descriptionMl" TEXT,
+  "status" TEXT NOT NULL,
+  "visibility" TEXT NOT NULL,
+  "tags" TEXT,
+  "pageSize" TEXT,
+  "meta" TEXT,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "document_uid_unique" ON "docman_documents" ("tenantId", "scopeId", "documentUid");
+CREATE INDEX IF NOT EXISTS "document_idx_tenant" ON "docman_documents" ("tenantId");
+CREATE INDEX IF NOT EXISTS "document_idx_scope" ON "docman_documents" ("tenantId", "scopeId");
+CREATE INDEX IF NOT EXISTS "document_idx_status" ON "docman_documents" ("tenantId", "status");
+CREATE INDEX IF NOT EXISTS "document_idx_scope_slug" ON "docman_documents" ("tenantId", "scopeId", "slug");
+CREATE INDEX IF NOT EXISTS "document_idx_scope_group_id" ON "docman_documents" ("tenantId", "scopeId", "groupId");
+CREATE INDEX IF NOT EXISTS "document_idx_scope_group_uid" ON "docman_documents" ("tenantId", "scopeId", "groupUid");
+
+CREATE TABLE IF NOT EXISTS "docman_document_versions" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "documentId" TEXT NOT NULL,
+  "version" INTEGER NOT NULL,
+  "label" TEXT,
+  "status" TEXT NOT NULL,
+  "title" TEXT,
+  "summary" TEXT,
+  "releaseNotes" TEXT,
+  "releaseNotesMl" TEXT,
+  "isCurrent" INTEGER NOT NULL DEFAULT 0,
+  "basedOnVersionId" TEXT,
+  "publishedAt" INTEGER,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "document_version_unique" ON "docman_document_versions" ("tenantId", "documentId", "version");
+CREATE INDEX IF NOT EXISTS "document_version_idx_doc" ON "docman_document_versions" ("tenantId", "documentId");
+CREATE INDEX IF NOT EXISTS "document_version_idx_status" ON "docman_document_versions" ("tenantId", "status");
+CREATE INDEX IF NOT EXISTS "document_version_idx_current" ON "docman_document_versions" ("tenantId", "documentId", "isCurrent");
+
+CREATE TABLE IF NOT EXISTS "docman_sections" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "scopeId" TEXT NOT NULL,
+  "sectionUid" TEXT NOT NULL,
+  "title" TEXT NOT NULL,
+  "titleMl" TEXT,
+  "kind" TEXT,
+  "slug" TEXT,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "section_uid_unique" ON "docman_sections" ("tenantId", "scopeId", "sectionUid");
+CREATE INDEX IF NOT EXISTS "section_idx_tenant" ON "docman_sections" ("tenantId");
+CREATE INDEX IF NOT EXISTS "section_idx_scope" ON "docman_sections" ("tenantId", "scopeId");
+
+CREATE TABLE IF NOT EXISTS "docman_pages" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "scopeId" TEXT NOT NULL,
+  "pageUid" TEXT NOT NULL,
+  "title" TEXT NOT NULL,
+  "titleMl" TEXT,
+  "kind" TEXT,
+  "meta" TEXT,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "page_uid_unique" ON "docman_pages" ("tenantId", "scopeId", "pageUid");
+CREATE INDEX IF NOT EXISTS "page_idx_tenant" ON "docman_pages" ("tenantId");
+CREATE INDEX IF NOT EXISTS "page_idx_scope" ON "docman_pages" ("tenantId", "scopeId");
+
+CREATE TABLE IF NOT EXISTS "docman_page_versions" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "pageId" TEXT NOT NULL,
+  "version" INTEGER NOT NULL,
+  "title" TEXT,
+  "format" TEXT NOT NULL,
+  "content" TEXT,
+  "contentMl" TEXT,
+  "contentData" TEXT,
+  "directives" TEXT,
+  "status" TEXT NOT NULL,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "page_version_unique" ON "docman_page_versions" ("tenantId", "pageId", "version");
+CREATE INDEX IF NOT EXISTS "page_version_idx_page" ON "docman_page_versions" ("tenantId", "pageId");
+CREATE INDEX IF NOT EXISTS "page_version_idx_status" ON "docman_page_versions" ("tenantId", "status");
+
+CREATE TABLE IF NOT EXISTS "docman_document_section_links" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "documentVersionId" TEXT NOT NULL,
+  "kind" TEXT NOT NULL,
+  "sectionId" TEXT,
+  "pageVersionId" TEXT,
+  "parentLinkId" TEXT,
+  "position" INTEGER NOT NULL,
+  "depth" INTEGER,
+  "titleOverride" TEXT,
+  "titleVisible" INTEGER NOT NULL DEFAULT 1,
+  "numbering" TEXT,
+  "pageBreakBefore" INTEGER NOT NULL DEFAULT 0,
+  "pageBreakAfter" INTEGER NOT NULL DEFAULT 0,
+  "directives" TEXT,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "doc_section_pos_unique" ON "docman_document_section_links" ("tenantId", "documentVersionId", "parentLinkId", "position");
+CREATE INDEX IF NOT EXISTS "doc_section_idx_doc_version" ON "docman_document_section_links" ("tenantId", "documentVersionId");
+CREATE INDEX IF NOT EXISTS "doc_section_idx_section" ON "docman_document_section_links" ("tenantId", "sectionId");
+CREATE INDEX IF NOT EXISTS "doc_section_idx_page_version" ON "docman_document_section_links" ("tenantId", "pageVersionId");
+CREATE INDEX IF NOT EXISTS "doc_section_idx_parent" ON "docman_document_section_links" ("tenantId", "parentLinkId");
+
+CREATE TABLE IF NOT EXISTS "docman_section_page_links" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "sectionId" TEXT NOT NULL,
+  "pageVersionId" TEXT NOT NULL,
+  "position" INTEGER NOT NULL,
+  "numbering" TEXT,
+  "titleOverride" TEXT,
+  "titleVisible" INTEGER NOT NULL DEFAULT 1,
+  "pageBreakBefore" INTEGER NOT NULL DEFAULT 0,
+  "pageBreakAfter" INTEGER NOT NULL DEFAULT 0,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "section_page_pos_unique" ON "docman_section_page_links" ("tenantId", "sectionId", "position");
+CREATE INDEX IF NOT EXISTS "section_page_idx_section" ON "docman_section_page_links" ("tenantId", "sectionId");
+CREATE INDEX IF NOT EXISTS "section_page_idx_page_version" ON "docman_section_page_links" ("tenantId", "pageVersionId");
+
+CREATE TABLE IF NOT EXISTS "docman_snippets" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "scopeId" TEXT NOT NULL,
+  "snippetUid" TEXT NOT NULL,
+  "title" TEXT,
+  "language" TEXT NOT NULL,
+  "code" TEXT NOT NULL,
+  "description" TEXT,
+  "meta" TEXT,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "snippet_uid_unique" ON "docman_snippets" ("tenantId", "scopeId", "snippetUid");
+CREATE INDEX IF NOT EXISTS "snippet_idx_tenant" ON "docman_snippets" ("tenantId");
+CREATE INDEX IF NOT EXISTS "snippet_idx_scope" ON "docman_snippets" ("tenantId", "scopeId");
+CREATE INDEX IF NOT EXISTS "snippet_idx_scope_language" ON "docman_snippets" ("tenantId", "scopeId", "language");
+
+CREATE TABLE IF NOT EXISTS "docman_page_snippet_links" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "pageVersionId" TEXT NOT NULL,
+  "snippetId" TEXT NOT NULL,
+  "position" INTEGER NOT NULL,
+  "caption" TEXT,
+  "showLineNumbers" INTEGER,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "page_snippet_pos_unique" ON "docman_page_snippet_links" ("tenantId", "pageVersionId", "position");
+CREATE INDEX IF NOT EXISTS "page_snippet_idx_page_version" ON "docman_page_snippet_links" ("tenantId", "pageVersionId");
+CREATE INDEX IF NOT EXISTS "page_snippet_idx_snippet" ON "docman_page_snippet_links" ("tenantId", "snippetId");
+
+CREATE TABLE IF NOT EXISTS "docman_assets" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "scopeId" TEXT NOT NULL,
+  "assetUid" TEXT NOT NULL,
+  "kind" TEXT NOT NULL,
+  "title" TEXT,
+  "slug" TEXT,
+  "altText" TEXT,
+  "currentVersionId" TEXT,
+  "meta" TEXT,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "asset_uid_unique" ON "docman_assets" ("tenantId", "scopeId", "assetUid");
+CREATE INDEX IF NOT EXISTS "asset_idx_tenant" ON "docman_assets" ("tenantId");
+CREATE INDEX IF NOT EXISTS "asset_idx_scope" ON "docman_assets" ("tenantId", "scopeId");
+CREATE INDEX IF NOT EXISTS "asset_idx_scope_kind" ON "docman_assets" ("tenantId", "scopeId", "kind");
+CREATE INDEX IF NOT EXISTS "asset_idx_scope_current_version" ON "docman_assets" ("tenantId", "scopeId", "currentVersionId");
+
+CREATE TABLE IF NOT EXISTS "docman_asset_versions" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "assetId" TEXT 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" TEXT,
+  "meta" TEXT,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "asset_version_unique" ON "docman_asset_versions" ("tenantId", "assetId", "version");
+CREATE INDEX IF NOT EXISTS "asset_version_idx_asset" ON "docman_asset_versions" ("tenantId", "assetId");
+CREATE INDEX IF NOT EXISTS "asset_version_idx_status" ON "docman_asset_versions" ("tenantId", "status");
+CREATE INDEX IF NOT EXISTS "asset_version_idx_hash" ON "docman_asset_versions" ("tenantId", "contentHash");
+
+CREATE TABLE IF NOT EXISTS "docman_document_index_entries" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "documentVersionId" TEXT NOT NULL,
+  "documentId" TEXT NOT NULL,
+  "locale" TEXT NOT NULL DEFAULT '',
+  "fallbackLocale" TEXT NOT NULL DEFAULT '',
+  "itemKind" TEXT NOT NULL,
+  "sortOrder" INTEGER NOT NULL,
+  "buildFingerprint" TEXT NOT NULL,
+  "linkId" TEXT,
+  "parentLinkId" TEXT,
+  "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" INTEGER NOT NULL DEFAULT 1,
+  "pageBreakBefore" INTEGER NOT NULL DEFAULT 0,
+  "pageBreakAfter" INTEGER NOT NULL DEFAULT 0,
+  "sectionId" TEXT,
+  "sectionUid" TEXT,
+  "sectionSlug" TEXT,
+  "pageId" TEXT,
+  "pageUid" TEXT,
+  "pageVersionId" TEXT,
+  "format" TEXT,
+  "pageNumberStart" INTEGER,
+  "pageNumberEnd" INTEGER,
+  "bodyText" TEXT,
+  "summaryText" TEXT,
+  "sourceCharCount" INTEGER NOT NULL DEFAULT 0,
+  "sourceWordCount" INTEGER NOT NULL DEFAULT 0,
+  "summaryCharCount" INTEGER NOT NULL DEFAULT 0,
+  "summaryWordCount" INTEGER NOT NULL DEFAULT 0,
+  "embeddingProvider" TEXT,
+  "embeddingModel" TEXT,
+  "embeddingHash" TEXT,
+  "embeddingDimensions" INTEGER,
+  "embeddingVector" TEXT,
+  "searchText" TEXT NOT NULL,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "doc_index_entry_sort_unique" ON "docman_document_index_entries" ("tenantId", "documentVersionId", "locale", "fallbackLocale", "sortOrder");
+CREATE UNIQUE INDEX IF NOT EXISTS "doc_index_entry_anchor_unique" ON "docman_document_index_entries" ("tenantId", "documentVersionId", "locale", "fallbackLocale", "anchor");
+CREATE INDEX IF NOT EXISTS "doc_index_entry_idx_doc_version" ON "docman_document_index_entries" ("tenantId", "documentVersionId", "locale", "fallbackLocale");
+CREATE INDEX IF NOT EXISTS "doc_index_entry_idx_link" ON "docman_document_index_entries" ("tenantId", "linkId");
+CREATE INDEX IF NOT EXISTS "doc_index_entry_idx_page_version" ON "docman_document_index_entries" ("tenantId", "pageVersionId");
+CREATE INDEX IF NOT EXISTS "doc_index_entry_idx_section" ON "docman_document_index_entries" ("tenantId", "sectionId");
+
+CREATE TABLE IF NOT EXISTS "docman_embeds" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "scopeId" TEXT NOT NULL,
+  "embedUid" TEXT NOT NULL,
+  "type" TEXT NOT NULL,
+  "title" TEXT,
+  "content" TEXT,
+  "url" TEXT,
+  "path" TEXT,
+  "mime" TEXT,
+  "meta" TEXT,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "embed_uid_unique" ON "docman_embeds" ("tenantId", "scopeId", "embedUid");
+CREATE INDEX IF NOT EXISTS "embed_idx_tenant" ON "docman_embeds" ("tenantId");
+CREATE INDEX IF NOT EXISTS "embed_idx_scope" ON "docman_embeds" ("tenantId", "scopeId");
+CREATE INDEX IF NOT EXISTS "embed_idx_scope_type" ON "docman_embeds" ("tenantId", "scopeId", "type");
+
+CREATE TABLE IF NOT EXISTS "docman_page_embed_links" (
+  "id" TEXT PRIMARY KEY NOT NULL,
+  "tenantId" TEXT NOT NULL,
+  "pageVersionId" TEXT NOT NULL,
+  "embedId" TEXT NOT NULL,
+  "position" INTEGER NOT NULL,
+  "caption" TEXT,
+  "createdBy" TEXT,
+  "updatedBy" TEXT,
+  "createdAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER)),
+  "updatedAt" INTEGER NOT NULL DEFAULT (CAST((julianday('now') - 2440587.5) * 86400000 AS INTEGER))
+);
+CREATE UNIQUE INDEX IF NOT EXISTS "page_embed_pos_unique" ON "docman_page_embed_links" ("tenantId", "pageVersionId", "position");
+CREATE INDEX IF NOT EXISTS "page_embed_idx_page_version" ON "docman_page_embed_links" ("tenantId", "pageVersionId");
+CREATE INDEX IF NOT EXISTS "page_embed_idx_embed" ON "docman_page_embed_links" ("tenantId", "embedId");

package/src/cli-types.ts

@@ -0,0 +1,33 @@
+export type OptionValue = boolean | string | string[]
+
+export type ParsedArgv = {
+  positionals: string[]
+  options: Record<string, OptionValue>
+}
+
+export type RuntimeContext = {
+  scopeId: string
+  workspaceId: string
+  tenantId: string
+}
+
+export type DocmanExecutionMode = 'host' | 'tooling'
+
+export type DocmanOperationSpec = {
+  operationId: string
+  toolId?: string
+  summary?: string
+  sideEffect?: 'none' | 'db' | 'mixed'
+  tags?: string[]
+  examples?: string[]
+  docs?: {
+    notes?: string[]
+    antiPatterns?: string[]
+    preconditions?: string[]
+    postconditions?: string[]
+  }
+  args: Array<{
+    name: string
+    optional?: boolean
+  }>
+}

package/src/command-surface.ts

@@ -0,0 +1,87 @@
+import type { DocmanCliStoredConfigPatch, LoadedDocmanCliStoredConfig } from './config-host.js'
+import type { ParsedArgv } from './cli-types.js'
+
+type DocmanCliCommandSurfaceDeps = {
+  buildConfigSetOutput: (stored: LoadedDocmanCliStoredConfig) => Record<string, unknown>
+  buildConfigShowOutput: (processEnv: NodeJS.ProcessEnv) => Record<string, unknown>
+  getStringOption: (parsed: ParsedArgv, key: string) => string | undefined
+  parseJsonInput: (raw: unknown, label: string) => unknown
+  printJson: (value: unknown) => void
+  runOperationById: (operationId: string, input?: unknown) => Promise<unknown>
+  writeStoredConfig: (
+    patch: DocmanCliStoredConfigPatch,
+    processEnv?: NodeJS.ProcessEnv,
+  ) => LoadedDocmanCliStoredConfig
+}
+
+export function createDocmanCliCommandSurface(deps: DocmanCliCommandSurfaceDeps) {
+  async function handleConfig(subcommand: string | undefined, parsed: ParsedArgv): Promise<void> {
+    if (subcommand === 'show') {
+      deps.printJson(deps.buildConfigShowOutput(process.env))
+      return
+    }
+
+    if (subcommand === 'set') {
+      const patch: DocmanCliStoredConfigPatch = {}
+      const repoUrl = deps.getStringOption(parsed, 'repo-url')
+      const scopeId = deps.getStringOption(parsed, 'scope-id') ?? deps.getStringOption(parsed, 'workspace-id')
+      const runtimeModeRaw = deps.getStringOption(parsed, 'runtime-mode')
+      const tenantId = deps.getStringOption(parsed, 'tenant-id')
+      const logLevel = deps.getStringOption(parsed, 'log-level')
+      const hostConfigPath = deps.getStringOption(parsed, 'host-config')
+      const executionModeRaw = deps.getStringOption(parsed, 'execution-mode')
+
+      if (repoUrl) patch.repoUrl = repoUrl
+      if (scopeId) patch.scopeId = scopeId
+      if (runtimeModeRaw) {
+        const runtimeMode = runtimeModeRaw.trim().toLowerCase()
+        if (runtimeMode !== 'single-user' && runtimeMode !== 'multi-user') {
+          throw new Error(`invalid_runtime_mode:${runtimeModeRaw}`)
+        }
+        patch.runtimeMode = runtimeMode
+      }
+      if (tenantId) patch.tenantId = tenantId
+      if (logLevel) patch.logLevel = logLevel
+      if (hostConfigPath) patch.hostConfigPath = hostConfigPath
+      if (executionModeRaw) {
+        const executionMode = executionModeRaw.trim().toLowerCase()
+        if (executionMode !== 'host' && executionMode !== 'tooling') {
+          throw new Error(`invalid_execution_mode:${executionModeRaw}`)
+        }
+        patch.executionMode = executionMode
+      }
+
+      if (Object.keys(patch).length === 0) {
+        throw new Error('missing_config_patch:provide_at_least_one_option')
+      }
+
+      const stored = deps.writeStoredConfig(patch, process.env)
+      deps.printJson(deps.buildConfigSetOutput(stored))
+      return
+    }
+
+    throw new Error(`unknown_config_subcommand:${subcommand ?? '<missing>'}`)
+  }
+
+  async function tryExecuteOperationViaHook(operationId: string, parsed: ParsedArgv): Promise<boolean> {
+    if (operationId === 'docman.document.get') {
+      const id = deps.getStringOption(parsed, 'id')
+      const documentId = deps.getStringOption(parsed, 'document-id')
+      if (id || !documentId) return false
+
+      const input: Record<string, unknown> = { id: documentId }
+      const options = deps.parseJsonInput(deps.getStringOption(parsed, 'options'), 'options')
+      if (options !== undefined) input.options = options
+      const output = await deps.runOperationById(operationId, input)
+      deps.printJson(output)
+      return true
+    }
+
+    return false
+  }
+
+  return {
+    handleConfig,
+    tryExecuteOperationViaHook,
+  }
+}

package/src/config-host.ts

@@ -0,0 +1,24 @@
+export {
+  DEFAULT_DOCMAN_SCOPE_ID,
+  applyDocmanRuntimeEnv,
+  getDefaultDocmanSqlitePath,
+  getDefaultDocmanSqliteRepoUrl,
+  getDocmanConfigDir as getDocmanCliConfigDir,
+  getDocmanConfigPath as getDocmanCliConfigPath,
+  inferDocmanRepoDialect,
+  isDocmanSqliteRepoUrl,
+  readDocmanStoredConfig as readDocmanCliStoredConfig,
+  resolveDocmanRuntimeConfig,
+  writeDocmanStoredConfig as writeDocmanCliStoredConfig,
+} from '@aopslab/domain-runtime-config-docman'
+
+export type {
+  DocmanCliExecutionMode,
+  DocmanConfigSource,
+  DocmanRepoDialect,
+  DocmanRuntimeMode,
+  DocmanStoredConfig as DocmanCliStoredConfig,
+  DocmanStoredConfigPatch as DocmanCliStoredConfigPatch,
+  LoadedDocmanStoredConfig as LoadedDocmanCliStoredConfig,
+  ResolvedDocmanRuntimeConfig,
+} from '@aopslab/domain-runtime-config-docman'

package/src/env-bootstrap.ts

@@ -0,0 +1,111 @@
+import { config as dotenvConfig } from 'dotenv'
+import { existsSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { readDocmanCliStoredConfig } from './config-host.js'
+
+const cliRoot = fileURLToPath(new URL('../', import.meta.url))
+const envPaths = [
+  resolve(cliRoot, '..', '.env'),
+  resolve(cliRoot, '..', '..', '..', 'apps', 'aops', '.env'),
+]
+
+type ParsedBootstrapArgv = {
+  positionals: string[]
+  options: Record<string, string | boolean>
+}
+
+function normalizeNonEmptyString(value: unknown): string | undefined {
+  if (typeof value !== 'string') return undefined
+  const normalized = value.trim()
+  return normalized.length > 0 ? normalized : undefined
+}
+
+function normalizeRepoUrlValue(value: unknown): string | undefined {
+  const normalized = normalizeNonEmptyString(value)
+  if (!normalized) return undefined
+  return normalized.replace(/(?:\\r|\r)+$/g, '')
+}
+
+function inferRepoDialectFromUrl(repoUrl: string): 'pg' | 'sqlite' {
+  const normalized = repoUrl.trim().toLowerCase()
+  if (!normalized) return 'pg'
+  if (normalized === ':memory:') return 'sqlite'
+  if (normalized.startsWith('sqlite:') || normalized.startsWith('file:')) return 'sqlite'
+  if (normalized.endsWith('.db') || normalized.endsWith('.sqlite') || normalized.endsWith('.sqlite3')) return 'sqlite'
+  return 'pg'
+}
+
+function normalizeOptionKey(raw: string): string {
+  return raw.trim().replace(/^--+/, '').toLowerCase()
+}
+
+function parseBootstrapArgv(argv: string[]): ParsedBootstrapArgv {
+  const positionals: string[] = []
+  const options: Record<string, string | boolean> = {}
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index]
+    if (token === '--') continue
+
+    if (!token.startsWith('--')) {
+      positionals.push(token)
+      continue
+    }
+
+    const eqAt = token.indexOf('=')
+    if (eqAt > -1) {
+      options[normalizeOptionKey(token.slice(0, eqAt))] = token.slice(eqAt + 1)
+      continue
+    }
+
+    const key = normalizeOptionKey(token)
+    const next = argv[index + 1]
+    if (!next || next.startsWith('--')) {
+      options[key] = true
+      continue
+    }
+
+    options[key] = next
+    index += 1
+  }
+
+  return { positionals, options }
+}
+
+function getStringOption(parsed: ParsedBootstrapArgv, key: string): string | undefined {
+  const value = parsed.options[key]
+  return normalizeNonEmptyString(value)
+}
+
+for (const envPath of envPaths) {
+  if (existsSync(envPath)) {
+    dotenvConfig({ path: envPath, override: false, quiet: true })
+  }
+}
+
+const parsed = parseBootstrapArgv(process.argv.slice(2))
+const command = parsed.positionals[0]?.toLowerCase()
+const isConfigCommand = command === 'config'
+const storedConfig = readDocmanCliStoredConfig(process.env).config
+
+if (
+  !isConfigCommand &&
+  !normalizeRepoUrlValue(process.env.DOCMAN_REPO_URL) &&
+  !normalizeRepoUrlValue(process.env.DOCMAN_SQLITE_URL) &&
+  !normalizeRepoUrlValue(process.env.DOCMAN_PG_URL) &&
+  !getStringOption(parsed, 'repo-url')
+) {
+  const storedRepoUrl = normalizeRepoUrlValue(storedConfig.repoUrl)
+  if (storedRepoUrl) {
+    process.env.DOCMAN_REPO_URL = storedRepoUrl
+    if (inferRepoDialectFromUrl(storedRepoUrl) === 'sqlite') {
+      process.env.DOCMAN_SQLITE_URL = storedRepoUrl
+      delete process.env.DOCMAN_PG_URL
+    } else {
+      process.env.DOCMAN_PG_URL = storedRepoUrl
+      delete process.env.DOCMAN_SQLITE_URL
+    }
+    process.env.DOCMAN_CLI_BOOTSTRAPPED_REPO_URL_SOURCE = 'stored-config'
+  }
+}