@openreachtech/hora-ecosystem

A module catalog of Open Reach Tech's ecosystem packages (renchan-* / furo-* / mentsu-*), maintained so that Hora — Open Reach Tech's tool for fully-automated, AI-driven application generation — can learn how to use them.

Concept

This package doesn't ship runnable application code. It ships catalog data: a machine-readable list of which ecosystem packages are currently tracked, plus a per-package specification of each package's classes and how to use them, extracted from that package's own README and JSDoc/type declarations.

The catalog content isn't written for human readability — it only needs to be precise enough for Hora (an AI) to understand a package's public surface and use it correctly.

Installation

Requires Node.js 20.x (the version the CI builds against).

npm install @openreachtech/hora-ecosystem

It is an ES module ("type": "module"); import it with ESM import syntax.

Usage

config/lookup.js

The whitelist of tracked packages, as a plain object mapping each package name (without the @openreachtech/ scope) to whether it's currently catalogued:

import TARGET_PACKAGES from '@openreachtech/hora-ecosystem/config/lookup.js'

Object.entries(TARGET_PACKAGES)
  .filter(([, isCatalogued]) => isCatalogued)
  .map(([packageName]) => packageName)
// -> ['mentsu-rootpath', 'renchan-env', ...]

A package present with value false is known to exist but intentionally excluded from the catalog (e.g. deprecated, or not yet decided on); a package absent from this object entirely was never a candidate.

lib/docs/<package-name>/

For every package name that's true in config/lookup.js, this directory holds:

• README.md — a verbatim copy of that package's own README, when one exists.
• API.md — a summary of the package's exported classes/functions and their public members, methods, and signatures, derived from its .d.ts or JSDoc.

import { readFile } from 'node:fs/promises'

const apiReference = await readFile(
  new URL(
    '../node_modules/@openreachtech/hora-ecosystem/lib/docs/mentsu-rootpath/API.md',
    import.meta.url
  ),
  'utf-8'
)

Contribution

Bug reports, feature requests, and code contributions are welcome.

Feel free to contact us through GitHub Issues.

The catalog under config/lookup.js and lib/docs/ is maintained with Claude Code skills — see CONTRIBUTION.md for how to use them.

git clone https://github.com/openreachtech/hora-ecosystem.git
cd hora-ecosystem
npm install
npm run lint
npm test

License

This project is released under the Apache License 2.0.

For more details, please see in the LICENSE file.

Developer

Open Reach Tech Inc.

Copyright

© 2026 Open Reach Tech Inc.