Files
orca/src/main/runtime/workspaces/creation/created-worktree-approved-setup.ts
T
Brennan Benson b08064cfd5 feat(workspaces): run setup and archive scripts for folder projects
Folder projects get the setup and archive scripts git projects have:
creating a workspace runs setup in a Setup tab, and removing one runs
archive first. The script sees the workspace's name and id, so
`orca worktree create` inside it attaches each new worktree to that
workspace, however the workspace was created.

- Folder creates (desktop IPC and runtime) prepare setup through the
  shared setup prep; runtime creates start it with the worktree terminal
  startup, so Setup-before-agent ordering matches.
- Runner files live in <folder>/.orca, one fresh file per launch, removed
  with the workspace.
- Only the host whose catalog holds the folder reads its orca.yaml or runs
  its scripts; a setup problem becomes a warning, never a failed create.
- Shared orca.yaml setup with no approval from an older client is skipped;
  ask/inherit never refuses a folder create.
- No orca.yaml default tabs for folders, since every workspace shares the
  directory.
- New capability worktree.folder-setup.v1 gates the Settings section on
  runtime hosts; the composer, Settings and trust prompt reuse the
  existing setup surfaces.
2026-11-08 15:26:26 -08:00

85 lines
3.5 KiB
TypeScript

import { isFolderRepo } from '../../../../shared/repo-kind'
import { isRepoOnCatalogHost } from '../../../../shared/execution-host'
import { scopeHooksToRepoKind } from '../../../../shared/folder-workspace-hooks'
import { getSetupRunnerCommandPlatformForPath } from '../../../../shared/agent-launch/startup/setup-runner-command'
import type { RunApprovedWorktreeSetupResult } from '../../../../shared/worktree/create-types'
import {
getDefaultTabsLaunch,
getEffectiveHooksFromConfig
} from '../../../workspace-hooks/effective-hook-config'
import { loadHooks } from '../../../workspace-hooks/hooks'
import {
checkCreatedWorktreeSetupTrust,
defaultTabsWithCommands
} from '../../../workspace-hooks/created-worktree-setup-trust'
import {
createSetupRunnerScript,
resolveSetupRunnerShell
} from '../../../workspace-hooks/worktree-runner-script'
import { getLocalProjectWorktreeGitOptions } from '../../../workspaces/execution-host/project-runtime-git-options'
import type { Worktree } from '../../../../shared/worktree/types'
import type { RuntimeStore } from '../../construction/runtime-store-contract'
import type { WorktreeTerminalProvisioningArgs } from '../startup/runtime-worktree-terminal-provisioning'
type ApprovedSetupRuntime = {
showManagedWorktree: (
selector: string
) => Promise<Pick<Worktree, 'id' | 'repoId' | 'path' | 'displayName'>>
requireStore: () => Pick<RuntimeStore, 'getRepo' | 'getSettings'>
provisionManagedWorktreeTerminals: (args: WorktreeTerminalProvisioningArgs) => Promise<unknown>
}
/**
* Start setup and default-tab commands a create skipped, once the user approved this worktree's
* own content. Re-hashes first, so only the approved bytes run.
*/
export async function runApprovedCreatedWorktreeSetup(
runtime: ApprovedSetupRuntime,
worktreeSelector: string,
approvedSetupHash: string,
options: { wslUserAct?: true } = {}
): Promise<RunApprovedWorktreeSetupResult> {
const worktree = await runtime.showManagedWorktree(worktreeSelector)
const store = runtime.requireStore()
const repo = store.getRepo(worktree.repoId)
if (!repo || (isFolderRepo(repo) && !isRepoOnCatalogHost(repo))) {
return { status: 'not_configured' }
}
const yamlHooks = scopeHooksToRepoKind(repo, loadHooks(worktree.path))
const mismatch = checkCreatedWorktreeSetupTrust(repo, yamlHooks, 'run', { approvedSetupHash })
if (mismatch) {
return { status: 'mismatch', setupTrustMismatch: mismatch }
}
const setupScript = getEffectiveHooksFromConfig(repo, yamlHooks)?.scripts.setup
const setup = setupScript
? await createSetupRunnerScript(
repo,
worktree.path,
setupScript,
getLocalProjectWorktreeGitOptions(store, repo),
resolveSetupRunnerShell(store.getSettings()),
yamlHooks?.setupAgentStartupPolicy,
{ worktreeId: worktree.id, displayName: worktree.displayName }
)
: undefined
// The create already opened the command-less default tabs.
const defaultTabs = defaultTabsWithCommands(getDefaultTabsLaunch(yamlHooks, repo, 'run'))
if (!setup && !defaultTabs) {
return { status: 'not_configured' }
}
await runtime.provisionManagedWorktreeTerminals({
worktreeSelector: `id:${worktree.id}`,
worktreeId: worktree.id,
worktreePath: worktree.path,
...(setup ? { setup } : {}),
...(defaultTabs ? { defaultTabs } : {}),
hasStartupTerminal: true,
setupCommandPlatform: getSetupRunnerCommandPlatformForPath(
setup?.runnerScriptPath ?? '',
process.platform === 'win32' ? 'windows' : 'posix'
),
...options
})
return { status: 'started' }
}