feat(core): Add tracker CRUD tools & visualization

[anj-s]

This PR implements Phase 2 of the Task Tracker system.

Key features:

• Core CRUD tools: tracker_init, tracker_create_task, tracker_update_task, tracker_get_task, tracker_list_tasks.
• Relationship tools: tracker_add_dependency.
• CLI Visualization: tracker_visualize rendering ASCII tree with status emojis.
• Infrastructure: experimental.taskTracker feature flag.
• Foundation fixes: addressed bot review comments (secure IDs, runtime validation, performance optimization).

Closes #19545

[gemini-code-assist]

Summary of Changes

Hello @anj-s, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly advances the Task Tracker system by delivering its second phase. It provides a comprehensive set of tools for creating, reading, updating, and listing tasks, along with sophisticated dependency management and a visual representation of the task hierarchy. The entire feature set is controlled by an experimental flag, ensuring controlled rollout and testing.

Highlights

• Task Tracker Phase 2 Implementation: This pull request completes Phase 2 of the Task Tracker system, introducing core CRUD operations and visualization capabilities.
• New CRUD Tools: Implemented tools for tracker_init, tracker_create_task, tracker_update_task, tracker_get_task, and tracker_list_tasks to manage tasks.
• Dependency Management: Added tracker_add_dependency tool and robust validation within the TrackerService to prevent circular dependencies and ensure tasks can only be closed if their dependencies are met.
• CLI Visualization: Introduced tracker_visualize to render an ASCII tree visualization of the task graph, including status emojis.
• Feature Flag Integration: Integrated the task tracker functionality behind an experimental.taskTracker feature flag in the CLI configuration, allowing it to be enabled or disabled.
• Foundation Fixes and Testing: Addressed previous bot review comments and included comprehensive unit and integration tests for the new TrackerService and TrackerTools.

Changelog

• packages/cli/src/config/config.ts
  • Updated loadCliConfig to include the taskTracker experimental setting.
• packages/cli/src/config/settingsSchema.ts
  • Added experimental.taskTracker boolean setting to the CLI settings schema.
• packages/core/src/config/config.ts
  • Imported new trackerTools and TrackerService.
  • Extended ConfigParameters with a tracker boolean property.
  • Added trackerService and trackerEnabled properties to the Config class.
  • Initialized trackerEnabled in the Config constructor.
  • Implemented getTrackerService() and isTrackerEnabled() methods.
  • Conditionally registered all TrackerTools in createToolRegistry based on trackerEnabled.
• packages/core/src/config/trackerFeatureFlag.test.ts
  • Added new tests to verify the tracker feature flag correctly registers/unregisters tracker tools.
• packages/core/src/index.ts
  • Exported trackerService, trackerTypes, and trackerTools from the core package.
• packages/core/src/services/trackerService.test.ts
  • Added new tests for TrackerService covering initialization, task CRUD, dependency management, and circular dependency detection.
• packages/core/src/services/trackerService.ts
  • Added a new service for managing tasks, including file-based storage, ID generation, and dependency validation.
• packages/core/src/services/trackerTypes.ts
  • Added new Zod schemas and TypeScript types for TaskType, TaskStatus, and TrackerTask.
• packages/core/src/tools/definitions/trackerTools.ts
  • Added new tool definitions for all tracker tools (tracker_init, tracker_create_task, tracker_update_task, tracker_get_task, tracker_list_tasks, tracker_add_dependency, tracker_visualize).
• packages/core/src/tools/tool-names.ts
  • Added new constants for all tracker tool names.
  • Included new tracker tool names in ALL_BUILTIN_TOOL_NAMES.
• packages/core/src/tools/trackerTools.test.ts
  • Added new integration tests for TrackerTools, covering tracker_init, tracker_create_task, tracker_list_tasks, and tracker_update_task.
• packages/core/src/tools/trackerTools.ts
  • Added new tool implementations for all tracker tools, interacting with the TrackerService.
• plans/task-tracker-implementation.md
  • Updated the task tracker implementation plan, marking Phase 1 and Phase 2 tasks as completed.

Activity

• The pull request was created by anj-s.
• No human review comments or activity have been recorded yet.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request introduces a comprehensive task tracker feature, including CRUD tools, dependency management, and a command-line visualization. No concrete security issues or bugs were identified in the provided code changes. The review focused on performance optimizations in the new TrackerService and trackerTools to reduce redundant file I/O, improve algorithmic complexity, and leverage asynchronous operations efficiently, ensuring the feature scales well with a large number of tasks.

[abhipatel12]

LGTM