Add missing lexicon reference pages for org.hypercerts.ontology types.

[Kzoeps]

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Description: Check if the referenced lexicon types exist in the codebase and verify their current status

echo "=== Searching for org.hypercerts.ontology.celExpression ==="
rg -n "org\.hypercerts\.ontology\.celExpression" --type-add 'lexicon:*.json' --type lexicon

echo -e "\n=== Searching for org.hypercerts.ontology.workScopeTag ==="
rg -n "org\.hypercerts\.ontology\.workScopeTag" --type-add 'lexicon:*.json' --type lexicon

echo -e "\n=== Searching for org.hypercerts.claim.activity ==="
rg -n "org\.hypercerts\.claim\.activity" --type-add 'lexicon:*.json' --type lexicon

echo -e "\n=== Finding all lexicon definition files ==="
fd -e json -p lexicon

Repository: hypercerts-org/documentation

Length of output: 49050

---

🏁 Script executed:

# Search for any deprecation or outdated notices related to these lexicons
rg -i "deprecated|outdated|changed|updated" public/raw/core-concepts/cel-work-scopes.md -A 2 -B 2

# Check for version information in the file
rg "version|v1|schema" public/raw/core-concepts/cel-work-scopes.md

# Search for any TODO or FIXME comments in the documentation
rg "TODO|FIXME|XXX" public/raw/core-concepts/cel-work-scopes.md

Repository: hypercerts-org/documentation

Length of output: 978

---

🏁 Script executed:

# Check if there are any recent updates or maintenance notes in the directory
git log --oneline -n 10 public/raw/core-concepts/cel-work-scopes.md

# Look for any links to the lexicon repository or external references
rg "hypercerts-lexicon|github.com" public/raw/core-concepts/cel-work-scopes.md

Repository: hypercerts-org/documentation

Length of output: 524

---

🏁 Script executed:

# Explore the /lexicons/ directory structure
find public/lexicons -type f -name "*.md" | head -20

# Check what's in the /lexicons/ directory
ls -la public/lexicons/ 2>/dev/null || ls -la lexicons/ 2>/dev/null || find . -type d -name "lexicons" 2>/dev/null | head -5

# Look for activity-claim or cel related lexicon files
fd "activity|cel|workscope" public/lexicons --type f 2>/dev/null || fd "activity|cel|workscope" lexicons --type f 2>/dev/null

Repository: hypercerts-org/documentation

Length of output: 178

---

🏁 Script executed:

# List files in lexicon directories
echo "=== ./pages/lexicons ===" 
ls -la ./pages/lexicons/ 2>/dev/null | head -20

echo -e "\n=== ./public/raw/lexicons ===" 
ls -la ./public/raw/lexicons/ 2>/dev/null | head -20

# Search for activity, cel, or workscope files
echo -e "\n=== Files matching pattern ===" 
find ./pages/lexicons ./public/raw/lexicons -type f -name "*activity*" -o -name "*cel*" -o -name "*workscope*" 2>/dev/null

Repository: hypercerts-org/documentation

Length of output: 1068

---

🏁 Script executed:

# Read the activity-claim lexicon file to compare
echo "=== activity-claim.md content ===" 
cat ./pages/lexicons/hypercerts-lexicons/activity-claim.md

# Also check if there are separate files for celExpression or workScopeTag
echo -e "\n=== All hypercerts-lexicons files ===" 
ls -la ./pages/lexicons/hypercerts-lexicons/

Repository: hypercerts-org/documentation

Length of output: 2203

---

🏁 Script executed:

# Search for celExpression or workScopeTag in the lexicons directory
echo "=== Searching for celExpression or workScopeTag in lexicons ===" 
rg -i "celexpression|workscope" ./pages/lexicons/ ./public/raw/lexicons/

# Check the index file for what's covered
echo -e "\n=== Content of hypercerts-lexicons/index.md ===" 
cat ./pages/lexicons/hypercerts-lexicons/index.md

# List all markdown files to see what's documented
echo -e "\n=== All lexicon pages ===" 
ls -1 ./pages/lexicons/hypercerts-lexicons/*.md | xargs -I {} basename {}

Repository: hypercerts-org/documentation

Length of output: 2195

---

Add missing lexicon reference pages for org.hypercerts.ontology types.

The document references org.hypercerts.ontology.celExpression and org.hypercerts.ontology.workScopeTag, but these types are not documented in the /lexicons/hypercerts-lexicons/ section. The lexicon index lists 9 record types, none in the org.hypercerts.ontology namespace. Create dedicated lexicon pages for these types to maintain consistency with other documented record types, or remove inline schema tables and link to external lexicon definitions instead.

🧰 Tools

🪛 LanguageTool

[style] ~60-~60: This phrase is redundant. Consider writing “created”.
Context: ...ared timestamp when this expression was originally created. | ### `org.hypercerts.ontology.workSc...

(ORIGINALLY_CREATED)

---

[style] ~78-~78: This phrase is redundant. Consider writing “created”.
Context: ...declared timestamp when this record was originally created. | ### activity.workScope union The...

(ORIGINALLY_CREATED)

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@public/raw/core-concepts/cel-work-scopes.md` around lines 51 - 86, The
document embeds schema tables for org.hypercerts.ontology.celExpression and
org.hypercerts.ontology.workScopeTag but there are no corresponding lexicon
pages in the /lexicons/hypercerts-lexicons/ index; either add lexicon files for
these two types (create lexicon pages named
org.hypercerts.ontology.celExpression and org.hypercerts.ontology.workScopeTag
containing the same field definitions and metadata and update the lexicon index
to include them) or remove the inline schema tables from this page and replace
them with links to the external lexicon definitions (update references around
activity.workScope to point to the new lexicon pages if you add them).

Originally posted by @coderabbitai[bot] in #110 (comment)