hh-contracts 0.0.81 → 0.0.83

package/AGENTS.md

@@ -0,0 +1,66 @@
+# agents.md — Каркас для Codex/LLM-агентов
+
+## 1. Введение
+
+Этот документ описывает агентов (AI-ассистентов), их роли, правила и форматы работы.  
+Цель — стандартизировать использование Codex/LLM внутри проекта, сделать промптинг воспроизводимым и согласованным.
+
+---
+
+## 2. Таксономия агентов
+
+Определены следующие агенты:
+
+- **Contracts Agent** — ведёт Zod-схемы, DTO, enums в `hh-contracts`.
+
+---
+
+## 3. Общие принципы
+
+1. **Single Source of Truth**: все типы и схемы берутся из `hh-contracts`.
+2. **Чёткие форматы**: каждый агент возвращает только согласованный формат (TSX, SQL, JSON и т.д.).
+3. **ASSUMPTIONS/GAPS**: если данных не хватает, агент явно указывает предположения и пробелы.
+4. **Пошаговость**: сложные задачи делятся на дизайн → реализация → тесты.
+5. **Безопасность**: никаких секретов, токены только через `process.env` и Zod-валидацию.
+
+---
+
+## 4. Описание агентов
+
+### Contracts Agent
+
+**Назначение**: ведёт контракты (Zod v4 схемы/DTO).  
+**Вход**: описание сущностей, версия `hh-contracts`.  
+**Выход**: TypeScript-файл со схемами, без README.  
+**Стиль**: TS 5.x strict, без `any`.  
+**Ограничения**: не использовать class-validator.  
+**Инструменты**: zod.  
+**Few-shot**:
+
+```
+Запрос: Добавь сущность Permission (id, name, action, subject, conditions?)
+Ответ: TypeScript-файл с Zod-схемой и типом.
+```
+
+---
+
+## 5. Чек-лист качества (для каждого ответа)
+
+- [ ] Соответствует контрактам.
+- [ ] Нет магических значений.
+- [ ] Типизировано строго.
+- [ ] Есть тесты или примеры.
+- [ ] Код ≤ 400 строк.
+
+---
+
+## 6. Версионирование
+
+- Изменения фиксируются внизу файла (Changelog).
+- MAJOR — при смене форматов, MINOR — при добавлении агентов.
+
+---
+
+## Changelog
+
+- 1.0 — первоначальная версия каркаса.

package/build/permissions/permission.models.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PermissionListItemSchema = exports.PermissionWithTranslationsSchema = exports.PermissionLangTranslationSchema = exports.PermissionPersistedSchema = exports.JsonConditionsSchema = void 0;
+exports.PermissionListItemSchema = exports.PermissionWithTranslationsSchema = exports.PermissionTranslationsSchema = exports.PermissionPersistedSchema = exports.JsonConditionsSchema = void 0;
 const z = __importStar(require("zod"));
 const common_1 = require("../common");
 exports.JsonConditionsSchema = z
@@ -61,12 +61,12 @@ exports.PermissionPersistedSchema = z
 })
     .extend(common_1.TimestampSchema.shape);
 // V2 translations: all translatable fields are inside per-language translation object
-exports.PermissionLangTranslationSchema = z.object({
+exports.PermissionTranslationsSchema = z.object({
     name: z.string().min(3),
     description: z.string().optional(),
 });
 exports.PermissionWithTranslationsSchema = exports.PermissionPersistedSchema.extend({
-    translations: (0, common_1.makeTranslationsByLang)(exports.PermissionLangTranslationSchema),
+    translations: (0, common_1.makeTranslationsByLang)(exports.PermissionTranslationsSchema),
 });
 exports.PermissionListItemSchema = exports.PermissionPersistedSchema.extend({
     name: z.string().nullable(),

package/build/roles/role.models.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RoleListItemSchema = exports.RoleWithTranslationsSchema = exports.RoleLangTranslationSchema = exports.RoleWithPermissionsSchema = exports.RolePersistedSchema = void 0;
+exports.RoleListItemSchema = exports.RoleWithTranslationsSchema = exports.RoleTranslationsSchema = exports.RoleWithPermissionsSchema = exports.RolePersistedSchema = void 0;
 const z = __importStar(require("zod"));
 const common_1 = require("../common");
 const permissions_1 = require("../permissions");
@@ -48,12 +48,12 @@ exports.RolePersistedSchema = z
 exports.RoleWithPermissionsSchema = exports.RolePersistedSchema.extend({
     permissionIds: common_1.UuidArraySchema.optional(),
 });
-exports.RoleLangTranslationSchema = z.object({
+exports.RoleTranslationsSchema = z.object({
     name: z.string().min(3),
     description: z.string().optional(),
 });
 exports.RoleWithTranslationsSchema = exports.RoleWithPermissionsSchema.extend({
-    translations: (0, common_1.makeTranslationsByLang)(exports.RoleLangTranslationSchema),
+    translations: (0, common_1.makeTranslationsByLang)(exports.RoleTranslationsSchema),
 });
 exports.RoleListItemSchema = exports.RolePersistedSchema.extend({
     name: z.string().nullable(),

package/build/translations/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./translation.models"), exports);
 __exportStar(require("./resolve-translation-value-type.helper"), exports);
 __exportStar(require("./translation-value-types.constant"), exports);
+__exportStar(require("./translation-value-type-policy"), exports);

package/build/translations/translation-value-types.constant.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TranslationValueTypesValues = exports.TRANSLATION_VALUE_TYPES = void 0;
+exports.TRANSLATION_VALUE_TYPES_VALUES = exports.TRANSLATION_VALUE_TYPES = void 0;
 exports.TRANSLATION_VALUE_TYPES = {
     text: 'text',
     html: 'html',
 };
-exports.TranslationValueTypesValues = Object.values(exports.TRANSLATION_VALUE_TYPES);
+exports.TRANSLATION_VALUE_TYPES_VALUES = Object.values(exports.TRANSLATION_VALUE_TYPES);

package/build/translations/translation.models.js

@@ -42,6 +42,6 @@ exports.TranslationPersistedSchema = z.object({
     entityId: z.string(),
     lang: common_1.LanguageKeysSchema,
     path: z.string(),
-    valueType: z.enum(translation_value_types_constant_1.TranslationValueTypesValues),
+    valueType: z.enum(translation_value_types_constant_1.TRANSLATION_VALUE_TYPES_VALUES),
     value: z.string().min(1),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hh-contracts",
-  "version": "0.0.81",
+  "version": "0.0.83",
   "description": "",
   "main": "./build/index.js",
   "scripts": {

package/permissions/permission.models.ts

@@ -32,13 +32,14 @@ export const PermissionPersistedSchema = z
 export type TPermissionPersisted = z.infer<typeof PermissionPersistedSchema>;
 
 // V2 translations: all translatable fields are inside per-language translation object
-export const PermissionLangTranslationSchema = z.object({
+export const PermissionTranslationsSchema = z.object({
   name: z.string().min(3),
   description: z.string().optional(),
 });
+export type TPermissionTranslations = z.infer<typeof PermissionTranslationsSchema>;
 
 export const PermissionWithTranslationsSchema = PermissionPersistedSchema.extend({
-  translations: makeTranslationsByLang(PermissionLangTranslationSchema),
+  translations: makeTranslationsByLang(PermissionTranslationsSchema),
 });
 export type TPermissionWithTranslations = z.infer<typeof PermissionWithTranslationsSchema>;
 

package/roles/role.models.ts

@@ -22,13 +22,14 @@ export const RoleWithPermissionsSchema = RolePersistedSchema.extend({
 });
 export type TRoleWithPermissions = z.infer<typeof RoleWithPermissionsSchema>;
 
-export const RoleLangTranslationSchema = z.object({
+export const RoleTranslationsSchema = z.object({
   name: z.string().min(3),
   description: z.string().optional(),
 });
+export type TRoleTranslations = z.infer<typeof RoleTranslationsSchema>;
 
 export const RoleWithTranslationsSchema = RoleWithPermissionsSchema.extend({
-  translations: makeTranslationsByLang(RoleLangTranslationSchema),
+  translations: makeTranslationsByLang(RoleTranslationsSchema),
 });
 export type TRoleWithTranslations = z.infer<typeof RoleWithTranslationsSchema>;
 

package/translations/index.ts

@@ -1,3 +1,4 @@
 export * from './translation.models';
 export * from './resolve-translation-value-type.helper';
 export * from './translation-value-types.constant';
+export * from './translation-value-type-policy';

package/translations/resolve-translation-value-type.helper.ts

@@ -1,12 +1,12 @@
 import { TEntity } from '../common';
-import { ContentPolicyRegistry, defaultPolicy } from './translation-value-type-policy';
+import { TContentPolicyRegistry, defaultPolicy } from './translation-value-type-policy';
 import { TTranslationValueType } from './translation-value-types.constant';
 
 export function resolveTranslationValueType<E extends TEntity>(
   entityName: E,
   dotPath: string,
   explicit?: TTranslationValueType | null,
-  registry: ContentPolicyRegistry<E> = defaultPolicy,
+  registry: TContentPolicyRegistry<E> = defaultPolicy,
 ): TTranslationValueType {
   if (explicit) return explicit;
   const byEntity = registry.byEntity?.[entityName];

package/translations/translation-value-type-policy.ts

@@ -1,13 +1,13 @@
 import { TEntity } from '../common';
 import type { TTranslationValueType } from './translation-value-types.constant';
 
-export type ContentPolicy = Record<string, TTranslationValueType>;
-export type ContentPolicyRegistry<E extends TEntity> = {
-  default?: ContentPolicy;
-  byEntity?: Partial<Record<E, ContentPolicy>>;
+export type TContentPolicy = Record<string, TTranslationValueType>;
+export type TContentPolicyRegistry<E extends TEntity> = {
+  default?: TContentPolicy;
+  byEntity?: Partial<Record<E, TContentPolicy>>;
 };
 
-export const defaultPolicy: ContentPolicyRegistry<TEntity> = {
+export const defaultPolicy: TContentPolicyRegistry<TEntity> = {
   default: {
     name: 'text',
     description: 'html',

package/translations/translation-value-types.constant.ts

@@ -4,7 +4,7 @@ export const TRANSLATION_VALUE_TYPES = {
 } as const;
 export type TTranslationValueType =
   (typeof TRANSLATION_VALUE_TYPES)[keyof typeof TRANSLATION_VALUE_TYPES];
-export const TranslationValueTypesValues = Object.values(TRANSLATION_VALUE_TYPES) as [
+export const TRANSLATION_VALUE_TYPES_VALUES = Object.values(TRANSLATION_VALUE_TYPES) as [
   TTranslationValueType,
   ...TTranslationValueType[],
 ];

package/translations/translation.models.ts

@@ -1,13 +1,13 @@
 import * as z from 'zod';
 import { ENTITY_VALUES, LanguageKeysSchema } from '../common';
-import { TranslationValueTypesValues } from './translation-value-types.constant';
+import { TRANSLATION_VALUE_TYPES_VALUES } from './translation-value-types.constant';
 
 export const TranslationPersistedSchema = z.object({
   entityName: z.enum(ENTITY_VALUES),
   entityId: z.string(),
   lang: LanguageKeysSchema,
   path: z.string(),
-  valueType: z.enum(TranslationValueTypesValues),
+  valueType: z.enum(TRANSLATION_VALUE_TYPES_VALUES),
   value: z.string().min(1),
 });
 export type TTranslationPersisted = z.infer<typeof TranslationPersistedSchema>;