Skip to content

foryourhealth111-pixel/Vibe-Skills

Vibe Code Orchestrator (VCO) is a governed runtime entry that freezes requirements, bounds execution, and enforces verification and phase cleanup.

FileKindSize
SKILL.mdskill md17.2 KB
agents/templates/debugger.mdmarkdown323 B
agents/templates/planner.mdmarkdown313 B
agents/templates/reviewer.mdmarkdown331 B
agents/templates/security-reviewer.mdmarkdown341 B
references/change-proof-matrix.mdmarkdown2.6 KB
references/contributor-zone-decision-table.mdmarkdown2.2 KB
references/developer-entry-contract.mdmarkdown2.7 KB
references/fixtures/external-corpus/external-corpus-gate.jsonconfig8.6 KB
references/fixtures/external-corpus/prompt-signals.jsonconfig412.4 KB
references/fixtures/external-corpus/skill-keyword-index.backup.jsonconfig30.6 KB
references/fixtures/external-corpus/skill-keyword-index.candidate.jsonconfig26.5 KB
references/fixtures/external-corpus/vco-suggestions.jsonconfig16.6 KB
references/fixtures/migration-map.jsonconfig7.8 KB
references/fixtures/retro-compare/safety-gate/baseline-cer.jsonconfig294 B
references/fixtures/retro-compare/safety-gate/current-cer.jsonconfig1.1 KB
references/fixtures/retro-compare/safety-gate/delta.jsonconfig1.0 KB
references/fixtures/retro-compare/sample-run/baseline-cer.jsonconfig324 B
references/fixtures/retro-compare/sample-run/current-cer.jsonconfig1.2 KB
references/fixtures/retro-compare/sample-run/delta.jsonconfig1.0 KB
references/fixtures/retro-compare/smoke/baseline-smoke.jsonconfig266 B
references/fixtures/retro-compare/smoke/current-smoke.jsonconfig1.0 KB
references/fixtures/retro-compare/smoke/delta-smoke.jsonconfig1.0 KB
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/cleanup-receipt.jsonconfig1.3 KB
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/governance-capsule.jsonconfig408 B
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/intent-contract.jsonconfig2.2 KB
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/phase-plan-execute.jsonconfig2.4 KB
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/skeleton-receipt.jsonconfig722 B
references/fixtures/runtime/vibe-sessions/20260413T131910Z-pr153-rabbit-review-fix/stage-lineage.jsonconfig1.3 KB
references/fixtures/skills-audit/bio-science-problem/bio-science-problem-map.csvother9.2 KB
references/fixtures/skills-audit/bio-science-problem/bio-science-problem-map.jsonconfig18.1 KB
references/fixtures/verify/routing-stability/vibe-routing-stability-gate.jsonconfig24.4 KB
references/index.mdmarkdown1.3 KB
references/proof-bundles/claude-code-managed-closure-candidate/linux-managed-run-01-local-host/installed-runtime-outputs/runtime-freshness-receipt.jsonconfig262 B
references/proof-bundles/claude-code-managed-closure-candidate/manifest.jsonconfig2.6 KB
references/proof-bundles/linux-full-authoritative-candidate/linux-pwsh-run-01-wsl/installed-runtime-outputs/runtime-freshness-receipt.jsonconfig298 B
references/proof-bundles/linux-full-authoritative-candidate/linux-pwsh-run-02-docker/installed-runtime-outputs/runtime-freshness-receipt.jsonconfig298 B
references/proof-bundles/linux-full-authoritative-candidate/manifest.jsonconfig3.3 KB
references/proof-bundles/openclaw-runtime-core-preview-candidate/manifest.jsonconfig1.9 KB
references/release-ledger.jsonlother5.1 KB
scripts/README.mdmarkdown1.7 KB
scripts/bootstrap/one-shot-setup.ps1script797 B
scripts/bootstrap/one-shot-setup.shscript482 B
scripts/bootstrap/scaffold-claude-preview.ps1script875 B
scripts/bootstrap/scaffold-claude-preview.shexecutablescript866 B
scripts/bootstrap/sync-local-compat.ps1script2.6 KB
scripts/common/AntiProxyGoalDrift.ps1script15.1 KB
scripts/common/NodeLaunchWrapper.ps1script13.1 KB
scripts/common/ProcessLedger.ps1script27.1 KB
scripts/common/ProtectedDocumentCleanup.ps1script6.9 KB
scripts/common/README.mdmarkdown1.9 KB
scripts/common/Resolve-VgoAdapter.ps1script4.3 KB
scripts/common/adapter_registry_query.pyexecutablescript3.8 KB
scripts/common/python_helpers.shscript2.8 KB
scripts/common/resolve_vgo_adapter.pyexecutablescript2.4 KB
scripts/common/runtime_contracts.pyscript3.7 KB
scripts/common/vibe-governance-helpers.ps1script75.6 KB
scripts/common/vibe-wave-gate-runner.ps1script28.3 KB
scripts/governance/Invoke-NodeProcessAudit.ps1script3.6 KB
scripts/governance/Invoke-NodeZombieCleanup.ps1script3.7 KB
scripts/governance/README.mdmarkdown5.1 KB
scripts/governance/audit-upstream.ps1script22.7 KB
scripts/governance/export-repo-cleanliness-inventory.ps1script8.6 KB
scripts/governance/install-local-worktree-excludes.ps1script2.0 KB
scripts/governance/invoke-mem0-policy.ps1script1.0 KB
scripts/governance/invoke-openspec-governance.ps1script8.6 KB
scripts/governance/new-origin-record.ps1script3.3 KB
scripts/governance/phase-end-cleanup.ps1script10.7 KB
scripts/governance/publish-absorption-soft-rollout.ps1script3.2 KB
scripts/governance/publish-openspec-soft-rollout.ps1script9.3 KB
scripts/governance/release-cut.ps1script25.1 KB
scripts/governance/set-gsd-overlay-rollout.ps1script3.9 KB
scripts/governance/set-openspec-rollout.ps1script3.1 KB
scripts/governance/sync-bundled-vibe.ps1script20.3 KB
scripts/install/Install-VgoAdapter.ps1script2.0 KB
scripts/install/install_vgo_adapter.pyexecutablescript524 B
scripts/overlay/README.mdmarkdown885 B
scripts/overlay/suggest-browserops-provider.ps1script9.3 KB
scripts/overlay/suggest-overlays.ps1script17.3 KB
scripts/release/build_release_bundle.pyscript6.5 KB
scripts/research/README.mdmarkdown1.1 KB
scripts/research/build-eval-slicing-catalog.ps1script2.6 KB
scripts/research/build-watch-portfolio-review.ps1script3.5 KB
scripts/research/build-xl-operator-checklist.ps1script2.3 KB
scripts/research/extract-prompt-signals.ps1script6.7 KB
scripts/research/generate-vco-suggestions.ps1script9.7 KB
scripts/research/sync-mcp-catalog.ps1script3.5 KB
scripts/research/vibe-adaptive-train.ps1script10.1 KB
scripts/router/README.mdmarkdown1.8 KB
scripts/router/invoke-pack-route.pyscript428 B
scripts/router/modules/00-core-utils.ps1script14.6 KB
scripts/router/modules/01-openai-responses.ps1script17.9 KB
scripts/router/modules/10-observability.ps1script11.7 KB
scripts/router/modules/11-route-probe.ps1script20.7 KB
scripts/router/modules/12-heartbeat.ps1script19.9 KB
scripts/router/modules/19-custom-admission.ps1script16.3 KB
scripts/router/modules/20-routing-rules.ps1script1.7 KB
scripts/router/modules/21-capability-interview.ps1script11.8 KB
scripts/router/modules/22-intent-contract.ps1script18.2 KB
scripts/router/modules/30-openspec.ps1script8.3 KB
scripts/router/modules/31-gsd-overlay.ps1script5.5 KB
scripts/router/modules/32-prompt-overlay.ps1script8.0 KB
scripts/router/modules/33-memory-governance.ps1script5.5 KB
scripts/router/modules/34-data-scale-overlay.ps1script25.8 KB
scripts/router/modules/35-quality-debt-overlay.ps1script13.4 KB
scripts/router/modules/36-framework-interop-overlay.ps1script16.9 KB
scripts/router/modules/37-ml-lifecycle-overlay.ps1script22.4 KB
scripts/router/modules/38-python-clean-code-overlay.ps1script16.2 KB
scripts/router/modules/39-system-design-overlay.ps1script15.5 KB
scripts/router/modules/40-cuda-kernel-overlay.ps1script17.7 KB
scripts/router/modules/42-ai-rerank-overlay.ps1script14.0 KB
scripts/router/modules/43-retrieval-overlay.ps1script22.4 KB
scripts/router/modules/44-dialectic-team-gate.ps1script7.5 KB
scripts/router/modules/44-exploration-overlay.ps1script17.7 KB
scripts/router/modules/45-daily-dialectic-guard.ps1script6.6 KB
scripts/router/modules/47-closure-overlay.ps1script9.2 KB
scripts/router/modules/48-llm-acceleration-overlay.ps1script104.6 KB
scripts/router/modules/49-prompt-asset-boost.ps1script28.3 KB
scripts/router/resolve-pack-route.ps1script4.1 KB
scripts/router/runtime_neutral/custom_admission.pyscript349 B
scripts/router/runtime_neutral/router_contract.pyscript356 B
scripts/ruc-nlpir/preflight.ps1script5.3 KB
scripts/runtime/Freeze-RuntimeInputPacket.ps1script33.0 KB
scripts/runtime/Invoke-AntiProxyGoalDriftCompaction.ps1script551 B
scripts/runtime/Invoke-DeepInterview.ps1script1.1 KB
scripts/runtime/Invoke-PhaseCleanup.ps1script11.1 KB
scripts/runtime/Invoke-PlanExecute.ps1script13.7 KB
scripts/runtime/Invoke-SkeletonCheck.ps1script3.1 KB
scripts/runtime/Invoke-VibeCanonicalEntry.ps1script12.9 KB
scripts/runtime/VibeMemoryActivation.Common.ps1script41.3 KB
scripts/runtime/VibeMemoryBackends.Common.ps1script12.4 KB
scripts/runtime/VibeRuntime.Common.ps1script298.6 KB
scripts/runtime/VibeSkillRouting.Common.ps1script19.0 KB
scripts/runtime/VibeWorkspaceMemory.Common.ps1script6.9 KB
scripts/runtime/Write-RequirementDoc.ps1script23.7 KB
scripts/runtime/Write-XlPlan.ps1script32.3 KB
scripts/runtime/invoke-vibe-runtime.ps1script69.7 KB
scripts/runtime/memory_backend_driver.pyscript14.2 KB
scripts/runtime/skill_authority_driver.pyscript375 B
scripts/runtime/workspace_memory_driver.pyscript24.8 KB
scripts/setup/check-kvm-host-readiness.shscript3.4 KB
scripts/setup/check-windows-eval-iso-readiness.shexecutablescript2.2 KB
scripts/setup/check-windows-proof-vm-state.shexecutablescript2.0 KB
scripts/setup/export-codex-settings-sanitized.ps1script2.6 KB
scripts/setup/fetch-windows11-eval-iso.shexecutablescript4.1 KB
scripts/setup/install-local-vm-host.shexecutablescript1.6 KB
scripts/setup/persist-codex-openai-env.ps1script2.4 KB
scripts/setup/run-windows-proof-vm.shexecutablescript11.4 KB
scripts/setup/send-qmp-boot-keys.pyexecutablescript3.0 KB
scripts/setup/send-qmp-text.pyexecutablescript3.0 KB
scripts/setup/show-windows-proof-media-options.shexecutablescript1.6 KB
scripts/setup/stop-windows-proof-vm.shexecutablescript1.6 KB
scripts/setup/sync-codex-settings-to-user-env.ps1script2.6 KB
scripts/uninstall/Uninstall-VgoAdapter.ps1script1.4 KB
scripts/uninstall/uninstall_vgo_adapter.pyscript526 B
scripts/verify/README.mdmarkdown3.8 KB
scripts/verify/cer-compare.ps1script8.5 KB
scripts/verify/fixtures/README.mdmarkdown1.1 KB
scripts/verify/fixtures/document-cleanup-safety/README.mdmarkdown527 B
scripts/verify/fixtures/document-cleanup-safety/ambiguous-cn-set/metadata.jsonconfig101 B
scripts/verify/fixtures/document-cleanup-safety/ambiguous-cn-set/source/.tmp/docs/重庆市永川区技术预见与制度创新项目申报书1-修订版.docxbinary56 B
scripts/verify/fixtures/document-cleanup-safety/ambiguous-cn-set/source/.tmp/docs/重庆市永川区技术预见与制度创新项目申报书1-补充材料.pdfbinary56 B
scripts/verify/fixtures/document-cleanup-safety/ambiguous-cn-set/source/docs/重庆市永川区技术预见与制度创新项目申报书1-正式版.docxbinary36 B
scripts/verify/fixtures/document-cleanup-safety/mixed-office-assets/metadata.jsonconfig101 B
scripts/verify/fixtures/document-cleanup-safety/mixed-office-assets/source/.tmp/staging/budget-review.xlsxbinary59 B
scripts/verify/fixtures/document-cleanup-safety/mixed-office-assets/source/.tmp/staging/quarterly-review-deck.pptxbinary60 B
scripts/verify/fixtures/document-cleanup-safety/mixed-office-assets/source/docs/reference-manual.pdfbinary21 B
scripts/verify/fixtures/document-cleanup-safety/non-protected-control/metadata.jsonconfig101 B
scripts/verify/fixtures/document-cleanup-safety/non-protected-control/source/.tmp/control.txtmarkdown54 B
scripts/verify/fixtures/llm-acceleration.mock.jsonconfig1.0 KB
scripts/verify/fixtures/pilot-browserops.jsonconfig541 B
scripts/verify/fixtures/pilot-deep-extraction.jsonconfig731 B
scripts/verify/fixtures/pilot-desktopops.jsonconfig587 B
scripts/verify/fixtures/pilot-memory.jsonconfig575 B
scripts/verify/fixtures/pilot-prompt.jsonconfig525 B
scripts/verify/fixtures/process-health/external-node-protected-fixture.jsonconfig345 B
scripts/verify/fixtures/process-health/healthy-managed-fixture.jsonconfig1.1 KB
scripts/verify/fixtures/process-health/managed-completed-alive-fixture.jsonconfig1.2 KB
scripts/verify/fixtures/process-health/managed-stale-fixture.jsonconfig1.1 KB
scripts/verify/fixtures/process-health/no-node-processes-fixture.jsonconfig131 B
scripts/verify/fixtures/prompt-asset-boost.mock.jsonconfig1.2 KB
scripts/verify/gate-family-index.mdmarkdown2.5 KB
scripts/verify/lib/VibeOfflineSkillsAudit.Suites.ps1script11.8 KB
scripts/verify/lib/VibeOfflineSkillsAudit.ps1script12.2 KB
scripts/verify/lib/VibeRouteAudit.Suites.ps1script7.9 KB
scripts/verify/lib/VibeRouteAudit.ps1script5.2 KB
scripts/verify/live-document-gate.pyscript7.6 KB
scripts/verify/probe-scientific-packs.ps1script55.1 KB
scripts/verify/publish-proof.pyscript409 B
scripts/verify/runtime_neutral/README.mdmarkdown2.5 KB
scripts/verify/runtime_neutral/_bootstrap.pyscript321 B
scripts/verify/runtime_neutral/bio_science_pack_consolidation_audit.pyscript421 B
scripts/verify/runtime_neutral/bootstrap_doctor.pyscript494 B
scripts/verify/runtime_neutral/code_quality_pack_consolidation_audit.pyscript717 B
scripts/verify/runtime_neutral/coherence_gate.pyscript529 B
scripts/verify/runtime_neutral/freshness_gate.pyscript494 B
scripts/verify/runtime_neutral/global_pack_consolidation_audit.pyscript635 B
scripts/verify/runtime_neutral/ml_skills_pruning_audit.pyscript574 B
scripts/verify/runtime_neutral/opencode_preview_smoke.pyscript674 B
scripts/verify/runtime_neutral/release_notes_quality.pyscript701 B

scripts/runtime/Invoke-VibeCanonicalEntry.ps1

View on GitHub
param(
    [Parameter(Mandatory)] [string]$Task,
    [Parameter(Mandatory)] [string]$HostId,
    [Parameter(Mandatory)] [string]$EntryId,
    [AllowEmptyString()] [string]$RequestedStageStop = '',
    [AllowEmptyString()] [string]$RequestedGradeFloor = '',
    [AllowEmptyString()] [string]$RunId = '',
    [AllowEmptyString()] [string]$WorkspaceRoot = '',
    [AllowEmptyString()] [string]$ArtifactRoot = '',
    [AllowEmptyString()] [string]$HostDecisionJson = '',
    [AllowEmptyString()] [string]$ModuleExecutionJsonFile = '',
    [AllowEmptyString()] [string]$BridgeOutputJsonPath = ''
)

Set-StrictMode -Version Latest
$ErrorActionPreference = 'Stop'

# Ensure consistent UTF-8 encoding for Unicode path compatibility (e.g., Chinese username paths)
if ($PSVersionTable.PSEdition -eq 'Desktop' -or $PSVersionTable.Platform -eq 'Win32NT') {
    # Windows PowerShell 5.x: set console encoding to UTF-8
    [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
    $OutputEncoding = [System.Text.Encoding]::UTF8
} else {
    # PowerShell Core 7+: already defaults to UTF-8, but ensure consistency
    $OutputEncoding = [System.Text.Encoding]::UTF8
}

$repoRoot = [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot '..\..'))
$runtimeEntrypoint = Join-Path $PSScriptRoot 'invoke-vibe-runtime.ps1'
$runtimeCommonPath = Join-Path $PSScriptRoot 'VibeRuntime.Common.ps1'
if (-not (Test-Path -LiteralPath $runtimeCommonPath -PathType Leaf)) {
    throw ('live governance artifact contract is required: missing runtime contract helper: {0}' -f $runtimeCommonPath)
}
. $runtimeCommonPath
$helperPath = Join-Path $repoRoot 'scripts\common\vibe-governance-helpers.ps1'
$launcherPath = $PSCommandPath
$previousHostId = $env:VCO_HOST_ID

function Get-PreferredPythonInvocation {
    if (Test-Path -LiteralPath $helperPath) {
        . $helperPath
        if (Get-Command Get-VgoPythonCommand -ErrorAction SilentlyContinue) {
            return Get-VgoPythonCommand
        }
    }

    foreach ($candidate in @(
        [pscustomobject]@{ name = 'python3'; prefix_arguments = @() },
        [pscustomobject]@{ name = 'python'; prefix_arguments = @() },
        [pscustomobject]@{ name = 'py'; prefix_arguments = @('-3') }
    )) {
        $command = Get-Command ([string]$candidate.name) -ErrorAction SilentlyContinue
        if ($command) {
            return [pscustomobject]@{
                host_path = $command.Source
                prefix_arguments = @($candidate.prefix_arguments)
            }
        }
    }

    throw 'Python 3.10+ is required to launch the canonical runtime entry.'
}

function Write-Utf8Json {
    param(
        [Parameter(Mandatory)] [string]$Path,
        [Parameter(Mandatory)] [object]$Payload,
        [int]$Depth = 20
    )

    $parent = Split-Path -Parent $Path
    if (-not [string]::IsNullOrWhiteSpace($parent)) {
        [System.IO.Directory]::CreateDirectory($parent) | Out-Null
    }
    $json = $Payload | ConvertTo-Json -Depth $Depth
    $utf8NoBom = [System.Text.UTF8Encoding]::new($false)
    [System.IO.File]::WriteAllText($Path, $json + [Environment]::NewLine, $utf8NoBom)
}

function New-CanonicalRunId {
    $timestamp = (Get-Date).ToUniversalTime().ToString('yyyyMMddTHHmmssZ')
    $suffix = [System.Guid]::NewGuid().ToString('N').Substring(0, 8)
    return "$timestamp-$suffix"
}

function Resolve-CanonicalArtifactRoot {
    param(
        [Parameter(Mandatory)] [string]$BaseRoot,
        [AllowEmptyString()] [string]$ArtifactRoot
    )

    if ([string]::IsNullOrWhiteSpace($ArtifactRoot)) {
        return [System.IO.Path]::GetFullPath((Join-Path $BaseRoot '.vibeskills'))
    }
    if ([System.IO.Path]::IsPathRooted($ArtifactRoot)) {
        return [System.IO.Path]::GetFullPath($ArtifactRoot)
    }
    return [System.IO.Path]::GetFullPath((Join-Path $BaseRoot $ArtifactRoot))
}

function Resolve-CanonicalSessionRoot {
    param(
        [Parameter(Mandatory)] [string]$RepoRoot,
        [Parameter(Mandatory)] [string]$WorkspaceRoot,
        [Parameter(Mandatory)] [string]$ArtifactRoot,
        [Parameter(Mandatory)] [string]$RunId
    )

    return Get-VibeSessionRoot `
        -RepoRoot $RepoRoot `
        -RunId $RunId `
        -WorkspaceRoot $WorkspaceRoot `
        -ArtifactRoot $ArtifactRoot
}

function New-HostLaunchReceiptPayload {
    param(
        [Parameter(Mandatory)] [string]$HostId,
        [Parameter(Mandatory)] [string]$LauncherPath,
        [AllowEmptyString()] [string]$RequestedStageStop,
        [AllowEmptyString()] [string]$RequestedGradeFloor,
        [Parameter(Mandatory)] [string]$RuntimeEntrypoint,
        [Parameter(Mandatory)] [string]$RunId,
        [Parameter(Mandatory)] [string]$LaunchStatus
    )

    return [pscustomobject]@{
        host_id = $HostId
        entry_id = 'vibe'
        launch_mode = 'canonical-entry'
        launcher_path = $LauncherPath
        requested_stage_stop = if ([string]::IsNullOrWhiteSpace($RequestedStageStop)) { $null } else { $RequestedStageStop }
        requested_grade_floor = if ([string]::IsNullOrWhiteSpace($RequestedGradeFloor)) { $null } else { $RequestedGradeFloor }
        runtime_entrypoint = $RuntimeEntrypoint
        run_id = $RunId
        created_at = (Get-Date).ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:ssZ')
        launch_status = $LaunchStatus
    }
}

function Assert-CanonicalTruthArtifacts {
    param([Parameter(Mandatory)] [string]$SessionRoot)

    $required = @(
        'runtime-input-packet.json',
        'governance-capsule.json',
        'stage-lineage.json'
    )
    $missing = @(
        $required |
            Where-Object { -not (Test-Path -LiteralPath (Join-Path $SessionRoot $_) -PathType Leaf) }
    )
    if ($missing.Count -gt 0) {
        throw ('Missing required Python-built runtime artifacts under session_root: {0}' -f ($missing -join ', '))
    }
}

try {
    $env:VCO_HOST_ID = $HostId
    $resolvedRunId = if ([string]::IsNullOrWhiteSpace($RunId)) {
        New-CanonicalRunId
    } else {
        Resolve-VibeSafeRunId -RunId $RunId
    }
    $resolvedWorkspaceRoot = if (-not [string]::IsNullOrWhiteSpace($WorkspaceRoot)) {
        if ([System.IO.Path]::IsPathRooted($WorkspaceRoot)) {
            [System.IO.Path]::GetFullPath($WorkspaceRoot)
        } else {
            [System.IO.Path]::GetFullPath((Join-Path $repoRoot $WorkspaceRoot))
        }
    } elseif (-not [string]::IsNullOrWhiteSpace($ArtifactRoot)) {
        Resolve-CanonicalArtifactRoot -BaseRoot $repoRoot -ArtifactRoot $ArtifactRoot
    } else {
        [System.IO.Path]::GetFullPath($repoRoot)
    }
    $resolvedArtifactRoot = if ([string]::IsNullOrWhiteSpace($WorkspaceRoot) -and -not [string]::IsNullOrWhiteSpace($ArtifactRoot)) {
        $resolvedWorkspaceRoot
    } else {
        Resolve-CanonicalArtifactRoot -BaseRoot $resolvedWorkspaceRoot -ArtifactRoot $ArtifactRoot
    }
    $sessionRoot = Resolve-CanonicalSessionRoot `
        -RepoRoot $repoRoot `
        -WorkspaceRoot $resolvedWorkspaceRoot `
        -ArtifactRoot $resolvedArtifactRoot `
        -RunId $resolvedRunId
    if (-not [string]::IsNullOrWhiteSpace($ModuleExecutionJsonFile)) {
        $requestedWorkspace = if ([string]::IsNullOrWhiteSpace($WorkspaceRoot)) { '' } else { $resolvedWorkspaceRoot }
        $resolvedWorkspaceRoot = Resolve-VibeResultWorkspaceRoot `
            -RepoRoot $repoRoot -SessionRoot $sessionRoot -RunId $resolvedRunId `
            -FallbackWorkspaceRoot $resolvedWorkspaceRoot -RequestedWorkspaceRoot $requestedWorkspace
    }
    $summaryPath = Join-Path $sessionRoot 'runtime-summary.json'
    $receiptPath = Join-Path $sessionRoot 'host-launch-receipt.json'

    $invokeArgs = @{
        Task = $Task
        Mode = 'interactive_governed'
        EntryIntentId = $EntryId
        RunId = $resolvedRunId
        WorkspaceRoot = $resolvedWorkspaceRoot
        ArtifactRoot = $resolvedArtifactRoot
    }
    if (-not [string]::IsNullOrWhiteSpace($RequestedStageStop)) {
        $invokeArgs.RequestedStageStop = $RequestedStageStop
    }
    if (-not [string]::IsNullOrWhiteSpace($RequestedGradeFloor)) {
        $invokeArgs.RequestedGradeFloor = $RequestedGradeFloor
    }
    if (-not [string]::IsNullOrWhiteSpace($HostDecisionJson)) {
        $invokeArgs.HostDecisionJson = $HostDecisionJson
    }
    if (-not [string]::IsNullOrWhiteSpace($ModuleExecutionJsonFile)) {
        $invokeArgs.ModuleExecutionJsonFile = $ModuleExecutionJsonFile
    }

    $launchedReceipt = New-HostLaunchReceiptPayload `
        -HostId $HostId `
        -LauncherPath $launcherPath `
        -RequestedStageStop $RequestedStageStop `
        -RequestedGradeFloor $RequestedGradeFloor `
        -RuntimeEntrypoint $runtimeEntrypoint `
        -RunId $resolvedRunId `
        -LaunchStatus 'launched'
    Write-Utf8Json -Path $receiptPath -Payload $launchedReceipt

    try {
        $result = & $runtimeEntrypoint @invokeArgs
        if ($null -eq $result) {
            throw 'runtime entrypoint returned no payload'
        }
        $expectedSessionRoot = Resolve-CanonicalSessionRoot `
            -RepoRoot $repoRoot `
            -WorkspaceRoot $resolvedWorkspaceRoot `
            -ArtifactRoot $resolvedArtifactRoot `
            -RunId $resolvedRunId
        $expectedSummaryPath = [System.IO.Path]::GetFullPath((Join-Path $expectedSessionRoot 'runtime-summary.json'))
        if (
            -not ($result.PSObject.Properties.Name -contains 'run_id') -or
            $result.run_id -isnot [string] -or
            [string]::IsNullOrWhiteSpace([string]$result.run_id) -or
            ([string]$result.run_id).Trim() -cne $resolvedRunId
        ) {
            throw 'runtime entrypoint returned a run_id that does not match the live governance contract.'
        }
        if (
            -not ($result.PSObject.Properties.Name -contains 'session_root') -or
            $result.session_root -isnot [string] -or
            [string]::IsNullOrWhiteSpace([string]$result.session_root)
        ) {
            throw 'runtime entrypoint must return session_root.'
        }
        $reportedSessionRoot = [System.IO.Path]::GetFullPath([string]$result.session_root)
        if (-not [string]::Equals($reportedSessionRoot, $expectedSessionRoot, [System.StringComparison]::OrdinalIgnoreCase)) {
            throw 'runtime entrypoint returned session_root outside the live governance contract.'
        }
        if (
            -not ($result.PSObject.Properties.Name -contains 'summary_path') -or
            $result.summary_path -isnot [string] -or
            [string]::IsNullOrWhiteSpace([string]$result.summary_path)
        ) {
            throw 'runtime entrypoint must return summary_path.'
        }
        $reportedSummaryPath = [System.IO.Path]::GetFullPath([string]$result.summary_path)
        if (-not [string]::Equals($reportedSummaryPath, $expectedSummaryPath, [System.StringComparison]::OrdinalIgnoreCase)) {
            throw 'runtime entrypoint returned summary_path outside the live governance contract.'
        }
        $sessionRoot = $expectedSessionRoot
        $summaryPath = $expectedSummaryPath
        $receiptPath = Join-Path $sessionRoot 'host-launch-receipt.json'

        Assert-CanonicalTruthArtifacts -SessionRoot $sessionRoot

        $verifiedReceipt = New-HostLaunchReceiptPayload `
            -HostId $HostId `
            -LauncherPath $launcherPath `
            -RequestedStageStop $RequestedStageStop `
            -RequestedGradeFloor $RequestedGradeFloor `
            -RuntimeEntrypoint $runtimeEntrypoint `
            -RunId $resolvedRunId `
            -LaunchStatus 'verified'
        Write-Utf8Json -Path $receiptPath -Payload $verifiedReceipt
    } catch {
        $failedReceipt = New-HostLaunchReceiptPayload `
            -HostId $HostId `
            -LauncherPath $launcherPath `
            -RequestedStageStop $RequestedStageStop `
            -RequestedGradeFloor $RequestedGradeFloor `
            -RuntimeEntrypoint $runtimeEntrypoint `
            -RunId $resolvedRunId `
            -LaunchStatus 'failed'
        Write-Utf8Json -Path $receiptPath -Payload $failedReceipt
        throw
    }

    $payload = [pscustomobject]@{
        host_id = $HostId
        entry_id = 'vibe'
        entry_intent_id = $EntryId
        requested_stage_stop = if ([string]::IsNullOrWhiteSpace($RequestedStageStop)) { $null } else { $RequestedStageStop }
        requested_grade_floor = if ([string]::IsNullOrWhiteSpace($RequestedGradeFloor)) { $null } else { $RequestedGradeFloor }
        launcher_path = $launcherPath
        runtime_entrypoint = $runtimeEntrypoint
        run_id = $resolvedRunId
        session_root = $sessionRoot
        summary_path = $summaryPath
        host_launch_receipt_path = $receiptPath
        launch_mode = 'canonical-entry'
        summary = $result.summary
    }
    if (-not [string]::IsNullOrWhiteSpace($BridgeOutputJsonPath)) {
        Write-Utf8Json -Path $BridgeOutputJsonPath -Payload $payload -Depth 20
    } else {
        $payload | ConvertTo-Json -Depth 20
    }
} finally {
    if ([string]::IsNullOrWhiteSpace($previousHostId)) {
        Remove-Item Env:VCO_HOST_ID -ErrorAction SilentlyContinue
    } else {
        $env:VCO_HOST_ID = $previousHostId
    }
}
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall