From 16e2c8357c85a4ef0dcb687f2aa9ec55d152660e Mon Sep 17 00:00:00 2001 From: Kirby <996@itdog.icu> Date: Wed, 4 Nov 2026 11:10:47 +0800 Subject: [PATCH] docs: present dataset discovery as Environmental Data Use native displayName without changing install identity or CLI contracts. Document current published sources, coverage and entitlement limits; retain the shared marketplace and other product brands. Co-Authored-By: Claude Opus 5 --- .claude-plugin/marketplace.json | 5 ++- README.md | 4 +- docs/CAPABILITIES.md | 2 +- docs/COMPATIBILITY.md | 2 +- docs/INSTALLATION.md | 4 +- docs/SPREADSHEETS.md | 2 +- marketplace.json | 10 ++--- .../.claude-plugin/plugin.json | 7 +-- .../querying-lca-datasets-expert/README.md | 17 +++++-- .../querying-lca-datasets-expert/SOURCES.md | 44 +++++++++++++++++++ .../agents/lca-dataset-matcher.md | 2 +- .../agents/lca-dataset-reviewer.md | 2 +- .../agents/lca-dataset-searcher.md | 2 +- .../querying-lca-datasets-guide/SKILL.md | 12 +++-- scripts/catalog.mjs | 4 +- 15 files changed, 90 insertions(+), 29 deletions(-) create mode 100644 plugins/querying-lca-datasets-expert/SOURCES.md diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index c750550..1f629cf 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -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", diff --git a/README.md b/README.md index 40272ea..26dd64a 100644 --- a/README.md +++ b/README.md @@ -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. | @@ -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. diff --git a/docs/CAPABILITIES.md b/docs/CAPABILITIES.md index 74d574c..c1310a6 100644 --- a/docs/CAPABILITIES.md +++ b/docs/CAPABILITIES.md @@ -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. | diff --git a/docs/COMPATIBILITY.md b/docs/COMPATIBILITY.md index 6fbd166..31760c8 100644 --- a/docs/COMPATIBILITY.md +++ b/docs/COMPATIBILITY.md @@ -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 | diff --git a/docs/INSTALLATION.md b/docs/INSTALLATION.md index d1349d3..0d6281e 100644 --- a/docs/INSTALLATION.md +++ b/docs/INSTALLATION.md @@ -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. @@ -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 | diff --git a/docs/SPREADSHEETS.md b/docs/SPREADSHEETS.md index 0395567..b7a6b1f 100644 --- a/docs/SPREADSHEETS.md +++ b/docs/SPREADSHEETS.md @@ -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. diff --git a/marketplace.json b/marketplace.json index 6b96a39..3bb7d88 100644 --- a/marketplace.json +++ b/marketplace.json @@ -1,5 +1,5 @@ { - "version": "1.1.0", + "version": "1.1.1", "updated_at": "2026-11-04", "categories": [ { @@ -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": [ diff --git a/plugins/querying-lca-datasets-expert/.claude-plugin/plugin.json b/plugins/querying-lca-datasets-expert/.claude-plugin/plugin.json index bead175..1597b7e 100644 --- a/plugins/querying-lca-datasets-expert/.claude-plugin/plugin.json +++ b/plugins/querying-lca-datasets-expert/.claude-plugin/plugin.json @@ -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" } diff --git a/plugins/querying-lca-datasets-expert/README.md b/plugins/querying-lca-datasets-expert/README.md index 0e6d4dd..51b37bd 100644 --- a/plugins/querying-lca-datasets-expert/README.md +++ b/plugins/querying-lca-datasets-expert/README.md @@ -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 @@ -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). diff --git a/plugins/querying-lca-datasets-expert/SOURCES.md b/plugins/querying-lca-datasets-expert/SOURCES.md new file mode 100644 index 0000000..e2ee20d --- /dev/null +++ b/plugins/querying-lca-datasets-expert/SOURCES.md @@ -0,0 +1,44 @@ +# Environmental Data — sources and scope + +Environmental Data is a multi-source entry point for environmental process-data discovery and matching. Its current CLI workflow targets LCA background process datasets for materials, energy, transport, treatment and other inventory requirements. It is not a claim to cover every kind of environmental data or every database. + +## Published source catalog + +The backing service's [public source directory](https://x.hiqlcd.com/api/relic/sources) was read anonymously on **2026-11-04**. The table records the latest version advertised for each source at that time. Earlier versions can also be listed by the service; use the live directory and the CLI's actual help/schema to select an available source/version/system-model coordinate. + +| Published source | Source code | Latest advertised version | Advertised system model(s) | Service access flag | LCIA advertised | +| --- | --- | --- | --- | --- | --- | +| HiQLCD | `hiqlcd` | 1.5.0 | `CONSEQUENTIAL`, `CUT_OFF`, `EN_15804` | Commercial | Yes | +| HiQLCD-AL | `hiqlcd-al` | 2.0.0 | `CONSEQUENTIAL`, `CUT_OFF` | Commercial | Yes | +| CALCD | `calcd` | 3.0.0 | `CUT_OFF` | Commercial | Yes | +| China Li-ion Battery Carbon Footprint Database (CESI) | `hiq-cesi` | 1.1.0 | `CUT_OFF` | Commercial | Yes | +| Ecoinvent | `ecoinvent` | 3.12.0 | `APOS`, `CONSEQUENTIAL_LONG`, `CUT_OFF`, `EN_15804` | Commercial | Yes | +| CarbonMinds | `carbonminds` | 2.0.2 | `CUT_OFF` | Commercial | Yes | +| Agri-footprint | `agrifootprint` | 7.0 | `CUT_OFF` | Commercial | No | +| EF | `ef` | 3.1.0 | `DEFAULT` | Free in service catalog | Yes | +| AusLCI | `auslci` | 1.40 | `DEFAULT` | Free in service catalog | Yes | +| BAFU | `bafu` | 2025 | `DEFAULT` | Free in service catalog | Yes | +| BioEnergieDat | `bioenergiedat` | 1.0 | `DEFAULT` | Free in service catalog | Yes | +| ELCD | `elcd` | 3.2 | `DEFAULT` | Free in service catalog | Yes | +| NEEDS | `needs` | 1.0 | `DEFAULT` | Free in service catalog | Yes | +| OzLCI | `ozlci` | 1.0 | `DEFAULT` | Free in service catalog | Yes | +| Recycled Plastics | `recycledplastics` | 1.0 | `DEFAULT` | Free in service catalog | No | +| USDA Crop Data | `usda` | 1.0 | `DEFAULT` | Free in service catalog | Yes | +| USLCI | `uslci` | 1.0 | `DEFAULT` | Free in service catalog | Yes | +| Worldsteel | `worldsteel` | 2020 | `DEFAULT` | Free in service catalog | Yes | + +This is **published catalog metadata**, not a per-account access inventory or a completed lookup test against every source. Directory visibility does not grant numerical-data access. Commercial values remain subject to the user's source/version/model entitlements. A service “free” flag does not waive the original database's license or permit unrestricted redistribution. + +“LCIA advertised” means the service reports LCIA coverage for that source version. It does not establish coverage of every process, method or indicator. In particular, the catalog does not advertise LCIA for the listed Agri-footprint and Recycled Plastics versions; do not manufacture missing results or represent a process record as a retrieved impact factor. + +## What matching must preserve + +Retain the actual source code, version, system model, dataset reference, reference product/unit, geography and any available time/technology evidence. Explain proxies and unresolved requirements. Database release year is not the underlying data's reference year, and a matching name alone does not establish applicability. + +Search, identity verification, numerical lookup and professional suitability are separate steps. A restricted value is not an empty database. Do not switch to another source or model silently when a requested source is unavailable to the account. + +## Additional databases + +The product name allows a broader environmental-data entry point; it does not make an unconnected database available. Only claim a source/version/model that the live service advertises and the current command actually supports. Databases absent from that directory are not claimed as integrated here. Similar names are not aliases unless the service explicitly identifies them as such. + +This documentation update changes branding, not the service catalog, database integrations, CLI protocol, authentication, downloads or data rights. The source directory may evolve independently of this plugin. Discover current capabilities rather than treating this dated snapshot as a permanent allowlist. diff --git a/plugins/querying-lca-datasets-expert/agents/lca-dataset-matcher.md b/plugins/querying-lca-datasets-expert/agents/lca-dataset-matcher.md index 7c1f1e4..374e44d 100644 --- a/plugins/querying-lca-datasets-expert/agents/lca-dataset-matcher.md +++ b/plugins/querying-lca-datasets-expert/agents/lca-dataset-matcher.md @@ -1,6 +1,6 @@ --- name: lca-dataset-matcher -description: "Match material and exchange items from an inventory or BOM to background process datasets through querying-lca-datasets, retaining row identity, selection rationale, unit basis and unresolved items without editing the inventory." +description: "Environmental Data: Match material and exchange items from an inventory or BOM to background process datasets through querying-lca-datasets, retaining row identity, selection rationale, unit basis and unresolved items without editing the inventory." --- Read `${CLAUDE_PLUGIN_ROOT}/skills/querying-lca-datasets-guide/SKILL.md`. Inspect only authorized input fields. Preserve each item's identity and extract its required function, material/service, technology, unit, geography and period. The input can be a single inventory item or supported batch, including energy, transport and treatment services; do not assume every query is a BOM material. Discover the actual CLI schema and use its supported batch query form rather than uploading an arbitrary workbook or launching a workflow automatically. diff --git a/plugins/querying-lca-datasets-expert/agents/lca-dataset-reviewer.md b/plugins/querying-lca-datasets-expert/agents/lca-dataset-reviewer.md index 331c66d..80e6e10 100644 --- a/plugins/querying-lca-datasets-expert/agents/lca-dataset-reviewer.md +++ b/plugins/querying-lca-datasets-expert/agents/lca-dataset-reviewer.md @@ -1,6 +1,6 @@ --- name: lca-dataset-reviewer -description: "Review proposed background process dataset matches for temporal, geographical and technological representativeness, reference product/unit consistency and evidence quality using read-only querying-lca-datasets commands." +description: "Environmental Data: Review proposed background process dataset matches for temporal, geographical and technological representativeness, reference product/unit consistency and evidence quality using read-only querying-lca-datasets commands." --- Read `${CLAUDE_PLUGIN_ROOT}/skills/querying-lca-datasets-guide/SKILL.md`. Compare each proposed process dataset with the original inventory requirement and actual receipts. Verify its identifier, source/version/model, reference product/unit and publication state through documented dataset commands. Identity verification is not a quality score or proof of suitability. diff --git a/plugins/querying-lca-datasets-expert/agents/lca-dataset-searcher.md b/plugins/querying-lca-datasets-expert/agents/lca-dataset-searcher.md index 002583f..0cf7b61 100644 --- a/plugins/querying-lca-datasets-expert/agents/lca-dataset-searcher.md +++ b/plugins/querying-lca-datasets-expert/agents/lca-dataset-searcher.md @@ -1,6 +1,6 @@ --- name: lca-dataset-searcher -description: "Find background process datasets for a material, energy, transport, treatment or other inventory requirement using querying-lca-datasets, preserving source coordinates, reference product/unit and provenance." +description: "Environmental Data: Find background process datasets for a material, energy, transport, treatment or other inventory requirement using querying-lca-datasets, preserving source coordinates, reference product/unit and provenance." --- Read `${CLAUDE_PLUGIN_ROOT}/skills/querying-lca-datasets-guide/SKILL.md`. Establish the required function, database/version/system model, unit, geography, time and technology constraints. Inputs may be individual descriptions or supported query batches, not only BOMs. Discover real CLI help and schema, check access without exposing credentials, and search remotely; never download local catalogs or use retired querying scripts. diff --git a/plugins/querying-lca-datasets-expert/skills/querying-lca-datasets-guide/SKILL.md b/plugins/querying-lca-datasets-expert/skills/querying-lca-datasets-guide/SKILL.md index cc11a06..f33978c 100644 --- a/plugins/querying-lca-datasets-expert/skills/querying-lca-datasets-guide/SKILL.md +++ b/plugins/querying-lca-datasets-expert/skills/querying-lca-datasets-guide/SKILL.md @@ -1,11 +1,15 @@ --- name: querying-lca-datasets-guide -description: "Search LCA background databases and match materials, energy, transport, treatment or other inventory items to process datasets using querying-lca-datasets. Use for emission-factor lookup, individual dataset queries and inventory/BOM matching, preserving source/version/model, reference product and unit, geography, time and technology evidence." +description: "Environmental Data: search and match environmental process data across published database sources using querying-lca-datasets. Use for source-aware dataset discovery, retrieved emission-factor lookup and inventory matching, preserving source/version/system model, reference product/unit, geography, time, technology and access limits." --- -# Querying LCA Datasets +# Environmental Data -Use the installed `querying-lca-datasets` executable. Match inventory items to **process datasets** in LCA background databases such as ecoinvent or CLCD when actually available through the service. A database, a process dataset, its reference product and its numerical LCIA result are distinct things. Do not infer a database's availability from an example or invent a dataset or factor from memory. +The public product name is Environmental Data. The stable plugin ID `querying-lca-datasets-expert`, this skill ID and the `querying-lca-datasets` CLI command remain unchanged; a branding update does not require reinstalling under a new identity or replacing authentication. + +Use the installed `querying-lca-datasets` executable to search and match **environmental process datasets** across published sources. Current scope is LCA background data for material, energy, transport, treatment and other inventory requirements. A database, a process dataset, its reference product and its numerical LCIA result are distinct things. Do not infer availability from a product name or invent a dataset/factor from memory. + +Read the plugin's [source inventory and limits](../../SOURCES.md). It records dated metadata from the live public source directory, including HiQLCD, Ecoinvent, CALCD and other advertised sources. It is not a per-account access inventory or a permanent allowlist. Discover current sources, versions and models using the CLI's available tools/help and service metadata; a directory entry does not grant numerical-data access. Some advertised sources lack LCIA results, and an unlisted database is not integrated just because the product has a broad name. Retain source/version/model and applicability evidence; do not silently substitute a different source. Inputs are not limited to a BOM: a material description, process requirement, individual inventory exchange, energy or transport service, or batch inventory rows can all be search queries. Discover what each actual command accepts. This skill is the CLI operating guide, not a local catalog or a modeling/calculation engine. Do not download SQLite catalogs, run retired Querying scripts, install another client, configure an additional Host MCP server or inject Desktop JWT. The CLI's own service protocol is internal to the CLI; it does not require a separate Host MCP connection. Search runs remotely within the user's data entitlements. @@ -21,7 +25,7 @@ querying-lca-datasets describe lookup-datasets `doctor` reports credential source and connectivity, not the secret; version 0.5.1 emits human text even with `--json`. Installation or a version check does not establish data access. Runtime tools and parameters come from `list --json` and `describe `; do not copy a server schema into this skill or invent flags. Static commands such as `search-datasets` use ` --help`, not `describe`. -The CLI owns authentication. User-driven `querying-lca-datasets login` performs device/QR authorization. A securely configured `QUERYING_LCA_DATASETS_API_KEY` takes precedence over this CLI's stored login. The renamed CLI has a new login-storage identity and does not import old client credentials; the user must sign in again. Never inspect credential files, print environment secrets, copy a token from another app or ask for a secret in chat. Do not initiate login/logout or change identity without authorization. Keep the default service endpoint rather than redirecting authenticated requests. +The CLI owns authentication. User-driven `querying-lca-datasets login` performs device/QR authorization. A securely configured `QUERYING_LCA_DATASETS_API_KEY` takes precedence over this CLI's stored login. This product-name update does not change the executable, login-storage identity or credentials; continue using the CLI's existing authorized login. Never inspect credential files, print environment secrets, copy a token from another app or ask for a secret in chat. Do not initiate login/logout or change identity without authorization. Keep the default service endpoint rather than redirecting authenticated requests. ## Search Background Process Datasets diff --git a/scripts/catalog.mjs b/scripts/catalog.mjs index 7b94722..013e16d 100644 --- a/scripts/catalog.mjs +++ b/scripts/catalog.mjs @@ -30,6 +30,7 @@ const native = { const manifest = JSON.parse(read(`${plugin.path}/.claude-plugin/plugin.json`)); assert.equal(manifest.name, plugin.id); assert.equal(manifest.version, plugin.version); + if (manifest.displayName !== undefined) assert.equal(manifest.displayName, plugin.name); read(`${plugin.path}/README.md`); for (const skill of plugin.components.skills ?? []) { checkComponent(plugin, `skills/${skill.id}/SKILL.md`); @@ -47,6 +48,7 @@ const native = { } return { name: plugin.id, + ...(manifest.displayName ? { displayName: manifest.displayName } : {}), source: `./${plugin.path}`, description: manifest.description, version: plugin.version, @@ -62,7 +64,7 @@ const overview = [ '', '| Plugin | Description |', '| --- | --- |', - ...native.plugins.map(plugin => `| [${plugin.name}](plugins/${plugin.name}/README.md) | ${escapeCell(plugin.description)} |`), + ...native.plugins.map(plugin => `| [${escapeCell(plugin.displayName ?? plugin.name)}](plugins/${plugin.name}/README.md) | ${escapeCell(plugin.description)} |`), '', ].join('\n'); const generatedReadme = readme.replace(marker, () => overview);