onetaskgraph-plugin-api 0.12.13

The plugin contract onetaskgraph sources implement: the traits, the work types, and the capability declaration.
Documentation
# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [0.12.13]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.12.12...onetaskgraph-plugin-api-v0.12.13 - 2026-10-30

### Added

- project human tasks through existing tracker routing ([#3824]https://github.com/nickderobertis/onetaskgraph/pull/3824)

## [0.12.11]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.12.10...onetaskgraph-plugin-api-v0.12.11 - 2026-10-29

### Fixed

- *(github-projects)* file a private home's public task in a private repository ([#3804]https://github.com/nickderobertis/onetaskgraph/pull/3804)

## [0.12.10]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.12.9...onetaskgraph-plugin-api-v0.12.10 - 2026-10-29

### Fixed

- *(deps)* move pulldown-cmark past the wikilink event-growth advisory ([#3802]https://github.com/nickderobertis/onetaskgraph/pull/3802)

## [0.12.9]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.12.8...onetaskgraph-plugin-api-v0.12.9 - 2026-10-28

### Added

- *(locate)* answer where an item lands, its counterpart and its issue's repository ([#3791]https://github.com/nickderobertis/onetaskgraph/pull/3791)

## [0.12.4]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.12.3...onetaskgraph-plugin-api-v0.12.4 - 2026-10-25

### Fixed

- *(linear)* [**breaking**] take what Linear stores from each write's own answer ([#3762]https://github.com/nickderobertis/onetaskgraph/pull/3762)

## [0.12.3]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.12.2...onetaskgraph-plugin-api-v0.12.3 - 2026-10-25

### Performance

- *(copy)* remove redundant screening and hosted reads ([#3749]https://github.com/nickderobertis/onetaskgraph/pull/3749)

## [0.12.1]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.12.0...onetaskgraph-plugin-api-v0.12.1 - 2026-10-24

### Added

- support task-owned visibility and private coordination projections ([#3725]https://github.com/nickderobertis/onetaskgraph/pull/3725)

## [0.12.0]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.11.1...onetaskgraph-plugin-api-v0.12.0 - 2026-10-24

### Added

- [**breaking**] read dependencies from a task's own record, naming private ones opaquely ([#3724]https://github.com/nickderobertis/onetaskgraph/pull/3724)

## [0.9.2]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.9.1...onetaskgraph-plugin-api-v0.9.2 - 2026-10-20

### Added

- *(copy)* [**breaking**] record the body_digest of what Linear stores ([#3687]https://github.com/nickderobertis/onetaskgraph/pull/3687)

### Performance

- *(github-projects)* write a copied item in fewer requests ([#3692]https://github.com/nickderobertis/onetaskgraph/pull/3692)

## [0.9.1]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.9.0...onetaskgraph-plugin-api-v0.9.1 - 2026-10-20

### Performance

- *(copy)* copy and list a plan without reading the whole board ([#3679]https://github.com/nickderobertis/onetaskgraph/pull/3679)

## [0.9.0]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.8.0...onetaskgraph-plugin-api-v0.9.0 - 2026-10-19

### Added

- *(status)* [**breaking**] move a project item with its issue's closure and set a project's status ([#3681]https://github.com/nickderobertis/onetaskgraph/pull/3681)

## [0.8.0]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.7.3...onetaskgraph-plugin-api-v0.8.0 - 2026-10-19

### Added

- *(status)* [**breaking**] complete landed issues and skip unrepresentable copies ([#3677]https://github.com/nickderobertis/onetaskgraph/pull/3677)

## [0.7.1]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.7.0...onetaskgraph-plugin-api-v0.7.1 - 2026-10-15

### Added

- *(cache)* serve Linear comments and dependency reads from the cache ([#3619]https://github.com/nickderobertis/onetaskgraph/pull/3619)

## [0.7.0]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.6.1...onetaskgraph-plugin-api-v0.7.0 - 2026-10-14

### Added

- *(cache)* [**breaking**] cache every vouched project and document read ([#3609]https://github.com/nickderobertis/onetaskgraph/pull/3609)

## [0.6.0]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.5.0...onetaskgraph-plugin-api-v0.6.0 - 2026-10-12

### Added

- *(cache)* [**breaking**] cache remote items and comments per source, served only against a token in hand ([#3595]https://github.com/nickderobertis/onetaskgraph/pull/3595)

## [0.5.0]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.4.0...onetaskgraph-plugin-api-v0.5.0 - 2026-10-12

### Added

- *(copy)* [**breaking**] carry comments, skip items unchanged since the last copy, and copy by query ([#3593]https://github.com/nickderobertis/onetaskgraph/pull/3593)

## [0.3.12]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.3.11...onetaskgraph-plugin-api-v0.3.12 - 2026-10-10

### Added

- classify store items and enforce private destinations ([#3580]https://github.com/nickderobertis/onetaskgraph/pull/3580)

## [0.3.3]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.3.2...onetaskgraph-plugin-api-v0.3.3 - 2026-10-07

### Added

- *(assets)* carry image assets with tasks and documents across copies ([#3392]https://github.com/nickderobertis/onetaskgraph/pull/3392)

## [0.3.2]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.3.1...onetaskgraph-plugin-api-v0.3.2 - 2026-10-06

### Added

- *(projects)* render a project's description from a template, with provenance and stored answers ([#3334]https://github.com/nickderobertis/onetaskgraph/pull/3334)

## [0.3.1]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.3.0...onetaskgraph-plugin-api-v0.3.1 - 2026-10-06

### Added

- *(engine)* let a long-lived Engine end a command so sources drop what a person can change ([#3307]https://github.com/nickderobertis/onetaskgraph/pull/3307)

## [0.3.0]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.58...onetaskgraph-plugin-api-v0.3.0 - 2026-10-06

### Added

- *(status)* [**breaking**] scope status_mapping by item kind, refuse unmapped statuses, and drop Linear's by-type fallback ([#3262]https://github.com/nickderobertis/onetaskgraph/pull/3262)

## [0.2.55]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.54...onetaskgraph-plugin-api-v0.2.55 - 2026-10-02

### Added

- *(store)* read items in batches and copy without repeating a lookup ([#3105]https://github.com/nickderobertis/onetaskgraph/pull/3105)

## [0.2.52]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.51...onetaskgraph-plugin-api-v0.2.52 - 2026-09-29

### Added

- *(github-projects)* answer text, metadata and origin queries with GitHub's own search ([#2983]https://github.com/nickderobertis/onetaskgraph/pull/2983)
- *(copy)* record where an item was copied to and follow that link on every later copy ([#2967]https://github.com/nickderobertis/onetaskgraph/pull/2967)

## [0.2.50]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.49...onetaskgraph-plugin-api-v0.2.50 - 2026-09-29

### Added

- *(query)* filter tasks by comment activity with --commented-since ([#2916]https://github.com/nickderobertis/onetaskgraph/pull/2916)

## [0.2.48]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.47...onetaskgraph-plugin-api-v0.2.48 - 2026-09-28

### Added

- *(task)* add a targeted task update and classify budget exhaustion ([#2805]https://github.com/nickderobertis/onetaskgraph/pull/2805)

## [0.2.47]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.46...onetaskgraph-plugin-api-v0.2.47 - 2026-09-27

### Added

- *(templates)* create and regenerate items from templates, keeping answers out of the body ([#2716]https://github.com/nickderobertis/onetaskgraph/pull/2716)

## [0.2.45]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.44...onetaskgraph-plugin-api-v0.2.45 - 2026-09-26

### Added

- *(task)* add a first-class task priority and a field-setup verb ([#2613]https://github.com/nickderobertis/onetaskgraph/pull/2613)

## [0.2.44]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.43...onetaskgraph-plugin-api-v0.2.44 - 2026-09-26

### Added

- *(task)* report the backend's short handle as a task's key ([#2585]https://github.com/nickderobertis/onetaskgraph/pull/2585)

## [0.2.34]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.33...onetaskgraph-plugin-api-v0.2.34 - 2026-09-16

### Added

- *(metadata)* add task, document and project metadata set verbs ([#1314]https://github.com/nickderobertis/onetaskgraph/pull/1314)

## [0.2.33]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.32...onetaskgraph-plugin-api-v0.2.33 - 2026-09-16

### Fixed

- *(local-md)* read the canonical in-progress word and resolve a file-relative root ([#1240]https://github.com/nickderobertis/onetaskgraph/pull/1240)

## [0.2.32]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.31...onetaskgraph-plugin-api-v0.2.32 - 2026-09-15

### Added

- *(status)* add a queued category, a status-only write, and a delivers relation ([#1145]https://github.com/nickderobertis/onetaskgraph/pull/1145)

## [0.2.31]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.30...onetaskgraph-plugin-api-v0.2.31 - 2026-09-14

### Added

- *(cli)* comment on a task with task comment add, list, edit and delete across every plugin ([#1073]https://github.com/nickderobertis/onetaskgraph/pull/1073)

## [0.2.30]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.29...onetaskgraph-plugin-api-v0.2.30 - 2026-09-14

### Added

- *(copy)* copy only a project's named members, and report what it spent ([#904]https://github.com/nickderobertis/onetaskgraph/pull/904)

## [0.2.22]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.21...onetaskgraph-plugin-api-v0.2.22 - 2026-09-04

### Added

- *(github-projects)* account for what the live tests spend, reduce it, and refuse a run the account cannot afford ([#280]https://github.com/nickderobertis/onetaskgraph/pull/280)

## [0.2.18]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.17...onetaskgraph-plugin-api-v0.2.18 - 2026-09-01

### Fixed

- *(github-projects)* read GitHub's secondary rate limiter as one, and stop the copy outrunning it ([#173]https://github.com/nickderobertis/onetaskgraph/pull/173)

## [0.2.14]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.13...onetaskgraph-plugin-api-v0.2.14 - 2026-09-01

### Added

- *(plugin-api)* give the source contract documents and locations ([#114]https://github.com/nickderobertis/onetaskgraph/pull/114)

## [0.2.13]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.12...onetaskgraph-plugin-api-v0.2.13 - 2026-08-30

### Fixed

- make project copy atomic, publish the npm package, and provision the pre-push gate ([#87]https://github.com/nickderobertis/onetaskgraph/pull/87)

## [0.2.9]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.8...onetaskgraph-plugin-api-v0.2.9 - 2026-08-28

### Added

- *(github-projects)* store many projects on one board as issues and their sub-issues ([#56]https://github.com/nickderobertis/onetaskgraph/pull/56)
- add draft to the status vocabulary and default local-md to backlog ([#54]https://github.com/nickderobertis/onetaskgraph/pull/54)

## [0.3.0]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.2.8...onetaskgraph-plugin-api-v0.3.0 - 2026-08-28

### Added

- *(github-projects)* store many projects on one board as issues and their sub-issues ([#56]https://github.com/nickderobertis/onetaskgraph/pull/56)
- add draft to the status vocabulary and default local-md to backlog ([#54]https://github.com/nickderobertis/onetaskgraph/pull/54)

## [0.2.0]https://github.com/nickderobertis/onetaskgraph/compare/onetaskgraph-plugin-api-v0.1.0...onetaskgraph-plugin-api-v0.2.0 - 2026-08-26

### Added

- *(copy)* add the copy verb and the plugin write seam across the engine, CLI, and both SDKs ([#29]https://github.com/nickderobertis/onetaskgraph/pull/29)
- *(api)* [**breaking**] carry custom metadata, repositories, and edges that leave the project ([#25]https://github.com/nickderobertis/onetaskgraph/pull/25)

## [0.1.0]https://github.com/nickderobertis/onetaskgraph/releases/tag/onetaskgraph-plugin-api-v0.1.0 - 2026-08-25

### Added

- *(release)* automate versioning, publication and the proven end-user install path ([#15]https://github.com/nickderobertis/onetaskgraph/pull/15)
- establish the onetaskgraph workspace, its gate, its CI and its plugin contract ([#1]https://github.com/nickderobertis/onetaskgraph/pull/1)