Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,10 @@
},
{
"name": "querying-lca-datasets-expert",
"displayName": "Environmental Data",
"source": "./plugins/querying-lca-datasets-expert",
"description": "Query LCA process datasets and match inventory requirements using the self-contained querying-lca-datasets CLI, with provenance and representativeness review.",
"version": "0.5.1"
"description": "Environmental Data: search and match environmental process data across published database sources, preserving source, version, system model, units and applicability evidence. Access depends on source and account entitlements.",
"version": "0.5.2"
},
{
"name": "jimu-lca",
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Find background datasets, prepare an openLCA study, work with product carbon-foo
| --- | --- |
| [cortex-org-wiki](plugins/cortex-org-wiki/README.md) | Search Nora's published organization Wiki and read versioned pages with source citations. Use the CLI's own Cortex login and the intended organization. |
| [hiq-editor](plugins/hiq-editor/README.md) | HiQ Editor toolkit: the native CLI release, its canonical UPR workflow skill and evidence-based authoring/review agents. |
| [querying-lca-datasets-expert](plugins/querying-lca-datasets-expert/README.md) | Query LCA process datasets and match inventory requirements using the self-contained querying-lca-datasets CLI, with provenance and representativeness review. |
| [Environmental Data](plugins/querying-lca-datasets-expert/README.md) | Environmental Data: search and match environmental process data across published database sources, preserving source, version, system model, units and applicability evidence. Access depends on source and account entitlements. |
| [jimu-lca](plugins/jimu-lca/README.md) | Inspect JiMULCA product carbon-footprint cases and run authorized inventory, binding and calculation operations with the user's own member credential. |
| [cortex-lca-expert](plugins/cortex-lca-expert/README.md) | Preview wrapper for cortex-lca-expert 0.1.0-dev.14: build, inspect and calculate openLCA models using the user's installed application and Cortex expert authorization. Wrapper version 0.1.0 is not a stable CLI release. |
| [cortex-epd](plugins/cortex-epd/README.md) | Demo-only prerelease wrapper for cortex-epd 0.1.0-dev.14.candidate.39933331655.1.2. EPD pre-audit instructions come from that complete candidate. HOLD remains in effect; this is not promotion, product acceptance or certification. |
Expand Down Expand Up @@ -51,7 +51,7 @@ See [compatibility and verification](docs/COMPATIBILITY.md) for platform coverag

## Use the right tool for the task

- **Looking for a background factor or dataset?** Start with dataset lookup. A match needs compatible function, units, geography, technology and period; a search hit alone does not establish suitability.
- **Looking for environmental process data?** Start with [Environmental Data](plugins/querying-lca-datasets-expert/README.md) for multi-source discovery and matching. A match needs compatible function, units, geography, technology and period; a search hit alone does not establish suitability.
- **Building an LCA study?** Use the prerelease openLCA plugin with your own official openLCA installation and appropriately licensed databases. Dataset lookup does not calculate a model.
- **Working in JiMULCA?** Use its case workflow and the intended space/case. Local file edits do not change a remote case.
- **Preparing or reviewing an EPD?** The demo prerelease assists with intake and evidence. A generated report is not certification, and review execution requires explicit delegation and model-cost authorization.
Expand Down
2 changes: 1 addition & 1 deletion docs/CAPABILITIES.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Choose a plugin by the system and task you actually need. Agent roles help organ
| --- | --- | --- |
| Nora | Read published organization Wiki pages; trace exact versions and sources; synthesize supported answers | Requires organization membership. Search results are not public data. This plugin does not author/publish pages, approve processes or notify colleagues. |
| Editor | Prepare authorized UPR inputs; inspect preflight; import, trial-calculate and read back a process | Import uploads/creates remote resources. Trial calculation writes results. Review submission can notify people and needs specific submission authorization. Workbook preparation is not a successful import. |
| Dataset lookup | Search background process datasets, verify source coordinates and match inventory needs | Read-only matching, constrained by data rights. Not a calculation engine, model editor, bulk database downloader or permission to upload an entire workbook. A dataset identity match does not prove representativeness. |
| Environmental Data | Search background process datasets, verify source coordinates and match inventory needs | Read-only matching, constrained by data rights. Not a calculation engine, model editor, bulk database downloader or permission to upload an entire workbook. A dataset identity match does not prove representativeness. |
| JiMU | Inspect products/cases; prepare inventory; authorized edits, background binding and calculations | Requires intended product/space/case and controlled member credential. UUID-based local binding has a separately prepared optional bridge; ordinary name-based binding does not justify downloading it. No certification claim. |
| openLCA prerelease | Prepare a study, operate an authorized native model and explain actual calculations | Requires user's openLCA installation, workspace, data licenses and CLI entitlement. Database import/restore/replacement, entity edits, service start and calculations have real effects. No automatic database preparation. Structural checks are not professional quality acceptance. |
| EPD demo prerelease | Clarify engagement and material roles; execute a separately authorized demo review; explain actual findings and reports | Demo-only, formal promotion on hold. Requires matching sidecars, separately locked Docling, intended login/entitlement, delegation and model-cost consent. Review creation/copying materials and execution are not read-only checks. Reports are not certificates. |
Expand Down
2 changes: 1 addition & 1 deletion docs/COMPATIBILITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
| --- | --- | --- | --- | --- | --- |
| Nora | Yes | Yes | Yes | Yes | Yes |
| HiQ Editor | Yes | Yes | Yes | Yes | Yes |
| Dataset lookup | Yes | Yes | Yes | Yes | Yes |
| Environmental Data | Yes | Yes | Yes | Yes | Yes |
| JiMU | Yes | No | No | No | No |
| openLCA modeling — prerelease | Yes | No | No | Yes | Yes |
| EPD review — demo prerelease | Yes | No | No | Yes | Yes |
Expand Down
4 changes: 2 additions & 2 deletions docs/INSTALLATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ For manual preparation:
5. Check version and help using that exact release. The expert archives use supply wrapper `0.1.0`, but their executables report prerelease versions. A plugin version, archive directory name or successful download does not prove runtime readiness.
6. If using a release-owned operating skill in another host, use that CLI's documented skill installation mechanism. Do not overwrite an existing customized skill, register all hosts or change global permissions without authorization.

Publisher entry points are available for [Editor](https://download.hiq.earth/cli/hiq-editor/install.md), [Nora](https://download.hiq.earth/cli/cortex-org-wiki/install.sh) and [JiMU](https://download.hiq.earth/cli/jimu-lca/install.sh). Inspect the instructions and platform/version before running an installer. A script link is not a recommendation to pipe an uninspected response into a shell. For dataset lookup and both expert previews, use the pinned archives; do not infer a current installer URL from the CLI name.
Publisher entry points are available for [Editor](https://download.hiq.earth/cli/hiq-editor/install.md), [Nora](https://download.hiq.earth/cli/cortex-org-wiki/install.sh) and [JiMU](https://download.hiq.earth/cli/jimu-lca/install.sh). Inspect the instructions and platform/version before running an installer. A script link is not a recommendation to pipe an uninspected response into a shell. For Environmental Data and both expert previews, use the pinned archives; do not infer a current installer URL from the CLI name.

The proposed newer EPD `experts/cortex-epd/latest.json` and `install.sh` endpoints returned HTTP 403 during verification on 2026-11-04. They are not usable public installation paths in this guide. The catalog's older candidate archives are separate, accessible artifacts; they are not a release of dev.21.

Expand All @@ -48,7 +48,7 @@ Run the relevant discovery command only after trusting and preparing the release
| --- | --- | --- |
| Nora | `cortex-org-wiki --version`, `--help` | CLI device login and intended organization membership; published Wiki pages only |
| Editor | `hiq-editor version --json`, `--help` | CLI login, correct account/organization/datasource and business permissions |
| Dataset lookup | `querying-lca-datasets version`, `--help` | CLI device/QR login or controlled API-key configuration; dataset access depends on entitlements |
| Environmental Data | `querying-lca-datasets version`, `--help` | CLI device/QR login or controlled API-key configuration; dataset access depends on entitlements |
| JiMU | `jimu-lca --version`, `--help` | macOS arm64; user's controlled member-key configuration; this archive does not include the addon required by native login |
| openLCA modeling | `cortex-lca-expert version`, `--help`, `status --offline` | Official openLCA installation, selected workspace/database, CLI device login and `lca-modeling-expert` entitlement; ordinary modeling does not require Pi/model login |
| EPD demo | `cortex-epd version -f json`, `--help`, `doctor --offline -f json` | Matching candidate's full sidecars, separately installed locked Docling 2.140.0-1 (approximately 0.8–0.9 GB download), CLI device login and `epd-audit` entitlement for reviews |
Expand Down
2 changes: 1 addition & 1 deletion docs/SPREADSHEETS.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ The plugins here expose business capabilities, not a general Office suite. A plu
## When needed

- **Editor:** use spreadsheet tooling to inspect or prepare an authorized UPR workbook. The Editor CLI's preflight/import and backend receipts remain authoritative for business validation; spreadsheet recalculation is not an Editor import or trial calculation.
- **Dataset lookup/matching:** use spreadsheet tooling only when the source or requested deliverable is a workbook. Preserve row identity, units and unresolved items. The CLI accepts its documented query inputs; a general workbook is not automatically a supported upload.
- **Environmental Data:** use spreadsheet tooling only when the source or requested deliverable is a workbook. Preserve row identity, units and unresolved items. The CLI accepts its documented query inputs; a general workbook is not automatically a supported upload.
- **Nora:** ordinary search and page reading do not require Excel. A requested workbook export may require a separate spreadsheet capability.
- **JiMU:** ordinary CLI inventory queries do not require Excel. For workbook inputs or outputs use a separate spreadsheet capability; do not infer that editing a workbook changes a JiMU case.
- **openLCA prerelease:** inventory workbook inspection or preparation can need spreadsheet tooling. An edited workbook is not an imported native model; authorize and verify any subsequent import or model edit separately.
Expand Down
10 changes: 5 additions & 5 deletions marketplace.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"version": "1.1.0",
"version": "1.1.1",
"updated_at": "2026-11-04",
"categories": [
{
Expand Down Expand Up @@ -165,10 +165,10 @@
{
"id": "querying-lca-datasets-expert",
"type": "plugin",
"name": "Querying LCA Datasets",
"description": "使用自包含 CLI 检索 LCA 过程数据集,将物料、能源、运输/处理服务等清单需求进行匹配,保留来源坐标并复核时间、地域、技术代表性与参考产品/单位一致性;不修改模型或执行 EPD 审核。",
"description_en": "Query LCA process datasets and match material, energy, transport and treatment inventory requirements through the self-contained CLI. Preserve provenance and review temporal, geographical and technological representativeness and reference product/unit consistency; no model edits or EPD audit.",
"version": "0.5.1",
"name": "Environmental Data",
"description": "Environmental Data:跨已发布数据库检索与匹配环境过程数据,保留来源、版本、系统模型、单位及适用性证据;可访问数据取决于来源和账户权益。",
"description_en": "Environmental Data: search and match environmental process data across published database sources, preserving source, version, system model, units and applicability evidence. Access depends on source and account entitlements.",
"version": "0.5.2",
"author": "HiQ",
"category": "lca",
"tags": [
Expand Down
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
{
"name": "querying-lca-datasets-expert",
"version": "0.5.1",
"description": "Query LCA process datasets and match inventory requirements using the self-contained querying-lca-datasets CLI, with provenance and representativeness review.",
"version": "0.5.2",
"description": "Environmental Data: search and match environmental process data across published database sources, preserving source, version, system model, units and applicability evidence. Access depends on source and account entitlements.",
"repository": "https://github.com/HiQ-AI/plugins",
"license": "MIT",
"author": {
"name": "HiQ"
}
},
"displayName": "Environmental Data"
}
17 changes: 13 additions & 4 deletions plugins/querying-lca-datasets-expert/README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,18 @@
# LCA dataset lookup & matching
# Environmental Data

For LCA practitioners selecting background process datasets for materials, energy, transport, treatment and other inventory requirements.
Search and match environmental process data across published database sources, with traceable provenance and explicit applicability limits.

For practitioners selecting data for environmental assessments, life-cycle inventories and product carbon-footprint studies. The current workflow covers LCA background process datasets for materials, energy, transport, treatment and other inventory requirements; it is not a promise that every environmental database or data type is connected.

## What it does

Search datasets, inspect source/version/model and reference units, verify identifiers and propose justified matches or unresolved needs while preserving input-row identity.
Search published sources, inspect source/version/system-model coordinates and reference units, verify identifiers and propose justified matches or unresolved needs while preserving input-row identity. Retain geography, time and technology evidence rather than treating a search hit as a suitable factor.

## Published sources and current scope

The backing service's public directory currently advertises sources including HiQLCD, Ecoinvent, CALCD, CarbonMinds, Agri-footprint, EF, AusLCI, BAFU, ELCD, USLCI and Worldsteel. See the [dated source inventory](SOURCES.md) for the full observed list, versions, system models and coverage limits, and follow its live directory link for current metadata.

Catalog visibility is not access to numerical data. Commercial-source values require the relevant account entitlements; a service “free” flag does not grant redistribution rights. LCIA coverage varies: the listed Agri-footprint and Recycled Plastics versions do not advertise LCIA results. A new product name does not connect additional databases; unlisted sources are not claimed as supported.

## Install the plugin

Expand All @@ -22,7 +30,8 @@ This loads instructions and agent roles, not a CLI, credentials or business data

## Native CLI and requirements

- Plugin version: **0.5.1**.
- Public product name: **Environmental Data**. The install ID remains `querying-lca-datasets-expert` so existing installations and upgrades keep their identity.
- Plugin version: **0.5.2** (branding and documentation update).
- CLI executable: `querying-lca-datasets`. CLI version: **0.5.1**.
- Catalog platforms: `darwin-arm64, darwin-x64, linux-arm64, linux-x64, win32-x64`. Missing platforms are unsupported by this catalog.
- Exact archive URLs, SHA256 and executable/skill paths: [release catalog](https://github.com/HiQ-AI/plugins/blob/main/marketplace.json).
Expand Down
Loading
Loading