D-Zone

d-zone@histruct:~$ ./enter --if-you-dare

D-Zone is the HiStruct developer zone: living documentation for people and agents who want to build checked parametric engineering components instead of only talking about them.

It is the factory door behind the polished showroom. The official HiStruct website explains what the platform does for customers. D-Zone shows how the machinery is built, tested, broken, fixed, and eventually trusted.

Read the positioning note: Positioning

Start In One Screen

If you are new here, do this:

1. Read Start Here In 5 Minutes.
2. Open the tiny Golden Example: Vertex.
3. Then open the first memorable visual example: Snow White Dining, now with material layers.
4. If you still want to continue after that, congratulations. The door worked.

Start

• Start Here In 5 Minutes
• Examples
• HiStruct Code Quest
• FCS Essentials
• Platform Architecture
• FCC Component Structure
• Agent Knowledge Base
• Material Visualization
• Gist-Based Documentation

Acronym Strip

• FCS: FemCAD Script, the component logic language.
• PVC: Parameter Value Collection, the editable instance state.
• FCC: FemCAD Component folder.
• FLI: command-line interpreter for FCS.
• Booster: compute node that evaluates jobs.
• HiScene: JSON scene format for the viewer.
• Golem: future agent companion that opens examples and helps modify them.

Core Idea

HiStruct components combine two worlds:

• FCS: reusable component logic, geometry, formulas, reports, and outputs.
• PVC: per-instance values edited by users, APIs, or tools.

FCS is the template. PVC is the current state. Booster evaluates the result. HiScene feeds the viewer. Golem should make the examples alive.

Living Examples

Each useful example should eventually have:

1. a Markdown explanation,
2. the FCS source,
3. expected output or scene,
4. validation notes,
5. a link to open or continue the example in Golem,
6. a viewer link when the output is visual.

Current seed examples:

• Golden Example: Vertex
• Snow White Dining
• Arithmetic
• Vertex
• Portal Frame
• CSG Union / Intersect
• DXF Export

First Public Challenge

The proposed first challenge is a reinforced-concrete rectangular beam or lintel component: design reinforcement bars for a simple bent rectangular cross section, produce a clear report, and include a useful picture.

Read the draft: Rebar Lintel Challenge

Golem

Golem is the future companion for D-Zone examples. Static documentation explains the example. Golem lets a developer ask: "What if I change this?" and then tries it with FCS, FLI, and the viewer.

Read the integration note: Golem Links

Agents

Machine-readable entry points:

• llms.txt
• agent-index.json

Local Preview

For now, open this folder in VS Code and use Markdown preview on index.md. That is deliberately boring. Boring is fast, searchable, and hard to break.

See: Local Preview