Retire the shared-drift gate — the copy it policed is being deleted#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
brentrager merged 1 commit into from
Aug 26, 2026
Merged

Retire the shared-drift gate — the copy it policed is being deleted #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
44 changes: 9 additions & 35 deletions .github/workflows/rust.yml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,14 @@
name: Rust

# This repo shipped with no CI at all — `.github/` held only banner images — so
# a change could land unbuilt, and `shared/` could drift from SmooAI/client-shared
# without anything saying so. It did: SmooAI/client-shared spent weeks serving the
# pre-f230808 monogram (no inner 'S', no dot) because that fix never crossed.
# This repo shipped with no CI at all — `.github/` held only banner images — so a
# change could land unbuilt.
#
# It also used to carry a `shared-drift` job, because SmooAI/client-shared kept a
# byte-identical copy of `shared/` and the two silently diverged: client-shared
# spent weeks serving the pre-f230808 monogram (no inner 'S', no dot) because that
# fix never crossed. That copy is gone — client-shared is an auth library now, and
# nothing imported its `ui` module — so this repo is the single source of the
# design system and there is nothing left to drift against.

on:
pull_request:
Expand DownExpand Up@@ -47,34 +52,3 @@ jobs:
# never compiles and no other check can see it.
- name: Every .rs file is reachable from the module tree
run: python3 scripts/check-module-tree.py

shared-drift:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# SmooAI/client-shared owns the design system; this repo carries a copy for
# its own consumers. The gate is deliberately ONE-directional — client-shared
# is ungated, so a design change lands there first and this repo follows.
# A bidirectional gate would deadlock: neither PR could go green until the
# other merged.
#
# Compares git blob SHAs from the GitHub contents API against `git ls-tree`,
# so added and deleted files are caught as well as edited ones — no
# hand-maintained filename list to fall behind.
- name: shared/ must match SmooAI/client-shared
run: |
set -euo pipefail
curl -fsSL "https://api.github.com/repos/SmooAI/client-shared/contents/shared?ref=main" \
| python3 -c 'import json,sys; [print(e["sha"], e["name"]) for e in sorted(json.load(sys.stdin), key=lambda e: e["name"])]' \
> /tmp/upstream.txt
git ls-tree HEAD shared/ --format='%(objectname) %(path)' \
| sed 's| shared/| |' | sort -k2 > /tmp/local.txt
if ! diff -u --label "SmooAI/client-shared@main" /tmp/upstream.txt --label "this repo" /tmp/local.txt; then
echo "::error::shared/ has drifted from SmooAI/client-shared, which owns the design system."
echo "Land the change in SmooAI/client-shared first, then copy shared/ across:"
echo " for f in \$(git ls-tree --name-only HEAD shared/); do"
echo " curl -fsSL \"https://raw.githubusercontent.com/SmooAI/client-shared/main/\$f\" -o \"\$f\""
echo " done"
exit 1
fi
echo "✓ shared/ matches SmooAI/client-shared@main"
24 changes: 6 additions & 18 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -168,25 +168,13 @@ The honest per-language picture — one binding exists, the rest are direction,

## Relationship to client-shared

**[`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) owns the design system. This repo carries a gated copy.**
**This repo owns the design system. [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) is an auth library and carries no copy of it.**

client-shared declares itself this crate's successor and is what the [`th` CLI](https://github.com/SmooAI/smooth) ships in production. This repo keeps `shared/` for its own consumers (`observability-studio`, smooblue), and CI **fails if the two diverge** — `shared-drift` compares every blob in `shared/` against `SmooAI/client-shared@main`.
It used to. client-shared declared itself this crate's successor and kept a byte-identical `shared/`, with a CI gate here failing if the two diverged. That arrangement is retired: an org-wide search found **nothing imported `client_shared::ui`** — its only consumer, the [`th` CLI](https://github.com/SmooAI/smooth), builds `features = ["auth"]` and never touched the design half. So the duplicate was deleted at the source rather than policed forever, and the gate went with it.

The gate is deliberately **one-directional**: client-shared is ungated, so a design change lands there first and this repo follows. A bidirectional gate would deadlock, with neither repo's PR able to go green until the other merged.
> The duplication was not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and its `styles.css` lost the whole `.input` family. Nothing was red. Deleting the copy removes the failure mode instead of detecting it.

Why a gate and not a cargo dependency on client-shared? Both crates are git dependencies rather than crates.io publishes, so depending across would put two independently rev-pinned git deps in one graph for any consumer that wants both. The gate closes the silent-divergence hole without the coupling.

> This is not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and `styles.css` lost the whole `.input` family. Nothing was red. That is the defect this gate exists to prevent.

To sync after a change lands upstream:

```bash
for f in $(git ls-tree --name-only HEAD shared/); do
curl -fsSL "https://raw.githubusercontent.com/SmooAI/client-shared/main/$f" -o "$f"
done
```

If you need only the design system, either crate works — the `ui` surface is identical (`smooai_ui::STYLES` ⇄ `smooai_client_shared::ui::STYLES`).
Design changes land here, and only here. Consumers today are [`observability-studio`](https://github.com/SmooAI/observability) and [smooblue](https://github.com/SmooAI/smooblue).

## Versioning

Expand All@@ -203,11 +191,11 @@ Per-language packages share the same semver line so consumers can correlate vers
`@smooai/ui` is built and open-sourced by **[Smoo AI](https://smoo.ai)** — the AI-powered business platform with AI built into every product: CRM, customer support, campaigns, field service, observability, and developer tools.

- 🧰 **More open source from Smoo AI** — [smoo.ai/open-source](https://smoo.ai/open-source)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (this crate's superset), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (auth for the `th` CLI), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)

## 🤝 Contributing

PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land in [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) first**; this repo's `shared/` is a gated copy and CI rejects a divergent one. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.
PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land here** — this repois the single source. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.

## 📄 License

Expand Down
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all \u003cpre\u003e\u003ccode\u003e blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks"); } } catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); } })(); (function(){ try { var __m = "github.com"; var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Retire the shared-drift gate — the copy it policed is being deleted#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
brentrager merged 1 commit into from
Aug 26, 2026
Merged

Retire the shared-drift gate — the copy it policed is being deleted #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
44 changes: 9 additions & 35 deletions .github/workflows/rust.yml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,14 @@
name: Rust

# This repo shipped with no CI at all — `.github/` held only banner images — so
# a change could land unbuilt, and `shared/` could drift from SmooAI/client-shared
# without anything saying so. It did: SmooAI/client-shared spent weeks serving the
# pre-f230808 monogram (no inner 'S', no dot) because that fix never crossed.
# This repo shipped with no CI at all — `.github/` held only banner images — so a
# change could land unbuilt.
#
# It also used to carry a `shared-drift` job, because SmooAI/client-shared kept a
# byte-identical copy of `shared/` and the two silently diverged: client-shared
# spent weeks serving the pre-f230808 monogram (no inner 'S', no dot) because that
# fix never crossed. That copy is gone — client-shared is an auth library now, and
# nothing imported its `ui` module — so this repo is the single source of the
# design system and there is nothing left to drift against.

on:
pull_request:
Expand DownExpand Up@@ -47,34 +52,3 @@ jobs:
# never compiles and no other check can see it.
- name: Every .rs file is reachable from the module tree
run: python3 scripts/check-module-tree.py

shared-drift:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# SmooAI/client-shared owns the design system; this repo carries a copy for
# its own consumers. The gate is deliberately ONE-directional — client-shared
# is ungated, so a design change lands there first and this repo follows.
# A bidirectional gate would deadlock: neither PR could go green until the
# other merged.
#
# Compares git blob SHAs from the GitHub contents API against `git ls-tree`,
# so added and deleted files are caught as well as edited ones — no
# hand-maintained filename list to fall behind.
- name: shared/ must match SmooAI/client-shared
run: |
set -euo pipefail
curl -fsSL "https://api.github.com/repos/SmooAI/client-shared/contents/shared?ref=main" \
| python3 -c 'import json,sys; [print(e["sha"], e["name"]) for e in sorted(json.load(sys.stdin), key=lambda e: e["name"])]' \
> /tmp/upstream.txt
git ls-tree HEAD shared/ --format='%(objectname) %(path)' \
| sed 's| shared/| |' | sort -k2 > /tmp/local.txt
if ! diff -u --label "SmooAI/client-shared@main" /tmp/upstream.txt --label "this repo" /tmp/local.txt; then
echo "::error::shared/ has drifted from SmooAI/client-shared, which owns the design system."
echo "Land the change in SmooAI/client-shared first, then copy shared/ across:"
echo " for f in \$(git ls-tree --name-only HEAD shared/); do"
echo " curl -fsSL \"https://raw.githubusercontent.com/SmooAI/client-shared/main/\$f\" -o \"\$f\""
echo " done"
exit 1
fi
echo "✓ shared/ matches SmooAI/client-shared@main"
24 changes: 6 additions & 18 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -168,25 +168,13 @@ The honest per-language picture — one binding exists, the rest are direction,

## Relationship to client-shared

**[`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) owns the design system. This repo carries a gated copy.**
**This repo owns the design system. [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) is an auth library and carries no copy of it.**

client-shared declares itself this crate's successor and is what the [`th` CLI](https://github.com/SmooAI/smooth) ships in production. This repo keeps `shared/` for its own consumers (`observability-studio`, smooblue), and CI **fails if the two diverge** — `shared-drift` compares every blob in `shared/` against `SmooAI/client-shared@main`.
It used to. client-shared declared itself this crate's successor and kept a byte-identical `shared/`, with a CI gate here failing if the two diverged. That arrangement is retired: an org-wide search found **nothing imported `client_shared::ui`** — its only consumer, the [`th` CLI](https://github.com/SmooAI/smooth), builds `features = ["auth"]` and never touched the design half. So the duplicate was deleted at the source rather than policed forever, and the gate went with it.

The gate is deliberately **one-directional**: client-shared is ungated, so a design change lands there first and this repo follows. A bidirectional gate would deadlock, with neither repo's PR able to go green until the other merged.
> The duplication was not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and its `styles.css` lost the whole `.input` family. Nothing was red. Deleting the copy removes the failure mode instead of detecting it.

Why a gate and not a cargo dependency on client-shared? Both crates are git dependencies rather than crates.io publishes, so depending across would put two independently rev-pinned git deps in one graph for any consumer that wants both. The gate closes the silent-divergence hole without the coupling.

> This is not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and `styles.css` lost the whole `.input` family. Nothing was red. That is the defect this gate exists to prevent.

To sync after a change lands upstream:

```bash
for f in $(git ls-tree --name-only HEAD shared/); do
curl -fsSL "https://raw.githubusercontent.com/SmooAI/client-shared/main/$f" -o "$f"
done
```

If you need only the design system, either crate works — the `ui` surface is identical (`smooai_ui::STYLES` ⇄ `smooai_client_shared::ui::STYLES`).
Design changes land here, and only here. Consumers today are [`observability-studio`](https://github.com/SmooAI/observability) and [smooblue](https://github.com/SmooAI/smooblue).

## Versioning

Expand All@@ -203,11 +191,11 @@ Per-language packages share the same semver line so consumers can correlate vers
`@smooai/ui` is built and open-sourced by **[Smoo AI](https://smoo.ai)** — the AI-powered business platform with AI built into every product: CRM, customer support, campaigns, field service, observability, and developer tools.

- 🧰 **More open source from Smoo AI** — [smoo.ai/open-source](https://smoo.ai/open-source)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (this crate's superset), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (auth for the `th` CLI), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)

## 🤝 Contributing

PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land in [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) first**; this repo's `shared/` is a gated copy and CI rejects a divergent one. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.
PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land here** — this repois the single source. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.

## 📄 License

Expand Down
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Retire the shared-drift gate — the copy it policed is being deleted#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
brentrager merged 1 commit into from
Aug 26, 2026
Merged

Retire the shared-drift gate — the copy it policed is being deleted #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
44 changes: 9 additions & 35 deletions .github/workflows/rust.yml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,14 @@
name: Rust

# This repo shipped with no CI at all — `.github/` held only banner images — so
# a change could land unbuilt, and `shared/` could drift from SmooAI/client-shared
# without anything saying so. It did: SmooAI/client-shared spent weeks serving the
# pre-f230808 monogram (no inner 'S', no dot) because that fix never crossed.
# This repo shipped with no CI at all — `.github/` held only banner images — so a
# change could land unbuilt.
#
# It also used to carry a `shared-drift` job, because SmooAI/client-shared kept a
# byte-identical copy of `shared/` and the two silently diverged: client-shared
# spent weeks serving the pre-f230808 monogram (no inner 'S', no dot) because that
# fix never crossed. That copy is gone — client-shared is an auth library now, and
# nothing imported its `ui` module — so this repo is the single source of the
# design system and there is nothing left to drift against.

on:
pull_request:
Expand DownExpand Up@@ -47,34 +52,3 @@ jobs:
# never compiles and no other check can see it.
- name: Every .rs file is reachable from the module tree
run: python3 scripts/check-module-tree.py

shared-drift:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# SmooAI/client-shared owns the design system; this repo carries a copy for
# its own consumers. The gate is deliberately ONE-directional — client-shared
# is ungated, so a design change lands there first and this repo follows.
# A bidirectional gate would deadlock: neither PR could go green until the
# other merged.
#
# Compares git blob SHAs from the GitHub contents API against `git ls-tree`,
# so added and deleted files are caught as well as edited ones — no
# hand-maintained filename list to fall behind.
- name: shared/ must match SmooAI/client-shared
run: |
set -euo pipefail
curl -fsSL "https://api.github.com/repos/SmooAI/client-shared/contents/shared?ref=main" \
| python3 -c 'import json,sys; [print(e["sha"], e["name"]) for e in sorted(json.load(sys.stdin), key=lambda e: e["name"])]' \
> /tmp/upstream.txt
git ls-tree HEAD shared/ --format='%(objectname) %(path)' \
| sed 's| shared/| |' | sort -k2 > /tmp/local.txt
if ! diff -u --label "SmooAI/client-shared@main" /tmp/upstream.txt --label "this repo" /tmp/local.txt; then
echo "::error::shared/ has drifted from SmooAI/client-shared, which owns the design system."
echo "Land the change in SmooAI/client-shared first, then copy shared/ across:"
echo " for f in \$(git ls-tree --name-only HEAD shared/); do"
echo " curl -fsSL \"https://raw.githubusercontent.com/SmooAI/client-shared/main/\$f\" -o \"\$f\""
echo " done"
exit 1
fi
echo "✓ shared/ matches SmooAI/client-shared@main"
24 changes: 6 additions & 18 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -168,25 +168,13 @@ The honest per-language picture — one binding exists, the rest are direction,

## Relationship to client-shared

**[`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) owns the design system. This repo carries a gated copy.**
**This repo owns the design system. [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) is an auth library and carries no copy of it.**

client-shared declares itself this crate's successor and is what the [`th` CLI](https://github.com/SmooAI/smooth) ships in production. This repo keeps `shared/` for its own consumers (`observability-studio`, smooblue), and CI **fails if the two diverge** — `shared-drift` compares every blob in `shared/` against `SmooAI/client-shared@main`.
It used to. client-shared declared itself this crate's successor and kept a byte-identical `shared/`, with a CI gate here failing if the two diverged. That arrangement is retired: an org-wide search found **nothing imported `client_shared::ui`** — its only consumer, the [`th` CLI](https://github.com/SmooAI/smooth), builds `features = ["auth"]` and never touched the design half. So the duplicate was deleted at the source rather than policed forever, and the gate went with it.

The gate is deliberately **one-directional**: client-shared is ungated, so a design change lands there first and this repo follows. A bidirectional gate would deadlock, with neither repo's PR able to go green until the other merged.
> The duplication was not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and its `styles.css` lost the whole `.input` family. Nothing was red. Deleting the copy removes the failure mode instead of detecting it.

Why a gate and not a cargo dependency on client-shared? Both crates are git dependencies rather than crates.io publishes, so depending across would put two independently rev-pinned git deps in one graph for any consumer that wants both. The gate closes the silent-divergence hole without the coupling.

> This is not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and `styles.css` lost the whole `.input` family. Nothing was red. That is the defect this gate exists to prevent.

To sync after a change lands upstream:

```bash
for f in $(git ls-tree --name-only HEAD shared/); do
curl -fsSL "https://raw.githubusercontent.com/SmooAI/client-shared/main/$f" -o "$f"
done
```

If you need only the design system, either crate works — the `ui` surface is identical (`smooai_ui::STYLES` ⇄ `smooai_client_shared::ui::STYLES`).
Design changes land here, and only here. Consumers today are [`observability-studio`](https://github.com/SmooAI/observability) and [smooblue](https://github.com/SmooAI/smooblue).

## Versioning

Expand All@@ -203,11 +191,11 @@ Per-language packages share the same semver line so consumers can correlate vers
`@smooai/ui` is built and open-sourced by **[Smoo AI](https://smoo.ai)** — the AI-powered business platform with AI built into every product: CRM, customer support, campaigns, field service, observability, and developer tools.

- 🧰 **More open source from Smoo AI** — [smoo.ai/open-source](https://smoo.ai/open-source)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (this crate's superset), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (auth for the `th` CLI), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)

## 🤝 Contributing

PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land in [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) first**; this repo's `shared/` is a gated copy and CI rejects a divergent one. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.
PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land here** — this repois the single source. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.

## 📄 License

Expand Down
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length \u003e 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Retire the shared-drift gate — the copy it policed is being deleted#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
brentrager merged 1 commit into from
Aug 26, 2026
Merged

Retire the shared-drift gate — the copy it policed is being deleted #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
44 changes: 9 additions & 35 deletions .github/workflows/rust.yml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,14 @@
name: Rust

# This repo shipped with no CI at all — `.github/` held only banner images — so
# a change could land unbuilt, and `shared/` could drift from SmooAI/client-shared
# without anything saying so. It did: SmooAI/client-shared spent weeks serving the
# pre-f230808 monogram (no inner 'S', no dot) because that fix never crossed.
# This repo shipped with no CI at all — `.github/` held only banner images — so a
# change could land unbuilt.
#
# It also used to carry a `shared-drift` job, because SmooAI/client-shared kept a
# byte-identical copy of `shared/` and the two silently diverged: client-shared
# spent weeks serving the pre-f230808 monogram (no inner 'S', no dot) because that
# fix never crossed. That copy is gone — client-shared is an auth library now, and
# nothing imported its `ui` module — so this repo is the single source of the
# design system and there is nothing left to drift against.

on:
pull_request:
Expand DownExpand Up@@ -47,34 +52,3 @@ jobs:
# never compiles and no other check can see it.
- name: Every .rs file is reachable from the module tree
run: python3 scripts/check-module-tree.py

shared-drift:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# SmooAI/client-shared owns the design system; this repo carries a copy for
# its own consumers. The gate is deliberately ONE-directional — client-shared
# is ungated, so a design change lands there first and this repo follows.
# A bidirectional gate would deadlock: neither PR could go green until the
# other merged.
#
# Compares git blob SHAs from the GitHub contents API against `git ls-tree`,
# so added and deleted files are caught as well as edited ones — no
# hand-maintained filename list to fall behind.
- name: shared/ must match SmooAI/client-shared
run: |
set -euo pipefail
curl -fsSL "https://api.github.com/repos/SmooAI/client-shared/contents/shared?ref=main" \
| python3 -c 'import json,sys; [print(e["sha"], e["name"]) for e in sorted(json.load(sys.stdin), key=lambda e: e["name"])]' \
> /tmp/upstream.txt
git ls-tree HEAD shared/ --format='%(objectname) %(path)' \
| sed 's| shared/| |' | sort -k2 > /tmp/local.txt
if ! diff -u --label "SmooAI/client-shared@main" /tmp/upstream.txt --label "this repo" /tmp/local.txt; then
echo "::error::shared/ has drifted from SmooAI/client-shared, which owns the design system."
echo "Land the change in SmooAI/client-shared first, then copy shared/ across:"
echo " for f in \$(git ls-tree --name-only HEAD shared/); do"
echo " curl -fsSL \"https://raw.githubusercontent.com/SmooAI/client-shared/main/\$f\" -o \"\$f\""
echo " done"
exit 1
fi
echo "✓ shared/ matches SmooAI/client-shared@main"
24 changes: 6 additions & 18 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -168,25 +168,13 @@ The honest per-language picture — one binding exists, the rest are direction,

## Relationship to client-shared

**[`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) owns the design system. This repo carries a gated copy.**
**This repo owns the design system. [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) is an auth library and carries no copy of it.**

client-shared declares itself this crate's successor and is what the [`th` CLI](https://github.com/SmooAI/smooth) ships in production. This repo keeps `shared/` for its own consumers (`observability-studio`, smooblue), and CI **fails if the two diverge** — `shared-drift` compares every blob in `shared/` against `SmooAI/client-shared@main`.
It used to. client-shared declared itself this crate's successor and kept a byte-identical `shared/`, with a CI gate here failing if the two diverged. That arrangement is retired: an org-wide search found **nothing imported `client_shared::ui`** — its only consumer, the [`th` CLI](https://github.com/SmooAI/smooth), builds `features = ["auth"]` and never touched the design half. So the duplicate was deleted at the source rather than policed forever, and the gate went with it.

The gate is deliberately **one-directional**: client-shared is ungated, so a design change lands there first and this repo follows. A bidirectional gate would deadlock, with neither repo's PR able to go green until the other merged.
> The duplication was not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and its `styles.css` lost the whole `.input` family. Nothing was red. Deleting the copy removes the failure mode instead of detecting it.

Why a gate and not a cargo dependency on client-shared? Both crates are git dependencies rather than crates.io publishes, so depending across would put two independently rev-pinned git deps in one graph for any consumer that wants both. The gate closes the silent-divergence hole without the coupling.

> This is not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and `styles.css` lost the whole `.input` family. Nothing was red. That is the defect this gate exists to prevent.

To sync after a change lands upstream:

```bash
for f in $(git ls-tree --name-only HEAD shared/); do
curl -fsSL "https://raw.githubusercontent.com/SmooAI/client-shared/main/$f" -o "$f"
done
```

If you need only the design system, either crate works — the `ui` surface is identical (`smooai_ui::STYLES` ⇄ `smooai_client_shared::ui::STYLES`).
Design changes land here, and only here. Consumers today are [`observability-studio`](https://github.com/SmooAI/observability) and [smooblue](https://github.com/SmooAI/smooblue).

## Versioning

Expand All@@ -203,11 +191,11 @@ Per-language packages share the same semver line so consumers can correlate vers
`@smooai/ui` is built and open-sourced by **[Smoo AI](https://smoo.ai)** — the AI-powered business platform with AI built into every product: CRM, customer support, campaigns, field service, observability, and developer tools.

- 🧰 **More open source from Smoo AI** — [smoo.ai/open-source](https://smoo.ai/open-source)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (this crate's superset), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (auth for the `th` CLI), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)

## 🤝 Contributing

PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land in [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) first**; this repo's `shared/` is a gated copy and CI rejects a divergent one. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.
PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land here** — this repois the single source. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.

## 📄 License

Expand Down
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Retire the shared-drift gate — the copy it policed is being deleted#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
brentrager merged 1 commit into from
Aug 26, 2026
Merged

Retire the shared-drift gate — the copy it policed is being deleted #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
44 changes: 9 additions & 35 deletions .github/workflows/rust.yml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,14 @@
name: Rust

# This repo shipped with no CI at all — `.github/` held only banner images — so
# a change could land unbuilt, and `shared/` could drift from SmooAI/client-shared
# without anything saying so. It did: SmooAI/client-shared spent weeks serving the
# pre-f230808 monogram (no inner 'S', no dot) because that fix never crossed.
# This repo shipped with no CI at all — `.github/` held only banner images — so a
# change could land unbuilt.
#
# It also used to carry a `shared-drift` job, because SmooAI/client-shared kept a
# byte-identical copy of `shared/` and the two silently diverged: client-shared
# spent weeks serving the pre-f230808 monogram (no inner 'S', no dot) because that
# fix never crossed. That copy is gone — client-shared is an auth library now, and
# nothing imported its `ui` module — so this repo is the single source of the
# design system and there is nothing left to drift against.

on:
pull_request:
Expand DownExpand Up@@ -47,34 +52,3 @@ jobs:
# never compiles and no other check can see it.
- name: Every .rs file is reachable from the module tree
run: python3 scripts/check-module-tree.py

shared-drift:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# SmooAI/client-shared owns the design system; this repo carries a copy for
# its own consumers. The gate is deliberately ONE-directional — client-shared
# is ungated, so a design change lands there first and this repo follows.
# A bidirectional gate would deadlock: neither PR could go green until the
# other merged.
#
# Compares git blob SHAs from the GitHub contents API against `git ls-tree`,
# so added and deleted files are caught as well as edited ones — no
# hand-maintained filename list to fall behind.
- name: shared/ must match SmooAI/client-shared
run: |
set -euo pipefail
curl -fsSL "https://api.github.com/repos/SmooAI/client-shared/contents/shared?ref=main" \
| python3 -c 'import json,sys; [print(e["sha"], e["name"]) for e in sorted(json.load(sys.stdin), key=lambda e: e["name"])]' \
> /tmp/upstream.txt
git ls-tree HEAD shared/ --format='%(objectname) %(path)' \
| sed 's| shared/| |' | sort -k2 > /tmp/local.txt
if ! diff -u --label "SmooAI/client-shared@main" /tmp/upstream.txt --label "this repo" /tmp/local.txt; then
echo "::error::shared/ has drifted from SmooAI/client-shared, which owns the design system."
echo "Land the change in SmooAI/client-shared first, then copy shared/ across:"
echo " for f in \$(git ls-tree --name-only HEAD shared/); do"
echo " curl -fsSL \"https://raw.githubusercontent.com/SmooAI/client-shared/main/\$f\" -o \"\$f\""
echo " done"
exit 1
fi
echo "✓ shared/ matches SmooAI/client-shared@main"
24 changes: 6 additions & 18 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -168,25 +168,13 @@ The honest per-language picture — one binding exists, the rest are direction,

## Relationship to client-shared

**[`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) owns the design system. This repo carries a gated copy.**
**This repo owns the design system. [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) is an auth library and carries no copy of it.**

client-shared declares itself this crate's successor and is what the [`th` CLI](https://github.com/SmooAI/smooth) ships in production. This repo keeps `shared/` for its own consumers (`observability-studio`, smooblue), and CI **fails if the two diverge** — `shared-drift` compares every blob in `shared/` against `SmooAI/client-shared@main`.
It used to. client-shared declared itself this crate's successor and kept a byte-identical `shared/`, with a CI gate here failing if the two diverged. That arrangement is retired: an org-wide search found **nothing imported `client_shared::ui`** — its only consumer, the [`th` CLI](https://github.com/SmooAI/smooth), builds `features = ["auth"]` and never touched the design half. So the duplicate was deleted at the source rather than policed forever, and the gate went with it.

The gate is deliberately **one-directional**: client-shared is ungated, so a design change lands there first and this repo follows. A bidirectional gate would deadlock, with neither repo's PR able to go green until the other merged.
> The duplication was not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and its `styles.css` lost the whole `.input` family. Nothing was red. Deleting the copy removes the failure mode instead of detecting it.

Why a gate and not a cargo dependency on client-shared? Both crates are git dependencies rather than crates.io publishes, so depending across would put two independently rev-pinned git deps in one graph for any consumer that wants both. The gate closes the silent-divergence hole without the coupling.

> This is not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and `styles.css` lost the whole `.input` family. Nothing was red. That is the defect this gate exists to prevent.

To sync after a change lands upstream:

```bash
for f in $(git ls-tree --name-only HEAD shared/); do
curl -fsSL "https://raw.githubusercontent.com/SmooAI/client-shared/main/$f" -o "$f"
done
```

If you need only the design system, either crate works — the `ui` surface is identical (`smooai_ui::STYLES` ⇄ `smooai_client_shared::ui::STYLES`).
Design changes land here, and only here. Consumers today are [`observability-studio`](https://github.com/SmooAI/observability) and [smooblue](https://github.com/SmooAI/smooblue).

## Versioning

Expand All@@ -203,11 +191,11 @@ Per-language packages share the same semver line so consumers can correlate vers
`@smooai/ui` is built and open-sourced by **[Smoo AI](https://smoo.ai)** — the AI-powered business platform with AI built into every product: CRM, customer support, campaigns, field service, observability, and developer tools.

- 🧰 **More open source from Smoo AI** — [smoo.ai/open-source](https://smoo.ai/open-source)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (this crate's superset), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (auth for the `th` CLI), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)

## 🤝 Contributing

PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land in [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) first**; this repo's `shared/` is a gated copy and CI rejects a divergent one. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.
PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land here** — this repois the single source. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.

## 📄 License

Expand Down
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Retire the shared-drift gate — the copy it policed is being deleted#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
brentrager merged 1 commit into from
Aug 26, 2026
Merged

Retire the shared-drift gate — the copy it policed is being deleted #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
44 changes: 9 additions & 35 deletions .github/workflows/rust.yml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,14 @@
name: Rust

# This repo shipped with no CI at all — `.github/` held only banner images — so
# a change could land unbuilt, and `shared/` could drift from SmooAI/client-shared
# without anything saying so. It did: SmooAI/client-shared spent weeks serving the
# pre-f230808 monogram (no inner 'S', no dot) because that fix never crossed.
# This repo shipped with no CI at all — `.github/` held only banner images — so a
# change could land unbuilt.
#
# It also used to carry a `shared-drift` job, because SmooAI/client-shared kept a
# byte-identical copy of `shared/` and the two silently diverged: client-shared
# spent weeks serving the pre-f230808 monogram (no inner 'S', no dot) because that
# fix never crossed. That copy is gone — client-shared is an auth library now, and
# nothing imported its `ui` module — so this repo is the single source of the
# design system and there is nothing left to drift against.

on:
pull_request:
Expand DownExpand Up@@ -47,34 +52,3 @@ jobs:
# never compiles and no other check can see it.
- name: Every .rs file is reachable from the module tree
run: python3 scripts/check-module-tree.py

shared-drift:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# SmooAI/client-shared owns the design system; this repo carries a copy for
# its own consumers. The gate is deliberately ONE-directional — client-shared
# is ungated, so a design change lands there first and this repo follows.
# A bidirectional gate would deadlock: neither PR could go green until the
# other merged.
#
# Compares git blob SHAs from the GitHub contents API against `git ls-tree`,
# so added and deleted files are caught as well as edited ones — no
# hand-maintained filename list to fall behind.
- name: shared/ must match SmooAI/client-shared
run: |
set -euo pipefail
curl -fsSL "https://api.github.com/repos/SmooAI/client-shared/contents/shared?ref=main" \
| python3 -c 'import json,sys; [print(e["sha"], e["name"]) for e in sorted(json.load(sys.stdin), key=lambda e: e["name"])]' \
> /tmp/upstream.txt
git ls-tree HEAD shared/ --format='%(objectname) %(path)' \
| sed 's| shared/| |' | sort -k2 > /tmp/local.txt
if ! diff -u --label "SmooAI/client-shared@main" /tmp/upstream.txt --label "this repo" /tmp/local.txt; then
echo "::error::shared/ has drifted from SmooAI/client-shared, which owns the design system."
echo "Land the change in SmooAI/client-shared first, then copy shared/ across:"
echo " for f in \$(git ls-tree --name-only HEAD shared/); do"
echo " curl -fsSL \"https://raw.githubusercontent.com/SmooAI/client-shared/main/\$f\" -o \"\$f\""
echo " done"
exit 1
fi
echo "✓ shared/ matches SmooAI/client-shared@main"
24 changes: 6 additions & 18 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -168,25 +168,13 @@ The honest per-language picture — one binding exists, the rest are direction,

## Relationship to client-shared

**[`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) owns the design system. This repo carries a gated copy.**
**This repo owns the design system. [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) is an auth library and carries no copy of it.**

client-shared declares itself this crate's successor and is what the [`th` CLI](https://github.com/SmooAI/smooth) ships in production. This repo keeps `shared/` for its own consumers (`observability-studio`, smooblue), and CI **fails if the two diverge** — `shared-drift` compares every blob in `shared/` against `SmooAI/client-shared@main`.
It used to. client-shared declared itself this crate's successor and kept a byte-identical `shared/`, with a CI gate here failing if the two diverged. That arrangement is retired: an org-wide search found **nothing imported `client_shared::ui`** — its only consumer, the [`th` CLI](https://github.com/SmooAI/smooth), builds `features = ["auth"]` and never touched the design half. So the duplicate was deleted at the source rather than policed forever, and the gate went with it.

The gate is deliberately **one-directional**: client-shared is ungated, so a design change lands there first and this repo follows. A bidirectional gate would deadlock, with neither repo's PR able to go green until the other merged.
> The duplication was not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and its `styles.css` lost the whole `.input` family. Nothing was red. Deleting the copy removes the failure mode instead of detecting it.

Why a gate and not a cargo dependency on client-shared? Both crates are git dependencies rather than crates.io publishes, so depending across would put two independently rev-pinned git deps in one graph for any consumer that wants both. The gate closes the silent-divergence hole without the coupling.

> This is not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and `styles.css` lost the whole `.input` family. Nothing was red. That is the defect this gate exists to prevent.

To sync after a change lands upstream:

```bash
for f in $(git ls-tree --name-only HEAD shared/); do
curl -fsSL "https://raw.githubusercontent.com/SmooAI/client-shared/main/$f" -o "$f"
done
```

If you need only the design system, either crate works — the `ui` surface is identical (`smooai_ui::STYLES` ⇄ `smooai_client_shared::ui::STYLES`).
Design changes land here, and only here. Consumers today are [`observability-studio`](https://github.com/SmooAI/observability) and [smooblue](https://github.com/SmooAI/smooblue).

## Versioning

Expand All@@ -203,11 +191,11 @@ Per-language packages share the same semver line so consumers can correlate vers
`@smooai/ui` is built and open-sourced by **[Smoo AI](https://smoo.ai)** — the AI-powered business platform with AI built into every product: CRM, customer support, campaigns, field service, observability, and developer tools.

- 🧰 **More open source from Smoo AI** — [smoo.ai/open-source](https://smoo.ai/open-source)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (this crate's superset), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (auth for the `th` CLI), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)

## 🤝 Contributing

PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land in [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) first**; this repo's `shared/` is a gated copy and CI rejects a divergent one. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.
PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land here** — this repois the single source. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.

## 📄 License

Expand Down
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Retire the shared-drift gate — the copy it policed is being deleted#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
brentrager merged 1 commit into from
Aug 26, 2026
Merged

Retire the shared-drift gate — the copy it policed is being deleted #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
44 changes: 9 additions & 35 deletions .github/workflows/rust.yml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,14 @@
name: Rust

# This repo shipped with no CI at all — `.github/` held only banner images — so
# a change could land unbuilt, and `shared/` could drift from SmooAI/client-shared
# without anything saying so. It did: SmooAI/client-shared spent weeks serving the
# pre-f230808 monogram (no inner 'S', no dot) because that fix never crossed.
# This repo shipped with no CI at all — `.github/` held only banner images — so a
# change could land unbuilt.
#
# It also used to carry a `shared-drift` job, because SmooAI/client-shared kept a
# byte-identical copy of `shared/` and the two silently diverged: client-shared
# spent weeks serving the pre-f230808 monogram (no inner 'S', no dot) because that
# fix never crossed. That copy is gone — client-shared is an auth library now, and
# nothing imported its `ui` module — so this repo is the single source of the
# design system and there is nothing left to drift against.

on:
pull_request:
Expand DownExpand Up@@ -47,34 +52,3 @@ jobs:
# never compiles and no other check can see it.
- name: Every .rs file is reachable from the module tree
run: python3 scripts/check-module-tree.py

shared-drift:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# SmooAI/client-shared owns the design system; this repo carries a copy for
# its own consumers. The gate is deliberately ONE-directional — client-shared
# is ungated, so a design change lands there first and this repo follows.
# A bidirectional gate would deadlock: neither PR could go green until the
# other merged.
#
# Compares git blob SHAs from the GitHub contents API against `git ls-tree`,
# so added and deleted files are caught as well as edited ones — no
# hand-maintained filename list to fall behind.
- name: shared/ must match SmooAI/client-shared
run: |
set -euo pipefail
curl -fsSL "https://api.github.com/repos/SmooAI/client-shared/contents/shared?ref=main" \
| python3 -c 'import json,sys; [print(e["sha"], e["name"]) for e in sorted(json.load(sys.stdin), key=lambda e: e["name"])]' \
> /tmp/upstream.txt
git ls-tree HEAD shared/ --format='%(objectname) %(path)' \
| sed 's| shared/| |' | sort -k2 > /tmp/local.txt
if ! diff -u --label "SmooAI/client-shared@main" /tmp/upstream.txt --label "this repo" /tmp/local.txt; then
echo "::error::shared/ has drifted from SmooAI/client-shared, which owns the design system."
echo "Land the change in SmooAI/client-shared first, then copy shared/ across:"
echo " for f in \$(git ls-tree --name-only HEAD shared/); do"
echo " curl -fsSL \"https://raw.githubusercontent.com/SmooAI/client-shared/main/\$f\" -o \"\$f\""
echo " done"
exit 1
fi
echo "✓ shared/ matches SmooAI/client-shared@main"
24 changes: 6 additions & 18 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -168,25 +168,13 @@ The honest per-language picture — one binding exists, the rest are direction,

## Relationship to client-shared

**[`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) owns the design system. This repo carries a gated copy.**
**This repo owns the design system. [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) is an auth library and carries no copy of it.**

client-shared declares itself this crate's successor and is what the [`th` CLI](https://github.com/SmooAI/smooth) ships in production. This repo keeps `shared/` for its own consumers (`observability-studio`, smooblue), and CI **fails if the two diverge** — `shared-drift` compares every blob in `shared/` against `SmooAI/client-shared@main`.
It used to. client-shared declared itself this crate's successor and kept a byte-identical `shared/`, with a CI gate here failing if the two diverged. That arrangement is retired: an org-wide search found **nothing imported `client_shared::ui`** — its only consumer, the [`th` CLI](https://github.com/SmooAI/smooth), builds `features = ["auth"]` and never touched the design half. So the duplicate was deleted at the source rather than policed forever, and the gate went with it.

The gate is deliberately **one-directional**: client-shared is ungated, so a design change lands there first and this repo follows. A bidirectional gate would deadlock, with neither repo's PR able to go green until the other merged.
> The duplication was not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and its `styles.css` lost the whole `.input` family. Nothing was red. Deleting the copy removes the failure mode instead of detecting it.

Why a gate and not a cargo dependency on client-shared? Both crates are git dependencies rather than crates.io publishes, so depending across would put two independently rev-pinned git deps in one graph for any consumer that wants both. The gate closes the silent-divergence hole without the coupling.

> This is not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and `styles.css` lost the whole `.input` family. Nothing was red. That is the defect this gate exists to prevent.

To sync after a change lands upstream:

```bash
for f in $(git ls-tree --name-only HEAD shared/); do
curl -fsSL "https://raw.githubusercontent.com/SmooAI/client-shared/main/$f" -o "$f"
done
```

If you need only the design system, either crate works — the `ui` surface is identical (`smooai_ui::STYLES` ⇄ `smooai_client_shared::ui::STYLES`).
Design changes land here, and only here. Consumers today are [`observability-studio`](https://github.com/SmooAI/observability) and [smooblue](https://github.com/SmooAI/smooblue).

## Versioning

Expand All@@ -203,11 +191,11 @@ Per-language packages share the same semver line so consumers can correlate vers
`@smooai/ui` is built and open-sourced by **[Smoo AI](https://smoo.ai)** — the AI-powered business platform with AI built into every product: CRM, customer support, campaigns, field service, observability, and developer tools.

- 🧰 **More open source from Smoo AI** — [smoo.ai/open-source](https://smoo.ai/open-source)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (this crate's superset), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (auth for the `th` CLI), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)

## 🤝 Contributing

PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land in [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) first**; this repo's `shared/` is a gated copy and CI rejects a divergent one. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.
PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land here** — this repois the single source. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.

## 📄 License

Expand Down
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Retire the shared-drift gate — the copy it policed is being deleted#10

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
brentrager merged 1 commit into from
Aug 26, 2026
Merged

Retire the shared-drift gate — the copy it policed is being deleted #10

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
44 changes: 9 additions & 35 deletions .github/workflows/rust.yml
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,14 @@
name: Rust

# This repo shipped with no CI at all — `.github/` held only banner images — so
# a change could land unbuilt, and `shared/` could drift from SmooAI/client-shared
# without anything saying so. It did: SmooAI/client-shared spent weeks serving the
# pre-f230808 monogram (no inner 'S', no dot) because that fix never crossed.
# This repo shipped with no CI at all — `.github/` held only banner images — so a
# change could land unbuilt.
#
# It also used to carry a `shared-drift` job, because SmooAI/client-shared kept a
# byte-identical copy of `shared/` and the two silently diverged: client-shared
# spent weeks serving the pre-f230808 monogram (no inner 'S', no dot) because that
# fix never crossed. That copy is gone — client-shared is an auth library now, and
# nothing imported its `ui` module — so this repo is the single source of the
# design system and there is nothing left to drift against.

on:
pull_request:
Expand DownExpand Up@@ -47,34 +52,3 @@ jobs:
# never compiles and no other check can see it.
- name: Every .rs file is reachable from the module tree
run: python3 scripts/check-module-tree.py

shared-drift:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
# SmooAI/client-shared owns the design system; this repo carries a copy for
# its own consumers. The gate is deliberately ONE-directional — client-shared
# is ungated, so a design change lands there first and this repo follows.
# A bidirectional gate would deadlock: neither PR could go green until the
# other merged.
#
# Compares git blob SHAs from the GitHub contents API against `git ls-tree`,
# so added and deleted files are caught as well as edited ones — no
# hand-maintained filename list to fall behind.
- name: shared/ must match SmooAI/client-shared
run: |
set -euo pipefail
curl -fsSL "https://api.github.com/repos/SmooAI/client-shared/contents/shared?ref=main" \
| python3 -c 'import json,sys; [print(e["sha"], e["name"]) for e in sorted(json.load(sys.stdin), key=lambda e: e["name"])]' \
> /tmp/upstream.txt
git ls-tree HEAD shared/ --format='%(objectname) %(path)' \
| sed 's| shared/| |' | sort -k2 > /tmp/local.txt
if ! diff -u --label "SmooAI/client-shared@main" /tmp/upstream.txt --label "this repo" /tmp/local.txt; then
echo "::error::shared/ has drifted from SmooAI/client-shared, which owns the design system."
echo "Land the change in SmooAI/client-shared first, then copy shared/ across:"
echo " for f in \$(git ls-tree --name-only HEAD shared/); do"
echo " curl -fsSL \"https://raw.githubusercontent.com/SmooAI/client-shared/main/\$f\" -o \"\$f\""
echo " done"
exit 1
fi
echo "✓ shared/ matches SmooAI/client-shared@main"
24 changes: 6 additions & 18 deletions README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -168,25 +168,13 @@ The honest per-language picture — one binding exists, the rest are direction,

## Relationship to client-shared

**[`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) owns the design system. This repo carries a gated copy.**
**This repo owns the design system. [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) is an auth library and carries no copy of it.**

client-shared declares itself this crate's successor and is what the [`th` CLI](https://github.com/SmooAI/smooth) ships in production. This repo keeps `shared/` for its own consumers (`observability-studio`, smooblue), and CI **fails if the two diverge** — `shared-drift` compares every blob in `shared/` against `SmooAI/client-shared@main`.
It used to. client-shared declared itself this crate's successor and kept a byte-identical `shared/`, with a CI gate here failing if the two diverged. That arrangement is retired: an org-wide search found **nothing imported `client_shared::ui`** — its only consumer, the [`th` CLI](https://github.com/SmooAI/smooth), builds `features = ["auth"]` and never touched the design half. So the duplicate was deleted at the source rather than policed forever, and the gate went with it.

The gate is deliberately **one-directional**: client-shared is ungated, so a design change lands there first and this repo follows. A bidirectional gate would deadlock, with neither repo's PR able to go green until the other merged.
> The duplication was not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and its `styles.css` lost the whole `.input` family. Nothing was red. Deleting the copy removes the failure mode instead of detecting it.

Why a gate and not a cargo dependency on client-shared? Both crates are git dependencies rather than crates.io publishes, so depending across would put two independently rev-pinned git deps in one graph for any consumer that wants both. The gate closes the silent-divergence hole without the coupling.

> This is not hypothetical. The two copies **had** already diverged: the monogram fix in `f230808` ("restore the inner 'S' curve and the dot") never crossed, so client-shared served a monogram with no S and no dot, and `styles.css` lost the whole `.input` family. Nothing was red. That is the defect this gate exists to prevent.

To sync after a change lands upstream:

```bash
for f in $(git ls-tree --name-only HEAD shared/); do
curl -fsSL "https://raw.githubusercontent.com/SmooAI/client-shared/main/$f" -o "$f"
done
```

If you need only the design system, either crate works — the `ui` surface is identical (`smooai_ui::STYLES` ⇄ `smooai_client_shared::ui::STYLES`).
Design changes land here, and only here. Consumers today are [`observability-studio`](https://github.com/SmooAI/observability) and [smooblue](https://github.com/SmooAI/smooblue).

## Versioning

Expand All@@ -203,11 +191,11 @@ Per-language packages share the same semver line so consumers can correlate vers
`@smooai/ui` is built and open-sourced by **[Smoo AI](https://smoo.ai)** — the AI-powered business platform with AI built into every product: CRM, customer support, campaigns, field service, observability, and developer tools.

- 🧰 **More open source from Smoo AI** — [smoo.ai/open-source](https://smoo.ai/open-source)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (this crate's superset), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)
- 🧩 **Sibling packages** — [client-shared](https://github.com/SmooAI/client-shared) (auth for the `th` CLI), [@smooai/logger](https://github.com/SmooAI/logger), [@smooai/utils](https://github.com/SmooAI/utils), [@smooai/file](https://github.com/SmooAI/file), [smooth](https://github.com/SmooAI/smooth) (the `th` CLI)

## 🤝 Contributing

PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land in [`SmooAI/client-shared`](https://github.com/SmooAI/client-shared) first**; this repo's `shared/` is a gated copy and CI rejects a divergent one. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.
PRs welcome. Keep this surface narrow — only add a token or class when at least two apps need it. **Design-system changes land here** — this repois the single source. Add tokens to `shared/tokens.json` (the Rust constants generate from it) rather than to the CSS alone.

## 📄 License

Expand Down
Loading