Repository navigation
ADO Lens 0.1.0 - #1
Merged
Merged
Conversation
- ado_work_item, ado_query, ado_create, ado_update (with preview and confirm for many items), ado_comment (@[name] mentions), ado_link; same CLI commands - checks before writing: fields by name, allowed values, required fields, people by name, state transitions; markdown to HTML and back - modes po / dev / full register only their tool sets - the PAT is only sent to Azure DevOps hosts; rule errors in plain words - README in both languages, SECURITY.md, issue templates
- adolens stats --live follows every MCP call as Claude makes it (tool, estimated tokens, ms, arguments, running total) - --tokens after any CLI command prints the size of the answer - config --show-tokens true ends every answer with [~N tokens], also for Claude
- ado_sprint: dates and working day, progress by state, estimates, remaining work vs capacity left (team and personal days off), attention list (stale, blocked, no estimate, no criteria, unassigned), task progress; an ended sprint is reported as ended - ado_board: columns with WIP limits and cards; moving a card sets the board column and the state mapped for the item's type - ado_backlog: priority order and reordering (above / below) - ado_my_day: mentions, own and followed items changed by others, pull requests waiting for review - CLI: sprint, board, backlog, myday
- ado_wiki: page tree, a page as markdown with its version and subpages, search with snippets - ado_wiki_write: create, append, prepend, or replace with the version from the last read; a page changed meanwhile is never overwritten (If-Match) - a refresh right after a refresh fetches the metadata again - release.ps1, release-notes.ps1 and the Release workflow (zip + SHA-256) - README: wiki tools, releasing
First release: work items, sprints, boards, backlogs and the wiki for Claude Desktop and Claude Code. - `adolens.exe`: MCP server over stdio and CLI with the same answers. - Connections (several organizations): `login`, `logout`, `connections`, `config`. PATs in Windows Credential Manager (`ado-lens:<connection>`); without one, `ADOLENS_PAT_<CONNECTION>` and then `AZURE_DEVOPS_PAT`. - Registration in Claude Desktop and Claude Code (`register` / `unregister`), never with a PAT in the Claude configuration; `status` warns about other entries that keep a PAT in plain text. - Local metadata (SQLite) per connection: work item types by backlog level, states, transitions, fields, required flags, defaults and allowed values; history of structure changes between refreshes. - Tools: `ado_status`, `ado_fields`. - Work items (tool set `work`): `ado_work_item` (compact item with markdown text, links, code links; comments and history on request), `ado_query` (WIQL or saved query), `ado_create` and `ado_update` (fields by name, allowed values, people by name, state only along the transitions, markdown → HTML, soft length notes; updates of more than `confirmBulkAbove` items are previewed and written with the preview's token), `ado_comment` (`@[name]` mentions), `ado_link`. Same commands in the CLI (`item`, `query`, `create`, `update`, `comment`, `link`). - Boards (tool set `boards`): `ado_sprint` (dates and working day, progress by state, estimates, remaining work vs capacity left with days off, attention list, task progress; ended sprints said plainly), `ado_board` (columns, WIP limits, cards; moving a card sets the column and the state mapped for its type), `ado_backlog` (priority order, reordering), `ado_my_day` (mentions, own and followed items changed by others, PRs waiting for review). CLI: `sprint`, `board`, `backlog`, `myday`. - Wiki (tool set `wiki`): `ado_wiki` (page tree, a page as markdown with its version and subpages, search with snippets) and `ado_wiki_write` (create, append, prepend, or replace with the version from the last read — a page changed meanwhile is never overwritten). CLI: `wiki`, `wiki-write`. - Modes `po` / `dev` / `full` choose the tool sets Claude sees; `config --add-toolset`, `--confirm-above`. - Inherited process names, bugs shown on the requirement backlog, disabled types listed by name. - The PAT is only ever sent to Azure DevOps hosts. `adolens api <path>` for development. - Releases: `release.ps1` (test or regular release from `dev`, private names and broken characters scan, CI, merge to `main`, tag, published package check), Release workflow with the package's SHA-256. - Usage log and `adolens stats` (answer sizes in tokens, times, empty answers); `stats --live` follows the calls as Claude makes them; `--tokens` on any command and `config --show-tokens true` show the size of each answer.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
First release: work items, sprints, boards, backlogs and the wiki for Claude Desktop and Claude Code.
adolens.exe: MCP server over stdio and CLI with the same answers.login,logout,connections,config. PATs in Windows Credential Manager(
ado-lens:<connection>); without one,ADOLENS_PAT_<CONNECTION>and thenAZURE_DEVOPS_PAT.register/unregister), never with a PAT in the Claude configuration;statuswarns about other entries that keep a PAT in plain text.defaults and allowed values; history of structure changes between refreshes.
ado_status,ado_fields.work):ado_work_item(compact item with markdown text, links, code links; comments andhistory on request),
ado_query(WIQL or saved query),ado_createandado_update(fields by name, allowed values,people by name, state only along the transitions, markdown → HTML, soft length notes; updates of more than
confirmBulkAboveitems are previewed and written with the preview's token),ado_comment(@[name]mentions),ado_link. Same commands in the CLI (item,query,create,update,comment,link).boards):ado_sprint(dates and working day, progress by state, estimates, remaining work vscapacity left with days off, attention list, task progress; ended sprints said plainly),
ado_board(columns, WIPlimits, cards; moving a card sets the column and the state mapped for its type),
ado_backlog(priority order,reordering),
ado_my_day(mentions, own and followed items changed by others, PRs waiting for review). CLI:sprint,board,backlog,myday.wiki):ado_wiki(page tree, a page as markdown with its version and subpages, search withsnippets) and
ado_wiki_write(create, append, prepend, or replace with the version from the last read — a pagechanged meanwhile is never overwritten). CLI:
wiki,wiki-write.po/dev/fullchoose the tool sets Claude sees;config --add-toolset,--confirm-above.adolens api <path>for development.release.ps1(test or regular release fromdev, private names and broken characters scan, CI, mergeto
main, tag, published package check), Release workflow with the package's SHA-256.adolens stats(answer sizes in tokens, times, empty answers);stats --livefollows the calls asClaude makes them;
--tokenson any command andconfig --show-tokens trueshow the size of each answer.