docs: Cloud VM native Postgres when Docker yieldomega-pg unavailable #400

Merged
PlasticDigits merged 1 commit from cursor/cloud-vm-native-postgres-docs-4baf into main 2026-06-02 13:47:08 +00:00
PlasticDigits commented 2026-06-02 13:27:42 +00:00 (Migrated from gitlab.com)

Summary

Documents how Cursor Cloud agents (and other Linux hosts) can run indexer QA when the yieldomega-pg Docker container cannot start—common on nested VMs with overlay mount failures.

Changes

  • AGENTS.md: New section Postgres without Docker (yieldomega-pg) with connection defaults, one-time Ubuntu setup (postgresql-16, port 5433, yieldomega role with CREATEDB), and clarity on which workflows work without Docker vs. start-local-anvil-stack.sh (still Docker-dependent for Postgres bootstrap).
  • docs/testing/qa-local-full-stack.md: Prerequisites table links to the new AGENTS section.

Verification checklist

Item Command / result
Docs only — no code paths changed git diff main...HEAD — AGENTS.md, qa-local-full-stack.md only
Anchor link target exists AGENTS.md#postgres-without-docker-yieldomega-pg
Cross-link from QA doc qa-local-full-stack.md prerequisites row

Follow-up from GitLab #254 verification (native Postgres on Cloud VM during verify-podium-live-anvil.sh).

## Summary Documents how Cursor Cloud agents (and other Linux hosts) can run indexer QA when the **yieldomega-pg** Docker container cannot start—common on nested VMs with overlay mount failures. ## Changes - **AGENTS.md**: New section **Postgres without Docker (yieldomega-pg)** with connection defaults, one-time Ubuntu setup (postgresql-16, port 5433, yieldomega role with CREATEDB), and clarity on which workflows work without Docker vs. start-local-anvil-stack.sh (still Docker-dependent for Postgres bootstrap). - **docs/testing/qa-local-full-stack.md**: Prerequisites table links to the new AGENTS section. ## Verification checklist | Item | Command / result | |------|------------------| | Docs only — no code paths changed | git diff main...HEAD — AGENTS.md, qa-local-full-stack.md only | | Anchor link target exists | AGENTS.md#postgres-without-docker-yieldomega-pg | | Cross-link from QA doc | qa-local-full-stack.md prerequisites row | ## Related Follow-up from GitLab #254 verification (native Postgres on Cloud VM during verify-podium-live-anvil.sh).
ghost1 commented 2026-06-02 13:35:32 +00:00 (Migrated from gitlab.com)

Security review

SHA reviewed: 13c0cbfed3e48074d7f5c2f67052b6c9fb1dc821

Scope: docs-only — AGENTS.md native Postgres section, docs/testing/qa-local-full-stack.md cross-link

Outcome: Security review: no medium+ findings on this diff.

FINDINGS: 0

This is documentation-only that mirrors pre-existing dev defaults already in scripts (yieldomega/password@127.0.0.1:5433). No executable code, no new attack surface in production paths. Native Postgres setup binds to localhost per docs; CREATEDB is required for existing verify scripts; credentials are dev-only same as Docker path.

No inline threads needed.

## Security review **SHA reviewed:** `13c0cbfed3e48074d7f5c2f67052b6c9fb1dc821` **Scope:** docs-only — `AGENTS.md` native Postgres section, `docs/testing/qa-local-full-stack.md` cross-link **Outcome:** Security review: no medium+ findings on this diff. **FINDINGS:** 0 This is documentation-only that mirrors pre-existing dev defaults already in scripts (`yieldomega`/`password`@`127.0.0.1:5433`). No executable code, no new attack surface in production paths. Native Postgres setup binds to localhost per docs; `CREATEDB` is required for existing verify scripts; credentials are dev-only same as Docker path. No inline threads needed.
PlasticDigits commented 2026-06-02 13:47:08 +00:00 (Migrated from gitlab.com)

mentioned in commit 66460c50e5

mentioned in commit 66460c50e52b47305c6ef1bb63c6df87d4281fc7
PlasticDigits (Migrated from gitlab.com) merged commit 66460c50e5 into main 2026-06-02 13:47:08 +00:00
ghost1 commented 2026-06-02 13:50:11 +00:00 (Migrated from gitlab.com)

Security review

SHA reviewed: 13c0cbfed3e48074d7f5c2f67052b6c9fb1dc821 (merge 66460c50)

Scope: Docs only (AGENTS.md, docs/testing/qa-local-full-stack.md)

Outcome: FINDINGS: 0 / Security review: no medium+ findings on this diff


Automated security review — docs-only change documenting native Postgres 16 on port 5433 when Docker yieldomega-pg is unavailable. Documented credentials match existing local dev defaults in verify scripts. No application or contract code paths changed.

## Security review **SHA reviewed:** `13c0cbfed3e48074d7f5c2f67052b6c9fb1dc821` (merge `66460c50`) **Scope:** Docs only (`AGENTS.md`, `docs/testing/qa-local-full-stack.md`) **Outcome:** FINDINGS: 0 / Security review: no medium+ findings on this diff --- *Automated security review — docs-only change documenting native Postgres 16 on port 5433 when Docker `yieldomega-pg` is unavailable. Documented credentials match existing local dev defaults in verify scripts. No application or contract code paths changed.*
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
code/yieldomega!400
No description provided.