Skip to content

Runtime re-seeds BOOTSTRAP.md after onboarding (idempotency regression) #2

@wenakita

Description

@wenakita

Summary

In production use, a configured agent can be pushed with workspace/BOOTSTRAP.md removed, but runtime lifecycle events still reintroduce bootstrap behavior and trigger repeated onboarding loops.

Expected behavior

  • BOOTSTRAP.md is first-run only.
  • After onboarding and deletion, startup should never re-run onboarding for already configured identity.
  • Runtime should not mutate workspace prompts back into onboarding state.

Actual behavior

  • BOOTSTRAP.md can reappear after restart/probe cycles.
  • Agent re-enters identity onboarding flow ("who am I?" style prompts) despite prior configuration.
  • During repro attempts, control paths also showed intermittent runtime instability (chat hangs / 500s), which makes drift hard to recover from reliably.

Reproduction (high level)

  1. Start from template-derived agent with configured identity.
  2. Remove workspace/BOOTSTRAP.md and push.
  3. Restart agent and verify bootstrap is absent.
  4. Run normal chat/probe activity.
  5. Observe bootstrap/onboarding behavior return unexpectedly.

Impact

  • Breaks deterministic production agent behavior.
  • Causes user-facing regressions and identity churn.
  • Increases operational overhead due to repeated manual re-apply/restart loops.

Mitigation PR

A template-level mitigation is proposed here (idempotent bootstrap guard):

This mitigation reduces user impact by skipping onboarding if identity markers are already configured, but does not replace a runtime/platform fix if file reseeding persists.

Additional external evidence

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions