codeharbor 0.1.23 → 0.1.24

package/README.md

@@ -200,6 +200,8 @@ PLAYWRIGHT_USE_SYSTEM_CHROME=false npm run test:e2e
 
 - `REQUIREMENTS.md`: current baseline + next-stage requirements
 - `TASK_LIST.md`: implementation task breakdown and status
+- `docs/USER_MANUAL_ZH.md`: Chinese user manual (installation, configuration, verification)
+- `docs/COMPLETE_CONFIGURATION_GUIDE.md`: end-to-end setup flow + full feature-to-config mapping
 - `docs/CONFIG_UI_DESIGN.md`: configuration UI MVP design
 - `docs/CONFIG_CATALOG.md`: consolidated configuration matrix (required/runtime/UI/effective timing)
 - `docs/ADMIN_STANDALONE_DEPLOY.md`: standalone admin deployment and Cloudflare Tunnel exposure guide
@@ -249,6 +251,7 @@ node dist/cli.js start
 Use this layered reference to avoid mixing boot-only and runtime tuning items:
 
 - [`docs/CONFIG_CATALOG.md`](docs/CONFIG_CATALOG.md)
+- [`docs/COMPLETE_CONFIGURATION_GUIDE.md`](docs/COMPLETE_CONFIGURATION_GUIDE.md)
 
 It documents:
 
@@ -256,6 +259,7 @@ It documents:
 - which keys can be edited in Admin UI
 - whether changes are immediate or restart-scoped
 - recommended profiles for local/internal/public deployment
+- a complete setup sequence from install to production operations
 
 ## Commands
 

package/dist/cli.js

@@ -7978,6 +7978,25 @@ var runtimeHome = null;
 var cliVersion = resolveCliVersion();
 var program = new import_commander.Command();
 program.name("codeharbor").description("Instant-messaging bridge for Codex CLI sessions").version(cliVersion);
+program.addHelpText(
+  "after",
+  [
+    "",
+    "Prerequisites:",
+    "  - codex CLI installed and authenticated (run: codex login)",
+    "  - Matrix bot credentials in .env: MATRIX_HOMESERVER, MATRIX_USER_ID, MATRIX_ACCESS_TOKEN",
+    "",
+    "Runtime:",
+    "  - default CODEHARBOR_HOME: ~/.codeharbor (legacy /opt/codeharbor/.env is auto-detected)",
+    "  - running without subcommand defaults to: codeharbor start",
+    "",
+    "Common commands:",
+    "  - codeharbor init",
+    "  - codeharbor doctor",
+    "  - codeharbor service install --with-admin",
+    "  - codeharbor admin serve --host 127.0.0.1 --port 8787"
+  ].join("\n")
+);
 program.command("init").description("Create or update .env via guided prompts").option("-f, --force", "overwrite existing .env without confirmation").action(async (options) => {
   const home = ensureRuntimeHomeOrExit();
   await runInitCommand({ force: options.force ?? false, cwd: home });
@@ -8014,6 +8033,33 @@ program.command("doctor").description("Check codex and matrix connectivity").act
 var admin = program.command("admin").description("Admin utilities");
 var configCommand = program.command("config").description("Config snapshot utilities");
 var serviceCommand = program.command("service").description("Systemd service management");
+admin.addHelpText(
+  "after",
+  [
+    "",
+    "Notes:",
+    "  - For non-loopback host binding, set ADMIN_TOKEN or ADMIN_TOKENS_JSON.",
+    "  - Admin UI routes: /settings/global, /settings/rooms, /health, /audit."
+  ].join("\n")
+);
+configCommand.addHelpText(
+  "after",
+  [
+    "",
+    "Examples:",
+    "  - codeharbor config export -o backup.json",
+    "  - codeharbor config import backup.json --dry-run"
+  ].join("\n")
+);
+serviceCommand.addHelpText(
+  "after",
+  [
+    "",
+    "Notes:",
+    "  - Service subcommands auto-elevate with sudo when required.",
+    "  - Use --with-admin to manage both main and admin services together."
+  ].join("\n")
+);
 admin.command("serve").description("Start admin config API server").option("--host <host>", "override admin bind host").option("--port <port>", "override admin bind port").option(
   "--allow-insecure-no-token",
   "allow serving admin API without ADMIN_TOKEN on non-loopback host (not recommended)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeharbor",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Instant-messaging bridge for Codex CLI sessions",
   "license": "MIT",
   "main": "dist/cli.js",