yoi/.yoi/tickets/closed/20260607-031439-ticket-init-role-profile-scaffold/thread.md

Created

Created by LocalTicketBackend create.

---

Plan

Preflight / implementation intent

Classification: implementation-ready after ticket-role-launch-config-strict-validation landed.

Intent:

• Add a Ticket-focused scaffold/init path that writes an explicit .yoi/ticket.config.toml with concrete fixed role profiles.
• This is explicit config generation, not runtime fallback. The generated file may choose builtin presets, but the runtime must continue requiring explicit role config.

Current state:

• There is no top-level yoi init command in crates/yoi/src/main.rs.
• yoi ticket currently has no init command.
• yoi ticket already documents fallback backend behavior when config is absent, but role launch validation now requires explicit role config for Panel Intake/Orchestrator launches.

Implementation direction:

• Introduce a narrow yoi ticket init scaffold command rather than a broad product-level init redesign.
• The command should create .yoi/ticket.config.toml if missing, and optionally ensure the local Ticket root .yoi/tickets exists.
• Default generated config should explicitly include:
  • [backend] provider = "builtin:yoi_local", root = ".yoi/tickets";
  • fixed [roles.*] tables for intake, orchestrator, coder, reviewer, investigator;
  • each role has a concrete profile, initially builtin:default unless role-specific builtin profiles are introduced in the same small diff;
  • each role has explicit workflow matching the role defaults.
• Do not overwrite an existing .yoi/ticket.config.toml unless an explicit force flag is intentionally added and tested. A minimal first pass can fail with an actionable diagnostic when the config already exists.
• Generated config should pass the strict role launch validation added by the previous ticket.

Suggested command shape:

• yoi ticket init
• Optional flags only if small and useful:
  • --force is not required for first pass;
  • --print/dry-run is not required for first pass.

Code map:

• crates/yoi/src/ticket_cli.rs: add parse/run/help for init and tests.
• crates/ticket/src/config.rs: add reusable scaffold string/helper if that keeps config generation testable near config types.
• crates/client/src/ticket_role.rs: use existing launch validation tests to verify generated config is launch-ready.
• .yoi/ticket.config.toml: update this repository's config through the new intended shape or keep repository config update in main workspace if child worktree excludes .yoi; the implementation should at least make the scaffold generate that shape.

Non-goals:

• Do not loosen runtime validation.
• Do not add implicit builtin/default fallback.
• Do not implement broad global yoi init unless the existing CLI structure makes it clearly smaller than yoi ticket init.
• Do not design role-specific builtin profiles unless it is trivial and scoped; builtin:default as explicit scaffold output is acceptable for now.

Validation:

• Tests should cover generated config shape, refusal to overwrite existing config, and successful role launch validation against generated config.
• Run focused cargo test -p ticket config --lib, cargo test -p client ticket_role --lib, and cargo test -p yoi ticket or equivalent ticket CLI tests.
• Run cargo fmt --check and git diff --check.

---

Intake summary

Implementation-ready after strict role launch validation: add a narrow yoi ticket init scaffold path that writes explicit backend and fixed role profile config to .yoi/ticket.config.toml, using concrete selectors such as explicit builtin:default for now, without adding runtime fallback.

---

State changed

Ticket intake complete; workflow_state intake -> ready.

---

Implementation report

Delegation

Implementation delegated to child Pod ticket-init-scaffold-coder-20260607 in worktree .worktree/ticket-init-role-profile-scaffold on branch work/ticket-init-role-profile-scaffold.

Scope:

• Add a narrow yoi ticket init scaffold command.
• Generate explicit backend and fixed role profile/workflow config in .yoi/ticket.config.toml.
• Use concrete role profiles in the generated config; explicit builtin:default is acceptable for the first pass.
• Do not loosen strict role launch validation or add runtime fallback.
• Do not overwrite existing config in the first pass.

The child should commit implementation work in the child worktree and report diff/tests. Merge, review, Ticket closure, and cleanup remain with the parent/human workflow.

---

Implementation report

Implementation report

Coder Pod ticket-init-scaffold-coder-20260607 completed implementation in .worktree/ticket-init-role-profile-scaffold.

Commit:

• f265098 ticket: add ticket config init scaffold

Reported summary:

• Added narrow yoi ticket init.
• It creates .yoi/ticket.config.toml only when missing and ensures .yoi/tickets exists.
• Existing .yoi/ticket.config.toml is not overwritten and fails with an actionable diagnostic.
• Added reusable ticket_config_scaffold() in crates/ticket/src/config.rs.
• Generated config includes backend provider/root plus fixed roles intake/orchestrator/coder/reviewer/investigator.
• Each generated role uses explicit profile = "builtin:default" and explicit default workflow.
• Added tests for config shape, CLI init/no-overwrite behavior, CLI help, and launch planning for Intake/Orchestrator from the scaffold.

Reported validation:

• cargo test -p ticket config --lib
• cargo test -p client ticket_role --lib
• cargo test -p yoi ticket
• cargo fmt --check
• git diff --check
• nix build .#yoi

External review will be delegated before merge.

---

Review: approve

Approved.

Evidence:

• Runtime fallback was not loosened. Strict role launch validation still requires configured role table/profile and rejects top-level inherit before launch.
• ticket_config_scaffold() writes explicit backend config and all fixed role tables: intake, orchestrator, coder, reviewer, investigator.
• Each generated role has explicit profile = "builtin:default" and explicit default workflow.
• Launch validation coverage plans both Intake and Orchestrator from the scaffolded config.
• yoi ticket init refuses to overwrite existing .yoi/ticket.config.toml, uses create-new behavior, and reports an actionable diagnostic.
• Command shape is scoped to yoi ticket init; no broad product init or runtime implicit fallback was introduced.

Reviewer validation:

• cargo test -p ticket config --lib
• cargo test -p client ticket_role --lib
• cargo test -p yoi ticket
• cargo fmt --check
• git diff --check develop...HEAD
• nix build --no-link .#yoi

Merge readiness:

• Branch is behind current develop only by Ticket metadata changes.
• Implementation changes are limited to crates/client/src/ticket_role.rs, crates/ticket/src/config.rs, and crates/yoi/src/ticket_cli.rs.
• git merge-tree showed no conflicts.

Dogfooding note:

• The main workspace's existing .yoi/ticket.config.toml remains backend-only, so a separate main-workspace config update is needed after merge if this workspace should use explicit Ticket role profiles.

---

State changed

Ticket closed; workflow_state set to done.

---

Closed

Implemented, reviewed, merged, validated, and applied to this workspace config.

Summary:

• Added a narrow yoi ticket init command.
• The command creates .yoi/ticket.config.toml only when missing and refuses to overwrite an existing config with an actionable diagnostic.
• Added ticket_config_scaffold() for the generated config body.
• Generated config includes explicit backend config and fixed role tables for intake, orchestrator, coder, reviewer, and investigator.
• Each generated role uses explicit profile = "builtin:default" and explicit default workflow.
• No runtime fallback was added or loosened.
• The generated config validates for Ticket role launch planning under the strict validation implemented by ticket-role-launch-config-strict-validation.
• This repository's .yoi/ticket.config.toml was updated to the scaffolded explicit role-profile shape for dogfooding.

Implementation:

• Child commit: f265098 ticket: add ticket config init scaffold
• Merge commit: merge: ticket init scaffold

Review:

• External reviewer ticket-init-scaffold-reviewer-20260607 approved with no blockers.

Validation after merge:

• cargo test -p ticket config --lib
• cargo test -p client ticket_role --lib
• cargo test -p yoi ticket
• cargo fmt --check
• git diff --check
• target/debug/yoi ticket doctor

---