Harden production launch install path

Author: Ashish-dwi99

CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/), and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [6.2.0] - 2026-05-15 — Production launch hardening
+
+- Marked the public package metadata as `Development Status :: 5 -
+  Production/Stable` for the Product Hunt launch.
+- Fixed the release wheel so the bundled `engram_bus` handoff package is
+  actually included instead of being pruned from the source distribution.
+- Hardened `install.sh` with a verified handoff-bus check, a GitHub repair
+  fallback if PyPI is stale or broken, `DHEE_INSTALL_PACKAGE` for reproducible
+  installer smoke tests, and `DHEE_INIT_REPO` for non-interactive repo wire-up.
+- The installer now explicitly points new users at `dhee ui` after install so
+  they can open the local command center, folders canvas, and firewall without
+  hunting through docs.
+
 ## Unreleased — Developer Brain split
 
 - Public Dhee is now positioned and packaged as **Dhee Developer Brain**:

MANIFEST.in

@@ -1,7 +1,5 @@
 prune dhee/ui/web/node_modules
-prune dhee/ui
 prune enterprise
-prune engram-bus
 prune engram-bridge
 prune engram-enterprise
 prune engram-failure

README.md

@@ -8,6 +8,7 @@
 
 <p align="center">
   <a href="https://pypi.org/project/dhee"><img src="https://img.shields.io/pypi/v/dhee?style=flat-square&color=orange" alt="PyPI"></a>
+  <a href="https://github.com/Sankhya-AI/Dhee/releases"><img src="https://img.shields.io/badge/status-production--ready-brightgreen?style=flat-square" alt="Production ready"></a>
   <a href="https://pypi.org/project/dhee"><img src="https://img.shields.io/badge/python-3.9%2B-blue.svg?style=flat-square" alt="Python 3.9+"></a>
   <a href="https://github.com/Sankhya-AI/Dhee/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square" alt="MIT License"></a>
   <a href="benchmarks/longmemeval/"><img src="https://img.shields.io/badge/LongMemEval-R%401%2094.8%25-brightgreen.svg?style=flat-square" alt="LongMemEval R@1 94.8%"></a>
@@ -92,6 +93,10 @@ One command:
 curl -fsSL https://raw.githubusercontent.com/Sankhya-AI/Dhee/main/install.sh | sh
 ```
 
+The installer creates the managed local runtime, verifies the handoff bus, wires
+detected harnesses, and ends with the two commands most people need first:
+`cd /path/to/repo && dhee init` and `dhee ui`.
+
 Or via pip:
 
 ```bash

dhee/__init__.py

@@ -34,7 +34,7 @@
 # Default: CoreMemory (lightest, zero-config)
 Memory = CoreMemory
 
-__version__ = "6.1.0"
+__version__ = "6.2.0"
 __all__ = [
     # Memory classes
     "Engram",

install.sh

@@ -10,9 +10,13 @@
 #   4. Wires Claude Code (hooks + MCP + router) if available
 #   5. Runs `dhee onboard` — provider picker, API key paste,
 #      and optional git repo linking
+#   6. Shows `dhee ui` so the developer can inspect the local brain
 #
 # Non-interactive: pass DHEE_PROVIDER=openai DHEE_API_KEY=sk-... to skip
-# the prompts entirely (CI-friendly).
+# the prompts entirely (CI-friendly). Set DHEE_INIT_REPO=/path/to/repo to
+# wire a git repo non-interactively after install. Set
+# DHEE_INIT_SKIP_INGEST=1 for CI smoke tests that should link the repo without
+# calling an embedding provider.
 #
 # Requires: Python 3.9+  (Claude Code CLI optional)
 set -e
@@ -21,7 +25,9 @@ DHEE_HOME="$HOME/.dhee"
 VENV_DIR="$DHEE_HOME/.venv"
 BIN_DIR="$HOME/.local/bin"
 MIN_PYTHON="3.9"
-PACKAGE="dhee>=6.1.0"
+DEFAULT_PACKAGE="dhee>=6.2.0"
+PACKAGE="${DHEE_INSTALL_PACKAGE:-$DEFAULT_PACKAGE}"
+FALLBACK_PACKAGE="${DHEE_FALLBACK_PACKAGE:-git+https://github.com/Sankhya-AI/Dhee.git@main}"
 
 # --- Colors ---
 if [ -t 1 ]; then
@@ -35,6 +41,19 @@ warn()  { printf "${YELLOW}!${RESET} %s\n" "$1"; }
 error() { printf "${RED}x${RESET} %s\n" "$1" >&2; exit 1; }
 done_() { printf "${GREEN}✓${RESET} %s\n" "$1"; }
 
+pip_install_package() {
+    "$VENV_DIR/bin/pip" install --upgrade --force-reinstall --no-cache-dir "$1" -q
+}
+
+verify_handoff_bus() {
+    "$VENV_DIR/bin/python" - <<'PY' >/dev/null 2>&1
+from dhee.core.kernel import _get_bus
+
+bus = _get_bus()
+bus.close()
+PY
+}
+
 # --- OS check ---
 OS="$(uname -s)"
 case "$OS" in
@@ -73,20 +92,30 @@ fi
 
 # --- Install package ---
 "$VENV_DIR/bin/pip" install --upgrade pip -q 2>/dev/null
-"$VENV_DIR/bin/pip" install --upgrade --no-cache-dir "$PACKAGE" -q
-done_ "Installed dhee"
+if pip_install_package "$PACKAGE"; then
+    done_ "Installed dhee"
+else
+    if [ -n "${DHEE_INSTALL_PACKAGE:-}" ]; then
+        error "Could not install Dhee from DHEE_INSTALL_PACKAGE=$DHEE_INSTALL_PACKAGE"
+    fi
+    warn "PyPI install failed — trying the current GitHub release path"
+    command -v git >/dev/null 2>&1 || error "Git is required for the fallback installer. Install git, then rerun the command."
+    pip_install_package "$FALLBACK_PACKAGE" || error "Could not install Dhee from PyPI or GitHub fallback"
+    done_ "Installed dhee from GitHub fallback"
+fi
 
 # --- Verify bundled handoff bus ---
-if "$VENV_DIR/bin/python" - <<'PY' >/dev/null 2>&1
-from dhee.core.kernel import _get_bus
-
-bus = _get_bus()
-bus.close()
-PY
-then
+if verify_handoff_bus; then
     done_ "Cross-agent handoff bus ready"
 else
-    error "Dhee installed, but the bundled handoff bus failed to import. Please rerun the installer or report this build."
+    if [ -n "${DHEE_INSTALL_PACKAGE:-}" ]; then
+        error "Dhee installed, but the bundled handoff bus failed to import from DHEE_INSTALL_PACKAGE=$DHEE_INSTALL_PACKAGE"
+    fi
+    warn "PyPI package failed handoff-bus verification — repairing from GitHub"
+    command -v git >/dev/null 2>&1 || error "Git is required for the repair installer. Install git, then rerun the command."
+    pip_install_package "$FALLBACK_PACKAGE" || error "Dhee installed, but GitHub repair failed. Please report this installer output."
+    verify_handoff_bus || error "Dhee installed, but the bundled handoff bus still failed to import after repair."
+    done_ "Cross-agent handoff bus ready"
 fi
 
 # --- Symlink binaries ---
@@ -170,9 +199,23 @@ else
     fi
 fi
 
+if [ -n "${DHEE_INIT_REPO:-}" ]; then
+    info "Wiring git repo: ${DHEE_INIT_REPO}"
+    INIT_FLAGS=""
+    [ "${DHEE_INIT_SKIP_INGEST:-}" = "1" ] && INIT_FLAGS="$INIT_FLAGS --skip-ingest"
+    [ "${DHEE_INIT_SKIP_FIRST_LIGHT:-}" = "1" ] && INIT_FLAGS="$INIT_FLAGS --skip-first-light"
+    # shellcheck disable=SC2086 # intentional flag splitting for the small managed flag set above.
+    if "$VENV_DIR/bin/dhee" init "$DHEE_INIT_REPO" $INIT_FLAGS >/dev/null 2>&1; then
+        done_ "Repo wired into Dhee"
+    else
+        warn "Repo wire-up failed — run 'cd ${DHEE_INIT_REPO} && dhee init' manually for details"
+    fi
+fi
+
 # --- Done ---
 printf "\n${BOLD}${GREEN}Dhee is ready.${RESET}\n"
 printf "  Wire up a repo:  ${BOLD}cd /path/to/repo && dhee init${RESET}\n"
+printf "  Open the UI:     ${BOLD}dhee ui${RESET}   ${DIM}(local command center, folders canvas, firewall)${RESET}\n"
 printf "  Update later:    ${BOLD}dhee update${RESET}\n\n"
 printf "${DIM}  Status:    dhee status            (savings + brain health)${RESET}\n"
 printf "${DIM}  Recall:    dhee recall \"<query>\"   (your personal cross-repo brain)${RESET}\n"

pyproject.toml

@@ -4,17 +4,17 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dhee"
-version = "6.1.0"
+version = "6.2.0"
 description = "Dhee Developer Brain — local memory, handoff, and git-backed context for AI coding agents"
 readme = "README.md"
 requires-python = ">=3.9"
 license = {text = "MIT"}
 authors = [
     {name = "Sankhya AI Labs"}
 ]
-keywords = ["memory-layer", "cognition", "mcp", "self-evolving", "hyperagent", "ai", "agents", "plugin", "llm", "edge"]
+keywords = ["context-firewall", "developer-brain", "coding-agents", "mcp", "claude-code", "codex", "local-first", "memory-layer", "ai", "agents"]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",

tests/test_packaging.py

@@ -8,19 +8,23 @@
 
 def test_handoff_bus_is_bundled_not_external_dependency():
     pyproject = (ROOT / "pyproject.toml").read_text(encoding="utf-8")
+    manifest = (ROOT / "MANIFEST.in").read_text(encoding="utf-8")
 
     assert '"engram-bus>=' not in pyproject
     assert 'engram-bus = "engram_bus.server:main"' in pyproject
     assert "bus = []" in pyproject
 
     assert 'where = [".", "engram-bus"]' in pyproject
     assert 'include = ["dhee*", "engram*", "engram_bus*"]' in pyproject
+    assert "prune dhee/ui\n" not in manifest
+    assert "prune engram-bus" not in manifest
     assert '"dhee.ui*"' not in pyproject
     assert 'dhee-ui = "dhee.ui.cli:main"' in pyproject
     assert '"web/dist/*"' in pyproject
     assert '"web/dist/assets/*"' in pyproject
     assert '"web/src/components/canvas/*"' in pyproject
     assert (ROOT / "engram-bus" / "engram_bus" / "__init__.py").exists()
+    assert (ROOT / "engram-bus" / "engram_bus" / "bus.py").exists()
 
 
 def test_curl_installer_verifies_handoff_bus():
@@ -29,4 +33,11 @@ def test_curl_installer_verifies_handoff_bus():
     assert "Cross-agent handoff bus ready" in installer
     assert "from dhee.core.kernel import _get_bus" in installer
     assert "for bin_name in dhee dhee-mcp engram-bus" in installer
+    assert 'DEFAULT_PACKAGE="dhee>=6.2.0"' in installer
+    assert "DHEE_INSTALL_PACKAGE" in installer
+    assert "FALLBACK_PACKAGE" in installer
+    assert "DHEE_INIT_REPO" in installer
+    assert "DHEE_INIT_SKIP_INGEST" in installer
+    assert "Open the UI:" in installer
+    assert "dhee ui" in installer
     assert "dhee uninstall --yes" in installer