development-engine-vector 0.3.0__tar.gz

development_engine_vector-0.3.0/.flake8

@@ -0,0 +1,5 @@
+[flake8]
+max-line-length = 150
+extend-ignore = E203
+per-file-ignores =
+    dev/ui/templates.py: E501

development_engine_vector-0.3.0/.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+dist/
+*.egg-info/
+__pycache__/
+*.pyc
+build/

development_engine_vector-0.3.0/PKG-INFO

@@ -0,0 +1,252 @@
+Metadata-Version: 2.4
+Name: development-engine-vector
+Version: 0.3.0
+Summary: Development Engine Vector — internal developer workflow CLI.
+Author-email: Ernie Butcher <ernie@fiosii.com>
+License-Expression: MIT
+Requires-Python: >=3.8
+Requires-Dist: click>=8.1
+Requires-Dist: tomli>=2.0
+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)
+[![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.
+
+`dev` is designed to be pointed at any goCosmix project directory and immediately useful: it reads project config, validates state, manages versions, and drives releases — without knowing anything specific about what the project does.
+
+## ✨ Key Capabilities
+
+- **Preflight checks**: version file, changelog entry, git state, dirty tree, sensitive files, pyproject sync
+- **CDA-aware preflight**: extended checks for vscode-ark-specific pipeline and daemon health
+- **Version management**: read, bump (major/minor/patch), sync to `pyproject.toml` and all tracked files
+- **Changelog automation**: structured CHANGELOG management with version section creation and entry validation
+- **Release orchestration**: full release workflow — preflight → version sync → build → git tag → publish
+- **Project bootstrap**: install editable package, requirements, and dev dependencies in one command
+- **Git/GitHub ops**: ensure remotes, create GitHub repos via API, push branches
+- **Self-check**: engine health validation — install path, DB state, tool dependencies, version consistency
+- **Config-driven**: per-project `.dev-cli.toml` for default bump level, skip flags, dry-run mode
+
+## 📋 Table of Contents
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [CLI Reference](#cli-reference)
+- [Configuration](#configuration)
+- [Architecture](#architecture)
+- [Development](#development)
+- [Contributing](#contributing)
+- [License](#license)
+
+## 🚀 Installation
+
+### Prerequisites
+
+- Python 3.9+
+
+### Install from PyPI
+
+```bash
+pip install dev-cli
+```
+
+> **macOS / system Python note**: pip installs the `dev` binary to `~/Library/Python/3.x/bin/` which may not be on `PATH` by default.
+>
+> ```bash
+> export PATH="$HOME/Library/Python/3.9/bin:$PATH"
+> ```
+>
+> Add this line to `~/.zprofile` for persistence.
+
+### Install from source
+
+```bash
+git clone https://github.com/goCosmix/dev.git
+cd dev/source
+pip install -e .
+```
+
+### Install development dependencies
+
+```bash
+pip install -e ".[dev]"
+```
+
+## ⚡ Quick Start
+
+```bash
+pip install dev-cli
+export PATH="$HOME/Library/Python/3.9/bin:$PATH"
+
+# 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
+```
+
+## 🔧 CLI Reference
+
+### `dev pf` / `dev preflight`
+
+Run pre-release preflight checks for a project.
+
+```bash
+dev pf --project <path>           # standard checks
+dev pf --project <path> --full    # full check set (includes CDA-specific)
+dev pf --project <path> --report report.json
+```
+
+Checks run: version file, changelog entry, git state (clean tree, committed), sensitive file exposure, pyproject.toml version sync.
+
+### `dev version`
+
+```bash
+dev version show   --project <path>              # print current version
+dev version bump   --project <path> --level patch  # bump major/minor/patch
+dev version sync   --project <path>              # sync version → pyproject.toml
+```
+
+### `dev release`
+
+Full release workflow: preflight → version bump → sync → build → git tag → publish.
+
+```bash
+dev release --project <path>
+dev release --project <path> --bump minor
+dev release --project <path> --version 2.1.0
+dev release --project <path> --skip-publish     # build + tag, don't push to PyPI
+dev release --project <path> --dry-run          # simulate, no writes
+```
+
+### `dev build`
+
+Build source and wheel distributions.
+
+```bash
+dev build --project <path>
+```
+
+### `dev sync`
+
+Bootstrap or re-sync project dependencies.
+
+```bash
+dev sync --project <path>
+dev sync --project <path> --install-dev         # also install dev dependencies
+dev sync --project <path> --no-install-editable # skip editable install
+```
+
+### `dev check`
+
+Project health checks: compile validation, lint, optional pytest.
+
+```bash
+dev check --project <path>
+dev check --project <path> --tests              # include pytest
+dev check --project <path> --lint               # include flake8
+dev check --project <path> --compile            # Python compile check
+```
+
+### `dev selfcheck`
+
+Engine self-diagnostics — validates the `dev` installation itself.
+
+```bash
+dev selfcheck
+```
+
+Checks: version consistency, install path, DB state, required tools on PATH, Python dependencies.
+
+### `dev config`
+
+```bash
+dev config show --project <path>    # display active config and resolved settings
+```
+
+## ⚙️ Configuration
+
+Add a `.dev-cli.toml` or `dev-cli.toml` at any project root:
+
+```toml
+[release]
+default_bump = "minor"
+skip_build = false
+skip_publish = false
+dry_run = false
+
+[bootstrap]
+install_editable = true
+install_dependencies = true
+install_dev_dependencies = false
+
+[check]
+compile = true
+tests = false
+lint = false
+```
+
+Override the config file path at runtime:
+
+```bash
+dev --config ./custom.dev-cli.toml release --project /Volumes/intel/systems/cda/source
+```
+
+## 🏗 Architecture
+
+`dev` is organized into four layers:
+
+```
+dev/
+├── kernel/       — runtime foundation (paths, DB, config, self-check)
+├── workflow/     — business logic (versioning, changelog, preflight, release)
+├── vcs/          — version control ops (git, GitHub API)
+└── cli/          — thin click wrappers
+```
+
+See [docs/architecture.md](docs/architecture.md) for the full design.
+
+## 🛠 Development
+
+```bash
+cd /Volumes/intel/systems/dev/source
+pip install -e .
+export PATH="$HOME/Library/Python/3.9/bin:$PATH"
+
+# Run checks
+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
+
+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
+```
+
+## 🤝 Contributing
+
+See [contributing.md](contributing.md).
+
+## 📄 License
+
+MIT — see [license](license).

development_engine_vector-0.3.0/changelog.md

@@ -0,0 +1,65 @@
+# Changelog
+
+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
+
+### Added
+- **Embedded web UI** — full WSGI dashboard on port 9001 (`dev ui start/stop/status/restart`)
+  - Pages: dashboard, runs, health, checks, manifest, identity, events, query
+  - Sidebar navigation with indigo accent theme; run detail drawer with 3 tabs (Overview, Output, Raw)
+  - Pure Python — zero npm, zero build step; CSS + JS bundled as Python string constants
+- **PMF kernel** (`dev/kernel/pmf_kernel.py`) — embedded process manager for background services
+  - `PMFKernel` class: start/stop/restart/status/tail_log with PID file tracking
+  - launchd integration: `install_launchd()` / `uninstall_launchd()` write `com.gocosmix.dev.plist` to `~/Library/LaunchAgents/`
+  - `wait_for_port_and_open_browser()` — polls server before opening browser
+- **`dev pmf` command group** — `services`, `status`, `start`, `stop`, `restart`, `logs`, `up`, `install`, `uninstall`
+- **`dev setup`** — full onboarding: init dirs → pmf install → ui up → open browser
+- **Self-provisioning** — `ensure_dirs()` fires on any real CLI command; no manual dir creation needed
+- **`tools/dev` home** — DEV_HOME moved to `~/Library/goCosmix/tools/dev` (tools tier, not apps)
+- **New runtime paths** in `paths.py`: `RUN_DIR`, `PMF_DIR`, `PMF_LOG_DIR`, `RUNTIME_FILE`, `UI_PID_FILE`, `DEFAULT_PORT`
+
+### Changed
+- Port changed from 10002 → **9001** (tools namespace; 9000 reserved for future tool orchestrator)
+- `--version` now reads from package metadata dynamically
+- `.flake8`: added `per-file-ignores` to allow long lines in `dev/ui/templates.py`
+
+## [0.2.1] - 2026-05-11
+
+### Fixed
+- **`check_sensitive_files`** — now uses `git check-ignore` to verify `.env` is gitignored rather than failing on existence alone; eliminates false-positive preflight failures on projects that correctly ignore `.env`
+
+## [0.2.0] - 2026-05-11
+
+### Added
+- **`create_github_repo()`** — GitHub API repo creation via personal access token loaded from `audit-engine/.env`
+- **`GitOps.ensure_remote()`** — creates GitHub repo and adds `origin` remote if not already configured
+- **`GitOps.push_main()`** — `set_upstream` flag enables `-u origin main` on first push
+- **`_load_github_token()` / `_github_api()`** — shared GitHub API primitives with token-from-env loading
+- **Updated `push_repos.py`** — full 10-repo list with auto-create-remote logic and CLI arg filtering
+
+## [0.1.0] - 2026-05-10
+
+### Added
+- Initial release of the Development Engine Vector (`dev-cli`)
+- **4-layer engine architecture**: `kernel/` (paths, DB, config, selfcheck) + `workflow/` (versioning, changelog, preflight, release) + `vcs/` (git, github) + `cli/` (click interface)
+- **`dev pf`** / **`dev preflight`** — pre-release preflight checks: version file, changelog entry, git state, sensitive file exposure, pyproject.toml version sync
+- **`dev version show/bump/sync`** — version management with sync to `pyproject.toml` and tracked files
+- **`dev release`** — full release orchestration: preflight → version sync → build → tag → publish; supports `--bump`, `--version`, `--skip-build`, `--skip-publish`, `--dry-run`
+- **`dev build`** — source and wheel distribution build via `python -m build`
+- **`dev sync`** — project bootstrap: editable install, requirements, dev dependencies
+- **`dev check`** — project health: compile validation, optional lint and pytest
+- **`dev selfcheck`** — engine self-diagnostics: version, install path, DB state, tool dependencies
+- **`dev config show`** — display active config and resolved settings
+- **`CdaPreflightModule`** — extended preflight checks for vscode-ark: pipeline stage validation, watcher state, daemon health, queue depth
+- **`DevConfig`** — TOML-based per-project config (`.dev-cli.toml` / `dev-cli.toml`); falls back gracefully if absent
+- **`VersionManager`** — reads/writes `version` file; bumps semver; syncs to `pyproject.toml`
+- **`ChangelogManager`** — reads, adds version sections, validates changelog entries
+- **`ReleaseOrchestrator`** — coordinates all release steps; records runs to `dev.db`
+- **`GitOps`** — git status, dirty check, tag, push, remote management
+- **`kernel.db`** — WAL-mode SQLite runtime DB: `runs` and `projects` tables
+- **`kernel.paths`** — `DEV_HOME` = `~/Library/goCosmix/apps/dev`; canonical path constants
+- **3-layer repo layout**: `source/` (tracked code) + `local/` (runtime state) + `control/` (management artifacts)

development_engine_vector-0.3.0/contributing.md

@@ -0,0 +1,174 @@
+# Contributing to Development Engine Vector
+
+We welcome contributions. This document provides guidelines for working on `dev-cli`.
+
+## Code of Conduct
+
+- Be respectful and constructive
+- Focus on ideas, not personal criticism
+- Support others in the community
+
+## Getting Started
+
+### Clone and setup
+
+```bash
+git clone https://github.com/goCosmix/dev.git
+cd dev/source
+```
+
+### Setup development environment
+
+```bash
+pip install -e ".[dev]"
+export PATH="$HOME/Library/Python/3.9/bin:$PATH"
+```
+
+### Create a feature branch
+
+```bash
+git checkout -b feature/your-feature-name
+```
+
+## Development Workflow
+
+### Making changes
+
+1. Make changes in your feature branch
+2. Add or update tests for new functionality
+3. Ensure all checks pass: `python3 ../control/scripts/vet.py`
+4. Run lint: `python3 -m flake8 dev/`
+5. Run type check: `python3 -m mypy dev/`
+
+### Writing tests
+
+- Place tests in `tests/` directory
+- Use descriptive names: `test_<feature>_<scenario>()`
+- Mock external dependencies (subprocess, filesystem)
+
+Example:
+
+```python
+def test_version_bump_increments_patch():
+    """Test that patch bump increments the third semver segment."""
+    vm = VersionManager(tmp_project_dir)
+    vm.write("1.2.3")
+    new_version = vm.bump("patch")
+    assert new_version == "1.2.4"
+```
+
+### Code style
+
+- Follow PEP 8; max line length 150 (see `.flake8`)
+- Use `Optional[X]` from `typing` — project targets Python 3.9
+- Use meaningful variable names
+- No docstrings required on private helpers
+
+## Commit guidelines
+
+- Use present tense: "Add feature" not "Added feature"
+- Keep commits focused and atomic
+- Reference issues when relevant: "Fix #42"
+
+## Pull request process
+
+1. **Update CHANGELOG** — add entry under the new version section
+2. **Add tests** — new functionality needs test coverage
+3. **Run vet** — `python3 control/scripts/vet.py` must exit 0
+4. **Create PR** — clear description of what changed and why
+5. **Respond to reviews** — address feedback promptly
+
+## Project structure
+
+```
+dev/
+├── .gitignore
+├── source/                  # all tracked code lives here
+│   ├── dev/                 # Python package
+│   │   ├── kernel/          # runtime foundation
+│   │   │   ├── paths.py     # DEV_HOME, path constants
+│   │   │   ├── db.py        # WAL SQLite — runs + projects
+│   │   │   ├── config.py    # DevConfig — reads .dev-cli.toml
+│   │   │   └── selfcheck.py # engine self-diagnostics
+│   │   ├── workflow/        # business logic
+│   │   │   ├── versioning.py
+│   │   │   ├── changelog.py
+│   │   │   ├── preflight.py
+│   │   │   ├── cda.py       # CDA-specific preflight module
+│   │   │   └── release.py
+│   │   ├── vcs/             # version control
+│   │   │   ├── git.py
+│   │   │   └── github.py
+│   │   └── cli/
+│   │       └── cli.py       # click entry point
+│   ├── tests/
+│   ├── docs/
+│   ├── pyproject.toml
+│   ├── changelog.md
+│   ├── 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
+```
+
+## Key components
+
+### CLI (`dev/cli/cli.py`)
+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`
+- `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
+
+### Workflow (`dev/workflow/`)
+- `versioning.py` — `VersionManager`: read, write, bump semver, sync to files
+- `changelog.py` — `ChangelogManager`: add version section, verify entry exists
+- `preflight.py` — `PreflightChecks`: runs all checks, generates optional JSON report
+- `cda.py` — `CdaPreflightModule`: CDA pipeline and daemon-specific checks
+- `release.py` — `ReleaseOrchestrator`: full release workflow, records runs to DB
+
+### VCS (`dev/vcs/`)
+- `git.py` — `GitOps`: status, dirty check, commit, tag, push, ensure remote
+- `github.py` — token-based GitHub API: create repo, manage remotes
+
+## Testing strategy
+
+```bash
+# Run all tests
+python3 -m pytest tests/ -q
+
+# Run with coverage
+python3 -m pytest tests/ --cov=dev
+
+# Run specific test
+python3 -m pytest tests/test_dev_cli.py::test_version_bump -v
+```
+
+## Release process
+
+1. Set version: `dev version bump --level patch --project .`
+2. Update `changelog.md` with release notes
+3. Run vet: `python3 control/scripts/vet.py`
+4. Release: `dev release --project . --dry-run` → then without `--dry-run`
+5. Or via control plane: `python3 control/scripts/push.py`
+
+## Additional resources
+
+- [Python Style Guide (PEP 8)](https://www.python.org/dev/peps/pep-0008/)
+- [Click Documentation](https://click.palletsprojects.com/)
+- [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
+- [Semantic Versioning](https://semver.org/)
+
+---
+
+Thank you for contributing to the Development Engine Vector.

development_engine_vector-0.3.0/dev/__init__.py

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

development_engine_vector-0.3.0/dev/__main__.py

@@ -0,0 +1,5 @@
+"""Allow `python -m dev` execution."""
+from dev.cli.cli import cli
+
+if __name__ == "__main__":
+    cli()