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/util/GetServiceManifest.ts

@@ -1,7 +1,7 @@
-import { Effects } from "../../../base/lib/Effects"
-import { Manifest, PackageId } from "../../../base/lib/osBindings"
-import { DropGenerator, DropPromise } from "../../../base/lib/util/Drop"
-import { deepEqual } from "../../../base/lib/util/deepEqual"
+import { Effects } from '../../../base/lib/Effects'
+import { Manifest, PackageId } from '../../../base/lib/osBindings'
+import { DropGenerator, DropPromise } from '../../../base/lib/util/Drop'
+import { deepEqual } from '../../../base/lib/util/deepEqual'
 
 export class GetServiceManifest<Mapped = Manifest> {
   constructor(
@@ -45,7 +45,7 @@ export class GetServiceManifest<Mapped = Manifest> {
     this.effects.onLeaveContext(() => {
       resolveCell.resolve()
     })
-    abort?.addEventListener("abort", () => resolveCell.resolve())
+    abort?.addEventListener('abort', () => resolveCell.resolve())
     while (this.effects.isInContext && !abort?.aborted) {
       let callback: () => void = () => {}
       const waitForNext = new Promise<void>((resolve) => {
@@ -64,7 +64,7 @@ export class GetServiceManifest<Mapped = Manifest> {
       }
       await waitForNext
     }
-    return new Promise<never>((_, rej) => rej(new Error("aborted")))
+    return new Promise<never>((_, rej) => rej(new Error('aborted')))
   }
 
   /**
@@ -72,7 +72,7 @@ export class GetServiceManifest<Mapped = Manifest> {
    */
   watch(abort?: AbortSignal): AsyncGenerator<Mapped, never, unknown> {
     const ctrl = new AbortController()
-    abort?.addEventListener("abort", () => ctrl.abort())
+    abort?.addEventListener('abort', () => ctrl.abort())
     return DropGenerator.of(this.watchGen(ctrl.signal), () => ctrl.abort())
   }
 
@@ -96,7 +96,7 @@ export class GetServiceManifest<Mapped = Manifest> {
           }
         } catch (e) {
           console.error(
-            "callback function threw an error @ GetServiceManifest.onChange",
+            'callback function threw an error @ GetServiceManifest.onChange',
             e,
           )
         }
@@ -105,7 +105,7 @@ export class GetServiceManifest<Mapped = Manifest> {
       .catch((e) => callback(null, e))
       .catch((e) =>
         console.error(
-          "callback function threw an error @ GetServiceManifest.onChange",
+          'callback function threw an error @ GetServiceManifest.onChange',
           e,
         ),
       )
@@ -123,7 +123,7 @@ export class GetServiceManifest<Mapped = Manifest> {
             return next
           }
         }
-        throw new Error("context left before predicate passed")
+        throw new Error('context left before predicate passed')
       }),
       () => ctrl.abort(),
     )