Skip to content

ADO Lens 0.1.0 - #1

Merged
willowdev-code merged 5 commits into
mainfrom
dev
Oct 14, 2026
Merged

willowdev-code merged 5 commits into
mainfrom
dev

Conversation

@willowdev-code

Copy link
Copy Markdown
Owner

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.

- 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.
@willowdev-code
willowdev-code merged commit d2b2664 into main Oct 14, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant