Merge pull request #4 from freshtechbro/chore/pr-governance-checks

ci: enforce PR checks for lint, typecheck, and build

Author: freshtechbro

.github/workflows/pr-checks.yml

@@ -0,0 +1,72 @@
+name: PR Checks
+
+on:
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: pr-checks-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run lint
+        run: npm run lint
+
+  typecheck:
+    name: typecheck
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run typecheck
+        run: npm run typecheck
+
+  build:
+    name: build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run build
+        run: npm run build

.gitignore

@@ -30,7 +30,9 @@ pnpm-debug.log*
 
 # Temporary files
 *.tmp
+tmp/
 .cache/
+artifacts/
 
 # Playwright
 test-results/
@@ -43,8 +45,12 @@ playwright/.cache/
 # Build artifacts (do not commit)
 *.tgz
 opendevbrowser-extension.zip
+frontend/.next/
+frontend/.next-dev/
+frontend/.validation/
 
 # Continuity ledger (local-only)
+CONTINUITY*.md
 
 # Auto Claude data directory
 .auto-claude/

.ralph-last-branch

@@ -14,7 +14,7 @@ OpenCode plugin providing AI agents with browser automation via Chrome DevTools
 
 ## Architecture
 
-```
+```text
 ┌─────────────────────────────────────────────────────────────────┐
 │                      Distribution Layer                         │
 ├──────────────────┬──────────────────┬──────────────────┬──────────────────────────┤
@@ -25,8 +25,8 @@ OpenCode plugin providing AI agents with browser automation via Chrome DevTools
          │                  │                  │                       │
          ▼                  ▼                  ▼                       ▼
 ┌─────────────────────────────────────────────────────────────────┐
-│                    Core Runtime (src/core/)                      │
-│  bootstrap.ts → wires managers, injects ToolDeps                 │
+│                    Core Runtime (src/core/)                    │
+│  bootstrap.ts → wires managers, injects ToolDeps              │
 └────────┬────────────────────────────────────────────────────────┘
          │
     ┌────┴────┬─────────────┬──────────────┬──────────────┬──────────────┐
@@ -94,13 +94,15 @@ Extension relay requires **Chrome 125+** and uses flat CDP sessions with Debugge
 │   ├── relay/        # Extension relay server, protocol types
 │   ├── skills/       # SkillLoader for skill pack discovery
 │   ├── snapshot/     # AX-tree snapshots, ref management
-│   ├── tools/        # 41 opendevbrowser_* tool definitions
+│   ├── tools/        # 48 opendevbrowser_* tool definitions
 │   ├── annotate/     # Annotation transports + output shaping
 │   └── utils/        # Shared utilities
 ├── extension/        # Chrome extension (relay client)
-├── skills/           # Bundled skill packs (5 total)
+├── frontend/         # Next.js marketing/docs frontend
+├── scripts/          # Operational scripts (build/sync/smoke)
+├── skills/           # Bundled skill packs (8 total)
 ├── tests/            # Vitest tests (97% coverage required)
-└── docs/             # Architecture, plans, CLI docs
+└── docs/             # Architecture, CLI, extension, frontend, plans
 ```
 
 ## Where to Look
@@ -119,6 +121,7 @@ Extension relay requires **Chrome 125+** and uses flat CDP sessions with Debugge
 | Add skill pack | `skills/*/SKILL.md` | Follow naming conventions |
 | Config schema | `src/config.ts` | Zod schema, defaults |
 | DI wiring | `src/core/bootstrap.ts` | Creates ToolDeps, wires managers |
+| Full command/tool/channel inventory | `docs/SURFACE_REFERENCE.md` | Canonical 55 CLI + 48 tools + `/ops` + `/cdp` map |
 
 ## Commands
 
@@ -204,7 +207,7 @@ export function createTools(deps: ToolDeps): Record<string, ToolDefinition> {
   return {
     opendevbrowser_launch: createLaunchTool(deps),
     opendevbrowser_snapshot: createSnapshotTool(deps),
-    // ... 41 tools
+    // ... 48 tools
   };
 }
 ```
@@ -227,9 +230,10 @@ export function createTools(deps: ToolDeps): Record<string, ToolDefinition> {
 - Source of truth: `docs/`
 - Architecture: `docs/ARCHITECTURE.md`
 - CLI reference: `docs/CLI.md`
+- Surface inventory: `docs/SURFACE_REFERENCE.md`
 - Additional design/plan docs: `docs/` (feature-specific; verify file paths exist before referencing)
 - Keep docs in sync with implementation
-- If tool list or outputs change, update `docs/CLI.md` and this file together.
+- If tool list or outputs change, update `docs/CLI.md`, `docs/SURFACE_REFERENCE.md`, and this file together.
 
 ## AGENTS.md Governance
 
@@ -241,10 +245,17 @@ Subdirectory guides override this root file:
 - `src/AGENTS.md` — module boundaries, manager patterns
 - `src/browser/AGENTS.md` — browser/session module specifics
 - `src/cli/AGENTS.md` — CLI command and daemon conventions
+- `src/providers/AGENTS.md` — provider system (web/social/shopping), tiers, safety
 - `src/relay/AGENTS.md` — relay protocol and security specifics
 - `src/snapshot/AGENTS.md` — snapshot/ref pipeline specifics
 - `src/tools/AGENTS.md` — tool development patterns
 - `extension/AGENTS.md` — Chrome extension specifics
+- `extension/src/ops/AGENTS.md` — ops runtime for extension relay
+- `extension/src/services/AGENTS.md` — CDP routing, flat-session handling
+- `frontend/AGENTS.md` — frontend app conventions and generation workflow
+- `frontend/src/AGENTS.md` — frontend source module boundaries
+- `docs/AGENTS.md` — documentation source-of-truth and sync rules
+- `scripts/AGENTS.md` — script safety and output conventions
 - `tests/AGENTS.md` — testing conventions
 - `skills/AGENTS.md` — skill pack format
 

AGENTS.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.16] - 2026-02-24
+
+### Added
+- Automation provider runtime and macro execution surfaces for research, shopping, and product-asset workflows.
+- Debug-trace diagnostics snapshots and blocker metadata contracts across runtime outputs.
+- Expanded bundled skill-pack workflows and multi-agent skill target support.
+- Frontend docs site and branded asset pipeline for generated documentation delivery.
+
+### Changed
+- Hardened multitab runtime scheduling, provider orchestration, and Ops matrix execution behavior.
+- Migrated and stabilized skill-pack handling for multitab workflows and legacy alias compatibility.
+- Refreshed architecture/operations/distribution docs and release-readiness guidance.
+- Updated package + extension versions to `0.0.16` and refreshed dependency ranges/lockfile.
+
+### Fixed
+- Preserved blocker resolution outcomes and improved traversal recovery under live matrix pressure.
+- Narrowed native extension ID fallback typing for safer native-host path handling.
+- Corrected legacy skill alias drift (`SKILL 2`) to keep compatibility behavior deterministic.
+
+### Tests
+- Expanded multitab, provider, and CLI regression coverage.
+- Added workflow runtime, skill-installer, blocker-transition, traversal, and live-path guard tests.
+
 ## [0.0.15] - 2026-02-08
 
 ### Added
@@ -99,7 +122,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Core browser management
 - Basic snapshot pipeline
 
-[Unreleased]: https://github.com/freshtechbro/opendevbrowser/compare/eaced1e...HEAD
+[Unreleased]: https://github.com/freshtechbro/opendevbrowser/compare/v0.0.16...HEAD
+[0.0.16]: https://github.com/freshtechbro/opendevbrowser/compare/v0.0.15...v0.0.16
 [0.0.15]: https://github.com/freshtechbro/opendevbrowser/compare/ebb109e...eaced1e
 [0.0.14]: https://github.com/freshtechbro/opendevbrowser/compare/v0.0.13...ebb109e
 [0.0.13]: https://github.com/freshtechbro/opendevbrowser/compare/v0.0.12...v0.0.13

CHANGELOG.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 OpenDevBrowser contributors
+Copyright (c) 2024-2026 OpenDevBrowser contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal