@picoai/tickets 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (19) hide show
  1. package/.tickets/spec/AGENTS_EXAMPLE.md +5 -4
  2. package/.tickets/spec/TICKETS.md +295 -358
  3. package/.tickets/spec/profile/defaults.yml +29 -0
  4. package/.tickets/spec/version/20260311-tickets-spec.md +38 -0
  5. package/.tickets/spec/version/20260317-tickets-spec.md +82 -0
  6. package/README.md +122 -147
  7. package/package.json +4 -1
  8. package/release-history.json +19 -0
  9. package/src/cli.js +462 -137
  10. package/src/lib/claims.js +66 -0
  11. package/src/lib/config.js +162 -0
  12. package/src/lib/constants.js +8 -2
  13. package/src/lib/listing.js +21 -84
  14. package/src/lib/planning.js +355 -0
  15. package/src/lib/projections.js +70 -0
  16. package/src/lib/repair.js +75 -1
  17. package/src/lib/util.js +5 -1
  18. package/src/lib/validation.js +216 -0
  19. package/src/release-status.js +141 -0
package/.tickets/spec/AGENTS_EXAMPLE.md CHANGED
@@ -1,16 +1,17 @@
1
1
  This file is an example for agent harnesses. Rename or copy it to `AGENTS.md` if your tooling reads it.
2
2
 
3
- The purpose of this bootstrap is to ensure an agent loads the canonical workflow from `TICKETS.md` before doing any work.
3
+ The purpose of this bootstrap is to ensure an agent loads the canonical ticketing workflow before doing any work.
4
4
 
5
5
  ## Ticketing Workflow
6
6
 
7
7
  ### Required Behavior
8
- - First action: open and read `TICKETS.md` (canonical ticket workflow and rules).
9
- - First response: briefly confirm understanding of the ticketing system described in `TICKETS.md` before starting any implementation work.
8
+ - First action: if your environment supports repo-local skills and `.tickets/skills/tickets/SKILL.md` exists, load that skill. Otherwise open and read `TICKETS.md`.
9
+ - First response: briefly confirm understanding of the ticketing system before starting any implementation work.
10
10
  - Use the repo-local CLI (`npx @picoai/tickets`) as the integration surface for tickets and logs.
11
11
  - Before performing work on a ticket, validate it: run `npx @picoai/tickets validate` (or `npx @picoai/tickets validate --issues` + `npx @picoai/tickets repair`).
12
12
  - When logging via the CLI: use `npx @picoai/tickets log --machine` so logs are strictly structured.
13
- - Respect `assignment.mode` and any `agent_limits` in the ticket/config.
13
+ - Respect `assignment.mode`, `agent_limits`, active advisory claims, and repo-local defaults in `.tickets/config.yml`.
14
14
 
15
15
  ### Bootstrapping TICKETS.md
16
16
  - If `.tickets/` or `TICKETS.md` are missing, run `npx @picoai/tickets init`.
17
+ - `init` also creates `.tickets/config.yml` and `.tickets/skills/tickets/SKILL.md`.