Add Coding Agent Import

---
name: add-coding-agent-import
description: Add or review historical transcript import and live attach support for a coding agent, including session lookup, native parsing, synthetic lifecycle envelopes, shared translator use, incremental tailing, destination overrides, and import tests. Use when implementing or fixing import, attach, resume-session lookup, or transcript-following behavior.
---

# Add coding-agent transcript import

Require a production translator and a viable native transcript containing the
facts to import. If either is missing, use `add-coding-agent-translator` or report
the fidelity blocker before implementing import.

## Implement import and attach

- Expose the agent, aliases, and display name through the public import command.
- Locate exactly one transcript from a validated session ID across documented
  active and archived locations. Avoid unsafe symlink traversal and fail clearly
  on zero or multiple matches.
- Parse records with contextual file and line errors, schema-version handling,
  authoritative native session identity, and native timestamps.
- Convert transcript records into synthetic envelopes for the same source and
  translator used by live capture. Never create a second trace builder or invent
  facts that exist only in hooks.
- Keep historical import and live attach on the same parser, processor,
  translator, and sink state. Vary only waiting and finalization.
- Tail incrementally without duplicates, tolerate partial final records, keep an
  active turn open, and finalize it on interruption.
- Apply typed destination or exported parent overrides before transcript lookup
  and fail fast when the host has not supplied resolved session configuration.

## Verify completion

Test active and archived discovery, invalid and ambiguous IDs, malformed and
empty files, one and many turns, incremental growth, no-growth polls, partial
writes, finalization, destination and parent attachment, resume behavior, and
deterministic replay through the production translator.