Audit: complete the Fumadocs migration, correct the docs, repo hygiene

.changeset/config.json

@@ -7,5 +7,10 @@
   "access": "public",
   "baseBranch": "main",
   "updateInternalDependencies": "patch",
-  "ignore": ["@work-sdk/web"]
+  "ignore": [
+    "@work-sdk/web",
+    "@work-sdk/video",
+    "@work-sdk/example-approval-cli",
+    "@work-sdk/example-webhook-bot"
+  ]
 }

.gitignore

@@ -10,5 +10,3 @@ coverage
 !.env.example
 npm-debug.log*
 work/
-
-.vercel

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.5.0 — 2026-07-24
+
+- Return action-specific commit receipts: `commit()` narrows its result type to
+  the prepared action (`CommitResultFor`), and replay receipts are validated
+  against the prepared action before being returned.
+- Added compile-time API contract tests and a release gate that runs
+  package-lint and tarball smoke checks before publishing.
+
 ## 0.4.0 — 2026-07-24
 
 - Replaced the distributed-idempotency `get`/`set` recipe with an atomic
@@ -24,6 +32,12 @@
   landing-page documentation to describe real guarantees instead of
   overpromising exactly-once behavior.
 
+## 0.3.1 — 2026-07-24
+
+- Improved package discovery and evaluation with issue-tracker search metadata,
+  a credential-free safe-write example, a provider comparison, and clearer
+  guidance on when to use Work SDK.
+
 ## 0.3.0 — 2026-07-24
 
 - Added a GitLab.com and GitLab Self-Managed adapter with private-token and OAuth auth, search, pagination, Markdown notes, guarded labels, explicit issue-type maps, readback verification, and optimistic revision checks.

apps/web/.gitignore

@@ -1 +1,2 @@
 .vercel
+.source/

apps/web/app/api/search/route.ts

@@ -0,0 +1,5 @@
+import { createFromSource } from "fumadocs-core/search/server";
+
+import { source } from "@/lib/source";
+
+export const { GET } = createFromSource(source);

apps/web/app/docs/[[...slug]]/page.tsx

@@ -0,0 +1,58 @@
+import type { Metadata } from "next";
+import { notFound } from "next/navigation";
+import {
+  DocsBody,
+  DocsDescription,
+  DocsPage,
+  DocsTitle,
+} from "fumadocs-ui/layouts/docs/page";
+
+import { createPageMetadata } from "@/lib/site";
+import { source } from "@/lib/source";
+import { getMDXComponents } from "@/mdx-components";
+
+interface PageProps {
+  params: Promise<{ slug?: string[] }>;
+}
+
+export default async function DocPage(props: PageProps) {
+  const params = await props.params;
+  const page = source.getPage(params.slug);
+  if (!page) notFound();
+
+  const MDX = page.data.body;
+
+  return (
+    <DocsPage
+      breadcrumb={{ enabled: true }}
+      className="docs-content"
+      footer={{ enabled: false }}
+      id="main-content"
+      tableOfContent={{ enabled: page.data.toc.length > 0 }}
+      toc={page.data.toc}
+    >
+      <DocsTitle>{page.data.title}</DocsTitle>
+      <DocsDescription className="docs-lead">{page.data.description}</DocsDescription>
+      <DocsBody>
+        <MDX components={getMDXComponents()} />
+      </DocsBody>
+    </DocsPage>
+  );
+}
+
+export function generateStaticParams() {
+  return source.generateParams();
+}
+
+export async function generateMetadata(props: PageProps): Promise<Metadata> {
+  const params = await props.params;
+  const page = source.getPage(params.slug);
+  if (!page) notFound();
+
+  return createPageMetadata({
+    title: page.data.seoTitle ?? page.data.title,
+    description: page.data.description ?? "",
+    path: page.url as `/${string}`,
+    ...(page.data.keywords ? { keywords: page.data.keywords } : {}),
+  });
+}

apps/web/app/docs/docs.css

@@ -0,0 +1,24 @@
+@import "tailwindcss";
+@import "fumadocs-ui/css/neutral.css";
+@import "fumadocs-ui/css/preset.css";
+
+.work-docs-layout {
+  --fd-layout-width: 1400px;
+  min-height: calc(100dvh - 68px);
+  background: var(--bg);
+}
+
+.work-docs-layout #nd-sidebar {
+  border-color: var(--line);
+  background: color-mix(in srgb, var(--bg) 94%, transparent);
+}
+
+.work-docs-layout #nd-page {
+  min-width: 0;
+}
+
+@media (max-width: 760px) {
+  .work-docs-layout {
+    min-height: calc(100dvh - 62px);
+  }
+}