docs: show where P comes from in P.tag snippets

Review feedback: several snippets call P.tag(...) without establishing that
P is unthrown's pattern namespace.

Standalone and random-access contexts now import it explicitly — the eight
TSDoc @example blocks (each renders as an isolated card in the API docs), the
root README client example, and the troubleshoot.md entry readers reach by
symptom rather than by reading top to bottom.

The linear how-to guides already import P at their first use, so their later
blocks are left alone. reference/errors.md keeps its one-line shape fragments
free of imports — no snippet on that page has ever carried one — and states
P's origin in prose instead.

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

Author: 2 people

README.md

@@ -84,6 +84,8 @@ export const activities = declareActivitiesHandler({
 Call it — names, arguments, and results all typed, and validated at runtime:
 
 ```typescript
+import { P } from "unthrown";
+
 const result = await client.executeWorkflow("processOrder", {
   workflowId: "order-123",
   args: { orderId: "ORD-1", customerId: "CUST-1", amount: 99.99 },

docs/how-to/troubleshoot.md

@@ -250,6 +250,8 @@ Since 8.0, `TechnicalError` and `RuntimeClientError` ride the defect channel.
 Handle them in `defect`, `recoverDefect`, or `tapDefect`:
 
 ```typescript
+import { P } from "unthrown";
+
 result.match({
   ok: (v) => v,
   errCases: (m) => m.with(P.tag("@temporal-contract/WorkflowFailedError"), handle),

docs/reference/errors.md

@@ -11,6 +11,9 @@ exhaustive matcher. Tags are namespaced with the package scope
 (`"@temporal-contract/…"`) so they never collide with your own or another
 library's. `.name` stays the bare class name for readable logs.
 
+The snippets on this page are shape fragments, not runnable programs. `P` is
+unthrown's pattern namespace throughout — `import { P } from "unthrown"`.
+
 ```typescript
 matcher.with(P.tag("@temporal-contract/WorkflowFailedError"), (error) => ...);
 ```

packages/client/src/client.ts

@@ -383,6 +383,8 @@ export class TypedClient<TContract extends ContractDefinition> {
    *
    * @example
    * ```ts
+   * import { P } from "unthrown";
+   *
    * const result = await client.schedule.create("processOrder", {
    *   scheduleId: "daily-sweep",
    *   spec: { cronExpressions: ["0 2 * * *"] },
@@ -516,6 +518,8 @@ export class TypedClient<TContract extends ContractDefinition> {
    *
    * @example
    * ```ts
+   * import { P } from "unthrown";
+   *
    * const handleResult = await client.startWorkflow('processOrder', {
    *   workflowId: 'order-123',
    *   args: { orderId: 'ORD-123' },
@@ -612,6 +616,8 @@ export class TypedClient<TContract extends ContractDefinition> {
    *
    * @example
    * ```ts
+   * import { P } from "unthrown";
+   *
    * const result = await client.signalWithStart('processOrder', {
    *   workflowId: 'order-123',
    *   args: { orderId: 'ORD-123', customerId: 'CUST-1' },
@@ -744,6 +750,8 @@ export class TypedClient<TContract extends ContractDefinition> {
    *
    * @example
    * ```ts
+   * import { P } from "unthrown";
+   *
    * const result = await client.executeWorkflow('processOrder', {
    *   workflowId: 'order-123',
    *   args: { orderId: 'ORD-123' },
@@ -888,6 +896,8 @@ export class TypedClient<TContract extends ContractDefinition> {
    *
    * @example
    * ```ts
+   * import { P } from "unthrown";
+   *
    * const handleResult = await client.getHandle('processOrder', 'order-123');
    * await handleResult.match({
    *   ok: async (handle) => {

packages/worker/src/activity.ts

@@ -293,6 +293,9 @@ export type ActivityMiddlewareNext<
  *
  * @example Log every activity invocation and its outcome (read-only)
  * ```ts
+ * import { ApplicationFailure } from '@temporal-contract/worker/activity';
+ * import { P } from "unthrown";
+ *
  * const logging: ActivityMiddleware = ({ activityName, workflowName }, next) =>
  *   next().tapErrCases((matcher) =>
  *     matcher.with(

packages/worker/src/cancellation.ts

@@ -31,6 +31,8 @@ import { makeAsyncResult } from "./internal.js";
  *
  * @example
  * ```ts
+ * import { P } from "unthrown";
+ *
  * const result = await context.cancellableScope(async () => {
  *   return await context.activities.processStep(...);
  * });

packages/worker/src/workflow.ts

@@ -610,6 +610,8 @@ type WorkflowContext<
    *
    * @example
    * ```ts
+   * import { P } from "unthrown";
+   *
    * // Same contract child workflow
    * const childResult = await context.startChildWorkflow(myContract, 'processPayment', {
    *   workflowId: 'payment-123',
@@ -659,6 +661,8 @@ type WorkflowContext<
    *
    * @example
    * ```ts
+   * import { P } from "unthrown";
+   *
    * // Same contract child workflow
    * const result = await context.executeChildWorkflow(myContract, 'processPayment', {
    *   workflowId: 'payment-123',