Skip to content

Refactor transcript handling and improve output messaging#75

Merged
dbrosio3 merged 1 commit into
mainfrom
solidify-transcript-domain-model
Jul 1, 2026
Merged

Refactor transcript handling and improve output messaging#75
dbrosio3 merged 1 commit into
mainfrom
solidify-transcript-domain-model

Conversation

@dbrosio3

@dbrosio3 dbrosio3 commented Jul 1, 2026

Copy link
Copy Markdown
Member

This pull request refactors the handling of transcript (developer-facing output) for both the Deterministic and Local AI review phases, introducing a unified, language-agnostic transcript module and updating documentation to reflect this architectural change. The main improvements are the introduction of the src/transcript module, migration of transcript event rendering out of the AI module, and consistent transcript streaming across phases.

Transcript system refactor and documentation update:

  • Introduced a new src/transcript module that owns language-agnostic, developer-facing output for both Deterministic and Local AI review phases, replacing phase-specific transcript logic. [1] [2] [3] [4]
  • Updated both Deterministic and Local AI runners to accept a transcript object instead of a raw stdout stream, and to use the new transcript interface for streaming output events. [1] [2] [3] [4] [5] [6] [7] [8]
  • Removed the old renderLocalAiTranscript and transcript event types from src/ai/transcript.ts and src/ai/types.ts, moving transcript event types to the new module. [1] [2] [3] [4]
  • Updated documentation (docs/architecture/overview.md, docs/architecture/modules.md, docs/architecture/runtime-flow.md) to document the new transcript module, its responsibilities, and integration points in the architecture and runtime flow. [1] [2] [3] [4] [5] [6] [7] [8] [9]
  • Ensured test coverage for transcript rendering by documenting new test files for the transcript module.

- Moved transcript-related functionality from runner to a dedicated transcript module.
- Introduced `createPushgateTranscript` to encapsulate different transcript types.
- Updated `runDeterministicChecks` to accept a transcript parameter instead of stdout.
- Enhanced output messages for local AI review and deterministic checks to provide clearer guidance.
- Added tests to validate new transcript functionality and ensure proper output formatting.
- Removed deprecated `transcript.ts` file and consolidated its functionality into the new structure.
@dbrosio3 dbrosio3 merged commit a10f5ec into main Jul 1, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant