Skip to content

BIT-442: make issue creation deterministic via stateId; document Backlog ID#98

Closed
cjarguello wants to merge 2 commits into
codex/linear-issue-type-decision-guidefrom
codex/t01-bit-442-issue-create-backlog-stateid
Closed

BIT-442: make issue creation deterministic via stateId; document Backlog ID#98
cjarguello wants to merge 2 commits into
codex/linear-issue-type-decision-guidefrom
codex/t01-bit-442-issue-create-backlog-stateid

Conversation

@cjarguello
Copy link
Copy Markdown
Member

Context

  • BIT-442 observed that Codex/Linear toolchains can create Product Development issues in Icebox 🧊 even when state: "Backlog" was requested.

What this PR does

  • Updates linear/scripts/create_linear_issues_from_seed.py to resolve workflow state name -> stateId and pass stateId on issueCreate.
  • Documents the Product Development Backlog workflow state ID (162716a8-ffa4-43ea-9e0d-c48fdb8054bc) in linear/README.md and clarifies the operating-guide workaround.

Evidence (2026-05-08)

  • Verified via Linear MCP: setting issue state by name did not update an existing issue; setting by workflow state ID does work.
  • Created disposable verification issue BIT-443 using the Backlog stateId; it landed in Backlog on create and was immediately closed as Canceled.

Scope hygiene

  • Does not touch unrelated local edits (audit_ctl.sh / repo_registry.tsv / test_audit_tools.sh).

Validation

  • python3 -m json.tool linear/contracts/linear_type_classifier_v1.json >/dev/null
  • python3 -m unittest linear.tests.test_engine
  • git diff --check

@cjarguello cjarguello changed the base branch from main to codex/linear-issue-type-decision-guide May 8, 2026 09:25
Copy link
Copy Markdown
Member Author

Follow-up: updated resolve_state_id GraphQL variable type from String! -> ID! to better match Linear schema (team(id: ID!)). Commit: be42989.

@taylor-01 taylor-01 force-pushed the codex/linear-issue-type-decision-guide branch from b8106e7 to 67881f8 Compare May 8, 2026 11:36
@taylor-01 taylor-01 force-pushed the codex/t01-bit-442-issue-create-backlog-stateid branch from be42989 to 3027aca Compare May 8, 2026 11:36
Copy link
Copy Markdown
Member Author

Rebased onto updated PR #97 after PR #97 moved onto origin/main (e0d8053). Current head: 3027aca.

Validation passed:

  • python3 -m py_compile linear/scripts/create_linear_issues_from_seed.py
  • python3 -m json.tool linear/contracts/linear_type_classifier_v1.json >/dev/null
  • python3 -m unittest linear.tests.test_engine linear.tests.test_classifier_corrections
  • git diff --check

@taylor-01 taylor-01 deleted the branch codex/linear-issue-type-decision-guide May 9, 2026 05:45
@taylor-01 taylor-01 closed this May 9, 2026
cjarguello added a commit that referenced this pull request May 9, 2026
Supersedes PR #98.

CJ Admin authorized force merge / QA skip.

Validation:
- python3 -m py_compile linear/scripts/create_linear_issues_from_seed.py
- python3 -m json.tool linear/contracts/linear_type_classifier_v1.json >/dev/null
- python3 -m unittest linear.tests.test_engine linear.tests.test_classifier_corrections
- git diff --check
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.

2 participants