lsm / neokai / 25671263236

82%

push

github

feat: add workflow handle as alternative identifier (#1841)

* feat: add workflow handle as alternative identifier

Add a short human-readable handle (e.g. 'coding-with-qa') as an alternative
identifier for workflows within a space, alongside the existing UUID.

- Migration 124: adds handle column + partial unique index on (space_id, handle)
- Shared types: handle field on SpaceWorkflow, CreateSpaceWorkflowParams,
  UpdateSpaceWorkflowParams
- Repository: handle CRUD, getWorkflowByHandle, getHandlesForSpace
- Manager: auto-generate handle from name via slugify with collision resolution
  (-2, -3, etc.), validate uniqueness, regenerate on rename
- RPC handlers: spaceWorkflow.get accepts id or handle+spaceId
- MCP tools: change_plan, get_workflow_detail, create_standalone_task accept
  workflow_handle as alternative to workflow_id

* fix: address review feedback on workflow handle feature

- P1: Add handle field to SpaceWorkflowSummary type, repo SELECT/mapping,
  and workflowToSummary in space-store.ts
- P1: Call validateSlug() in validateHandle to reject invalid formats
- P2: Use getHandlesForSpace() instead of listWorkflows() in validateHandle
  and generateUniqueHandle for lightweight queries
- P3: Better error message when handle provided without spaceId in RPC get
- P3: Update create_standalone_task workflow_id description to mention handles
- Only regenerate handle on update when name actually changes (not on every
  save with same name)
- Validate explicit handles during workflow creation (format + uniqueness)
- Migration 124: create index even when column already exists

* fix: guard handle inputs, validate generated handles, backfill existing workflows

- createWorkflow: guard against null and non-string handle inputs
- updateWorkflow: reject non-string handles with WorkflowValidationError
- generateUniqueHandle: validate slug after collision suffixing, truncate
  with fallback if over-length
- Migration 124: backfill handles for existing work... (continued)

8346 of 11648 branches covered (71.65%)

Branch coverage included in aggregate %.

358 of 391 new or added lines in 13 files covered. (91.56%)

65977 of 78422 relevant lines covered (84.13%)

289.64 hits per line