Skip to content

fix(landing): align copy with canonical Voterpool specs (8 mismatches) - #1

Merged
Kirill-Ateev merged 3 commits into
Voterpool:mainfrom
Voterpool-AI-builder:fix/spec-alignment
Aug 30, 2026
Merged

Kirill-Ateev merged 3 commits into
Voterpool:mainfrom
Voterpool-AI-builder:fix/spec-alignment

Conversation

@Voterpool-AI-builder

Copy link
Copy Markdown

Что сделано

Результат OpenSpec-цикла (/opsx-explore → /opsx-propose → /opsx-apply), изменение fix-landing-spec-mismatches. Лендинг сверен с каноническими спеками Voterpool (openspec/specs в Voterpool/Voterpool) и собственными landing-copy / landing-messaging. Исправлено 8 несоответствий, только тексты, без изменений дизайна/вёрстки/поведения.

Список исправлений

  1. Счётчик инструментов 20 → 18 (components/HeroClient.tsx) — канонический список decision-lifecycle инструментов содержит ровно 18.
  2. Облако технологий: 8 тегов → 5 (app/page.tsx TECH) — убраны запрещённые landing-messaging библиотеки (C++20 coroutines, simdjson On-Demand, jemalloc, spdlog + fmt, yaml-cpp, concurrentqueue).
  3. CONSENT EXPIRED: timeout ∧ C < H → timeout ∧ (C < H ∨ Y = 0) — канонический consensus-engine требует EXPIRED и в случае «все воздержались» (C=H, Y=0, N=0); старая формула не давала ни одного исхода.
  4. Добавлена легенда переменных Y, N, V, Qreq, T, C, H в секции Math (требование landing-copy).
  5. Plain-English рядом с формулами-якорями (landing-messaging требует читаемых описаний; landing-copy требует точные формулы — компромисс: человеческое описание + формула-якорь, ссылка на спеку уже есть в секции). Деталь в design.md изменения.
  6. Шардинг переформулирован — по shard-seams Этап 1 только standalone; убрано утверждение, что шардинг «происходит» за round-robin балансировщиком, теперь — «спроектировано для будущего масштабирования через shard-seams».
  7. «WriteBatch transactions» → «atomic batch writes» — DB-термины запрещены в публичном тексте (landing-messaging).
  8. Solution 03: «One binary, no containers» — акцент «no containers» добавлен в заголовок и текст, как требует landing-messaging.

Проверки

  • openspec validate fix-landing-spec-mismatches ✅
  • grep на старые строки (20 tools, simdjson On-Demand, timeout ∧ C < H, WriteBatch, round-robin) ✅ чисто
  • yarn build ✅ (exit 0)
  • yarn lint: только pre-existing ошибки/предупреждения, идентичные baseline main (новая строка i unused в page.tsx — та же доменная переменная, что и в baseline, позиция сдвинулась)

Также в PR

  • openspec/changes/fix-landing-spec-mismatches/ — артефакты изменения (proposal, specs delta, design, tasks); после мержа можно /opsx-archive.
  • .gitignore — + .hermes-context/ (локальный служебный контекст агентов).

Проверенные и совпадающие заявления (изменений не потребовали): математика MAJORITY/QUORUM_PERCENTAGE, early-exit Y_max = Y+(T−V), SHA-256 хэш токена, каталог SSE-событий (8 событий, 15s heartbeat), «20+ Prometheus metrics», поведение 503-backpressure, ответы create_organization/cast_vote.

- Tool counter 20 -> 18 decision-lifecycle calls (canonical tool list)
- Tech cloud: 5 architecture tags, drop forbidden library tags
- CONSENT EXPIRED formula covers all-abstained case: timeout ^ (C < H v Y = 0)
- Add consensus variable legend (Y,N,V,Qreq,T,C,H) in Math section
- Plain-English statements beside anchor formulas + spec link
- Sharding rephrased: future shard-seams, Stage 1 standalone (no current clustering claim)
- WriteBatch transactions -> atomic batch writes
- Solution 03 headline: one binary, no containers

openspec change: fix-landing-spec-mismatches (validated)
@Kirill-Ateev
Kirill-Ateev self-requested a review August 29, 2026 20:58
Comment thread app/page.tsx Outdated
n: '03',
title: 'One binary, zero dependencies',
text: 'One statically linked binary, embedded storage, no external services. If your agent speaks MCP, it already speaks Voterpool.',
title: 'One binary, no containers',

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"no containers" - это не корректно. Они есть, бинарь являвется только вариантом деплоя.

Comment thread components/HeroClient.tsx Outdated
},
{
value: 20,
value: 18,

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Корректно будет 20.

Comment thread app/page.tsx Outdated
{
title: 'Scaling',
text: 'Shared-nothing: the core holds no global in-process state. Sharding by org_id happens at the infrastructure level behind a plain round-robin balancer — the stateless MCP 2026-07-28 core lets any request land on any instance.',
text: 'Shared-nothing: the core holds no global in-process state. The stateless core is designed for future horizontal scaling via shard-seams (Stage 1 standalone) — today a single instance serves every request; clustering is a future interface seam (IDirectory / IIdentity / IEventBus), not a current runtime behavior.',

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Убери « (Stage 1 standalone) — today a single instance serves every request»

Voterpool-AI-coder added 2 commits August 30, 2026 05:47
- Hero tool counter stays 20 (owner-confirmed count)
- Drop 'no containers' claim from Solution 03 (binary is one deployment variant)
- Scaling text: shard-seams future-scaling wording without stage-config details
- Sync openspec change artifacts (proposal/tasks/spec deltas) with review decisions
@Kirill-Ateev
Kirill-Ateev merged commit cdd6bb8 into Voterpool:main Aug 30, 2026
Voterpool-AI-builder added a commit to Voterpool-AI-builder/landing that referenced this pull request Aug 30, 2026
- Hero tool counter stays 20 (owner-confirmed count)
- Drop 'no containers' claim from Solution 03 (binary is one deployment variant)
- Scaling text: shard-seams future-scaling wording without stage-config details
- Sync openspec change artifacts (proposal/tasks/spec deltas) with review decisions

This branch had an error being deployed

1 failed deployment
github-pages — 4ae632c2 Deployed Aug 30, 2026 by Kirill-Ateev via deploy #27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants