INB-117: correct documented SeaweedFS bucket and historical .mbox key #5

2026-06-08T13:06:49Z

Ghost commented

2026-06-08 13:06:49 +00:00

Summary

Aligns all documentation with the actual deployment values, so a new engineer reading the README can find the historical .mbox on the first try with one mc ls.

Bucket: inboxos-eml → inboxos
Object key: historical/all-mail.mbox → eml/historical/all-mail.mbox
Canonical URI: s3://inboxos/eml/historical/all-mail.mbox

Confirmed by Gitea Actions probe run #922 (runner-2, 799 MB read, end-to-end UPSERT into NocoDB). See INB-43.

Changes (9 files, +31 / -15)

README.md — new Historical archive section with canonical URI and mc ls hint.
.env.example — SEAWEEDFS_S3_BUCKET=inboxos.
docs/operations-runbook.md — §3.2 key example, §4.4 layout header + s3:// URI, §6.1 secret table, §6 env-var inventory.
.gitea/workflows/historical-pipeline.yml — comment + workflow_dispatch input example.
.gitea/workflows/live-pipeline.yml — comment.
pipelines/README.md — live + historical secret blocks.
scripts/setup_gitea_secrets.sh — SEAWEEDFS_S3_BUCKET default.
pipelines/historical_pipeline.py + live_pipeline.py — bucket_default kwarg.
INB-34 description — concrete-actions block updated to match (INB-34 itself is done via INB-43; this is a doc-text correction only).

Out of scope

No change to the runtime S3 read path. The Gitea repo secret SEAWEEDFS_S3_BUCKET is already inboxos; the live and historical pipelines read whatever value is in the env.
No ranged-GET refactor. The 799 MB archive is well under the 2 GB threshold.

Verification (acceptance criteria)

$ git grep -n 'inboxos-eml' -- ':!pipelines/_tests/'
$ echo $?  # 1 (zero hits)

$ git grep -nE '\bhistorical/all-mail.mbox\b' -- ':!pipelines/_tests/'
$ echo $?  # 1 (zero hits; the word-boundary \b before 'historical' is meaningful)

pipelines/_tests/test_historical_pipeline_offline.py intentionally retains inboxos-eml as a self-contained test-only string. The issue explicitly allows this.

Board approval

Linked to the docs PR review request: approval 777a1115

References

INB-117 — this issue.
INB-34 — original "find the .mbox" task; description corrected.
INB-43 — probe run #922 on runner-2 that confirmed the actual values.
Probe run: https://git.cloudinit.dev/cto-inboxos/inboxos/actions/runs/922

## Summary Aligns all documentation with the actual deployment values, so a new engineer reading the README can find the historical .mbox on the first try with one mc ls. - **Bucket:** inboxos-eml → inboxos - **Object key:** historical/all-mail.mbox → eml/historical/all-mail.mbox - **Canonical URI:** s3://inboxos/eml/historical/all-mail.mbox Confirmed by Gitea Actions probe run #922 (runner-2, 799 MB read, end-to-end UPSERT into NocoDB). See INB-43. ## Changes (9 files, +31 / -15) - README.md — new Historical archive section with canonical URI and mc ls hint. - .env.example — SEAWEEDFS_S3_BUCKET=inboxos. - docs/operations-runbook.md — §3.2 key example, §4.4 layout header + s3:// URI, §6.1 secret table, §6 env-var inventory. - .gitea/workflows/historical-pipeline.yml — comment + workflow_dispatch input example. - .gitea/workflows/live-pipeline.yml — comment. - pipelines/README.md — live + historical secret blocks. - scripts/setup_gitea_secrets.sh — SEAWEEDFS_S3_BUCKET default. - pipelines/historical_pipeline.py + live_pipeline.py — bucket_default kwarg. - INB-34 description — concrete-actions block updated to match (INB-34 itself is done via INB-43; this is a doc-text correction only). ## Out of scope - No change to the runtime S3 read path. The Gitea repo secret SEAWEEDFS_S3_BUCKET is already inboxos; the live and historical pipelines read whatever value is in the env. - No ranged-GET refactor. The 799 MB archive is well under the 2 GB threshold. ## Verification (acceptance criteria) ``` $ git grep -n 'inboxos-eml' -- ':!pipelines/_tests/' $ echo $? # 1 (zero hits) $ git grep -nE '\bhistorical/all-mail.mbox\b' -- ':!pipelines/_tests/' $ echo $? # 1 (zero hits; the word-boundary \b before 'historical' is meaningful) ``` pipelines/_tests/test_historical_pipeline_offline.py intentionally retains inboxos-eml as a self-contained test-only string. The issue explicitly allows this. ## Board approval Linked to the docs PR review request: approval 777a1115 ## References - INB-117 — this issue. - INB-34 — original "find the .mbox" task; description corrected. - INB-43 — probe run #922 on runner-2 that confirmed the actual values. - Probe run: https://git.cloudinit.dev/cto-inboxos/inboxos/actions/runs/922

Ghost added 1 commit 2026-06-08 13:06:50 +00:00

INB-117: correct documented SeaweedFS bucket and historical .mbox key

InboxOS — PR CI / Fast offline tests (pull_request) Successful in 28s

Details

InboxOS — PR CI / 100MB historical e2e (pull_request) Successful in 11m9s

Details

InboxOS — PR CI / Live Ollama extract smoke (pull_request) Successful in 51s

Details

034b08ff3e

The actual deployment uses bucket 'inboxos' (not 'inboxos-eml') and the
.mbox lives at key 'eml/historical/all-mail.mbox' (not 'historical/all-mail.mbox').
Full canonical URI: s3://inboxos/eml/historical/all-mail.mbox. Confirmed by
Gitea Actions run #922 (probe dispatch on runner-2, 799 MB read, end-to-end
UPSERT into NocoDB).

Updates:
- README.md: add Historical archive section with canonical URI and mc ls hint.
- .env.example: SEAWEEDFS_S3_BUCKET=inboxos.
- docs/operations-runbook.md: §3.2 key example, §4.4 layout header + s3:// URI,
  §6.1 secret table, §6 env-var inventory.
- .gitea/workflows/historical-pipeline.yml: comment + workflow_dispatch input.
- .gitea/workflows/live-pipeline.yml: comment.
- pipelines/README.md: live + historical secret blocks.
- scripts/setup_gitea_secrets.sh: SEAWEEDFS_S3_BUCKET default.
- pipelines/historical_pipeline.py + live_pipeline.py: bucket_default kwarg.

INB-34 description also updated to match (doc-text correction; INB-34 itself
is closed done in INB-43 with the correct values).

Test fixtures in pipelines/_tests/ retain the 'inboxos-eml' string as a
self-contained test-only value; the issue explicitly allows this.

Verification:
  git grep -n 'inboxos-eml' -- ':!pipelines/_tests/'     -> 0 hits
  git grep -n 'historical/all-mail.mbox' (no eml/ prefix) -> 0 hits

Refs: INB-34, INB-43 (probe run #922), INB-7

Co-Authored-By: Paperclip <noreply@paperclip.ing>

grimacing merged commit e5b039c9f0 into main

2026-06-08 14:56:42 +00:00

cpo referenced this pull request

2026-06-08 20:05:19 +00:00

CPO: backfill docs/requirements.md and docs/roadmap.md for 5 already-shipped PRs (INB-21/33/45/117/120) #9

cpo referenced this pull request

2026-06-08 20:15:36 +00:00

REQ-MVP-004: canonical SeaweedFS bucket and historical .mbox key — INB-117 #13

cpo referenced this pull request

2026-06-08 20:17:35 +00:00

CPO: backfill docs/requirements.md and docs/roadmap.md for 5 already-shipped PRs (INB-21/33/45/117/120) #9

Sign in to join this conversation.