Prepare Effect API Query 0.1.0 with HTTP streams and typed cache helpers

.fallowrc.jsonc

@@ -1,16 +1,19 @@
 {
   "$schema": "./node_modules/fallow/schema.json",
 
-  // Astro copies this browser entry from public/ and loads it through the
-  // Starlight head configuration, which static import analysis cannot follow.
-  "entry": ["apps/docs/public/package-version.js", "playwright.docs.config.ts"],
+  "entry": [
+    "scripts/measure-construction.mts",
+    "scripts/verify-docs-examples.mts",
+    "apps/docs/public/package-version.js",
+    "playwright.docs.config.ts",
+    "tests/types/*.{ts,tsx}"
+  ],
 
   "ignorePatterns": ["examples/tanstack-start/src/routeTree.gen.ts"],
 
-  // Framework tooling consumes these exports through convention-generated entries.
   "ignoreExports": [
     {
-      "file": "apps/docs/astro.config.mjs",
+      "file": "apps/docs/astro.config.mts",
       "exports": ["default"]
     },
     {
@@ -27,10 +30,9 @@
     }
   ],
 
-  // Each executable example keeps its resource ownership and cancellation
-  // workflow and UI in place so readers can understand and copy the integration.
-  // Fingerprints expire when the duplicated code or occurrence count changes.
   "duplicates": {
+    "mode": "semantic",
+    "near": true,
     "ignoredClones": [
       "dup:22704c46:2",
       "dup:3fec4231:2",
@@ -54,21 +56,21 @@
     ]
   },
 
-  // Vite+ tasks, packing, and imported lint presets invoke tools Fallow cannot trace.
-  // Keep Effect peer and test dependencies available for the library and fixtures.
   "ignoreDependencies": [
     "@arethetypeswrong/cli",
+    "@effect/platform-node",
     "@effect/tsgo",
     "@effect/vitest",
     "@shadcn/lint",
+    "@tanstack/intent",
     "effect",
     "publint",
+    // React belongs to the private apps; Fallow attributes shared example sources to the root.
+    "react",
     "typescript-5.9",
     "unplugin-unused"
   ],
 
-  // Health measures shipped library code in src/. Exclude docs, examples,
-  // tooling, and tests here; other audits retain their repository-wide scope.
   "health": {
     "ignore": [
       "apps/**",
@@ -85,8 +87,13 @@
   "rules": {
     "private-type-leaks": "error",
 
-    // Public-entry suppressions are valid in the entry audit but necessarily
-    // look stale in production mode, where package entry exports are exempt.
     "stale-suppressions": "off"
-  }
+  },
+
+  "overrides": [
+    {
+      "files": ["src/index.ts"],
+      "rules": { "unused-types": "off" }
+    }
+  ]
 }

.github/actions/setup-repository/action.yml

@@ -1,12 +1,6 @@
 name: Set up repository
 description: Install the pinned package manager, Vite+, and workspace dependencies.
 
-inputs:
-  cache:
-    description: Whether setup-vp should restore and save its dependency cache.
-    required: false
-    default: 'true'
-
 runs:
   using: composite
   steps:
@@ -17,6 +11,6 @@ runs:
       uses: voidzero-dev/setup-vp@1b32467adbe183473499fd9d5d372c3ed9641754 # v1.18.0
       with:
         node-version-file: .node-version
-        cache: ${{ inputs.cache }}
+        cache: true
         run-install: |
           args: ['--frozen-lockfile']

.github/workflows/ci.yml

@@ -2,9 +2,6 @@ name: CI
 
 on:
   pull_request:
-  push:
-    branches:
-      - main
   schedule:
     - cron: '17 4 1 * *'
   workflow_call:
@@ -29,6 +26,7 @@ jobs:
         name: Check out repository
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
+          fetch-depth: 0
           persist-credentials: false
 
       - &setup_repository
@@ -38,49 +36,31 @@ jobs:
       - name: Verify formatting
         run: vp run format
 
-      - name: Construct package prerequisite
-        run: vp run pack
-
-      - name: Run type-aware linting
-        run: vp run lint
-
-      - name: Run TypeScript checking
+      - name: Check shipped skills
+        env:
+          INTENT_REVIEW_BASE: ${{ github.event.pull_request.base.sha }}
+        run: |
+          vp run skills-check
+          if [ -n "$INTENT_REVIEW_BASE" ]; then
+            vp exec intent maintainer check --base "$INTENT_REVIEW_BASE" --github-summary
+          else
+            vp exec intent maintainer check --github-summary
+          fi
+
+      - name: Run type-aware linting and TypeScript checking
         run: vp run typecheck
 
+      - name: Check public API compiler fixtures
+        run: vp run api-types
+
       - name: Run Effect diagnostics
         run: vp run effect-check
 
-      - name: Run Vitest
-        run: vp run test
-
       - name: Run Fallow audits
         run: vp run fallow
 
-  package-contract:
-    name: Package contract
-    needs: source-quality
-    runs-on: ubuntu-latest
-    timeout-minutes: 20
-
-    steps:
-      - *checkout
-      - *setup_repository
-
-      - name: Construct and inspect package
-        run: vp run pack
-
-      - name: Verify packed consumers and type scale
-        run: vp run packed-package
-
-      - name: Preserve verified package artifact
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: package-${{ github.sha }}
-          path: .artifacts/*.tgz
-          if-no-files-found: error
-          include-hidden-files: true
-          compression-level: 0
-          retention-days: 7
+      - name: Run Vitest
+        run: vp run test
 
   example-builds:
     name: Example builds
@@ -98,6 +78,18 @@ jobs:
       - name: Build TanStack Start application
         run: vp run tanstack-start-build
 
+      - name: Preserve application builds
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: application-builds
+          path: |
+            dist
+            examples/vite-react/dist
+            examples/tanstack-start/dist
+          if-no-files-found: error
+          include-hidden-files: true
+          retention-days: 7
+
   documentation:
     name: Documentation
     needs: source-quality
@@ -114,11 +106,20 @@ jobs:
       - name: Build documentation
         run: vp run docs-build
 
+      - name: Preserve documentation build
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: documentation-build
+          path: apps/docs/dist
+          if-no-files-found: error
+          include-hidden-files: true
+          retention-days: 7
+
   browser:
     name: Playwright (${{ matrix.browser }})
     needs:
-      - package-contract
       - example-builds
+      - documentation
     runs-on: ubuntu-latest
     timeout-minutes: 20
 
@@ -134,14 +135,25 @@ jobs:
       - *checkout
       - *setup_repository
 
+      - name: Restore application builds
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: application-builds
+
+      - name: Restore documentation build
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: documentation-build
+          path: apps/docs/dist
+
       - name: Install ${{ matrix.browser }}
         run: vp exec playwright install --with-deps ${{ matrix.browser }}
 
       - name: Check documentation in ${{ matrix.browser }}
-        run: vp run docs-e2e --project=${{ matrix.browser }}
+        run: vp run --ignore-depends-on docs-e2e --project=${{ matrix.browser }}
 
       - name: Run ${{ matrix.browser }} acceptance tests
-        run: vp run e2e:${{ matrix.browser }}
+        run: vp run --ignore-depends-on e2e:${{ matrix.browser }}
 
       - name: Preserve Playwright failure diagnostics
         if: failure()

.github/workflows/deploy-docs.yml

@@ -2,6 +2,12 @@ name: Deploy documentation
 
 on:
   workflow_call:
+    inputs:
+      build-artifact:
+        description: Validated documentation artifact from this workflow run.
+        required: false
+        type: string
+        default: ''
   workflow_dispatch:
 
 permissions:
@@ -20,23 +26,32 @@ jobs:
     timeout-minutes: 15
 
     steps:
+      - name: Restore validated documentation
+        if: inputs.build-artifact != ''
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: ${{ inputs.build-artifact }}
+          path: apps/docs/dist
+
       - name: Check out repository
+        if: inputs.build-artifact == ''
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           fetch-depth: 0
           persist-credentials: false
 
       - name: Set up repository
+        if: inputs.build-artifact == ''
         uses: ./.github/actions/setup-repository
 
-      - name: Check documentation
-        run: vp run docs-check
+      - name: Build documentation
+        if: inputs.build-artifact == ''
+        run: vp run docs-build
 
-      - name: Build and upload documentation
-        uses: withastro/action@e84f40bd8d2caa9e768ec82ad30dd81f0b280853 # v6
+      - name: Upload documentation
+        uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5
         with:
-          package-manager: pnpm@12.8.2
-          path: ./apps/docs
+          path: apps/docs/dist
 
   deploy:
     name: Deploy documentation