CLI Entry, Build and Project Tooling

Generated

Built from the knowledge graph of commit db90516 (2026-09-23), produced by Understand-Anything. Structure (files, symbols, imports, calls) comes from tree-sitter; summaries are model-written. Regenerate with the steps in This site.

The thin Commander dispatcher (src/cli.ts) and public package entry, plus the package/tsconfig/bunfig/Vitest configuration, esbuild build, docs-sync and doc-link scripts, and deterministic smoke harnesses (fake OMP and Command Code probes) that exercise the built uh CLI.

Depends on: Mission Lifecycle and Artifact Store (15), Runtime Adapters and In-Runtime Extensions (13), Verification, Review and Promotion (12), Observability, Accounting and Reporting (9), Runtime Execution and Supervision (9), Artifact Schemas (4), Run Control and Team Coordination (3), Hermes Dashboard Plugin (1), Mission Control TUI (1)

Used by: none

(Numbers are distinct file-to-file dependencies.)

Files

File	Summary	Key symbols
.env.example	Safe placeholder environment template covering the OpenRouter adapter key, opt-in PostHog telemetry settings, and Hermes dashboard plugin variables (project root, CLI binary, timeouts and artifact size caps).
.gitattributes	Git attributes file forcing LF line endings for the acceptance-docs README so it renders identically across platforms.
bunfig.toml	Bun runtime configuration that preloads the @opentui/solid JSX transform so Solid TSX files for the TUI compile under Bun without affecting Node/Vitest paths.
package.json	npm package manifest for @agenticengineeringagency/ultimate-harness v0.11.0 exposing the uh bin from dist/cli.js, pinning Node 20+/Bun 1.3.14+, and defining dev, build, test, typecheck, docs, TUI spike and Hermes plugin scripts plus OpenTUI, Solid, Commander, YAML and Zod dependencies.
README.md	Project overview for Ultimate Harness describing the runtime-agnostic mission lifecycle, the ten runtime adapters and their status, run-control operations, documentation index, install and quick-start commands, runtime overrides, durable artifacts and the safety model.
scripts/build.mjs	Atomic build script that compiles TypeScript into dist.next and swaps it into dist only on success, cleaning or restoring leftovers from interrupted builds.	cleanLeftovers, main
scripts/check-doc-links.mjs	Dependency-free dead-link checker that scans markdown under docs/, resolves relative link targets on disk, and exits non-zero when any are missing.	listFiles, resolveMdxRoute
scripts/smoke/resource-wave/fake-omp.mjs	Deterministic stand-in for omp –print –mode json used by the resource-wave smoke test, emitting session, usage, and final-message events and writing an answer file.
scripts/smoke/resource-wave/run.mjs	Resource-wave smoke test that builds throwaway git projects, points the oh-my-pi adapter at a fake OMP fixture, and runs uh mission run-team through the built CLI to check cost-budget and memory-headroom admission across four scenarios.	setupProject
scripts/smoke/supervisor-loop/fake-command-code-probe.mjs	Fake Command Code runtime fixture that emits scripted JSON event streams (session, tool hook blocks, shell mutations, success) selected by FIXTURE_PROBE so the supervisor-loop smoke can exercise denial budgets and tamper handling without a real model.
scripts/smoke/supervisor-loop/fake-omp-probe.mjs	Fake oh-my-pi runtime fixture that replays scripted event streams per FIXTURE_PROBE (stalls, turn caps, repeated failures, deadline grace, tamper, launcher loss) to drive the runtime supervisor’s stop and recovery paths.
scripts/smoke/supervisor-loop/run.mjs	Supervisor-loop smoke runner that sets up one throwaway project per probe, runs missions through the built uh CLI against fake OMP and Command Code fixtures, and checks runtime-control stop codes, recovery resumes and final result status.	setup, overrides, launcherGone, runProbe
scripts/smoke/tool-guard/run.mjs	Tool-guard smoke that writes a temporary guard policy and drives the built Command Code PreToolUse hook and oh-my-pi extension to confirm git mutations and protected-path writes are denied while read-only commands pass.
scripts/smoke/worker-contract/run.mjs	Worker-contract smoke that initializes a project, rewires the oh-my-pi adapter to the fake OMP fixture, runs a two-worker team mission through the built CLI and checks per-worker routes and declared-output enforcement.
scripts/sync-docs-site.mjs	Build helper that converts docs/ROADMAP.md into the public docs site’s roadmap.mdx, rewriting repo-relative links to GitHub URLs and deriving the frontmatter date from the body’s ‘Last updated’ line.
src/cli.ts	Commander-based uh CLI dispatcher wiring every command (mission, run, verify, promote, team, queue, experiment, tui, etc.) to harness lifecycle modules and runtime adapter wirings.	enforceRuntimePreflight, evaluateSemanticRoute, sandboxRouteLine, resolveRuntimeConfigRole, installRuntimeCancelledEventHandler, runOperatorResumedAttempt, renderAlignedTable, verdictSentence, …
src/index.ts	Public library entry point that re-exports the init, status, validate, verify, promote, paths and registry harness modules.
tsconfig.json	TypeScript build configuration compiling strict ES2022 NodeNext sources from src/**/*.ts into dist.
tsconfig.tests.json	No-emit TypeScript configuration used by the typecheck script, covering src, tests and bin TS/TSX files with the @opentui/solid JSX import source.
vitest.config.ts	Vitest configuration running tests/**/*.test.ts with globals and a shared setup file, raising test and hook timeouts to 30 s because suites spawn real subprocesses.