ActionTracker

A local-first VS Code extension for managing action items, documents, and governance forums.

Features

• Action Management: Create, update, and track action items with statuses (open, in-progress, completed, blocked)
• Document Linking: Associate documents with actions and forums
• Forum Tracking: Manage governance forums and their relationships to action items
• Detail Views: Open dedicated detail panels for any data item with full field editing and linked item navigation
• Rich Data Types: Support for Actions, Documents, Forums, Risks, Controls, Roles, Policies, Processes, and Work Packages
• Local Storage: All data is stored locally in a JSON file with no external dependencies
• Rich UI: Interactive webview dashboard for visualizing and managing all data
• Export: Export all data to a JSON file for backup or sharing
• Copilot Chat Assistant: Ask natural-language questions or run quick action commands via GitHub Copilot Chat (@ActionTracker Copilot)

Copilot Chat Assistant

If you have GitHub Copilot Chat enabled (VS Code 1.93+), mention @ActionTracker Copilot in a chat window to:

• Ask free-form questions about the latest actions, documents, forums, or risks.
• Run structured commands:
  • list actions – returns the 10 most recent stored actions.
  • create action {"summary":"Upgrade VPN","detail":"Deploy client","status":"open"} – creates a new action.
  • update action <id> {"status":"in-progress"} – updates an existing action.
  • delete action <id> – removes an action by ID.

If Copilot is unavailable, the assistant gracefully reports that the feature is disabled. The chat participant is registered automatically during activation.

Usage

Detail Views

Each data type now has a dedicated detail view that displays:

• All data fields with proper formatting
• Inline editing capability (click "Edit" button)
• Status badges and priority indicators
• Linked/related items with clickable navigation
• Metadata (created date, updated date, etc.)

To open a detail view:

• Click on any item in the tree views (Actions, Documents, Forums)
• Use the "Edit" context menu option
• Use commands like actiontracker.openActionDetails with an item ID

The detail view allows you to:

• View all fields in a clean, formatted display
• Edit fields by clicking the "Edit" button
• Navigate to related items by clicking on linked items
• Delete the item with confirmation

Supported Data Types

• Action Items: Tasks with status, priority, assignee, due dates, and effort tracking
• Documents: Files or references with paths, URLs, versions, and types
• Forums: Meeting groups with chairs, schedules, and notes
• Risks: Tracked risks with levels, likelihood, impact, and mitigation plans
• Controls: Risk mitigation controls with types, effectiveness, and review dates
• Roles: Organizational roles with responsibilities and permissions
• Policies: Governance policies with status, versions, and approval workflows
• Processes: Operational processes with steps, inputs, and outputs
• Work Packages: Collections of related actions with timelines

Installation

1. Clone this repository
2. Run npm install to install dependencies
3. Press F5 to open a new VS Code window with the extension loaded
4. Open the Command Palette (Cmd+Shift+P) and run "ActionTracker: Open Dashboard"

Usage

Open Dashboard

1. Open Command Palette (Cmd+Shift+P)
2. Run "ActionTracker: Open Dashboard"
3. The dashboard will open in a new webview panel

Create an Action

1. In the dashboard, click "Add Action"
2. Fill in the form:
   • Summary (required)
   • Detail
   • Status
   • Linked Documents (comma-separated IDs)
   • Forums (comma-separated IDs)
3. Click "Save"

Export Data

1. In the Actions tab, click "Export Data"
2. Choose a location to save the JSON file
3. All actions, documents, and forums will be exported

Data Storage

All data is stored locally in:

~/.vscode/extensions/<publisher>.<extension-name>/globalStorage/actiontracker-data.json

The data file contains:

• actions[]: Array of action items
• documents[]: Array of linked documents
• forums[]: Array of governance forums

License

MIT