qiksy 1.0.0

package/tools/client-finder/vendor/icp/assist-pl-shops.json

@@ -0,0 +1,30 @@
+{
+  "id": "assist-pl-shops",
+  "product": {
+    "name": "Qiksy Assist",
+    "pitch": "A chat widget for your site that lives in the owner's Telegram: the visitor writes in the bubble, the owner replies by swiping in their own Telegram — the visitor needs no Telegram at all. One line of code on any site (WordPress, Shopify, a hand-built one). Free / Start $99 a year / Pro $199 a year.",
+    "url": "https://qiksy.app/assist/"
+  },
+  "who": "A small Polish online shop or service business with its own site, run by an owner or a two-person team, that sells through conversation but has no live chat on the site — a visitor with a question has only a form or a phone number.",
+  "must": [
+    "Has its own website in Polish, business operates in Poland",
+    "There is NO live chat on the site: no widget, no operator bubble",
+    "The business is alive: current prices, working cart or booking form, recent posts or products",
+    "Small enough that the owner decides: no call centre, no support desk"
+  ],
+  "mustNot": [
+    "Already runs a chat widget (Tidio, Smartsupp, LiveChat, Crisp, tawk.to, Zendesk, Intercom and the like) — Tidio and Smartsupp are Polish and very common, check carefully",
+    "A chain, a franchise or a marketplace",
+    "An abandoned site: dead links, old prices, news over a year old"
+  ],
+  "signals": [
+    "Messenger icons in the footer or contacts — they already sell by conversation",
+    "The site is on WordPress, Shoper, WooCommerce or a builder — one line of code is within reach",
+    "An owner is visible: a name on the About page, a signature under posts",
+    "A contact form is the only way to reach them, which is exactly the gap"
+  ],
+  "geo": "Poland",
+  "language": "Polish",
+  "contact": "the contact form or the e-mail published on the contact page",
+  "avoid": ["marketplaces", "aggregators", "government sites", "sites with no products or prices"]
+}

package/tools/client-finder/vendor/icp/assist-ua-shops.json

@@ -0,0 +1,30 @@
+{
+  "id": "assist-ua-shops",
+  "product": {
+    "name": "Qiksy Assist",
+    "pitch": "Чат для сайта, который живёт в Telegram владельца: посетитель пишет в виджет — владелец отвечает свайпом из своей Телеги, клиенту Telegram не нужен. Одна строка кода на любой сайт (Тильда, WordPress, самопис). Free / Start $99 в год / Pro $199 в год.",
+    "url": "https://qiksy.app/assist/"
+  },
+  "who": "Небольшой украинский интернет-магазин или сервисный бизнес с собственным сайтом, который продаёт через мессенджеры и живёт в Telegram, но на сайте у него нет чата — посетителю некуда написать, кроме формы или телефона.",
+  "must": [
+    "Есть собственный сайт (не только страница в Instagram и не только маркетплейс)",
+    "Сайт на украинском или русском, бизнес работает в Украине",
+    "На сайте НЕТ живого чата: ни виджета, ни всплывающего окна оператора",
+    "Есть признак, что бизнес живой: свежие товары/цены, работающая корзина или форма, актуальные контакты"
+  ],
+  "mustNot": [
+    "Уже стоит чат-виджет (Tidio, Crisp, JivoSite, tawk.to, Smartsupp, HelpCrunch, Binotel, LiveChat и подобные)",
+    "Это крупный ритейлер или сеть с собственным колл-центром",
+    "Сайт заброшен: битые ссылки, цены в старой валюте, новости годичной давности"
+  ],
+  "signals": [
+    "В контактах указан Telegram — значит владелец уже там живёт",
+    "Отвечают в Instagram Direct или Viber, то есть переписка и есть их канал продаж",
+    "Сайт сделан на Тильде, WordPress или конструкторе — вставить одну строку кода они смогут сами",
+    "Владелец виден: имя в разделе «о нас», подпись под текстами, личный аккаунт"
+  ],
+  "geo": "Украина",
+  "language": "украинский (или русский, если сайт русскоязычный)",
+  "contact": "форма на сайте или почта из раздела контактов; Telegram владельца — если он сам указал его публично",
+  "avoid": ["маркетплейсы", "агрегаторы", "государственные сайты", "сайты без товаров и цен"]
+}

package/tools/client-finder/vendor/knowledge/assist.md

@@ -0,0 +1,68 @@
+# Qiksy Assist — база знаний
+
+**Одной фразой:** чат для сайта, который живёт в Telegram владельца — посетитель
+пишет в виджет, владелец отвечает свайпом из своей Телеги, и клиенту Telegram не
+нужен.
+
+## Цены (канон — [products/assist/docs/PAYMENTS.md](../../assist/docs/PAYMENTS.md))
+
+| План | Цена | Что даёт |
+|---|---|---|
+| Free | $0 | Виджет с брендингом, ответы на почту |
+| Start | **$8/мес = $96/год** | Ответы из Telegram, файлы и фото в обе стороны |
+| Pro | **$15/мес = $180/год** | White-label, несколько сайтов, статистика |
+| Founding | **$49/год**, промо | Ранние клиенты, лимит мест |
+
+Оплата: касса Qiksy Pay (наша, на mono) — карта, Apple Pay, Google Pay. Триал 14 дней.
+
+## Как работает технически
+
+- **Виджет** — один `<script>` на любой сайт: Тильда, WordPress, Shopify, самопис.
+  Вставляется в `<head>` или перед `</body>`, ничего больше настраивать не нужно.
+- **Бэкенд** — Cloudflare Worker + Durable Object (`ChatHub`): держит переписку и
+  доставку. Живой адрес `qiksy-assist.qiksy.workers.dev`.
+- **Связь с Telegram** — сообщения посетителя приходят владельцу в личный чат с
+  ботом; ответ свайпом (reply) уходит обратно в виджет. Посетителю Telegram не
+  нужен вообще — он остаётся на сайте.
+- **Что умеет пересылать:** текст, фото, файлы, PDF — в обе стороны.
+- **Публичный API виджета:** `qiksy.ask(...)`, `qiksy.identify(...)` — чтобы
+  открыть чат кнопкой на сайте или передать, кто этот посетитель.
+
+## Кому продаём
+
+Небольшой бизнес с сайтом, который продаёт через переписку и живёт в мессенджерах:
+магазин, услуги, студия, мастерская, агентство. Владелец сам отвечает клиентам.
+
+**Признак боли:** на сайте нет чата — посетителю некуда написать, кроме формы или
+телефона; он уходит и пишет в Instagram, где всё теряется.
+
+## Возражения и ответы
+
+**«У меня уже есть Tidio / Crisp / JivoSite».**
+Спросите, где они читают сообщения. Все они заставляют жить в своём дашборде или
+приложении оператора. Assist кладёт диалог в Telegram, где владелец уже сидит —
+отвечаешь свайпом, а не заходишь куда-то ещё. Это единственная реальная разница,
+и говорить надо о ней, а не о функциях.
+
+**«А клиенту нужен Telegram?»**
+Нет. Клиент пишет прямо на сайте, в виджет. Telegram нужен только владельцу.
+
+**«Дорого».**
+Tidio ~$29/мес, JivoChat ~$28 за оператора, Crisp ~$45/мес. Assist — $8. Разница
+не в скидке, а в том, что мы не строим операторский центр: мы соединяем сайт с
+телефоном владельца.
+
+**«Не хочу ставить код на сайт».**
+Одна строка, и её можно вставить через любой конструктор. Если сайт делал кто-то
+другой — вставка занимает минуту, мы можем показать где.
+
+**«Безопасно ли?»**
+Переписка идёт через наш Worker и Telegram. Мы не продаём данные, не показываем
+рекламу и не даём доступ к чужим диалогам: у каждого сайта свой изолированный
+канал.
+
+## Чего НЕ обещать
+
+- Не обещать рост конверсии в процентах — цифры зависят от их трафика.
+- Не называть Assist «CRM» или «службой поддержки»: это чат и лиды, а не тикеты.
+- White-label — только на плане Pro.

package/tools/client-finder/vendor/knowledge/custom.md

@@ -0,0 +1,36 @@
+# Qiksy Build / Ops — кастомная разработка
+
+**Одной фразой:** студия делает продукты (Build) и автоматизирует то, как бизнес
+уже работает (Ops).
+
+## Цена
+
+От проекта. Кастом — это наше время, поэтому цена считается по объёму, а не по
+прайсу. Партнёрам: 10% за приведённый лид, 20% за полностью проведённую сделку
+([EARN.md](../../assist/docs/EARN.md)).
+
+## Что делаем
+
+- **Build** — новые продукты за недели: лендинги, приложения, интеграции,
+  собственные инструменты.
+- **Ops** — автоматизация существующих процессов: то, что сейчас держится на людях
+  и таблицах.
+
+Доказательство состоятельности — собственные продукты: Assist (живой воркер на
+Cloudflare), QA Copilot (в Chrome Web Store), Work Finder и Travel (локальные
+агенты на Claude), Investments (живой крипторадар). Всё это построено студией и
+работает.
+
+## Кому продаём
+
+Бизнес, которому надо построить или автоматизировать, а своей команды разработки
+нет.
+
+**Признак боли:** процесс держится на людях и таблицах; или есть идея продукта и
+некому её собрать.
+
+## Чего НЕ обещать
+
+- Не называть сроки и цену до разговора о задаче.
+- Не обещать «под ключ за неделю» — это то обещание, из-за которого потом теряют
+  доверие.

package/tools/client-finder/vendor/knowledge/multilogin.md

@@ -0,0 +1,29 @@
+# MultiLogin Tabs — база знаний
+
+**Одной фразой:** расширение Chrome, которое изолирует сессии по вкладкам —
+несколько аккаунтов одного сервиса открыты одновременно, без инкогнито и без
+перелогинов.
+
+## Цена
+
+**Бесплатно.** Всегда. Партнёрской ставки у него нет и не будет — это канон
+программы Earn ([docs/PRODUCTS.md](../../../docs/PRODUCTS.md)).
+
+## Как работает технически
+
+- Manifest V3, чистый вэнилла-JS.
+- Изоляция на уровне вкладки: cookies, localStorage, IndexedDB, Cache Storage.
+- В Chrome Web Store: ★5.0, около 700 пользователей.
+
+## Кому продаём
+
+Ничего не продаём — раздаём. Это инструмент, которым удобно начать разговор:
+SMM, арбитраж, агентства, поддержка, все, кто ведёт несколько аккаунтов.
+
+**Как использовать в продаже:** повод для первого контакта и доказательство, что
+студия делает работающие вещи, а не только обещает.
+
+## Чего НЕ делать
+
+- Не приписывать ему платный план и не показывать реф-пилюлю.
+- Не обещать обход антифрода площадок: это изоляция сессий, а не подмена отпечатка.

package/tools/client-finder/vendor/knowledge/pay.md

@@ -0,0 +1,26 @@
+# Qiksy Pay — база знаний
+
+**Одной фразой:** подписки и платежи под ключ поверх собственного эквайринга —
+биллинг, который не надо писать.
+
+## Статус
+
+**Ранний доступ.** Продукт заявлен, лендинг ведёт на лист ожидания. В разговоре
+это надо называть честно: «мы открываем ранний доступ», а не «у нас есть готовый
+биллинг». Каталог студии уже поправлен именно по этой причине.
+
+Полная позиция и аргументы против Stripe/Paddle/Chargebee — в
+[docs/PAY.md](../../../docs/PAY.md).
+
+## Кому продаём
+
+Сервисы с регулярными платежами, которым нужен биллинг, а не банк: подписочные
+продукты, школы, SaaS.
+
+**Признак боли:** подписки считаются руками или биллинг пишется своими силами.
+
+## Чего НЕ обещать
+
+- Не называть Qiksy Pay банком или платёжной системой: мы софт поверх эквайринга.
+- Не называть сроки запуска, которых нет.
+- Не обещать конкретные комиссии до того, как они зафиксированы.

package/tools/client-finder/vendor/knowledge/qa-copilot.md

@@ -0,0 +1,43 @@
+# Qiksy QA Copilot — база знаний
+
+**Одной фразой:** расширение Chrome для ручного QA — умное заполнение форм, живой
+аудит страницы и готовые к вставке находки.
+
+## Цена (канон — [products/qa-copilot/docs/OPERATIONS.md](../../qa-copilot/docs/OPERATIONS.md))
+
+**$20** — разовая покупка = Pro на 1 год. Опубликовано в Chrome Web Store.
+
+## Как работает технически
+
+- Расширение Manifest V3: TypeScript + React, сборка esbuild, загружаемая папка
+  `dist`.
+- Умное заполнение форм — понимает типы полей и подставляет валидные данные,
+  экономя ручной ввод на регрессе.
+- Аудит страницы — собирает проблемы (доступность, битые ссылки, консоль) прямо на
+  живой странице.
+- Находки оформляются в готовый текст, который вставляется в баг-трекер.
+- Есть MCP-мост (`qiksy-mcp` в npm) — для тех, кто хочет дергать это из своего
+  агента.
+
+## Кому продаём
+
+QA-инженеры, тест-лиды, небольшие продуктовые команды без автотестов, аутсорс-
+студии с ручным регрессом.
+
+**Признак боли:** регресс руками и оформление багов копипастой.
+
+## Возражения и ответы
+
+**«У нас есть автотесты».**
+Автотесты закрывают известные сценарии. Ручной регресс никуда не девается — этот
+инструмент про него, а не про замену автоматизации.
+
+**«$20 — а что через год?»**
+Год Pro за разовую покупку; продлевать необязательно, расширение продолжит
+работать в базовом виде.
+
+## Чего НЕ обещать
+
+- Не называть это автотестами и не обещать «покрытие».
+- Не обещать интеграцию с конкретным трекером, если её нет — находки копируются
+  текстом.

package/tools/client-finder/vendor/knowledge/travel.md

@@ -0,0 +1,43 @@
+# Qiksy Travel Assistant — база знаний
+
+**Одной фразой:** авиабилеты, отели и трансферы для командировок — агент собирает
+варианты и готовит маршрут; локально, на ключе клиента.
+
+## Цены (канон — [docs/PAYMENTS.md](../../../docs/PAYMENTS.md))
+
+| План | Цена | Что даёт |
+|---|---|---|
+| Free | $0 | До 3 путешественников («семья») |
+| Pro | **$9/мес**, без ограничения по людям | Неограниченно путешественников, все функции |
+
+Оплата: касса Qiksy Pay (наша, на mono) → `qiksy-licenses`, ключ `tr_`, проверяется локальным бэкендом.
+
+## Как работает технически
+
+- Локальный Node-бэкенд (`npm run backend:travel`, порт 5545); фронт ходит к нему
+  через прокси `/api`.
+- Агенты Claude собирают варианты и складывают маршрут; approver-MCP ограничивает,
+  какими инструментами агенту можно пользоваться.
+- Ключ Anthropic — клиента.
+
+## Кому продаём
+
+Компании и агентства, которые часто отправляют людей в командировки, и тревел-
+координаторы, которые собирают маршруты руками.
+
+**Признак боли:** командировка собирается в двадцати вкладках и пересобирается при
+каждом переносе.
+
+## Возражения и ответы
+
+**«У нас есть корпоративный тревел-агент».**
+Это не замена агенту, а замена рутине до него: собрать варианты, сравнить, свести
+в маршрут. Агенту остаётся то, за что ему платят.
+
+**«А данные сотрудников?»**
+Остаются на машине клиента: продукт локальный, у нас только лицензия.
+
+## Чего НЕ обещать
+
+- Не обещать цены ниже рынка — мы не туроператор и не выкупаем билеты.
+- Не гарантировать наличие мест: данные берутся из открытых источников.

package/tools/client-finder/vendor/knowledge/work-finder.md

@@ -0,0 +1,52 @@
+# Qiksy Work Finder — база знаний
+
+**Одной фразой:** агенты Claude сканируют рынок вакансий, подбирают их под профиль
+и готовят персональные отклики — локально, на ключе самого пользователя.
+
+## Цены (канон — [docs/PAYMENTS.md](../../../docs/PAYMENTS.md))
+
+| План | Цена | Что даёт |
+|---|---|---|
+| Free | $0 | 1 профиль кандидата, поиск и отклики |
+| Pro | **$9/мес**, без ограничения по людям | Неограниченно профилей, авто-отклики, лиды по найму |
+
+Оплата: касса Qiksy Pay (наша, на mono) → воркер `qiksy-licenses` выдаёт лицензионный ключ (`wf_`), который
+локальный бэкенд проверяет. Продаётся по числу пользователей, **не по кредитам**:
+токены идут с ключа Anthropic самого клиента.
+
+## Как работает технически
+
+- **Локальный бэкенд** на машине пользователя (`npm run backend:wf`, порт 5544) —
+  ничего про его поиск работы не уходит к нам.
+- **Агент** — headless `claude -p` со stream-json; поиск идёт через WebSearch и
+  WebFetch, при необходимости — через настоящий браузер по CDP.
+- **Ключ Anthropic** — свой у каждого пользователя, вводится в интерфейсе.
+- **Лицензия** проверяется у воркера с офлайн-грейсом 7 дней: интернет отвалился —
+  платный план не слетает.
+
+## Кому продаём
+
+Специалисты в IT, которые ищут работу: разработка, QA, проджект-менеджмент,
+дизайн, DevOps. И рекрутинговые агентства, которым нужен масштаб.
+
+**Признак боли:** тратит вечера на отклики и переписывание сопроводительных.
+
+## Возражения и ответы
+
+**«Есть же LinkedIn Easy Apply».**
+Easy Apply рассылает одно и то же. Здесь агент читает вакансию и профиль и пишет
+отклик под конкретную вакансию — то, на что у человека не хватает вечера.
+
+**«Мои данные уйдут к вам?»**
+Нет. Продукт работает на машине пользователя, на его ключе. Мы не видим ни резюме,
+ни переписки — у нас только факт лицензии.
+
+**«Почему я ещё и за токены плачу?»**
+Потому что иначе мы бы продавали токены с наценкой. Свой ключ — это прозрачная
+цена работы, и её можно оптимизировать самому.
+
+## Чего НЕ обещать
+
+- Не обещать трудоустройство и количество офферов.
+- Не называть авто-отклики «рассылкой» — это персональные отклики, и точность
+  здесь важнее объёма.

package/tools/client-finder/vendor/lib/access.mjs

@@ -0,0 +1,108 @@
+/**
+ * Client Finder is for PARTNERS, not for anyone who finds the URL.
+ *
+ * The check rides the licensing worker we already run (`qiksy-licenses`), the same
+ * one Work Finder and Travel verify against — one system, one place to revoke, and
+ * a partner code that stops working the moment someone leaves the programme. The
+ * product id is `clientfinder`; keys carry the `cf_` prefix by the same convention
+ * as `wf_` and `tr_`.
+ *
+ * Two deliberate properties:
+ *   • Failure to REACH the worker never locks out a partner who was fine a minute
+ *     ago (offline grace) — the same rule lib/license.mjs follows in Work Finder,
+ *     because a plane without wifi is not a licence violation.
+ *   • Failure to ANSWER "yes" does lock: an unknown code is refused, and refused
+ *     with a sentence rather than a blank screen.
+ *
+ * `CF_PARTNER_CODES` (comma-separated) is the local escape hatch for development
+ * and for the owner's own machine, where the worker has nothing to say yet.
+ *
+ * THE STUDIO ACCOUNT IS A SECOND DOOR, not a bypass. Someone signed in to the studio
+ * as the owner — or as a partner the owner promoted — is already a partner by every
+ * meaning of the word; sending them to look for a `cf_…` licence they were never
+ * issued locks the product against the people who own it. So an account is accepted
+ * INSTEAD of a code, and it is checked the same way: the worker is asked who this
+ * is, and only the worker's answer counts. What arrives from the browser is a
+ * ref_code and a token, never a claim of being the owner.
+ */
+const API = (process.env.QIKSY_LICENSE_API || 'https://qiksy-licenses.qiksy.workers.dev').replace(/\/+$/, '');
+const PRODUCT = 'clientfinder';
+const GRACE_MS = 7 * 86400 * 1000;
+
+const localCodes = () =>
+  String(process.env.CF_PARTNER_CODES || '')
+    .split(',')
+    .map((s) => s.trim())
+    .filter(Boolean);
+
+/** code → { ok, at } — remembered so every request does not hit the network. */
+const cache = new Map();
+
+/**
+ * The gate is a STUDIO ACCOUNT, the same way the admin console works: signed in →
+ * in, not signed in → out. No per-request key. Registering IS joining the programme
+ * (the worker mints the referral code at registration), so any account the worker
+ * confirms — `me.ok` — is a partner and may run the panel; owner/admin only change
+ * the source label, not the verdict.
+ *
+ * The check still rides the licensing worker on every call, and what the browser
+ * sends is a ref_code + token, never a claim of being anyone: a forged body earns
+ * nothing because the worker is the one that says who this is. Any failure to reach
+ * or confirm answers null, and the caller falls back to the legacy `cf_` code path.
+ */
+async function checkAccount(account) {
+  const ref = String(account?.ref_code || '').trim();
+  const token = String(account?.token || '').trim();
+  if (!ref || !token) return null;
+  try {
+    const r = await fetch(
+      `${API}/account/me?ref_code=${encodeURIComponent(ref)}&token=${encodeURIComponent(token)}`,
+      { signal: AbortSignal.timeout(4000) },
+    );
+    if (!r.ok) return null;
+    const me = await r.json().catch(() => null);
+    if (!me || me.ok === false) return null;
+    return { ok: true, source: me.owner ? 'owner' : me.admin ? 'admin' : 'account' };
+  } catch {
+    /* unreachable worker — the caller falls back to the code path */
+  }
+  return null;
+}
+
+export async function checkPartner(code, account) {
+  // A signed-in studio account is the gate. Checked FIRST, because it is now the
+  // normal way in — the `cf_` code below is a dev/legacy fallback (CF_PARTNER_CODES,
+  // and any key issued before this change).
+  const byAccount = await checkAccount(account);
+  if (byAccount) return byAccount;
+
+  const key = String(code || '').trim();
+  if (!key) {
+    return { ok: false, reason: 'Войдите в Qiksy Studio — панель открыта зарегистрированным партнёрам.' };
+  }
+
+  if (localCodes().includes(key)) return { ok: true, source: 'local' };
+
+  const seen = cache.get(key);
+  try {
+    const r = await fetch(`${API}/v?key=${encodeURIComponent(key)}&product=${PRODUCT}`, {
+      signal: AbortSignal.timeout(4000),
+    });
+    if (r.ok) {
+      const j = await r.json().catch(() => null);
+      const ok = !!j && j.ok !== false && j.active !== false;
+      cache.set(key, { ok, at: Date.now() });
+      return ok
+        ? { ok: true, source: 'worker', plan: j.plan }
+        : { ok: false, reason: 'Этот ключ не действует. Проверьте его в кабинете партнёра.' };
+    }
+  } catch {
+    /* offline — fall through to the grace window below */
+  }
+
+  if (seen?.ok && Date.now() - seen.at < GRACE_MS) return { ok: true, source: 'grace' };
+  return {
+    ok: false,
+    reason: 'Не удалось проверить ключ: сервис лицензий не отвечает. Попробуйте ещё раз через минуту.',
+  };
+}