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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: development-engine-vector
-Version: 0.3.1
+Version: 0.5.1
 Summary: Development Engine Vector — internal developer workflow CLI.
 Author-email: Ernie Butcher <ernie@fiosii.com>
 License-Expression: MIT
@@ -187,35 +187,45 @@ dev ui status                       # show pid, started time, log path
 dev ui restart                      # restart
 ```
 
-### `dev pmf`
+### `dev otk`
 
-Manage the embedded PMF kernel and background services.
+Manage the **Ops Tool Kernel (OTK)** and background services/tasks.
 
 ```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 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 + pmf install + ui start + open browser
+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. **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`
+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
 
@@ -251,7 +261,7 @@ dev --config ./custom.dev-cli.toml release --project /Volumes/intel/systems/cda/
 
 ```
 dev/
-├── kernel/       — runtime foundation (paths, PMF kernel, 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)

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

@@ -5,6 +5,72 @@ 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.5.1] - 2026-05-12
+
+### Fixed
+- UI service status stuck on `"starting"` — `_refresh()` now advances to `"running"` and persists state when the process is confirmed alive
+- `VersionManager.get_sync_targets()` removed stale `vscode_ark/__init__.py` and `setup.py` targets; now resolves `dev/__init__.py` from the project tree
+- `ReleaseOrchestrator.commit_and_tag()` staged `vscode_ark/__init__.py` and `setup.py` (copy-paste from cda); corrected to `dev/__init__.py`
+- `get_recent_runs` unused import in `routes.py` removed (lint failure)
+- Release page showed always-empty kernel run history; now shows real action states (pass/fail, exit code, timestamps)
+
+### Added
+- `/api/kernel/logs?service=X&lines=N` endpoint — tails any service log file from the UI
+- OTK page **Logs** button per service opens a modal with the last 100 log lines
+- Action buttons now poll to completion and display a result toast with exit code and captured output
+- Raw Query page has a database selector: `control.db` (vet history) or `dev.db` (kernel/projects)
+- `sync` OTK task service added — bootstrap/editable-install from the OTK page
+- Setup page shows `dev otk install` guidance when the LaunchAgent is not installed
+- Git page shows "Clean — no commits since vX.Y.Z" on a clean repo instead of a blank panel
+- `vet.py` writes `vet.start` / `vet.pass` / `vet.fail` events to the `events` table and refreshes `identity.version` on every passing run
+
+## [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

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

@@ -87,7 +87,9 @@ dev/
 │   ├── dev/                 # Python package
 │   │   ├── kernel/          # runtime foundation
 │   │   │   ├── paths.py     # DEV_HOME = ~/Library/goCosmix/tools/dev
-│   │   │   ├── pmf_kernel.py # PMFKernel, launchd integration (port 9001)
+│   │   │   ├── 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
@@ -128,7 +130,9 @@ Thin click wrappers. All logic delegates to `workflow/` and `vcs/` modules.
 
 ### Kernel (`dev/kernel/`)
 - `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
+- `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.1 → development_engine_vector-0.5.1}/dev/__init__.py

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

{development_engine_vector-0.3.1 → development_engine_vector-0.5.1}/dev/cli/cli.py

@@ -10,8 +10,8 @@ import click
 
 from dev.kernel.config import DevConfig
 from dev.kernel.paths import ensure_dirs
-from dev.kernel.pmf_kernel import (
-    PMFKernel, PMFKernelError,
+from dev.kernel.otk_kernel import (
+    OTKKernel, OTKKernelError,
     install_launchd, uninstall_launchd, plist_path,
     wait_for_port_and_open_browser,
 )
@@ -272,7 +272,7 @@ def selfcheck():
     print(f"  {result['passed']} passed, {result['failed']} failed")
 
 
-_kernel = PMFKernel()
+_kernel = OTKKernel()
 
 
 # ── helper ────────────────────────────────────────────────────────────────────
@@ -300,7 +300,7 @@ def _hr():
 
 def _pmf_warn_if_not_installed():
     if not plist_path().exists():
-        click.echo(_yellow("  ⚠  LaunchAgent not installed — run `dev pmf install` to auto-start on login."))
+        click.echo(_yellow("  ⚠  LaunchAgent not installed — run `dev otk install` (or `dev pmf install`) to auto-start on login."))
 
 
 # ── ui group ─────────────────────────────────────────────────────────────────
@@ -317,7 +317,7 @@ def ui():
 @click.option("--no-browser", "no_browser", is_flag=True, default=False,
               help="Don't open browser automatically")
 def ui_start(host, port, no_browser):
-    """Start the web UI via PMF."""
+    """Start the web UI via OTK."""
     _pmf_warn_if_not_installed()
     try:
         result = _kernel.start_service("ui", options={"host": host, "port": port})
@@ -326,7 +326,7 @@ def ui_start(host, port, no_browser):
             url = f"http://{host}:{port}"
             click.echo(_dim("  Opening browser when server is ready..."))
             wait_for_port_and_open_browser(url, host, port)
-    except PMFKernelError as exc:
+    except OTKKernelError as exc:
         click.echo(_red(f"  {exc}"))
 
 
@@ -336,7 +336,7 @@ def ui_stop():
     try:
         result = _kernel.stop_service("ui")
         click.echo(green(f"  Stopped {result['label']}"))
-    except PMFKernelError as exc:
+    except OTKKernelError as exc:
         click.echo(_red(f"  {exc}"))
 
 
@@ -367,7 +367,7 @@ def ui_restart(host, port, no_browser):
             url = f"http://{host}:{port}"
             click.echo(_dim("  Opening browser when server is ready..."))
             wait_for_port_and_open_browser(url, host, port)
-    except PMFKernelError as exc:
+    except OTKKernelError as exc:
         click.echo(_red(f"  {exc}"))
 
 
@@ -375,16 +375,16 @@ def ui_restart(host, port, no_browser):
 
 @cli.group()
 def pmf():
-    """Manage the embedded PMF kernel and dev services."""
+    """Legacy alias for OTK commands (kept for backward compatibility)."""
     pass
 
 
 @pmf.command("services")
 def pmf_services():
-    """List PMF services and runtime status."""
+    """List OTK services and runtime status."""
     rows = _kernel.services()
     click.echo()
-    click.echo(_bold("  PMF Runtime Services"))
+    click.echo(_bold("  OTK Runtime Services"))
     click.echo(_hr())
     for svc in rows:
         status_str = green(svc["status"]) if svc["status"] == "running" else _yellow(svc["status"])
@@ -396,7 +396,7 @@ def pmf_services():
 @pmf.command("status")
 @click.argument("service_id", required=False)
 def pmf_status(service_id):
-    """Show PMF runtime status for one or all services."""
+    """Show OTK runtime status for one or all services."""
     if service_id:
         try:
             svc = _kernel.service_status(service_id)
@@ -407,7 +407,7 @@ def pmf_status(service_id):
             click.echo(f"  Started: {svc['started_at'] or '—'}")
             click.echo(f"  Log:     {svc['log_file'] or '—'}")
             click.echo()
-        except PMFKernelError as exc:
+        except OTKKernelError as exc:
             click.echo(_red(f"  {exc}"))
     else:
         ctx = click.get_current_context()
@@ -418,10 +418,15 @@ def pmf_status(service_id):
 @click.argument("service_id")
 @click.option("--host", default="127.0.0.1", help="Host override for UI service")
 @click.option("--port", default=9001, help="Port override for UI service")
+@click.option("--project", default=".", help="Project path override for task services")
 @click.option("--no-browser", "no_browser", is_flag=True, default=False)
-def pmf_start(service_id, host, port, no_browser):
-    """Start a PMF-managed service."""
-    options = {"host": host, "port": port} if service_id == "ui" else None
+def pmf_start(service_id, host, port, project, no_browser):
+    """Start an OTK-managed service."""
+    options = {
+        "host": host,
+        "port": port,
+        "project": str(Path(project).resolve()),
+    }
     try:
         result = _kernel.start_service(service_id, options=options)
         click.echo(green(f"  Started {result['label']}  pid={result['pid']}"))
@@ -429,29 +434,35 @@ def pmf_start(service_id, host, port, no_browser):
             url = f"http://{host}:{port}"
             click.echo(_dim("  Opening browser when server is ready..."))
             wait_for_port_and_open_browser(url, host, port)
-    except PMFKernelError as exc:
+    except OTKKernelError as exc:
         click.echo(_red(f"  {exc}"))
 
 
 @pmf.command("stop")
 @click.argument("service_id")
 def pmf_stop(service_id):
-    """Stop a PMF-managed service."""
+    """Stop an OTK-managed service."""
     try:
         result = _kernel.stop_service(service_id)
         click.echo(green(f"  Stopped {result['label']}"))
-    except PMFKernelError as exc:
+    except OTKKernelError as exc:
         click.echo(_red(f"  {exc}"))
 
 
 @pmf.command("restart")
 @click.argument("service_id")
-def pmf_restart(service_id):
-    """Restart a PMF-managed service."""
+@click.option("--host", default="127.0.0.1", help="Host override for UI service")
+@click.option("--port", default=9001, help="Port override for UI service")
+@click.option("--project", default=".", help="Project path override for task services")
+def pmf_restart(service_id, host, port, project):
+    """Restart an OTK-managed service."""
     try:
-        result = _kernel.restart_service(service_id)
+        result = _kernel.restart_service(
+            service_id,
+            options={"host": host, "port": port, "project": str(Path(project).resolve())},
+        )
         click.echo(green(f"  Restarted {result['label']}  pid={result['pid']}"))
-    except PMFKernelError as exc:
+    except OTKKernelError as exc:
         click.echo(_red(f"  {exc}"))
 
 
@@ -459,20 +470,35 @@ def pmf_restart(service_id):
 @click.argument("service_id")
 @click.option("--tail", default=50, show_default=True, help="Lines to tail")
 def pmf_logs(service_id, tail):
-    """Display the last lines from a PMF service log."""
+    """Display the last lines from an OTK service log."""
     try:
         output = _kernel.tail_log(service_id, lines=tail)
         click.echo(output)
-    except PMFKernelError as exc:
+    except OTKKernelError as exc:
         click.echo(_red(f"  {exc}"))
 
 
+@pmf.command("events")
+@click.option("--tail", default=20, show_default=True, help="Number of recent kernel events")
+def pmf_events(tail):
+    """Show recent OTK kernel runtime events."""
+    events = _kernel.recent_events(limit=tail)
+    click.echo()
+    click.echo(_bold("  OTK Kernel Events"))
+    click.echo(_hr())
+    if not events:
+        click.echo(_dim("  (no events)"))
+    for ev in events:
+        click.echo(f"  {ev.get('ts', '—')}  {_bold(ev.get('kind', 'event')):<18} {ev.get('service_id', '—'):<14} {ev.get('detail', '')}")
+    click.echo()
+
+
 @pmf.command("up")
 @click.option("--host", default="127.0.0.1", show_default=True)
 @click.option("--port", default=9001, show_default=True)
 @click.option("--no-browser", "no_browser", is_flag=True, default=False)
 def pmf_up(host, port, no_browser):
-    """Start all dev services (web UI). Called automatically by launchd on login."""
+    """Start default OTK services (web UI). Called by launchd on login."""
     url = f"http://{host}:{port}"
     click.echo(_bold("  Development Engine Vector — starting services"))
     click.echo(_hr())
@@ -483,7 +509,7 @@ def pmf_up(host, port, no_browser):
         if not no_browser:
             click.echo(_dim("  Opening browser when server is ready..."))
             wait_for_port_and_open_browser(url, host, port)
-    except PMFKernelError as exc:
+    except OTKKernelError as exc:
         click.echo(_yellow(f"  Web UI       {exc}"))
 
     click.echo()
@@ -503,9 +529,10 @@ def pmf_install():
         click.echo(green("  Loaded:  yes — dev will start automatically on next login"))
         click.echo()
         click.echo(_dim("  To start services now without logging out:"))
-        click.echo(_dim("    dev pmf up"))
+        click.echo(_dim("    dev otk up"))
+        click.echo(_dim("    (legacy alias: dev pmf up)"))
         click.echo()
-    except PMFKernelError as exc:
+    except OTKKernelError as exc:
         click.echo(_red(f"  {exc}"))
         click.echo(_yellow("  Make sure `dev` is on PATH: export PATH=\"$HOME/Library/Python/3.9/bin:$PATH\""))
         click.echo()
@@ -523,29 +550,134 @@ def pmf_uninstall():
     click.echo(green("  dev will no longer start automatically on login."))
 
 
+@cli.group()
+def otk():
+    """Manage the Ops Tool Kernel (OTK) and dev runtime services."""
+    pass
+
+
+@otk.command("services")
+@click.pass_context
+def otk_services(ctx):
+    """List OTK services and runtime status."""
+    ctx.invoke(pmf_services)
+
+
+@otk.command("status")
+@click.argument("service_id", required=False)
+@click.pass_context
+def otk_status(ctx, service_id):
+    """Show OTK runtime status for one or all services."""
+    ctx.invoke(pmf_status, service_id=service_id)
+
+
+@otk.command("start")
+@click.argument("service_id")
+@click.option("--host", default="127.0.0.1", help="Host override for UI service")
+@click.option("--port", default=9001, help="Port override for UI service")
+@click.option("--project", default=".", help="Project path override for task services")
+@click.option("--no-browser", "no_browser", is_flag=True, default=False)
+@click.pass_context
+def otk_start(ctx, service_id, host, port, project, no_browser):
+    """Start an OTK-managed service or task."""
+    ctx.invoke(
+        pmf_start,
+        service_id=service_id,
+        host=host,
+        port=port,
+        project=project,
+        no_browser=no_browser,
+    )
+
+
+@otk.command("stop")
+@click.argument("service_id")
+@click.pass_context
+def otk_stop(ctx, service_id):
+    """Stop an OTK-managed service."""
+    ctx.invoke(pmf_stop, service_id=service_id)
+
+
+@otk.command("restart")
+@click.argument("service_id")
+@click.option("--host", default="127.0.0.1", help="Host override for UI service")
+@click.option("--port", default=9001, help="Port override for UI service")
+@click.option("--project", default=".", help="Project path override for task services")
+@click.pass_context
+def otk_restart(ctx, service_id, host, port, project):
+    """Restart an OTK-managed service or task."""
+    ctx.invoke(pmf_restart, service_id=service_id, host=host, port=port, project=project)
+
+
+@otk.command("logs")
+@click.argument("service_id")
+@click.option("--tail", default=50, show_default=True, help="Lines to tail")
+@click.pass_context
+def otk_logs(ctx, service_id, tail):
+    """Tail logs for an OTK service or task."""
+    ctx.invoke(pmf_logs, service_id=service_id, tail=tail)
+
+
+@otk.command("events")
+@click.option("--tail", default=20, show_default=True, help="Number of recent kernel events")
+@click.pass_context
+def otk_events(ctx, tail):
+    """Show recent OTK events."""
+    ctx.invoke(pmf_events, tail=tail)
+
+
+@otk.command("up")
+@click.option("--host", default="127.0.0.1", show_default=True)
+@click.option("--port", default=9001, show_default=True)
+@click.option("--no-browser", "no_browser", is_flag=True, default=False)
+@click.pass_context
+def otk_up(ctx, host, port, no_browser):
+    """Start default OTK services (web UI)."""
+    ctx.invoke(pmf_up, host=host, port=port, no_browser=no_browser)
+
+
+@otk.command("install")
+@click.pass_context
+def otk_install(ctx):
+    """Install OTK launchd registration for auto-start on login."""
+    ctx.invoke(pmf_install)
+
+
+@otk.command("uninstall")
+@click.pass_context
+def otk_uninstall(ctx):
+    """Uninstall OTK launchd registration."""
+    ctx.invoke(pmf_uninstall)
+
+
 # ── setup ─────────────────────────────────────────────────────────────────────
 
 @cli.command("setup")
 @click.option("--no-browser", "no_browser", is_flag=True, default=False,
               help="Don't open browser when the web UI starts")
-def setup(no_browser):
+@click.option("--run-otk-chain/--skip-otk-chain", default=False,
+              help="Run the first OTK task chain (preflight → vet) after startup")
+def setup(no_browser, run_otk_chain):
     """
-    Full onboarding in three steps: init → pmf install → up.
+    Full onboarding in three steps: init → otk install → up.
 
     \b
-    Run this once after `pip install dev-cli`.
-    If `dev` isn't on PATH yet, use the fallback:
+            3. Up      — start the web UI via OTK, open browser
 
-        python3 -m dev setup
+        Optional phase 2:
+            - Run the first OTK task chain (preflight → vet) against the dev source tree.
+    If `dev` isn't on PATH yet, use the fallback:
+        All processes are managed by the OTK kernel. The LaunchAgent calls
+        `dev otk up` on every login — no manual interaction needed after setup.
 
     \b
     What each step does:
       1. Init    — create ~/Library/goCosmix/tools/dev/, patch PATH
       2. Install — register a macOS LaunchAgent so dev starts on every login
-      3. Up      — start the web UI via PMF, open browser
+            3. Up      — start the web UI via OTK, open browser
 
-    All processes are managed by the PMF kernel. The LaunchAgent calls
-    `dev pmf up` on every login — no manual interaction needed after setup.
+        All processes are managed by the OTK kernel. The LaunchAgent calls
+        `dev otk up` on every login — no manual interaction needed after setup.
     """
     import os as _os
     import shutil as _shutil
@@ -569,7 +701,9 @@ def setup(no_browser):
     click.echo(_dim("  Three steps to a fully operational dev installation:"))
     click.echo(_dim(f"    1. Init    — create {DEV_HOME}"))
     click.echo(_dim("    2. Install — register macOS LaunchAgent (auto-start on login)"))
-    click.echo(_dim("    3. Up      — start web UI via PMF, open browser"))
+    click.echo(_dim("    3. Up      — start web UI via OTK, open browser"))
+    if run_otk_chain:
+        click.echo(_dim("    4. Phase 2 — run OTK preflight → vet task chain"))
     click.echo()
 
     # ── Step 1: Init ─────────────────────────────────────────────
@@ -616,13 +750,13 @@ def setup(no_browser):
 
     click.echo()
 
-    # ── Step 2: PMF install ──────────────────────────────────────
+    # ── Step 2: OTK install ──────────────────────────────────────
     click.echo(_bold(bar))
-    click.echo(_bold("  Step 2/3 — PMF install"))
+    click.echo(_bold("  Step 2/3 — OTK install"))
     click.echo(_bold(bar))
     click.echo()
     click.echo(_dim("  The LaunchAgent registers dev with macOS launchd. On every login,"))
-    click.echo(_dim("  launchd calls `dev pmf up` — starts the web UI via PMF kernel."))
+    click.echo(_dim("  launchd calls `dev otk up` — starts the web UI via OTK kernel."))
     click.echo(_dim("  No terminal required after this."))
     click.echo()
 
@@ -632,9 +766,9 @@ def setup(no_browser):
         click.echo(f"    {green('✓')}  LaunchAgent: {target}")
         click.echo(f"    {green('✓')}  Loaded — dev starts automatically on every login")
         pmf_ok = True
-    except PMFKernelError as exc:
+    except OTKKernelError as exc:
         click.echo(f"    {_yellow('⚠')}  LaunchAgent registration failed: {exc}")
-        click.echo(_yellow("         Fix PATH then run `dev pmf install` to retry."))
+        click.echo(_yellow("         Fix PATH then run `dev otk install` (or `dev pmf install`) to retry."))
     click.echo()
 
     # ── Step 3: Up ───────────────────────────────────────────────
@@ -651,9 +785,31 @@ def setup(no_browser):
         if not no_browser:
             click.echo(_dim("  Opening browser when server is ready..."))
             wait_for_port_and_open_browser(url, host, port)
-    except PMFKernelError as exc:
+    except OTKKernelError as exc:
         click.echo(f"    {_yellow('⚠')}  Web UI: {exc}")
-        click.echo(_dim("         Try `dev ui start` once PMF is installed."))
+        click.echo(_dim("         Try `dev ui start` once OTK is installed."))
+
+    if run_otk_chain:
+        source_root = Path(__file__).resolve().parents[2]
+        click.echo()
+        click.echo(_bold(bar))
+        click.echo(_bold("  Phase 2 — OTK task chain"))
+        click.echo(_bold(bar))
+        click.echo()
+
+        try:
+            preflight_result = _kernel.run_task("preflight", options={"project": str(source_root)}, timeout=600)
+            preflight_status = green("✓") if preflight_result["returncode"] == 0 else _yellow("⚠")
+            click.echo(f"    {preflight_status}  preflight  exit={preflight_result['returncode']}")
+        except OTKKernelError as exc:
+            click.echo(f"    {_yellow('⚠')}  preflight: {exc}")
+
+        try:
+            vet_result = _kernel.run_task("vet", timeout=900)
+            vet_status = green("✓") if vet_result["returncode"] == 0 else _yellow("⚠")
+            click.echo(f"    {vet_status}  vet       exit={vet_result['returncode']}")
+        except OTKKernelError as exc:
+            click.echo(f"    {_yellow('⚠')}  vet: {exc}")
 
     click.echo()
     click.echo(_bold(BAR))