development-engine-vector 0.3.0__tar.gz → 0.3.1__tar.gz

{development_engine_vector-0.3.0 → development_engine_vector-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: development-engine-vector
-Version: 0.3.0
+Version: 0.3.1
 Summary: Development Engine Vector — internal developer workflow CLI.
 Author-email: Ernie Butcher <ernie@fiosii.com>
 License-Expression: MIT
@@ -12,7 +12,7 @@ Description-Content-Type: text/markdown
 # Development Engine Vector
 
 [![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
-[![PyPI](https://img.shields.io/pypi/v/dev-cli.svg)](https://pypi.org/project/dev-cli)
+[![PyPI](https://img.shields.io/pypi/v/development-engine-vector.svg)](https://pypi.org/project/development-engine-vector)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 **Development Engine Vector** (`dev`) is the developer workflow coordination CLI for goCosmix systems. It provides a consistent, scriptable interface for preflight checks, version management, changelog automation, release orchestration, and git/GitHub operations — usable across every system in the federation.
@@ -51,10 +51,10 @@ Description-Content-Type: text/markdown
 ### Install from PyPI
 
 ```bash
-pip install dev-cli
+pip install development-engine-vector
 ```
 
-> **macOS / system Python note**: pip installs the `dev` binary to `~/Library/Python/3.x/bin/` which may not be on `PATH` by default.
+> **macOS / system Python note**: pip installs the `dev` binary to `~/Library/Python/3.9/bin/` which may not be on `PATH` by default.
 >
 > ```bash
 > export PATH="$HOME/Library/Python/3.9/bin:$PATH"
@@ -62,30 +62,38 @@ pip install dev-cli
 >
 > Add this line to `~/.zprofile` for persistence.
 
-### Install from source
+### First-time setup (recommended)
+
+After install, run the onboarding wizard — it creates your home directory, registers the macOS LaunchAgent, and opens the dashboard:
 
 ```bash
-git clone https://github.com/goCosmix/dev.git
-cd dev/source
-pip install -e .
+dev setup
 ```
 
-### Install development dependencies
+### Install from source
 
 ```bash
-pip install -e ".[dev]"
+git clone https://github.com/goCosmix/dev.git
+cd dev/source
+pip install -e .
 ```
 
 ## ⚡ Quick Start
 
 ```bash
-pip install dev-cli
+pip install development-engine-vector
 export PATH="$HOME/Library/Python/3.9/bin:$PATH"
 
+# Full onboarding (creates ~/Library/goCosmix/tools/dev/, registers launchd, opens UI)
+dev setup
+
+# Or just start the dashboard manually
+dev ui start
+
 # Point at any goCosmix project
-dev pf --project /Volumes/intel/systems/cda/source     # preflight check
-dev version show --project /Volumes/intel/systems/cda/source
-dev release --project /Volumes/intel/systems/cda/source --dry-run
+dev pf --project /path/to/project     # preflight check
+dev version show --project /path/to/project
+dev release --project /path/to/project --dry-run
 ```
 
 ## 🔧 CLI Reference
@@ -167,6 +175,48 @@ Checks: version consistency, install path, DB state, required tools on PATH, Pyt
 dev config show --project <path>    # display active config and resolved settings
 ```
 
+### `dev ui`
+
+Manage the embedded web dashboard (port 9001).
+
+```bash
+dev ui start                        # start dashboard, open browser
+dev ui start --no-browser           # start without opening browser
+dev ui stop                         # stop dashboard
+dev ui status                       # show pid, started time, log path
+dev ui restart                      # restart
+```
+
+### `dev pmf`
+
+Manage the embedded PMF kernel and background services.
+
+```bash
+dev pmf services                    # list all services and status
+dev pmf status [service_id]         # detailed status for one or all services
+dev pmf start ui                    # start a service
+dev pmf stop ui                     # stop a service
+dev pmf restart ui                  # restart a service
+dev pmf logs ui [--tail 50]         # tail service log
+dev pmf up                          # start all services (called by launchd on login)
+dev pmf install                     # register macOS LaunchAgent (auto-start on login)
+dev pmf uninstall                   # remove LaunchAgent
+```
+
+### `dev setup`
+
+Full onboarding wizard — run once after install.
+
+```bash
+dev setup                           # init dirs + pmf install + ui start + open browser
+dev setup --no-browser              # same, skip browser
+```
+
+Steps:
+1. **Init** — create `~/Library/goCosmix/tools/dev/` and all runtime subdirs; patch `~/.zprofile` if `dev` is not on PATH
+2. **PMF install** — register `com.gocosmix.dev` LaunchAgent so `dev` starts automatically on every login
+3. **Up** — start the web UI via PMF kernel, open browser at `http://127.0.0.1:9001`
+
 ## ⚙️ Configuration
 
 Add a `.dev-cli.toml` or `dev-cli.toml` at any project root:
@@ -197,16 +247,19 @@ dev --config ./custom.dev-cli.toml release --project /Volumes/intel/systems/cda/
 
 ## 🏗 Architecture
 
-`dev` is organized into four layers:
+`dev` is organized into five layers:
 
 ```
 dev/
-├── kernel/       — runtime foundation (paths, DB, config, self-check)
+├── kernel/       — runtime foundation (paths, PMF kernel, DB, config, self-check)
 ├── workflow/     — business logic (versioning, changelog, preflight, release)
 ├── vcs/          — version control ops (git, GitHub API)
+├── ui/           — embedded WSGI dashboard (port 9001, indigo theme)
 └── cli/          — thin click wrappers
 ```
 
+Runtime home: `~/Library/goCosmix/tools/dev/` (tools tier — `9000` namespace)
+
 See [docs/architecture.md](docs/architecture.md) for the full design.
 
 ## 🛠 Development
@@ -216,31 +269,24 @@ cd /Volumes/intel/systems/dev/source
 pip install -e .
 export PATH="$HOME/Library/Python/3.9/bin:$PATH"
 
-# Run checks
+# Run all checks (lint + typecheck + tests)
+python3 /Volumes/intel/systems/dev/control/scripts/vet.py
+
+# Or individually
 python3 -m flake8 dev/
 python3 -m mypy dev/
 python3 -m pytest tests/ -q
-
-# Or via the control plane
-python3 ../control/scripts/vet.py
-python3 ../control/cli.py health
 ```
 
 ### Control plane
 
-```bash
-python3 control/cli.py --help
+The control plane manages the `dev` system itself (not for managing other projects).
 
-dev-control status        # version, paths, DB state
-dev-control vet           # run lint + typecheck + tests, write history to DB
-dev-control health        # show vet run history
-dev-control health --checks  # list defined check definitions
-dev-control push          # build + publish to PyPI
-dev-control seed          # re-seed control.db
-dev-control selfcheck     # engine self-diagnostics
-dev-control runs          # show run history from dev.db
-dev-control projects      # show registered projects
-dev-control manifest      # query file manifest from control.db
+```bash
+# Vet, seed, and publish
+python3 /Volumes/intel/systems/dev/control/scripts/vet.py    # lint + typecheck + tests
+python3 /Volumes/intel/systems/dev/control/scripts/seed.py   # re-seed control.db
+python3 /Volumes/intel/systems/dev/control/scripts/push.py   # vet + git push + PyPI publish
 ```
 
 ## 🤝 Contributing

{development_engine_vector-0.3.0 → development_engine_vector-0.3.1}/changelog.md

@@ -5,7 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.3.0] - 2026-05-12
+## [0.3.1] - 2026-05-11
+
+### Changed
+- PyPI package renamed from `dev-cli` (taken) to **`development-engine-vector`** — matching the `code-data-ark` naming convention
+- `--version` now resolves from `development-engine-vector` package metadata
+- Docs updated: readme, architecture, contributing — correct DEV_HOME path (`tools/dev`), port 9001, `ui`/`pmf`/`setup` command reference, `ui/` layer in architecture diagram
+
+## [0.3.0] - 2026-05-11
 
 ### Added
 - **Embedded web UI** — full WSGI dashboard on port 9001 (`dev ui start/stop/status/restart`)

{development_engine_vector-0.3.0 → development_engine_vector-0.3.1}/contributing.md

@@ -1,6 +1,6 @@
 # Contributing to Development Engine Vector
 
-We welcome contributions. This document provides guidelines for working on `dev-cli`.
+We welcome contributions. This document provides guidelines for working on `development-engine-vector`.
 
 ## Code of Conduct
 
@@ -20,7 +20,7 @@ cd dev/source
 ### Setup development environment
 
 ```bash
-pip install -e ".[dev]"
+pip install -e .
 export PATH="$HOME/Library/Python/3.9/bin:$PATH"
 ```
 
@@ -86,7 +86,8 @@ dev/
 ├── source/                  # all tracked code lives here
 │   ├── dev/                 # Python package
 │   │   ├── kernel/          # runtime foundation
-│   │   │   ├── paths.py     # DEV_HOME, path constants
+│   │   │   ├── paths.py     # DEV_HOME = ~/Library/goCosmix/tools/dev
+│   │   │   ├── pmf_kernel.py # PMFKernel, launchd integration (port 9001)
 │   │   │   ├── db.py        # WAL SQLite — runs + projects
 │   │   │   ├── config.py    # DevConfig — reads .dev-cli.toml
 │   │   │   └── selfcheck.py # engine self-diagnostics
@@ -99,6 +100,13 @@ dev/
 │   │   ├── vcs/             # version control
 │   │   │   ├── git.py
 │   │   │   └── github.py
+│   │   ├── ui/              # embedded WSGI dashboard (port 9001)
+│   │   │   ├── web.py
+│   │   │   ├── routes.py
+│   │   │   ├── templates.py
+│   │   │   ├── actions.py
+│   │   │   ├── static/      # web.css (indigo theme), web.js
+│   │   │   └── db/          # per-page query modules
 │   │   └── cli/
 │   │       └── cli.py       # click entry point
 │   ├── tests/
@@ -108,15 +116,9 @@ dev/
 │   ├── readme.md
 │   └── version
 ├── local/                   # runtime state (gitignored)
-│   ├── data/                # dev.db lives at ~/Library/goCosmix/apps/dev/
-│   └── logs/
 └── control/                 # management artifacts (gitignored)
-    ├── cli.py               # dev-control CLI
-    ├── ops.py               # reusable status helpers
     ├── data/                # control.db
-    ├── scripts/             # seed.py, vet.py, push.py
-    ├── audit/               # audit engine output JSONs
-    └── docs/                # control system documentation
+    └── scripts/             # seed.py, vet.py, push.py
 ```
 
 ## Key components
@@ -125,7 +127,8 @@ dev/
 Thin click wrappers. All logic delegates to `workflow/` and `vcs/` modules.
 
 ### Kernel (`dev/kernel/`)
-- `paths.py` — canonical path constants; `DEV_HOME = ~/Library/goCosmix/apps/dev`
+- `paths.py` — canonical path constants; `DEV_HOME = ~/Library/goCosmix/tools/dev`
+- `pmf_kernel.py` — `PMFKernel`: start/stop/restart/status for background services; `install_launchd` / `uninstall_launchd` for `com.gocosmix.dev` LaunchAgent
 - `db.py` — WAL SQLite; `record_run`, `finish_run`, `upsert_project`, `get_recent_runs`
 - `config.py` — loads `.dev-cli.toml` / `dev-cli.toml` from project root
 - `selfcheck.py` — five checks: version, install path, DB, tools, dependencies

{development_engine_vector-0.3.0 → development_engine_vector-0.3.1}/dev/__init__.py

@@ -1,3 +1,3 @@
 """dev — Development Engine Vector."""
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"

{development_engine_vector-0.3.0 → development_engine_vector-0.3.1}/docs/architecture.md

@@ -35,12 +35,13 @@ The kernel provides the shared infrastructure all other layers depend on.
 
 | Module | Responsibility |
 |---|---|
-| `paths.py` | `DEV_HOME`, `DATA_DIR`, `LOG_DIR`, `DB_PATH`, `ensure_dirs()` |
+| `paths.py` | `DEV_HOME`, `DATA_DIR`, `RUN_DIR`, `LOG_DIR`, `PMF_DIR`, `DB_PATH`, `UI_PID_FILE`, `DEFAULT_PORT`, `ensure_dirs()` |
 | `db.py` | WAL SQLite runtime DB — `runs` + `projects` tables; `record_run`, `finish_run`, `upsert_project` |
 | `config.py` | Loads `.dev-cli.toml` / `dev-cli.toml` from project root via TOML parser |
 | `selfcheck.py` | Five checks: version consistency, install path, DB integrity, tools on PATH, Python deps |
+| `pmf_kernel.py` | `PMFKernel` process manager; `install_launchd` / `uninstall_launchd` for `com.gocosmix.dev` LaunchAgent |
 
-**DEV_HOME** resolves to `~/Library/goCosmix/apps/dev` on macOS. The runtime DB lives there.
+**DEV_HOME** resolves to `~/Library/goCosmix/tools/dev` on macOS (tools tier — port 9001; 9000 reserved for future tool orchestrator). The runtime DB lives at `DEV_HOME/data/dev.db`.
 
 ### `workflow/` — Business Logic
 
@@ -74,6 +75,22 @@ CDA-extended checks (via `--full`):
 - Queue depth
 - Session analysis freshness
 
+### `ui/` — Embedded Dashboard
+
+A self-contained WSGI application served on port 9001 (tools namespace). Zero npm, zero build step — CSS and JS are bundled as Python string constants.
+
+| Module | Responsibility |
+|---|---|
+| `web.py` | `start_server(host, port=9001)` — `WSGIServer` with `SO_REUSEADDR` |
+| `routes.py` | WSGI app; routes all API endpoints and serves the SPA shell |
+| `templates.py` | `INDEX_HTML` shell; `PAGE_REGISTRY_JS` — page render functions |
+| `actions.py` | Background task execution (`vet`); `ACTION_STATE` tracker |
+| `static/web.css` | Indigo accent theme (`--accent: #6366f1`) |
+| `static/web.js` | Page init functions; run drawer; tab switching |
+| `db/` | Per-page DB query modules: overview, runs, health, checks, manifest, identity, events |
+
+**API endpoints**: `GET /`, `/api/overview`, `/api/runs`, `/api/run`, `/api/health`, `/api/checks`, `/api/manifest`, `/api/identity`, `/api/events`; `POST /api/action`, `/api/query`
+
 ### `vcs/` — Version Control
 
 | Module | Key class | Responsibility |
@@ -82,7 +99,7 @@ CDA-extended checks (via `--full`):
 | `github.py` | — | `create_github_repo()`, `_github_api()`, token loading from `.env` |
 
 `GitOps.ensure_remote()` creates the GitHub repo via API and sets `origin` if absent.
-Token is loaded from `systems/audit/.env` (`GITHUB_TOKEN`).
+Token is loaded from `/Volumes/intel/.env` (`GITHUB_TOKEN`).
 
 ### `cli/` — Click Interface
 

{development_engine_vector-0.3.0 → development_engine_vector-0.3.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "development-engine-vector"
-version = "0.3.0"
+version = "0.3.1"
 description = "Development Engine Vector — internal developer workflow CLI."
 readme = "readme.md"
 requires-python = ">=3.8"

{development_engine_vector-0.3.0 → development_engine_vector-0.3.1}/readme.md

@@ -1,7 +1,7 @@
 # Development Engine Vector
 
 [![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
-[![PyPI](https://img.shields.io/pypi/v/dev-cli.svg)](https://pypi.org/project/dev-cli)
+[![PyPI](https://img.shields.io/pypi/v/development-engine-vector.svg)](https://pypi.org/project/development-engine-vector)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 **Development Engine Vector** (`dev`) is the developer workflow coordination CLI for goCosmix systems. It provides a consistent, scriptable interface for preflight checks, version management, changelog automation, release orchestration, and git/GitHub operations — usable across every system in the federation.
@@ -40,10 +40,10 @@
 ### Install from PyPI
 
 ```bash
-pip install dev-cli
+pip install development-engine-vector
 ```
 
-> **macOS / system Python note**: pip installs the `dev` binary to `~/Library/Python/3.x/bin/` which may not be on `PATH` by default.
+> **macOS / system Python note**: pip installs the `dev` binary to `~/Library/Python/3.9/bin/` which may not be on `PATH` by default.
 >
 > ```bash
 > export PATH="$HOME/Library/Python/3.9/bin:$PATH"
@@ -51,30 +51,38 @@ pip install dev-cli
 >
 > Add this line to `~/.zprofile` for persistence.
 
-### Install from source
+### First-time setup (recommended)
+
+After install, run the onboarding wizard — it creates your home directory, registers the macOS LaunchAgent, and opens the dashboard:
 
 ```bash
-git clone https://github.com/goCosmix/dev.git
-cd dev/source
-pip install -e .
+dev setup
 ```
 
-### Install development dependencies
+### Install from source
 
 ```bash
-pip install -e ".[dev]"
+git clone https://github.com/goCosmix/dev.git
+cd dev/source
+pip install -e .
 ```
 
 ## ⚡ Quick Start
 
 ```bash
-pip install dev-cli
+pip install development-engine-vector
 export PATH="$HOME/Library/Python/3.9/bin:$PATH"
 
+# Full onboarding (creates ~/Library/goCosmix/tools/dev/, registers launchd, opens UI)
+dev setup
+
+# Or just start the dashboard manually
+dev ui start
+
 # Point at any goCosmix project
-dev pf --project /Volumes/intel/systems/cda/source     # preflight check
-dev version show --project /Volumes/intel/systems/cda/source
-dev release --project /Volumes/intel/systems/cda/source --dry-run
+dev pf --project /path/to/project     # preflight check
+dev version show --project /path/to/project
+dev release --project /path/to/project --dry-run
 ```
 
 ## 🔧 CLI Reference
@@ -156,6 +164,48 @@ Checks: version consistency, install path, DB state, required tools on PATH, Pyt
 dev config show --project <path>    # display active config and resolved settings
 ```
 
+### `dev ui`
+
+Manage the embedded web dashboard (port 9001).
+
+```bash
+dev ui start                        # start dashboard, open browser
+dev ui start --no-browser           # start without opening browser
+dev ui stop                         # stop dashboard
+dev ui status                       # show pid, started time, log path
+dev ui restart                      # restart
+```
+
+### `dev pmf`
+
+Manage the embedded PMF kernel and background services.
+
+```bash
+dev pmf services                    # list all services and status
+dev pmf status [service_id]         # detailed status for one or all services
+dev pmf start ui                    # start a service
+dev pmf stop ui                     # stop a service
+dev pmf restart ui                  # restart a service
+dev pmf logs ui [--tail 50]         # tail service log
+dev pmf up                          # start all services (called by launchd on login)
+dev pmf install                     # register macOS LaunchAgent (auto-start on login)
+dev pmf uninstall                   # remove LaunchAgent
+```
+
+### `dev setup`
+
+Full onboarding wizard — run once after install.
+
+```bash
+dev setup                           # init dirs + pmf install + ui start + open browser
+dev setup --no-browser              # same, skip browser
+```
+
+Steps:
+1. **Init** — create `~/Library/goCosmix/tools/dev/` and all runtime subdirs; patch `~/.zprofile` if `dev` is not on PATH
+2. **PMF install** — register `com.gocosmix.dev` LaunchAgent so `dev` starts automatically on every login
+3. **Up** — start the web UI via PMF kernel, open browser at `http://127.0.0.1:9001`
+
 ## ⚙️ Configuration
 
 Add a `.dev-cli.toml` or `dev-cli.toml` at any project root:
@@ -186,16 +236,19 @@ dev --config ./custom.dev-cli.toml release --project /Volumes/intel/systems/cda/
 
 ## 🏗 Architecture
 
-`dev` is organized into four layers:
+`dev` is organized into five layers:
 
 ```
 dev/
-├── kernel/       — runtime foundation (paths, DB, config, self-check)
+├── kernel/       — runtime foundation (paths, PMF kernel, DB, config, self-check)
 ├── workflow/     — business logic (versioning, changelog, preflight, release)
 ├── vcs/          — version control ops (git, GitHub API)
+├── ui/           — embedded WSGI dashboard (port 9001, indigo theme)
 └── cli/          — thin click wrappers
 ```
 
+Runtime home: `~/Library/goCosmix/tools/dev/` (tools tier — `9000` namespace)
+
 See [docs/architecture.md](docs/architecture.md) for the full design.
 
 ## 🛠 Development
@@ -205,31 +258,24 @@ cd /Volumes/intel/systems/dev/source
 pip install -e .
 export PATH="$HOME/Library/Python/3.9/bin:$PATH"
 
-# Run checks
+# Run all checks (lint + typecheck + tests)
+python3 /Volumes/intel/systems/dev/control/scripts/vet.py
+
+# Or individually
 python3 -m flake8 dev/
 python3 -m mypy dev/
 python3 -m pytest tests/ -q
-
-# Or via the control plane
-python3 ../control/scripts/vet.py
-python3 ../control/cli.py health
 ```
 
 ### Control plane
 
-```bash
-python3 control/cli.py --help
+The control plane manages the `dev` system itself (not for managing other projects).
 
-dev-control status        # version, paths, DB state
-dev-control vet           # run lint + typecheck + tests, write history to DB
-dev-control health        # show vet run history
-dev-control health --checks  # list defined check definitions
-dev-control push          # build + publish to PyPI
-dev-control seed          # re-seed control.db
-dev-control selfcheck     # engine self-diagnostics
-dev-control runs          # show run history from dev.db
-dev-control projects      # show registered projects
-dev-control manifest      # query file manifest from control.db
+```bash
+# Vet, seed, and publish
+python3 /Volumes/intel/systems/dev/control/scripts/vet.py    # lint + typecheck + tests
+python3 /Volumes/intel/systems/dev/control/scripts/seed.py   # re-seed control.db
+python3 /Volumes/intel/systems/dev/control/scripts/push.py   # vet + git push + PyPI publish
 ```
 
 ## 🤝 Contributing

development_engine_vector-0.3.1/version

@@ -0,0 +1 @@
+0.3.1

development_engine_vector-0.3.0/version

@@ -1 +0,0 @@
-0.3.0