add documentation for ai agents (#3115)

* add documentation for ai agents

* docs: consolidate CLAUDE.md and CONTRIBUTING.md, add style guidelines

- Refactor CLAUDE.md to reference CONTRIBUTING.md for build/test/format info
- Expand CONTRIBUTING.md with comprehensive build targets, env vars, and testing
- Add code style guidelines section with conventional commits
- Standardize SDK prettier config to use single quotes (matching web)
- Add project-level Claude Code settings to disable co-author attribution

* style(sdk): apply prettier with single quotes

Run prettier across sdk/base and sdk/package to apply the
standardized quote style (single quotes matching web).

* docs: add USER.md for per-developer TODO filtering

- Add agents/USER.md to .gitignore (contains user identifier)
- Document session startup flow in CLAUDE.md:
  - Create USER.md if missing, prompting for identifier
  - Filter TODOs by @username tags
  - Offer relevant TODOs on session start

* docs: add i18n documentation task to agent TODOs

* docs: document i18n ID patterns in core/

Add agents/i18n-patterns.md covering rust-i18n setup, translation file
format, t!() macro usage, key naming conventions, and locale selection.
Remove completed TODO item and add reference in CLAUDE.md.

* chore: clarify that all builds work on any OS with Docker

sdk/package/lib/health/HealthCheck.ts

@@ -1,10 +1,10 @@
-import { Effects, HealthCheckId } from "../../../base/lib/types"
-import { HealthCheckResult } from "./checkFns/HealthCheckResult"
-import { Trigger } from "../trigger"
-import { TriggerInput } from "../trigger/TriggerInput"
-import { defaultTrigger } from "../trigger/defaultTrigger"
-import { once, asError, Drop } from "../util"
-import { object, unknown } from "ts-matches"
+import { Effects, HealthCheckId } from '../../../base/lib/types'
+import { HealthCheckResult } from './checkFns/HealthCheckResult'
+import { Trigger } from '../trigger'
+import { TriggerInput } from '../trigger/TriggerInput'
+import { defaultTrigger } from '../trigger/defaultTrigger'
+import { once, asError, Drop } from '../util'
+import { object, unknown } from 'ts-matches'
 
 export type HealthCheckParams = {
   id: HealthCheckId
@@ -59,15 +59,15 @@ export class HealthCheck extends Drop {
             try {
               let { result, message } = await o.fn()
               if (
-                result === "failure" &&
+                result === 'failure' &&
                 performance.now() - started <= gracePeriod
               )
-                result = "starting"
+                result = 'starting'
               await effects.setHealth({
                 name: o.name,
                 id: o.id,
                 result,
-                message: message || "",
+                message: message || '',
               })
               this.currentValue.lastResult = result
             } catch (e) {
@@ -76,11 +76,11 @@ export class HealthCheck extends Drop {
                 id: o.id,
                 result:
                   performance.now() - started <= gracePeriod
-                    ? "starting"
-                    : "failure",
-                message: asMessage(e) || "",
+                    ? 'starting'
+                    : 'failure',
+                message: asMessage(e) || '',
               })
-              this.currentValue.lastResult = "failure"
+              this.currentValue.lastResult = 'failure'
             }
           }
         } else triggered = false