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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: development-engine-vector
-Version: 0.3.0
+Version: 0.5.0
 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,58 @@ 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 otk`
+
+Manage the **Ops Tool Kernel (OTK)** and background services/tasks.
+
+```bash
+dev otk services                              # list services/tasks and status
+dev otk status [service_id]                   # detailed status for one or all
+dev otk start ui                              # start daemon service
+dev otk start preflight --project <path>      # run preflight task service
+dev otk start vet                             # run control vet task service
+dev otk start build --project <path>          # run build task service
+dev otk start publish-check                   # run dry-run publish validation
+dev otk start release-dryrun --project <path> # run full dry-run release workflow
+dev otk stop ui                               # stop daemon service
+dev otk restart ui                            # restart daemon service
+dev otk logs vet --tail 100                   # tail service/task logs
+dev otk events --tail 20                      # inspect kernel event journal
+dev otk up                                    # start default runtime services
+dev otk install                               # register macOS LaunchAgent (auto-start)
+dev otk uninstall                             # remove LaunchAgent
+```
+
+`dev pmf ...` remains available as a legacy alias for backward compatibility.
+
+### `dev setup`
+
+Full onboarding wizard — run once after install.
+
+```bash
+dev setup                           # init dirs + otk install + ui start + open browser
+dev setup --no-browser              # same, skip browser
+dev setup --run-otk-chain           # also run the OTK preflight → vet chain
+```
+
+Steps:
+1. **Init** — create `~/Library/goCosmix/tools/dev/` and all runtime subdirs; patch `~/.zprofile` if `dev` is not on PATH
+2. **OTK install** — register `com.gocosmix.dev` LaunchAgent so `dev` starts automatically on every login
+3. **Up** — start the web UI via OTK kernel, open browser at `http://127.0.0.1:9001`
+4. **Phase 2** — optionally run `preflight → vet` against the dev source tree for a fresh post-setup validation pass
+
 ## ⚙️ Configuration
 
 Add a `.dev-cli.toml` or `dev-cli.toml` at any project root:
@@ -197,16 +257,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 (OTK kernel, shared core, paths, 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 +279,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.5.0}/changelog.md

@@ -5,7 +5,61 @@ 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.5.0] - 2026-05-11
+
+### Added
+- **Full UI expansion** — 7 new dashboard pages surfacing the entire `dev` command surface:
+  - **OTK** — live service/task table with Start / Stop / Restart controls per service
+  - **Selfcheck** — editable install path, DB state, tool availability, dependency status
+  - **Version** — version file vs package version, sync target map
+  - **Release** — release run history, registered project registry, one-click workflow buttons (Preflight, Vet, Build, Publish Check, Release Dry-Run)
+  - **Project** — project dir, config file, package/changelog sync state
+  - **Git** — branch, last tag, dirty state, remote URL, commits since tag
+  - **Setup** — DEV_HOME, launch agent install status, all runtime path table
+- New backend summary APIs: `/api/dev/selfcheck`, `/api/dev/version`, `/api/dev/changelog`, `/api/dev/git`, `/api/dev/project`, `/api/dev/release`, `/api/dev/setup`
+- Background action runner now distinguishes task vs daemon services: tasks run synchronously to completion and capture full output before updating action state
+- Navigation expanded with new groups: OTK under Core; Selfcheck/Version/Release under Config; Project/Git under Inventory; Setup under System
+
+## [0.4.1] - 2026-05-11
+
+### Added
+- Optional Phase 2 onboarding flow: `dev setup --run-otk-chain` runs the OTK preflight → vet task chain after startup
+- Dashboard now renders the OTK kernel brain directly on the default page:
+  - runtime service table
+  - recent kernel event feed
+- Added synchronous task execution support in the shared kernel core for onboarding and orchestration
+
+### Changed
+- Dashboard overview now includes kernel-state visibility in addition to vet stats
+- OTK task events are recorded in the runtime journal and surfaced through the UI
+
+## [0.4.0] - 2026-05-11
+
+### Added
+- **Ops Tool Kernel (OTK)** architecture for `dev`:
+  - `kernel_core.py` shared kernel base (service lifecycle, persistent runtime state, event journal)
+  - `otk_kernel.py` system-adapted kernel (daemon + task service catalog)
+  - `pmf_kernel.py` compatibility shim preserving PMF imports
+- New OTK task services: `preflight`, `vet`, `build`, `publish-check`, `release-dryrun`
+- New runtime events command: `dev otk events` (also available through legacy `dev pmf events`)
+- New web API endpoints for kernel state and actions:
+  - `GET /api/kernel/services`, `GET /api/kernel/status`, `GET /api/kernel/events`
+  - `POST /api/kernel/start`, `POST /api/kernel/stop`, `POST /api/kernel/restart`
+  - `GET /api/actions`, `GET /api/action/status`
+
+### Changed
+- LaunchAgent now calls `dev otk up` (legacy `dev pmf ...` remains as an alias)
+- `dev setup` language updated from PMF-first to OTK-first flow
+- Control data seed metadata updated for PyPI package name: `development-engine-vector`
+
+## [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.5.0}/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,10 @@ 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
+│   │   │   ├── kernel_core.py # shared kernel DNA (service lifecycle + events)
+│   │   │   ├── otk_kernel.py # Ops Tool Kernel (dev-specific services/tasks)
+│   │   │   ├── pmf_kernel.py # compatibility shim over OTK symbols
 │   │   │   ├── db.py        # WAL SQLite — runs + projects
 │   │   │   ├── config.py    # DevConfig — reads .dev-cli.toml
 │   │   │   └── selfcheck.py # engine self-diagnostics
@@ -99,6 +102,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 +118,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 +129,10 @@ 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`
+- `kernel_core.py` — shared kernel base (`ServiceSpec`, lifecycle, state persistence, event journal)
+- `otk_kernel.py` — `OTKKernel`: Ops Tool Kernel service/task catalog (`ui`, `preflight`, `vet`, `build`, `publish-check`, `release-dryrun`) and launchd integration
+- `pmf_kernel.py` — backward-compatible alias layer for existing PMF imports
 - `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.5.0}/dev/__init__.py

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