@aopslab/domain-cli-docman 0.1.4

package/src/host-registration.ts

@@ -0,0 +1,155 @@
+import { readFileSync } from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { createRequire } from 'node:module'
+import { DEFAULT_DOCMAN_SCOPE_ID } from '@aopslab/domain-runtime-config-docman'
+
+export type DocmanHostRegistrationPathMode = 'portable' | 'installed' | 'package'
+
+export type DocmanHostRegistrationManifest = {
+  kind: 'aops-host-registration'
+  registrationVersion: '1'
+  domain: 'docman'
+  displayName: 'Docman'
+  packageName: string
+  description: string
+  baseDir?: string
+  notes?: string[]
+  pluginLoader: {
+    allowlist: string[]
+    strictAllowlist: false
+    tolerantBootstrap: false
+  }
+  manifestProviders: Array<{
+    id: 'docman-dcm'
+    domain: 'docman'
+    enabled: true
+    module: string
+    exportName: 'buildDocmanDomainCapabilityManifest'
+    options: {
+      includeDocs: true
+    }
+  }>
+  plugins: Array<{
+    domain: 'docman'
+    enabled: true
+    module: string
+    factory: 'createDocmanPlugin'
+    options: {
+      defaultScopeId: typeof DEFAULT_DOCMAN_SCOPE_ID
+    }
+  }>
+}
+
+type PackageDescriptor = {
+  packageName: string
+  packageRoot: string
+  mainEntry: string
+  version: string
+}
+
+const requireFromHere = createRequire(import.meta.url)
+
+function readJsonFile<T>(filePath: string): T {
+  return JSON.parse(readFileSync(filePath, 'utf8')) as T
+}
+
+function getCliPackageDescriptor(): PackageDescriptor {
+  const packageJsonPath = fileURLToPath(new URL('../package.json', import.meta.url))
+  const packageRoot = path.dirname(packageJsonPath)
+  const packageJson = readJsonFile<{ name?: string; main?: string; version?: string }>(packageJsonPath)
+  return {
+    packageName: packageJson.name?.trim() || '@aopslab/domain-cli-docman',
+    packageRoot,
+    mainEntry: path.resolve(packageRoot, packageJson.main?.trim() || 'dist/main.js'),
+    version: packageJson.version?.trim() || '0.0.0',
+  }
+}
+
+function resolvePackageDescriptor(packageName: string): PackageDescriptor {
+  const packageJsonPath = requireFromHere.resolve(`${packageName}/package.json`)
+  const packageRoot = path.dirname(packageJsonPath)
+  const packageJson = readJsonFile<{ main?: string; version?: string }>(packageJsonPath)
+  return {
+    packageName,
+    packageRoot,
+    mainEntry: path.resolve(packageRoot, packageJson.main?.trim() || 'dist/index.js'),
+    version: packageJson.version?.trim() || '0.0.0',
+  }
+}
+
+function toPortablePath(fromDir: string, targetPath: string): string {
+  const relative = path.relative(fromDir, targetPath).split(path.sep).join('/')
+  if (relative.startsWith('.')) return relative
+  return `./${relative}`
+}
+
+export function buildDocmanHostRegistrationManifest(
+  options: {
+    mode?: DocmanHostRegistrationPathMode
+  } = {},
+): DocmanHostRegistrationManifest {
+  const mode = options.mode ?? 'installed'
+  const cli = getCliPackageDescriptor()
+  const toolingPackage = mode === 'package' ? '@aopslab/domain-kit-docman/operations' : '@aopslab/domain-tooling-docman'
+  const hostPluginPackage = '@aopslab/domain-host-plugin-docman'
+  const tooling = mode === 'package' ? null : resolvePackageDescriptor(toolingPackage)
+  const hostPlugin = mode === 'package' ? null : resolvePackageDescriptor(hostPluginPackage)
+  const portable = mode === 'portable'
+  const packageMode = mode === 'package'
+  const baseDir = portable ? '../..' : packageMode ? undefined : cli.packageRoot
+  const specifierBaseDir = portable ? cli.packageRoot : ''
+  const toolingModule = packageMode
+    ? toolingPackage
+    : portable
+      ? toPortablePath(specifierBaseDir, tooling!.mainEntry)
+      : tooling!.mainEntry
+  const pluginModule = packageMode
+    ? hostPluginPackage
+    : portable
+      ? toPortablePath(specifierBaseDir, hostPlugin!.mainEntry)
+      : hostPlugin!.mainEntry
+
+  return {
+    kind: 'aops-host-registration',
+    registrationVersion: '1',
+    domain: 'docman',
+    displayName: 'Docman',
+    packageName: cli.packageName,
+    description: 'Document graph and content-structure tooling for documents, sections, pages, snippets, embeds, rendering, and version workflows.',
+    ...(baseDir ? { baseDir } : {}),
+    notes: [
+      'Prefer registering from `docman manifest host-registration` when docman is installed outside the AOPS workspace.',
+      'Provide `DOCMAN_REPO_URL`, `DOCMAN_SQLITE_URL`, or `DOCMAN_PG_URL` for explicit host runtime binding; standalone docman without a Docman-specific repo source falls back to `~/.aops/docman.aops.sqlite`.',
+      'HRM is runtime registration metadata only. Capability/discovery truth still comes from DCM.',
+    ],
+    pluginLoader: {
+      allowlist: [pluginModule],
+      strictAllowlist: false,
+      tolerantBootstrap: false,
+    },
+    manifestProviders: [
+      {
+        id: 'docman-dcm',
+        domain: 'docman',
+        enabled: true,
+        module: toolingModule,
+        exportName: 'buildDocmanDomainCapabilityManifest',
+        options: {
+          includeDocs: true,
+        },
+      },
+    ],
+    plugins: [
+      {
+        domain: 'docman',
+        enabled: true,
+        module: pluginModule,
+        factory: 'createDocmanPlugin',
+        options: {
+          defaultScopeId: DEFAULT_DOCMAN_SCOPE_ID,
+        },
+      },
+    ],
+  }
+}