ai-engineering-fluency: Instructions file for GitHub Copilot

CLI — Architecture & Integration Guide

The CLI (cli/) is a standalone command-line tool that shares the session discovery and data access classes from the repo-root src/ folder but has its own aggregation pipeline. It is built with TypeScript and bundled via cli/esbuild.js into cli/dist/cli.js.

Key Files

• cli/src/helpers.ts: Shared helper functions — session discovery, file processing, stats aggregation. Imports all data access classes from src/.
• cli/src/commands/: One file per sub-command (stats, usage, environmental, fluency, diagnostics).
• cli/esbuild.js: Build script (esbuild bundles for the CLI and the session library entry). The shared JSON data files are imported straight from ../src and inlined by esbuild — nothing is copied, and the shared src/ imports no vscode, so no vscode alias/stub is needed.
• cli/tsconfig.json: paths alias points to ../src/*.

Developer Workflow

cd cli
pnpm install
pnpm run build            # development build
pnpm run build:production # minified release build

Or from the repo root:

./build.ps1 -Project cli

Adding a New Editor / Data Source

When adding support for a new editor or data source, wire it into both the shared src/ folder (see .github/instructions/vscode-extension.instructions.md) and this CLI.

Adapter architecture (issue #654): The CLI shares the adapter classes from src/adapters/ via buildAdapterRegistry and createDataAccessInstances in src/adapters/adapterRegistry.ts. Currently 11 adapters are registered: OpenCode, Crush, Continue, ClaudeCode, ClaudeDesktop, VisualStudio, MistralVibe, GeminiCli, CopilotChat, CopilotCli, JetBrains. The Copilot and JetBrains adapters own discovery but their handles() returns false, so processSessionFile() falls through to the existing per-format helpers (JSONL/JSON parsing) for those files. Order matters — register Copilot/JetBrains adapters last.