Neue optionale Kappe je Search-Config: wie viele Index-Kandidaten gegen den
Query-Filter geprüft werden, bevor die Suche auf den regulären Pfad
zurückfällt. 0 = Server-Default (search.inMemory.maxFilterCandidates, 500000),
negativ = keine Kappe. Die Prüfung läuft gestückelt und stoppt, sobald die
Seite voll ist (tibi-server 09aaaf56).
Aktionen erscheinen in der generierten OpenAPI-Spec als /_actions/<name>.
Dafür trägt die Action-Meta jetzt denselben openapi-Block wie eine Sammlung:
- action.schema.json: meta.openapi referenziert openapi.schema.json
(bisher lehnte additionalProperties: false den Block ab).
- openapi.schema.json: Beschreibung deckt Sammlung und Aktion ab, get/getOne/
post/put/delete sind entsprechend erläutert.
- index.d.ts: ActionMeta.openapi plus OpenapiMeta/OpenapiOperationMeta/
OpenapiParameter.
- demo-api/actions/demo-action.yml und types-test/action-openapi.ts zeigen
und prüfen die Form.
- `AdminMfaChallenge` trägt `mfaEnrollmentRecommended` und `rememberDeviceDays`.
- `AdminMfaStatus.emailFallback` markiert die erzwungene Rückfallebene.
- `AdminTrustedDevice`/`AdminTrustedDevices` für die Geräteliste.
- `AdminAuthMethod` kennt `trusted_device` und `impersonation`; `AdminMfaMethod`
schließt beide aus.
- `AdminAuthMethod`/`AdminMfaMethod` enthalten jetzt `email`.
- `AdminMfaStatus` um `emailEnabled`, `email` (maskiert), `emailVerified`
erweitert.
- `AdminMfaChallenge.emailHint` für die maskierte Adresse, wenn der Faktor
angeboten wird.
- Type-Test deckt die neue Methode und den Status ab.
Eine Quelle für Server und Admin-UI:
- `AdminLoginResponse`: Union aus `AdminMfaChallenge` (`mfaRequired: true`)
und `AdminLoginSession` (`token`, `user`, `amr`, `mfaEnrollmentRecommended`).
Die Diskriminante ist `mfaRequired`, damit Clients sauber narrowen.
- `AdminAuthMethod` (`pwd|totp|recovery|webauthn`) vs. `AdminMfaMethod`
(ohne `pwd`) — Go schreibt `pwd` immer in `amr`, bietet es aber nie als
Faktor an.
- `AdminMfaStatus`, `AdminMfaTotpEnrollment`, `AdminMfaConfirmResult`,
`AdminStepUpResult`.
- WebAuthn: `AdminWebAuthnCreationOptions`,
`AdminWebAuthnRequestOptions`, `AdminWebAuthnCredentialJSON`,
`AdminWebAuthnCredentialView`, `AdminAuthenticatorTransport`.
Type-Tests in `types-test/admin-auth.ts`: `Expect<Equal<…>>`-Assertions und
`@ts-expect-error` für die nicht möglichen Felder der Challenge. `npm test`
führt jetzt Schemas **und** `tsc` aus (TypeScript als devDependency).
- `WebAuthnPackage` mit `verifyRegistration` und `verifyAssertion`, verdrahtet
in `HookContext`.
- `WebAuthnRegistrationOptions`/`WebAuthnAssertionOptions`,
`WebAuthnCredentialJSON` (Binärfelder base64url oder Byte-Array).
- Diskriminierte Ergebnistypen: `verified: true` mit Credential-Daten bzw.
`verified: false` mit `WebAuthnErrorCode` und optionalem Detail.
- `attestationTrusted` als explizite Warnung: heute immer `false`, die AAGUID
ist damit nicht authentisiert.
- SealedValue { iv, ciphertext, tag } (base64)
- encrypt/decrypt mit key, aad und encoding
- deriveKey (HKDF-SHA256) mit info, length und encoding
Refs #65
ConfigPackage.secret(name): string | null und secretNames(): string[]
ergänzt; project.schema.json erlaubt den secrets-Block (string-Map) mit
Hinweis, dass die Werte nie in API-Antworten oder config.project() landen.
Refs cms/tibi-server#66
TotpPackage mit generate/verify/uri, TotpOptions (digits, period,
algorithm, t) und window beim Verify; totp im HookContext registriert.
Kommentare nennen Defaults, die State-Losigkeit und dass t nicht aus
Nutzereingaben kommen darf.
Refs cms/tibi-server#63
hmac mit sha1|sha256|sha512, Schlüssel/Daten als String oder Bytes und
encoding-abhängigem Rückgabetyp; timingSafeEqual als boolean. Kommentare
nennen die Begründung für SHA-1 (TOTP) und die Length-Grenze.
Refs cms/tibi-server#60
collection.audit.excludeFields (dot notation) hält Werte aus dem Audit-Verlauf
heraus; AuditLog.redactedFields nennt die betroffenen Pfade. AuditEntry ist
jetzt als Typ deklariert, damit Clients das Feld sehen.
Refs cms/tibi-server#67
randomBytes gibt je nach encoding Int8Array oder string zurück,
randomToken immer string (Default ungepolstertes base64url). Der neue Typ
ByteEncoding (hex|base64|base64url|bytes) wird von den kommenden
base64-/crypto-Erweiterungen mitgenutzt.
Refs cms/tibi-server#61
- project.schema.json: cache.image.{path, autoCleanup.{maxAge,maxFiles,tempMaxAge}};
Server-only-Knöpfe (enabled, interval, Laufbudgets) sind bewusst nicht vorgesehen.
- asset.schema.json: cachePath optional, ohne Pflicht-Verzeichnis, verweist auf
cache.image.path als Default.
- index.d.ts und Beispiel-YAML nachgezogen.
Die Gesamtabnahme fand zwei Lücken im Config-Vertrag:
- ngram.sizes erlaubte minimum 1 und hatte kein maximum; der Server akzeptiert
nur 2–10 (collection_setup.go) — das Schema ließ also Configs durch, die beim
Projektload scheitern.
- combinedCache fehlte komplett, obwohl Server (models.CombinedCacheConfig) und
Doku den Block als Projekt-YAML führen; additionalProperties:false lehnte
gültige, dokumentierte Configs ab.
Ergänzt in collection.schema.json und index.d.ts (CombinedCacheConfig mit
enabled/ttl/maxEntries). Die Demo-Collection ngram-stopwords.yml enthält jetzt
eine Combined-Config mit combinedCache, sodass validate:schemas den Block
abdeckt. Gegenprobe per AJV: sizes [1] und [11] werden abgelehnt, [2,3] und
combinedCache akzeptiert.
Der Config-Vertrag kannte nur sizes und normalize. Damit lehnte
`validate:schemas` jedes Projekt ab, das die bereits im Server vorhandenen
ngram-Optionen nutzt (additionalProperties: false), und die generierte
Schema-Referenz konnte sie nie zeigen.
Ergänzt in collection.schema.json und index.d.ts:
- stopwords: { presets?: string[], words?: string[] }
- queryFilter: { minMatchRatio?: 0..1 }
- inMemory: { enabled?, maxDocs?, maxMemoryMB? }
plus demo-api/collections/ngram-stopwords.yml als Validierungs-Fixture; ohne
Schema-Erweiterung schlägt validate:schemas dort mit "must NOT have additional
properties" fehl.
Review-Nachbefunde am neuen embedding-Schema:
- latencyWindow war als integer/number deklariert, ist in Go aber ein String
(ConfigEmbeddingGroup.OnSingleQuery.LatencyWindow, per Atoi geprüft) — Schema
und index.d.ts auf digits-String (>0) umgestellt.
- duration-Pattern erlaubte nur eine Einheit und akzeptierte Unsinn wie "1ss":
jetzt (Zahl+Einheit)+, damit auch 1m30s/1h1m/1.5h gelten und 1ss/8/abc fallen.
- Beispiel examples/server/embedding.yml übt latencyWindow und Mehrfach-Einheiten
aus (npm test: 5 YAML gegen 17 Schemas, tsc --noEmit --strict grün).
index.d.ts: EmbeddingProviderConfig/EmbeddingGroupConfig (onSingleQuery, onBulkWrite,
health), EmbeddingConfig für config.server().embedding (Roh-JSON von config.Server.
Embedding) sowie die Status-Payloads von GET …/admin/embedding/status (Projekt- und
Server-Scope, Zustände live|degraded|quarantined|offline, Breaker closed|open|half-open).
VectorConfig.provider dokumentiert jetzt, dass dort auch ein Gruppenname stehen darf.
schemas/config/embedding.schema.json: validierbares Schema des Server-Abschnitts
(Enums für Policies/Distributionen, Go-Duration-Muster, Pflichtfelder, keine
erfundenen Properties); Beispiel examples/server/embedding.yml, per
scripts/validate-schemas.mjs mitgeprüft (npm test: 5 YAML gegen 17 Schemas).
Quelle der Wahrheit: internal/config/server.go + internal/config/embedding_group.go
(tibi-server). Typecheck: tsc --noEmit --strict über index.d.ts grün.
Hooks lesen oft zusätzliche Query-Parameter (ctx.request().query(name)).
Mit meta.query werden sie deklariert, für Agenten dokumentiert
(REST _meta/OpenAPI, MCP collection_describe) und bei MCP-Calls
validiert. Vergleiche docs 04-collections (meta.query).
Die Starter-Collections dokumentieren Editor-Workflows in meta.agent
(tibi-server spielt das ueber MCP/REST _meta aus), die Schemas kannten
den Schlüssel aber nicht – YAML-LS meldete 'Property agent is not
allowed'. agent ist bewusst freiform (additionalProperties: true),
damit die Doku nicht wieder hinterherhinkt.
Feld-Meta position erlaubt jetzt section und section:<group> neben main/sidebar.
Collection-Meta bekommt sections: [{ group, label, collapsible, collapsed }] als
Pendant zu sidebar.
Ohne das Pattern-Update schlaegt die YAML-Validierung im Editor fehl und
position: "section:x" wird als ungueltig markiert.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
choices previously only array|object, now also string to allow
choices: !include ../../choices/icon-choices.yml
which tibi-server resolves via yamlResolveIncludes before validation
- Introduced `field-list.schema.json`, `field-meta.schema.json`, and `field.schema.json` for field configurations.
- Added `hooks.schema.json` for defining hooks in the Tibi project.
- Created `image-filter.schema.json` for image processing configurations.
- Implemented `job.schema.json` for job scheduling configurations.
- Added `openapi.schema.json` for OpenAPI metadata generation.
- Introduced `permissions.schema.json` for managing permissions in the project.
- Created `project.schema.json` for overall project configuration.
- Added `projections.schema.json` for defining projections in the project.
- Implemented a validation script `validate-schemas.mjs` to ensure schema compliance.
- Introduced `field-list.schema.json`, `field-meta.schema.json`, and `field.schema.json` for field configurations.
- Added `hooks.schema.json` for defining hooks in the Tibi project.
- Created `image-filter.schema.json` for image processing configurations.
- Implemented `job.schema.json` for job scheduling configurations.
- Added `openapi.schema.json` for OpenAPI metadata generation.
- Introduced `permissions.schema.json` for managing permissions in the project.
- Created `project.schema.json` for overall project configuration.
- Added `projections.schema.json` for defining projections in the project.
- Implemented a validation script `validate-schemas.mjs` to ensure schema compliance.
- Introduced `field-list.schema.json`, `field-meta.schema.json`, and `field.schema.json` for field configurations.
- Added `hooks.schema.json` for defining hooks in the Tibi project.
- Created `image-filter.schema.json` for image processing configurations.
- Implemented `job.schema.json` for job scheduling configurations.
- Added `openapi.schema.json` for OpenAPI metadata generation.
- Introduced `permissions.schema.json` for managing permissions in the project.
- Created `project.schema.json` for overall project configuration.
- Added `projections.schema.json` for defining projections in the project.
- Implemented a validation script `validate-schemas.mjs` to ensure schema compliance.
- Updated collection.json to include upload defaults, audit logging, query limits, and more.
- Enhanced collectionNavigation.json with viewHint configurations.
- Added project-wide upload defaults and hook configurations in config.json.
- Expanded field.json to support new field types, validations, and properties.
- Improved fieldMeta.json with additional widget configurations and properties.
- Updated hooks.json to include new bulk operation hooks and audit logging.
- Enhanced imageFilter.json with additional image processing options.
- Added timeout properties to job.json for better execution control.
- Refined permissions.json to allow more granular control over HTTP method permissions and added filter and field visibility options.