Skip to content

Feature: Tool to review and extract assistant logs #68

Description

@adamd9

Summary:
Add a developer tool to the repository that allows the assistant (and developers) to review, export, and extract runtime/log data produced during Copilot/assistant sessions. This will help with debugging, auditability, and building summarized reports from background tasks.

Requirements:

  • Implement a lightweight CLI tool (Node.js script or Python) under tools/log-reviewer/ that can:
    • Locate session folders (sessions/*) and list available sessions with metadata (timestamp, task name, agent id).
    • Extract key files: report.md, screenshots, and any stdout/stderr logs into a single ZIP for download.
    • Produce a short JSON summary for each session (products found, links, gitSync status if present).
    • Optionally filter sessions by date range or keyword.
  • Include unit tests for core parsing functions.
  • Add README with usage examples and how to run locally (npm install / python -m venv instructions).
  • Ensure tool writes outputs to ./exports/ and does not modify original session files.

Acceptance criteria:

  1. CLI can list sessions and export a selected session into a ZIP containing report.md, screenshots, and a metadata.json.
  2. README documents usage and example commands.
  3. Tests cover parsing of report.md metadata and ZIP creation.
  4. Include a sample export generated from an existing session in sessions/ (if present) saved to sessions/sample-exports/.

Workflow requested for Copilot agent:

  1. Create a branch feat/log-reviewer.
  2. Implement the tool under tools/log-reviewer/ (Node.js or Python).
  3. Run tests and generate a sample export from the latest session.
  4. Commit and push the branch and open a PR linking to this issue. If push fails, attach the created files to the issue and note the push failure.

Priority: Medium
Labels: enhancement, tooling, developer-experience

Notes for implementer:

  • Security: do not commit any secrets. The tool should handle file paths safely.
  • The Master (user) expects this tool to enable the assistant to locate and extract session logs autonomously in future tasks.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions