development-engine-vector 0.3.0__py3-none-any.whl

dev/workflow/versioning.py

@@ -0,0 +1,87 @@
+"""Version management and syncing."""
+
+import re
+from pathlib import Path
+from dev.utils import error, success
+
+
+class VersionManager:
+    """Manages version numbers across a project."""
+
+    VERSION_PATTERN = r"\d+\.\d+\.\d+"
+
+    def __init__(self, project_dir):
+        self.project_dir = Path(project_dir).resolve()
+        self.version_file = self.project_dir / "version"
+
+        if not self.version_file.exists():
+            error(f"version file not found: {self.version_file}")
+
+    def read(self):
+        """Read current version."""
+        text = self.version_file.read_text().strip()
+        if not re.fullmatch(self.VERSION_PATTERN, text):
+            error(f"Invalid version format in version file: {text}")
+        return text
+
+    def write(self, version):
+        """Write new version."""
+        if not re.fullmatch(self.VERSION_PATTERN, version):
+            error(f"Invalid version format: {version}")
+        self.version_file.write_text(f"{version}\n")
+
+    def bump(self, level):
+        """Bump version (major, minor, or patch)."""
+        current = self.read()
+        major, minor, patch = map(int, current.split("."))
+
+        if level == "major":
+            major += 1
+            minor = 0
+            patch = 0
+        elif level == "minor":
+            minor += 1
+            patch = 0
+        elif level == "patch":
+            patch += 1
+        else:
+            error(f"Invalid bump level: {level}")
+
+        new_version = f"{major}.{minor}.{patch}"
+        return new_version
+
+    def sync_to_files(self, version, target_files):
+        """Sync version to multiple files.
+
+        Args:
+            version: Version string (e.g. "2.0.0")
+            target_files: Dict mapping file paths to patterns
+                         {'/path/file.py': r'(__version__ = ")X.Y.Z(")'}
+        """
+        for filepath, pattern in target_files.items():
+            path = self.project_dir / filepath
+            if not path.exists():
+                error(f"File not found: {path}")
+
+            text = path.read_text()
+            # Replace version in pattern, preserving groups
+            new_text = re.sub(
+                pattern.replace("X.Y.Z", self.VERSION_PATTERN),
+                lambda m: m.group(1) + version + m.group(2),
+                text,
+                flags=re.MULTILINE,
+            )
+
+            if new_text == text:
+                error(f"Pattern not found or no change in: {path}")
+
+            path.write_text(new_text)
+            success(f"Updated {filepath} to {version}")
+
+    def get_sync_targets(self):
+        """Return standard sync target patterns for common files."""
+        return {
+            "pyproject.toml": r'(^version\s*=\s*")' + self.VERSION_PATTERN + r'(")',
+            "setup.py": r'(\s*version\s*=\s*")' + self.VERSION_PATTERN + r'(",)',
+            "vscode_ark/__init__.py": r'(\s*__version__\s*=\s*")' + self.VERSION_PATTERN + r'(")',
+        }

development_engine_vector-0.3.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,41 @@
+dev/__init__.py,sha256=fXSn40zGxzcODNjKCvOLkYXC8vGULDZvPbKmAseoTec,64
+dev/__main__.py,sha256=6mqulF3fT-c2VOCHizGjph4RZOml96d6M27MdDwsxbY,105
+dev/utils.py,sha256=9y_QSfAXQGWM8LO-L8iO-333DVPHmLJK7PsNxR3BCSs,1817
+dev/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dev/cli/cli.py,sha256=fXf0I9afD7mzZ8BZfI0f9DWHm_r-LLZMu_wOygrrBe0,24892
+dev/kernel/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dev/kernel/config.py,sha256=Fgb7jmCL63fjObwCCEaHcL3hBedl4qwcu7d0lDs9wnc,1487
+dev/kernel/db.py,sha256=bH59wCsHqOvSRI0caAedyBtWeZmHfKJtXDzmDggrmxc,4318
+dev/kernel/paths.py,sha256=ccYMqHx0BwQqdLlHRAf5EZvEkyNeCYaxqCKFmfYfo5c,2832
+dev/kernel/pmf_kernel.py,sha256=bIGUyuPRRWlf6IlFRA5-fdKWbx9i9GeZqlhlBfLPLl8,13896
+dev/kernel/selfcheck.py,sha256=dtHEDUCEDgvHvwVVAYazcjdjdUwUZ0naj6JQkeIx1pA,5186
+dev/ui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dev/ui/actions.py,sha256=yqm0gw9U45DiqFmUuCoIcqM4vpdmccaee_XRN0Gg26U,1587
+dev/ui/routes.py,sha256=eQ_juy3_n9sJLE9GSmmcJW-EBeD8Dpzsx68Hl6PzKHs,4435
+dev/ui/templates.py,sha256=OHJewoOfwoclv11ZsoHu3R1zj_thr7aArD3TrSWd1WU,8501
+dev/ui/web.py,sha256=ycJ8_H0FQx3Muz_kMhYvkDn8gkpM6pVxMImrUZtXVtU,741
+dev/ui/db/__init__.py,sha256=WweOUt326t1BZNqoO3b_NC7xwijhz9I70gWvVJU_0-w,627
+dev/ui/db/base.py,sha256=fbQoMFyVWQDG0UHSmVFRL5bzuM0NlC1qyJZnHe2IIYA,2090
+dev/ui/db/checks.py,sha256=xBezjAE2iwYGycrjsAyMvJAZ9zmeu87CLUhkLNMYAEQ,451
+dev/ui/db/events.py,sha256=dwIR_7dFeud9mP_WLLhwGgFnHxzX8Ew_WWHbUCHXcfM,463
+dev/ui/db/health.py,sha256=JiTbijCIbduq2W3nM2NPIw4mvwx-ng0-VBvzCG_ZCGY,1196
+dev/ui/db/identity.py,sha256=-jbFPFXXdx8Vo9Yzef61pxCNHgK-u4OdJ1JOBNgY2qk,357
+dev/ui/db/manifest.py,sha256=P57d2q_V9Clm1RPdogmrmxS3B_QTXKB-aky8PRA186o,1330
+dev/ui/db/overview.py,sha256=Jjp2oPp6MVK6rq0L0-hlbbmwYqCbmgDG2CWZ6jfXW5I,2109
+dev/ui/db/runs.py,sha256=caRXOeLXOj36EycYX7UXGzXzwmJDsC_PsKgyG0RGnnI,1422
+dev/ui/static/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dev/ui/static/web.css,sha256=H30z3a-BJxS4qcuUX3sLDTgheIumCriClxqsnqmippY,13035
+dev/ui/static/web.js,sha256=Nhaqs6ATMnLXzmr5AdkcOo0YdWzQ7dEvtriasy8HwVI,25203
+dev/vcs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dev/vcs/git.py,sha256=TxNiNzxEAEdOodyJa5iBIRb9VZNlWbcaDrsexH-_-to,3738
+dev/vcs/github.py,sha256=YxW4CG12A0cTeZY1pOiQx3rEgab0NlIvIOHcJJW27Hg,2649
+dev/workflow/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dev/workflow/cda.py,sha256=OKaqoBH_TCN36S7eaSzKLkuD1AxJ5TxmPBesQWdEr70,5355
+dev/workflow/changelog.py,sha256=Yh1gaiE9hn06DneLVRY8kWYd4UcuW390j5K0J8ze3cE,3319
+dev/workflow/preflight.py,sha256=Cm1R1dMOtVABpMLh9pxJ0hzoyJQ3_6FOJfW0OfTwMEc,11647
+dev/workflow/release.py,sha256=YvO9nnTeRvtMUrNvrA_pyZ8y2b5dzk2d5A7hVUwcOyE,8373
+dev/workflow/versioning.py,sha256=3l_UfvB5gYabTlNM8trIZuLxJM8q1W6fCWrAqwIM16U,2925
+development_engine_vector-0.3.0.dist-info/METADATA,sha256=F71NG8zWRXJbhZpqFRS8DhNuhmXJSNfnzZRHJ8lHOcg,7381
+development_engine_vector-0.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+development_engine_vector-0.3.0.dist-info/entry_points.txt,sha256=m3Sk8zBP1FRj_6rNqBN-S7QA3yPby6gl6JRL2N0kST8,40
+development_engine_vector-0.3.0.dist-info/RECORD,,

development_engine_vector-0.3.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

development_engine_vector-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dev = dev.cli.cli:cli