feat(workflow): save scope, root resolution, and size guideline

[elkaix]

Related Issue

No linked issue — the problem is explained below.

Problem

/workflow save had three limitations:

1. It always saved into the project scope — there was no way to keep a saved workflow in the user's home skills directory.
2. It used the session working directory as the project root. Saving from a repository subdirectory placed the skill where the skill scanner (which resolves the closest .git ancestor) would never find it — the saved skill was invisible until the session was reopened at the repository root.
3. The workflow size guideline in force during the run was not persisted, so a re-run of the saved skill lost the fan-out expectation.

What changed

• /workflow save <name> [--personal]: --personal saves into the home skills directory; project scope stays the default.
• writeSavedWorkflowSkill now takes the working directory and resolves the repository root itself via the skill scanner's own findProjectRoot (now exported) — the same rule the scanner uses to look skills up, so a save from a subdirectory lands where it will be found.
• Saved workflows persist the size guideline into the skill frontmatter and state it in the body (the body is what the model reads on invocation; frontmatter alone is inert). The TUI caches the resolved guideline at startup, and the resolver is exported from the SDK.
• Docs: the /workflow save row in the slash-command reference, and the PYTHINKER_CODE_DISABLE_WORKFLOWS / PYTHINKER_CODE_WORKFLOW_SIZE_GUIDELINE rows in the env-var reference.
• Rider: removes an unused mission-control streaming helper and narrows another to module scope (no behavior change).

Tests: the save suite covers scope selection, root resolution from a subdirectory, and guideline persistence; the TUI suite covers --personal parsing.

Checklist

• I have read the CONTRIBUTING document.
• I have linked a related issue, or explained the problem above.
• I have added tests that prove my feature works.
• Ran gen-changesets skill, or this PR needs no changeset.
• Ran gen-docs skill, or this PR needs no doc update.

[coderabbitai]

Warning

Review limit reached

You’ve reached a temporary PR review limit under our Fair Usage Limits Policy.

Your recent review volume is higher than typical usage, so adaptive limits are currently applied.

Next review available in: 57 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: edda99a5-ab31-40ac-a0e4-85a305cd75c3

📥 Commits

Reviewing files that changed from the base of the PR and between 38e3504 and b04404c.

📒 Files selected for processing (14)

• .changeset/sdk-saved-workflow-workdir.md
• .changeset/workflow-save-scope-and-root.md
• apps/pythinker-code/src/tui/commands/dynamic-workflow.ts
• apps/pythinker-code/src/tui/commands/workflow-availability.ts
• apps/pythinker-code/src/tui/components/messages/dynamic-workflow-mission-control.ts
• apps/pythinker-code/src/tui/pythinker-tui.ts
• apps/pythinker-code/test/tui/commands/dynamic-workflow.test.ts
• docs/configuration/env-vars.md
• docs/reference/slash-commands.md
• packages/agent-core/src/agent/dynamic-workflow/save-as-skill.ts
• packages/agent-core/src/agent/index.ts
• packages/agent-core/src/skill/scanner.ts
• packages/agent-core/test/agent/dynamic-workflow-save.test.ts
• packages/node-sdk/src/index.ts

---

_{Comment @coderabbitai help to get the list of available commands.}

[pkg-pr-new]

pnpm dlx https://pkg.pr.new/@pythoughts/pythinker-code@b04404c

npx https://pkg.pr.new/@pythoughts/pythinker-code@b04404c

commit: b04404c

[elkaix]

@coderabbitai review

[coderabbitai]

⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.