Add Maintenance menu, track name fixer

.dockerignore

@@ -0,0 +1,16 @@
+node_modules/
+dist/
+.git/
+.gitignore
+*.log
+*.md
+Dockerfile*
+.dockerignore
+coverage/
+.env
+.env.*
+*.test.ts
+*.spec.ts
+__tests__/
+.vscode/
+.idea/

.gitignore

@@ -8,4 +8,6 @@ yarn-error.log*
 coverage/
 .env
 .env.*
-!/.env.example
+!/.env.example
+debug-run*
+Dockerfile.test

CLAUDE.md

@@ -0,0 +1,60 @@
+# CLAUDE.md
+
+## CRITICAL: Ready Endpoint Requirements
+
+**THE `/ready` ENDPOINT MUST VERIFY THAT THE NODE HAS SYNCED CONTENT.**
+
+A "ready" check is NOT just "is the service alive". It means:
+- The node has connected to peers
+- Content replication has occurred
+- Data stores contain replicated content
+- The node is actually serving the content it should be serving
+
+We care deeply if content is synced. That's the entire point of the ready check.
+
+The challenge is that checking sync status triggers expensive distributed index queries that cause DoS. The solution is to:
+1. Cache sync status and only refresh it periodically (not on every `/ready` call)
+2. Use the most efficient Peerbit APIs to check replication status
+3. Ensure the check completes quickly without exhausting system resources
+
+But the check MUST verify actual content replication, not just peer connectivity.
+
+## CRITICAL: Local Build vs Docker - It Works Locally
+
+**THE LOCAL BUILD WORKS RELIABLY.** When debugging Docker issues:
+
+The site `zb2rhcRzjgGXUxi8PypUJGvk42HXaXQS3VBZ2aYvgAUrDgkZ1` EXISTS and the local build connects, replicates, and runs successfully with these exact parameters:
+
+```bash
+rm -r ~/.lens-node/
+SITE_ADDRESS=zb2rhcRzjgGXUxi8PypUJGvk42HXaXQS3VBZ2aYvgAUrDgkZ1 \
+BOOTSTRAPPERS=/dns4/relay01.eu.riff.cc/tcp/443/wss/p2p/12D3KooWRcsxc5FBG4QU6MoeGmuXi5KbQyYKwZPnkemKV2GZcRvM,/dns4/relay02.us.riff.cc/tcp/443/wss/p2p/12D3KooWGie5X52rmrZ6iDgqrWv8Ecnc3YfUwsopCT6isbVWZHJR,/dns4/relay03.sg.riff.cc/tcp/443/wss/p2p/12D3KooWDDwXRyvibdj1quDsmvmEKPGH2yK2mMEGXonBKc5GPdDh \
+./dist/cli/bin.js run -d ~/.lens-node --onlyReplicate --light --useRelays --apiPort 10002 --listenPort 9001
+```
+
+Output: `LensService configured.` and the node runs successfully.
+
+If Docker fails with "Failed to load store" but local works, the issue is NOT:
+- The site doesn't exist
+- The parameters are wrong
+- Native modules (if local and Docker both use the same published package)
+
+Look for environment differences: permissions, file paths, network configuration, or Docker-specific issues.
+
+## CRITICAL: Using DeepWiki for Peerbit Research
+
+**DeepWiki is NOT aware of Lens Node specific terminology or implementation details.**
+
+When querying the dao-xyz/peerbit repository via DeepWiki:
+- ❌ DO NOT use Lens-specific terms like "Lens node", "Site", "ready check", "featured releases"
+- ✅ DO use Peerbit-specific terms like "peer", "SharedLog", "replication", "relay", "DirectStream"
+- ❌ DO NOT assume DeepWiki knows about our lens-sdk wrapper or LensService
+- ✅ DO ask about core Peerbit concepts like "connectionManager", "DialerOptions", "SeekDelivery"
+
+**Example Queries:**
+- ✅ "How does Peerbit handle relay reconnection when relay connections are lost?"
+- ❌ "How does Lens handle relay reconnection?"
+- ✅ "How does SeekDelivery calculate quorum in Peerbit?"
+- ❌ "How does the ready check work with SeekDelivery?"
+
+DeepWiki provides documentation for the **upstream Peerbit library**, not our implementation that wraps it.

Dockerfile

@@ -1,16 +1,27 @@
-FROM node:22-alpine
+FROM node:22-trixie-slim
 
 WORKDIR /app
 
-ARG TAG
-ENV TAG=${TAG:-latest}
-
 # Enable corepack, set PNPM_HOME and ensure pnpm is available
 ENV PNPM_HOME=/root/.local/share/pnpm
 ENV PATH=$PNPM_HOME:$PATH
 RUN corepack enable && corepack prepare pnpm@latest --activate
 
-# Install the CLI
-RUN pnpm install -g --dangerously-allow-all-builds @riffcc/lens-node@${TAG}
+# Install build dependencies for native modules
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    python3 \
+    make \
+    g++ \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy package files and lockfile
+COPY package.json pnpm-lock.yaml ./
+
+# Install dependencies locally
+RUN pnpm install --frozen-lockfile
+
+# Copy source and build
+COPY . .
+RUN pnpm build
 
-ENTRYPOINT ["lens-node"]
+ENTRYPOINT ["node", "dist/cli/bin.js"]

Dockerfile.dev

@@ -0,0 +1,55 @@
+# Development Dockerfile for building from source
+FROM node:18-alpine as builder
+
+WORKDIR /app
+
+# Install pnpm
+RUN npm install -g pnpm
+
+# First, build lens-sdk locally
+COPY ../lens-sdk /lens-sdk
+WORKDIR /lens-sdk
+RUN pnpm install --frozen-lockfile && pnpm build
+
+# Now build lens-node
+WORKDIR /app
+
+# Copy package files
+COPY package.json pnpm-lock.yaml ./
+
+# Link local lens-sdk
+RUN pnpm link /lens-sdk
+
+# Install dependencies
+RUN pnpm install --frozen-lockfile
+
+# Copy source code
+COPY . .
+
+# Build the project
+RUN pnpm build
+
+# Runtime stage
+FROM node:18-alpine
+
+WORKDIR /app
+
+# Install pnpm in runtime
+RUN npm install -g pnpm
+
+# Copy built files and dependencies
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package.json ./package.json
+
+# Create directory for lens-node data
+RUN mkdir -p /root/.lens-node
+
+# Make binary executable
+RUN chmod +x dist/cli/bin.js
+
+# Expose default ports
+EXPOSE 9501 3000
+
+# Default command
+CMD ["node", "dist/cli/bin.js", "run"]

Dockerfile.full

@@ -0,0 +1,74 @@
+# Full build Dockerfile that includes lens-sdk from source
+# Use the same base image throughout to ensure binary compatibility
+FROM node:22-slim as base
+
+# Install pnpm and build tools once in base
+RUN npm install -g pnpm && \
+    apt-get update && \
+    apt-get install -y python3 make g++ && \
+    rm -rf /var/lib/apt/lists/*
+
+# Build lens-sdk
+FROM base as sdk-builder
+WORKDIR /lens-sdk
+
+# Copy lens-sdk files
+COPY ./lens-sdk/package.json ./lens-sdk/pnpm-lock.yaml ./
+RUN pnpm install --frozen-lockfile
+
+COPY ./lens-sdk/ ./
+RUN pnpm build
+
+# Build lens-node
+FROM base as node-builder
+WORKDIR /app
+
+# Copy lens-node package files
+COPY ./lens-node/package.json ./lens-node/pnpm-lock.yaml ./
+
+# Copy built lens-sdk from previous stage
+COPY --from=sdk-builder /lens-sdk /lens-sdk
+
+# Install dependencies with local lens-sdk using file: protocol
+RUN sed -i 's|"@riffcc/lens-sdk": ".*"|"@riffcc/lens-sdk": "file:/lens-sdk"|' package.json && \
+    pnpm install --no-frozen-lockfile && \
+    pnpm rebuild
+
+# Copy lens-node source
+COPY ./lens-node/ ./
+
+# Build lens-node
+RUN pnpm build
+
+# Runtime stage - same base image!
+FROM base
+
+WORKDIR /app
+
+# Copy everything from the build stage
+COPY --from=node-builder /app/dist ./dist
+COPY --from=node-builder /app/node_modules ./node_modules
+COPY --from=node-builder /app/package.json ./package.json
+COPY --from=sdk-builder /lens-sdk /lens-sdk
+
+# Rebuild native modules in the runtime container
+RUN cd /app && pnpm rebuild
+
+# Create directory for lens-node data
+RUN mkdir -p /root/.lens-node
+
+# Make binary executable
+RUN chmod +x dist/cli/bin.js
+
+# Copy entrypoint script
+COPY ./lens-node/docker-entrypoint.sh /usr/local/bin/
+RUN chmod +x /usr/local/bin/docker-entrypoint.sh
+
+# Expose default ports
+EXPOSE 9501 3000
+
+# Set entrypoint
+ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
+
+# Default command (will be passed to entrypoint which adds node dist/cli/bin.js)
+CMD ["run"]

Dockerfile.local

@@ -0,0 +1,26 @@
+FROM node:22-trixie-slim
+
+WORKDIR /app
+
+# Enable corepack and install pnpm
+ENV PNPM_HOME=/root/.local/share/pnpm
+ENV PATH=$PNPM_HOME:$PATH
+RUN corepack enable && corepack prepare pnpm@latest --activate
+
+# Install build dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    python3 \
+    make \
+    g++ \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy package files
+COPY package.json pnpm-lock.yaml* ./
+
+# Install dependencies
+RUN pnpm install --frozen-lockfile
+
+# Copy built dist
+COPY dist ./dist
+
+ENTRYPOINT ["node", "dist/cli/bin.js"]

Dockerfile.simple

@@ -0,0 +1,46 @@
+# Simple single-stage Dockerfile for lens-node
+FROM node:18-slim
+
+WORKDIR /app
+
+# Install pnpm and build tools
+RUN npm install -g pnpm && \
+    apt-get update && \
+    apt-get install -y python3 make g++ && \
+    rm -rf /var/lib/apt/lists/*
+
+# Copy lens-sdk source
+COPY ./lens-sdk /lens-sdk
+WORKDIR /lens-sdk
+RUN pnpm install --frozen-lockfile && pnpm build
+
+# Copy lens-node source
+WORKDIR /app
+COPY ./lens-node/package.json ./lens-node/pnpm-lock.yaml ./
+
+# Install dependencies with local lens-sdk
+RUN sed -i 's|"@riffcc/lens-sdk": ".*"|"@riffcc/lens-sdk": "file:/lens-sdk"|' package.json && \
+    pnpm install --no-frozen-lockfile
+
+# Copy lens-node source and build
+COPY ./lens-node/ ./
+RUN pnpm build
+
+# Create directory for lens-node data
+RUN mkdir -p /root/.lens-node
+
+# Make binary executable
+RUN chmod +x dist/cli/bin.js
+
+# Copy entrypoint script
+COPY ./lens-node/docker-entrypoint.sh /usr/local/bin/
+RUN chmod +x /usr/local/bin/docker-entrypoint.sh
+
+# Expose default ports
+EXPOSE 9501 3000
+
+# Set entrypoint
+ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
+
+# Default command (will be passed to entrypoint which adds node dist/cli/bin.js)
+CMD ["run"]

bin.js.bak

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import yargs from 'yargs';
+import { hideBin } from 'yargs/helpers';
+import runCommand from './commands/run.js';
+import setupCommand from './commands/setup.js';
+import importCommand from './commands/import.js';
+import { generateMigrationCommand } from './commands/generate-migration.js';
+import { migrateCommand } from './commands/migrate.js';
+import { undoCommand } from './commands/undo.js';
+import { releasesMigrateCommand } from './commands/releases-migrate.js';
+import { programMigrateCommand } from './commands/program-migrate.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import path from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packageJsonPath = path.resolve(__dirname, '../../package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+yargs(hideBin(process.argv))
+    .scriptName('lens-node')
+    .command(setupCommand)
+    .command(runCommand)
+    .command(importCommand)
+    .command(generateMigrationCommand)
+    .command(migrateCommand)
+    .command(undoCommand)
+    .command(releasesMigrateCommand)
+    .command(programMigrateCommand)
+    .demandCommand(1, 'A command must be specified.')
+    .strict()
+    .help()
+    .alias('h', 'help')
+    .version(packageJson.version)
+    .alias('v', 'version')
+    .fail((msg, err, yargsInstance) => {
+    if (err) {
+        console.error('Error:', err.message);
+    }
+    else if (msg) {
+        console.error(`Error: ${msg}\n`); // Then print the specific message
+    }
+    yargsInstance.showHelp(); // Show yargs generated help for context
+    process.exit(1);
+})
+    .parse();
+//# sourceMappingURL=bin.js.map

docker-build.sh

@@ -1 +1,2 @@
-docker build -t zorlin/lens-node:0.1.16 --build-arg TAG=0.1.16 .
+docker build -t zorlin/lens-node:0.1.48-a13 --build-arg TAG=0.1.48-a13 .
+docker push zorlin/lens-node:0.1.48-a13