Timestamp GIT

← All posts

2026-11-15

Автоматическая простановка временных меток для Git-коммитов без CLI

Автоматическая простановка временных меток для Git-коммитов без CLI
timestamp git blockchain proof

Автоматическая простановка временных меток Git-коммитов без единой команды в CLI

Большинство команд, которым нужен криптографический уровень prior art, так и не получают его, и причина почти никогда не техническая. Она операционная. Привычка ставить временные метки работает, только если человек помнит, что нужно запустить инструмент для нужного коммита в нужный момент и сохранить квитанцию там, где аудитор найдёт её через полтора года. Под давлением дедлайнов эта привычка умирает первой.

Эта статья о том, как избавиться от привычки полностью. Не «как чаще запускать команду простановки меток», а как сделать так, чтобы каждый коммит в отслеживаемом репозитории автоматически привязывался к блокчейну Bitcoin каждую ночь, без единой команды, введённой кем-либо из вашей команды. Если вы решаете, стоит ли изучать сырой протокол или использовать управляемое GitHub App, мы отдельно разбираем этот компромисс в OpenTimestamps vs Timestamp GIT: Manual Proofs or GitHub App?. Здесь мы исходим из того, что вы уже решили, что хотите автоматизации.

Ловушка ручной простановки меток (и почему из неё хочется выбраться)

Представьте, как ручная простановка меток выглядит на практике:

  1. Кто-то завершает ветку с фичей и вспоминает — обычно уже постфактум — что этот коммит стоило бы заверить меткой времени.
  2. Он запускает инструмент, ждёт и получает файл-квитанцию.
  3. Квитанцию переименовывают, кладут в папку proofs/, коммитят или, что хуже, отправляют менеджеру по почте.
  4. Для следующих сорока коммитов этого не делает никто, потому что в спринте стало жарко.

Сырой CLI OpenTimestamps существует и представляет собой трудный путь: это маршрут для экспертов, где вы сами отвечаете за батчинг, файлы доказательств, взаимодействие с календарями и систему хранения. Он работает. Но он зависит от того, что человек будет дисциплинирован вечно, и не оставляет аудиторского следа, объясняющего, почему у коммита 4f9c1ab есть доказательство, а у коммита 8d2e0f3 — нет.

Сценарий провала комплаенса хуже, чем неудобство. Запись prior art с дырами — это запись, которую юрист может разобрать по частям. Если контрагент спрашивает: «докажите, как выглядела ваша кодовая база 14 марта», а ваш ответ — это таблица плюс память разработчика, вы уже проиграли в постановке вопроса. Ручные процессы к тому же трудно аудировать: нет согласованного артефакта, нет регулярной периодичности и нет способа для комплаенс-ревьюера подтвердить покрытие, не прося инженеров реконструировать собственную историю.

Обещание автоматизации отличается качественно, а не количественно: установите один раз, и с этого момента каждый коммит в отслеживаемом репозитории получает отпечаток и привязывается к блокчейну каждую ночь. Не нужно учить CLI, не нужно вручную раскладывать квитанции, ничего не устанавливается на машины разработчиков. Запись доказательств становится свойством репозитория, а не свойством чьей-то добросовестности.

Разовая настройка: установите GitHub App и забудьте

Основной путь — GitHub App. Вы устанавливаете его на репозиторий или на всю организацию, и настройка действительно разовая — никаких скриптов на каждый репозиторий, никакого шага онбординга разработчиков.

Стандартный режим (GitHub App). Приложение автоматически читает хеш HEAD-коммита каждого отслеживаемого репозитория. Модель разрешений GitHub не предлагает область «только хеш коммита», поэтому приложению нужен как минимум доступ на чтение исходного репозитория. Ему также нужен доступ на чтение и запись к целевому репозиторию, потому что именно туда записываются доказательства: в выделенную ветку timestamps — либо в том же репозитории, что и исходный, либо в отдельном теневом репозитории.

Корпоративный ZK-режим. GitHub Action из 12 строк выполняется на вашей собственной инфраструктуре и отправляет в API Timestamp GIT только хеш коммита. В этом режиме сервису вообще не нужен доступ на чтение исходного репозитория — только чтение и запись в целевой репозиторий для доставки доказательств — а Action вы устанавливаете в свой workflow. Выбирайте этот вариант, когда доступ на чтение исходного кода неприемлем по политике или когда ваш security review требует, чтобы хеши создавались внутри вашего периметра. Выбирайте стандартный режим, когда хотите абсолютный минимум движущихся частей.

Стандартный (GitHub App) Корпоративный ZK (GitHub Action)
Доступ к исходному репозиторию Только чтение Нет
Доступ к целевому репозиторию Чтение и запись Чтение и запись
Где создаются хеши Приложение Ваш CI-раннер
Трудозатраты на настройку Установить приложение Установить приложение + добавить Action

В обоих режимах на машины разработчиков ничего не устанавливается. Инженеры коммитят ровно так же, как сегодня, а весь конвейер работает на стороне сервера. Сервис никогда не видит, не копирует и не хранит ваш исходный код — он работает только с хешами коммитов.

Если вам нужно запустить всё внутри собственной сети, Timestamp GIT также доступен как self-hosted Docker-образ. Быстрый старт с Docker Compose выглядит так:

services:
  timestampgit:
    image: rue1401/timestampgit:prod
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

  valkey:
    image: valkey/valkey:8
    restart: unless-stopped
docker compose pull
docker compose up -d
docker compose logs -f timestampgit

После запуска приложение доступно по адресу http://localhost:8080, а мастер настройки при первом запуске проведёт вас через подключение GitHub App и конфигурирование экземпляра. Ограниченную по времени демо-лицензию для оценки можно запросить на странице Docker License. Подробнее о развёртывании мы рассказываем в Self-Host Git Timestamping With Docker Compose.

Автоматический конвейер: от коммита до привязки в Bitcoin

После установки приложения вот что происходит без вашего участия:

  1. Обнаружение коммитов. Либо GitHub App получает новые коммиты через вебхуки, либо ваш GitHub Action отправляет хеши коммитов в API. Передаются только хеши.
  2. Очередь хешей. Хеши коммитов попадают в хранилище «ключ-значение» в памяти и ждут ночного батча.
  3. Cron-воркер в полночь. Каждую ночь воркер группирует все ожидающие хеши, записывает текстовый файл-манифест для каждого репозитория, нативно строит дерево Меркла, создаёт доказательства OpenTimestamps с помощью публичных календарей OTS и привязывает корень Меркла к блокчейну Bitcoin.
  4. Доставка доказательств. Манифест и файлы-квитанции .ots отправляются обратно в ваш репозиторий — в выделенную ветку timestamps или в теневой репозиторий, — чтобы доказательства лежали рядом с кодом, который они описывают.

Практическое замечание о сроках: подтверждение в Bitcoin занимает несколько часов, обычно около трёх. Поэтому коммит, сделанный во вторник, получает финальное доказательство утром в среду, а не вечером во вторник. Это цена привязки к публичному неизменяемому реестру, и эту цену стоит заплатить.

Вам не нужно принимать всё это на веру. Каждый отслеживаемый репозиторий получает публичную панель статуса, показывающую долговечность доказательств, самую раннюю дату привязки, ежедневную регулярность, данные блока и транзакции Bitcoin за каждой привязкой, а также календарную тепловую карту, по которой можно глазами проверить наличие пробелов. На той же странице доступны для скачивания аудиторские CSV и PDF-сертификаты. Сама верификация происходит по адресу /verification/{user}/{repo}/{date}, который шаг за шагом проходит многоуровневую цепочку Меркла — и все эти вычисления выполняются локально в браузере, так что никто не видит, что вы проверяете.

Для README доступны встраиваемые бейджи, публично отображающие статус верификации, и любой может перейти по ссылке бейджа, чтобы проверить временную метку на сайте или скачать PDF-отчёт.

Чтобы подключить статус к своим дашбордам, публичный API намеренно скучен:

# Last anchored Bitcoin block info
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api

# Total committed/stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api

# Combined summary (what the Shields.io badge consumes)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api

А когда комплаенс просит артефакты, не нужно кликать по интерфейсу в пятницу в пять вечера:

# Full audit ledger as CSV
curl -sL -o audit-acme-payments-api.csv \
  https://timestampgit.dev/api/audit/acme/payments-api

# PDF certificate for a specific day
curl -sL -o certificate-2026-11-14.pdf \
  https://timestampgit.dev/api/report/acme/payments-api/2026-11-14

URL бейджей и готовый к вставке markdown берутся из /api/badgeLink/{user}/{repo} (с аутентификацией). Для приватных репозиториев URL статуса содержат зашифрованный HMAC, специфичный для вашего экземпляра сервера, так что прочитать их могут только авторизованные пользователи.

Мониторинг и обработка сбоев: как не дать автоматизации обмануть

Автоматизация, за которой вы не следите, — это автоматизация, о работе которой вы не знаете. Есть три вещи, вокруг которых стоит выработать привычку.

Следите за пробелами, а не за ошибками. Если ночной запуск падает, система повторяет попытку, а ожидающие хеши остаются в очереди в памяти, а не отбрасываются. Но глубина очереди и повторы — это внутренние детали; календарная тепловая карта на странице статуса — то, что вы действительно можете прочитать. Пропущенный день сразу виден как дыра в сетке.

Опрашивайте и оповещайте. Небольшая задача по расписанию, которая сравнивает последний payload статуса со вчерашним снимком, поймает остановившийся конвейер раньше аудитора:

import json, pathlib, requests

REPO = "acme/payments-api"
URL = f"https://timestampgit.dev/api/statusSummary/{REPO}"
snapshot = pathlib.Path("last-status.json")

r = requests.get(URL, timeout=30)
r.raise_for_status()
current = r.json()

previous = json.loads(snapshot.read_text()) if snapshot.exists() else None

if previous == current:
    print("WARNING: status unchanged since last poll - check the repo status page")
else:
    print("new anchor data:", json.dumps(current))

snapshot.write_text(json.dumps(current, indent=2))

Запускайте её ежечасно в CI или ежедневно сразу после окна cron и направляйте предупреждение туда, где люди его увидят.

Планируйте аудиты с учётом задержки подтверждения. Поскольку привязка в Bitcoin занимает несколько часов после запуска cron-воркера, «заверь меткой времени всё из вчерашнего релиза, сертификат нужен через десять минут» — это запрос, который никто не сможет выполнить. Дайте комплаенсу простое правило: доказательства за день N финальны к дню N+1.

Успокаивающая часть обработки сбоев — это то, что происходит, если сервис полностью недоступен. Верификация не требует нас. Файл-квитанцию .ots можно проверить офлайн по блокчейну Bitcoin с помощью стандартных инструментов верификации OpenTimestamps, потому что доказательство зависит только от SHA-256 и данных блоков Bitcoin — никаких проприетарных технологий, никакой привязки к вендору. Даже если вендор исчезнет, доказательство останется в силе.

Лучшие практики для простановки меток без ручного участия

  • Коммитьте рано и часто. Каждый коммит автоматически получает отпечаток, поэтому плотная история коммитов даёт плотную запись prior art. Сквошивание месяца работы в один коммит накануне подачи патентной заявки даёт вам одну привязку вместо двухсот.
  • Выбирайте режим, соответствующий вашей модели безопасности. Если доступ на чтение исходного репозитория исключён, используйте корпоративный ZK-режим: за пределы вашей инфраструктуры уходят только хеши коммитов, отправляемые GitHub Action.
  • Выгружайте аудиторские реестры и сертификаты по расписанию. Архивы комплаенса не должны зависеть от того, кто-то вспомнит ссылку для скачивания. Обращайтесь к /api/audit/{user}/{repo} ежемесячно и к /api/report/{user}/{repo}/{date} для ключевых дат и сохраняйте результаты там, где хранятся ваши юридические артефакты.
  • Поместите бейдж в README. Помимо сигнала, который он посылает клиентам, живой бейдж верификации — дешёвое средство сдерживания против заявлений «мы разработали это независимо».
  • Храните доказательства в отдельной ветке или теневом репозитории. Ежедневные коммиты с доказательствами в выделенной ветке timestamps сохраняют читаемость основной истории и при этом держат доказательства привязанными к тому же репозиторию.
  • Запишите процесс. Для аудитора задокументируйте, кто установил GitHub App, какие репозитории отслеживаются и где находится ветка timestamps. Математика проверяема; цепочке хранения всё ещё нужен абзац.

FAQ

Нужно ли устанавливать какое-либо ПО на машины разработчиков?

Нет. Timestamp GIT — это управляемый сервис, который полностью работает на стороне сервера через GitHub App. Разработчики просто коммитят как обычно; никаких CLI-инструментов или локальных установок не требуется.

Сколько времени занимает простановка метки времени на коммит?

Коммиты собираются в ночные батчи и привязываются к Bitcoin. Подтверждение в Bitcoin обычно занимает около 3 часов, поэтому доказательства, как правило, доступны через несколько часов после запуска ночного cron.

Могу ли я проверять доказательства без сервиса?

Да. Вы получаете неизменяемый файл-квитанцию .ots, который можно проверить офлайн с помощью стандартных инструментов OpenTimestamps по блокчейну Bitcoin. Доказательство не зависит от вендора и опирается только на SHA-256 и данные блоков Bitcoin.

Что если я использую приватный репозиторий?

GitHub App работает с приватными репозиториями. URL статуса для приватных репозиториев содержат зашифрованный HMAC, специфичный для вашего экземпляра сервера, так что просматривать статус могут только авторизованные пользователи.

Заключение

Вся ценность записи prior art в том, что она существует, когда она вам нужна, а значит, она не может зависеть от того, что человек помнит команду. Установите GitHub App один раз, и каждый коммит в отслеживаемых репозиториях будет поставлен в очередь, собран в батч в полночь, сведён в корень Меркла и привязан к Bitcoin — с доказательствами, отправленными обратно в принадлежащую вам ветку, панелью статуса, которую можно проверить, и экспортом в CSV и PDF для аудиторов.

Если причина, по которой вы до сих пор не ставили метки времени на свой код, в том, что это всегда выглядело как рутина, — эта причина только что исчезла. Начните с timestampgit.dev — подключите репозиторий, дайте отработать первому ночному батчу и посмотрите на календарную тепловую карту на следующее утро.

Похожие статьи

EU label: AI-generated content