@warpgogol/werkstatt-shared 0.14.0 → 0.15.0

package/README.md

@@ -2,7 +2,9 @@
 
 [Українська](README.uk.md) | English
 
-Stack-agnostic shared infrastructure extracted from `werkstatt-site` (RFC-0868). Owns checks, integration, ontology, passport, share, and surface domains consumed by both the Werkstatt engine and the site plugin.
+Stack-agnostic shared infrastructure extracted from `werkstatt-site` (RFC-0868). Owns checks, integration, ontology, passport, slug, semantic, typography, middleware, and surface domains consumed by both the Werkstatt engine and the site plugin.
+
+> Engineered at [Warpgogol](https://warpgogol.com) · Released as open source.
 
 ---
 
@@ -14,7 +16,8 @@ This is a **shared infrastructure library** used by the [Werkstatt](https://www.
 - **Integration** — CRM, funnel, hub, sharding, QStash adapters
 - **Ontology** — catalogs, enums, Sternsystem owner types
 - **Passport** — DHT signing, identity signing, schema validation
-- **Share** — slug generation, semantic extraction, URL canonicalization, route filtering, middleware, access protection
+- **Slug / Semantic / Routes** — slug generation, semantic extraction, URL canonicalization, route filtering
+- **Middleware** — access protection, language redirect, retired tombstones
 - **Surface** — surface expand/bake helpers and labels
 
 You don't use this package on its own — it is consumed by the engine and site plugin as a dependency.
@@ -37,8 +40,8 @@ This package is installed automatically when you install `@warpgogol/werkstatt`
 | --- | --- |
 | `@warpgogol/forge` | Governance layer — skills, RFC/ADR workflows, CLI, project scaffolding |
 | `@warpgogol/werkstatt` | Runtime engine — missions, releases, deployment, certification, Bordbuch |
-| `@warpgogol/werkstatt-shared` | **This package** — shared infrastructure (checks, integration, ontology, passport, share) |
-| `@warpgogol/werkstatt-site` | Astro site plugin — consumes this package for checks, integration, ontology, passport, share |
+| `@warpgogol/werkstatt-shared` | **This package** — shared infrastructure (checks, integration, ontology, passport, semantic) |
+| `@warpgogol/werkstatt-site` | Astro site plugin — consumes this package for checks, integration, ontology, passport, semantic |
 
 The engine and site plugin both import from this package. It MUST NOT import from `werkstatt-site` — enforced by `werkstatt.shared.validate`.
 
@@ -55,43 +58,50 @@ The engine and site plugin both import from this package. It MUST NOT import fro
 | `HeadingSlugger` | Stateful heading anchor deduplication |
 
 ```ts
-import { slugUrl } from "@warpgogol/werkstatt-shared/share/slug";
+import { slugUrl } from "@warpgogol/werkstatt-shared/slug";
 
 const url = slugUrl("Über uns", "de"); // "ueber-uns"
 ```
 
 ### Semantic extraction (RFC-0901)
 
-| Export | Purpose |
-| --- | --- |
+| Export                          | Purpose                                                     |
+| ------------------------------- | ----------------------------------------------------------- |
 | `splitSentences(text, locale?)` | Locale-aware sentence boundary detection (`de`, `uk`, `en`) |
 
 ### Canonical entity URL (RFC-0910)
 
-| Export | Purpose |
-| --- | --- |
+| Export                      | Purpose                                         |
+| --------------------------- | ----------------------------------------------- |
 | `canonicalRootUrl(baseUrl)` | Unprefixed root URL for JSON-LD entity identity |
 
 ### Placeholder route filtering (RFC-0917)
 
-| Export | Purpose |
-| --- | --- |
+| Export                         | Purpose                                                      |
+| ------------------------------ | ------------------------------------------------------------ |
 | `hasPlaceholderRoutes(routes)` | Detect Astro dynamic route templates (`[slug]`, `[version]`) |
 
 ---
 
 ## Architecture
 
+The package has **no root barrel export** (RFC-1106) — all consumption is via subpath exports (`@warpgogol/werkstatt-shared/<domain>`). The former `src/share/` namespace is dissolved (RFC-1105): every subdomain is a top-level `src/` directory.
+
 | Directory | Purpose |
 | --- | --- |
-| `src/index.ts` | Main barrel export |
 | `src/checks/` | Content validators, SEO validators, surface expand/bake |
 | `src/integration/` | CRM, funnel, hub, sharding, QStash adapters |
 | `src/ontology/` | Catalogs, enums, Sternsystem owner types |
 | `src/passport/` | DHT signing, identity signing, schema validation |
-| `src/share/` | Slug, semantic, URL canonicalization, routes, middleware, access protection |
+| `src/slug/` | Locale-aware slug generation |
+| `src/semantic/` | Semantic extraction, fact extraction, freshness, canonical URIs |
+| `src/typography/` | Typography rules (Tier 1–3) and fix engine |
+| `src/middleware/` | Access protection, language redirect, retired tombstones |
+| `src/routes/` | Route filtering, placeholder route detection |
 | `src/surface/` | Surface expand/bake helpers and labels |
 | `src/content/` | SystemManifest types and content schema |
+| `src/node/` | Node-only utilities (fs, import-scan) — never re-exported from browser barrels |
+| `src/client-scripts/` | Browser-only scripts (gsap, lenis, plyr, hls, lordicon) |
 
 ---
 
@@ -133,3 +143,11 @@ After CI completes, verify the new version on [npmjs.com/package/@warpgogol/werk
 ## License
 
 Apache-2.0
+
+## Open Engineering
+
+This package originated from production engineering work at [Warpgogol](https://warpgogol.com), an engineering studio in Germany.
+
+We publish reusable parts of our infrastructure when they can be useful beyond our own projects. It is published independently of any Warpgogol commercial service. Using this package does not create any dependency on Warpgogol.
+
+Built for real systems. Shared openly.

package/README.uk.md

@@ -4,6 +4,8 @@
 
 Спільна інфраструктура, незалежна від стеку, витягнута з `werkstatt-site` (RFC-0868). Володіє доменами checks, integration, ontology, passport, share та surface, які споживають рушій Werkstatt та site-плагін.
 
+> Розроблено в [Warpgogol](https://warpgogol.com) · Опубліковано як open source.
+
 ---
 
 ## Що робить цей пакет
@@ -55,21 +57,21 @@ pnpm add @warpgogol/werkstatt-shared
 | `HeadingSlugger` | Станковий дедуплікатор якорів заголовків |
 
 ```ts
-import { slugUrl } from "@warpgogol/werkstatt-shared/share/slug";
+import { slugUrl } from "@warpgogol/werkstatt-shared/slug";
 
 const url = slugUrl("Über uns", "de"); // "ueber-uns"
 ```
 
 ### Семантична екстракція (RFC-0901)
 
-| Експорт | Призначення |
-| --- | --- |
+| Експорт                         | Призначення                                          |
+| ------------------------------- | ---------------------------------------------------- |
 | `splitSentences(text, locale?)` | Локалізоване виявлення меж речень (`de`, `uk`, `en`) |
 
 ### Канонічний URL сутності (RFC-0910)
 
-| Експорт | Призначення |
-| --- | --- |
+| Експорт                     | Призначення                                                     |
+| --------------------------- | --------------------------------------------------------------- |
 | `canonicalRootUrl(baseUrl)` | Непрефіксований кореневий URL для JSON-LD ідентичності сутності |
 
 ### Фільтрація плейсхолдер-маршрутів (RFC-0917)
@@ -82,16 +84,16 @@ const url = slugUrl("Über uns", "de"); // "ueber-uns"
 
 ## Архітектура
 
-| Директорія | Призначення |
-| --- | --- |
-| `src/index.ts` | Головний barrel-експорт |
-| `src/checks/` | Валідатори контенту, SEO-валідатори, surface expand/bake |
-| `src/integration/` | Адаптери CRM, funnel, hub, sharding, QStash |
-| `src/ontology/` | Каталоги, enum-и, типи Sternsystem owner |
-| `src/passport/` | DHT-підписування, підписування ідентичності, валідація схем |
-| `src/share/` | Slug, семантика, канонізація URL, маршрути, middleware, захист доступу |
-| `src/surface/` | Хелпери surface expand/bake та мітки |
-| `src/content/` | Типи SystemManifest та схема контенту |
+| Директорія         | Призначення                                                            |
+| ------------------ | ---------------------------------------------------------------------- |
+| `src/index.ts`     | Головний barrel-експорт                                                |
+| `src/checks/`      | Валідатори контенту, SEO-валідатори, surface expand/bake               |
+| `src/integration/` | Адаптери CRM, funnel, hub, sharding, QStash                            |
+| `src/ontology/`    | Каталоги, enum-и, типи Sternsystem owner                               |
+| `src/passport/`    | DHT-підписування, підписування ідентичності, валідація схем            |
+| `src/share/`       | Slug, семантика, канонізація URL, маршрути, middleware, захист доступу |
+| `src/surface/`     | Хелпери surface expand/bake та мітки                                   |
+| `src/content/`     | Типи SystemManifest та схема контенту                                  |
 
 ---
 
@@ -133,3 +135,11 @@ pnpm exec repo-extract --config packages/werkstatt-shared/extract.config.yaml --
 ## Ліцензія
 
 Apache-2.0
+
+## Відкрита інженерія
+
+Цей пакет походить із виробничої інженерної роботи в [Warpgogol](https://warpgogol.com), інженерній студії в Німеччині.
+
+Ми публікуємо багаторазові частини нашої інфраструктури, коли вони можуть бути корисними поза нашими власними проєктами. Він публікується незалежно від будь-якого комерційного сервісу Warpgogol. Використання цього пакету не створює жодної залежності від Warpgogol.
+
+Створено для реальних систем. Поширюється відкрито.