forgeplan log

Показывает журнал изменений - дополняемый аудиторский след каждой мутации артефакта в рабочем пространстве. Каждая запись фиксирует, кто/что изменил какой артефакт, когда и через какой источник (команда CLI, редактирование файла, синхронизация Git или переиндексация).

Когда использовать

“Что изменилось за последний день?” - контекст для утреннего стендапа
Отладка причин неожиданного изменения оценки или статуса
Просмотр активности коллеги в общем рабочем пространстве
Проверка успешности синхронизации Git или переиндексации

Когда не использовать

Если нужны только решения (а не все мутации) → используйте forgeplan journal
Если нужен сводный отчёт о состоянии проекта → используйте forgeplan health
Если нужно искать содержимое → используйте forgeplan search

Использование

forgeplan log [OPTIONS] [ID]

Аргументы

  [ID]  Фильтровать по ID артефакта

Опции

  -n, --limit <LIMIT>    Максимальное количество записей (по умолчанию: 20) [default: 20]
      --source <SOURCE>  Фильтровать по источнику (cli, file_edit, git_sync, reindex)
      --json             Вывод в формате JSON для машинной обработки
  -h, --help             Показать справку
  -V, --version          Показать версию

Примеры

Последние 20 событий по всем артефактам (по умолчанию):

forgeplan log

История одного конкретного PRD:

forgeplan log PRD-001

Только мутации, инициированные через CLI, последние 50 - отфильтровать шум от редактирования файлов:

forgeplan log --source cli --limit 50

Интерпретация вывода

Каждая строка - это одно событие:

2026-04-11 14:32  cli        PRD-001   activate       draft → active
2026-04-11 14:28  cli        PRD-001   link           → EVID-012 (informs)
2026-04-11 14:20  file_edit  PRD-001   body_update    (detected by scan-import)
2026-04-11 13:55  cli        EVID-012  create         EvidencePack created

Столбец	Значение
Timestamp	Локальное время мутации
Source	`cli`, `file_edit`, `git_sync`, `reindex`
Artifact ID	Что изменилось
Action	create, update, link, activate, supersede, deprecate, и т. д.
Detail	Дельта в удобочитаемом формате

Если синхронизация Git включена, записи могут включать короткий хеш коммита в столбце «Detail», связывая мутацию с коммитом Git.

Как это работает

log - это низкоуровневый след мутаций. Представления более высокого уровня фильтруют его:

log        (всё, что произошло)
  ↓
journal    (только решения с R_eff)
  ↓
health     (агрегированное состояние проекта)

См. также

forgeplan journal - хронология только решений
forgeplan health - агрегированная панель мониторинга
forgeplan session - текущая фаза рабочего процесса