Native source materials / 61 indexed
Native lessons and source materials
This index links to repository-authored course records, examples, tutorials, and technical reading. The separate browser lab is an educational surrogate; its sliders and checkpoints do not execute this repository's native engine.
Current audited native source: c0f26c3327c2c3088de56d1fd333872e18dc608d
Browser-lab provenance from the reconciled package: package source revision 130b8c9664f5349b77941a03903dde29bef6aa74. This is separate from the current native source revision above.
Source-defined reproduction commands
These exact one-line commands were observed in the audited repository workflow records and link to their source location. Expected setup, tool licensing, data, and environment vary by repository; the dashboard does not execute these commands or promise a completion time.
Source-defined validation command
npm run typecheck: tsc -p tsconfig.json --noEmitObserved in apps/web/package.json
Source-defined example command
npm run build: tsc -p tsconfig.json && node ../../scripts/build-web.mjsObserved in apps/web/package.json
Source-defined validation command
npm run test: node --test tests/*.test.mjsObserved in apps/web/package.json
Search the native catalog
61 materials
Question / topology
Architecture
The gate in the diagram describes permission, not a silent fallback: an explicit OpenAI request that fails configuration or consent checks returns an error. It is never relabelled as an actual AI success.
docs/ARCHITECTURE.md
Cloudflare browser edition
Public overview: <https://mkgrid.co.technology/>
docs/CLOUDFLARE.md
Completion UI implementation
apps/web/src/completion-ui.ts adds a DOM enhancement controller for the existing learning studio, study workbench and saved-run comparison. It exports:
docs/roadmap/COMPLETION_UI.md
Experiment index
docs/roadmap/INDEX.md
From useful release to a 5,000-star ambition
Stars are an external community outcome. There is no honest implementation that guarantees 5,000 stars, an award, adoption or product-market fit. Do not buy engagement, spam communities, fabricate customers or place a false achievement badge in the UI.
docs/OPEN_SOURCE_LAUNCH.md
Hybrid coverage matrix
36 curated architectures, not every physically possible hybrid. Screening and study-only capabilities are explicitly separated.
docs/HYBRID_COVERAGE.md
Optional OpenAI council
The numerical application and local checklist need no AI service. Actual multi-agent mode is optional, external and potentially billable. It has not been run against a live provider as part of this delivery.
docs/AI_SETUP.md
Equations / provenance
Averaged inverter control studies
This addition provides two executable research studies alongside the switching
docs/roadmap/CONTROL_MODELS.md
HelioForge Energy Lab: awesome-list research
Checked live GitHub metadata on 2026-09-30. Ten existing lists were investigated; this is a screening log, not ten claims of eligibility. No PR was submitted. Relevance and current contribution rules take priority over filling a quota.
docs/promotion/AWESOME_LIST_TARGETS.md
HelioForge Energy Lab: community teaching draft
Candidate communities: r/webdev for implementation discussion; r/opensource for source review; r/Python for numerical Python methods.
docs/promotion/REDDIT_LAUNCH.md
HelioForge Energy Lab: conditional launch calendar
T−7: complete current checks and source/rights review; inspect first-run demo.
docs/promotion/LAUNCH_CALENDAR.md
HelioForge Energy Lab: growth experiments
Stars are an aspiration, not a guaranteed outcome. No current metric is asserted here.
docs/promotion/GROWTH_EXPERIMENTS.md
HelioForge Energy Lab: LinkedIn drafts
Not posted.
docs/promotion/LINKEDIN_LAUNCH.md
HelioForge Energy Lab: newsletter and publisher pitch drafts
Promotion hold: Current readiness score 86/100 is below the 90/100 gate. These drafts remain unsent. Confirm public access, current editorial rules and project-specific fit before any submission.
docs/promotion/NEWSLETTER_OUTREACH.md
HelioForge Energy Lab: press kit
Name: HelioForge Energy Lab
docs/promotion/PRESS_KIT.md
HelioForge Energy Lab: shots
1440×1000 overview with demo label.
docs/demo/SHOT_LIST.md
HelioForge Energy Lab: Show HN draft
Selected title: Show HN: HelioForge Energy Lab — an inspectable local demo
docs/promotion/HACKER_NEWS_LAUNCH.md
HelioForge Energy Lab: technical thread draft
Not posted.
docs/promotion/X_LAUNCH.md
Hybrid electricity screen: numerical contract
Version: hybrid-greedy-hourly-v1 · catalogue 0.2.0 · synthetic educational data.
docs/HYBRID_METHODOLOGY.md
Internal readiness score: HelioForge Energy Lab
Assessed 2026-09-30 using the same seven weights for all 37 projects. This is an editorial QA prioritization rubric, not a calibrated metric, external rating or promise of adoption.
docs/CHAMPION_SCORE.md
Mapping the supplied reference archive
The supplied hybrid_power_systems_archive.zip contains a Markdown overview, PDF and two diagrams. Its Markdown describes five conceptual configurations. These were used to identify topology, assets and lesson goals; the new UI uses original software-3D geometry and does not embed the supplied diagrams. No third-party licence is inferred for those reference images.
docs/REFERENCE_MAPPING.md
Useful contribution quests for HelioForge Energy Lab
These are contribution proposals, not rewards for stars. Check existing issues before starting.
docs/CHAMPION_QUESTS.md
Reproduce / parameters
HelioForge Energy Lab: community outreach
Start with existing repository issues after public release. Discuss one concrete workflow with energy researchers and engineering educators. Use an existing authenticated account and follow the receiving community’s current rules. No Discord, Slack, research affiliation or domain partnership is invented.
docs/promotion/COMMUNITY_OUTREACH.md
Learning, comparison, pilot, and council study models
This page documents the twelve deterministic Python experiments in
docs/roadmap/WORKFLOW_MODELS.md
README CTA alternatives
If HelioForge Energy Lab helps you study this workflow, a star helps other energy researchers and engineering educators find it.
docs/promotion/README_CTA_OPTIONS.md
Reproducible synthetic examples
All inputs are illustrative, not a real customer tariff, project or forecast. Each *-default.json contains the complete API input contract for its named model. dashboard-snapshot.json is generated by the Python engines and feeds the standalone preview.
examples/README.md
Verification / output
45-second HelioForge Energy Lab demo
0–8s: Show the title and synthetic-data label. Explain: Interactive hybrid-energy research and learning workbench with auditable numerical screens and a local Python API.
docs/demo/DEMO_SCRIPT.md
Advanced physical studies
Status: executable bounded research screens with synthetic examples. The equations and software paths have internal hand-case and invariant tests. No model here has been calibrated against a real plant, cell, crop, sensor, mesh, or operator record.
docs/roadmap/PHYSICAL_MODELS.md
Advanced planning and calibration studies
These nine models are registered through the roadmap study contract. They run locally in Python, return finite JSON, and keep synthetic defaults separate from user-supplied data. A successful solver or a small residual is software evidence only; neither is proof of calibration, commercial readiness, survey accuracy, or legal compliance.
docs/roadmap/PLANNING_MODELS.md
Advanced study visuals
HF.advancedStudyVisual(def: StudyDefinition, result: StudyResult, slice: number): string | null supplies geometry-specific SVG for four roadmap study IDs: hybrid-powerflow, markets-network, pv-raytrace, and pilots-registration. It returns null for every other study so the established study renderer can continue to handle those views. The current renderers are static and use the result an…
docs/roadmap/ADVANCED_VISUALS.md
Change report — Champion 0.3.0
Base: the uploaded HelioForge-Hybrid-Lab-v0.2.0.zip. The original upload was not overwritten. SOURCE_CHANGES.patch is the reviewable source/test/configuration patch against the isolated local baseline; the full ZIP also includes generated browser assets and documentation. Apply a patch only to a separate matching baseline and rebuild the frontend. The complete packaged app does not need…
docs/champion/CHANGE_REPORT.md
Controlled release preparation — not a deployment
HelioForge Champion 0.3.0 is delivered for local evaluation. The full source, built frontend, starter scripts, verification records and file-hash manifest are included. The standard launcher uses this computer's loopback interface and disables external AI. No service was published, repository pushed, billable integration called or staged rollout started.
docs/champion/RELEASE_PLAN.md
Engineering experimental studies
These twelve studies are bounded, deterministic Python screens for the hybrid, storage, PV and research views. Their defaults are illustrative. The catalogue and per-study Pydantic inputs live in apps/api/helioforge/engines/engineering_studies.py; results contain finite JSON metrics, series, tables, details and warnings. The registry remains responsible for attaching model version, sourc…
docs/roadmap/ENGINEERING_MODELS.md
Experimental study contract
The roadmap adds separately named experimental studies without changing the capability declarations of the existing hybrid engine. All numerical calculations execute in tested Python. Public static pages show Python-generated example outputs; new calculations require the local API. No new runtime JavaScript dependencies.
docs/roadmap/CONTRACT.md
HelioForge Champion 0.3.0 — verification and handoff
Assessment date: 28 September 2026. Deliverable: implemented local-evaluation app, compiled interface, source, starter scripts and evidence. Production status: not deployed; production approval is blocked pending the checks and decisions below. “Champion” is an edition name, not an award or certification.
docs/champion/VERIFICATION.md
HelioForge Energy Lab: launch strategy
Audience: energy researchers and engineering educators. Positioning: Interactive hybrid-energy research and learning workbench with auditable numerical screens and a local Python API.
docs/promotion/LAUNCH_STRATEGY.md
Human acceptance script — pending
No human beta sessions or assistive-technology sessions were completed in this build. Have a real evaluator use the exact packaged candidate on the intended computer and browser. Record date, candidate manifest hash, browser/OS, task outcome, time if relevant, observed confusion, screenshots and reproducible defects. Use synthetic inputs only.
docs/champion/UAT.md
Interrupted invocation
The champion-browser-existing-2 wrapper was terminated by the container call timeout before a complete log was retained. It has no PASS result. It was superseded by instrumented, separately recorded invocations. A requested streaming exec session was unavailable; later longer jobs were collected to on-disk logs and their exit results inspected before handoff.
docs/champion/evidence/interrupted-attempt.md
Local evidence and connector setup
The static public preview displays bundled examples. Imports, new calculations and upstream/device connections run only through the local Python API. Settings below are environment variables; neither .env.example nor the development launcher automatically loads a private .env file. Keep the server on loopback. launch.py deliberately disables external AI; an operator enabling it must star…
docs/roadmap/CONNECTORS.md
Numerical methodology and model boundaries
Version 0.2.0 (retained research engines) · screening, not an investment recommendation. Parameters and outputs include units. The source code and regression tests are the executable specification; the following explains the calculation boundaries.
docs/METHODOLOGY.md
Primary sources and evidence status
The original source register is retained from the supplied repository; it is not an independent re-verification of every inherited source during this upgrade. Hybrid/control, Canvas, motion and agent-orchestration references below were checked for this extension on 23 September 2026. This is a developer source register, not substantive legal review or evidence that a particular customer…
docs/SOURCES.md
Roadmap completion and external evidence — 18 October 2026
The software implementation now covers all twelve views and 59 executable research studies. The original 39-study delivery is retained as historical evidence; twenty further studies, evidence connectors, prerequisite gates, comparison scenes and external council rounds close its implementation gaps. All numerical studies can run through the local Python API. The public static edition car…
docs/roadmap/COMPLETION.md
Roadmap: from research release to operational evidence platform
This document describes future work, not hidden shipped capabilities.
docs/ROADMAP.md
Validation record — 0.2.0
Date: 23 September 2026. These are observed checks in the build environment, not declarations that every deployment or scientific use is safe.
docs/VALIDATION.md
Verification — 18 October 2026
Software evidence for the 59-study release; see the completion ledger for all twelve views and external prerequisites. This does not establish scientific, regulatory, identity or accessibility certification.
docs/roadmap/VERIFICATION.md
Scope / limitations
Alternatives and adjacent tools: HelioForge Energy Lab
HelioForge connects a browsable energy-learning interface to an optional local Python calculation API. The standalone preview preserves a reproducible starting point; new numerical runs use the backend and its explicit scenario assumptions.
docs/ALTERNATIVES.md
Author a lesson or architecture
Edit apps/api/helioforge/data/hybrid_catalog.json. Each system has a stable ID, topology, coupling, control assumption, technology IDs, capability mode, preset inputs, learning focus, evidence requirements and source references. Each lesson references an existing system and applicable scenario; it supplies original objectives, steps, quiz options, one answer index per question and explan…
docs/LESSON_AUTHORING.md
Champion design and journey notes
Audience assumptions: researchers, teachers and engineering students exploring synthetic hybrid-energy configurations on a personal computer. These are inferred from the app's existing capabilities, not new stakeholder interviews. Primary success is an inspectable baseline/stress comparison with intact inputs and clear model boundaries. New human-user evidence has not been collected.
docs/champion/DESIGN_AND_JOURNEYS.md
Decision studies: model notes and limits
These twelve experiments are implemented in apps/api/helioforge/engines/decision_studies.py. They share the experimental-study contract in CONTRACT.md: each has a strict bounded Pydantic input, a catalogue entry with defaults and equations, and a result with metrics, series, table, details and warnings. Unknown inputs, fractional integer fields, non-finite values, oversized arrays and ou…
docs/roadmap/DECISION_MODELS.md
Full-spectrum implementation and audit — 17 October 2026
This release adds 39 independently named experiments across all 12 existing views. Numerical results come from Python, are saved through the local API, and include inputs, equations, source references, model limits and SHA-256 evidence digests. The browser includes reproducible examples for offline inspection and exports. Edited calculations require the local Python app. The original 19…
docs/roadmap/DELIVERY.md
Full-spectrum roadmap implementation
User scope confirmed 17 October 2026: implement the entire roadmap across all twelve views. The initial preservation sprint is included in this larger scope.
docs/roadmap/IMPLEMENTATION.md
HelioForge 0.2.0 — final build audit
Audited: 23 September 2026. Release scope: local-first hybrid-energy education and research. Verdict: deliverable as a tested research/learning release; not approved as a production multi-tenant service, engineering design tool, complete multi-carrier solver or accredited course.
docs/FINAL_AUDIT.md
HelioForge Energy Lab
Open the public browser preview · Purpose, usage and limits · Methodology · Build and deployment guide
README.md
HelioForge Energy Lab visual identity
Repository accent: #8bc4f8. Shared background: #0c1923; text: #f7fafc; secondary text: #c6d4dc. Keep the supplied application palette and functional status labels. Diagrams use labeled boxes and arrows, never color alone. Social assets identify the synthetic/demo scope; screenshots are actual rendered app states. Editable SVG sources accompany the PNG preview.
docs/repository/VISUAL_IDENTITY.md
HelioForge Energy Lab: data and rule boundaries
HelioForge connects a browsable energy-learning interface to an optional local Python calculation API. The standalone preview preserves a reproducible starting point; new numerical runs use the backend and its explicit scenario assumptions.
docs/architecture/system-overview.md
HelioForge Energy Lab: voiceover draft
Interactive hybrid-energy research and learning workbench with auditable numerical screens and a local Python API. The example runs locally. Start from the README, open a supplied record, and inspect what is known, what is synthetic, and what stays on the device. The source and tests let you inspect the rule behind the interface. This is a demonstration under documented limits. If this w…
docs/demo/VOICEOVER.md
Package checks
The packager excludes virtual environments, node_modules, Git internals, caches, runtime/test databases, real .env files and font binaries. It retains .env.example, compiled browser assets, source and audit evidence. No matching common private-key/API-token patterns were found in the scanned text files. This limited pattern check is not a comprehensive secret or vulnerability audit.
docs/champion/PACKAGE_CHECKS.md
Remaining roadmap implementation — 17 October 2026
User authorization: implement the remaining items in every view, identify real-data/credential/external-validation requirements, then merge, commit and publish. This supersedes the prior no-publication boundary. No claim of certification, field truth, signer identity or executed paid agents may be manufactured.
docs/roadmap/COMPLETION_PLAN.md
Separating a numerical model from its explanation
HelioForge connects a browsable energy-learning interface to an optional local Python calculation API. The standalone preview preserves a reproducible starting point; new numerical runs use the backend and its explicit scenario assumptions.
docs/engineering/CASE_STUDY.md
Separating a numerical model from its explanation
HelioForge connects a browsable energy-learning interface to an optional local Python calculation API. The standalone preview preserves a reproducible starting point; new numerical runs use the backend and its explicit scenario assumptions.
docs/promotion/DEVTO_ARTICLE.md
Three boundaries in HelioForge Energy Lab
HelioForge connects a browsable energy-learning interface to an optional local Python calculation API. The standalone preview preserves a reproducible starting point; new numerical runs use the backend and its explicit scenario assumptions.
docs/promotion/HASHNODE_ARTICLE.md