用途：为代码加入"智能体优先"的可观测性，即在代码做出可能出错的决策处埋点，让下一个接手的人或智能体能读懂系统发生了什么。它强调的不是"到处打日志"，而是记录正确的信号。
适用时机：编写自动模式风格代码（循环、调度、守卫、重试）、添加后台任务或定时任务、编写服务器或长时间运行进程、重构难调试的子系统、处理"完全没有可见性"的生产故障。
主要能力与步骤：一是先梳理失败模式，包括无效输入、外部依赖失败、内部不变量破坏和静默数据损坏；二是在决策点写结构化日志，回答"做了什么决策、为什么、调试者会想知道什么"，并使用项目已有 logger；三是持久化失败状态到磁盘，例如写入 .gsd/runtime/last-error.json，便于冷启动读取；四是为长时进程提供健康端点或状态文件、摘要视图和少量关键指标；五是用显式错误类型、日志和抛出替代静默 try/catch；六是上线前清理临时调试埋点；七是模拟一个失败模式验证信号可达。
使用方式：遵循 gsd-2 已有模式，参考 src/resources/extensions/gsd/activity-log.ts 与 journal.ts 的结构化 JSONL 格式（每行一个事件，含 ts、event 及领域字段），并复用 atomic-write.ts 辅助函数和 .gsd/runtime/、.gsd/forensics/ 目录。
限制与注意事项：可观测性有成本，只添加真正会读取的内容；不要均匀打点、不要用散文式日志、不要静默吞掉异常、不要堆砌无人使用的指标、绝不记录密钥或 PII、避免在高频热路径过度埋点。
其他细节（如具体安装命令、价格、支持平台）暂未提供。