@medicine-wheel/app 0.2.3

package/dist/cli/mwsrv.js

@@ -0,0 +1,267 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * mwsrv — Medicine Wheel Server Launcher
+ *
+ * Starts the Medicine Wheel Next.js application in local or Docker mode.
+ *
+ * Usage:
+ *   mwsrv [options]
+ *   mwsrv --docker -D /path/to/project
+ *
+ * Options:
+ *   --port, -p <port>        Port to listen on (default: 3940)
+ *   --directory, -D <dir>    Host directory containing (or for) .mw/store (default: cwd)
+ *   --docker                 Run in Docker container
+ *   --pull                   Pull Docker image before starting
+ *   --no-open                Do not open browser automatically
+ *   --help, -h               Show this help message
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const DOCKER_IMAGE = 'jgwill/medicine-wheel:app';
+const DEFAULT_PORT = 3940;
+const CONTAINER_PORT = 3940;
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    const flags = {};
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--') {
+            positional.push(...args.slice(i + 1));
+            break;
+        }
+        else if (arg.startsWith('--')) {
+            const key = arg.slice(2);
+            const next = args[i + 1];
+            if (next !== undefined && !next.startsWith('-')) {
+                flags[key] = args[++i];
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else if (arg.startsWith('-') && arg.length === 2) {
+            const key = arg.slice(1);
+            const next = args[i + 1];
+            if (next !== undefined && !next.startsWith('-')) {
+                flags[key] = args[++i];
+            }
+            else {
+                flags[key] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { flags, positional };
+}
+// ── Helpers ───────────────────────────────────────────────────────
+function resolvePackageRoot() {
+    try {
+        const scriptDir = path.dirname(fs.realpathSync(process.argv[1]));
+        // dist/cli/mwsrv.js → go up two levels to package root
+        return path.resolve(scriptDir, '..', '..');
+    }
+    catch {
+        return process.cwd();
+    }
+}
+function openBrowser(url) {
+    const cmd = process.platform === 'darwin'
+        ? 'open'
+        : process.platform === 'win32'
+            ? 'start'
+            : 'xdg-open';
+    (0, child_process_1.spawn)(cmd, [url], { detached: true, stdio: 'ignore' }).unref();
+}
+// ── Docker mode ───────────────────────────────────────────────────
+async function runDocker(opts) {
+    const { hostDir, port, pull, noOpen } = opts;
+    // Resolve store path on host: <dir>/.mw/store
+    const storeDir = path.resolve(hostDir, '.mw', 'store');
+    fs.mkdirSync(storeDir, { recursive: true });
+    if (pull) {
+        console.log(`⬇️  Pulling ${DOCKER_IMAGE}...`);
+        await new Promise((resolve, reject) => {
+            const p = (0, child_process_1.spawn)('docker', ['pull', DOCKER_IMAGE], { stdio: 'inherit' });
+            p.on('exit', (code) => code === 0 ? resolve() : reject(new Error(`docker pull failed: ${code}`)));
+        });
+    }
+    const dockerArgs = [
+        'run', '--rm',
+        '-p', `${port}:${CONTAINER_PORT}`,
+        '-v', `${storeDir}:/data/store`,
+        '-e', `MW_DATA_DIR=/data/store`,
+        '-e', `MW_STORAGE_PROVIDER=jsonl`,
+        '-e', `PORT=${CONTAINER_PORT}`,
+        DOCKER_IMAGE,
+    ];
+    console.log(`🐳 docker ${dockerArgs.join(' ')}\n`);
+    const proc = (0, child_process_1.spawn)('docker', dockerArgs, { stdio: 'inherit' });
+    if (!noOpen) {
+        setTimeout(() => {
+            const url = `http://localhost:${port}`;
+            console.log(`\n🚀 Opening browser: ${url}\n`);
+            openBrowser(url);
+        }, 4000);
+    }
+    const shutdown = () => {
+        console.log('\n👋 Shutting down Medicine Wheel...');
+        proc.kill();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    proc.on('exit', (code) => process.exit(code ?? 0));
+}
+// ── Local mode ────────────────────────────────────────────────────
+function runLocal(opts) {
+    const { hostDir, port, noOpen, packageRoot } = opts;
+    const storeDir = path.resolve(hostDir, '.mw', 'store');
+    fs.mkdirSync(storeDir, { recursive: true });
+    // Local mode always runs `next dev`. `next start` requires a production build
+    // (.next/) which is not shipped in the published package. For a
+    // production-like experience without a source checkout, use --docker instead.
+    const nextCmd = 'dev';
+    console.log(`🌿 Medicine Wheel — local dev mode (next dev)`);
+    console.log(`   For a production-built server use: mwsrv --docker`);
+    console.log(`📁 Store: ${storeDir}`);
+    console.log(`🌐 http://localhost:${port}\n`);
+    const env = {
+        ...process.env,
+        MW_DATA_DIR: storeDir,
+        MW_STORAGE_PROVIDER: process.env.MW_STORAGE_PROVIDER ?? 'jsonl',
+        PORT: String(port),
+    };
+    // next binary may be in node_modules/.bin relative to package root
+    const nextBin = path.join(packageRoot, 'node_modules', '.bin', 'next');
+    const nextExe = fs.existsSync(nextBin) ? nextBin : 'next';
+    const proc = (0, child_process_1.spawn)(nextExe, [nextCmd, '-p', String(port)], {
+        cwd: packageRoot,
+        stdio: 'inherit',
+        env,
+    });
+    if (!noOpen) {
+        setTimeout(() => {
+            const url = `http://localhost:${port}`;
+            console.log(`\n🚀 Opening browser: ${url}\n`);
+            openBrowser(url);
+        }, 5000);
+    }
+    const shutdown = () => {
+        console.log('\n👋 Shutting down Medicine Wheel...');
+        proc.kill();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    proc.on('exit', (code) => process.exit(code ?? 0));
+}
+// ── Help ──────────────────────────────────────────────────────────
+function showHelp() {
+    console.log(`
+\x1b[1m🌿 mwsrv — Medicine Wheel Server Launcher\x1b[0m
+
+DESCRIPTION
+  Starts the Medicine Wheel Next.js application locally or in Docker.
+  In Docker mode, data persists in the host directory's .mw/store folder.
+
+USAGE
+  mwsrv [options]
+
+OPTIONS
+  --port, -p <port>       Port to listen on (default: ${DEFAULT_PORT})
+  --directory, -D <dir>   Host directory for .mw/store (default: current dir)
+  --docker                Run in Docker container (image: ${DOCKER_IMAGE})
+  --pull                  Pull/update Docker image before starting
+  --no-open               Do not auto-open browser
+  --help, -h              Show this help
+
+EXAMPLES
+  # Start locally (uses current directory's .mw/store)
+  mwsrv
+
+  # Start locally with a specific data directory
+  mwsrv -D ~/my-research
+
+  # Start in Docker (recommended for clean environments)
+  mwsrv --docker
+
+  # Docker with custom directory and port
+  mwsrv --docker -D ~/my-research --port 4000
+
+  # Pull latest image then start in Docker
+  mwsrv --docker --pull -D ~/my-research
+
+ENVIRONMENT
+  MW_API_URL            Client API URL (default: http://localhost:${DEFAULT_PORT})
+  MW_STORAGE_PROVIDER   Storage backend: jsonl (default) or postgres
+  DATABASE_URL          PostgreSQL connection string (when using postgres provider)
+`);
+}
+// ── Main ──────────────────────────────────────────────────────────
+async function main() {
+    const { flags } = parseArgs(process.argv);
+    if (flags['help'] || flags['h']) {
+        showHelp();
+        return;
+    }
+    const port = Number(flags['port'] ?? flags['p'] ?? DEFAULT_PORT);
+    const directory = String(flags['directory'] ?? flags['D'] ?? process.cwd());
+    const useDocker = Boolean(flags['docker']);
+    const pull = Boolean(flags['pull']);
+    const noOpen = Boolean(flags['no-open']);
+    const hostDir = path.resolve(directory);
+    console.log(`🌿 Medicine Wheel${useDocker ? ' [DOCKER]' : ' [LOCAL]'}`);
+    console.log(`📁 Directory: ${hostDir}`);
+    console.log(`🌐 Port: ${port}\n`);
+    if (useDocker) {
+        await runDocker({ hostDir, port, pull, noOpen });
+    }
+    else {
+        const packageRoot = resolvePackageRoot();
+        runLocal({ hostDir, port, noOpen, packageRoot });
+    }
+}
+main().catch((err) => {
+    console.error('❌ Fatal error:', err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});

package/docker-build-push.sh

@@ -0,0 +1,15 @@
+#!/bin/sh
+set -e
+
+TAG="${1:-app}"
+IMAGE="jgwill/medicine-wheel:${TAG}"
+
+echo "🐳 Building ${IMAGE}..."
+docker build -t "${IMAGE}" .
+
+echo "📤 Pushing ${IMAGE}..."
+docker push "${IMAGE}"
+
+echo "✅ Done: ${IMAGE}"
+echo "Run with:"
+echo "  docker run --rm -p 3940:3940 -v /abs/path/to/project/.mw/store:/data/store ${IMAGE}"

package/docker-entrypoint.sh

@@ -0,0 +1,26 @@
+#!/bin/sh
+set -e
+
+# Medicine Wheel Docker Entrypoint
+#
+# The Next.js app is pre-built. Data store is mounted at /data/store.
+# Environment variables:
+#   MW_DATA_DIR          — path to JSONL store directory (default: /data/store)
+#   MW_STORAGE_PROVIDER  — storage backend (default: jsonl)
+#   PORT                 — HTTP port (default: 3940)
+
+STORE_DIR="${MW_DATA_DIR:-/data/store}"
+PORT="${PORT:-3940}"
+
+mkdir -p "$STORE_DIR"
+
+echo "🌿 Medicine Wheel"
+echo "📁 Store: $STORE_DIR"
+echo "🌐 http://localhost:$PORT"
+echo ""
+
+export MW_DATA_DIR="$STORE_DIR"
+export MW_STORAGE_PROVIDER="${MW_STORAGE_PROVIDER:-jsonl}"
+export PORT="$PORT"
+
+exec node_modules/.bin/next start -p "$PORT"