solid-environment
Use when reading or writing indoor environment observations, air quality monitor metadata, numeric purifier state, sensor day documents, or changing the generated SOSA/QUDT model in @jeswr/solid-environment.
- License 许可
- MIT
- 所属仓库
- jeswr/solid-sdk
- 最近更新
- 2026-11-15
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- solid-environment
- description
- Use when reading or writing indoor environment observations, air quality monitor metadata, numeric purifier state, sensor day documents, or changing the generated SOSA/QUDT model in @jeswr/solid-environment.
02 资源文件 23
- 其他biome.jsonc153 B
- 参考文档codegen/codegen.config.json2.1 KB
- 其他codegen/environment.shapes.ttl4.4 KB
- 许可证LICENSE1.0 KB
- 参考文档package.json1.9 KB
- 参考文档README.md8.6 KB
- 脚本scripts/copy-generated.mjs411 B
- 脚本src/document.ts6.8 KB
- 参考文档src/generated/codegen-manifest.json842 B
- 参考文档src/generated/codegen.lock.json434 B
- 脚本src/generated/model.d.ts6.7 KB
- 脚本src/generated/model.js14.7 KB
- 参考文档src/generated/model.json7.0 KB
- 其他src/generated/shapes.ttl9.3 KB
- 脚本src/index.ts535 B
- 脚本src/model.ts4.9 KB
- 脚本src/policy.ts3.4 KB
- 脚本src/vocab.ts2.3 KB
- 脚本test/codegen.test.ts1.2 KB
- 脚本test/model.test.ts24.6 KB
- 参考文档tsconfig.build.json220 B
- 参考文档tsconfig.json663 B
- 脚本vitest.config.ts237 B
03 SKILL.md 正文
<!-- AUTHORED-BY Codex GPT-6.1-Sol --> <!-- AUTHORED-BY Codex GPT-6 -->
Indoor environment model
Read README.md for the public API, property/unit inventory and document
bounds. The sector is in environment.ttl
and environment.shacl.ttl.
envr: properties are provisional pending maintainer review; keep the closed list.
No device API integration belongs in this package.
Generate every RDF accessor using @jeswr/federation-codegen; never edit
src/generated/. The package profile preserves all five sector shapes intact.
Read the generator skill before changing inputs;
run the codegen script with --update-lock after reviewing the input change.
The drift test must compare all regenerated artifacts byte-for-byte.
Use buildObservation(subjectIri, input) for a single root or
buildObservationDay(documentUrl, sensorIri, date, entries) for a sensor's UTC day.
The latter uses stable slug ids and many independent roots in one document, through
generated per-node wrappers. No ObservationLog vocabulary is needed. Keep one typed
quantity per observation. Sensor metadata and room builders also take exact subject
IRIs. Rooms are SOSA FeaturesOfInterest, distinct from sensor hosting Platforms.
Numeric fan/filter observations concern the purifier; text-valued modes are omitted.
Use PROPERTY, UNITS, and PROPERTY_UNITS; never invent device-specific vocabulary
or infer equivalent AQI/VOC scales. The facade checks finite values, property/unit
compatibility and timezone-qualified valid ISO times. Generated accessors enforce RDF
term kinds, datatypes, enums and singleton cardinalities. Follow actual quantity links
and require their types and all MUST fields. Keep schema.org manufacturer/model literal.
Read with parseObservations or parseObservationsTurtle; malformed records are skipped,
budget violations throw. Defaults: 2000 typed roots, 50000 total quads, 8 MiB UTF-8
Turtle. Count malformed/off-document roots too, snapshot a bounded dataset once, and
use indexed lookups. Do not add unbounded traversals or per-reading pod documents.
Use observationDocPath / sensorDocPath for safe relative paths and UTC partitioning.
Hosts own fetch, conditional writes, container creation and Type Index registration.
Run lint, dependency-first build, typecheck and tests for this package and
@jeswr/solid-federation-vocab, then pnpm run lint:root. Round-trip tests must also
validate generated data against the sector shape. Preserve coverage for unit mismatches,
malformed RDF, many roots, UTC boundaries, parse budgets and generated-file drift.
04 同仓库更多 Skills
storage-conformance
Work on @jeswr/storage-conformance, the shared storage conformance suite package in the Solid SDK workspace.
fetch-rdf-engine-tests
Maintain fetch-rdf's real Node WASM parser integration tests without introducing a reverse engine dependency in fetch-rdf.
alpha
Use when checking fixtures, including folded YAML descriptions.
widget
Use when testing package skills: YAML quoting works.
web-seo
Use when improving technical and entity SEO for a modern personal, portfolio, documentation, or marketing site, including crawlable HTML, canonical metadata, sitemap and robots, Person/ProfilePage JSON-LD, Core Web Vitals, and honest ranking expectations.
solid-wac
Use when implementing or auditing Solid server WAC authorization, ACL creation and inheritance, auxiliary-resource escalation, method-to-mode mapping, 401 versus 403 challenges, WAC-Allow, or defensive typed ACL parsing with @solid/object and @rdfjs/wrapper.