IW-650: issue create --json (id, number, url) #663

Merged

mph merged 18 commits from IW-650 into main 2026-10-01 10:59:02 +00:00

Conversation 0 Commits 18 Files changed 19 +1658 -16

claude commented 2026-10-01 09:36:45 +00:00

Member

Copy link

Summary

iw issue create --json prints one JSON object {"id", "number", "url"} for the new issue and nothing else on stdout, so a program can record the issue and read it back with iw issue <id>. Exit codes do not change; without --json the human output stays as it was.

Changes

• core/model/IssueReference.scala — pure IssueReference(id, number, url) and IssueReference.forTracker(...). Forges: id is PREFIX-n (bare number without a team prefix). Linear/YouTrack: id is the readable key, number is its numeric suffix.
• core/adapters/LinearClient.scala — the create mutation selects identifier and returns it in place of the internal UUID, so a Linear id can be read back. Human output for Linear now shows #IWLE-123.
• core/commands/Issue.scala — --json switch, help example, and the exit-1 doc for "created but reference not built" (stderr names the created URL; do not retry).

Testing

• Unit: IssueReferenceTest, IssueHarnessTest (--json per tracker, failure modes, flag position, help), LinearClientCreateIssueTest, LinearClientMockTest.
• E2E: test/issue-create.bats.
• Phase PR #658 passed CI on the full suite.
• Review packet: project-management/issues/IW-650/review-packet.md.

Follow-ups filed: #661 (live Linear call in a unit test), #662 (rename CreatedIssue.id to key).

Release notes

Příkaz pro založení nového úkolu v systému pro správu úkolů nyní umí vrátit výsledek ve strojově čitelné podobě. Nástroje a automatizace, které úkoly zakládají samy, si tak hned po založení spolehlivě zjistí, jaký úkol vznikl a kde ho najdou, a nemusejí přitom číst text určený lidem.

Stačí k příkazu přidat přepínač pro výstup ve formátu JSON. Příkaz pak po úspěšném založení vypíše jediný záznam se třemi údaji: označením úkolu, jeho číslem a odkazem na něj. Označení má stejnou podobu, jakou používají ostatní příkazy nástroje, například IW-650, takže ho lze rovnou použít k pozdějšímu načtení úkolu a ke sledování, zda je práce hotová. Pokud se úkol založit nepodaří, chyba se vypíše stejně jako dosud a do výsledku se nedostane nic, co by automatizace mohla mylně považovat za úspěch. Ve vzácném případě, kdy úkol vznikne, ale jeho označení se nepodaří sestavit, nástroj ve zprávě uvede odkaz na už založený úkol, aby se úkol nezakládal podruhé.

Pro uživatele systému Linear přináší změna i opravu: po založení úkolu se nyní zobrazí jeho běžné čitelné označení (například IWLE-123) místo interního identifikátoru, se kterým nebylo možné úkol znovu otevřít.

Bez nového přepínače se příkaz chová stejně jako dříve a vypisuje stejné hlášení pro lidi. Návratové kódy příkazu se nemění.

🤖 Generated with Claude Code

Closes #650

## Summary `iw issue create --json` prints one JSON object `{"id", "number", "url"}` for the new issue and nothing else on stdout, so a program can record the issue and read it back with `iw issue <id>`. Exit codes do not change; without `--json` the human output stays as it was. ## Changes - `core/model/IssueReference.scala` — pure `IssueReference(id, number, url)` and `IssueReference.forTracker(...)`. Forges: `id` is `PREFIX-n` (bare number without a team prefix). Linear/YouTrack: `id` is the readable key, `number` is its numeric suffix. - `core/adapters/LinearClient.scala` — the create mutation selects `identifier` and returns it in place of the internal UUID, so a Linear id can be read back. Human output for Linear now shows `#IWLE-123`. - `core/commands/Issue.scala` — `--json` switch, help example, and the exit-1 doc for "created but reference not built" (stderr names the created URL; do not retry). ## Testing - Unit: `IssueReferenceTest`, `IssueHarnessTest` (`--json` per tracker, failure modes, flag position, help), `LinearClientCreateIssueTest`, `LinearClientMockTest`. - E2E: `test/issue-create.bats`. - Phase PR #658 passed CI on the full suite. - Review packet: `project-management/issues/IW-650/review-packet.md`. Follow-ups filed: #661 (live Linear call in a unit test), #662 (rename `CreatedIssue.id` to `key`). ## Release notes Příkaz pro založení nového úkolu v systému pro správu úkolů nyní umí vrátit výsledek ve strojově čitelné podobě. Nástroje a automatizace, které úkoly zakládají samy, si tak hned po založení spolehlivě zjistí, jaký úkol vznikl a kde ho najdou, a nemusejí přitom číst text určený lidem. Stačí k příkazu přidat přepínač pro výstup ve formátu JSON. Příkaz pak po úspěšném založení vypíše jediný záznam se třemi údaji: označením úkolu, jeho číslem a odkazem na něj. Označení má stejnou podobu, jakou používají ostatní příkazy nástroje, například IW-650, takže ho lze rovnou použít k pozdějšímu načtení úkolu a ke sledování, zda je práce hotová. Pokud se úkol založit nepodaří, chyba se vypíše stejně jako dosud a do výsledku se nedostane nic, co by automatizace mohla mylně považovat za úspěch. Ve vzácném případě, kdy úkol vznikne, ale jeho označení se nepodaří sestavit, nástroj ve zprávě uvede odkaz na už založený úkol, aby se úkol nezakládal podruhé. Pro uživatele systému Linear přináší změna i opravu: po založení úkolu se nyní zobrazí jeho běžné čitelné označení (například IWLE-123) místo interního identifikátoru, se kterým nebylo možné úkol znovu otevřít. Bez nového přepínače se příkaz chová stejně jako dříve a vypisuje stejné hlášení pro lidi. Návratové kódy příkazu se nemění. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Closes #650

claude added 17 commits 2026-10-01 09:36:45 +00:00

workflow(wf): Create analysis for IW-650 ... 8015512e23

issue create: machine-readable output (id, url)

Artifacts:
- analysis.md
- issue.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

workflow: Resolve clarifications for IW-650 ... 3025d53b71

Resolved:
- analysis.md: E2E happy path for issue create --json → Option A, stub gh on PATH (explicit exception to the no-mocks-in-E2E rule for this test)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

chore(IW-650): update review-state to tasks_ready 799a68c1cd

workflow(wf): Create task index for IW-650 ... c35882f793

issue create: machine-readable output (id, url)

Artifacts:
- tasks.md
- review-state.json (tasks_ready)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Phase 1: context ready ... dd0be71d24

Issue: IW-650
Phase: 1 - Issue reference + `issue create --json`

This commit marks the checkpoint for phase 1 context generation.
Use wf-implement IW-650 to return to this point.

Decision (Michal): the exit-1 help text names the reference-build
failure and tells the caller not to retry when the error names the
URL of a created issue (analysis Risk 4).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

chore(IW-650): update review-state to context_ready 0a59d9ebf2

workflow(wf): Generate Phase 1 tasks for IW-650 ... 6743e2024c

Issue reference + `issue create --json`

Artifacts:
- phase-01-tasks.md
- phase-01-context.md: Linear test classes live in package iw.tests

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

chore(IW-650): update review-state to tasks_ready bf91f76794

chore(IW-650): update review-state for phase 01 d25b4e8daa

phase(IW-650): phase 01 implementation, before code review ... 93a49dda29

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

phase(IW-650): phase 01 code review iteration 2 fixes ... 575b7160f5

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Issue reference + issue create --json ... 7e9a4ef98a

- IssueReference model: {id, number, url} built per tracker from the created issue's key
- Linear create returns the readable identifier instead of the internal UUID
- issue create --json prints one JSON object; a created-but-unreadable reference names the URL and says not to retry
- Harness, unit and BATS tests; false-green missing-url test fixed in review

Merge pull request 'Phase 1: Issue reference + issue create --json' (#658) from IW-650-phase-01 into IW-650 ... d45ff674e6

Reviewed-on: #658

chore(IW-650): update review-state for phase 01 4935eb08bf

chore(IW-650): mark phase 01 complete in tasks.md 4e90979e50

chore(IW-650): file follow-ups as #661 and #662 ... d4305e0dd6

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs(IW-650): add review packet and release notes ... e0b0bd5637

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

mph added 1 commit 2026-10-01 09:38:04 +00:00

chore(IW-650): update review-state to all_complete 985362150b

mph merged commit 03b3d4e352 into main 2026-10-01 10:59:02 +00:00

mph referenced this pull request from a commit 2026-10-01 10:59:04 +00:00

Merge pull request 'IW-650: issue create --json (id, number, url)' (#663) from IW-650 into main

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

agent-ready

  

bug

Something isn't working

  

contract

Run the tool-contract suite on this PR

  

documentation

Improvements or additions to documentation

  

duplicate

This issue or pull request already exists

  

enhancement

New feature or request

  

good first issue

Good for newcomers

  

help wanted

Extra attention is needed

  

invalid

This doesn't seem right

  

needs-human

  

needs-input

Intake asked the human a question on the issue; waiting for the answer

  

question

Further information is requested

  

wontfix

This will not be worked on

No labels

agent-ready

bug

contract

documentation

duplicate

enhancement

good first issue

help wanted

invalid

needs-human

needs-input

question

wontfix

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

2 participants

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

iterative-works/iw-cli!663

No description provided.