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/common/NodeLaunchWrapper.ps1

View on GitHub
param(
    [string]$FilePath,
    [string[]]$ArgumentList = @(),
    [string]$Label = 'node-runtime',
    [string]$WorkingDirectory,
    [string]$OwnerId,
    [int]$WaitForNodeSec = 20,
    [int]$HeartbeatIntervalSec = 0,
    [switch]$PassThru,
    [switch]$NoHeartbeatMonitor,
    [switch]$MonitorMode,
    [string]$EntryId,
    [int]$LauncherPid,
    [string]$RepoRoot
)

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

. (Join-Path $PSScriptRoot 'ProcessLedger.ps1')

function Get-VgoProcessTableSnapshot {
    param([Nullable[int]]$RootPid)

    if (-not (Test-VgoIsWindows)) {
        return @()
    }

    $selected = @()
    $rootStartedAt = $null
    if ($null -ne $RootPid -and $RootPid -gt 0) {
        try {
            $rootProcess = Get-Process -Id $RootPid -ErrorAction Stop
            $selected += @($rootProcess)
            try {
                $rootStartedAt = $rootProcess.StartTime.ToUniversalTime()
            } catch {
                $rootStartedAt = $null
            }
        } catch {
        }
    }

    try {
        $nodeProcesses = @(Get-Process -Name node,node.exe -ErrorAction SilentlyContinue)
        if ($null -ne $rootStartedAt) {
            $cutoff = $rootStartedAt.AddSeconds(-2)
            $nodeProcesses = @(
                $nodeProcesses | Where-Object {
                    try {
                        $_.StartTime.ToUniversalTime() -ge $cutoff
                    } catch {
                        $true
                    }
                }
            )
        }
        $selected += $nodeProcesses
    } catch {
    }

    $selected = @($selected | Sort-Object Id -Unique)
    if ($selected.Count -eq 0) {
        return @()
    }

    $metadataByPid = Get-VgoWindowsProcessMetadata -Pids @($selected | ForEach-Object { [int]$_.Id })
    return @(
        foreach ($proc in $selected) {
            $processId = [int]$proc.Id
            $metadata = if ($metadataByPid.ContainsKey([string]$processId)) { $metadataByPid[[string]$processId] } else { $null }
            [pscustomobject]@{
                pid = $processId
                parent_pid = if ($null -ne $metadata) { [int]$metadata.parent_pid } else { $null }
                process_name = if ($null -ne $metadata -and $metadata.process_name) { [string]$metadata.process_name } else { [string]$proc.ProcessName }
                command_line = if ($null -ne $metadata) { [string]$metadata.command_line } else { $null }
            }
        }
    )
}

function Get-VgoProcessDepthToRoot {
    param(
        [hashtable]$ByPid,
        [int]$ProcessId,
        [int]$RootPid
    )

    $depth = 0
    $cursor = $ProcessId
    $guard = 0
    while ($cursor -gt 0 -and $guard -lt 512) {
        if ($cursor -eq $RootPid) {
            return $depth
        }
        if (-not $ByPid.ContainsKey([string]$cursor)) {
            return $null
        }
        $cursor = [int]$ByPid[[string]$cursor].parent_pid
        $depth++
        $guard++
    }

    return $null
}

function Find-VgoNodeProcessForLauncher {
    param(
        [int]$RootPid,
        [string]$RepoRoot
    )

    if ($RootPid -le 0) {
        return $null
    }

    $context = Get-VgoProcessHealthContext -RepoRoot $RepoRoot
    $table = @(Get-VgoProcessTableSnapshot -RootPid $RootPid)
    if ($table.Count -eq 0) {
        try {
            $root = Get-Process -Id $RootPid -ErrorAction Stop
            if ($root.ProcessName -eq 'node') {
                return [pscustomobject]@{
                    pid = [int]$root.Id
                    parent_pid = $null
                    process_name = 'node'
                    command_line = $null
                }
            }
        } catch {
            return $null
        }
        return $null
    }

    $byPid = @{}
    foreach ($row in $table) {
        $byPid[[string]$row.pid] = $row
    }

    $candidates = @()
    foreach ($row in $table) {
        if (-not (Test-VgoNodeProcessName -ProcessName $row.process_name -HealthPolicy $context.healthPolicy)) {
            continue
        }

        $depth = Get-VgoProcessDepthToRoot -ByPid $byPid -ProcessId ([int]$row.pid) -RootPid $RootPid
        if ($null -eq $depth) {
            continue
        }

        $candidates += [pscustomobject]@{
            pid = [int]$row.pid
            parent_pid = [int]$row.parent_pid
            process_name = [string]$row.process_name
            command_line = [string]$row.command_line
            depth = $depth
        }
    }

    if ($candidates.Count -eq 0) {
        return $null
    }

    return $candidates | Sort-Object depth, pid | Select-Object -First 1
}

function Wait-VgoNodeProcessDiscovery {
    param(
        [int]$RootPid,
        [int]$TimeoutSec,
        [string]$RepoRoot
    )

    $deadline = (Get-Date).ToUniversalTime().AddSeconds([Math]::Max(1, $TimeoutSec))
    do {
        $candidate = Find-VgoNodeProcessForLauncher -RootPid $RootPid -RepoRoot $RepoRoot
        if ($null -ne $candidate) {
            return $candidate
        }

        if (-not (Test-VgoProcessAlive -ProcessId $RootPid)) {
            break
        }

        Start-Sleep -Milliseconds 800
    } while ((Get-Date).ToUniversalTime() -lt $deadline)

    return $null
}

function Resolve-VgoMonitorHostPath {
    foreach ($candidate in @(
        (Join-Path $PSHOME 'powershell.exe'),
        (Get-Command powershell.exe -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Source -First 1),
        (Get-Command pwsh.exe -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Source -First 1)
    )) {
        if (-not [string]::IsNullOrWhiteSpace($candidate) -and (Test-Path -LiteralPath $candidate)) {
            return $candidate
        }
    }

    throw 'Unable to resolve PowerShell host for heartbeat monitor.'
}

function Invoke-VgoNodeHeartbeatMonitor {
    param(
        [Parameter(Mandatory)] [string]$EntryId,
        [Parameter(Mandatory)] [int]$LauncherPid,
        [Parameter(Mandatory)] [string]$RepoRoot,
        [int]$HeartbeatIntervalSec
    )

    $context = Initialize-VgoProcessHealthRuntime -RepoRoot $RepoRoot
    $ledger = Get-VgoProcessLedger -RepoRoot $context.repoRoot
    $entry = @($ledger.entries | Where-Object { [string]$_.entry_id -eq $EntryId } | Select-Object -First 1)
    if ($entry.Count -eq 0) {
        throw "Unable to locate ledger entry '$EntryId'."
    }

    $currentEntry = $entry[0]
    $heartbeatPath = if ([System.IO.Path]::IsPathRooted([string]$currentEntry.heartbeat_path)) {
        [string]$currentEntry.heartbeat_path
    } else {
        Join-Path $context.repoRoot ([string]$currentEntry.heartbeat_path)
    }

    $interval = if ($HeartbeatIntervalSec -gt 0) {
        $HeartbeatIntervalSec
    } elseif ($currentEntry.heartbeat_interval_sec -gt 0) {
        [int]$currentEntry.heartbeat_interval_sec
    } else {
        [int]$context.ledgerPolicy.defaults.heartbeat_interval_sec
    }

    while ($true) {
        $now = Get-VgoUtcTimestamp
        $launcherAlive = Test-VgoProcessAlive -ProcessId $LauncherPid
        $nodeCandidate = Find-VgoNodeProcessForLauncher -RootPid $LauncherPid -RepoRoot $context.repoRoot

        if ($null -ne $nodeCandidate) {
            $currentEntry = Update-VgoProcessLedgerEntry -EntryId $EntryId -RepoRoot $context.repoRoot -EventType 'entry.heartbeat' -Note 'node heartbeat observed' -Patch @{
                pid = [int]$nodeCandidate.pid
                target_process_name = [string]$nodeCandidate.process_name
                command_line = if ($nodeCandidate.command_line) { [string]$nodeCandidate.command_line } else { [string]$currentEntry.command_line }
                node_pid_confirmed = $true
                cleanup_safe = $true
                status = 'running'
                last_heartbeat_at = $now
                last_seen_alive_at = $now
            }
            Write-VgoProcessHeartbeatFile -Path $heartbeatPath -EntryId $EntryId -State 'running' -Note 'node heartbeat observed' -ProcessId ([int]$nodeCandidate.pid) -LauncherPid $LauncherPid
            Start-Sleep -Seconds $interval
            continue
        }

        if ($launcherAlive) {
            $currentEntry = Update-VgoProcessLedgerEntry -EntryId $EntryId -RepoRoot $context.repoRoot -EventType 'entry.heartbeat' -Note 'launcher alive, waiting for node runtime' -Patch @{
                status = 'running'
                last_heartbeat_at = $now
                last_seen_alive_at = $now
            }
            Write-VgoProcessHeartbeatFile -Path $heartbeatPath -EntryId $EntryId -State 'launcher_only' -Note 'launcher alive, waiting for node runtime' -ProcessId ([int]$currentEntry.pid) -LauncherPid $LauncherPid
            Start-Sleep -Seconds $interval
            continue
        }

        $targetAlive = Test-VgoProcessAlive -ProcessId ([int]$currentEntry.pid)
        if ($targetAlive) {
            $currentEntry = Complete-VgoProcessLedgerEntry -EntryId $EntryId -RepoRoot $context.repoRoot -FinalStatus 'completed' -Note 'launcher exited while target remained alive'
            Write-VgoProcessHeartbeatFile -Path $heartbeatPath -EntryId $EntryId -State 'orphaned_after_completion' -Note 'launcher exited while target remained alive' -ProcessId ([int]$currentEntry.pid) -LauncherPid $LauncherPid
            break
        }

        $currentEntry = Complete-VgoProcessLedgerEntry -EntryId $EntryId -RepoRoot $context.repoRoot -FinalStatus 'completed' -Note 'launcher and target exited'
        Write-VgoProcessHeartbeatFile -Path $heartbeatPath -EntryId $EntryId -State 'completed' -Note 'launcher and target exited' -ProcessId ([int]$currentEntry.pid) -LauncherPid $LauncherPid
        break
    }
}

if ($MonitorMode) {
    Invoke-VgoNodeHeartbeatMonitor -EntryId $EntryId -LauncherPid $LauncherPid -RepoRoot $RepoRoot -HeartbeatIntervalSec $HeartbeatIntervalSec
    return
}

if ([string]::IsNullOrWhiteSpace($FilePath)) {
    throw 'FilePath is required unless -MonitorMode is used.'
}

$resolvedRepoRoot = if ([string]::IsNullOrWhiteSpace($RepoRoot)) {
    Resolve-VgoRepoRoot -StartPath $PSScriptRoot
} else {
    [System.IO.Path]::GetFullPath($RepoRoot)
}

$context = Initialize-VgoProcessHealthRuntime -RepoRoot $resolvedRepoRoot
$workingDir = if ([string]::IsNullOrWhiteSpace($WorkingDirectory)) { (Get-Location).Path } else { $WorkingDirectory }
$owner = if ([string]::IsNullOrWhiteSpace($OwnerId)) { '{0}@{1}' -f $env:USERNAME, $env:COMPUTERNAME } else { $OwnerId }
$intervalSec = if ($HeartbeatIntervalSec -gt 0) { $HeartbeatIntervalSec } else { [int]$context.ledgerPolicy.defaults.heartbeat_interval_sec }
$commandLine = (($FilePath) + ' ' + (($ArgumentList | Where-Object { $_ -ne $null }) -join ' ')).Trim()

$launched = Start-Process -FilePath $FilePath -ArgumentList $ArgumentList -WorkingDirectory $workingDir -PassThru
$nodeCandidate = Wait-VgoNodeProcessDiscovery -RootPid ([int]$launched.Id) -TimeoutSec $WaitForNodeSec -RepoRoot $context.repoRoot
$entryIdValue = New-VgoProcessLedgerEntryId
$heartbeatPath = Join-Path $context.heartbeatsDir ("{0}.json" -f $entryIdValue)
$heartbeatRelPath = Get-VgoRelativePathPortable -BasePath $context.repoRoot -TargetPath $heartbeatPath
$effectivePid = if ($null -ne $nodeCandidate) { [int]$nodeCandidate.pid } else { [int]$launched.Id }

$entry = Register-VgoProcessLedgerEntry -RepoRoot $context.repoRoot -Entry @{
    entry_id = $entryIdValue
    label = $Label
    owner_id = $owner
    pid = $effectivePid
    launcher_pid = [int]$launched.Id
    working_directory = $workingDir
    command_line = if ($null -ne $nodeCandidate -and $nodeCandidate.command_line) { [string]$nodeCandidate.command_line } else { $commandLine }
    heartbeat_path = $heartbeatRelPath
    cleanup_safe = ($null -ne $nodeCandidate)
    node_pid_confirmed = ($null -ne $nodeCandidate)
    stale_after_sec = [int]$context.ledgerPolicy.defaults.stale_after_sec
    heartbeat_interval_sec = $intervalSec
    target_process_name = if ($null -ne $nodeCandidate) { [string]$nodeCandidate.process_name } else { [string]$launched.ProcessName }
} -Note 'wrapper launch registered'

$heartbeatState = if ($null -ne $nodeCandidate) { 'running' } else { 'launcher_only' }
$heartbeatNote = if ($null -ne $nodeCandidate) { 'node runtime discovered at launch' } else { 'launcher registered before node discovery' }
Write-VgoProcessHeartbeatFile -Path $heartbeatPath -EntryId $entry.entry_id -State $heartbeatState -Note $heartbeatNote -ProcessId $effectivePid -LauncherPid ([int]$launched.Id)

if (-not $NoHeartbeatMonitor) {
    $hostPath = Resolve-VgoMonitorHostPath
    $monitorArgs = @(
        '-NoProfile',
        '-ExecutionPolicy', 'Bypass',
        '-File', $PSCommandPath,
        '-MonitorMode',
        '-EntryId', $entry.entry_id,
        '-LauncherPid', ([string]$launched.Id),
        '-RepoRoot', $context.repoRoot,
        '-HeartbeatIntervalSec', ([string]$intervalSec)
    )
    Start-Process -FilePath $hostPath -ArgumentList $monitorArgs -WindowStyle Hidden | Out-Null
}

$result = [pscustomobject]@{
    entry_id = [string]$entry.entry_id
    label = [string]$entry.label
    launcher_pid = [int]$launched.Id
    pid = [int]$entry.pid
    node_pid_confirmed = [bool]$entry.node_pid_confirmed
    cleanup_safe = [bool]$entry.cleanup_safe
    heartbeat_path = [string]$entry.heartbeat_path
    command_line = [string]$entry.command_line
}

if ($PassThru) {
    return $result
}

$result | ConvertTo-Json -Depth 10
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