ctxtop 0.0.0-stage → 4.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.antigravity-plugin/plugin.json +36 -0
- package/.claude-plugin/plugin.json +18 -0
- package/CHECKSUMS.sha256 +166 -0
- package/LICENSE +27 -0
- package/README.md +350 -2
- package/SECURITY.md +22 -0
- package/agents/ah-flash-scout.md +25 -0
- package/assets/advanced_view_loaded_420px.png +0 -0
- package/assets/hero-demo.svg +188 -0
- package/assets/logo.svg +19 -0
- package/assets/simple_view_lean_420px.png +0 -0
- package/assets/simple_view_loaded_420px.png +0 -0
- package/assets/social-preview.svg +72 -0
- package/assets/zone_c_step3_shield_full.png +0 -0
- package/bin/ah-statusline.mjs +175 -0
- package/bin/cli.mjs +3 -0
- package/bin/ctxtop.mjs +1799 -0
- package/commands/cost-radar.md +11 -0
- package/commands/evolve.md +10 -0
- package/commands/handoff.md +10 -0
- package/commands/horizon.md +10 -0
- package/commands/inspect.md +10 -0
- package/commands/precheck.md +10 -0
- package/config/default_flightcheck.json +133 -0
- package/config/modelCatalog.json +785 -0
- package/config/platformQuirks.json +19 -0
- package/hooks/handlers/compact-lifecycle.mjs +577 -0
- package/hooks/handlers/config-change.mjs +402 -0
- package/hooks/handlers/hookIo.mjs +311 -0
- package/hooks/handlers/hookIpcClient.mjs +83 -0
- package/hooks/handlers/post-model-switch.mjs +111 -0
- package/hooks/handlers/post-tool-use.mjs +366 -0
- package/hooks/handlers/pre-model-switch.mjs +1048 -0
- package/hooks/handlers/pre-tool-use.mjs +632 -0
- package/hooks/handlers/stop-gate.mjs +526 -0
- package/hooks/handlers/user-prompt-submit.mjs +367 -0
- package/hooks/hooks.json +131 -0
- package/hooks/post_invocation.mjs +13 -0
- package/hooks/post_tool_use.mjs +25 -0
- package/hooks/pre_invocation.mjs +14 -0
- package/hooks/pre_tool_use.mjs +97 -0
- package/hooks/register.js +726 -0
- package/hooks/session_start.mjs +24 -0
- package/hooks/stop.mjs +23 -0
- package/hooks.json +56 -0
- package/package.json +110 -4
- package/packages/antigravity/package.json +14 -0
- package/packages/antigravity/src/index.mjs +1 -0
- package/packages/claude-code/package.json +14 -0
- package/packages/claude-code/src/index.mjs +2 -0
- package/packages/core/package.json +14 -0
- package/packages/core/src/index.mjs +1 -0
- package/packages/engine-node/package.json +14 -0
- package/packages/engine-node/src/index.mjs +1 -0
- package/packages/mcp/package.json +17 -0
- package/packages/mcp/src/server.mjs +396 -0
- package/packages/pro/LICENSE-COMMERCIAL.md +19 -0
- package/packages/pro/README-SIGNING.md +30 -0
- package/packages/pro/package.json +16 -0
- package/packages/pro/src/index.mjs +3 -0
- package/packages/pro/src/team_finops_pack.mjs +241 -0
- package/packages/pro/workers/polar_webhook_worker.mjs +215 -0
- package/plugin.json +36 -0
- package/rules/AGENTS.md +10 -0
- package/sidecars/horizon-daemon/ipcServer.mjs +24 -0
- package/sidecars/horizon-daemon/server.mjs +2038 -0
- package/sidecars/horizon-daemon/sidecar.json +19 -0
- package/skills/cost-radar/SKILL.md +21 -0
- package/skills/evolve/SKILL.md +21 -0
- package/skills/handoff/SKILL.md +50 -0
- package/skills/horizon/SKILL.md +17 -0
- package/skills/inspect/SKILL.md +18 -0
- package/skills/precheck/SKILL.md +44 -0
- package/src/adapters/antigravity/index.mjs +109 -0
- package/src/adapters/claude-code/index.mjs +194 -0
- package/src/cli/cost_radar.mjs +70 -0
- package/src/cli/doctor.mjs +351 -0
- package/src/cli/horizon_hud.mjs +888 -0
- package/src/cli/init.mjs +425 -0
- package/src/cli/postmortem.mjs +515 -0
- package/src/coach/cacheGravityRouter.mjs +12 -0
- package/src/config/modelCatalog.json +704 -0
- package/src/config/platformQuirks.json +19 -0
- package/src/core/action_queue.mjs +264 -0
- package/src/core/ag_bridge.mjs +346 -0
- package/src/core/atomic_io.mjs +124 -0
- package/src/core/baseline.mjs +607 -0
- package/src/core/blindspot_sensors.mjs +399 -0
- package/src/core/bucket_b_runtime.mjs +1200 -0
- package/src/core/classifier.mjs +1757 -0
- package/src/core/coach/circuit_breakers.mjs +650 -0
- package/src/core/coach/contradiction_auditor.mjs +239 -0
- package/src/core/coach/effort_advisor.mjs +143 -0
- package/src/core/coach/handoff_hydrator.mjs +483 -0
- package/src/core/coach/progressive_checkpointer.mjs +551 -0
- package/src/core/coach/prompt_decomposer_coach.mjs +141 -0
- package/src/core/coach/reflector_queue.mjs +505 -0
- package/src/core/coach/saved_quota_ledger.mjs +615 -0
- package/src/core/coach/subagent_ipi_sanitizer.mjs +200 -0
- package/src/core/coach/subagent_phantom_auditor.mjs +261 -0
- package/src/core/coach/task_quota_router.mjs +955 -0
- package/src/core/coach/turn_zero_gate.mjs +574 -0
- package/src/core/compaction_coach.mjs +1126 -0
- package/src/core/config.mjs +214 -0
- package/src/core/constants.mjs +1987 -0
- package/src/core/detectors_det01_to_16.mjs +1523 -0
- package/src/core/doc_indexer.mjs +338 -0
- package/src/core/episodic_memory.mjs +135 -0
- package/src/core/fts5_output_compressor.mjs +359 -0
- package/src/core/git_ledger.mjs +189 -0
- package/src/core/handoff_audit.mjs +558 -0
- package/src/core/history.mjs +221 -0
- package/src/core/hook_diagnostics.mjs +158 -0
- package/src/core/horizon_classifier.mjs +326 -0
- package/src/core/horizon_config.mjs +802 -0
- package/src/core/host_watchdog.mjs +200 -0
- package/src/core/layer5_hygiene.mjs +1084 -0
- package/src/core/log_resolver.mjs +231 -0
- package/src/core/mcp_auditor.mjs +138 -0
- package/src/core/micro_skills_store.mjs +91 -0
- package/src/core/offenders.mjs +161 -0
- package/src/core/parser.mjs +1997 -0
- package/src/core/path_canonicalizer.mjs +73 -0
- package/src/core/paths.mjs +311 -0
- package/src/core/prefix_cache_shield.mjs +386 -0
- package/src/core/pro_license.mjs +385 -0
- package/src/core/prompt_rubric.mjs +518 -0
- package/src/core/pruner.mjs +433 -0
- package/src/core/quota.mjs +1860 -0
- package/src/core/rsi_instinct_engine.mjs +1197 -0
- package/src/core/rsl_clash_auditor.mjs +423 -0
- package/src/core/rsl_distiller.mjs +372 -0
- package/src/core/rsl_ledger.mjs +969 -0
- package/src/core/rsl_triage.mjs +909 -0
- package/src/core/sanitizer.mjs +121 -0
- package/src/core/session_auditor.mjs +658 -0
- package/src/core/session_forensics.mjs +303 -0
- package/src/core/session_timeline.mjs +358 -0
- package/src/core/settings.mjs +99 -0
- package/src/core/shared/detectors.mjs +1342 -0
- package/src/core/shared/fnv1a64.mjs +85 -0
- package/src/core/shared/handoff_schema.mjs +123 -0
- package/src/core/shared/index.mjs +5 -0
- package/src/core/shared/ipi_sanitizer.mjs +165 -0
- package/src/core/shared/micro_skills.mjs +1 -0
- package/src/core/shared/plugin_validator.mjs +202 -0
- package/src/core/shared/prompt_hygiene_governor.mjs +1 -0
- package/src/core/shield_manager.mjs +1417 -0
- package/src/core/sidecar_store.mjs +302 -0
- package/src/core/sprint_metrics.mjs +366 -0
- package/src/core/sqlite_client.mjs +283 -0
- package/src/core/storage_doctor.mjs +358 -0
- package/src/core/subagents.mjs +609 -0
- package/src/core/swarm_topology.mjs +360 -0
- package/src/core/task_quota_router.mjs +1656 -0
- package/src/core/telemetry/cache_ttl_watchdog.mjs +284 -0
- package/src/core/telemetry/scope_lock_registry.mjs +578 -0
- package/src/core/telemetry/shadow_file_detector.mjs +291 -0
- package/src/core/telemetry/trajectory_watcher.mjs +259 -0
- package/src/core/timeline_svg.mjs +236 -0
- package/src/core/tool_surgeon.mjs +305 -0
- package/src/core/trajectory_stitcher.mjs +645 -0
- package/src/core/u_shaped_optimizer.mjs +789 -0
- package/src/core/wal_hygiene.mjs +233 -0
- package/src/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
- package/src/core-isomorphic/catalog/index.mjs +1 -0
- package/src/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
- package/src/core-isomorphic/coach/microSkills.mjs +1 -0
- package/src/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
- package/src/core-isomorphic/coach/repoCalibration.mjs +254 -0
- package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
- package/src/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
- package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +305 -0
- package/src/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
- package/src/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
- package/src/core-isomorphic/config/anthropicModelCatalog.json +606 -0
- package/src/core-isomorphic/config/catalogLoader.mjs +1268 -0
- package/src/core-isomorphic/config/horizonConfig.mjs +1055 -0
- package/src/core-isomorphic/control/callTree.mjs +338 -0
- package/src/core-isomorphic/control/coachLatches.mjs +126 -0
- package/src/core-isomorphic/control/controlStateMachine.mjs +205 -0
- package/src/core-isomorphic/control/index.mjs +49 -0
- package/src/core-isomorphic/control/swarmWorktree.mjs +109 -0
- package/src/core-isomorphic/control/toolSuspension.mjs +197 -0
- package/src/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
- package/src/core-isomorphic/diagnostics/index.mjs +9 -0
- package/src/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
- package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
- package/src/core-isomorphic/economics/billingBlocks.mjs +251 -0
- package/src/core-isomorphic/economics/cacheGravity.mjs +369 -0
- package/src/core-isomorphic/economics/cliffBreaker.mjs +256 -0
- package/src/core-isomorphic/economics/driftLatency.mjs +433 -0
- package/src/core-isomorphic/economics/dualTtl.mjs +198 -0
- package/src/core-isomorphic/economics/index.mjs +47 -0
- package/src/core-isomorphic/economics/retentionRadar.mjs +348 -0
- package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
- package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
- package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
- package/src/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
- package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
- package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
- package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
- package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
- package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
- package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
- package/src/core-isomorphic/index.js +27 -0
- package/src/core-isomorphic/telemetry/otelExporter.mjs +187 -0
- package/src/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
- package/src/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
- package/src/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
- package/src/core-isomorphic/telemetry/telemetryBridge.mjs +1156 -0
- package/src/core-isomorphic/ui/brailleSparkline.mjs +142 -0
- package/src/core-isomorphic/ui/costRadarSvg.mjs +276 -0
- package/src/core-isomorphic/ui/horizonGrid.mjs +475 -0
- package/src/core-isomorphic/ui/horizonPanelHtml.mjs +1237 -0
- package/src/core-isomorphic/ui/modViews.mjs +1504 -0
- package/src/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
- package/src/core-isomorphic/ustf/index.mjs +7 -0
- package/src/core-isomorphic/ustf/normalizer.mjs +512 -0
- package/src/core-isomorphic/ustf/schema.mjs +186 -0
- package/src/core-isomorphic/utils/runtime.mjs +962 -0
- package/src/demo/synthetic_states.mjs +661 -0
- package/src/diagnostics/bugReportGenerator.mjs +253 -0
- package/src/diagnostics/claudeHookCapabilities.mjs +396 -0
- package/src/diagnostics/doctorEngine.mjs +295 -0
- package/src/engine-node/db/index.mjs +58 -0
- package/src/engine-node/db/jsonl_fallback.mjs +184 -0
- package/src/engine-node/db/probe.mjs +342 -0
- package/src/engine-node/db/sqlite_wrapper.mjs +122 -0
- package/src/engine-node/index.mjs +12 -0
- package/src/engine-node/ipc/client.mjs +447 -0
- package/src/engine-node/ipc/index.mjs +22 -0
- package/src/engine-node/ipc/protocol.mjs +177 -0
- package/src/engine-node/ipc/server.mjs +445 -0
- package/src/engine-node/offloader/index.mjs +6 -0
- package/src/engine-node/offloader/tool_offloader.mjs +241 -0
- package/src/engine-node/sensors/blindspots.mjs +376 -0
- package/src/engine-node/sensors/git_merge_tree.mjs +223 -0
- package/src/engine-node/sensors/index.mjs +7 -0
- package/src/hooks/antigravity_rsl_hook.mjs +250 -0
- package/src/hooks/claude_rsl_hook.mjs +288 -0
- package/src/hooks/portfolio_runtime.mjs +858 -0
- package/src/hooks/post_invocation.mjs +611 -0
- package/src/hooks/pre_invocation.mjs +1725 -0
- package/src/hooks/session_start.mjs +199 -0
- package/src/shims/agy_cli_compressor.mjs +705 -0
- package/src/shims/agy_git_guard.mjs +749 -0
- package/src/shims/ah_log_query.mjs +39 -0
- package/src/ui/costRadarSvg.mjs +6 -0
- package/src/ui/horizonGrid.mjs +1 -0
- package/src/ui/horizonPanelHtml.mjs +1 -0
- package/src/ui/horizon_panel.css +167 -0
- package/src/ui/horizon_panel.js +212 -0
- package/src/ui/modViews.mjs +1 -0
- package/src/utils/modelSwitchTelemetry.mjs +308 -0
- package/src/utils/nodeIo.mjs +59 -0
- package/src/utils/runtime.mjs +1 -0
- package/src/utils/sessionCalibration.mjs +657 -0
- package/src/webview/advanced_view.html +1808 -0
- package/src/webview/horizon_panel.html +12397 -0
- package/src/webview/registry.mjs +80 -0
- package/src/webview/simple_view.html +1370 -0
|
@@ -0,0 +1,351 @@
|
|
|
1
|
+
import fs from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import os from 'node:os';
|
|
4
|
+
import { fileURLToPath } from 'node:url';
|
|
5
|
+
import { loadFlightcheckConfig, getUserConfigPath } from '../core/config.mjs';
|
|
6
|
+
import { getDaemonPortFile, readDaemonPort, ensureSupportedNodeVersion, isSupportedNodeVersion } from '../core/paths.mjs';
|
|
7
|
+
import { resolveModelCeilingDetailed, resolvePricePerM } from '../core/constants.mjs';
|
|
8
|
+
import { getFlightcheckDir, SIDECAR_VERSION } from '../core/sidecar_store.mjs';
|
|
9
|
+
import { syncAndVerifyMirrors } from '../../scripts/sync_mirrors.mjs';
|
|
10
|
+
import { findSessionDirectory, parseTranscriptIncremental, parseRawJsonl } from '../core/parser.mjs';
|
|
11
|
+
import { executeToolOutputSurgery } from '../core/tool_surgeon.mjs';
|
|
12
|
+
import { compactCursorVscdbStreaming, recoverAntigravityBrainMigration } from '../core/storage_doctor.mjs';
|
|
13
|
+
import { reapOrphanProcesses } from '../core/host_watchdog.mjs';
|
|
14
|
+
import { generateHandoffMarkdown } from '../core/handoff_audit.mjs';
|
|
15
|
+
import {
|
|
16
|
+
loadHorizonConfig,
|
|
17
|
+
generateAntigravityDiagnosticMarkdown
|
|
18
|
+
} from '../core/horizon_config.mjs';
|
|
19
|
+
import { getHookDiagnosticSummary } from '../core/hook_diagnostics.mjs';
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* Parses CLI flags (`--prune-tools`, `--reap-orphans`, `--handoff`, `--storage-gc`, `--gc-cursor`, `--recover-brain`, `--diagnostic`, `--transcript <path>`, `--vscdb <path>`, `--dry-run`)
|
|
23
|
+
*/
|
|
24
|
+
export function parseDoctorArgs(argv = process.argv.slice(2)) {
|
|
25
|
+
const pruneTools = argv.includes('--prune-tools') || argv.includes('--prune') || argv.includes('prune');
|
|
26
|
+
const uncachedTail = argv.includes('--uncached-tail') || argv.includes('--tail');
|
|
27
|
+
const reapOrphans = argv.includes('--reap-orphans');
|
|
28
|
+
const handoff = argv.includes('--handoff') || argv.includes('--distill');
|
|
29
|
+
const gcCursor = argv.includes('--gc-cursor');
|
|
30
|
+
const recoverBrain = argv.includes('--recover-brain');
|
|
31
|
+
const storageGc = argv.includes('--storage-gc') || gcCursor || recoverBrain;
|
|
32
|
+
const diagnostic = argv.includes('--diagnostic') || argv.includes('--bug-report');
|
|
33
|
+
const dryRun = argv.includes('--dry-run');
|
|
34
|
+
const tIdx = argv.indexOf('--transcript');
|
|
35
|
+
const transcriptPath = tIdx !== -1 && argv[tIdx + 1] ? argv[tIdx + 1] : null;
|
|
36
|
+
const vIdx = argv.indexOf('--vscdb');
|
|
37
|
+
const vscdbPath = vIdx !== -1 && argv[vIdx + 1] ? argv[vIdx + 1] : null;
|
|
38
|
+
return { pruneTools, uncachedTail, reapOrphans, handoff, storageGc, gcCursor, recoverBrain, diagnostic, dryRun, transcriptPath, vscdbPath };
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Runs a comprehensive diagnosis of the Highbeam (`attention-horizon-antigravity`) environment.
|
|
43
|
+
*/
|
|
44
|
+
export async function runDoctor({ workspacePath = process.cwd(), pruneTools = false, uncachedTail = false, reapOrphans = false, handoff = false, storageGc = false, gcCursor = false, recoverBrain = false, diagnostic = false, dryRun = false, transcriptPath = null, vscdbPath = null, silent = false } = {}) {
|
|
45
|
+
const home = process.env.USERPROFILE || process.env.HOME || os.homedir();
|
|
46
|
+
if (reapOrphans) {
|
|
47
|
+
const res = await reapOrphanProcesses();
|
|
48
|
+
if (!silent) {
|
|
49
|
+
console.log(` ✔ PASS Orphan Watchdog Reaped ${res.reapedCount} orphan process(es)`);
|
|
50
|
+
}
|
|
51
|
+
return { ok: true, ...res };
|
|
52
|
+
}
|
|
53
|
+
if (handoff) {
|
|
54
|
+
const res = generateHandoffMarkdown({}, { workspacePath });
|
|
55
|
+
if (!silent) {
|
|
56
|
+
console.log(` ✔ PASS Handoff Distillation Generated handoff document at ${res.relativePath}`);
|
|
57
|
+
}
|
|
58
|
+
return { ok: true, ...res };
|
|
59
|
+
}
|
|
60
|
+
if (pruneTools || uncachedTail) {
|
|
61
|
+
let resolvedTranscript = transcriptPath;
|
|
62
|
+
if (!resolvedTranscript) {
|
|
63
|
+
const sessionInfo = findSessionDirectory(null, home);
|
|
64
|
+
if (sessionInfo && sessionInfo.sessionDir) {
|
|
65
|
+
const candidateFull = path.join(sessionInfo.sessionDir, '.system_generated', 'logs', 'transcript_full.jsonl');
|
|
66
|
+
const candidateCompact = path.join(sessionInfo.sessionDir, '.system_generated', 'logs', 'transcript.jsonl');
|
|
67
|
+
if (fs.existsSync(candidateFull)) resolvedTranscript = candidateFull;
|
|
68
|
+
else if (fs.existsSync(candidateCompact)) resolvedTranscript = candidateCompact;
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
if (!resolvedTranscript || !fs.existsSync(resolvedTranscript)) {
|
|
72
|
+
if (!silent) console.log(' ✖ FAIL Tool-Output Surgeon No active session transcript found to prune');
|
|
73
|
+
return { ok: false, success: false, error: 'No active session transcript found to prune' };
|
|
74
|
+
}
|
|
75
|
+
const res = executeToolOutputSurgery(resolvedTranscript, { dryRun, uncachedTail: uncachedTail || pruneTools });
|
|
76
|
+
if (!silent) {
|
|
77
|
+
const tag = (uncachedTail || pruneTools) ? 'Uncached Tail Surgeon' : 'Tool-Output Surgeon';
|
|
78
|
+
console.log(` ✔ PASS ${tag.padEnd(30)} Pruned ${res.prunedCount} stale tool output(s), saved ~${res.savedTokens} tokens${dryRun ? ' (dry-run)' : ''}`);
|
|
79
|
+
}
|
|
80
|
+
return { ok: Boolean(res.success), ...res };
|
|
81
|
+
}
|
|
82
|
+
if (storageGc || gcCursor || recoverBrain) {
|
|
83
|
+
const migration = (!gcCursor || recoverBrain || storageGc) ? recoverAntigravityBrainMigration(home, { dryRun }) : null;
|
|
84
|
+
const vscdbRes = vscdbPath ? await compactCursorVscdbStreaming(vscdbPath, { dryRun }) : null;
|
|
85
|
+
if (!silent) {
|
|
86
|
+
if (migration) {
|
|
87
|
+
console.log(` ✔ PASS Antigravity Brain Recovery Scanned ${migration.scannedDbCount} DBs, relinked ${migration.orphanedBrainCount} orphaned brain dir(s)${dryRun ? ' (dry-run)' : ''}`);
|
|
88
|
+
}
|
|
89
|
+
if (vscdbRes) {
|
|
90
|
+
console.log(` ✔ PASS Cursor state.vscdb GC Removed ${vscdbRes.removedOrphanRows} orphan rows, reclaimed ${vscdbRes.reclaimedBytes} bytes${dryRun ? ' (dry-run)' : ''}`);
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
return { ok: true, migration, vscdb: vscdbRes };
|
|
94
|
+
}
|
|
95
|
+
const results = [];
|
|
96
|
+
|
|
97
|
+
function record(title, status, detail = '') {
|
|
98
|
+
results.push({ title, status, detail });
|
|
99
|
+
if (silent || diagnostic) return;
|
|
100
|
+
const symbol = status === 'PASS' ? '\x1b[32m✔ PASS\x1b[0m' : (status === 'WARN' ? '\x1b[33m▲ WARN\x1b[0m' : '\x1b[31m✖ FAIL\x1b[0m');
|
|
101
|
+
console.log(` ${symbol} ${title.padEnd(35)} ${detail}`);
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
if (!silent && !diagnostic) {
|
|
105
|
+
console.log(`\n\x1b[1mHighbeam (ah-antigravity) System Doctor v${SIDECAR_VERSION}\x1b[0m`);
|
|
106
|
+
console.log('='.repeat(70));
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
// 0. Node.js Runtime & Daemon Port Discovery
|
|
110
|
+
if (isSupportedNodeVersion()) {
|
|
111
|
+
const sqliteDetail =
|
|
112
|
+
typeof process !== 'undefined' && process.env?.CTXTOP_FORCE_NO_SQLITE === '1'
|
|
113
|
+
? `${process.version} (Node >= 20.0.0 LTS JSONL fallback active)`
|
|
114
|
+
: `${process.version} (>= v22.5.0 built-in node:sqlite ready)`;
|
|
115
|
+
record('Node.js Runtime', 'PASS', sqliteDetail);
|
|
116
|
+
} else {
|
|
117
|
+
record('Node.js Runtime', 'FAIL', `${process.version} — Upgrade to Node >= 20.0.0 LTS required`);
|
|
118
|
+
}
|
|
119
|
+
const portFile = getDaemonPortFile(home);
|
|
120
|
+
const resolvedPort = readDaemonPort(home, 62935);
|
|
121
|
+
const hasPortLock = fs.existsSync(portFile);
|
|
122
|
+
record(
|
|
123
|
+
'Daemon Port Discovery',
|
|
124
|
+
'PASS',
|
|
125
|
+
hasPortLock
|
|
126
|
+
? `Active lockfile at ~/.ctxtop/daemon.port -> 127.0.0.1:${resolvedPort}`
|
|
127
|
+
: `Default loopback port 127.0.0.1:${resolvedPort} (start UI with: npx ctxtop ui)`
|
|
128
|
+
);
|
|
129
|
+
|
|
130
|
+
// 1. Hooks Registration Check
|
|
131
|
+
const hooksCandidates = [
|
|
132
|
+
path.join(home, '.gemini', 'config', 'hooks.json'),
|
|
133
|
+
path.join(home, '.gemini', 'config', 'plugins', 'agy-horizon-flightcheck', 'hooks.json'),
|
|
134
|
+
path.join(home, '.gemini', 'config', 'plugins', 'agy-horizon', 'hooks.json'),
|
|
135
|
+
path.join(workspacePath, '.agents', 'hooks.json'),
|
|
136
|
+
path.join(workspacePath, '.gemini', 'config', 'hooks.json'),
|
|
137
|
+
path.join(workspacePath, 'hooks.json')
|
|
138
|
+
];
|
|
139
|
+
let hooksFound = false;
|
|
140
|
+
for (const hPath of hooksCandidates) {
|
|
141
|
+
if (fs.existsSync(hPath)) {
|
|
142
|
+
try {
|
|
143
|
+
const parsed = JSON.parse(fs.readFileSync(hPath, 'utf8'));
|
|
144
|
+
const rootObj = parsed['horizon-flightcheck-lifecycle'] || parsed.hooks || parsed;
|
|
145
|
+
const pre = Boolean(rootObj.PreInvocation || rootObj.pre_invocation || parsed.PreToolUse);
|
|
146
|
+
const post = Boolean(rootObj.PostInvocation || rootObj.post_invocation);
|
|
147
|
+
const start = Boolean(rootObj.SessionStart || rootObj.session_start);
|
|
148
|
+
if (pre || post || start) {
|
|
149
|
+
hooksFound = true;
|
|
150
|
+
const relLabel = hPath.startsWith(workspacePath)
|
|
151
|
+
? path.relative(workspacePath, hPath).replace(/\\/g, '/') || 'hooks.json'
|
|
152
|
+
: hPath.replace(home, '~').replace(/\\/g, '/');
|
|
153
|
+
record('Antigravity Hooks', 'PASS', `Active at ${relLabel} (Pre:${pre ? '✔' : '✖'}, Post:${post ? '✔' : '✖'}, Start:${start ? '✔' : '✖'})`);
|
|
154
|
+
break;
|
|
155
|
+
}
|
|
156
|
+
} catch (err) {
|
|
157
|
+
const relLabel = hPath.startsWith(workspacePath)
|
|
158
|
+
? path.relative(workspacePath, hPath).replace(/\\/g, '/') || 'hooks.json'
|
|
159
|
+
: hPath.replace(home, '~').replace(/\\/g, '/');
|
|
160
|
+
record('Antigravity Hooks', 'WARN', `Malformed JSON in ${relLabel}: ${err.message}`);
|
|
161
|
+
}
|
|
162
|
+
}
|
|
163
|
+
}
|
|
164
|
+
if (!hooksFound) {
|
|
165
|
+
record('Antigravity Hooks', 'WARN', 'No hooks.json registering PreInvocation found in ~/.gemini/config or workspace');
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
// 1b. Plugin Mirror & Canonical Integrity Check
|
|
169
|
+
const agyHorizonDir = path.join(home, '.gemini', 'config', 'plugins', 'agy-horizon');
|
|
170
|
+
const flightcheckDir = path.join(home, '.gemini', 'config', 'plugins', 'agy-horizon-flightcheck');
|
|
171
|
+
if (fs.existsSync(agyHorizonDir) && fs.existsSync(flightcheckDir)) {
|
|
172
|
+
let mirrorsInSync = false;
|
|
173
|
+
try {
|
|
174
|
+
const mCheck = syncAndVerifyMirrors({ verifyOnly: true });
|
|
175
|
+
mirrorsInSync = Boolean(mCheck && mCheck.parityOk);
|
|
176
|
+
} catch (_err) {
|
|
177
|
+
mirrorsInSync = false;
|
|
178
|
+
}
|
|
179
|
+
if (mirrorsInSync) {
|
|
180
|
+
record('Plugin Canonical Integrity', 'PASS', 'Canonical & mirror plugin directories synced (SHA-256 parity verified)');
|
|
181
|
+
} else {
|
|
182
|
+
record('Plugin Canonical Integrity', 'WARN', 'Out-of-sync plugin mirrors detected (~/agy-horizon & ~/agy-horizon-flightcheck). Run `node scripts/sync_mirrors.mjs` or `npx ctxtop init --dedupe`.');
|
|
183
|
+
}
|
|
184
|
+
} else if (fs.existsSync(flightcheckDir)) {
|
|
185
|
+
record('Plugin Canonical Integrity', 'PASS', 'Canonical plugin directory active (~/.gemini/config/plugins/agy-horizon-flightcheck)');
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
// 2. Flight Check Configuration & Per-Detector Overlay (.attention-horizon.json)
|
|
189
|
+
const userCfgPath = getUserConfigPath();
|
|
190
|
+
const config = loadFlightcheckConfig();
|
|
191
|
+
const horizonCfg = loadHorizonConfig({ workspacePath, homeDir: home });
|
|
192
|
+
const customDetCount = Object.values(horizonCfg.detectors || {}).filter(m => m !== 'default').length;
|
|
193
|
+
if (fs.existsSync(userCfgPath)) {
|
|
194
|
+
try {
|
|
195
|
+
JSON.parse(fs.readFileSync(userCfgPath, 'utf8'));
|
|
196
|
+
record('Configuration Overlay', 'PASS', `Valid overlay at ~/.gemini/flightcheck/config.json (hook_level: ${config.hook_level}, detector overrides: ${customDetCount})`);
|
|
197
|
+
} catch (err) {
|
|
198
|
+
record('Configuration Overlay', 'FAIL', `Corrupt JSON in ~/.gemini/flightcheck/config.json: ${err.message}`);
|
|
199
|
+
}
|
|
200
|
+
} else {
|
|
201
|
+
record('Configuration Overlay', 'PASS', `Using bundled defaults (hook_level: ${config.hook_level}, halt_cooldown: ${config.halt_cooldown_turns}t, detector overrides: ${customDetCount})`);
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
// 3. Model Ceiling & Pricing Resolution
|
|
205
|
+
const testModels = ['gemini-3.8-flash', 'gemini-4-argon', 'gemini-4-carbon', 'claude-opus-5.5', 'custom-enterprise-model'];
|
|
206
|
+
let fallbackSeen = false;
|
|
207
|
+
for (const m of testModels) {
|
|
208
|
+
const details = resolveModelCeilingDetailed(m, null, { config });
|
|
209
|
+
resolvePricePerM(m, config);
|
|
210
|
+
if (m === 'custom-enterprise-model' && details.source === 'fallback') {
|
|
211
|
+
fallbackSeen = true;
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
if (fallbackSeen) {
|
|
215
|
+
record('Model Registry', 'PASS', `Dynamic family inheritance active; unmapped models resolve safely to fallback ceiling (${config.model_ceilings?.default || 256000} tokens)`);
|
|
216
|
+
} else {
|
|
217
|
+
record('Model Registry', 'PASS', 'Model registry and pricing table operational');
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
// 4. Sidecar Store Directory
|
|
221
|
+
const fcDir = getFlightcheckDir();
|
|
222
|
+
const sessionsDir = path.join(fcDir, 'sessions');
|
|
223
|
+
try {
|
|
224
|
+
if (!fs.existsSync(sessionsDir)) fs.mkdirSync(sessionsDir, { recursive: true });
|
|
225
|
+
const testFile = path.join(sessionsDir, `.doctor_write_${Date.now()}.tmp`);
|
|
226
|
+
fs.writeFileSync(testFile, 'ok', 'utf8');
|
|
227
|
+
fs.unlinkSync(testFile);
|
|
228
|
+
record('Sidecar Store Storage', 'PASS', `Writable directory at ${sessionsDir}`);
|
|
229
|
+
} catch (err) {
|
|
230
|
+
record('Sidecar Store Storage', 'FAIL', `Cannot write to ${sessionsDir}: ${err.message}`);
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
// 5. 3-Way Mirror Parity Check
|
|
234
|
+
try {
|
|
235
|
+
const mirrorCheck = syncAndVerifyMirrors({ verifyOnly: true });
|
|
236
|
+
if (mirrorCheck.parityOk) {
|
|
237
|
+
record('3-Way WebView Parity', 'PASS', `SHA-256 byte-for-byte match (${mirrorCheck.sha256.slice(0, 12)}...) across ${mirrorCheck.targets} targets`);
|
|
238
|
+
} else {
|
|
239
|
+
record('3-Way WebView Parity', 'FAIL', 'HTML or core module mismatch across local plugin mirrors');
|
|
240
|
+
}
|
|
241
|
+
} catch (err) {
|
|
242
|
+
record('3-Way WebView Parity', 'WARN', `Parity verify skipped or partial: ${err.message}`);
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
// 6. Transcript Parser Confidence
|
|
246
|
+
try {
|
|
247
|
+
const sessionInfo = findSessionDirectory(null, home);
|
|
248
|
+
if (sessionInfo && sessionInfo.sessionDir && fs.existsSync(sessionInfo.sessionDir)) {
|
|
249
|
+
const inc = parseTranscriptIncremental(sessionInfo.sessionDir, null);
|
|
250
|
+
if (inc && inc.filePath && fs.existsSync(inc.filePath)) {
|
|
251
|
+
if (inc.filePath.endsWith('.vscdb')) {
|
|
252
|
+
record(
|
|
253
|
+
'Transcript Health',
|
|
254
|
+
'PASS',
|
|
255
|
+
`Session ${sessionInfo.sessionId.slice(0, 8)} (${sessionInfo.surfaceTag || '[Cursor]'}) — Read-only SQLite state.vscdb (${(inc.steps || []).length} steps)`
|
|
256
|
+
);
|
|
257
|
+
} else {
|
|
258
|
+
const rawContent = fs.readFileSync(inc.filePath, 'utf8');
|
|
259
|
+
const parsed = parseRawJsonl(rawContent, { withHealth: true });
|
|
260
|
+
const health = parsed.health;
|
|
261
|
+
const status = health.confidence === 'HIGH' ? 'PASS' : (health.confidence === 'DEGRADED' ? 'WARN' : 'FAIL');
|
|
262
|
+
record(
|
|
263
|
+
'Transcript Health',
|
|
264
|
+
status,
|
|
265
|
+
`Session ${sessionInfo.sessionId.slice(0, 8)} (${sessionInfo.surfaceTag || '[App]'}) — Confidence: ${health.confidence} (${health.parsedLines}/${health.totalLines} lines, ${health.malformedLines} malformed)`
|
|
266
|
+
);
|
|
267
|
+
}
|
|
268
|
+
} else {
|
|
269
|
+
record('Transcript Health', 'PASS', `Session ${sessionInfo.sessionId.slice(0, 8)} located; waiting for first JSONL turn`);
|
|
270
|
+
}
|
|
271
|
+
} else {
|
|
272
|
+
record('Transcript Health', 'PASS', 'No active conversation folder currently open (idle)');
|
|
273
|
+
}
|
|
274
|
+
} catch (err) {
|
|
275
|
+
record('Transcript Health', 'WARN', `Log check error: ${err.message}`);
|
|
276
|
+
}
|
|
277
|
+
|
|
278
|
+
// 7. Hook & Shim Structured Diagnostics Ledger (~/.attention-horizon/diagnostics/ga_hook_diagnostics.jsonl)
|
|
279
|
+
const hookDiagnostics = getHookDiagnosticSummary({ homeDir: home });
|
|
280
|
+
if (hookDiagnostics.totalCount === 0) {
|
|
281
|
+
record('Hook & Shim Diagnostics', 'PASS', '0 recent hook/shim diagnostic errors recorded');
|
|
282
|
+
} else {
|
|
283
|
+
const latestTag = hookDiagnostics.latestSource && hookDiagnostics.latestOperation
|
|
284
|
+
? ` (latest: ${hookDiagnostics.latestSource}:${hookDiagnostics.latestOperation})`
|
|
285
|
+
: '';
|
|
286
|
+
record(
|
|
287
|
+
'Hook & Shim Diagnostics',
|
|
288
|
+
'WARN',
|
|
289
|
+
`${hookDiagnostics.totalCount} recent diagnostic event(s) in ~/.attention-horizon/diagnostics/ga_hook_diagnostics.jsonl${latestTag}`
|
|
290
|
+
);
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
const failCount = results.filter(r => r.status === 'FAIL').length;
|
|
294
|
+
const warnCount = results.filter(r => r.status === 'WARN').length;
|
|
295
|
+
|
|
296
|
+
if (diagnostic) {
|
|
297
|
+
const diagBundle = generateAntigravityDiagnosticMarkdown(results, {
|
|
298
|
+
workspacePath,
|
|
299
|
+
homeDir: home
|
|
300
|
+
});
|
|
301
|
+
if (!silent) {
|
|
302
|
+
console.log(diagBundle.markdown);
|
|
303
|
+
}
|
|
304
|
+
return {
|
|
305
|
+
ok: failCount === 0,
|
|
306
|
+
failCount,
|
|
307
|
+
warnCount,
|
|
308
|
+
hookDiagnostics,
|
|
309
|
+
diagnosticMarkdown: diagBundle.markdown,
|
|
310
|
+
diagnosticBundle: diagBundle
|
|
311
|
+
};
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
if (!silent) {
|
|
315
|
+
console.log('='.repeat(70));
|
|
316
|
+
}
|
|
317
|
+
if (failCount > 0) {
|
|
318
|
+
if (!silent) console.log(`\x1b[31mStatus: System issues detected (${failCount} failure${failCount > 1 ? 's' : ''}, ${warnCount} warning${warnCount > 1 ? 's' : ''}). Run recommendations above.\x1b[0m\n`);
|
|
319
|
+
return { ok: false, failCount, warnCount, hookDiagnostics, results };
|
|
320
|
+
} else if (warnCount > 0) {
|
|
321
|
+
if (!silent) console.log(`\x1b[33mStatus: Operational with ${warnCount} advisory warning${warnCount > 1 ? 's' : ''}.\x1b[0m\n`);
|
|
322
|
+
return { ok: true, failCount: 0, warnCount, hookDiagnostics, results };
|
|
323
|
+
} else {
|
|
324
|
+
if (!silent) console.log('\x1b[32mStatus: All checks PASSED. Highbeam system is fully healthy.\x1b[0m\n');
|
|
325
|
+
return { ok: true, failCount: 0, warnCount: 0, hookDiagnostics, results };
|
|
326
|
+
}
|
|
327
|
+
}
|
|
328
|
+
|
|
329
|
+
export function isDoctorMain(argv1 = process.argv[1], metaUrl = import.meta.url) {
|
|
330
|
+
if (!argv1) return false;
|
|
331
|
+
try {
|
|
332
|
+
return fs.realpathSync(argv1) === fs.realpathSync(fileURLToPath(metaUrl));
|
|
333
|
+
} catch (err) {
|
|
334
|
+
if (err?.code !== 'ENOENT') {
|
|
335
|
+
// Fallback to path.resolve when symlink target cannot be resolved
|
|
336
|
+
}
|
|
337
|
+
return path.resolve(argv1) === path.resolve(fileURLToPath(metaUrl));
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
|
|
341
|
+
const isMain = isDoctorMain();
|
|
342
|
+
if (isMain) {
|
|
343
|
+
ensureSupportedNodeVersion();
|
|
344
|
+
const cliOpts = parseDoctorArgs(process.argv.slice(2));
|
|
345
|
+
runDoctor(cliOpts).then(res => {
|
|
346
|
+
process.exit(res.ok === false ? 1 : 0);
|
|
347
|
+
}).catch(err => {
|
|
348
|
+
console.error('Doctor fatal error:', err);
|
|
349
|
+
process.exit(1);
|
|
350
|
+
});
|
|
351
|
+
}
|