Skip to content

docs: clarify PowerShell authorization and execution limits - #3199

Merged
jebrans merged 2 commits into
mainfrom
dev/jebransyed/powershell-docs-authorization
Oct 26, 2026
Merged

jebrans merged 2 commits into
mainfrom
dev/jebransyed/powershell-docs-authorization

Conversation

@jebrans

@jebrans jebrans commented Oct 20, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Correct outdated claims that dynamic PowerShell flows execute in a sandbox or that import analysis certifies script safety.
  • Explain the current authorization-based contract: approved scripts run with TypeAgent's existing Windows user privileges, subject to OS policy. Users can review the full root script and invocation details; opening the full review is optional, and Cancel remains the default.
  • Clarify exact-invocation/session approval, fresh consent for reasoning/tests/repairs, version-check limits, and the distinction between broker process management and sandbox containment.
  • Refresh the generated companion's references and metadata against the authoritative hand-written README.

Scope

Documentation only: the PowerShell README and its generated companion. No runtime behavior, authorization defaults, execution flags, or AppContainer settings change. Reviewed built-in actions and independent shell/MCP tools retain their own policies.

Validation

  • Pinned Prettier check passed for both changed files.
  • Documentation link verification passed: 30 links, zero broken.
  • Documentation structure and generated input hash validation passed.
  • git diff --check passed.
  • Lint, complexity and test-debt gates reported no changed source files.
  • The local circular-dependency gate could not complete because Windows locked temporary-worktree cleanup; another attempt encountered Windows path limits. Temporary worktrees were cleaned up. No dependency or source-code changes are included.

Replace outdated sandbox and analyzer safety claims with the current approved-local execution contract. Explain optional script review and refresh the generated companion references.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: f0270612-e497-47f9-84cb-892c2b38fca9
@jebrans
jebrans marked this pull request as ready for review October 20, 2026 02:56
@jebrans
jebrans enabled auto-merge October 26, 2026 16:06
@jebrans
jebrans added this pull request to the merge queue Oct 26, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to failed status checks Oct 26, 2026
@jebrans
jebrans added this pull request to the merge queue Oct 26, 2026
Merged via the queue into main with commit 3740f00 Oct 26, 2026
31 checks passed
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