Skip to content

feat: migrate task type taxonomy#122

Merged
singyichen merged 5 commits into
mainfrom
feat/task-type-taxonomy
Jul 22, 2026
Merged

feat: migrate task type taxonomy#122
singyichen merged 5 commits into
mainfrom
feat/task-type-taxonomy

Conversation

@singyichen

Copy link
Copy Markdown
Owner

Purpose

Migrate the task type taxonomy to its final naming and composition: rename three output types, retire two, and align every artifact (spec, ADR, functional map, prototype, visual overview, task configs, example data, tests) to the same 8-key registry.

Reason

The old taxonomy mixed implementation-flavored names (span, token_class, relation_triple) with two types (boundary, entity_relation) that ADR-029's composition model made redundant — their use cases are now expressed by composing the remaining output types (e.g. entity_recognition + relation_identification). Keeping stale keys in configs and docs risked divergence between spec 013 and the prototype.

Result

Old key New key / disposition
span renamed → entity_recognition
token_class renamed → sequence_tagging
relation_triple renamed → relation_identification
boundary retired — covered by composition
entity_relation retired — covered by entity_recognition + relation_identification composition
  • Spec 013 bumped v3.4.3 → v4.0.0 (breaking rename of output-type keys) with Changelog entry.
  • ADR-029 combinatorics corrected to the 8-type registry (C(8,2) + 8 = 36 pairwise combinations).
  • Prototype OUTPUT_TYPE_REGISTRY exposes exactly the 8 new keys; composite configs (absa-va, medical-ner-re) re-expressed with the new names.
  • New Playwright spec task-new-taxonomy-cascade.spec.ts guards the cascade (category → input type → output type) and asserts retired keys stay absent.

Changed Files

File Change
specs/task-management/013-task-new/spec.md Output-type key rename, v4.0.0 bump + Changelog
specs/STATUS.md 013 row updated to v4.0.0 (spec-ready)
docs/adr/029-output-type-composition.md Taxonomy list + combinatorics aligned to 8 keys
docs/product/functional-map/task-type-taxonomy.md Final taxonomy tree
docs/product/task-configs/* (7 files) Renamed span/token-class/relation-triple configs; removed boundary, entity-relation; composite configs updated
docs/product/example-data/* (5 files) Renamed to match configs; removed retired types' data
design/prototype/pages/task-management/task-new.html Registry + cascade migrated to new keys; retired branches removed
docs/product/visual-overview/task-new-output-types.html 8 output-type cards, new names
design/prototype/tests/task-management/*.spec.ts (3 files) New taxonomy-cascade spec; preview/overview specs updated to new keys

Test Plan

  • npx playwright test on the 3 changed spec files — 22/22 passed
  • Full prototype suite — 354/357 and 356/357 across two runs; every failure is a pre-existing flaky test outside this diff (disjoint failure sets across runs, each passes in isolation)
  • Code review (agent) — no Critical/Major findings; taxonomy consistency, JSON validity, spec version/Changelog, STATUS.md all verified
  • Repo-wide grep — zero surviving references to retired keys as config values

Notes

  • Size guardrail: 18 non-test files / +229 −807 exceeds the 5-file/300-line limit. Opened as a single PR with maintainer approval because the rename migration is atomic — splitting would leave docs referencing a mixed old/new taxonomy between merges. Docs/design artifacts only; no production code.
  • Spec 013 stays spec-ready (not archived), consistent with its ongoing status.

Impact Scope

  • Frontend
  • Admin
  • API
  • Queue
  • Other: design prototype, specs, product docs

Related

None

🤖 Generated with Claude Code

singyichen and others added 4 commits July 22, 2026 11:03
- **Remove** retired Boundary and Entity Relation fixtures from the active catalog
- **Rename** sequence fixtures to the current taxonomy and fix entity offsets

Co-Authored-By: OpenAI Codex GPT-5 <noreply@openai.com>
- **Replace** legacy sequence output keys with the current Entity Recognition, Relation Identification, and Sequence Tagging keys
- **Remove** retired Entity Relation and Boundary options from task creation
- **Add** regression coverage for registry keys, previews, names, and entity fixture offsets

Co-Authored-By: OpenAI Codex GPT-5 <noreply@openai.com>
- **Remove** retired output type configurations from the active examples
- **Rename** sequence configurations and dependency references to the current keys

Co-Authored-By: OpenAI Codex GPT-5 <noreply@openai.com>
- **Update** the taxonomy, architecture decision, and task creation specification for eight active output types
- **Document** breaking config key migrations and synchronize the visual overview and status index

Co-Authored-By: OpenAI Codex GPT-5 <noreply@openai.com>
@singyichen singyichen added the feature 功能新增 — New feature requests label Jul 22, 2026
@gemini-code-assist

Copy link
Copy Markdown

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

@qodo-code-review

Copy link
Copy Markdown

Qodo reviews are paused for this user.

Troubleshooting steps vary by plan Learn more →

On a Teams plan?
Reviews resume once this user has a paid seat and their Git account is linked in Qodo.
Link Git account →

Using GitHub Enterprise Server, GitLab Self-Managed, or Bitbucket Data Center?
These require an Enterprise plan - Contact us
Contact us →

@amazon-q-developer amazon-q-developer Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review Summary

I've completed a thorough review of this PR which adds taxonomy cascading functionality to task creation. The changes include implementation files, comprehensive test coverage, architecture documentation, configuration files, and detailed specifications.

Key Changes Reviewed:

  • Task creation HTML with Alpine.js implementation for taxonomy cascading
  • Playwright test suite with comprehensive coverage
  • Architecture Decision Record for output type composition
  • ABSA-VA task configuration
  • Detailed specification documentation

Assessment:
All code changes appear functionally correct with no critical defects identified. The implementation includes proper event handling, state management, and user interaction flows. Test coverage is comprehensive and well-structured.

No blocking issues found. The PR is ready for merge from a code quality perspective.


You can now have the agent implement changes and create commits directly on your pull request's source branch. Simply comment with /q followed by your request in natural language to ask the agent to make changes.

- **Replace** the eight Object.hasOwn registry checks in
  task-new-taxonomy-cascade.spec.ts with the `in` operator because the
  prototype tsconfig lib targets ES2020, where ObjectConstructor lacks
  hasOwn (TS2550) and the Prototype Type Check CI job fails
- **Keep** tsconfig untouched: bumping lib to ES2022 is a config-wide
  change outside this PR's single taxonomy-migration purpose

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@singyichen
singyichen merged commit 00e1ceb into main Jul 22, 2026
9 checks passed
@singyichen
singyichen deleted the feat/task-type-taxonomy branch July 22, 2026 03:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature 功能新增 — New feature requests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant