Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .agents/orbit.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,3 +2,4 @@
| --- | --- | --- | --- | --- |
| 2026-04-30 | Orbit | generated S3 Codex autoloop script set | `scripts/s3-autoloop/`, `.gitignore`, `README.md` | ready for bounded S3 implementation loop with foundation/full gates |
| 2026-05-01 | Orbit | generated DynamoDB Codex autoloop script set | `scripts/dynamodb-autoloop/`, `.gitignore` | ready for bounded DynamoDB implementation loop with staged verification gates |
| 2026-05-01 | Orbit | generated BigQuery Codex autoloop script set | `scripts/bigquery-autoloop/`, `.gitignore` | ready for bounded BigQuery REST v2 implementation loop with staged verification gates |
10 changes: 10 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,16 @@ scripts/dynamodb-autoloop/progress.md
scripts/dynamodb-autoloop/done.md
scripts/dynamodb-autoloop/iteration-*.out
scripts/dynamodb-autoloop/prompt-*.*
scripts/bigquery-autoloop/.run-loop.lock
scripts/bigquery-autoloop/.circuit-state
scripts/bigquery-autoloop/runner.jsonl
scripts/bigquery-autoloop/runner.log
scripts/bigquery-autoloop/state.env
scripts/bigquery-autoloop/state.env.sha256
scripts/bigquery-autoloop/progress.md
scripts/bigquery-autoloop/done.md
scripts/bigquery-autoloop/iteration-*.out
scripts/bigquery-autoloop/prompt-*.*
scripts/dashboard-design-renewal-autoloop/.run-loop.lock
scripts/dashboard-design-renewal-autoloop/.circuit-state
scripts/dashboard-design-renewal-autoloop/runner.jsonl
Expand Down
23 changes: 22 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Local cloud service emulator for development and E2E inspection.

`devcloud` runs a local dashboard plus compatible development endpoints for Mail, S3, GCS, and DynamoDB. It is designed for deterministic local tests and manual inspection, not for production workloads or full cloud-provider parity.
`devcloud` runs a local dashboard plus compatible development endpoints for Mail, S3, GCS, DynamoDB, and BigQuery. It is designed for deterministic local tests and manual inspection, not for production workloads or full cloud-provider parity.

## Quick Start

Expand All @@ -28,6 +28,7 @@ Default local endpoints:
| S3 | `http://127.0.0.1:4566` | `http://127.0.0.1:8025/s3` |
| GCS | `http://127.0.0.1:4443` | `http://127.0.0.1:8025/gcs` |
| DynamoDB | `http://127.0.0.1:8000` | `http://127.0.0.1:8025/dashboard/dynamodb` |
| BigQuery | `http://127.0.0.1:9050` | `http://127.0.0.1:8025/dashboard/bigquery` |

Useful commands:

Expand All @@ -52,6 +53,7 @@ server:
s3Port: 4566
gcsPort: 4443
dynamodbPort: 8000
bigqueryPort: 9050

auth:
smtp:
Expand All @@ -67,6 +69,10 @@ auth:
mode: relaxed
accessKeyId: dev
secretAccessKey: dev
bigquery:
mode: relaxed
project: devcloud
bearerToken: dev

storage:
path: .devcloud/data
Expand All @@ -93,6 +99,16 @@ services:
billingMode: PAY_PER_REQUEST
maxItemBytes: 400000
maxTables: 256
bigquery:
enabled: true
project: devcloud
location: US
maxRowsPerTable: 1000000
maxRequestBytes: 10485760
query:
maxResultRows: 10000
maxExecutionSeconds: 30
defaultUseLegacySql: false
```

## Support Matrix
Expand Down Expand Up @@ -224,6 +240,7 @@ VERIFY_STAGE=full bash scripts/mail-autoloop/verify.sh
VERIFY_STAGE=full bash scripts/s3-autoloop/verify.sh
VERIFY_STAGE=full bash scripts/gcs-autoloop/verify.sh
VERIFY_STAGE=full bash scripts/dynamodb-autoloop/verify.sh
VERIFY_STAGE=full bash scripts/bigquery-autoloop/verify.sh
```

Run E2E smoke tests:
Expand All @@ -233,6 +250,7 @@ scripts/mail-e2e.sh
scripts/s3-e2e.sh
scripts/gcs-e2e.sh
scripts/dynamodb-e2e.sh
scripts/bigquery-e2e.sh
```

Keep a service running after the E2E journey for browser/API inspection:
Expand All @@ -242,6 +260,7 @@ E2E_INTERACTIVE=true scripts/mail-e2e.sh
E2E_INTERACTIVE=true scripts/s3-e2e.sh
E2E_INTERACTIVE=true scripts/gcs-e2e.sh
E2E_INTERACTIVE=true E2E_DELETE_DATA=false scripts/dynamodb-e2e.sh
E2E_INTERACTIVE=true E2E_DELETE_DATA=false scripts/bigquery-e2e.sh
```

Override ports when defaults are already in use:
Expand All @@ -251,6 +270,7 @@ E2E_INTERACTIVE=true E2E_SMTP_PORT=1125 E2E_DASHBOARD_PORT=8125 scripts/mail-e2e
E2E_INTERACTIVE=true E2E_S3_PORT=14566 E2E_DASHBOARD_PORT=18025 E2E_SMTP_PORT=11025 scripts/s3-e2e.sh
E2E_INTERACTIVE=true E2E_GCS_PORT=14443 E2E_DASHBOARD_PORT=18025 scripts/gcs-e2e.sh
E2E_INTERACTIVE=true E2E_DYNAMODB_PORT=18000 E2E_DASHBOARD_PORT=18025 scripts/dynamodb-e2e.sh
E2E_INTERACTIVE=true E2E_BIGQUERY_PORT=19050 E2E_DASHBOARD_PORT=18025 scripts/bigquery-e2e.sh
```

## Project Structure
Expand All @@ -265,6 +285,7 @@ E2E_INTERACTIVE=true E2E_DYNAMODB_PORT=18000 E2E_DASHBOARD_PORT=18025 scripts/dy
| `internal/services/s3` | S3-compatible HTTP service and filesystem-backed object store. |
| `internal/services/gcs` | GCS JSON API-compatible HTTP service. |
| `internal/services/dynamodb` | DynamoDB-compatible JSON API service. |
| `internal/services/bigquery` | BigQuery-compatible REST API service. |
| `docs/` | Product and compatibility designs. |
| `mock/` | UI design mocks. |
| `scripts/*-autoloop/` | Bounded implementation-loop and verification scripts. |
Expand Down
Loading
Loading