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/router/modules/12-heartbeat.ps1

View on GitHub
# Auto-extracted router module. Keep function bodies behavior-identical.

function Get-HeartbeatPolicyValue {
    param(
        [object]$Container,
        [string]$Key,
        [object]$DefaultValue
    )

    if (-not $Container) { return $DefaultValue }
    $keys = @($Container.PSObject.Properties.Name)
    if ($keys -contains $Key) {
        return $Container.$Key
    }
    return $DefaultValue
}

function Get-HeartbeatGradePolicy {
    param(
        [object]$HeartbeatPolicy,
        [string]$Grade
    )

    if (-not $HeartbeatPolicy -or -not $HeartbeatPolicy.policy_by_grade) { return $null }
    $gradePolicies = $HeartbeatPolicy.policy_by_grade
    $gradeKeys = @($gradePolicies.PSObject.Properties.Name)
    if ($gradeKeys -contains $Grade) {
        return $gradePolicies.$Grade
    }
    return $null
}

function Get-HeartbeatStallAssessment {
    param(
        [double]$SilenceSec,
        [double]$NoStateChangeSec,
        [double]$SoftStallSec,
        [double]$HardStallSec,
        [double]$MaxNoStateChangeSec
    )

    $safeHard = if ($HardStallSec -gt 0) { $HardStallSec } else { 1.0 }
    $safeNoState = if ($MaxNoStateChangeSec -gt 0) { $MaxNoStateChangeSec } else { 1.0 }
    $silenceScore = [Math]::Min(1.0, [Math]::Max(0.0, ($SilenceSec / $safeHard)))
    $noStateScore = [Math]::Min(1.0, [Math]::Max(0.0, ($NoStateChangeSec / $safeNoState)))
    $stallScore = [Math]::Round([Math]::Max($silenceScore, $noStateScore), 4)

    $hardStall = (($HardStallSec -le 0 -and $SilenceSec -ge 0) -or ($SilenceSec -ge $HardStallSec))
    if (-not $hardStall -and $MaxNoStateChangeSec -gt 0) {
        $hardStall = ($NoStateChangeSec -ge $MaxNoStateChangeSec)
    } elseif (-not $hardStall -and $MaxNoStateChangeSec -le 0 -and $NoStateChangeSec -ge 0) {
        $hardStall = $true
    }

    $suspectStall = $false
    if (-not $hardStall) {
        if ($SoftStallSec -le 0) {
            $suspectStall = ($SilenceSec -ge 0)
        } else {
            $suspectStall = ($SilenceSec -ge $SoftStallSec)
        }
    }

    return [pscustomobject]@{
        stall_score = [double]$stallScore
        suspect_stall = [bool]$suspectStall
        hard_stall = [bool]$hardStall
    }
}

function New-HeartbeatContext {
    param(
        [object]$HeartbeatPolicy,
        [string]$Grade,
        [string]$TaskType
    )

    $mode = if ($HeartbeatPolicy -and $HeartbeatPolicy.mode) { [string]$HeartbeatPolicy.mode } else { "off" }
    $enabled = [bool]($HeartbeatPolicy -and $HeartbeatPolicy.enabled -ne $null -and [bool]$HeartbeatPolicy.enabled -and $mode -ne "off")
    $preserveRoutingAssignment = [bool](Get-HeartbeatPolicyValue -Container $HeartbeatPolicy -Key "preserve_routing_assignment" -DefaultValue $true)
    $timers = if ($HeartbeatPolicy) { $HeartbeatPolicy.timers } else { $null }
    $gradePolicy = Get-HeartbeatGradePolicy -HeartbeatPolicy $HeartbeatPolicy -Grade $Grade

    $scope = if ($HeartbeatPolicy) { $HeartbeatPolicy.scope } else { $null }
    $gradeAllow = if ($scope -and $scope.grade_allow) { @($scope.grade_allow) } else { @("M", "L", "XL") }
    $taskAllow = if ($scope -and $scope.task_allow) { @($scope.task_allow) } else { @("planning", "coding", "review", "debug", "research") }
    $gradeApplicable = ($gradeAllow -contains $Grade)
    $taskApplicable = ($taskAllow -contains $TaskType)
    $scopeApplicable = [bool]($gradeApplicable -and $taskApplicable)

    $briefInterval = [int](Get-HeartbeatPolicyValue -Container $timers -Key "user_brief_interval_sec" -DefaultValue 15)
    $debugTick = [int](Get-HeartbeatPolicyValue -Container $timers -Key "debug_tick_interval_sec" -DefaultValue 5)
    $softStall = [double](Get-HeartbeatPolicyValue -Container $timers -Key "soft_stall_silence_sec" -DefaultValue 30)
    $hardStall = [double](Get-HeartbeatPolicyValue -Container $timers -Key "hard_stall_silence_sec" -DefaultValue 120)
    $maxNoState = [double](Get-HeartbeatPolicyValue -Container $timers -Key "max_no_state_change_sec" -DefaultValue 180)

    if ($gradePolicy) {
        if ($gradePolicy.brief_interval_sec -ne $null) {
            $briefInterval = [int]$gradePolicy.brief_interval_sec
        }
        if ($gradePolicy.hard_stall_silence_sec -ne $null) {
            $hardStall = [double]$gradePolicy.hard_stall_silence_sec
        }
    }

    $autoDiagnosis = if ($HeartbeatPolicy) { $HeartbeatPolicy.auto_diagnosis } else { $null }
    $noiseControl = if ($HeartbeatPolicy) { $HeartbeatPolicy.noise_control } else { $null }
    $runtimeDigest = if ($HeartbeatPolicy) { $HeartbeatPolicy.runtime_digest } else { $null }

    $runtimeDigestEnabled = [bool](Get-HeartbeatPolicyValue -Container $runtimeDigest -Key "enabled" -DefaultValue $true)
    $runtimeDigestPulseCount = [int](Get-HeartbeatPolicyValue -Container $runtimeDigest -Key "include_recent_pulses" -DefaultValue 8)
    if ($runtimeDigestPulseCount -le 0) { $runtimeDigestPulseCount = 8 }

    $now = [DateTime]::UtcNow
    return [pscustomobject]@{
        enabled = [bool]($enabled -and $scopeApplicable)
        configured_enabled = [bool]$enabled
        mode = $mode
        grade = $Grade
        task_type = $TaskType
        grade_applicable = [bool]$gradeApplicable
        task_applicable = [bool]$taskApplicable
        scope_applicable = [bool]$scopeApplicable
        preserve_routing_assignment = [bool]$preserveRoutingAssignment
        user_brief_interval_sec = [int]$briefInterval
        debug_tick_interval_sec = [int]$debugTick
        soft_stall_silence_sec = [double]$softStall
        hard_stall_silence_sec = [double]$hardStall
        max_no_state_change_sec = [double]$maxNoState
        auto_diagnosis_enabled = [bool](Get-HeartbeatPolicyValue -Container $autoDiagnosis -Key "enabled" -DefaultValue $false)
        auto_diagnosis_tail_lines = [int](Get-HeartbeatPolicyValue -Container $autoDiagnosis -Key "tail_lines" -DefaultValue 120)
        auto_diagnosis_collect_process_snapshot = [bool](Get-HeartbeatPolicyValue -Container $autoDiagnosis -Key "collect_process_snapshot" -DefaultValue $false)
        auto_diagnosis_collect_last_phase = [bool](Get-HeartbeatPolicyValue -Container $autoDiagnosis -Key "collect_last_phase" -DefaultValue $true)
        runtime_digest_enabled = [bool]$runtimeDigestEnabled
        runtime_digest_recent_pulses = [int]$runtimeDigestPulseCount
        noise_suppress_duplicate_state = [bool](Get-HeartbeatPolicyValue -Container $noiseControl -Key "suppress_duplicate_state" -DefaultValue $true)
        noise_min_delta_elapsed_sec = [double](Get-HeartbeatPolicyValue -Container $noiseControl -Key "min_delta_elapsed_sec" -DefaultValue 10)
        noise_only_emit_on_phase_or_risk_change = [bool](Get-HeartbeatPolicyValue -Container $noiseControl -Key "only_emit_on_phase_or_risk_change" -DefaultValue $true)
        lifecycle_status = if ($enabled -and $scopeApplicable) { "running" } elseif (-not $enabled) { "disabled" } else { "outside_scope" }
        current_status = if ($enabled -and $scopeApplicable) { "running" } elseif (-not $enabled) { "disabled" } else { "outside_scope" }
        current_phase = "router.init"
        pulse_count = 0
        stall_score = 0.0
        suspect_stall = $false
        hard_stall = $false
        auto_diagnosis_triggered = $false
        status_reason = if (-not $enabled) { "policy_off" } elseif (-not $scopeApplicable) { "outside_scope" } else { "healthy_running" }
        created_utc = $now.ToString("o")
        start_utc = $now.ToString("o")
        last_pulse_utc = $null
        last_stage = $null
        last_note = $null
        next_seq = 1
        pulses = (New-Object System.Collections.ArrayList)
        _start_at = $now
        _last_output_at = $now
        _last_state_change_at = $now
        _last_phase = "router.init"
        _last_signature = $null
        _last_emit_elapsed_sec = 0.0
    }
}

function Add-HeartbeatPulse {
    param(
        [object]$Context,
        [string]$Stage,
        [string]$Phase,
        [string]$Note,
        [object]$Data,
        [switch]$ForceEmit
    )

    if (-not $Context -or -not $Context.enabled) { return $null }

    $now = [DateTime]::UtcNow
    $phaseName = if ($Phase) { [string]$Phase } elseif ($Context.current_phase) { [string]$Context.current_phase } else { "router" }
    $phaseChanged = ($phaseName -ne [string]$Context._last_phase)
    if ($phaseChanged) {
        $Context._last_phase = $phaseName
        $Context._last_state_change_at = $now
    }

    $outputActivity = $true
    if ($Data -and $Data.PSObject.Properties.Name -contains "output_activity") {
        $outputActivity = [bool]$Data.output_activity
    }
    if ($outputActivity) {
        $Context._last_output_at = $now
    }

    $elapsedSec = [Math]::Round(($now - $Context._start_at).TotalSeconds, 3)
    $lastOutputAgoSec = [Math]::Round(($now - $Context._last_output_at).TotalSeconds, 3)
    $noStateChangeSec = [Math]::Round(($now - $Context._last_state_change_at).TotalSeconds, 3)
    $assessment = Get-HeartbeatStallAssessment `
        -SilenceSec $lastOutputAgoSec `
        -NoStateChangeSec $noStateChangeSec `
        -SoftStallSec ([double]$Context.soft_stall_silence_sec) `
        -HardStallSec ([double]$Context.hard_stall_silence_sec) `
        -MaxNoStateChangeSec ([double]$Context.max_no_state_change_sec)

    $status = "running"
    if ($assessment.hard_stall) {
        $status = "hard_stall"
    } elseif ($assessment.suspect_stall) {
        $status = "suspect_stall"
    } elseif ($Context.hard_stall -or $Context.suspect_stall) {
        $status = "recovered"
    } elseif ($phaseChanged -or $outputActivity) {
        $status = "progressing"
    }

    if ($status -eq "hard_stall" -and [string]$Context.mode -eq "strict" -and [bool]$Context.auto_diagnosis_enabled) {
        $Context.auto_diagnosis_triggered = $true
    }

    $signature = "{0}|{1}|{2}" -f $status, $phaseName, [Math]::Round([double]$assessment.stall_score, 2)
    $deltaElapsed = [Math]::Abs([double]$elapsedSec - [double]$Context._last_emit_elapsed_sec)
    $shouldSuppress = $false
    if (-not $ForceEmit -and [bool]$Context.noise_suppress_duplicate_state) {
        if ($signature -eq [string]$Context._last_signature) {
            $minDelta = [double]$Context.noise_min_delta_elapsed_sec
            if ($deltaElapsed -lt $minDelta) {
                $shouldSuppress = $true
            }
        }
    }

    if ($shouldSuppress -and [bool]$Context.noise_only_emit_on_phase_or_risk_change -and (-not $phaseChanged)) {
        $Context.current_status = $status
        $Context.current_phase = $phaseName
        $Context.stall_score = [double]$assessment.stall_score
        $Context.suspect_stall = [bool]$assessment.suspect_stall
        $Context.hard_stall = [bool]$assessment.hard_stall
        return $null
    }

    $entry = [pscustomobject]@{
        seq = [int]$Context.next_seq
        timestamp_utc = $now.ToString("o")
        stage = if ($Stage) { [string]$Stage } else { "heartbeat.tick" }
        phase = $phaseName
        status = $status
        elapsed_sec = [double]$elapsedSec
        last_output_sec_ago = [double]$lastOutputAgoSec
        no_state_change_sec = [double]$noStateChangeSec
        stall_score = [double]$assessment.stall_score
        note = if ($Note) { [string]$Note } else { "" }
        data = if ($Data) {
            try { $Data | ConvertTo-Json -Depth 12 | ConvertFrom-Json } catch { [string]$Data }
        } else { $null }
    }

    [void]$Context.pulses.Add($entry)
    $Context.next_seq = [int]$Context.next_seq + 1
    $Context.pulse_count = [int]$Context.pulse_count + 1
    $Context.current_status = $status
    $Context.current_phase = $phaseName
    $Context.stall_score = [double]$assessment.stall_score
    $Context.suspect_stall = [bool]$assessment.suspect_stall
    $Context.hard_stall = [bool]$assessment.hard_stall
    $Context.last_stage = $entry.stage
    $Context.last_note = $entry.note
    $Context.last_pulse_utc = $entry.timestamp_utc
    $Context._last_signature = $signature
    $Context._last_emit_elapsed_sec = [double]$elapsedSec

    if ($status -eq "hard_stall") {
        $Context.status_reason = "hard_stall"
    } elseif ($status -eq "suspect_stall") {
        $Context.status_reason = "suspect_stall"
    } elseif ($status -eq "recovered") {
        $Context.status_reason = "recovered_after_stall"
    } else {
        $Context.status_reason = "healthy_running"
    }

    return $entry
}

function Get-HeartbeatAdvice {
    param([object]$Context)

    if (-not $Context) {
        return [pscustomobject]@{
            enabled = $false
            mode = "off"
            scope_applicable = $false
            enforcement = "none"
            reason = "context_missing"
            confirm_required = $false
            preserve_routing_assignment = $true
        }
    }

    if (-not $Context.enabled) {
        return [pscustomobject]@{
            enabled = $false
            mode = [string]$Context.mode
            scope_applicable = [bool]$Context.scope_applicable
            enforcement = "none"
            reason = [string]$Context.status_reason
            confirm_required = $false
            preserve_routing_assignment = [bool]$Context.preserve_routing_assignment
            status = [string]$Context.current_status
            lifecycle_status = [string]$Context.lifecycle_status
            pulse_count = [int]$Context.pulse_count
            stall_score = [double]$Context.stall_score
            suspect_stall = [bool]$Context.suspect_stall
            hard_stall = [bool]$Context.hard_stall
            auto_diagnosis_enabled = [bool]$Context.auto_diagnosis_enabled
            auto_diagnosis_triggered = [bool]$Context.auto_diagnosis_triggered
            confidence = 0.0
        }
    }

    $enforcement = "advisory"
    $confirmRequired = $false
    if ([string]$Context.mode -eq "soft" -and ([bool]$Context.suspect_stall -or [bool]$Context.hard_stall)) {
        $enforcement = "confirm_required"
        $confirmRequired = $true
    } elseif ([string]$Context.mode -eq "strict") {
        if ([bool]$Context.hard_stall) {
            $enforcement = "required"
            $confirmRequired = $true
        } elseif ([bool]$Context.suspect_stall) {
            $enforcement = "confirm_required"
            $confirmRequired = $true
        }
    }

    $reason = if ($Context.hard_stall) { "hard_stall" } elseif ($Context.suspect_stall) { "suspect_stall" } else { "healthy_running" }
    $confidence = [Math]::Round([Math]::Min(1.0, [Math]::Max(0.1, [double]$Context.stall_score)), 4)

    return [pscustomobject]@{
        enabled = $true
        mode = [string]$Context.mode
        scope_applicable = [bool]$Context.scope_applicable
        enforcement = $enforcement
        reason = $reason
        confirm_required = [bool]$confirmRequired
        preserve_routing_assignment = [bool]$Context.preserve_routing_assignment
        status = [string]$Context.current_status
        lifecycle_status = [string]$Context.lifecycle_status
        pulse_count = [int]$Context.pulse_count
        stall_score = [double]$Context.stall_score
        suspect_stall = [bool]$Context.suspect_stall
        hard_stall = [bool]$Context.hard_stall
        user_brief_interval_sec = [int]$Context.user_brief_interval_sec
        debug_tick_interval_sec = [int]$Context.debug_tick_interval_sec
        soft_stall_silence_sec = [double]$Context.soft_stall_silence_sec
        hard_stall_silence_sec = [double]$Context.hard_stall_silence_sec
        max_no_state_change_sec = [double]$Context.max_no_state_change_sec
        auto_diagnosis_enabled = [bool]$Context.auto_diagnosis_enabled
        auto_diagnosis_triggered = [bool]$Context.auto_diagnosis_triggered
        confidence = [double]$confidence
    }
}

function Get-HeartbeatStatus {
    param([object]$Context)

    if (-not $Context) {
        return [pscustomobject]@{
            enabled = $false
            lifecycle_status = "missing"
            current_status = "missing"
            pulse_count = 0
            elapsed_sec = 0.0
        }
    }

    $elapsedSec = [Math]::Round(([DateTime]::UtcNow - $Context._start_at).TotalSeconds, 3)
    $lastOutputAgoSec = [Math]::Round(([DateTime]::UtcNow - $Context._last_output_at).TotalSeconds, 3)
    $noStateChangeSec = [Math]::Round(([DateTime]::UtcNow - $Context._last_state_change_at).TotalSeconds, 3)

    return [pscustomobject]@{
        enabled = [bool]$Context.enabled
        mode = [string]$Context.mode
        lifecycle_status = [string]$Context.lifecycle_status
        current_status = [string]$Context.current_status
        current_phase = [string]$Context.current_phase
        pulse_count = [int]$Context.pulse_count
        elapsed_sec = [double]$elapsedSec
        last_output_sec_ago = [double]$lastOutputAgoSec
        no_state_change_sec = [double]$noStateChangeSec
        stall_score = [double]$Context.stall_score
        suspect_stall = [bool]$Context.suspect_stall
        hard_stall = [bool]$Context.hard_stall
        auto_diagnosis_triggered = [bool]$Context.auto_diagnosis_triggered
        start_utc = [string]$Context.start_utc
        last_pulse_utc = [string]$Context.last_pulse_utc
        last_stage = [string]$Context.last_stage
        last_note = [string]$Context.last_note
    }
}

function Get-HeartbeatRuntimeDigest {
    param(
        [object]$Context,
        [int]$RecentPulseCount = 8
    )

    if (-not $Context -or -not $Context.runtime_digest_enabled) {
        return [pscustomobject]@{
            enabled = $false
            reason = "runtime_digest_disabled"
        }
    }
    if (-not $Context.enabled) {
        return [pscustomobject]@{
            enabled = $false
            reason = "heartbeat_disabled"
        }
    }

    $limit = if ($RecentPulseCount -gt 0) { $RecentPulseCount } else { [int]$Context.runtime_digest_recent_pulses }
    if ($limit -le 0) { $limit = 8 }
    $pulseArray = @($Context.pulses)
    $recentPulses = @($pulseArray | Select-Object -Last $limit | ForEach-Object {
            [pscustomobject]@{
                seq = [int]$_.seq
                stage = [string]$_.stage
                phase = [string]$_.phase
                status = [string]$_.status
                elapsed_sec = [double]$_.elapsed_sec
                stall_score = [double]$_.stall_score
            }
        })

    return [pscustomobject]@{
        enabled = $true
        mode = [string]$Context.mode
        lifecycle_status = [string]$Context.lifecycle_status
        current_status = [string]$Context.current_status
        current_phase = [string]$Context.current_phase
        pulse_count = [int]$Context.pulse_count
        stall_score = [double]$Context.stall_score
        suspect_stall = [bool]$Context.suspect_stall
        hard_stall = [bool]$Context.hard_stall
        auto_diagnosis_triggered = [bool]$Context.auto_diagnosis_triggered
        user_brief_interval_sec = [int]$Context.user_brief_interval_sec
        debug_tick_interval_sec = [int]$Context.debug_tick_interval_sec
        soft_stall_silence_sec = [double]$Context.soft_stall_silence_sec
        hard_stall_silence_sec = [double]$Context.hard_stall_silence_sec
        max_no_state_change_sec = [double]$Context.max_no_state_change_sec
        recent_pulses = @($recentPulses)
    }
}

function Finalize-HeartbeatContext {
    param(
        [object]$Context,
        [string]$FinalPhase = "router.final",
        [bool]$Succeeded = $true,
        [string]$Note = "router completed"
    )

    if (-not $Context) { return $null }
    if (-not $Context.enabled) {
        if ($Succeeded) {
            $Context.lifecycle_status = "completed"
        } else {
            $Context.lifecycle_status = "failed"
        }
        return Get-HeartbeatStatus -Context $Context
    }

    $null = Add-HeartbeatPulse -Context $Context -Stage "heartbeat.finalize" -Phase $FinalPhase -Note $Note -ForceEmit

    if ($Succeeded) {
        $Context.lifecycle_status = "completed"
        if (-not $Context.hard_stall -and -not $Context.suspect_stall) {
            $Context.current_status = "completed"
            $Context.status_reason = "completed"
        }
    } else {
        $Context.lifecycle_status = "failed"
        $Context.current_status = "failed"
        $Context.status_reason = "failed"
    }

    return Get-HeartbeatStatus -Context $Context
}
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: 323kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 323kUpdated 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: 323kUpdated 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: 323kUpdated Claude CodeCodexVerifiedInstall