Skip to content

docs: align setup skill, docs and security suite with unified .env cloud config (#100 follow-up) - #106

Merged
bighadj22 merged 1 commit into
mainfrom
docs/env-unified-config-followup
Sep 9, 2026
Merged

docs: align setup skill, docs and security suite with unified .env cloud config (#100 follow-up)#106
bighadj22 merged 1 commit into
mainfrom
docs/env-unified-config-followup

Conversation

@bighadj22

Copy link
Copy Markdown
Owner

Follow-up to #100 (merged). The code was verified and merged; this closes the docs/config drift it left behind.

What

  • Setup skill (both .agents and .opencode copies): removed stale instructions to set COD_SERVER_URL in cod-astro/theme01/wrangler.jsonc (that vars block no longer exists); documented that COD_SERVER_URL is set in the root ..env and that npm run deploy refuses a localhost value without --force-local. Synced the .agents copy, which was also missing the Step 6b Sendili section.
  • cod-server/scripts/security/lib/common.sh: DB_NAME now resolves via cod-server/scripts/cloud-env.mjs (root .env COD_DB_NAME), keeping the DB_NAME=<name> env override and a safe fallback — this was the one remaining script hardcode and the reason the setup skill's grep gate failed.
  • docs/DEPLOYMENT.md, docs/CONFIGURATION.md, cod-astro/theme01/AGENTS.md: replaced instructions pointing at the removed vars block with the new .env-driven deploy flow.
  • De-hardcoded codflow-os-db in example commands: cod-server/README.md, CONTRIBUTING.md, docs/EMAIL-SENDING.md, docs/WHATSAPP-OTP-VERIFICATION.md, .agents/skills/whatsapp-otp/PLAN.md — commands now reference COD_DB_NAME / npm run db:migrate:remote / node scripts/d1.mjs.

Verification

  • Full cod-server suite: 1832 tests passing
  • common.sh: bash -n + sourced resolution check (DB_NAME=codflow-os-db from .env, override works)
  • Repo grep sweep: no codflow-os-db left in scripts/docs (only by-design defaults in cloud-env.mjs, .env.example, wrangler templates)

Docs-only change except common.sh, which is behavior-compatible (same default, now overridable via .env).

…oud config (#100 follow-up)

- setup skill: COD_SERVER_URL now set in root .env (not theme01 wrangler.jsonc),
  note the loopback deploy guard, sync .agents copy with .opencode (Sendili section)
- security suite (common.sh): DB_NAME resolves via cloud-env.mjs, DB_NAME env override kept
- DEPLOYMENT/CONFIGURATION/theme01 AGENTS: vars block is gone, deploy is .env-driven
- de-hardcode codflow-os-db in README, CONTRIBUTING, EMAIL-SENDING, WHATSAPP-OTP docs
@bighadj22
bighadj22 merged commit cb9708b into main Sep 9, 2026
3 checks passed
@bighadj22
bighadj22 deleted the docs/env-unified-config-followup branch September 9, 2026 06:09
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.

1 participant