Skip to content

Add Cloud Agent development environment - #33

Draft
a777ance wants to merge 1 commit into
mainfrom
cursor/setup-cloud-environment-fb62
Draft

a777ance wants to merge 1 commit into
mainfrom
cursor/setup-cloud-environment-fb62

Conversation

@a777ance

@a777ance a777ance commented Sep 12, 2026 •

Copy link
Copy Markdown
Owner

What

Adds .cursor/environment.json so this repo is fully usable in Cursor Cloud Agents. Repo-managed (versioned with code, follows branches/PRs) and highest-precedence environment source, so merging this PR is what activates it for future agents.

Why

localDNS is an Infrastructure-as-Code snapshot whose "applications" are Python tooling:

  • Static validation checks (stdlib only): tools/check-docs.py, tools/check-provenance.py, tools/check-doctrine.py — the repo's lint/test, gated at commit time by .claude/hooks/gate.sh.
  • Statement-gallery generators (docs/statements/tools/generate_client.py, generate_operator.py) — the one place a third-party dependency, segno, is needed (matches the Pages CI in .github/workflows/pages.yml).
  • The Jury self-consistency tool (04-user-services/ai-orchestration/jury/jury.py) — stdlib only, with an offline --mock mode.

Config

  • install — pip install segno (the only external dependency; everything else is Python 3.12 stdlib). Idempotent.
  • terminals — serves the Network Activity Statement gallery (docs/statements/) on :8000 for local preview of generated statements.
  • ports — exposes 8000.

Validation (this VM)

Check Result
check-docs.py / check-provenance.py / check-doctrine.py Pass (exit 0)
generate_client.py + generate_operator.py Rendered 3 client + 1 operator statement (deterministic; working tree stays clean)
Jury deliberate + calibrate (--mock) Pass (voting lift 0.71 → 1.00)
Install idempotence Passed twice
Gallery server (:8000) index + client + operator all HTTP 200

Build-test (fresh Cloud Agent)

Draft build bld-20260912-1595455b-1163-4d1e-8422-7d342389569c SUCCEEDED (install exit 0). A fresh Cloud Agent booted from that exact build on this branch re-verified:

Group Result
Base image + segno 1.6.6 importable Pass
Three static checks Pass (exit 0)
Statement generators Pass (3 client + 1 operator HTML)
Jury (--mock) Pass
Gallery command → HTTP 200 Pass

The terminals gallery server auto-launches for a real agent on the merged branch (repo-file managed). It was not auto-started in the draft-build verification pod only because a draft build's environmentJson override records install/snapshot (not terminals); the command itself returns HTTP 200 on both the original VM and the fresh agent.

Note

tools/sync-briefings.py reports drift only because the cloud checkout dir is named workspace rather than localDNS; the script self-excludes the repo by directory name, so it mistakes the repo for a sibling. Checkout-path artifact, not a repo defect, unrelated to this change.

Open in Web Open in Cursor 

Sets up a Cursor Cloud Agent development environment:
- install: adds segno (the only third-party dep, used by the
  docs/statements generators; the rest of the tooling is stdlib-only)
- terminals: serves the Network Activity Statement gallery on :8000
  for local preview of generated client/operator statements
- ports: exposes 8000

Co-authored-by: David Allum <a777ance@gmail.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
❌ Deployment failed
View logs
cloudflarelocaldns 0d2275c Sep 12 2026, 03:05 AM

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants