@javierfrancoleal/dsh-supervisor 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,41 @@
-# Temporary Holding Version
+# @javierfrancoleal/dsh-supervisor
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Created by **J.Franco** — the central control plane of the J.Franco agentic
+workflow suite.
+
+## What it is
+
+A zero-dependency Node.js server that provides:
+
+- **User accounts** with free role labels and three permission levels
+  (Field / Supervisor / Owner) — one universal flow for every person.
+- **The live conversation flow**: START → listening → per-person summary
+  with confirm buttons → orders to the kitchen and the central system.
+- **The universal sector dashboard** (10 languages, dark mode, wallboard,
+  PWA panel) — one skeleton that changes skin per sector
+  (restaurant, hotel, clinic, pharmacy, workshop, real estate, school…).
+- **Telemetry**: reports, feedback, usage and cost, conversation trail.
+
+## Install and run
+
+```sh
+npm install -g @javierfrancoleal/dsh-supervisor   # Node >= 24
+
+jfranco-supervisor init --owner Maria --password s3cret \
+  --owner-label "Directora" \
+  --employee Ana --employee-password pw2 --employee-label "Mesera" \
+  --lead Luis --lead-password pw3 --lead-label "Cocinero"
+
+jfranco-supervisor --lan --https   # serves the dashboard and the panel
+```
+
+Then open `http://<this-computer-ip>:8787/dashboard`.
+
+## Pairing with the AI
+
+Run the DeepSeek Harness standby agent so the field conversation is decoded
+automatically (see the suite's `tools/agent-standby.sh`).
+
+## License
+
+MIT.

package/bin/jfranco-supervisor.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+// @javierfrancoleal/dsh-supervisor — launcher. Created by J.Franco.
+// Forwards every argument to the supervisor server with sane defaults:
+//   data dir: ~/.dsh/supervisor-data   ·   sector packs: the package's own
+const os = require("node:os");
+const path = require("node:path");
+process.env.DSH_SUPERVISOR_DATA =
+  process.env.DSH_SUPERVISOR_DATA || path.join(os.homedir(), ".dsh", "supervisor-data");
+process.env.DSH_SECTOR_PACKS_DIR =
+  process.env.DSH_SECTOR_PACKS_DIR || path.join(__dirname, "..", "sector-packs");
+require("../server.js");