Repository navigation
Releases
Hephaera 5.2.1
Hephaera 5.2.1
This security patch retains the building, mechanical-model and reusable VFX/action workflows introduced in 5.2.0. It updates Hephaera's local tooling and installer version; it does not change the pinned Bubo revision or install additional software.
Security fixes
- Update the documentation Markdown parser to
markdown-it15.0.3. - Serve local website previews and browser evidence through verified HTTPS. Preserve the admitted file inventory, private-path exclusions, request limits and cleanup rules. The local preview TLS guide explains the existing OpenSSL prerequisite and exact certificate or browser-pin setup.
- Match model factory identifiers literally with bounded validation, and tighten file and process admission at the native execution boundary.
- Separate media lifecycle ownership from generation request data. Bound journal enumeration and use abortable process deadlines while waiting for owned workers to retire before returning.
No Snyk ignore, severity filter or suppression was added. A fresh scoped Code scan of the reviewed Hephaera remediation candidate reported no High or Medium findings, and the checked npm dependency graphs reported no vulnerabilities. Low findings remain deferred. Hephaera Code reported three header parsing failures, and these scans do not cover every custom Python, model, tool or framework dependency. This is scoped verification, not a claim that all source and dependencies are vulnerability-free.
Installation and updates
Confirm that the exact release and both selected package versions are published before using these instructions. GitHub Packages remains the primary distribution:
- npm:
@timothymeadows/hephaera@5.2.1athttps://npm.pkg.github.com. - NuGet tool:
Hephaeraversion5.2.1athttps://nuget.pkg.github.com/TimothyMeadows/index.json.
Both feeds require GitHub authentication. The matching GitHub release provides hephaera-setup-5.2.1.zip, release-manifest-5.2.1.json and CHECKSUMS-5.2.1.txt. Follow the installation guide for setup and explicit managed updates. Acquiring newer installer tooling does not move an existing project's pinned baseline; review update --dry-run before updating and preserve .hephaera/.cache, approvals and recovery journals.
npmjs.com and NuGet.org publication remains deferred. The GitHub release workflow must select publish_public=false. Manual clone/submodule installation stays the advanced last option.
Compatibility and verification
The native dependency remains Bubo a47896d730b32d00b165e61820060e7c73d1ec4a (API 2), the same reviewed revision used by 5.2.0. The installed gitlink, lock and verified build must still agree. Separate experimental Low-remediation work is not included.
Verification covered parser and site/Wiki checks, verified TLS peers and real sandboxed browser imports, bounded model-name matching, media ownership and real child-process cancellation/retirement. Both clone and submodule installation forms were exercised. Local Windows evidence does not substitute for the release workflow's Linux, macOS and Windows artifact checks or actual target-device acceptance.
Existing STYLE/ENGINE selections, AUDIO/MUSIC/VOICE domains and human review/promotion boundaries remain intact. The patch grants no model installation, media generation, consent, asset promotion, gameplay authority or runtime acceptance. Previous tags, release files and package versions remain unchanged.
Documentation erratum
For local website previews, use the HTTPS endpoint and per-run trust instructions in the local preview TLS guide. The HTTP preview example in the older docs/DOCUMENTATION_SITE.md is stale; its text correction is recorded for later documentation cleanup.
Hephaera 5.2.0
Hephaera 5.2.0
This stable release brings the new building, mechanical-model and reusable game-effect workflows into the versioned installer packages. Both installers select the same immutable Hephaera source and Bubo revision; setup runs the existing project scaffold automatically.
New production workflows
- FLOOR PLAN TO MODEL: design a building floor by floor, approve its complete dimensioned architectural package, then construct detailed unfurnished interiors and exteriors. Keep editable Blender source, semantic identities and separate visual/collision exports. Practical guide.
- SCHEMATIC TO MODEL: approve dimensioned schematics, build parts independently and assemble vehicles, devices and vessels with separately addressable components. Validate supported joints, mechanisms and flexible components, and preserve articulation metadata and diagnostic motion. Practical guide.
- Reusable VFX and MODEL TO ACTION v2: prepare versioned effect packages, process bounded textures/flipbooks/atlases, and connect reviewed effects to action clips with stable source/target bindings. The Three.js bridge uses Quarks with explicit resource ownership, cleanup, accessibility alternatives and review captures. Practical guide and detailed reference.
The default visual pipeline stays unchanged. AUDIO, MUSIC and VOICE remain independent domains that can be loaded alongside visual work. Existing action-v1 consumers keep their original contract.
Installation and updates
GitHub Packages is the primary registry for this release:
- npm:
@timothymeadows/hephaera@5.2.0athttps://npm.pkg.github.com. - NuGet tool:
Hephaeraversion5.2.0athttps://nuget.pkg.github.com/TimothyMeadows/index.json.
Both feeds require GitHub authentication. Use the matching release's setup ZIP, manifest and checksums; follow the installation guide for a new project or an explicit managed update. Manual clone/submodule installation remains the advanced option. npmjs.com and NuGet.org distribution is deferred and is not part of this release rollout.
Updating installer tooling alone does not update a project's pinned baseline. Review the target version's update --dry-run before an explicit update, and preserve .hephaera/.cache, its approval history and recovery journals. A changed native revision requires a fresh verified Bubo build using an existing .NET 10 SDK.
Verification and scope
The feature delivery exercised actual Blender construction/export/re-import, real Three.js WebGL rendering, action cancellation/resource ownership, lower-cost and steady-shape readability alternatives, and comparable performance runs. Independent review and human backend readability QA were recorded separately. Performance observations describe the measured test scenes; they are not device-wide frame-rate or whole-game guarantees.
The reviewed native dependency for this release is Bubo a47896d730b32d00b165e61820060e7c73d1ec4a (API 2). The installed gitlink, lock, build receipt and audited resources must agree; this note is not a second pin.
Three.js is the implemented reusable-VFX action bridge. Native-engine adapters, packaged-device QA, gameplay authority, human runtime acceptance and asset promotion remain separate. Mechanical assemblies retain their preserve-only animation handoff; action composition does not gain implicit mechanical-assembly support. No models, drivers, licensed tools or generated-media allowances are installed or granted by the package release.
The previous 5.1.0-rc.1 tag and package artifacts remain unchanged. Its full GitHub classification did not remove its SemVer prerelease suffix or add these features.
Installation guide previews
The authenticated GitHub setup instructions, captured in desktop and narrow browser layouts:
Publication target: stable GitHub release and both authenticated GitHub Packages feeds. Public npmjs.com and NuGet.org distribution is deferred. Reviewed source tree: 5181bdbc9592937007d3ef290c8fbd0f18ba3387.
Actual merged release source: 334ab87529ec1409d53776a2abf766ca21d53189. Reviewed through PR219; the merge tree matches the reviewed source exactly.
Hephaera 5.1.0-rc.1
Hephaera 5.1.0-rc.1 is the first versioned installer release candidate for GitHub Packages.
- npm package:
@timothymeadows/hephaera, prerelease tagnext. - NuGet tool package:
Hephaera, commandhephaera. - Supported setup installs the exact source revision and automatically runs the canonical project scaffold.
- Shared installer core preserves project content and durable state, with guarded restore/update/recovery operations.
- Bubo source is an explicit optional selection; native builds and media setup remain separate.
Both distributions carry the same source-bound manifest and installer core. Authentication is required for these GitHub Packages feeds. This is a prerelease candidate; real feed acquisition and non-owner consumption are release validation steps.
Reviewed source: f819d9a9c7d641d8c7e14b59560a4fd358ec4630 (merged PR184, identical tree to the reviewed PR head).
4.0.0
What's Changed
- Add first-class Brainstorm mode by @TimothyMeadows in #94
- Add new skills for game development by @TimothyMeadows in #95
- Add Blender art production capabilities by @TimothyMeadows in #96
- Add art pipelines and code-first Three.js models by @TimothyMeadows in #107
- Add Blender art pipeline by @TimothyMeadows in #108
- Add optional external 3D asset libraries by @TimothyMeadows in #110
Full Changelog: 3.0.1...4.0.0
3.0.1
What's Changed
- feat(gauntlet): add first-class adversarial delivery mode by @TimothyMeadows in #87
- feat(gauntlet): add progressive PR delivery by @TimothyMeadows in #89
Full Changelog: 3.0.0...3.0.1
3.0.0
What's Changed
-
Expand web and gameplay capabilities by @TimothyMeadows in #70
- adds 29 OpenCaw skills, two roles, and six web style templates
- adds static source auditing, originality evidence, browser capture, media rendering, performance reporting, gameplay review, and role-map commands
- makes domain-qualified role mapping JSON canonical and generated Markdown deterministic
- gives all 76 skills matching interface metadata
- strengthens skill safety and full-catalog validation
- adds inert adversarial, browser, media, originality, performance, and gameplay fixtures
-
Add proactive repository-local Memory by @TimothyMeadows in #73
- Store every memory and context artifact under
<project-root>/.ai/, including the always-loadedSYSTEM_MEMORY.md. - Add safe root resolution, protected system-memory defaults, tagged memory writes, ranked retrieval, exact-tag archival/purge, complete legacy migration, and repository-map fingerprint commands.
- Replace fragmented review/promotion skills with
maintain-memoryandmaintain-repository-mapworkflows shared across roles. - Update scaffolding, context cleanup, summaries, task tooling, role mappings, documentation, and validation hooks.
- Add isolated tests for path boundaries, tags, security rejection, migration completeness, map staleness, deduplication, contradiction replacement, and cleanup.
- Store every memory and context artifact under
-
Add local GPU support if available for use by @TimothyMeadows in #77
-
Refactor local GPU assets into .styles/.gpu by @TimothyMeadows in #81
-
Remove the legacy .media directory by @TimothyMeadows in #83
Full Changelog: 2.0.0...3.0.0
2.0.0
What's Changed
- docs(architecture): add Markdown template by @TimothyMeadows in #51
- feat(roles): add project manager role by @TimothyMeadows in #52
- feat(subagents): add orchestration support by @TimothyMeadows in #53
- docs(architecture): add Docker template by @TimothyMeadows in #54
- docs(readme): document sub-agent workflow by @TimothyMeadows in #55
- docs(readme): update flow diagram for subagents by @TimothyMeadows in #56
- feat(goal-flow): add automated goal delivery flow by @TimothyMeadows in #57
Full Changelog: 1.0.3...2.0.0
1.0.3
What's Changed
- Add slide deck by @TimothyMeadows in #46
- Update README with summary video by @TimothyMeadows in #48
- feat(playwright): add QA workflow tooling by @TimothyMeadows in #49
Full Changelog: 1.0.2...1.0.3
1.0.2
What's Changed
- chore(roles): add arts consultation guidance to UI-adjacent CS roles by @TimothyMeadows in #28
- chore(opencaw): apply audit cleanup patchset by @TimothyMeadows in #30
- feat: add database architecture templates and CLI install/query skills by @TimothyMeadows in #32
- feat: add SignalR/WebSockets architecture with SignalR-first guidance by @TimothyMeadows in #34
- feat: make architecture generation link-based by default by @TimothyMeadows in #36
- Update README.md by @TimothyMeadows in #37
- feat: add DOTNET_ASPIRE architecture template by @TimothyMeadows in #38
- fix: use read directives for ARCHITECTURE generation by @TimothyMeadows in #39
Full Changelog: 1.0.1...1.0.2
1.0.1
What's Changed
- feat(qa): expand qa-engineer role with Playwright support by @TimothyMeadows in #9
- feat(baseline): enforce GitHub Actions and cloud preference order by @TimothyMeadows in #10
- feat(scaffold): append host AGENTS bootstrap on first run by @TimothyMeadows in #11
- fix(startup): auto-run host scaffold on first run by @TimothyMeadows in #12
- fix(commands): enforce LF line endings for shell scripts by @TimothyMeadows in #13
- feat(roles): add arts css-vector-artist role by @TimothyMeadows in #14
- fix(tasks): use virtual task paths in issue bodies by @TimothyMeadows in #16
- feat(arts): add generative-art-designer role with sanity tooling by @TimothyMeadows in #18
- fix(tasks): preserve TASK.md markdown in issue body by @TimothyMeadows in #25
- feat: import tasks from GitHub issue numbers by @TimothyMeadows in #26
Full Changelog: 1.0.0...1.0.1

