oh-my-opencode 4.9.2 → 4.11.0

package/packages/omo-codex/plugin/skills/ast-grep/tests/smoke.ps1

@@ -0,0 +1,123 @@
+#Requires -Version 5.1
+# Smoke test for the ast-grep skill on Windows (PowerShell 5.1+).
+$ErrorActionPreference = 'Stop'
+
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$SkillDir  = Split-Path -Parent $ScriptDir
+$Helper    = Join-Path $SkillDir 'scripts/ast_grep_helper.py'
+$Python    = if (Get-Command py -ErrorAction SilentlyContinue) { 'py' } else { 'python' }
+
+$Output = Join-Path $env:TEMP ("ast-grep-skill-smoke-" + [guid]::NewGuid().ToString('N').Substring(0,8))
+New-Item -ItemType Directory -Path $Output -Force | Out-Null
+
+function Pass([string]$msg) { Write-Host "PASS: $msg" }
+function Fail([string]$msg) { Write-Host "FAIL: $msg" -ForegroundColor Red; Remove-Item -Recurse -Force $Output -ErrorAction SilentlyContinue; exit 1 }
+
+function Run([string[]]$Args) {
+    $stdoutFile = Join-Path $Output ("out-" + [guid]::NewGuid().ToString('N').Substring(0,8) + ".txt")
+    $proc = Start-Process -FilePath $Python -ArgumentList (@($Helper) + $Args) -NoNewWindow -PassThru -Wait -RedirectStandardOutput $stdoutFile -RedirectStandardError "$stdoutFile.err"
+    $stdout = if (Test-Path $stdoutFile) { Get-Content $stdoutFile -Raw } else { '' }
+    $stderr = if (Test-Path "$stdoutFile.err") { Get-Content "$stdoutFile.err" -Raw } else { '' }
+    return [pscustomobject]@{
+        ExitCode = $proc.ExitCode
+        Stdout = $stdout
+        Stderr = $stderr
+        Combined = "$stdout`n$stderr"
+    }
+}
+
+try {
+    # 1. --version
+    $r = Run @('--version')
+    if ($r.Combined -notmatch 'ast-grep-helper') { Fail '--version output missing' }
+    Pass '--version'
+
+    # 2. langs (must list >=25)
+    $r = Run @('langs')
+    $langCount = ($r.Stdout -split "`n" | Where-Object { $_ -match '^  [a-z]' }).Count
+    if ($langCount -lt 25) { Fail "langs listed only $langCount (expected >=25)" }
+    Pass 'langs lists at least 25 languages'
+
+    # 3. regex misuse: \w+
+    $r = Run @('validate', '\w+', '--lang', 'ts')
+    if ($r.ExitCode -ne 2) { Fail "validate '\w+' should exit 2, got $($r.ExitCode)" }
+    if ($r.Combined -notmatch 'regex') { Fail "validate '\w+' should mention regex" }
+    Pass 'validate detects \w regex misuse'
+
+    # 4. valid pattern
+    $r = Run @('validate', 'console.log($MSG)', '--lang', 'ts')
+    if ($r.ExitCode -ne 0) { Fail "validate 'console.log(`$MSG)' should exit 0, got $($r.ExitCode)" }
+    Pass 'validate accepts plausible pattern'
+
+    # 5. Python trailing colon
+    $r = Run @('validate', 'def $F($$$):', '--lang', 'py')
+    if ($r.ExitCode -ne 2) { Fail "validate 'def `$F(`$`$`$):' should exit 2, got $($r.ExitCode)" }
+    if ($r.Combined -notmatch 'colon|trailing') { Fail 'validate should mention trailing colon' }
+    Pass 'validate detects Python trailing colon'
+
+    # 6. Incomplete TS function
+    $r = Run @('validate', 'function $N', '--lang', 'ts')
+    if ($r.ExitCode -ne 2) { Fail "validate 'function `$N' should exit 2, got $($r.ExitCode)" }
+    if ($r.Combined -notmatch 'incomplete|params|body') { Fail 'validate should hint about params/body' }
+    Pass 'validate detects incomplete TS function'
+
+    # 7. Alternation pipe
+    $r = Run @('validate', 'foo|bar', '--lang', 'ts')
+    if ($r.ExitCode -ne 2) { Fail "validate 'foo|bar' should exit 2, got $($r.ExitCode)" }
+    if ($r.Combined -notmatch 'alternation|regex') { Fail 'validate should mention alternation' }
+    Pass 'validate detects literal | alternation'
+
+    # 8. doctor
+    $r = Run @('doctor')
+    if ($r.Combined -notmatch 'ast-grep-helper') { Fail 'doctor missing helper version line' }
+    Pass 'doctor produces output'
+
+    # 9. search w/o binary
+    $r = Run @('-q', 'search', 'foo()', '--lang', 'ts', 'C:/nonexistent-path-xyzzy')
+    switch ($r.ExitCode) {
+        { $_ -in 0,1,4 } { Pass "search runs (rc=$($r.ExitCode), ast-grep available)" }
+        3 {
+            if ($r.Combined -notmatch 'install') { Fail 'search rc=3 should print install hint' }
+            Pass 'search without binary prints install hint'
+        }
+        default { Fail "search returned unexpected rc=$($r.ExitCode): $($r.Combined)" }
+    }
+
+    # 10. install.ps1 syntax (parse-check via PowerShell tokenizer)
+    $tokens = $null
+    $errors = $null
+    [System.Management.Automation.Language.Parser]::ParseFile(
+        (Join-Path $SkillDir 'install.ps1'), [ref]$tokens, [ref]$errors) | Out-Null
+    if ($errors -and $errors.Count -gt 0) { Fail "install.ps1 has parse errors: $($errors -join '; ')" }
+    Pass 'install.ps1 parses cleanly'
+
+    # 11. SKILL.md frontmatter
+    $skill = Get-Content (Join-Path $SkillDir 'SKILL.md') -Raw
+    if (-not $skill.StartsWith("---`n") -and -not $skill.StartsWith("---`r`n")) {
+        Fail 'SKILL.md must start with YAML frontmatter'
+    }
+    $endIdx = $skill.IndexOf("`n---`n", 4)
+    if ($endIdx -lt 0) { $endIdx = $skill.IndexOf("`r`n---`r`n", 4) }
+    if ($endIdx -lt 0) { Fail 'SKILL.md missing closing ---' }
+    $fm = $skill.Substring(4, $endIdx - 4)
+    if ($fm -notmatch '(?m)^name:\s*ast-grep\s*$') { Fail 'frontmatter missing name: ast-grep' }
+    if ($fm -notmatch '(?m)^description:') { Fail 'frontmatter missing description' }
+    Pass 'SKILL.md frontmatter shape'
+
+    # 12. All required reference files exist
+    $required = @(
+        'references/install.md', 'references/patterns.md', 'references/pitfalls.md',
+        'references/recipes.md', 'references/cli.md', 'references/yaml-rules.md',
+        'references/sgconfig.md'
+    )
+    foreach ($f in $required) {
+        if (-not (Test-Path (Join-Path $SkillDir $f))) { Fail "missing $f" }
+    }
+    Pass 'all references present'
+
+    Write-Host ''
+    Write-Host 'all smoke tests passed'
+}
+finally {
+    Remove-Item -Recurse -Force $Output -ErrorAction SilentlyContinue
+}

package/packages/omo-codex/plugin/skills/ast-grep/tests/smoke.sh

@@ -0,0 +1,212 @@
+#!/usr/bin/env bash
+# Smoke test for the ast-grep skill on POSIX (macOS / Linux / WSL / Git Bash).
+#
+# Tests:
+#   1. helper --version
+#   2. helper langs                              (lists 25 languages)
+#   3. helper validate '\w+' --lang ts           (must exit 2 with hint)
+#   4. helper validate 'console.log($MSG)'       (must exit 0 plausible)
+#   5. helper validate 'def $F($$$):' --lang py  (must exit 2 - trailing colon)
+#   6. helper validate 'function $N' --lang ts   (must exit 2 - incomplete)
+#   7. helper validate 'foo|bar' --lang ts       (must exit 2 - alternation)
+#   8. helper doctor                             (informational; tolerates no-binary)
+#   9. helper search w/o binary => exit 3 with install hint
+#  10. install.sh --help                         (parses)
+#  11. SKILL.md frontmatter shape                (canonical)
+#
+# Runs against the helper using ONLY stdlib python3 - no ast-grep needed.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+SKILL_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+HELPER="python3 $SKILL_DIR/scripts/ast_grep_helper.py"
+
+OUTPUT_DIR="$(mktemp -d -t ast-grep-skill-smoke-XXXXXX)"
+trap 'rm -rf "$OUTPUT_DIR"' EXIT
+
+fail() { echo "FAIL: $*" >&2; exit 1; }
+pass() { echo "PASS: $*"; }
+
+omo_runtime_slug() {
+  case "$(uname -s)" in
+    Darwin) local os_slug="darwin" ;;
+    MINGW*|MSYS*|CYGWIN*) local os_slug="win32" ;;
+    *) local os_slug="linux" ;;
+  esac
+
+  case "$(uname -m | tr '[:upper:]' '[:lower:]')" in
+    arm64|aarch64) local arch_slug="arm64" ;;
+    *) local arch_slug="x64" ;;
+  esac
+
+  printf '%s-%s' "$os_slug" "$arch_slug"
+}
+
+fake_sg() {
+  local target="$1"
+  mkdir -p "$(dirname "$target")"
+  cat > "$target" <<'SH'
+#!/usr/bin/env bash
+if [ "${1:-}" = "--version" ]; then
+  printf 'ast-grep 0.43.0 fake\n'
+else
+  printf 'fake ast-grep\n'
+fi
+SH
+  chmod +x "$target"
+}
+
+# 1. --version
+$HELPER --version | grep -q "ast-grep-helper" || fail "--version output missing"
+pass "--version"
+
+# 2. langs (must list 25)
+LANG_LINES=$($HELPER langs | grep -E '^  [a-z]' | wc -l | tr -d ' ')
+[ "$LANG_LINES" -ge 25 ] || fail "langs listed only $LANG_LINES (expected >=25)"
+pass "langs lists at least 25 languages"
+
+# 3. regex misuse: \w+
+set +e
+$HELPER validate '\w+' --lang ts > "$OUTPUT_DIR/v1.out" 2>&1
+RC=$?
+set -e
+[ $RC -eq 2 ] || fail "validate '\\w+' should exit 2, got $RC (output: $(cat $OUTPUT_DIR/v1.out))"
+grep -qi 'regex' "$OUTPUT_DIR/v1.out" || fail "validate '\\w+' should mention regex (output: $(cat $OUTPUT_DIR/v1.out))"
+pass "validate detects \\w regex misuse"
+
+# 4. valid pattern
+set +e
+$HELPER validate 'console.log($MSG)' --lang ts > "$OUTPUT_DIR/v2.out" 2>&1
+RC=$?
+set -e
+[ $RC -eq 0 ] || fail "validate 'console.log(\$MSG)' should exit 0, got $RC (output: $(cat $OUTPUT_DIR/v2.out))"
+pass "validate accepts plausible pattern"
+
+# 5. Python trailing colon
+set +e
+$HELPER validate 'def $F($$$):' --lang py > "$OUTPUT_DIR/v3.out" 2>&1
+RC=$?
+set -e
+[ $RC -eq 2 ] || fail "validate 'def \$F(\$\$\$):' should exit 2, got $RC"
+grep -qi 'colon\|trailing' "$OUTPUT_DIR/v3.out" || fail "validate should mention trailing colon"
+pass "validate detects Python trailing colon"
+
+# 6. Incomplete TS function
+set +e
+$HELPER validate 'function $N' --lang ts > "$OUTPUT_DIR/v4.out" 2>&1
+RC=$?
+set -e
+[ $RC -eq 2 ] || fail "validate 'function \$N' should exit 2, got $RC"
+grep -qi 'incomplete\|params\|body' "$OUTPUT_DIR/v4.out" || fail "validate should hint about params/body"
+pass "validate detects incomplete TS function"
+
+# 7. Alternation pipe
+set +e
+$HELPER validate 'foo|bar' --lang ts > "$OUTPUT_DIR/v5.out" 2>&1
+RC=$?
+set -e
+[ $RC -eq 2 ] || fail "validate 'foo|bar' should exit 2, got $RC"
+grep -qi 'alternation\|regex' "$OUTPUT_DIR/v5.out" || fail "validate should mention alternation"
+pass "validate detects literal | alternation"
+
+# 8. doctor (informational)
+$HELPER doctor > "$OUTPUT_DIR/doc.out" 2>&1 || true
+grep -q "ast-grep-helper" "$OUTPUT_DIR/doc.out" || fail "doctor missing helper version line"
+pass "doctor produces output"
+
+# Given OMO_AST_GREP_SG_PATH points at a fake executable.
+# When doctor resolves ast-grep, then it reports that exact path.
+FAKE_ENV_SG="$OUTPUT_DIR/fake-env/sg"
+fake_sg "$FAKE_ENV_SG"
+OMO_AST_GREP_SG_PATH="$FAKE_ENV_SG" $HELPER doctor > "$OUTPUT_DIR/omo-env.out" 2>&1
+grep -Fq "ast-grep binary: $FAKE_ENV_SG" "$OUTPUT_DIR/omo-env.out" || fail "OMO_AST_GREP_SG_PATH was not preferred: $(cat "$OUTPUT_DIR/omo-env.out")"
+pass "OMO_AST_GREP_SG_PATH resolves first"
+
+# Given HOME has an OMO runtime sg executable.
+# When doctor resolves ast-grep, then it reports the HOME runtime path.
+RUNTIME_HOME="$OUTPUT_DIR/home"
+RUNTIME_SLUG="$(omo_runtime_slug)"
+RUNTIME_BIN="sg"
+case "$RUNTIME_SLUG" in
+  win32-*) RUNTIME_BIN="sg.exe" ;;
+esac
+FAKE_RUNTIME_SG="$RUNTIME_HOME/.omo/runtime/ast-grep/$RUNTIME_SLUG/$RUNTIME_BIN"
+fake_sg "$FAKE_RUNTIME_SG"
+HOME="$RUNTIME_HOME" CODEX_HOME= OMO_AST_GREP_SG_PATH= $HELPER doctor > "$OUTPUT_DIR/omo-runtime.out" 2>&1
+grep -Fq "ast-grep binary: $FAKE_RUNTIME_SG" "$OUTPUT_DIR/omo-runtime.out" || fail "OMO HOME runtime was not resolved: $(cat "$OUTPUT_DIR/omo-runtime.out")"
+pass "OMO HOME runtime resolves before standalone fallback"
+
+# 9. search w/o binary => either runs successfully (binary found) OR exits 3 with hint
+# The CI may or may not have ast-grep installed; both are valid.
+set +e
+$HELPER -q search 'foo()' --lang ts /nonexistent-path-xyzzy > "$OUTPUT_DIR/s1.out" 2>&1
+RC=$?
+set -e
+case "$RC" in
+  0|1|4)
+    # Binary present but no matches OR sg returned non-fatal error - both fine
+    pass "search runs (rc=$RC, ast-grep available)"
+    ;;
+  3)
+    grep -qi 'install' "$OUTPUT_DIR/s1.out" || fail "search rc=3 should print install hint"
+    pass "search without binary prints install hint"
+    ;;
+  *)
+    fail "search returned unexpected rc=$RC: $(cat $OUTPUT_DIR/s1.out)"
+    ;;
+esac
+
+# 10. install.sh syntax check + --help
+bash -n "$SKILL_DIR/install.sh" || fail "install.sh has syntax errors"
+$SKILL_DIR/install.sh --help > "$OUTPUT_DIR/inst.out" 2>&1 || true
+grep -qi 'install' "$OUTPUT_DIR/inst.out" || fail "install.sh --help missing keyword 'install'"
+pass "install.sh syntax + --help"
+
+# 11. SKILL.md frontmatter
+python3 - <<PY
+import re, sys
+src = open("$SKILL_DIR/SKILL.md").read()
+assert src.startswith("---\n"), "SKILL.md must start with YAML frontmatter"
+end = src.find("\n---\n", 4)
+assert end > 0, "SKILL.md missing closing ---"
+fm = src[4:end]
+assert re.search(r"^name:\s*ast-grep\s*$", fm, re.M), "frontmatter missing name: ast-grep"
+assert re.search(r"^description:", fm, re.M), "frontmatter missing description"
+PY
+pass "SKILL.md frontmatter shape"
+
+# 12. All required reference files exist
+for f in references/install.md references/patterns.md references/pitfalls.md \
+         references/recipes.md references/cli.md references/yaml-rules.md \
+         references/sgconfig.md; do
+  test -f "$SKILL_DIR/$f" || fail "missing $f"
+done
+pass "all references present"
+
+python3 - "$SKILL_DIR" <<'PY' || fail "Korean characters found in skill content"
+import pathlib, re, sys
+root = pathlib.Path(sys.argv[1])
+hangul = re.compile(r"[\uac00-\ud7a3]")
+targets = [root / "SKILL.md", root / "README.md"]
+for d in ("references", "scripts", "tests", ".github"):
+    targets.extend((root / d).rglob("*"))
+targets.extend([root / "install.sh", root / "install.ps1"])
+hits = 0
+for p in targets:
+    if not p.is_file():
+        continue
+    try:
+        text = p.read_text(encoding="utf-8")
+    except (UnicodeDecodeError, OSError):
+        continue
+    for n, line in enumerate(text.splitlines(), 1):
+        if hangul.search(line):
+            print(f"{p}:{n}: {line.rstrip()}")
+            hits += 1
+sys.exit(1 if hits else 0)
+PY
+pass "no Korean in skill content"
+
+echo ""
+echo "all smoke tests passed"

package/packages/omo-codex/plugin/skills/frontend/ATTRIBUTION.md

@@ -0,0 +1,127 @@
+# ATTRIBUTION / NOTICE
+
+This package (`@oh-my-opencode/shared-skills`) includes third-party content that is
+redistributed under its original license, consistent with the project's distribution
+license (see `LICENSE.md`: "All third party components incorporated into the
+oh-my-opencode Software are licensed under the original license provided by the owner of
+the applicable component"). Each upstream's license and required notices are reproduced
+below. Modifications to the original files are noted where applicable.
+
+---
+
+## 1. Open Design (brand design-system DESIGN.md references)
+
+The brand design-system reference files under `frontend/references/design/<brand>.md`
+(Apple, Stripe, Linear, Nike, BMW, Airbnb, Bugatti, Tesla, and the other named brands)
+are condensed/adapted derivatives of the `design-systems/<brand>/DESIGN.md` files from the
+Open Design project.
+
+- Source: https://github.com/nexu-io/open-design
+- Copyright 2026 Open Design contributors
+- Licensed under the Apache License, Version 2.0 (the "License"); you may not use these
+  files except in compliance with the License. You may obtain a copy of the License at:
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software distributed under
+  the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied. See the License for the specific language governing
+  permissions and limitations under the License. A full copy of the Apache-2.0 license
+  text is provided in `LICENSE-Apache-2.0.txt` alongside this notice.
+
+- **Changes (Apache-2.0 §4(b)):** the original `DESIGN.md` design-system files have been
+  condensed/adapted from the Open Design project for use as frontend skill references.
+  Specifically, the leading "> Category: ..." blockquote was removed and the documents were
+  shortened into derivative single-file brand references.
+
+- **Trademark notice:** All product names, brand names, trademarks, and registered
+  trademarks referenced in these design-system files (e.g. Apple, BMW, Airbnb, Bugatti,
+  Stripe, Nike, Tesla, and other named brands) are the property of their respective owners
+  and are used for identification and descriptive purposes only. This project is not
+  affiliated with, endorsed by, or sponsored by any of those brands. No trademark license
+  is granted under the Apache License 2.0 (Section 6). Named typefaces are referenced by
+  name only; no font binaries are included.
+
+---
+
+## 2. taste-skill (Leonxlnx) — taste and image-generation skills
+
+The taste-skill files and image-generation skills under `frontend/references/design/`
+(`taste-skill.md`, `gpt-tasteskill.md`, `minimalist-skill.md`, `brutalist-skill.md`,
+`soft-skill.md`, `redesign-skill.md`, `image-to-code-skill.md`, `output-skill.md`,
+`stitch-skill.md`, `imagegen-frontend-web.md`, `imagegen-frontend-mobile.md`,
+`imagegen-brandkit.md`) are derived from the taste-skill project.
+
+- Source: https://github.com/Leonxlnx/taste-skill
+
+```
+MIT License
+
+Copyright (c) 2026 Leonxlnx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+---
+
+## 3. UI/UX Pro Max — Design Intelligence Skill (Next Level Builder) — ui-ux-db
+
+The search engine and dataset under `frontend/references/ui-ux-db/` (`scripts/core.py`,
+`scripts/search.py`, `scripts/design_system.py`, `README.md`, and the `data/*.csv`
+knowledge base) are derived from the UI/UX Pro Max skill.
+
+- Source: https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
+- "UI/UX Pro Max" is the upstream project's branding; no trademark rights are granted by
+  the MIT license, and this distribution does not claim that name as its own.
+
+```
+MIT License
+
+Copyright (c) 2024 Next Level Builder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+---
+
+## 4. Project-original files
+
+`frontend/SKILL.md`, `frontend/references/design/README.md`, `_INDEX.md`,
+`design-system-architecture.md`, `react-dev-tooling-skill.md`,
+`frontend/references/perfection/README.md`, `react-perf-tooling.md`, and
+`frontend/scripts/perfection/lighthouse-audit.py` are original to this project and require
+no third-party attribution. The perfection docs and script only invoke third-party tools
+(react-scan, react-doctor, react-grab, playwright-lighthouse, lighthouse, chrome-launcher)
+at runtime; no source from those tools is vendored, so their licenses are not carried here.

package/packages/omo-codex/plugin/skills/frontend/LICENSE-Apache-2.0.txt

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Support. While redistributing the Work or
+      Derivative Works thereof, You may choose to offer, and charge a
+      fee for, acceptance of support, warranty, indemnity, or other
+      liability obligations and/or rights consistent with this License.
+      However, in accepting such obligations, You may act only on Your
+      own behalf and on Your sole responsibility, not on behalf of any
+      other Contributor, and only if You agree to indemnify, defend,
+      and hold each Contributor harmless for any liability incurred by,
+      or claims asserted against, such Contributor by reason of your
+      accepting any such warranty or support.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Open Design contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.