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
2 changes: 1 addition & 1 deletion .atomic-server-ref
Original file line number Diff line number Diff line change
@@ -1 +1 @@
8270cdf6a4d9e9c44dfab2e1f33b76bdcca3a2d7
11264e83e18ca59e0e0bd696eef6c8ac7ced5f68
10 changes: 5 additions & 5 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -34,8 +34,9 @@ name: CI
# dev-server.mjs for why it no longer proxies).
# - `integrations/localthought/mock-proxy.mjs` (the same fixture
# atomic-server's own dagger e2e pipeline runs) stands in for the real
# LocalThought integration proxy, so the Integrations-page flow can run
# without live provider credentials.
# integration proxy (`integration-proxy/`): it checks the proxy's 0.2
# signatures, capabilities and delegations the same way, with
# per-platform provider fixtures instead of live credentials.
#
# ## Job graph
#
Expand Down Expand Up @@ -68,9 +69,8 @@ name: CI
#
# No Rust/WASM tests run here: not the sandboxTests declared in each
# package's atomicCertification (those are atomic-server's own `cargo test`
# suite, run by its CI), and not localthought's browser-smoke.mjs (it
# needs a full Vite app). Building the atomic-server binary itself is unavoidable
# infrastructure, not a test.
# suite, run by its CI). Building the atomic-server binary itself is
# unavoidable infrastructure, not a test.

on:
pull_request:
Expand Down
21 changes: 13 additions & 8 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,9 +58,13 @@ in [`integrations/READINESS.md`](integrations/READINESS.md).
provider integrations. One ES module built by `app/build.mjs` that
exports `view({ root, store })`. atomic-server runs it as an App's entry
point in a null-origin iframe (`sandbox="allow-scripts allow-modals"`).
It never holds a credential: every provider call goes through the host relay
`store.proxy.request`/`.connections`/`.connect` (ontola/atomic-server#1657),
and the top page holds the integration-proxy connection. Reading uses
It never holds a credential: every provider call goes through
`store.proxy.request`/`.connections`/`.connect`. Since #54 phase 2
(ontola/atomic-server#1697) the connection lives at the integration
proxy, owned by the user's agent and delegated to the app's; the frame
calls the proxy itself with a short-lived capability from the page and a
key only it holds (`integrations/README.md`, "The host's proxy
access"). Reading uses
the npm `syncables/browser` package where an OpenAPI document drives the
paging, and optionally a lens from the npm `devonian` package for the
mapping. `pets/app/` (syncables), `notion/app/` (syncables plus a
Expand All @@ -81,8 +85,8 @@ in [`integrations/READINESS.md`](integrations/READINESS.md).
3. **Unhosted libraries** — mapping code, Devonian lenses and bridges with
no runtime of their own: `calendar/adapter.ts` and
`calendar/devonian/google-calendar/`, `issue-tracker/todoist.ts`, the
GitHub issues lens and bridge in `issue-tracker/devonian/github-issues/`,
and `BrowserIntegrations` (`localthought/browser.ts`). Their former
and the GitHub issues lens and bridge in
`issue-tracker/devonian/github-issues/`. Their former
hosts in atomic-server's data-browser (the LocalThought connect dialog
and sync panel, the Devonian demo) were removed; the data-browser no
longer imports anything from `integrations/`. A library reaches users
Expand Down Expand Up @@ -165,9 +169,10 @@ has been removed from this repo entirely — `atomic-server`'s WASM build
depends on it, so it belongs there, not here. See the "Building a
LocalThought" section of
[`integrations/README.md`](integrations/README.md#building-a-localthought-reflectorsyncablesdevonian-connector)
for the fuller architecture note, and the `describeIntegration`/
`fetchIntegration` machinery that depended on it, likewise removed from
[`integrations/localthought/browser.ts`](integrations/localthought/browser.ts).
for the fuller architecture note. The `describeIntegration`/
`fetchIntegration` machinery that depended on it was removed from
`integrations/localthought/browser.ts`, and that file itself was deleted in
#54 phase 2 with the proxy's rotating connection codes.

## overlays/

Expand Down
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ deprecated.
`localthought/overlays` repo with its history intact, and published by
GitHub Pages at https://ontola.github.io/atomic-plugins/overlays/.
- `integration-proxy/` — the Rust OAuth/API proxy (LocalThought) that drive
apps reach through atomic-server's host relay. See its own
apps reach through atomic-server's `store.proxy`. See its own
[README](integration-proxy/README.md) and [AGENTS.md](integration-proxy/AGENTS.md).
To run your own instance instead of atomic.place's, see
[integration-proxy/SELF_HOSTING.md](integration-proxy/SELF_HOSTING.md).
Expand All @@ -37,7 +37,7 @@ pinned atomic-server (`.atomic-server-ref`, `bae5cdbe3`), its scope, and
which evidence is unit, host E2E, live or historical.

In short, at that pin: the Pets and Notion drive apps import through the
host's integration-proxy relay and pass a host E2E against a mock proxy, but
host's `store.proxy` and pass a host E2E against a mock proxy, but
no host UI installs them from the catalog yet
([#94](https://github.com/ontola/atomic-plugins/issues/94)). Bank statements
is set up and fed files through the host's generic file entry point, after a
Expand All @@ -52,11 +52,11 @@ Screenshots are tracked in

| Plugin | What it does (catalog copy) | Current runtime | Code | Blocker |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 🐾 **Pets** | A trivial demo: imports five static pets into a Pets table. No account or network call. | Drive app over the host relay (read from a mock `pets` platform); the static no-network demo is a separate sandbox bundle | [`integrations/pets/`](integrations/pets/) | [#94](https://github.com/ontola/atomic-plugins/issues/94) |
| 📓 **Notion** | Sync supported row fields, property names and table or board views of a Notion database. Hidden (`enabled: false`). | Read-only drive app over the host relay; the two-way sandbox pilot has no host UI | [`integrations/notion/`](integrations/notion/) | [#94](https://github.com/ontola/atomic-plugins/issues/94), [#97](https://github.com/ontola/atomic-plugins/issues/97), [#8](https://github.com/ontola/atomic-plugins/issues/8) |
| 🐾 **Pets** | A trivial demo: imports five static pets into a Pets table. No account or network call. | Drive app over `store.proxy` (read from a mock `pets` platform); the static no-network demo is a separate sandbox bundle | [`integrations/pets/`](integrations/pets/) | [#94](https://github.com/ontola/atomic-plugins/issues/94) |
| 📓 **Notion** | Sync supported row fields, property names and table or board views of a Notion database. Hidden (`enabled: false`). | Read-only drive app over `store.proxy`; the two-way sandbox pilot has no host UI | [`integrations/notion/`](integrations/notion/) | [#94](https://github.com/ontola/atomic-plugins/issues/94), [#97](https://github.com/ontola/atomic-plugins/issues/97), [#8](https://github.com/ontola/atomic-plugins/issues/8) |
| ⏱️ **Clockify** | Bring completed Clockify time entries (past 7 or 30 days) into a Time Tracker. Import only. | Drive app, no connect/setup step yet | [`integrations/timesheets/`](integrations/timesheets/) | [#96](https://github.com/ontola/atomic-plugins/issues/96) |
| 🏦 **Bank statements** | Import bank transactions from MT940 and camt.053 statement exports; up to 500 transactions per file. No bank token. | Sandbox bundle, started from the host's generic file entry point (atomic-server#1653, in the pin); host E2E on synthetic statements | [`integrations/money/`](integrations/money/) | [#94](https://github.com/ontola/atomic-plugins/issues/94) (publication) |
| 🗓️ **Google Calendar** | Import one Google calendar's single (non-recurring) events into a table, and send reviewed edits of five fields back with `If-Match`. | Drive app over the host relay; mock-tested in a host e2e, not live-verified | [`integrations/calendar/`](integrations/calendar/) | [#94](https://github.com/ontola/atomic-plugins/issues/94) (install), live verification ([#101](https://github.com/ontola/atomic-plugins/issues/101)) |
| 🗓️ **Google Calendar** | Import one Google calendar's single (non-recurring) events into a table, and send reviewed edits of five fields back with `If-Match`. | Drive app over `store.proxy`; mock-tested in a host e2e, not live-verified | [`integrations/calendar/`](integrations/calendar/) | [#94](https://github.com/ontola/atomic-plugins/issues/94) (install), live verification ([#101](https://github.com/ontola/atomic-plugins/issues/101)) |
| ✅ **Todoist** (Devonian) | Bring Todoist projects and active tasks into a local issue tracker. Read only. | Projection library, no host | [`integrations/issue-tracker/`](integrations/issue-tracker/) | [#99](https://github.com/ontola/atomic-plugins/issues/99) |
| 🐙 **GitHub issues** (Devonian lens) | Maps GitHub issues and comments to and from Atomic issue-tracker resources. No catalog card. | Lens and bridge libraries, no host since atomic-server#1612 | [`integrations/issue-tracker/devonian/github-issues/`](integrations/issue-tracker/devonian/github-issues/) | [#100](https://github.com/ontola/atomic-plugins/issues/100) |
| 🐦 **Moneybird** | Import a Moneybird administration's bookkeeping records into typed tables. Read only. | Catalog entry and overlay only; no package here | — | [#102](https://github.com/ontola/atomic-plugins/issues/102) |
Expand Down
Loading
Loading