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
7 changes: 0 additions & 7 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -19,13 +19,6 @@
"description": "HiQ Editor toolkit: the native CLI release, its canonical UPR workflow skill and evidence-based authoring/review agents.",
"version": "0.12.0"
},
{
"name": "querying-lca-datasets-expert",
"displayName": "Environmental Data",
"source": "./plugins/querying-lca-datasets-expert",
"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",
"source": "./plugins/jimu-lca",
Expand Down
2 changes: 2 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,3 +35,5 @@ Changes here do not automatically switch Desktop's production marketplace or rel
## Reporting issues

Use [GitHub Issues](https://github.com/HiQ-AI/plugins/issues) with plugin ID, OS/architecture, actual CLI version, expected/observed behavior and a redacted error. Do not attach private materials, service tokens, login codes or full credential/environment dumps.

Environmental Data is maintained in its [independent repository](https://github.com/HiQ-AI/environmental-data). Do not copy its source or add a duplicate product listing here; historical shared-marketplace installations have an [explicit migration path](docs/MIGRATIONS.md).
12 changes: 7 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Agent plugins for life-cycle assessment, environmental product declarations and organization knowledge.

Find background datasets, prepare an openLCA study, work with product carbon-footprint cases, review EPD evidence, author datasets in HiQ Editor, or answer questions from your organization's published Wiki. Each plugin provides task-specific operating instructions and agent roles for its native CLI.
Prepare an openLCA study, work with product carbon-footprint cases, review EPD evidence, author datasets in HiQ Editor, or answer questions from your organization's published Wiki. Each plugin provides task-specific operating instructions and agent roles for its native CLI.

**Public plugin instructions do not grant access to HiQ services, licensed databases or an organization's materials.** You need the relevant CLI, account and permissions. The two expert plugins are explicitly prerelease; see their status before using them.

Expand All @@ -13,7 +13,6 @@ 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. |
| [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 All @@ -32,7 +31,7 @@ Add this repository as a marketplace:
Then install the plugin you need, for example:

```text
/plugin install querying-lca-datasets-expert@hiq-plugins
/plugin install cortex-org-wiki@hiq-plugins
```

Use any plugin ID from the table in the same form, or select it through the host's plugin interface. This is a repository marketplace, not a claim of inclusion in Anthropic's official directory.
Expand All @@ -43,15 +42,14 @@ Use any plugin ID from the table in the same form, or select it through the host

| Host | Support boundary |
| --- | --- |
| Claude Code | Native marketplace and all six plugin manifests have been validated with the installed CLI. Installation syntax is documented; no model-driven, end-to-end business workflow is claimed by this check. |
| Claude Code | Native marketplace and the plugin manifests have been validated with the installed CLI. Installation syntax is documented; no model-driven, end-to-end business workflow is claimed by this check. |
| Cortex Desktop | The root catalog carries Cortex-specific, pinned CLI supply metadata for compatible Hosts. Production Desktop has **not** switched to this repository; this publication is not a Desktop release. |
| Codex and other agents | Some expert CLIs have their own host-skill installation commands. This repository's marketplace has **not** been adapted or tested as a Codex plugin installer. Do not assume Claude Code marketplace commands apply to another host. |

See [compatibility and verification](docs/COMPATIBILITY.md) for platform coverage, tested behavior and remaining limitations.

## Use the right tool for the task

- **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 All @@ -70,6 +68,10 @@ Use only authorized inputs and the minimum fields needed for a service request.

Imports, model edits, calculations, review execution, submission and notifications require authorization for their actual target and effects. Read back writes, retain real receipts, and report incomplete or uncertain outcomes rather than blindly repeating an operation. CLI success is not proof of professional conformity, data suitability or certification. Details: [capabilities and safety boundaries](docs/CAPABILITIES.md).

## Distribution changes

Environmental Data is now distributed through its [independent repository and marketplace](https://github.com/HiQ-AI/environmental-data), rather than listed alongside these plugins. Existing users can follow the [explicit migration guide](docs/MIGRATIONS.md); no CLI or credential migration is performed automatically.

## Documentation and contributions

- [Installation and CLI preparation](docs/INSTALLATION.md)
Expand Down
1 change: 0 additions & 1 deletion docs/CAPABILITIES.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@ 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. |
| 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/CLI_REQUIREMENTS.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Native CLI requirements

See [installation and CLI preparation](INSTALLATION.md) for all six plugins, exact download/integrity steps, expert prerelease versions, authentication and optional runtime requirements.
See [installation and CLI preparation](INSTALLATION.md) for the listed plugins, exact download/integrity steps, expert prerelease versions, authentication and optional runtime requirements.

The [root catalog](../marketplace.json) pins CLI archives; it is not an installer. Native plugin installation does not provision a binary, login or business permissions. Preserve full sidecars and check actual executable versions before use.

Expand Down
5 changes: 2 additions & 3 deletions docs/COMPATIBILITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,6 @@
| --- | --- | --- | --- | --- | --- |
| Nora | Yes | Yes | Yes | Yes | Yes |
| HiQ Editor | 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 All @@ -25,8 +24,8 @@ Checks distinguish package integrity from professional or business acceptance:

| Check | Evidence / boundary |
| --- | --- |
| Catalog consistency | Local static check enforces the six declared plugin IDs, plugin/manifest versions, declared skill and agent paths, CLI pins and generated native index. GitHub-hosted CI runs the same check without credentials or business calls. |
| Native manifests | `claude plugin validate` checks the generated marketplace and six plugin manifests. It does not execute a model-driven workflow, install CLI dependencies or prove business correctness. Optional listing icons are not supplied. |
| Catalog consistency | Local static check enforces the declared plugin IDs, plugin/manifest versions, declared skill and agent paths, CLI pins and generated native index. GitHub-hosted CI runs the same check without credentials or business calls. |
| Native manifests | `claude plugin validate` checks the generated marketplace and the plugin manifests. It does not execute a model-driven workflow, install CLI dependencies or prove business correctness. Optional listing icons are not supplied. |
| New expert archive integrity | Both macOS arm64 archives were downloaded and their entire SHA256 digests matched the catalog. Full bundles were extracted for isolated discovery checks. |
| Actual openLCA CLI | The macOS binary's `version` reports `0.1.0-dev.14`; `--help` exits successfully. No openLCA database/service was opened or modified in these checks. |
| Actual EPD CLI | The macOS binary's `version -f json` reports `0.1.0-dev.14.candidate.39933331655.1.2`; `--help` exits successfully. No Docling installation, login, model call, review or report generation was performed. |
Expand Down
4 changes: 1 addition & 3 deletions docs/INSTALLATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,6 @@ Install one or more plugins by ID:
```text
/plugin install cortex-org-wiki@hiq-plugins
/plugin install hiq-editor@hiq-plugins
/plugin install querying-lca-datasets-expert@hiq-plugins
/plugin install jimu-lca@hiq-plugins
/plugin install cortex-lca-expert@hiq-plugins
/plugin install cortex-epd@hiq-plugins
Expand All @@ -36,7 +35,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 Environmental Data 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 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 +47,6 @@ 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 |
| 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
33 changes: 33 additions & 0 deletions docs/MIGRATIONS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Marketplace migrations

## Environmental Data: independent distribution

Environmental Data's authoritative source is [HiQ-AI/environmental-data](https://github.com/HiQ-AI/environmental-data). It is intentionally absent from this marketplace's current catalog so users see it as an independent product, not a duplicate listing alongside Editor or the expert plugins. The other products remain here.

The independent marketplace uses native relative sources within its own repository. Although a native marketplace can reference another repository, adding that reference here would still create a shared-marketplace product listing. No such duplicate listing is added. The current Cortex catalog/provisioner also resolves plugin paths within its configured repository; it does not define a per-entry remote-source field, so this migration does not invent one.

### Existing installations

The stable plugin ID is still `querying-lca-datasets-expert`; the business CLI is still `querying-lca-datasets`0.5.1 with unchanged authentication and release pins. The marketplace namespace changes from `hiq-plugins` to `environmental-data` and requires an explicit host-plugin migration:

1. Inspect the host's installed list and disable the old `querying-lca-datasets-expert@hiq-plugins` entry to avoid two active copies.
2. Add the independent marketplace and install its plugin:

```text
/plugin marketplace add HiQ-AI/environmental-data
```

```text
/plugin install querying-lca-datasets-expert@environmental-data
```

3. Confirm the independent plugin is available, then uninstall only the old host-plugin entry through the host's own interface.
4. Preserve the separately installed CLI, credentials, input files and user data. Reload the host session if required for plugin discovery.

A catalog refresh does not move an installed plugin between marketplace namespaces. Existing entries are not silently removed or migrated by this repository. Old revisions are historical evidence, not a second maintained product source. See the independent [installation guide](https://github.com/HiQ-AI/environmental-data/blob/main/docs/INSTALLATION.md).

### Verified boundary

With Claude Code2.1.317 in an isolated HOME/config, the old shared entry was installed and disabled, the independent public marketplace was added and its plugin0.5.3 installed, then the old entry was uninstalled. The final installed list contained only the enabled independent entry. The actual cache contained the manifest, main operating skill and three agent roles. No business CLI provisioning, login, model call or data request was performed.

This is native packaging/migration evidence, not Codex compatibility or a production Desktop change. This publication does not switch Desktop's existing source, release Desktop or alter its installed plugin/account state.
1 change: 0 additions & 1 deletion docs/SPREADSHEETS.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@ 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.
- **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
Loading
Loading