@damn-dev/cli 0.9.2-rc.1

package/README.md

@@ -0,0 +1,77 @@
+# @damn-dev/cli
+
+Self-hosted workspace OS for human + AI agent collaboration.
+
+## Install
+
+```sh
+npm install -g @damn-dev/cli
+```
+
+This installs the `damn-dev` command. Requires **Node.js 18+**.
+
+You will also need **OpenClaw** (the agent runtime):
+
+```sh
+npm install -g openclaw
+```
+
+## Quick start
+
+```sh
+damn-dev start --port 3001
+# open http://localhost:3001
+```
+
+The first run creates `~/.damn-dev/damn.db` and applies the Prisma schema.
+Subsequent starts skip schema setup unless the bundled schema has changed.
+
+## Commands
+
+```
+damn-dev start [--port N] [--foreground]
+damn-dev stop
+damn-dev --version
+damn-dev --help
+```
+
+- `--port N` — default `3001`
+- `--foreground` — run in the current terminal (useful for debugging / systemd units); otherwise the process detaches and writes to `~/.damn-dev/damn-dev.log`
+
+## Environment
+
+`damn-dev start` reads `~/.damn-dev/.env` (written by the installer). Relevant keys:
+
+- `DATABASE_URL` — defaults to `file:~/.damn-dev/damn.db`
+- `OPENCLAW_URL` — defaults to `http://localhost:18789`
+- `OPENCLAW_TOKEN` — required; generated by the installer
+- `BETTER_AUTH_SECRET` — required; generated by the installer
+- `DAMNDEV_OUTBOUND_SECRET` — required; generated by the installer
+
+## Files
+
+- `~/.damn-dev/` — database, logs, pidfile, config
+- `~/.openclaw/` — OpenClaw agent files
+- `~/openclaw-plugins/damndev/` — the damndev plugin (copied from this package at install time)
+
+## Upgrading
+
+From the app: **Settings → Update now** (the banner surfaces when `damn.dev/version.json` shows a newer release).
+
+From the CLI:
+
+```sh
+damn-dev stop
+npm install -g @damn-dev/cli@latest
+damn-dev start
+```
+
+## Links
+
+- Docs: https://damn.dev
+- Source: https://github.com/LethoDeter/damn-dev
+- Issues: https://github.com/LethoDeter/damn-dev/issues
+
+## License
+
+Apache-2.0

package/bin/damn-dev.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+// @damn-dev/cli — entry point. Dispatches to lib/cli.js.
+'use strict'
+require('../lib/cli.js').run(process.argv.slice(2))

package/lib/cli.js

@@ -0,0 +1,47 @@
+'use strict'
+
+function printHelp() {
+  const pkg = require('../package.json')
+  console.log(`damn-dev v${pkg.version} — self-hosted workspace OS for human + AI agent collaboration.
+
+Usage:
+  damn-dev start [--port N] [--foreground]   Start the damn.dev backend
+  damn-dev stop                              Stop the running backend
+  damn-dev --version | -v                    Print version
+  damn-dev --help    | -h                    Show this help
+
+Docs:  https://damn.dev
+`)
+}
+
+function run(args) {
+  const cmd = args[0]
+
+  if (!cmd || cmd === '-h' || cmd === '--help' || cmd === 'help') {
+    printHelp()
+    return
+  }
+
+  if (cmd === '-v' || cmd === '--version') {
+    require('./commands/version.js').run()
+    return
+  }
+
+  switch (cmd) {
+    case 'start':
+      require('./commands/start.js').run(args.slice(1))
+      return
+    case 'stop':
+      require('./commands/stop.js').run(args.slice(1))
+      return
+    case 'version':
+      require('./commands/version.js').run()
+      return
+    default:
+      console.error(`[damn.dev] Unknown command: ${cmd}`)
+      printHelp()
+      process.exit(1)
+  }
+}
+
+module.exports = { run }

package/lib/commands/start.js

@@ -0,0 +1,109 @@
+'use strict'
+const fs = require('node:fs')
+const path = require('node:path')
+const { spawn } = require('node:child_process')
+const dotenv = require('dotenv')
+
+const {
+  DAMN_DEV_DIR,
+  PID_FILE,
+  LOG_FILE,
+  BACKEND_ENTRY,
+  PRISMA_SCHEMA,
+} = require('../paths.js')
+const { runSetup, resolveDatabaseUrl } = require('../setup.js')
+
+function parseArgs(args) {
+  let port = process.env.PORT || '3001'
+  let foreground = false
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i]
+    if (a === '--port' || a === '-p') { port = args[++i]; continue }
+    if (a === '--foreground' || a === '-f') { foreground = true; continue }
+  }
+  return { port, foreground }
+}
+
+function loadEnvFile() {
+  const envPath = path.join(DAMN_DEV_DIR, '.env')
+  if (fs.existsSync(envPath)) {
+    const parsed = dotenv.parse(fs.readFileSync(envPath))
+    for (const [k, v] of Object.entries(parsed)) {
+      if (!(k in process.env)) process.env[k] = v
+    }
+  }
+}
+
+function alreadyRunning() {
+  if (!fs.existsSync(PID_FILE)) return false
+  try {
+    const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8').trim(), 10)
+    if (!pid) return false
+    process.kill(pid, 0)
+    return pid
+  } catch {
+    return false
+  }
+}
+
+function run(args) {
+  const { port, foreground } = parseArgs(args)
+
+  // Sanity-check the bundled runtime exists. Catches broken installs early.
+  if (!fs.existsSync(BACKEND_ENTRY)) {
+    console.error(`[damn.dev] Bundled backend not found at ${BACKEND_ENTRY}.`)
+    console.error('[damn.dev] This usually means the package was installed from a broken tarball.')
+    console.error('[damn.dev] Try: npm install -g @damn-dev/cli@latest')
+    process.exit(1)
+  }
+  if (!fs.existsSync(PRISMA_SCHEMA)) {
+    console.error(`[damn.dev] Prisma schema missing at ${PRISMA_SCHEMA}. Broken install.`)
+    process.exit(1)
+  }
+
+  loadEnvFile()
+  runSetup()
+
+  const existing = alreadyRunning()
+  if (existing) {
+    console.error(`[damn.dev] Already running (pid ${existing}). Run 'damn-dev stop' first.`)
+    process.exit(1)
+  }
+
+  const env = {
+    ...process.env,
+    PORT: String(port),
+    DATABASE_URL: resolveDatabaseUrl(),
+    // Backend resolves frontend via __dirname/../../frontend/dist — our bundle
+    // mirrors that layout inside runtime/, so no override needed.
+  }
+
+  if (foreground) {
+    console.log(`[damn.dev] Starting in foreground on port ${port}...`)
+    const child = spawn(process.execPath, [BACKEND_ENTRY], { env, stdio: 'inherit' })
+    fs.writeFileSync(PID_FILE, String(child.pid), 'utf-8')
+    child.on('exit', (code) => {
+      try { fs.unlinkSync(PID_FILE) } catch {}
+      process.exit(code || 0)
+    })
+    return
+  }
+
+  // Detached: spawn, write pidfile, exit parent.
+  const out = fs.openSync(LOG_FILE, 'a')
+  const err = fs.openSync(LOG_FILE, 'a')
+  const child = spawn(process.execPath, [BACKEND_ENTRY], {
+    env,
+    detached: true,
+    stdio: ['ignore', out, err],
+  })
+  child.unref()
+  fs.writeFileSync(PID_FILE, String(child.pid), 'utf-8')
+
+  console.log(`[damn.dev] Started on port ${port} (pid ${child.pid})`)
+  console.log(`[damn.dev]   Logs:  ${LOG_FILE}`)
+  console.log(`[damn.dev]   Stop:  damn-dev stop`)
+  console.log(`[damn.dev]   URL:   http://localhost:${port}`)
+}
+
+module.exports = { run }

package/lib/commands/stop.js

@@ -0,0 +1,49 @@
+'use strict'
+const fs = require('node:fs')
+const { PID_FILE } = require('../paths.js')
+
+function run() {
+  if (!fs.existsSync(PID_FILE)) {
+    console.log('[damn.dev] Not running (no pidfile).')
+    return
+  }
+
+  const pid = parseInt(fs.readFileSync(PID_FILE, 'utf-8').trim(), 10)
+  if (!pid) {
+    console.log('[damn.dev] Pidfile is empty — cleaning up.')
+    fs.unlinkSync(PID_FILE)
+    return
+  }
+
+  try {
+    process.kill(pid, 'SIGTERM')
+    // Give it 3 seconds to shut down gracefully before SIGKILL.
+    const deadline = Date.now() + 3000
+    const poll = () => {
+      try {
+        process.kill(pid, 0) // probe
+        if (Date.now() > deadline) {
+          try { process.kill(pid, 'SIGKILL') } catch {}
+          console.log(`[damn.dev] Force-killed pid ${pid}.`)
+          try { fs.unlinkSync(PID_FILE) } catch {}
+          return
+        }
+        setTimeout(poll, 100)
+      } catch {
+        console.log(`[damn.dev] Stopped (pid ${pid}).`)
+        try { fs.unlinkSync(PID_FILE) } catch {}
+      }
+    }
+    poll()
+  } catch (err) {
+    if (err.code === 'ESRCH') {
+      console.log('[damn.dev] Not running (stale pidfile) — cleaning up.')
+      try { fs.unlinkSync(PID_FILE) } catch {}
+    } else {
+      console.error('[damn.dev] Failed to stop:', err.message)
+      process.exit(1)
+    }
+  }
+}
+
+module.exports = { run }

package/lib/commands/version.js

@@ -0,0 +1,4 @@
+'use strict'
+const pkg = require('../../package.json')
+function run() { console.log(pkg.version) }
+module.exports = { run }

package/lib/paths.js

@@ -0,0 +1,34 @@
+'use strict'
+const path = require('node:path')
+const os = require('node:os')
+
+const HOME = os.homedir()
+const DAMN_DEV_DIR = path.join(HOME, '.damn-dev')
+const OPENCLAW_DIR = path.join(HOME, '.openclaw')
+const PID_FILE = path.join(DAMN_DEV_DIR, 'damn-dev.pid')
+const LOG_FILE = path.join(DAMN_DEV_DIR, 'damn-dev.log')
+const SCHEMA_MARKER = path.join(DAMN_DEV_DIR, '.schema-applied')
+
+// The "runtime" directory is a sibling of lib/ in the installed package.
+// Populated by scripts/bundle.sh at publish time.
+const RUNTIME_DIR = path.resolve(__dirname, '..', 'runtime')
+const BACKEND_DIR = path.join(RUNTIME_DIR, 'backend')
+const BACKEND_ENTRY = path.join(BACKEND_DIR, 'server.cjs')
+const PRISMA_DIR = path.join(BACKEND_DIR, 'prisma')
+const PRISMA_SCHEMA = path.join(PRISMA_DIR, 'schema.prisma')
+const PLUGIN_SRC = path.join(RUNTIME_DIR, 'plugins', 'damndev')
+
+module.exports = {
+  HOME,
+  DAMN_DEV_DIR,
+  OPENCLAW_DIR,
+  PID_FILE,
+  LOG_FILE,
+  SCHEMA_MARKER,
+  RUNTIME_DIR,
+  BACKEND_DIR,
+  BACKEND_ENTRY,
+  PRISMA_DIR,
+  PRISMA_SCHEMA,
+  PLUGIN_SRC,
+}

package/lib/setup.js

@@ -0,0 +1,69 @@
+'use strict'
+// First-run setup: ensure ~/.damn-dev/ exists, apply Prisma schema if the
+// sentinel marker is absent or schema.prisma has changed since last apply.
+// Idempotent — re-running `damn-dev start` never re-applies when up-to-date.
+
+const fs = require('node:fs')
+const path = require('node:path')
+const crypto = require('node:crypto')
+const { spawnSync } = require('node:child_process')
+
+const { DAMN_DEV_DIR, OPENCLAW_DIR, SCHEMA_MARKER, PRISMA_SCHEMA, PRISMA_DIR } = require('./paths.js')
+
+function fileHash(filePath) {
+  const buf = fs.readFileSync(filePath)
+  return crypto.createHash('sha256').update(buf).digest('hex')
+}
+
+function ensureDirectories() {
+  fs.mkdirSync(DAMN_DEV_DIR, { recursive: true })
+  fs.mkdirSync(OPENCLAW_DIR, { recursive: true })
+}
+
+function resolveDatabaseUrl() {
+  return process.env.DATABASE_URL || `file:${path.join(DAMN_DEV_DIR, 'damn.db')}`
+}
+
+function needsSchemaApply(currentSchemaHash) {
+  if (!fs.existsSync(SCHEMA_MARKER)) return true
+  try {
+    const recorded = fs.readFileSync(SCHEMA_MARKER, 'utf-8').trim()
+    return recorded !== currentSchemaHash
+  } catch {
+    return true
+  }
+}
+
+function applySchema() {
+  const schemaHash = fileHash(PRISMA_SCHEMA)
+  if (!needsSchemaApply(schemaHash)) return
+
+  console.log('[damn.dev] Applying database schema (first run or schema changed)...')
+
+  // Resolve the bundled prisma CLI binary.
+  const prismaBin = require.resolve('prisma/build/index.js')
+  const result = spawnSync(process.execPath, [prismaBin, 'db', 'push', '--skip-generate'], {
+    cwd: PRISMA_DIR,
+    env: {
+      ...process.env,
+      DATABASE_URL: resolveDatabaseUrl(),
+      PRISMA_SCHEMA_PATH: PRISMA_SCHEMA,
+    },
+    stdio: 'inherit',
+  })
+
+  if (result.status !== 0) {
+    console.error('[damn.dev] Prisma db push failed with exit code', result.status)
+    process.exit(1)
+  }
+
+  fs.writeFileSync(SCHEMA_MARKER, schemaHash, 'utf-8')
+  console.log('[damn.dev] Database schema applied.')
+}
+
+function runSetup() {
+  ensureDirectories()
+  applySchema()
+}
+
+module.exports = { runSetup, resolveDatabaseUrl }

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@damn-dev/cli",
+  "version": "0.9.2-rc.1",
+  "description": "damn.dev — self-hosted workspace OS for human + AI agent collaboration.",
+  "license": "Apache-2.0",
+  "homepage": "https://damn.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LethoDeter/damn-dev.git",
+    "directory": "packages/cli"
+  },
+  "bugs": "https://github.com/LethoDeter/damn-dev/issues",
+  "bin": {
+    "damn-dev": "./bin/damn-dev.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "runtime",
+    "scripts/postinstall.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@fastify/cors": "^9.0.0",
+    "@fastify/multipart": "^8.3.1",
+    "@fastify/static": "^7.0.4",
+    "@prisma/client": "^6.0.0",
+    "@trpc/server": "^11.0.0",
+    "adm-zip": "^0.5.16",
+    "archiver": "^7.0.1",
+    "better-auth": "^1.5.4",
+    "diff": "^8.0.4",
+    "dotenv": "^16.4.0",
+    "fastify": "^4.28.1",
+    "fastify-plugin": "^5.0.0",
+    "grammy": "^1.41.1",
+    "prisma": "^6.0.0",
+    "web-push": "^3.6.7",
+    "ws": "^8.18.0",
+    "yaml": "^2.8.2",
+    "zod": "^3.23.0"
+  },
+  "optionalDependencies": {
+    "node-pty": "^1.1.0"
+  },
+  "scripts": {
+    "bundle": "bash scripts/bundle.sh",
+    "prepack": "bash scripts/bundle.sh",
+    "postinstall": "node scripts/postinstall.js"
+  }
+}