v1.5.9

What's New

This release improves kit installation safety and makes several CLI diagnostics clearer.

Safer kit installs

• kit install now validates public subagent prompt/helper sources before writing any files.
• If a kit references a missing public subagent source, installation now fails cleanly instead of leaving a
  partial install behind.
• This validation now applies consistently across both copy and register install modes.

Legacy kit manifest warnings

• Installing a kit that does not use .cf-studio-kit.toml now shows a warning.
• Kits still using manifest.toml or other legacy layouts will prompt users to ask kit authors to migrate to the
  canonical manifest format.
• This helps surface legacy kits earlier without blocking installation.

Clearer validation output

• spec-coverage --system ... now fails fast with a clear error when an unknown system selector is provided.
• Human-readable output now explicitly lists invalid system selectors, making misconfigured commands easier to
  fix.

Better workspace diagnostics

• workspace info now reports degraded workspace states more clearly when metadata or workspace upgrade issues
  are detected.
• This makes partial workspace/configuration problems easier to spot during diagnosis.

Why it matters

• Fewer broken or partial kit installs
• Better visibility into legacy kit formats
• Clearer CLI feedback when configuration is invalid
• Easier troubleshooting for degraded workspace states

What's Changed

• Enhance end-to-end tests and refactor CLI command handling by @ainetx in #52

Full Changelog: v1.5.8...v1.5.9

v1.5.8

What's Changed

• test: add coverage for gitignore updates and agent generation scenarios by @ainetx in #51

Full Changelog: v1.5.7...v1.5.8

v1.5.7

What's Changed

• Refactor kit model loading and enhance workflow handling by @ainetx in #50

Full Changelog: v1.5.6...v1.5.7

v1.5.6

What's Changed

• Refactor gitignore patterns for generated agent resources by @ainetx in #49

Full Changelog: v1.5.5...v1.5.6

v1.5.5

What's Changed

• Refactor manifest path resolution to use centralized helper by @ainetx in #48

Full Changelog: v1.5.4...v1.5.5

v1.5.4

What's Changed

• Update version to v1.5.3 and add release notes by @ainetx in #46
• Enhance agent path resolution for register mode project root kits by @ainetx in #47

Full Changelog: v1.5.3...v1.5.4

v1.5.2

What's Changed

• Improve Pylint rules and enhance documentation by @ainetx in #38
• Enforce active workflow state law by @ainetx in #42
• Enhance Git Kit Source Management and Manifest Validation by @ainetx in #43

Full Changelog: v1.5.1...v1.5.2

v1.5.1

What's Changed

• Refactor bootstrap processes for various workflows by @ainetx in #40
• Refactor workflow module loading and improve error messaging by @ainetx in #41

Full Changelog: v1.5.0...v1.5.1

v1.5.0

Highlights

New Assistant Mode for guided workflow sessions

Constructor Studio now includes Assistant Mode for guided workflow sessions.

Assistant Mode acts like a visible guide in chat: it explains where you are in the workflow, why the current step is happening, what each
option does next, and which path is recommended.

New debug interaction mode

A dedicated debug interaction mode is now available for workflow sessions.

This gives advanced users a clearer way to inspect workflow behavior, follow pauses, and work through prompt or workflow debugging with less
friction.

Safer review-to-fix workflow

Review flows now more clearly separate reviewing findings from approving fixes.

Users see findings first, browse them in the findings browser, and only then choose whether to fix:

• critical and major findings
• all findings
• a selected subset
• nothing yet

This makes review-driven changes easier to inspect before edits are approved.

Better workflow startup and routing

Workflow entry behavior is more reliable across guided flows.

This is most noticeable when a workflow is activated first and the concrete task is provided afterward, or when the flow needs to carry
context cleanly through explore, planning, review, and approval gates.

Clearer multi-step workflow guidance

Guided workflow UX is more consistent across multi-step sessions.

Users get clearer explanations between stages, better gate framing, and smoother transitions through planning, review, and approval-heavy
flows.

User-Facing Changes

• Added Assistant Mode as a guided interaction mode for workflow sessions.
• Added Debug as a workflow interaction mode for advanced inspection and troubleshooting.
• Improved guided workflow messaging and step-to-step clarity.
• Improved review flows so findings are reviewed before fix approval.
• Improved workflow activation, routing, and resume behavior in multi-step sessions.

Notes

This release is mainly about workflow usability, guided interaction, and safer review behavior.

The biggest visible changes for end users are:

• new Assistant Mode
• new Debug interaction mode
• clearer guided workflow sessions
• safer findings review before fixes
• smoother workflow startup and routing

What's Changed

• Enhance workflows with intent capturing and review improvements by @ainetx in #39

Full Changelog: v1.4.0...v1.5.0

v1.4.0

This release improves how Constructor Studio routes requests, uses sub-agents, and runs execution plans.

What's New

Smarter workflow routing

Constructor Studio can now match a request to a single workflow or to a compatible group of companion workflows when the task spans multiple
areas.

For example, cross-cutting requests that involve analysis, documentation, implementation, or prompt work can now be routed more clearly
instead of forcing one narrow workflow too early.

When no clear intent is provided, routing flows now include a describe intent / help me choose option.

Better sub-agent control

Sub-agent dispatch now has clearer user controls:

• Approve native sub-agents once.
• Approve native sub-agents for the session.
• Run the same work inline once.
• Use inline execution for the session.
• Stop before dispatch.

Constructor Studio also avoids silent sub-agent launches. You can see and control when delegated work starts.

Expanded sub-agent selection

Studio now uses a shared sub-agent registry to choose the right helper for planning, exploration, authoring, coding, validation, review,
migration, and phase work.

This helps Studio pick a capable agent without overusing heavier models when a smaller execution agent is enough.

More reliable plan execution

Execution plans now choose the right phase compiler or runner based on where plan files and outputs live.

This is especially useful when plan state is stored under gitignored Studio folders. Studio can run those phases in place instead of choosing
an isolated context that cannot see the needed files.

Plan workflows also report which phase agent variant was selected and why.

Improvements

• cf-generate and cf-analyze can now offer companion workflow groups for multi-domain tasks.
• Plan phase compilation now has a clearer dispatch and resume lifecycle.
• Git handling is more explicit: Studio asks whether it may commit, stage only, or avoid git commands.
• Generated agent behavior is more predictable when no file changes are needed.
• Kit update handling is safer when updates are declined.
• Ralphex delegation handles timeouts and process cleanup more reliably.

• Refactor code for consistency and add Pylint backlog by @ainetx in #36
• Improve subagent routing and reasoning policies by @ainetx in #37

Full Changelog: v1.3.6...v1.4.0