docs(core,shared): clarify task-id alphabet and utility contracts

packages/agentplane/src/shared/agent-emoji.ts

@@ -33,6 +33,10 @@ function fallbackEmojiForAgentId(agentId: string): string {
   return FALLBACK_EMOJIS[idx] ?? "🧩";
 }
 
+/**
+ * Resolve commit emoji for an agent.
+ * Priority: explicit `commit_emoji` in agent JSON -> well-known map/hash fallback.
+ */
 export async function resolveCommitEmojiForAgent(opts: {
   agentsDirAbs: string;
   agentId: string;

packages/agentplane/src/shared/guards.ts

@@ -1,3 +1,6 @@
+/**
+ * Type guard for plain object-like values (`Record<string, unknown>`).
+ */
 export function isRecord(value: unknown): value is Record<string, unknown> {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }

packages/core/src/tasks/task-id.ts

@@ -1,5 +1,6 @@
 import { randomInt } from "node:crypto";
 
+// Crockford's base32 alphabet: omits I, L, O (confusable with 1/0) and U (accidental obscenity).
 export const TASK_ID_ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
 
 export function timestampIdPrefix(date: Date): string {