betterNAS/docs/repository-root/control.md

Control

This repo is the coordination and implementation ground for betterNAS.

Use it for:

• shared contracts
• architecture and planning docs
• runtime scripts
• stack verification
• implementation of the self-hosted stack

Current product focus

The default betterNAS product is:

• self-hosted on the user's NAS
• WebDAV-first
• Finder-mountable
• managed through a web control plane

The main parts are:

• node-service
  • apps/node-agent
• control-server
  • apps/control-plane
• web control plane
  • apps/web
• optional cloud adapter
  • apps/nextcloud-app

Rules

• shared interface changes land in packages/contracts first
• docs/architecture.md is the canonical architecture contract
• the self-hosted mount flow is the critical path
• optional Nextcloud work must not drive the main architecture

Command surface

• pnpm verify
  • static verification
• pnpm stack:up
  • boot the self-hosted stack
• pnpm stack:verify
  • verify the working stack
• pnpm stack:down --volumes
  • tear the stack down cleanly
• pnpm agent:verify
  • bootstrap, verify, boot, and stack-verify in one loop