Kontinuum

Appearance

Kontinuum Pulse — документация ​

Подсистема growth/monetization платформы Kontinuum: телеметрия, аналитика, маркетинговые решения и эксперименты. Neuro-symbolic стек с явным разделением ответственности между rules, ML и LLM, и с privacy-by-design на уровне архитектуры.

Код подсистемы живёт в submodule kontinuum-pulse (на уровне корня проекта). Здесь — спецификация и проектные документы.

Содержание ​

ДокументОписание
implementation-status.mdАвторитетный снимок «что в коде сегодня» vs §15 M0 чек-листа: статус каждого backend-пункта, хронология реализации decision spine + §7.4 unified dispatch, live-верификация, известные открытые границы (identity/CRM fork C, ML — M1), опер-баги, расхождения с текущей doc. Single source of truth по статусу реализации; обновляется отдельно от спеки.
specification.mdПолная архитектурная спецификация (v0.14.8): contract-driven архитектура, 5-слойный pipeline, identity/consent/semantic/audit горизонтали, deployment по уровням Kontinuum, single-UI стратегия через Directus admin (§4.4-bis), privacy-by-design (§3.6), M0-M5 roadmap (§15-bis), PostHog-inspired дополнения, meta-automation (§15-ter), marketing channels (§17), marketing patterns library (§17.15) + archetype как soft signal (§9.2.6), per-region overlay (§11.8), DSL-namespaces (§8.3.1.1), testing strategy (§18), identity-mapping API (§9.1.6), bootstrap (§10.6), performance budgets (§10.7), consent token wire format (§9.1.4-bis), client SDK contract (§13.7), data retention (§10.8), sampling (§6.9), template engine — Handlebars (§7.8), action retry policy (§7.9), canonical serialization (§10.9).
marketing-patterns.mdКаталог формализованных маркетинговых приёмов (Pulse Marketing Patterns Library, v0.4). 18 patterns по 7 категориям, адаптированные из методики Викентьева под privacy-VPN продукт. Используется маркетинг-командой при написании rules в Policy DSL; constraints применяются brand-guardrails verifier'ом автоматически. Включает Appendix A — Behavioural substitution guide.
m0-user-journey.mdEnd-to-end App user journey (v0.14.0) — install → onboarding → pairing → banner → payment → unsubscribe → GDPR. Каждый шаг подписан конкретными events/actions/metrics/tables. Идеальная точка входа для новых разработчиков.
testing.mdOperational testing guide (v0.1). Тесты по слоям Pulse, cross-cutting privacy/audit/identity, Pulse-specific подходы (contract evolution, SMT corpus, snapshot codegen, DSL property-based, decision replay), federation multi-node, meta-automation safety, compliance, tools matrix, test-corpus layout, CI/CD 4-уровневый pipeline, roadmap testing infrastructure синхронизирован с M0-M5+.
growth-measurement-frame.mdРамка измерения роста (v0.1, GMM, HOW-only). North-star = Activated-Retained Users (W2, CEO-approved); стадии воронки на инструментах Pulse; бар «attributed win» (campaign-attributed + знаменатель + vanity-gard + K-anon/DP); политика медиа-контента (Трек A активация / Трек B brand-wedge). Открытые работы (WHAT) → #86 (M8).
contracts/Pre-implementation freeze package + M0 contract instances: meta-schemas (telemetry, action), OpenAPI 3.1, consent-purposes registry, SQL DDL для трёх схем; реальные M0-контракты v0.1.0 в telemetry/, actions/, semantic-layer/. См. contracts/.

Статус ​

v0.14.8 (2026-05-28) — M0 backend закрыт по содержанию: decision spine замкнут (events → features → hydration → rules → preflight → dispatch → ack/audit с реальным провенансом); §7.4 unified dispatch tail на движковом пути, фейк-провенанс M0.STUB устранён; auto-audit pre-flight (consent/rate-limit/brand) работает на обоих путях; meta-периметр (rule_stats, anomaly_detect, champion_challenger, drift, …) включён.

Чекбоксы [ ] в §15 M0 спеки отстают от кода и обновляются вместе с этим релизным циклом, а не каждым PR. Авторитетный снимок «что работает сегодня» — в implementation-status.md.

Полная хронология версий спеки — в секции «Статус и roadmap» в конце specification.md.

Хронология реализации (отдельно от хронологии спеки):

  • 2026-05-25 — decision spine звенья #1–#4 (feature_derive, subject_context, decision_engine, real provenance) закрыты + verified live.
  • 2026-05-28 — §7.4 unified dispatch_decision tail + preflight на движковом пути + actions_dispatch рефактор (M0.STUB удалён, append-ack режим на engine-created decisions, manual путь как EXTERNAL.MANUAL).

См. implementation-status.md для полной матрицы статусов и расхождений с doc.

Связанные документы ​

  • docs/node/ — federation-уровень: tier model (architecture.md), DHT и mailbox (protocols.md). Pulse использует Node для distribution контрактов и publish audit-Merkle-корней.
  • docs/billing/ — биллинговая инфраструктура. Pulse интегрируется с Directus billing как один из потребителей action contract'а (тарификация, промо, capacity-управление).
  • docs/services/ — клиентские сервисы. Эмитят телеметрию через telemetry contract.
  • docs/internals/events.md — событийная система client-side. Source-of-events для Pulse.
  • docs/internals/observability.md — техническая observability (Prometheus, Grafana). Pulse — отдельный слой бизнес-аналитики, не заменяет ops-метрики.
  • docs/internals/architecture-decisions.md — высокоуровневые ADR'ы проекта.

Audience ​

  • Pulse developers — specification.md целиком.
  • App / Veil / Tether / Send developers — секция о telemetry contract и emit-обязательствах; интеграционные точки.
  • Node developers — секции о federation, distribution контракта через DHT, publish audit-Merkle-корней.
  • Billing team — action contract, integration с Directus, pricing/promo DSL.
  • Marketing team — concept overview, LLM interface, experiment platform.
  • Security review — секции threat model, consent model, privacy-by-design деривации.
  • Ops / DevOps — central growth service deployment, инфраструктурные требования.