@dotdrelle/wiki-manager 0.6.17

package/agents.docker-compose.yml

@@ -0,0 +1,96 @@
+# agents.docker-compose.yml — external agent stack
+#
+# Starts cme, documents, and mailer as workspace-agnostic global services.
+# All workspace paths are resolved at tool-call time via the `workspace` param.
+#
+# Required:
+#   WORKSPACES_ROOT   — path to the directory containing all workspace folders
+#
+# Optional (defaults shown):
+#   AGENTS_DATA_DIR        — persistent state for stateful agents (default: ./.agents-data)
+#   CME_MCP_PORT           — 3336
+#   DOCUMENTS_MCP_PORT     — 3337
+#   MAILER_MCP_PORT        — 3335
+#   CME_MCP_AUTH_TOKEN     — bearer token for cme agent (empty = no auth)
+#   DOCUMENTS_MCP_AUTH_TOKEN — bearer token for documents agent (empty = no auth)
+#   DOCUMENT_LLM_BASE_URL  — https://api.openai.com/v1
+#   DOCUMENT_LLM_MODEL     — gpt-5.4-mini
+#   DOCUMENT_LLM_API_KEY   — OpenAI/OpenAI-compatible API key for document OCR
+#   DOCUMENT_LLM_TIMEOUT_SECONDS — 120
+#   MAILER_MCP_AUTH_TOKEN  — bearer token for mailer agent (empty = no auth)
+#   MAILERSEND_API_KEY
+#   MAILERSEND_FROM_EMAIL
+#   MAILERSEND_FROM_NAME
+#
+# Set these variables in a .env file at the directory where you run wiki-workspace,
+# or export them in your shell before running wiki-workspace agents up.
+#
+# TLS (optional, cme + documents share the same cert):
+#   Set MCP_SSL_CERTFILE=/certs/server.crt and MCP_SSL_KEYFILE=/certs/server.key,
+#   place the cert files in AGENTS_DATA_DIR/certs/, and uncomment the TLS lines below.
+#
+# Usage (via wiki-workspace):
+#   wiki-workspace agents up
+#   wiki-workspace agents down
+#   wiki-workspace agents logs
+#   wiki-workspace agents pull
+#
+# Or directly:
+#   WORKSPACES_ROOT=/path/to/workspaces docker compose -f agents.docker-compose.yml up -d
+
+services:
+
+  cme:
+    image: dotdrelle/agent-cme:latest
+    ports:
+      - "${CME_MCP_PORT:-3336}:8080"
+    environment:
+      - MCP_AUTH_TOKEN=${CME_MCP_AUTH_TOKEN:-}
+      - WORKSPACES_ROOT=/workspaces
+      # HTTPS — uncomment and place cert files in AGENTS_DATA_DIR/certs/
+      #- MCP_SSL_CERTFILE=/certs/server.crt
+      #- MCP_SSL_KEYFILE=/certs/server.key
+    volumes:
+      - ${AGENTS_DATA_DIR:-./.agents-data}/cme:/data
+      - ${WORKSPACES_ROOT:?Set WORKSPACES_ROOT to the directory containing all workspace folders}:/workspaces
+      #- ${AGENTS_DATA_DIR:-./.agents-data}/certs:/certs:ro
+    restart: unless-stopped
+
+  documents:
+    image: dotdrelle/agent-wiki-documents:latest
+    ports:
+      - "${DOCUMENTS_MCP_PORT:-3337}:8080"
+    environment:
+      - MCP_AUTH_TOKEN=${DOCUMENTS_MCP_AUTH_TOKEN:-}
+      - DOCUMENT_INPUT_DIR=/documents/input
+      - DOCUMENT_OUTPUT_DIR=/documents/output
+      - WORKSPACES_ROOT=/workspaces
+      - DOCUMENT_MAX_UPLOAD_BYTES=${DOCUMENT_MAX_UPLOAD_BYTES:-52428800}
+      - DOCUMENT_LLM_BASE_URL=${DOCUMENT_LLM_BASE_URL:-https://api.openai.com/v1}
+      - DOCUMENT_LLM_MODEL=${DOCUMENT_LLM_MODEL:-gpt-5.4-mini}
+      - DOCUMENT_LLM_API_KEY=${DOCUMENT_LLM_API_KEY:-${OPENAI_API_KEY:-}}
+      - DOCUMENT_LLM_TIMEOUT_SECONDS=${DOCUMENT_LLM_TIMEOUT_SECONDS:-120}
+      # HTTPS — uncomment and place cert files in AGENTS_DATA_DIR/certs/
+      #- MCP_SSL_CERTFILE=/certs/server.crt
+      #- MCP_SSL_KEYFILE=/certs/server.key
+    volumes:
+      - ${AGENTS_DATA_DIR:-./.agents-data}/documents/input:/documents/input
+      - ${AGENTS_DATA_DIR:-./.agents-data}/documents/output:/documents/output
+      - ${WORKSPACES_ROOT:?Set WORKSPACES_ROOT to the directory containing all workspace folders}:/workspaces
+      #- ${AGENTS_DATA_DIR:-./.agents-data}/certs:/certs:ro
+    restart: unless-stopped
+
+  mailer:
+    image: dotdrelle/agent-mailer-api:latest
+    ports:
+      - "${MAILER_MCP_PORT:-3335}:8080"
+    environment:
+      - MAILERSEND_API_KEY=${MAILERSEND_API_KEY:-}
+      - MAILERSEND_FROM_EMAIL=${MAILERSEND_FROM_EMAIL:-no-reply@example.com}
+      - MAILERSEND_FROM_NAME=${MAILERSEND_FROM_NAME:-Mailer Agent}
+      - MAILERSEND_USER_AGENT=${MAILERSEND_USER_AGENT:-curl/8.7.1}
+      - MAILERSEND_VERIFY_SSL=${MAILERSEND_VERIFY_SSL:-true}
+      - MAILER_REQUIRE_CONFIRMATION=${MAILER_REQUIRE_CONFIRMATION:-true}
+      - MAILER_DRY_RUN=${MAILER_DRY_RUN:-false}
+      - MCP_AUTH_TOKEN=${MAILER_MCP_AUTH_TOKEN:-}
+    restart: unless-stopped

package/bin/wiki-manager.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+
+import '@opentui/solid/preload';
+
+function formatStartupError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  const code = err && typeof err === 'object' ? err.code : null;
+  if (code === 'ERR_MODULE_NOT_FOUND' || code === 'MODULE_NOT_FOUND') {
+    return [
+      `Startup error: ${message}`,
+      '',
+      'Check that you are running this command from the wiki-manager package directory:',
+      '  cd llm-wiki-manager',
+      '  node ./bin/wiki-manager.js',
+      '',
+      'If dependencies are missing, run:',
+      '  pnpm install',
+    ].join('\n');
+  }
+  return `Startup error: ${message}`;
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  const interactive = process.stdout.isTTY && process.stdin.isTTY && !argv.includes('--headless') && !argv.includes('--once') && !argv.includes('--version') && !argv.includes('-v') && !argv.includes('--help') && !argv.includes('-h');
+  if (interactive) process.stdout.write('Starting wiki-manager…\r');
+  const { runCli } = await import('../src/cli/wiki-manager.js');
+  await runCli(argv);
+}
+
+main().catch((err) => {
+  console.error(formatStartupError(err));
+  process.exit(1);
+});

package/bunfig.toml

@@ -0,0 +1 @@
+preload = ["@opentui/solid/preload"]

package/docker-compose.yml

@@ -0,0 +1,135 @@
+# docker-compose.yml — llm-wiki-manager cockpit stack
+#
+# This compose file is driven by ./wiki-workspace. It can run:
+#   - one llm-wiki serve + mcp-http + production MCP set per configured workspace
+#
+# Typical usage:
+#   ./wiki-workspace config <workspace> [path]
+#   ./wiki-workspace up <workspace>
+#   ./wiki-workspace wiki <workspace> doctor
+#   ./wiki-workspace wiki <workspace> ingest
+#
+# Workspace UI / MCP endpoints use the ports declared in workspaces/<name>/.env.
+# External MCP endpoints are declared in ./mcp.endpoints.json.
+
+services:
+
+  # ── llm-wiki ──────────────────────────────────────────────────────────────
+
+  wiki:
+    image: dotdrelle/llm-wiki:latest
+    profiles: [cli]
+    volumes:
+      # Compose interpolates all services before applying profiles, so this
+      # cannot be a required variable without breaking cli-only commands.
+      - ${WIKI_WORKSPACE_PATH:-/tmp/llm-wiki-workspace-not-set}:/workspace
+    environment:
+      - WIKI_WORKSPACE_PATH=/workspace
+      - WIKI_CONFIG_PATH
+    extra_hosts:
+      - host.docker.internal:host-gateway
+
+  serve:
+    image: dotdrelle/llm-wiki:latest
+    labels:
+      wiki-manager.description: "Workspace web UI and local wiki browser."
+    command: serve --port 3000
+    stop_grace_period: 10s
+    volumes:
+      - ${WIKI_WORKSPACE_PATH:-/tmp/llm-wiki-workspace-not-set}:/workspace
+      - ./mcp.endpoints.json:/mcp.endpoints.json:ro
+      - ${AGENTS_DATA_DIR:-./.agents-data}/documents/input:/documents/input
+      - ${AGENTS_DATA_DIR:-./.agents-data}/documents/uploads:/documents/uploads
+      # TLS certificates — uncomment if WIKI_SERVE_TLS_CERT_PATH is set
+      #- ${WIKI_SERVE_CERTS_DIR:-./certs}:/certs:ro
+    environment:
+      - WIKI_WORKSPACE_PATH=/workspace
+      - WIKI_CONFIG_PATH
+      - WIKI_MCP_HTTP_PORT=${WIKI_MCP_PORT:-3101}
+      - WIKI_MCP_AUTH_TOKEN
+      - PRODUCTION_MCP_AUTH_TOKEN
+      - PRODUCTION_MCP_PORT
+      - CME_MCP_PORT
+      - DOCUMENTS_MCP_PORT
+      - MAILER_MCP_PORT
+      - CME_MCP_AUTH_TOKEN
+      - DOCUMENTS_MCP_AUTH_TOKEN
+      - MAILER_MCP_AUTH_TOKEN
+      - ATLASSIAN_MCP_AUTH_TOKEN
+      - WORKSPACE_NAME
+      - DOCUMENT_INPUT_DIR=/documents/input
+      - DOCUMENT_UPLOADS_DIR=/documents/uploads
+      - DOCUMENT_MAX_UPLOAD_BYTES=${DOCUMENT_MAX_UPLOAD_BYTES:-52428800}
+      - WIKI_MCP_PROXY_URL=http://host.docker.internal:${WIKI_MCP_PORT:-3101}/mcp
+      - PRODUCTION_MCP_PROXY_URL=http://host.docker.internal:${PRODUCTION_MCP_PORT:-3102}/mcp/
+      # HTTPS — set paths inside the container (e.g. /certs/server.crt) and uncomment the volume above
+      #- WIKI_SERVE_TLS_CERT_PATH=/certs/server.crt
+      #- WIKI_SERVE_TLS_KEY_PATH=/certs/server.key
+      #- WIKI_SERVE_TLS_CA_PATH=/certs/ca.crt
+    ports:
+      - '${WIKI_SERVE_PORT:-3100}:3000'
+    extra_hosts:
+      - host.docker.internal:host-gateway
+    restart: unless-stopped
+
+  mcp-http:
+    image: dotdrelle/llm-wiki:latest
+    labels:
+      wiki-manager.description: "llm-wiki MCP HTTP server for wiki tools."
+    command: mcp-http --host 0.0.0.0 --port 3333 --path /mcp
+    volumes:
+      - ${WIKI_WORKSPACE_PATH:-/tmp/llm-wiki-workspace-not-set}:/workspace
+      # TLS certificates — uncomment if WIKI_MCP_TLS_CERT_PATH is set
+      #- ${WIKI_MCP_CERTS_DIR:-./certs}:/certs:ro
+    environment:
+      - WIKI_WORKSPACE_PATH=/workspace
+      - WIKI_CONFIG_PATH
+      - WIKI_MCP_AUTH_TOKEN
+      # HTTPS — set paths inside the container (e.g. /certs/server.crt) and uncomment the volume above
+      - WIKI_MCP_TLS_CERT_PATH
+      - WIKI_MCP_TLS_KEY_PATH
+      - WIKI_MCP_TLS_CA_PATH
+    ports:
+      - '${WIKI_MCP_PORT:-3101}:3333'
+    extra_hosts:
+      - host.docker.internal:host-gateway
+    restart: unless-stopped
+
+  # ── agent-wiki-production ─────────────────────────────────────────────────
+
+  production-mcp:
+    image: dotdrelle/agent-wiki-production:latest
+    labels:
+      wiki-manager.description: "Production MCP server for ingest/build/export jobs."
+    volumes:
+      - ${WIKI_WORKSPACE_PATH:-/tmp/llm-wiki-workspace-not-set}:/workspace
+    environment:
+      - MCP_AUTH_TOKEN=${PRODUCTION_MCP_AUTH_TOKEN:-}
+      - WORKSPACE_NAME=${WORKSPACE_NAME:-workspace}
+      - WIKI_WORKSPACE_PATH=/workspace
+      - WIKI_CONFIG_PATH=${WIKI_CONFIG_PATH:-}
+      - PRODUCTION_ALLOWED_STEPS=${PRODUCTION_ALLOWED_STEPS:-doctor,ingest,build,export,polish,pipeline}
+      - PRODUCTION_REQUIRE_CONFIRMATION=${PRODUCTION_REQUIRE_CONFIRMATION:-false}
+      - PRODUCTION_JOBS_DIR=${PRODUCTION_JOBS_DIR:-/workspace/.wiki/production-jobs}
+      - PRODUCTION_LOCKS_DIR=${PRODUCTION_LOCKS_DIR:-/workspace/.wiki/production-jobs/locks}
+    ports:
+      - '${PRODUCTION_MCP_PORT:-3102}:8080'
+    restart: unless-stopped
+
+x-wiki-manager:
+  service-aliases:
+    all:
+      targets: [serve, mcp-http, production-mcp]
+      description: "Full workspace service set."
+    ui:
+      targets: [serve]
+      description: "Alias for serve: workspace web UI."
+    wiki:
+      targets: [mcp-http]
+      description: "Alias for mcp-http: wiki MCP server."
+    mcp:
+      targets: [mcp-http]
+      description: "Alias for mcp-http: wiki MCP server."
+    production:
+      targets: [production-mcp]
+      description: "Alias for production-mcp: production jobs."

package/mcp.endpoints.example.json

@@ -0,0 +1,28 @@
+{
+  "mcpServers": {
+    "cme": {
+      "url": "http://host.docker.internal:${CME_MCP_PORT:-3336}/mcp/",
+      "headers": {
+        "Authorization": "Bearer ${CME_MCP_AUTH_TOKEN}"
+      }
+    },
+    "documents": {
+      "url": "http://host.docker.internal:${DOCUMENTS_MCP_PORT:-3337}/mcp/",
+      "headers": {
+        "Authorization": "Bearer ${DOCUMENTS_MCP_AUTH_TOKEN}"
+      }
+    },
+    "mailer": {
+      "url": "http://host.docker.internal:${MAILER_MCP_PORT:-3335}/mcp/",
+      "headers": {
+        "Authorization": "Bearer ${MAILER_MCP_AUTH_TOKEN}"
+      }
+    },
+    "atlassian": {
+      "url": "http://host.docker.internal:9000/mcp",
+      "headers": {
+        "Authorization": "Bearer ${ATLASSIAN_MCP_AUTH_TOKEN}"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@dotdrelle/wiki-manager",
+  "version": "0.6.17",
+  "description": "Agentic shell and orchestration cockpit for llm-wiki workspaces.",
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "author": "dotrelle",
+  "type": "module",
+  "bin": {
+    "wiki-manager": "bin/wiki-manager.js",
+    "wiki-workspace": "wiki-workspace"
+  },
+  "scripts": {
+    "start": "bun ./bin/wiki-manager.js",
+    "test": "node --test src/core/activity.test.js src/core/agentEvents.test.js src/core/plan.test.js src/core/mcp.test.js src/core/documentIntake.test.js",
+    "check": "bun ./bin/wiki-manager.js --version && bun ./bin/wiki-manager.js --help && bun ./bin/wiki-manager.js --once \"verifie le mode agent\""
+  },
+  "engines": {
+    "node": ">=22.0.0",
+    "bun": ">=1.2.0"
+  },
+  "files": [
+    "bin",
+    "src",
+    "wiki-workspace",
+    "docker-compose.yml",
+    "agents.docker-compose.yml",
+    "mcp.endpoints.example.json",
+    ".env.example",
+    "tsconfig.json",
+    "bunfig.toml",
+    "workspaces/.env.example",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "llm",
+    "wiki",
+    "agent",
+    "mcp",
+    "orchestration",
+    "cli"
+  ],
+  "packageManager": "pnpm@10.29.2",
+  "dependencies": {
+    "@langchain/langgraph": "^1.3.2",
+    "@opentui/core": "^0.3.2",
+    "@opentui/solid": "^0.3.2",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "openai": "^6.42.0",
+    "solid-js": "1.9.12",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.0.0"
+  }
+}