Skip to content

fix: auto-exempt tasks from reflection-origin on fresh installs#547

Merged
itskai-dev merged 1 commit intomainfrom
link/relax-task-creation-onboarding
Feb 28, 2026
Merged

fix: auto-exempt tasks from reflection-origin on fresh installs#547
itskai-dev merged 1 commit intomainfrom
link/relax-task-creation-onboarding

Conversation

@itskai-dev
Copy link
Collaborator

Problem

New users creating their first task hit DEFINITION_OF_READY error requiring metadata.reflection_exempt=true + reflection_exempt_reason. They have zero context about the reflection system and no way to discover what's needed without iterating through error messages.

This was the #1 onboarding blocker found during the launch smoke test.

Fix

When countReflections() === 0 (fresh install), auto-exempt tasks from:

  • Reflection-origin requirement (source_reflection / source_insight)
  • reflection_exempt_reason requirement

Once reflections exist in the system, the invariant re-engages normally. This means:

  • Fresh installs: tasks just work
  • Established teams: reflection-origin traceability is enforced as before

Testing

  • All 1517 tests pass
  • 1 file changed, +4/-2 lines

Related

  • Launch smoke test: task-1772314298928-69ud79b5d
  • Requested by @Sage as launch-critical fix

When no reflections exist in the system (fresh install / new user),
skip the reflection-origin requirement and reflection_exempt_reason
check on task creation. This removes the biggest onboarding friction
point where new users hit DEFINITION_OF_READY errors with zero
context about the reflection system.

Once reflections exist, the invariant re-engages normally.

Found during launch smoke test (task-69ud79b5d).
@itskai-dev itskai-dev force-pushed the link/relax-task-creation-onboarding branch from 60a155a to 4d32af6 Compare February 28, 2026 23:48
@itskai-dev itskai-dev merged commit 3ad73c3 into main Feb 28, 2026
10 checks passed
@itskai-dev itskai-dev deleted the link/relax-task-creation-onboarding branch February 28, 2026 23:48
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.

1 participant