Skip to content

docs: update for 1.70 release#4981

Open
drernie wants to merge 7 commits into
masterfrom
docs/1.70-release-updates
Open

docs: update for 1.70 release#4981
drernie wants to merge 7 commits into
masterfrom
docs/1.70-release-updates

Conversation

@drernie

@drernie drernie commented Jun 15, 2026

Copy link
Copy Markdown
Member

Summary

Documents the user-facing Platform 1.70 changes that weren't already covered by earlier docs PRs (Iceberg #4950, Glacier admin/preferences #4921, ChatGPT/Databricks MCP #4880). Source: knowledge-base release-notes/1-70-0-release-notes.md.

Text changes

  • MCP-Server: add Codex to the supported-clients list and a Connecting Codex section (uses the default localhost loopback).
  • Preview: Markdown previews now render as standard CommonMark + GFM (Pandoc/PHP-Markdown-Extra shortcuts dropped); refresh image-preview support notes (jpeg/webp, floating-point, 16-bit color, 16-bit greyscale).
  • FileBrowser: document the new in-Catalog Glacier / Deep Archive rehydration flow (Rehydrate button → tier + duration, restore-state tracking, ui.actions.restore).
  • QuiltSync: Background Autosync (independent Pull/Push toggles, pull interval, quiet period), tray icon + Close to tray, live filesystem watcher, direction-labeled Merge actions, and the crates.io quilt CLI (cargo binstall quilt-cli).
  • Tabulator: note the Iceberg-index speedup (no more full S3 scans); replace the removed global *_packages-view join example with the per-bucket Iceberg package_manifest table.
  • Iceberg tables: admin note for the opt-in EnableLakeFormationGrants parameter.

Screenshots

Refreshed from current (1.70 / v0.18.1) builds, optimized with optipng:

  • Added quiltsync-autosync.png — Autosync + Filesystem Watcher settings panes.
  • Replaced the stale 2023 "Object Archived / Preview not available" Glacier shot with catalog-filesbrowser-glacier-rehydrate.png (now shows the Rehydrate button); removed the orphaned catalog-filesbrowser-glacier-objectview.png.
  • Added catalog-filesbrowser-glacier-rehydrate-dialog.png — the Rehydrate dialog (retrieval tier + duration).

Still on v0.17.0: quiltsync-settings.png (the full Settings window). It only illustrates the General/Commit/Auth/Diagnostics panes, which are still accurate, and the new Autosync/Filesystem-Watcher crop now covers the additions — so it's not misleading, but it could be swapped for a fresh full-window capture if desired.

Notes

  • markdownlint-cli2 passes with 0 errors on all changed files.
  • Items already shipped in prior docs PRs (per-bucket Iceberg tables, Glacier admin/preferences, ChatGPT/Databricks MCP setup) were left as-is.
  • Purely internal/admin items with no user-facing surface (canary runtime v15.1, Postgres/nginx upgrades, logo-preview robustness, Athena workgroup pagination, MCP hash-truncation fix) are intentionally not documented.

🤖 Generated with Claude Code

Document user-facing 1.70 changes not yet covered by earlier docs PRs:

- MCP-Server: add Codex to supported clients + Connecting Codex section
- Preview: Markdown now renders as CommonMark + GFM (drop Pandoc/PHP
  shortcuts); refresh image-preview support (jpeg/webp, float, 16-bit
  color, 16-bit greyscale)
- FileBrowser: document in-Catalog Glacier/Deep Archive restore (tier +
  duration, restore-state tracking, ui.actions.restore)
- QuiltSync: Background Autosync (Pull/Push toggles), tray icon + Close to
  tray, live filesystem watcher, direction-labeled Merge actions, and the
  crates.io quilt CLI (cargo binstall quilt-cli)
- Tabulator: note Iceberg-index speedup; replace removed *_packages-view
  join example with the per-bucket Iceberg package_manifest table
- Iceberg tables: admin note for EnableLakeFormationGrants

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@codecov

codecov Bot commented Jun 15, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 47.14%. Comparing base (970a231) to head (0b9154a).

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #4981   +/-   ##
=======================================
  Coverage   47.14%   47.14%           
=======================================
  Files         837      837           
  Lines       34482    34482           
  Branches     5882     5882           
=======================================
  Hits        16256    16256           
  Misses      16228    16228           
  Partials     1998     1998           
Flag Coverage Δ
api-python 93.14% <ø> (ø)
catalog 22.15% <ø> (ø)
lambda 96.91% <ø> (ø)
py-shared 98.02% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment thread docs/Catalog/MCP-Server.md Outdated
Comment on lines +184 to +187
Codex connects to the Platform MCP server over its local loopback callback,
so no additional `ConnectAllowedHosts` entry is required beyond the default
`localhost` (which enables both `http://localhost:<port>` and
`http://127.0.0.1:<port>`). Point Codex at:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Misleading "default localhost" claim

ConnectAllowedHosts defaults to empty (Connect is disabled until it is set to a non-empty value, per Connect.md). Calling localhost the "default" implies it is always present, but a deployment that only has, say, cursor://,claude.ai in the list will silently break Codex OAuth until localhost is explicitly added. The sentence should instead say something like "provided localhost is included in ConnectAllowedHosts" rather than "beyond the default localhost".

Comment on lines 169 to 176
```sql
SELECT
"ccle_tsv".*,
"udp-spec_packages-view".user_meta
m.metadata
FROM "quilt-tf-stable-tabulator"."udp-spec"."ccle_tsv"
JOIN "userathenadatabase-1qstaay0czbf"."udp-spec_packages-view"
ON "ccle_tsv".pkg_name = "udp-spec_packages-view".pkg_name
JOIN "udp-spec_package_manifest" m
ON "ccle_tsv"."$top_hash" = m.top_hash
```

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Unqualified Iceberg table in cross-database JOIN

Athena resolves unqualified table names against the currently selected database. The Tabulator side of this query uses the fully-qualified three-part form ("quilt-tf-stable-tabulator"."udp-spec"."ccle_tsv"), while the Iceberg side uses the bare name "udp-spec_package_manifest". If the Athena workgroup context is set to the Tabulator database (the normal context for Tabulator queries), the bare Iceberg reference will not resolve and the query will fail with a "Table not found" error. Either qualify the Iceberg table with its Glue database name (e.g., "<IcebergDatabase>"."udp-spec_package_manifest") or add a note that the query must be run with the IcebergDatabase selected as the current database context.

Comment thread docs/examples/quiltsync.md Outdated
Comment on lines +27 to +28
- Companion `quilt` command-line interface published to
[crates.io](https://crates.io)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 The features list links to the crates.io homepage instead of the specific crate page, making it difficult for readers to verify the crate or copy install instructions. Link directly to the crate.

Suggested change
- Companion `quilt` command-line interface published to
[crates.io](https://crates.io)
- Companion `quilt` command-line interface published to
[crates.io](https://crates.io/crates/quilt-cli)

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

drernie and others added 6 commits June 14, 2026 20:43
- Add quiltsync-autosync.png (Autosync + Filesystem Watcher settings) and
  reference it from the Background Autosync section; list both new panes in
  the Settings section
- Replace the stale "Object Archived / Preview not available" Glacier
  object-view screenshot with the new Rehydrate-button preview
  (catalog-filesbrowser-glacier-rehydrate.png) and add the Rehydrate dialog
  (catalog-filesbrowser-glacier-rehydrate-dialog.png) showing retrieval tier
  and duration; remove the now-orphaned objectview image
- All PNGs optimized with optipng

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…esystem Watcher panes)

optipng-optimized.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Admin: document that manual bucket-management ops on stack-managed S3
  buckets are denied by bucket policy; changes must go through CloudFormation
- Iceberg tables: say "stack-enabled Lake Formation enforcement" rather than
  implying account-level enforcement

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- MCP-Server: clarify localhost requires inclusion in ConnectAllowedHosts
- tabulator: qualify Iceberg join table with IcebergDatabase (cross-database)
- quiltsync: link directly to crates.io/crates/quilt-cli

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…nts are stack-level

Clarify the failure mode: when an AWS account enforces Lake Formation, the
stack must opt into EnableLakeFormationGrants or LF denies the stack roles
and per-bucket Iceberg access breaks. Previous wording wrongly described
enforcement as stack-enabled.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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