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/research/vibe-adaptive-train.ps1

View on GitHub
param(
    [string]$TelemetryDirectory,
    [string]$OutputJsonPath,
    [string]$OutputMarkdownPath,
    [int]$LookbackDays = 7
)

$ErrorActionPreference = "Stop"

function Resolve-DefaultPaths {
    param(
        [string]$RepoRoot,
        [object]$ObservabilityPolicy
    )

    $telemetryRel = "outputs/telemetry"
    $jsonRel = "outputs/learn/vibe-adaptive-suggestions.json"
    $mdRel = "outputs/learn/vibe-adaptive-suggestions.md"

    if ($ObservabilityPolicy -and $ObservabilityPolicy.telemetry -and $ObservabilityPolicy.telemetry.output_dir) {
        $telemetryRel = [string]$ObservabilityPolicy.telemetry.output_dir
    }
    if ($ObservabilityPolicy -and $ObservabilityPolicy.learning -and $ObservabilityPolicy.learning.output_path) {
        $jsonRel = [string]$ObservabilityPolicy.learning.output_path
        if ($jsonRel.EndsWith(".json")) {
            $mdRel = $jsonRel.Substring(0, $jsonRel.Length - 5) + ".md"
        }
    }

    return [pscustomobject]@{
        telemetry = Join-Path $RepoRoot $telemetryRel
        json = Join-Path $RepoRoot $jsonRel
        markdown = Join-Path $RepoRoot $mdRel
    }
}

function Get-GroupStats {
    param(
        [object[]]$Events,
        [double]$MinTopGap
    )

    $groups = $Events | Group-Object -Property scenario_key
    $rows = @()
    foreach ($g in $groups) {
        $items = @($g.Group)
        $count = $items.Count
        if ($count -le 0) { continue }

        $legacy = ($items | Where-Object { $_.route.route_mode -eq "legacy_fallback" }).Count
        $confirm = ($items | Where-Object { $_.route.route_mode -eq "confirm_required" }).Count
        $lowGap = ($items | Where-Object { [double]$_.route.top1_top2_gap -lt $MinTopGap }).Count
        $confidenceValues = @(
            $items | ForEach-Object {
                if ($_.route -and $_.route.confidence -ne $null) {
                    [double]$_.route.confidence
                } else {
                    0.0
                }
            }
        )
        $gapValues = @(
            $items | ForEach-Object {
                if ($_.route -and $_.route.top1_top2_gap -ne $null) {
                    [double]$_.route.top1_top2_gap
                } else {
                    0.0
                }
            }
        )

        $avgConfidenceRaw = if ($confidenceValues.Count -gt 0) { ($confidenceValues | Measure-Object -Average).Average } else { 0.0 }
        $avgGapRaw = if ($gapValues.Count -gt 0) { ($gapValues | Measure-Object -Average).Average } else { 0.0 }
        $avgConfidence = [Math]::Round([double]$avgConfidenceRaw, 4)
        $avgGap = [Math]::Round([double]$avgGapRaw, 4)

        $rows += [pscustomobject]@{
            scenario_key = [string]$g.Name
            event_count = $count
            legacy_fallback_rate = [Math]::Round(($legacy / $count), 4)
            confirm_required_rate = [Math]::Round(($confirm / $count), 4)
            low_gap_rate = [Math]::Round(($lowGap / $count), 4)
            avg_confidence = $avgConfidence
            avg_top_gap = $avgGap
            environment_profile_id = [string]$items[0].environment_profile_id
            user_profile_id = [string]$items[0].user_profile_id
            task_type = [string]$items[0].route.task_type
        }
    }
    return $rows
}

function Build-Recommendations {
    param(
        [object[]]$GroupStats,
        [object]$Thresholds,
        [object]$ObservabilityPolicy
    )

    $current = $Thresholds.thresholds
    $minEvents = 200
    if ($ObservabilityPolicy -and $ObservabilityPolicy.learning -and $ObservabilityPolicy.learning.min_events_for_suggestion -ne $null) {
        $minEvents = [int]$ObservabilityPolicy.learning.min_events_for_suggestion
    }

    $maxDeltaConfirm = 0.03
    $maxDeltaGap = 0.03
    $maxDeltaFallback = 0.02
    if ($ObservabilityPolicy -and $ObservabilityPolicy.learning -and $ObservabilityPolicy.learning.bounded_adjustments) {
        $adj = $ObservabilityPolicy.learning.bounded_adjustments
        if ($adj.confirm_required_max_delta -ne $null) { $maxDeltaConfirm = [double]$adj.confirm_required_max_delta }
        if ($adj.min_top_gap_max_delta -ne $null) { $maxDeltaGap = [double]$adj.min_top_gap_max_delta }
        if ($adj.fallback_threshold_max_delta -ne $null) { $maxDeltaFallback = [double]$adj.fallback_threshold_max_delta }
    }

    $rec = @()
    foreach ($row in $GroupStats) {
        if ($row.event_count -lt $minEvents) { continue }

        if ($row.legacy_fallback_rate -ge 0.35 -and $row.avg_confidence -ge ([double]$current.fallback_to_legacy_below + 0.05)) {
            $delta = [Math]::Min($maxDeltaFallback, 0.02)
            $target = [Math]::Round(([double]$current.fallback_to_legacy_below - $delta), 4)
            $rec += [pscustomobject]@{
                scenario_key = $row.scenario_key
                reason = "high_legacy_fallback_with_confident_scores"
                parameter = "thresholds.fallback_to_legacy_below"
                current_value = [double]$current.fallback_to_legacy_below
                suggested_value = $target
                delta = -$delta
                apply_policy = "manual_review_required"
            }
        }

        if ($row.confirm_required_rate -ge 0.5 -and $row.avg_top_gap -ge ([double]$current.min_top1_top2_gap + 0.08)) {
            $delta = [Math]::Min($maxDeltaConfirm, 0.02)
            $target = [Math]::Round(([double]$current.confirm_required - $delta), 4)
            $rec += [pscustomobject]@{
                scenario_key = $row.scenario_key
                reason = "high_confirm_required_with_clear_top_gap"
                parameter = "thresholds.confirm_required"
                current_value = [double]$current.confirm_required
                suggested_value = $target
                delta = -$delta
                apply_policy = "manual_review_required"
            }
        }

        if ($row.low_gap_rate -ge 0.35) {
            $delta = [Math]::Min($maxDeltaGap, 0.01)
            $target = [Math]::Round(([double]$current.min_top1_top2_gap + $delta), 4)
            $rec += [pscustomobject]@{
                scenario_key = $row.scenario_key
                reason = "persistent_low_top1_top2_gap"
                parameter = "thresholds.min_top1_top2_gap"
                current_value = [double]$current.min_top1_top2_gap
                suggested_value = $target
                delta = $delta
                apply_policy = "manual_review_required"
            }
        }
    }

    return $rec
}

$repoRoot = Resolve-Path (Join-Path $PSScriptRoot "..\..")
$obsPolicyPath = Join-Path $repoRoot "config/observability-policy.json"
$routerThresholdPath = Join-Path $repoRoot "config/router-thresholds.json"
$obsPolicy = if (Test-Path -LiteralPath $obsPolicyPath) { Get-Content -LiteralPath $obsPolicyPath -Raw -Encoding UTF8 | ConvertFrom-Json } else { $null }
$thresholds = Get-Content -LiteralPath $routerThresholdPath -Raw -Encoding UTF8 | ConvertFrom-Json
$defaults = Resolve-DefaultPaths -RepoRoot $repoRoot -ObservabilityPolicy $obsPolicy

if (-not $TelemetryDirectory) { $TelemetryDirectory = $defaults.telemetry }
if (-not $OutputJsonPath) { $OutputJsonPath = $defaults.json }
if (-not $OutputMarkdownPath) { $OutputMarkdownPath = $defaults.markdown }

$cutoffDate = (Get-Date).AddDays(-1 * [Math]::Abs($LookbackDays))
$files = @()
if (Test-Path -LiteralPath $TelemetryDirectory) {
    $files = Get-ChildItem -LiteralPath $TelemetryDirectory -Filter "route-events-*.jsonl" -File | Where-Object { $_.LastWriteTime -ge $cutoffDate }
}

$events = @()
foreach ($file in $files) {
    $lines = Get-Content -LiteralPath $file.FullName -Encoding UTF8
    foreach ($line in $lines) {
        if ([string]::IsNullOrWhiteSpace($line)) { continue }
        try {
            $events += ($line | ConvertFrom-Json)
        } catch {
            continue
        }
    }
}

$groupStats = Get-GroupStats -Events $events -MinTopGap ([double]$thresholds.thresholds.min_top1_top2_gap)
$recommendations = Build-Recommendations -GroupStats $groupStats -Thresholds $thresholds -ObservabilityPolicy $obsPolicy

$summary = [pscustomobject]@{
    generated_at = (Get-Date).ToString("s")
    lookback_days = [int]$LookbackDays
    telemetry_directory = (Resolve-Path -LiteralPath $TelemetryDirectory -ErrorAction SilentlyContinue | ForEach-Object { $_.Path })
    files_scanned = @($files | Select-Object -ExpandProperty FullName)
    total_events = $events.Count
    scenarios = $groupStats.Count
    min_events_for_suggestion = if ($obsPolicy -and $obsPolicy.learning) { [int]$obsPolicy.learning.min_events_for_suggestion } else { 200 }
    apply_policy = if ($obsPolicy -and $obsPolicy.learning -and $obsPolicy.learning.apply_policy) { [string]$obsPolicy.learning.apply_policy } else { "manual_review_required" }
    recommendations = $recommendations
    scenario_stats = $groupStats
}

$jsonDir = Split-Path -Parent $OutputJsonPath
$mdDir = Split-Path -Parent $OutputMarkdownPath
New-Item -ItemType Directory -Path $jsonDir -Force | Out-Null
New-Item -ItemType Directory -Path $mdDir -Force | Out-Null

$summary | ConvertTo-Json -Depth 30 | Set-Content -LiteralPath $OutputJsonPath -Encoding UTF8

$lines = @()
$lines += "# VCO Adaptive Suggestions (Offline)"
$lines += ""
$lines += "- generated_at: ``$($summary.generated_at)``"
$lines += "- lookback_days: ``$($summary.lookback_days)``"
$lines += "- total_events: ``$($summary.total_events)``"
$lines += "- scenarios: ``$($summary.scenarios)``"
$lines += "- recommendation_count: ``$($recommendations.Count)``"
$lines += "- apply_policy: ``$($summary.apply_policy)``"
$lines += ""
$lines += "## Recommendations"
$lines += ""

if ($recommendations.Count -eq 0) {
    $lines += "- No threshold adjustments suggested for current telemetry window."
} else {
    foreach ($r in $recommendations) {
        $lines += "- scenario=``$($r.scenario_key)`` param=``$($r.parameter)`` current=``$($r.current_value)`` suggested=``$($r.suggested_value)`` reason=``$($r.reason)``"
    }
}

$lines -join "`n" | Set-Content -LiteralPath $OutputMarkdownPath -Encoding UTF8

[pscustomobject]@{
    ok = $true
    output_json = $OutputJsonPath
    output_markdown = $OutputMarkdownPath
    total_events = $events.Count
    recommendations = $recommendations.Count
} | 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: 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