attach-session-to-jira

name	attach-session-to-jira
description	Attach the current AI session context to a Jira issue as a formatted comment. Useful for investigation, audit trail, handoff, debugging. Use when user says "attach session to Jira", "document on Jira", or "export context to AAP-XXXXX". Use when this capability is needed.
metadata	{"author":"dmzoneill"}

Attach Session to Jira

Exports AI session context and attaches it to a Jira issue. Includes session metadata, summary stats, key actions, related issue keys, and optional full transcript.

Inputs

Input	Type	Default	Purpose
issue_key	string	required	Jira issue key (e.g., AAP-12345)
session_id	string	""	Session ID to export. Empty = active session
include_transcript	bool	false	Include full conversation transcript (collapsible)

Workflow

1. Validate Issue Key

• Format: ^[A-Z]+-\d+$ (e.g., AAP-12345)
• If invalid: raise error with expected format

2. Get Session Info

• session_info(session_id=session_id) — Get current/requested session
• If "No Active Session" or "Session Not Found": raise error "Call session_start() first"
• Extract session_id from output if present

3. Attach to Jira

• jira_attach_session(issue_key=validated_issue_key, session_id=session_id, include_transcript=include_transcript)

4. Log

• memory_session_log(action="Attached session context to {issue_key}", details="Include transcript: {include_transcript}")

Output Format

{attach_result}

---

## Next Steps
1. **View on Jira:** [AAP-12345](https://issues.redhat.com/browse/AAP-12345)
2. **Export locally:** session_export_context() for markdown/JSON
3. **Share with team:** Link the Jira issue in Slack or email

Error Handling

Pattern	Message
Invalid issue key	Expected AAP-12345 format. Got: {input}
No active session	Run session_start() first
Failed to add comment	Check JIRA_JPAT, issue exists, VPN. Try jira_view_issue()

Key MCP Tools

• session_info, jira_attach_session, memory_session_log

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.