Машинні інтерфейси для розробників

Інвентар даних і межі канону

Єдиний машинозчитуваний каталог описує всі 11 колекцій, їхні джерела, схеми, API, підрахунки та межі кожної проєкції. /data/latest/inventory.json ·/data/latest/coverage.json ·/data/latest/case-lift.json ·/data/latest/coverage-backlog.json

Колекції

Сутності

176

Сценарії

Архетипи

124

Тип	Кількість	Роль	Джерело	API / schema
`observation` Спостереження	21	Безпосередньо спостережуваний слід, який залишає процес найму.	`data/{lang}/entities/observation/*.md`	REST · schema
`barrier` Бар’єр	16	Точка, де нормативний шлях найму може зупинитися або відхилитися.	`data/{lang}/entities/barrier/*.md`	REST · schema
`mechanism` Механізм	28	Причинна сила, сумісна з одним або кількома спостереженнями й бар’єрами.	`data/{lang}/entities/mechanism/*.md`	REST · schema
`pattern` Патерн	4	Повторювана, формально визначена комбінація спостережень і сумісних механізмів.	`data/{lang}/entities/pattern/*.md`	REST · schema
`loop` Петля	3	Валідований підсилювальний цикл між механізмами.	`data/{lang}/entities/loop/*.md`	REST · schema
`intervention` Втручання	24	Зміна під контролем визначеного актора, спрямована на бар’єр, механізм, патерн або петлю.	`data/{lang}/entities/intervention/*.md`	REST · schema
`actor` Актор	7	Позиція ухвалення рішень із явними важелями, сліпими зонами та стимулами.	`data/{lang}/entities/actor/*.md`	REST · schema
`process` Процес	4	Машина станів із предметом, станами, власниками, переходами та очікуваною тривалістю.	`data/{lang}/entities/process/*.md`	REST · schema
`era` Ера	4	Підкріплений джерелами період економіки найму: капітал, поведінка найму, шляхи входу та завершення.	`data/{lang}/entities/era/*.md`	REST · schema
`evidence` Запис джерела	52	Мовно нейтральне джерело, що підтримує твердження реєстру.	`data/evidence/*.md`	REST · schema
`record` Фінансовий запис	13	Стійкий стан бюджету, контракту, фінансування, комісії, зарплат, підписки або runway з явними потоками.	`data/{lang}/entities/record/*.md`	REST · schema

composition

Валідовані сценарії · 16

Повторно використовувані ситуації, складені з канонічних ID та явних невисновків.

Не для: Сценарій не є сутністю онтології й не стверджує, що кожен випадок йому відповідає.

presentation

Архетипні накладки · 124

Псевдонім і позиція в сітці для огляду кожної сутності онтології, крім джерел.

Не для: Архетипи — подання, а не докази чи канонічні факти.

derived

Формальний субстрат

Проєкція на чотири примітиви для доказів, перевірок збереження та наскрізних запитів.

Не для: Ніколи не редагуйте субстрат як друге джерело правди.

Оберіть інструмент за ситуацією

Зрозуміти одне поняття в контексті

Відкрийте читацьку сторінку; переходьте до пов’язаних сутностей і джерел.

Вебсайт

Отримати один відомий канонічний ID

Зробіть GET елемента колекції, виконайте hoba show або викличте get_node.

Статичний REST APICLIMCP-сервер

Знайти поняття без знання ID

Шукайте в усіх 11 колекціях за ID, назвою та текстом.

CLIMCP-сервер

Почати з повторюваної реальної ситуації

Використайте валідований сценарій і перевірте його явні невисновки.

ВебсайтCLIMCP-сервер

Відокремити спостереження від сумісних причин

Запустіть діагностичний протокол H→O→B→A; не переходьте від сигналу прямо до мотиву.

CLIMCP-серверВебсайт

Завантажити всю онтологію в систему даних

Використайте registry.json для знімка або NDJSON для потоку.

JSON реєструNDJSON

Аналізувати причинні/топологічні зв’язки

Використайте graph JSON/GraphML/CSV; пам’ятайте, що це проєкція шести типів знахідок.

Графові експорти

Побудувати типізовану інтеграцію

Згенеруйте клієнт з OpenAPI та валідуйте payload через JSON Schema.

OpenAPIJSON SchemaСтатичний REST API

Дати агенту точний доступ до реєстру

Під’єднайте MCP-сервер, щоб модель викликала інструменти, а не вгадувала з копійованого тексту.

MCP-сервер

Додати або змінити дані реєстру

Редагуйте лише авторські дані, запустіть strict validation і build, потім перевірте generated drift.

Авторські джерелаІнструменти валідації

Перевірити формальні інваріанти

Перегенеруйте формальну проєкцію та запустіть Lean-перевірки.

Інструменти валідаціїLean-проєкція

Статичний REST API

JSON лише для читання: генерується під час збірки й віддається прямо з CDN. Бази даних за ним немає. /openapi.json

Сервер Model Context Protocol (MCP) stdio · локально

Підключіть AI-асистентів і автономних агентів прямо до графа знань hoba.

// claude_desktop_config.json / .mcp.json — запуск із локального клону
// (git clone … && pnpm install && pnpm build:packages)
{
  "mcpServers": {
    "hoba": {
      "command": "node",
      "args": ["/path/to/hoba.work/packages/mcp/dist/index.js", "--dir", "/path/to/hoba.work"]
    }
  }
}

Доступні інструменти: get_registry_info, get_data_inventory, search_registry, get_node, get_scenario, analyze_social_complaint, find_nearby_scenarios, explain_observation, find_compatible_mechanisms, get_diagnostic_probes, find_patterns, get_interventions, traverse_graph, get_methodology, detect_temporal_anomalies, calculate_runway, verify_flow_conservation, evaluate_pattern_emptiness, validate_entity_ids, validate_scenario, validate_analysis, validate_claim.

Ресурси методології: hoba://methodology/core, hoba://methodology/epistemic-rules, hoba://methodology/agency, hoba://methodology/evidence, hoba://methodology/non-goals.

MCP повертає канонічні дані, правила й детерміновані перевірки. Мовне міркування може виконувати модель на боці клієнта.

Пакети ще не опубліковані в npm; npx @hoba/mcp запрацює після публікації.

Інтерфейс командного рядка (CLI)

pnpm build:packages && node packages/cli/dist/cli.js --help

hoba search "reposted": Знайти сутності за запитом
hoba registry inventory --json: Отримати канонічний каталог, підрахунки, поверхні та рекомендації використання
hoba explain obs.materially_similar_role_reposted_shortly_after_rejection --stage technical: Провести спостереження через протокол hoba
hoba scenario scenario.application_silence: Прочитати валідований сценарій поверх онтології
hoba show mech.genuine_technical_skill_shortfall: Показати вузол повністю
hoba validate --strict: Перевірити контент, DAG барʼєрів, оголошення циклів і паритет англійської та української версій
hoba latency proc.the_hiring_funnel_end_to_end recruiter-queue 45: Перевірити аномалію тривалості на етапі процесу
hoba runway 25000 3500: Розрахувати горизонт фінансового runway пошуку

Додайте --json до будь-якої команди, щоб отримати машиночитний вивід.

Як читати реєстр із коду