hikoutei 0.3.4 → 0.3.6

package/dist/infrastructure/storage/sync/shared/syncRegistry.d.ts

@@ -1,9 +1,9 @@
 /**
- * SQLite registry/allowlist operations for the sync gateway.
+ * SQLite registry/allowlist operations for the sync provider.
  *
- * The local registry is the source of truth used to choose a gateway range.
+ * The local registry is the source of truth used to choose a provider range.
  * A caller cannot turn an arbitrary tab name into a sync target by merely
- * passing it to the gateway client.
+ * passing it to the provider client.
  */
 import { type RegisteredProjectionKind } from "../../../../domain/model/constants.js";
 import type { SqlExecutor, SqlStorageAdapter } from "../../../../adapter/persistence/contracts/sql.js";
@@ -25,7 +25,7 @@ export interface RegisterSyncSheetInput {
     /** Compatibility with the pre-foundation developer-metadata fixture path. */
     readonly anchorMode?: "business_key" | "developer_metadata";
 }
-/** Registry row used for all gateway requests. */
+/** Registry row used for all provider requests. */
 export interface RegisteredSyncSheet {
     readonly logicalSheetId: string;
     readonly physicalSheetId: string;

package/dist/infrastructure/storage/sync/shared/syncRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syncRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/storage/sync/shared/syncRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,uCAAuC,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACvG,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAsC1B,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAE5D,4EAA4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,4FAA4F;IAC5F,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,GAAG,oBAAoB,CAAC;CAC7D;AAED,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,oBAAoB,CAAC;CAC5D;AAED,gFAAgF;AAChF,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GACpE;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAEpC;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CA+DlC;AAED,yEAAyE;AACzE,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,qFAAqF;AACrF,wBAAsB,iCAAiC,CACrD,GAAG,EAAE,WAAW,EAChB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAS9B;AAED,sFAAsF;AACtF,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,iBAAiB,EAC1B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}
+{"version":3,"file":"syncRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/storage/sync/shared/syncRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,uCAAuC,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AACvG,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAsC1B,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAE5D,4EAA4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,4FAA4F;IAC5F,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,GAAG,oBAAoB,CAAC;CAC7D;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,oBAAoB,CAAC;CAC5D;AAED,gFAAgF;AAChF,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GACpE;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAEpC;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CA+DlC;AAED,yEAAyE;AACzE,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,qFAAqF;AACrF,wBAAsB,iCAAiC,CACrD,GAAG,EAAE,WAAW,EAChB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAS9B;AAED,sFAAsF;AACtF,wBAAsB,qCAAqC,CACzD,OAAO,EAAE,iBAAiB,EAC1B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}

package/dist/infrastructure/storage/sync/shared/syncRegistry.js

@@ -1,9 +1,9 @@
 /**
- * SQLite registry/allowlist operations for the sync gateway.
+ * SQLite registry/allowlist operations for the sync provider.
  *
- * The local registry is the source of truth used to choose a gateway range.
+ * The local registry is the source of truth used to choose a provider range.
  * A caller cannot turn an arbitrary tab name into a sync target by merely
- * passing it to the gateway client.
+ * passing it to the provider client.
  */
 import { STORAGE_ERROR_CODES, StorageError } from "../../errors.js";
 import { REGISTERED_PROJECTION_KINDS, } from "../../../../domain/model/constants.js";
@@ -197,7 +197,7 @@ function isRegisteredProjection(value) {
         value === REGISTERED_PROJECTION_KINDS.SYSTEM_STATE ||
         value === REGISTERED_PROJECTION_KINDS.SYNC_CONFLICTS;
 }
-/** Normalizes the v1 whole-column gateway boundary to the form accepted by Apps Script. */
+/** Normalizes the v1 whole-column provider boundary to the form accepted by the Sheets provider. */
 function normalizeRegisteredRange(value, errorCode) {
     const normalized = value.trim().toUpperCase();
     const match = /^([A-Z]+):([A-Z]+)$/.exec(normalized);

package/dist/infrastructure/storage/sync/shared/syncRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"syncRegistry.js","sourceRoot":"","sources":["../../../../../src/infrastructure/storage/sync/shared/syncRegistry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"syncRegistry.js","sourceRoot":"","sources":["../../../../../src/infrastructure/storage/sync/shared/syncRegistry.ts"],"names":[],"mappings":"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"}

package/dist/shared/encoding/types.d.ts

@@ -27,7 +27,7 @@ export type NormalizedCell = null | {
     readonly value: boolean;
 } | DateValue;
 /**
- * Physical Sheet metadata retained by the internal observation/gateway path.
+ * Physical Sheet metadata retained by the internal observation/provider path.
  * This compatibility type is intentionally not part of the public root API.
  */
 export interface CellObservation {

package/docs/architecture.md

@@ -5,7 +5,7 @@ asynchronous human-facing projection. SQLite is the authority; Sheets is an
 internal service-side projection and human input surface.
 
 > The root package API is ORM-only. Sheet synchronization is implemented inside
-> `src`, but its bootstrap, gateway, worker, and storage contracts are not root
+> `src`, but its bootstrap, worker, and storage contracts are not root
 > exports.
 
 ## System shape
@@ -20,7 +20,7 @@ Application code
                       ├─ durable Sheet effect outbox
                       ├─ outbound effect worker
                       ├─ User_Input polling
-                      └─ Apps Script gateway
+                      └─ sync provider (googleSheetsApi)
                            └─ Google Sheets projections
 ```
 
@@ -35,15 +35,14 @@ src/domain/                         pure normalization/evaluation/conflict rules
 src/application/orm/                public ORM facade and mapped flush planning
 src/application/sync/               internal sync engine and service bootstrap
 src/adapter/persistence/            SQLite/MikroORM implementation
-src/adapter/sheets/                 Apps Script transport and operation adapter
+src/adapter/sheets/                 Google Sheets API provider (sync provider contracts + implementation)
 src/infrastructure/storage/         canonical, observation, resolution, outbox state
 src/api/                            root-facing entity and EntityManager facade
 src/index.ts                        root public barrel only
-apps-script/gateway/                deployable Apps Script code
 ```
 
 `src` does not mean public. The only application-facing package entrypoint is
-`src/index.ts`; package subpaths for providers, gateway operations, polling,
+`src/index.ts`; package subpaths for providers, sync operations, polling,
 and sync state are not part of the contract.
 
 ## Root public API
@@ -76,7 +75,7 @@ await em.flush();
 The public surface contains entity definition, runtime creation, and the
 request-local `EntityManager` lifecycle: `fork()`, `create()`, `find()`,
 `findOne()`, `persist()`, `remove()`, `flush()`, and `transactional()`.
-MikroORM, raw SQL, gateway clients, Sheet routes, provisioning, polling, and
+MikroORM, raw SQL, provider clients, Sheet routes, provisioning, polling, and
 outbox controls are internal.
 
 ## SQLite authority
@@ -104,23 +103,53 @@ fixed headers are missing or drifted.
 ## Google Sheets projection
 
 The internal service provisions and validates registered projection tabs before
-starting delivery. It owns the signed Apps Script client, effect worker,
-response-loss recovery, reconciliation, and User_Input polling.
+starting delivery. It owns the sync provider (service-account Google Sheets API
+by default), effect worker, response-loss recovery, reconciliation, and
+User_Input polling.
 
 The application does not call Sheet operations. A successful public `flush()`
 means that the local SQLite transaction committed. It does not mean that a
 remote Sheet write has completed.
 
-The MVP gateway is a single file, `apps-script/gateway/Code.gs`, copied into a
-spreadsheet-bound Apps Script project and deployed as a Web App. The deployer
-pastes the `/exec` URL into `TYPED_SHEETS_GATEWAY_URL` and runs
-`setupSyncGateway()` from the editor, which stores the bound spreadsheet ID and
-a generated shared secret in Script Properties. This default path requires no
-`appsscript.json` manifest, no Apps Script Advanced Sheets Service, no Google
-Cloud Sheets API activation, and no service account. Sheet consistency does
-not rely on cross-request Sheet transactions; it comes from the Apps Script
-script lock, the hidden effect-receipt tab, effect-id/payload-hash dedupe, the
-SQLite durable outbox, fencing, and postcondition recovery.
+### Full direct provider (service account, preferred)
+
+The preferred production path uses the internal `googleSheetsApi` service
+option: ONE Google Sheets API provider under
+`src/adapter/sheets/providers/google-sheets-api/` implements every provider
+capability the runtime needs — provisioning, outbound effects (fast append,
+guarded update/delete, receipts, response-loss recovery), values-only table
+reads, row-anchor assignment, and full metadata snapshots. It authenticates
+with Application Default Credentials (`GOOGLE_APPLICATION_CREDENTIALS` service
+account shared on the spreadsheet), disables SDK auto-retry (retries are the
+durable worker's job), enforces request-start intervals of 1,100 ms per
+request class (reads and writes separately), and batches every applicable
+target mutation plus its receipt writes into one atomic
+`spreadsheets.batchUpdate`. The provider paces and reports every transport
+call individually; a serialized batch over ~2 MB is trimmed to an
+order-preserving prefix with `hasMore`. Transport failures are classified by
+the shared `classifyTransportOutcome` boundary: proven pre-mutation 4xx
+rejections are explicit remote failures, while timeouts, network errors,
+408/429/5xx, and malformed 2xx replies stay delivery-uncertain and are
+recovered through the shared postcondition probe path. Telemetry carries only
+operation names, counts, durations, and stable codes — never credentials,
+spreadsheet IDs, URLs, or payloads.
+
+Provisioning creates missing tabs and initializes header rows in one atomic
+batch and fails closed on any header drift; snapshot wire shapes (merged,
+error, formula, literal/blank cells plus stableHash evidence) are stable
+across providers, so reconciliation evidence is provider-independent. No Apps
+Script deployment is required.
+
+### Removed: Apps Script gateway
+
+The signed Apps Script gateway and the `appsScript`/`googleApiWorker` options
+were removed in this cleanup. The service-account `googleSheetsApi` provider
+above is the only sync path; existing deployments should switch to it. The
+provider reads and writes the same tabs, receipt sheet, and anchor metadata,
+so existing spreadsheets keep working without re-provisioning. Sheet
+consistency does not rely on cross-request Sheet transactions; it comes from
+the hidden effect-receipt tab, effect-id/payload-hash dedupe, the SQLite
+durable outbox, fencing, and postcondition recovery.
 
 `System_State` is materialized from canonical SQLite state. `User_Input` is
 observed by the internal polling loop, evaluated with ownership and field-level
@@ -153,7 +182,7 @@ internal outbound effect supervisor
   └─ reconcile remote drift
           │
           ▼
-Apps Script gateway ──▶ Google Sheets
+sync provider (googleSheetsApi) ──▶ Google Sheets
 
 internal User_Input polling
   ├─ adaptive values-only preflight over registered projections
@@ -171,15 +200,15 @@ a missing expected entity, or a type-invalid cell), or when the periodic safety
 full scan falls due. The safety scan (default one minute, configurable) keeps
 formula, merged, and error cell fidelity because the values-only read drops that
 metadata; the scan's overdue lag is recorded for diagnostics. Outbound effects
-are split into bounded sub-batches per physical route so one gateway call returns
+are split into bounded sub-batches per physical route so one provider call returns
 a complete result set, and a pass that only requeued uncertain work backs off with
 a bounded delay instead of retrying a struggling remote in a tight loop.
 
 The service bootstrap starts provisioning, outbound delivery, and inbound polling
 as one internal runtime. Outbound dispatch keeps the SQLite outbox as its only
 durable buffer, coalesces only a short in-process burst, and adapts each route's
-Gateway batch between five and twenty effects from latency and response-loss
-signals. The effect lease is longer than the configured Gateway timeout so a
+provider batch between five and twenty effects from latency and response-loss
+signals. The effect lease is longer than the configured provider timeout so a
 slow but valid request is recovered only after its remote result is checked.
 Ambiguous delivery is stored as `delivery_uncertain` with `uncertain_since`,
 `next_probe_at`, and `dispatch_id`; only a due probe may return it to processing.
@@ -192,4 +221,4 @@ supervisor, and only then closes SQLite.
 Hikoutei targets one local SQLite writer process and low-traffic MVP or internal
 workflows. It is not a distributed transaction coordinator, a general-purpose
 database, or a Google Sheets API replacement. Live Google integration remains
-opt-in; normal tests use fake gateways and SQLite fixtures.
+opt-in; normal tests use fake providers and SQLite fixtures.

package/docs/ci.md

@@ -5,8 +5,8 @@ package. Each is built as an installed consumer: after `npm pack` it imports
 from the packed tarball rather than from `src/**` or the source-only test
 fake, and neither is allowed to import those.
 
-1. **Internal sync/gateway E2E** (`scripts/ci/run-api-scenario.mjs`) drives the
-   internal typed-sheets sync pipeline — projection registration, gateway
+1. **Internal sync E2E** (`scripts/ci/run-api-scenario.mjs`) drives the
+   internal typed-sheets sync pipeline — projection registration, sheet
    provisioning, the bounded effect worker, polling, and the MikroORM-backed
    storage/CAS/hash machinery — and loads implementation modules directly from
    the packed `dist/` tree.
@@ -25,7 +25,7 @@ while the lifecycle itself imports only the root `hikoutei` entrypoint. This
 guards the boundary directly in an installed consumer in addition to the
 source-level tests.
 
-## Internal sync/gateway E2E
+## Internal sync E2E
 
 The scenario is built as an installed consumer: after `npm pack` it imports the
 package entrypoints from the packed tarball rather than from `src/**` or the
@@ -60,7 +60,7 @@ contacts Google Sheets, never needs credentials, and never provisions remote
 tabs, so it runs as a packed consumer only in the normal CI, develop, and stable
 verify jobs and has no live counterpart. It is local-only — an in-memory SQLite
 authority with no backend concept — not a fake-backend scenario like the
-internal sync/gateway E2E. Its entity lifecycle imports only the
+internal sync E2E. Its entity lifecycle imports only the
 root `hikoutei` package; the `hikoutei/orm` and `hikoutei/mikro-orm` dynamic
 imports it performs are negative boundary assertions that must be rejected,
 not part of the lifecycle.
@@ -68,7 +68,7 @@ not part of the lifecycle.
 ## Backends and triggers
 
 The normal CI, develop, and stable verification jobs run **both** installed-consumer
-scenarios — the internal sync/gateway E2E and the installed root API smoke. The
+scenarios — the internal sync E2E and the installed root API smoke. The
 internal E2E uses the **fake** backend (no Google Sheets contact, no
 credentials); the root API smoke is local-only, an in-memory SQLite authority
 (`:memory:`) with no backend concept. The workflows are:
@@ -84,32 +84,39 @@ credentials); the root API smoke is local-only, an in-memory SQLite authority
 - `.github/workflows/stable-publish.yml` verifies and publishes that tag with
   the `latest` dist-tag too.
 
-Only the internal sync/gateway E2E has a live variant, in the separate
+Only the internal sync E2E has a live variant, in the separate
 `.github/workflows/live-integration.yml` workflow. It is opt-in via
 `workflow_dispatch` — a maintainer with write access dispatches it explicitly;
 it never runs automatically on pull requests or pushes — and exercises
-that single scenario against real Google Sheets with `--backend=live`. The installed root API smoke has no live
+that single scenario against real Google Sheets with `--backend=live
+--outbound=direct`. The installed root API smoke has no live
 counterpart: it is a local-only lifecycle smoke against an in-memory SQLite
 authority, so it never runs there.
 
 Because live is opt-in via `workflow_dispatch`, it is triggered manually by a
 maintainer with write access rather than automatically on pull requests, so
-there is no forked-PR secret-exposure path. The three gateway secrets are
-scoped to the live execution and cleanup steps only, not the whole job, so
+there is no forked-PR secret-exposure path. The live path is
+service-account-only: the workflow materializes the service-account key in
+`$RUNNER_TEMP` and scopes the credential/spreadsheet environment to the live
+execution and cleanup steps only, not the whole job, so
 checkout/setup/install/build never see them. The live run uses a dedicated test
-spreadsheet and the following GitHub Actions secrets:
+spreadsheet shared with the service account and the following GitHub Actions
+secrets:
 
-- `TYPED_SHEETS_GATEWAY_URL`
-- `TYPED_SHEETS_GATEWAY_SHARED_SECRET`
-- `TYPED_SHEETS_GATEWAY_SHEET_ID`
+- `GOOGLE_SERVICE_ACCOUNT_CREDENTIALS_JSON` (the service-account key JSON)
+- `GOOGLE_SHEETS_TEST_SPREADSHEET_ID`
+
+No gateway is deployed or invoked — the live path is service-account-only, so
+the workflow needs only those two secrets.
 
 ## Cleanup
 
 Each live run generates unique tab names from the workflow run ID. The runner
 writes a manifest before provisioning, cleans those tabs in a `finally` path,
 and the workflow repeats cleanup with `if: always()` so a failed assertion does
-not leave the fixture behind. The Apps Script receipt tab is also removed by
-the cleanup operation. Do not point the live secrets at a production
+not leave the fixture behind. Cleanup uses the same service account
+(`deleteSheet` requests through the direct provider's transport) and removes
+the shared receipt tab too. Do not point the live secrets at a production
 spreadsheet; cleanup is intentionally scoped to the dedicated CI spreadsheet.
 
 ## Kohkai dependency
@@ -134,10 +141,11 @@ publishing Hikoutei. The first integration release therefore requires:
 2. merge the Hikoutei dependency integration;
 3. let the next develop release produce `0.3.2` from the current `0.3.1` baseline.
 
-Existing Hikoutei releases remain unchanged. Apps Script cannot import npm
-packages, so `apps-script/gateway/Code.gs` keeps the Hikoutei-specific gateway
-and its self-contained codec mirror; the root tests compare it with the pinned
-Kohkai compatibility vectors.
+Existing Hikoutei releases remain unchanged. The root
+`test/kohkai-compatibility.test.ts` pins the Hikoutei shared stable encoding to
+the Kohkai compatibility vectors and proves the local codec is byte-compatible
+with the generic `@hikoutei/kohkai` codec; the Apps Script codec mirror was
+removed with the gateway.
 
 ## Develop publication
 
@@ -148,7 +156,7 @@ an annotated tag such as `develop-v0.3.1`. The generated commit is guarded from
 being processed as another release.
 
 The tag triggers `.github/workflows/develop-publish.yml`. It repeats the
-unit/type/build/package checks, the installed-package internal sync/gateway
+unit/type/build/package checks, the installed-package internal sync
 E2E, and the installed root API smoke before publishing the numeric package
 version with the npm `latest` dist-tag. The version has no `-beta` suffix, and
 a plain `npm install hikoutei` resolves this channel:
@@ -226,8 +234,8 @@ npm install hikoutei
 ## Artifacts
 
 The CI, develop, and stable jobs each emit a JSON report for **both**
-scenarios (internal sync/gateway E2E and installed root API smoke). The live
-job emits a JSON report only for the internal sync/gateway E2E, the single
+scenarios (internal sync E2E and installed root API smoke). The live
+job emits a JSON report only for the internal sync E2E, the single
 scenario it runs. Both runner scripts (`run-api-scenario.mjs` and
 `run-root-api-scenario.mjs`) default their `--summary` option to
 `GITHUB_STEP_SUMMARY`, so in GitHub Actions every CI/develop/stable invocation
@@ -239,7 +247,7 @@ installed-consumer scenario reports as a dedicated reports artifact
 (`if: always()`), separate from the package artifact (`if: success()`) that the
 publish job consumes. Setup time and steady-state time are reported separately
 for the internal E2E so spreadsheet creation and header provisioning do not
-distort the internal sync/gateway measurements.
+distort the internal sync measurements.
 
 The develop and stable package artifacts are each a single directory that
 holds the npm tarball and its `sha256` checksum together under

package/docs/code-guidelines.md

@@ -13,7 +13,7 @@ The core value is safety around common Google Sheets-as-data-store failure modes
 - invalid row parsing
 - duplicate or missing key columns
 - API quota pressure
-- future write serialization through Apps Script
+- paced write serialization through the direct provider
 
 ## Positioning
 
@@ -60,8 +60,6 @@ MVP exclusions:
 - migration engine
 - lazy loading
 - multi-row atomic transactions
-- Apps Script automatic installation
-- Apps Script Web App gateway
 - caching
 - request collapse
 - retry/backoff
@@ -81,20 +79,15 @@ src/
   shared/                       # 도메인 간 공유 상수·인코딩·상태 계약
   application/
     orm/                        # 공개 ORM facade, mapping, flush 계획
-    sync/                       # worker, reconciliation, gateway orchestration
+    sync/                       # worker, reconciliation, Sheets 조정, telemetry
   adapter/
     persistence/
       contracts/                # 저장소 공통 계약
       providers/mikro-orm/      # 현재 MikroORM + SQLite 구현
     sheets/
-      providers/apps-script-gateway/
-        protocol/               # 서명·직렬화·응답 검증
-        transport/              # HTTP operation client
-        operations/
-          read/                 # 테이블 읽기
-          write/                # fast append
-          observation/           # snapshot·anchor 관측
-          effect/               # update/delete effect
+      providers/google-sheets-api/
+        transport/              # paced REST transport client
+        model/                  # preflight·planner·observation·batch 모델
   infrastructure/
     storage/                    # SQLite canonical state와 outbox
   index.ts
@@ -135,15 +128,16 @@ If a production source issue blocks the requested work, describe the blocker and
 ## Adapter Boundary
 
 Adapters are split by capability and provider. A provider is a concrete
-implementation such as MikroORM or Apps Script; a contract is the stable
-boundary that core, ORM, storage, or runtime code consumes.
+implementation such as MikroORM or the Google Sheets REST provider; a contract
+is the stable boundary that core, ORM, storage, or runtime code consumes.
 
 - `adapter/persistence/contracts/`: SQL and persistence contracts independent of
   MikroORM, Prisma, or another future implementation
 - `adapter/persistence/providers/mikro-orm/`: the current MikroORM-backed
   entity engine and SQLite storage bridge
-- `adapter/sheets/providers/apps-script-gateway/`: the current signed Apps Script
-  provider, separated into protocol, transport, and operation capabilities
+- `adapter/sheets/providers/google-sheets-api/`: the current direct Google
+  Sheets REST provider, separated into transport and model; the single sync
+  provider
 
 The adapter should expose sheet-level operations in terms the core needs, not Google-specific concepts.
 
@@ -210,8 +204,6 @@ After the MVP is stable, possible extensions are:
 - retry/backoff for 429 and transient 5xx
 - Google Sheet template generator
 - schema drift report
-- Apps Script installer CLI
-- Apps Script `LockService` write gateway
 - audit log sheet
 - `_createdAt` and `_updatedAt` system columns
 - GitHub Action for schema verification

package/docs/development.md

@@ -13,14 +13,33 @@ npm run build
 npm pack --dry-run
 ```
 
-The default test suite uses fake gateways and SQLite/MikroORM fixtures. It does
-not require live Google credentials.
+The default test suite uses a fake Sheets provider and SQLite/MikroORM fixtures.
+It does not require live Google credentials.
 
 ## Google integration tests
 
-Live Google Sheets tests are opt-in. They require a deployed Apps Script
-gateway, credentials, a spreadsheet, and consume external quota. Keep secrets
-in an untracked environment file and never commit them.
+Live Google Sheets tests are opt-in. The tracked live path is
+service-account-only: it requires a service-account key, a shared
+spreadsheet, and consumes external quota. Keep secrets in an untracked
+environment file and never commit them.
+
+The internal end-to-end scenario runs against the fake backend by default
+and against the live backend in full-direct mode:
+
+```sh
+node scripts/ci/run-api-scenario.mjs --backend fake
+node scripts/ci/run-api-scenario.mjs --backend live --outbound direct
+```
+
+The live backend is the service-account-only direct provider, used for
+provisioning, outbound effects, observation, `mutateRow`, and cleanup. It
+requires `GOOGLE_APPLICATION_CREDENTIALS` and
+`GOOGLE_SHEETS_TEST_SPREADSHEET_ID` — and nothing else. The report
+records only `sheetMatched: true` for the direct mode and never prints
+spreadsheet IDs.
+
+`--backend live` always runs the direct provider; the removed gateway mode no
+longer exists, so any `--outbound` value other than `direct` is rejected.
 
 ## Benchmarks
 
@@ -28,13 +47,17 @@ Performance measurements should be recorded in
 [`sync-bulk-write-benchmark.md`](sync-bulk-write-benchmark.md). Separate:
 
 - one-time setup from steady-state work
-- raw Gateway writes from full worker drain
+- raw transport writes from full worker drain
 - reconciliation from the normal append path
-- local SQLite/ORM time from HTTP and Apps Script time
+- local SQLite/ORM time from HTTP and provider time
 
 The benchmark history is not a universal Sheets performance guarantee. Network
-latency, Apps Script execution behavior, quotas, and spreadsheet state can
-change the result.
+latency, Sheets API behavior, quotas, and spreadsheet state can
+change the result. The full direct provider (`googleSheetsApi`) is not a
+performance claim either: the raw-transport benchmarks under `scripts/bench/`
+measure the unguarded API path (no receipts, no compare-and-set), while the
+provider adds fail-closed guarantees (receipts and compare-and-set), so its
+throughput is unverified until measured through the full worker.
 
 ## Package preview
 
@@ -44,5 +67,8 @@ Before publishing, inspect the tarball contents:
 npm pack --dry-run
 ```
 
-The package should include the built `dist/` output, public documentation, and
-the deployable [`apps-script/gateway/Code.gs`](../apps-script/gateway/Code.gs).
+The package should include the built `dist/` output and the public
+documentation only — no Apps Script deployment. The sync provider calls the
+Google Sheets REST API (`spreadsheets.get` / `spreadsheets.batchUpdate`)
+through a service account, so the tarball contains no gateway sources or
+manifest; the service account needs only the Spreadsheets scope.