Skip to content

Latest commit

 

History

91 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HELPER

HELPER runtime topology — isometric code city of the repository: 36 modules, 2 916 tracked files as columns, real project-reference edges and animated flows

Open the interactive topology → — an isometric map of the whole HELPER codebase: every module (16 .NET projects, React UI, tests, scripts, docs, eval) as a block, every tracked file as a column (height = size, colour = type), the real ProjectReference graph between projects, and animated payload flows along the real chains (chat turn → API → runtime → knowledge, local retrieval, web research, ingest, eval harness). Click a module to drill down; click a file to see what it imports and what imports it (file-level graph from C# type references and TS imports); filter modules, edge kinds and file types; the findings panel explains each architecture check (dependency cycles, layer inversions, fan-in/out, size concentration) with its rule and evidence instead of a score. the same page inside a running HELPER instance overlays live metrics (requests, turn stages, retrieval, model pool, persistence). Naming policy (explicit chronology): before 2026-08-19 file names were hidden in the public build; since 2026-08-19 it carries real file names for code, tests, scripts, frontend and CI (structural transparency: structure is public, content is not; docs/eval stay anonymous), a third-party package manifest, a structural test→production map and an explicit "what this proves / does not prove" block — see docs/repository-scope.md.

Machine-readable export: the full structural snapshot is published as docs/topology/topology.json (~300 KB) with a provenance block — private-core commit SHA, generator version (topology-gen v6), generation timestamp, tracked-file count and the public-names scope — so the topology can be audited, diffed and re-visualised outside this page.

HELPER public repository is a curated showcase surface for the product, not the private engineering core.

What This Repository Is

This repository exists to provide a public-facing view of:

  • product positioning
  • architecture and use-case narratives
  • trust and contact documents
  • issue intake forms
  • links to sanitized proof surfaces

What This Repository Is Not

This repository intentionally does not contain the code-bearing core:

  • no source content: no src/, test/ or operator scripts/ code (their file names, sizes and dependency graphs ARE published on the topology page — structural transparency; see docs/repository-scope.md)
  • no eval corpora or live runtime artifacts
  • no internal analysis or engineering history (those file names stay anonymous on the topology page too)

Implementation, internal tooling, and engineering history remain outside the public default branch.

Public-Facing Pack

Start here:

Trust and contact:

Public Proof Surface

Sanitized public proof bundles are published separately from this showcase repository.

Current public proof repo:

  • https://github.com/rovsh44-glitch/helper-web-reliability-50-proof

This split is deliberate:

  • this repo is the product-facing showcase
  • the proof repo is the evidence-facing export
  • the private core repo remains the implementation source of truth

Honest Status

  • release baseline: PASS
  • parity claim: not proven
  • blind human evaluation: not complete
  • counted long-window parity: not complete

Public claims from this repository should stay within those limits unless a separately published proof bundle demonstrates more.

Repository Model

The intended topology is:

  1. private core repo for implementation
  2. public showcase repo for narrative and intake
  3. separate public proof repos for sanitized evidence bundles

This repository is only lane 2.

About

Local-first operator shell for research, planning, generation, and runtime-guided execution.

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Used by

Contributors