GGitHubchore(deps): update dependency @types/node to v26

d52397fa创建于 7月21日历史提交

文件	最后提交记录	最后更新时间
bin	fix(cli): correct docker exec, port/slug validation, update pull, and restore behavior - dockerComposeExec: pass -T so non-interactive (CI) exec doesn't hang on a TTY - validatePort: reject non-numeric input before parseInt - organization slug: use canonical validateSlug (rejects leading/trailing/double hyphens) - update: pull images before recreating containers; tidy content-volume migration - restore: idempotency + clearer external-DB / no-deployment guards - add a --version guard and export a few helpers (parseMemLimit, formatBytes) for testing	2 个月前
docs	docs(cli): update release workflow documentation for improved clarity	4 个月前
scripts	feat: improvements to the cli	6 个月前
src	release(cli): bump version to 1.5.1	2 个月前
tests	fix(upload): allow large video uploads and surface upload errors Large video uploads failed instantly (~0s) with no feedback. Two causes: - The CLI-generated reverse proxy capped request bodies at 500M while the app's internal nginx allows 6G, so any video >500M was rejected with a 413 before reaching the app. Raise the proxy limit to 6G to match. - On a failed upload the frontend called result.json() on the proxy's HTML 413 page (throwing "Unexpected token '<'") and never dismissed the loading toast, so the user saw an endless spinner with no error. createFileActivity now checks result.ok and throws a clear error, and submitFileActivity catches failures to dismiss the toast and show an error message. Also clears pre-existing strict-lint errors in the touched component.	2 个月前
.gitignore	feat: add update command and enhance CLI documentation	5 个月前
.npmignore	feat: improvements to the cli	6 个月前
README.md	seo(cli): set npm homepage to learnhouse.app and add links to README	5 个月前
TEST_AUDIT.md	test(cli): close 6 mutation-test gaps, fix flaky network test, strengthen restore assertions A mutation-testing audit (cli-test-audit workflow + hand verification) found 6 behaviors that could be silently broken without any test failing. Each is now covered by a real assertion (verified: the same mutation now fails the suite): - compareVersions: assert a newer PATCH release is noticed (not just major) - dockerComposeUpRetry: exercise the default attempts=3 (was always passed explicitly) - getPublicIp: assert the anchored IP regex rejects an IP embedded in junk - backup createBackup: assert the exact pg_dump --clean --if-exists command - checkDevEnv: assert the generated collab .env actually contains COLLAB_PORT=4000 - autoDetectDeploymentId: assert the docker ps name=learnhouse-app- filter string Also: rewrote the flaky checkTcpConnection timeout test (dialed live 192.0.2.1) to mock the socket deterministically; strengthened the backup/restore guard tests to assert exit codes + that no psql runs past a guard, and gave the previously assertion-free 'interactive menu routes to restore' test a real assertion. Adds apps/cli/TEST_AUDIT.md documenting the audit.	2 个月前
bun.lock	chore(deps): update dependency @types/node to v26	1 个月前
install.ps1	feat: improvements to the cli	6 个月前
install.sh	fix(cli): handle Docker socket permissions on fresh Linux installs - Use sg docker to launch CLI with new group membership in same session - Detect "permission denied" vs "daemon not running" in Docker check - Show actionable fix command when Docker socket access is denied	5 个月前
package.json	chore(deps): update dependency @types/node to v26	1 个月前
tsconfig.json	feat(cli): add CI support and testing commands; enhance setup and update commands with non-interactive options	5 个月前
tsup.config.ts	feat: multiple improvements to the CLI	5 个月前
vitest.config.ts	feat(cli): add CI support and testing commands; enhance setup and update commands with non-interactive options	5 个月前

LearnHouse CLI

The official LearnHouse CLI — deploy, manage, and operate your LearnHouse instance.

Website | Documentation | GitHub

Quick Start

One-line install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/learnhouse/learnhouse/main/apps/cli/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/learnhouse/learnhouse/main/apps/cli/install.ps1 | iex

Using npx

npx learnhouse@latest setup

Install a specific version

npx learnhouse@1.0.0 setup

Requirements

Node.js >= 18
Docker

Commands

Command	Description
`learnhouse setup`	Interactive setup wizard
`learnhouse start`	Start all services
`learnhouse stop`	Stop all services
`learnhouse update`	Update to the latest version
`learnhouse update --version <x.y.z>`	Update to a specific version
`learnhouse logs`	Stream service logs
`learnhouse config`	Show current configuration
`learnhouse status`	Show service status
`learnhouse health`	Run health checks
`learnhouse backup`	Backup database
`learnhouse restore <archive>`	Restore database from a backup
`learnhouse deployments`	View deployments and set resource limits
`learnhouse doctor`	Diagnose common issues
`learnhouse shell`	Open a shell in a running container
`learnhouse env`	Edit environment variables
`learnhouse dev`	Start local development environment

Setup

The setup wizard walks through:

Install directory — where files are generated
Domain — hostname, port, HTTPS/SSL
Database & Redis — local (Docker) or external
Organization — name for your instance
Admin account — email and password
Features — AI, email, S3, OAuth, Unsplash

You can go back to any step, and edit from the summary before confirming.

Updating

# Back up first
npx learnhouse backup

# Update to latest
npx learnhouse update

# Or a specific version
npx learnhouse update --version 1.2.0

The update command pulls the new image, restarts services, and asks if you want to run database migrations. Check docs.learnhouse.app for migration guides before proceeding.

Generated Files

learnhouse/
  docker-compose.yml       # Service definitions
  .env                     # Configuration
  learnhouse.config.json   # CLI metadata
  extra/
    nginx.prod.conf        # Reverse proxy (or Caddyfile for auto-SSL)

CI / Non-interactive Mode

All commands support non-interactive usage for CI pipelines:

# Setup without prompts
npx learnhouse setup --ci \
  --name production \
  --domain example.com \
  --port 80 \
  --admin-email admin@example.com \
  --admin-password secretpass123

# Update with auto-migration
npx learnhouse update --version 1.2.0 --migrate

# Update without migrations
npx learnhouse update --no-migrate

# Setup without starting services
npx learnhouse setup --ci --admin-password pass123 --no-start

Testing

# Unit tests (no Docker required)
bun run test

# E2E tests (requires Docker)
bun run test:e2e

# All tests
bun run test:all

Unit tests cover template generation (docker-compose, .env, nginx, caddyfile) and config store operations.

E2E tests run the full lifecycle with real Docker containers: setup → start → status → health → doctor → stop → restart. They use --ci mode to run without prompts.

Not yet tested:

Interactive commands (backup create/restore, env editor, shell, deployments scaling)
update with actual version swap between two published images
update --migrate with pending Alembic migrations
logs (streams indefinitely)
dev mode (requires full monorepo source)
Multi-installation discovery (findInstallDir with multiple ~/.learnhouse/* entries)
Error recovery (Docker daemon down, port conflicts, corrupted config)

License

GPL-3.0