Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
74 commits
Select commit Hold shift + click to select a range
9d3a899
docs(anti-bot): keep orchestration notes local-only
freshtechbro Mar 22, 2026
b13f9ba
feat(runtime): add challenge-preserving controls
freshtechbro Mar 22, 2026
b2a6212
fix(audit): harden skill runtime harness
freshtechbro Mar 22, 2026
cd21850
docs(surface): sync runtime inventories
freshtechbro Mar 22, 2026
ec2060c
feat: expand skill runtime audit coverage
freshtechbro Mar 23, 2026
bb8910d
fix: stabilize login fixture live probe
freshtechbro Mar 23, 2026
8a651c9
feat: add shared challenge orchestration plane
freshtechbro Mar 23, 2026
50242b0
test: cover challenge orchestration flows
freshtechbro Mar 23, 2026
4b4d8c3
docs: publish challenge orchestration posture
freshtechbro Mar 23, 2026
4028b3b
docs: delete anti-bot challenge planning docs
freshtechbro Mar 23, 2026
c75fdfe
docs: add challenge override plan
freshtechbro Mar 23, 2026
277953f
docs: refresh AGENTS metadata
freshtechbro Mar 23, 2026
fc2f0b3
feat(runtime): add challenge override modes
freshtechbro Mar 23, 2026
371cb8f
fix(audit): harden provider audit lanes
freshtechbro Mar 23, 2026
b9da078
docs(runtime): sync override docs surface
freshtechbro Mar 23, 2026
23d1173
docs: align skill-pack drift closure wording
freshtechbro Mar 24, 2026
408b00c
fix: harden skill-pack validator closure
freshtechbro Mar 24, 2026
5c83a44
fix: harden extension shopping session recovery
freshtechbro Mar 27, 2026
1900dc6
fix: tighten workflow shopping quality and diagnostics
freshtechbro Mar 27, 2026
90fc221
docs: add workflow investigation records
freshtechbro Mar 27, 2026
012faac
fix: lazy-load playwright runtime for cookie bootstrap
freshtechbro Mar 27, 2026
129cbe6
fix: expand bounded challenge interaction handling
freshtechbro Mar 27, 2026
d6385ba
docs: add browser-help and challenge planning records
freshtechbro Mar 27, 2026
49b1090
fix(browser): harden review and policy seams
freshtechbro Mar 27, 2026
e402729
docs: sync workflow and compatibility audits
freshtechbro Mar 27, 2026
4d9dc11
fix(extension): stabilize popup attach and reconnect
freshtechbro Mar 29, 2026
f098b24
docs(extension): document popup attach diagnostics
freshtechbro Mar 29, 2026
2b9f7fc
docs(canvas): add active canvas technical references
freshtechbro Mar 29, 2026
56aa45a
docs(workflows): capture autonomy investigation results
freshtechbro Mar 29, 2026
285abd4
docs(governance): expand scoped agent guides
freshtechbro Mar 29, 2026
57389ed
fix: add popup attach recovery provenance
freshtechbro Mar 30, 2026
535000b
docs: add workflow autonomy implementation spec
freshtechbro Mar 30, 2026
a4970a6
docs: add oracle popup attach export
freshtechbro Mar 30, 2026
ef7688c
fix: restore popup workflow fixture host
freshtechbro Mar 30, 2026
1fba2ec
fix: preserve ops timeout context for shopping fallback
freshtechbro Mar 30, 2026
72f6b3f
fix: extract ebay s-card shopping offers
freshtechbro Mar 30, 2026
9533529
fix: recover Walmart prices from truncated search cards
freshtechbro Mar 30, 2026
3d45b75
docs: refine workflow autonomy implementation spec
freshtechbro Mar 30, 2026
29e9b5a
feat: implement workflow autonomy substrate
freshtechbro Mar 31, 2026
1c8dc54
refactor: centralize workflow governance helpers
freshtechbro Mar 31, 2026
f1f731f
docs: record workflow autonomy execution closure
freshtechbro Mar 31, 2026
1c60283
feat: harden workflow provider truth
freshtechbro Apr 1, 2026
06e2ad3
fix: preserve active targets across startUrl attach flows
freshtechbro Apr 1, 2026
ab7638b
fix: tighten CLI workflow support and challenge evidence
freshtechbro Apr 1, 2026
46b21d6
fix: align live validation harness with honest workflow outcomes
freshtechbro Apr 1, 2026
22a5dbf
test: stabilize canvas code sync watcher proof
freshtechbro Apr 1, 2026
9637950
chore: canonicalize generated dist outputs
freshtechbro Apr 1, 2026
1925214
docs: refresh workflow autonomy and live validation ledgers
freshtechbro Apr 1, 2026
27b1f66
fix: harden daemon startup and relay readiness
freshtechbro Apr 3, 2026
2704af5
fix: stabilize workflow and provider validation lanes
freshtechbro Apr 3, 2026
5a3437d
docs: sync workflow and daemon reliability references
freshtechbro Apr 3, 2026
e55db5b
refactor: share provider runtime composition
freshtechbro Apr 4, 2026
bcf5458
feat: add session diagnostics and interactive ops commands
freshtechbro Apr 4, 2026
1fb1c10
feat: generate public surface manifest and onboarding guidance
freshtechbro Apr 4, 2026
806a1cb
fix: harden onboarding help and skill install surfaces
freshtechbro Apr 4, 2026
95ef785
docs: align surface and skill discovery references
freshtechbro Apr 4, 2026
2f4dd72
fix: close distribution skill lifecycle and onboarding surfaces
freshtechbro Apr 4, 2026
61eb5f2
test: lock distribution cleanup regression coverage
freshtechbro Apr 4, 2026
d4dc63b
docs: finalize canonical skill lifecycle and onboarding docs
freshtechbro Apr 4, 2026
1a1c19e
fix: create macOS Logs dir before daemon bootstrap
freshtechbro Apr 4, 2026
5071489
test: extend cli smoke daemon startup coverage
freshtechbro Apr 4, 2026
2599eb9
chore: ignore prompt exports and drop stale local artifact
freshtechbro Apr 4, 2026
5b8652f
docs: remove historical cleanup-pass investigation docs
freshtechbro Apr 4, 2026
e6ed549
fix: correct managed ref screenshot clip geometry
freshtechbro Apr 4, 2026
cb5f593
fix: add CLI transport timeout defaults for page workflows
freshtechbro Apr 5, 2026
1b236dc
fix: harden extension handshake recovery and readiness gating
freshtechbro Apr 5, 2026
cf5fdb5
fix: stabilize extension attach recovery
freshtechbro Apr 5, 2026
a2b2b47
fix: gate ops recovery on healthy extension handshake
freshtechbro Apr 5, 2026
2ff30c6
fix: expose skill discovery provenance
freshtechbro Apr 6, 2026
ad7eb88
fix: strengthen workflow skill validators
freshtechbro Apr 6, 2026
b53d6ab
fix: align skill runtime audit proofs
freshtechbro Apr 6, 2026
723b049
docs: refresh governance and docs inventory
freshtechbro Apr 6, 2026
3b481b3
fix: tighten capability workflow contracts
freshtechbro Apr 6, 2026
7b538ee
fix: surface validated workflow lanes in cli guidance
freshtechbro Apr 6, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,7 @@ sub_continuity.md
.factory/
prd.json
progress.txt
prompt-exports/

# Local docs scratch
docs/RELAY_CDP_TOKEN_PLAN.md
Expand Down
20 changes: 15 additions & 5 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# OpenDevBrowser - Agent Guidelines

**Generated:** 2026-03-20 | **Commit:** 12a0dfb | **Branch:** codex/canvas-upgrade
**Generated:** 2026-04-04 | **Commit:** e6ed549 | **Branch:** codex/merge-antibot-workflow-stability

## Overview

Expand Down Expand Up @@ -98,7 +98,7 @@ 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/ # 49 opendevbrowser_* tool definitions
│ ├── tools/ # 57 opendevbrowser_* tool definitions
│ ├── annotate/ # Annotation transports + output shaping
│ └── utils/ # Shared utilities
├── extension/ # Chrome extension (relay client)
Expand Down Expand Up @@ -126,7 +126,7 @@ Extension relay requires **Chrome 125+** and uses flat CDP sessions with Debugge
| Design canvas + code sync | `src/canvas/`, `src/canvas/kits/catalog.ts`, `src/canvas/starters/catalog.ts`, `src/browser/canvas-manager.ts`, `docs/DESIGN_CANVAS_TECHNICAL_SPEC.md`, `docs/CANVAS_BIDIRECTIONAL_CODE_SYNC_TECHNICAL_SPEC.md`, `docs/CANVAS_ADAPTER_PLUGIN_CONTRACT.md`, `scripts/canvas-competitive-validation.mjs` | Current canvas technical docs, built-in kit and starter inventory, framework-adapter code sync, BYO plugin contract, validator evidence, manifest persistence, and runtime preview fallback |
| 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 56 CLI + 49 tools + `/ops` + `/canvas` + `/cdp` map |
| Full command/tool/channel inventory | `docs/SURFACE_REFERENCE.md` | Canonical 64 CLI + 57 tools + 59 `/ops` + 35 `/canvas` + `/cdp` map |

## Commands

Expand Down Expand Up @@ -213,7 +213,7 @@ export function createTools(deps: ToolDeps): Record<string, ToolDefinition> {
opendevbrowser_launch: createLaunchTool(deps),
opendevbrowser_canvas: createCanvasTool(deps),
opendevbrowser_snapshot: createSnapshotTool(deps),
// ... 49 tools
// ... 57 tools
};
}
```
Expand All @@ -237,11 +237,12 @@ export function createTools(deps: ToolDeps): Record<string, ToolDefinition> {
- Architecture: `docs/ARCHITECTURE.md`
- CLI reference: `docs/CLI.md`
- Surface inventory: `docs/SURFACE_REFERENCE.md`
- Canvas technical docs: `docs/DESIGN_CANVAS_TECHNICAL_SPEC.md`, `docs/CANVAS_BIDIRECTIONAL_CODE_SYNC_TECHNICAL_SPEC.md`
- Canvas technical docs: `docs/DESIGN_CANVAS_TECHNICAL_SPEC.md`, `docs/CANVAS_BIDIRECTIONAL_CODE_SYNC_TECHNICAL_SPEC.md`, `docs/CANVAS_ADAPTER_PLUGIN_CONTRACT.md`
- Canvas adapter plugin contract: `docs/CANVAS_ADAPTER_PLUGIN_CONTRACT.md`
- Additional design/plan docs: `docs/` (feature-specific; verify file paths exist before referencing)
- Keep docs in sync with implementation
- Treat generated CLI help as part of the documentation surface.
- Keep local-only generated artifacts such as `prompt-exports/`, root `artifacts/`, `coverage/`, `CONTINUITY*.md`, and `sub_continuity.md` out of commits; `.gitignore` is authoritative.
- If tool list, command outputs, or help inventory changes, update `src/cli/help.ts`, `docs/CLI.md`, `docs/SURFACE_REFERENCE.md`, and this file together, then verify both `npx opendevbrowser --help` and `npx opendevbrowser help`.

## AGENTS.md Governance
Expand All @@ -252,14 +253,23 @@ export function createTools(deps: ToolDeps): Record<string, ToolDefinition> {

Subdirectory guides override this root file:
- `src/AGENTS.md` — module boundaries, manager patterns
- `src/annotate/AGENTS.md` — annotation transport, inbox storage, and delivery rules
- `src/challenges/AGENTS.md` — bounded challenge orchestration plane, evidence, and recovery lanes
- `src/browser/AGENTS.md` — browser/session module specifics
- `src/canvas/AGENTS.md` — canvas document store, repo persistence, code-sync specifics
- `src/cli/AGENTS.md` — CLI command and daemon conventions
- `src/cli/commands/AGENTS.md` — CLI command handler subdomains and thin-command rules
- `src/core/AGENTS.md` — bootstrap, DI, and runtime assembly
- `src/devtools/AGENTS.md` — console/network/exception trackers and redaction rules
- `src/export/AGENTS.md` — DOM capture, sanitization, and React export constraints
- `src/integrations/AGENTS.md` — external integration adapters such as Figma import
- `src/macros/AGENTS.md` — macro parsing, resolution, and provider-action expansion rules
- `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/canvas/AGENTS.md` — extension-hosted canvas runtime and design-tab state
- `extension/src/ops/AGENTS.md` — ops runtime for extension relay
- `extension/src/services/AGENTS.md` — CDP routing, flat-session handling
- `docs/AGENTS.md` — documentation source-of-truth and sync rules
Expand Down
Loading
Loading