Skip to content

fix(shell): allow unjailed fs in shipped config so release publish boots - #117

Merged
andersonleal merged 4 commits into
mainfrom
fix/shell-release-config-jail
May 11, 2026
Merged

fix(shell): allow unjailed fs in shipped config so release publish boots#117
andersonleal merged 4 commits into
mainfrom
fix/shell-release-config-jail

Conversation

@andersonleal

@andersonleal andersonleal commented May 11, 2026

Copy link
Copy Markdown
Collaborator

Summary

The release publish workflow (run 25688635094) was failing at the "Start local worker for interface collection" step. The prebuilt iii-shell exited within 2s with:

fs.host_root is unset and fs.allow_unjailed is false — refusing to start unjailed.

Root cause: the shipped shell/config.yaml had host_root: null + allow_unjailed: false, which trips validate_fs_jail() (shell/src/config.rs:170) before the worker can register its functions with the engine. iii-database works because its config has no equivalent safety gate.

Fix: jail to /tmp instead of opening the host filesystem.

  • host_root: /tmp — exists on every Unix host (Ubuntu CI runners, macOS via /private/tmp), writable, ephemeral-only.
  • allow_unjailed: false — stays the safe default.

Operators should override host_root with the workspace they actually intend the shell worker to manage. The Rust Default::default() (shell/src/config.rs:111) remains fail-closed for the "no config file" path.

(First commit on this branch set allow_unjailed: true with host_root: null, which satisfied the gate but exposed the entire host filesystem. That's now corrected by the follow-up commit.)

Test plan

  • cargo test -p iii-shell --lib config:: passes locally (15/15).
  • Re-trigger the shell publish workflow (or cut shell/v0.3.3) and confirm the Start local worker step boots and POST /publish returns HTTP 200.

The release workflow boots the prebuilt iii-shell from shell/ to collect
its function interface. The shipped shell/config.yaml had host_root: null
and allow_unjailed: false, which trips validate_fs_jail() and exits before
registration, failing every shell publish run (e.g. 25688635094).

Flip allow_unjailed to true in the shipped config. The Rust default
remains fail-closed for the "no config file" path.
@coderabbitai

coderabbitai Bot commented May 11, 2026

Copy link
Copy Markdown

Warning

Rate limit exceeded

@github-actions[bot] has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 55 minutes before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7d17faf9-430c-47b7-9eac-ac34ec725dde

📥 Commits

Reviewing files that changed from the base of the PR and between 81ec3b1 and d1860bd.

📒 Files selected for processing (2)
  • shell/README.md
  • shell/config.yaml
📝 Walkthrough

Walkthrough

A single configuration value is changed: shell/config.yaml sets fs.allow_unjailed from false to true; the shell/README.md is updated to reflect that same change.

Changes

Filesystem Configuration

Layer / File(s) Summary
Allow Unjailed Filesystem
shell/config.yaml
fs.allow_unjailed is enabled by setting it to true, overriding the previous default that disallowed running when host_root is unset.
Documentation Update
shell/README.md
README updated to show fs.allow_unjailed changed from false to true.

🎯 1 (Trivial) | ⏱️ ~2 minutes

🐰 A flag flipped from false to true,
Host-root doors swing open wide—
Tiny hop, big stride.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly summarizes the main change: allowing unjailed filesystem access in the shipped config to fix the release publish workflow boot issue.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/shell-release-config-jail

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

  • Generate code and open pull requests
  • Plan features and break down work
  • Investigate incidents and troubleshoot customer tickets together
  • Automate recurring tasks and respond to alerts with triggers
  • Summarize progress and report instantly

Built for teams:

  • Shared memory across your entire org—no repeating context
  • Per-thread sandboxes to safely plan and execute work
  • Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@github-actions

github-actions Bot commented May 11, 2026

Copy link
Copy Markdown
Contributor

skill-check — worker

6 verified, 20 skipped (no docs/).

Layer Result
structure
vale
ai

Three for three. Nicely done.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@shell/config.yaml`:
- Around line 74-75: The shipped config exposes the full filesystem by setting
allow_unjailed: true with host_root: null; change this to a safe default
host_root (e.g., "/tmp" or "/var/lib/iii-shell" or your workspace dir) and/or
set allow_unjailed: false so the shell remains jailed by default; update the
config keys host_root and allow_unjailed accordingly and document the chosen
safe path so CI still passes but deployments are protected.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: c0174695-7815-4af5-861e-70c1e3c6aaf5

📥 Commits

Reviewing files that changed from the base of the PR and between ab1e650 and 425bbbf.

📒 Files selected for processing (1)
  • shell/config.yaml

Comment thread shell/config.yaml Outdated
andersonleal and others added 2 commits May 11, 2026 16:18
Previous commit set allow_unjailed: true with host_root: null, which
satisfied the safety check but exposed the entire host filesystem to
shell::fs::* (subject only to the advisory denylist).

Set host_root: /tmp and restore allow_unjailed: false. /tmp exists on
every Unix host (Ubuntu CI runners, macOS via /private/tmp), is
writable, and contains only ephemeral data. Operators should override
this with their actual workspace path.
@andersonleal
andersonleal merged commit 213a294 into main May 11, 2026
1 check passed
@andersonleal
andersonleal deleted the fix/shell-release-config-jail branch May 11, 2026 19:22
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.

2 participants