pi-goal-pro 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -0,0 +1,90 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.2.0] - 2026-06-11
+
+### Added
+- `.claude/CLAUDE.md` — agent instructions with git workflow and code style guide
+- `.pi/prompts/commit.md` — AI prompt template for conventional commit messages
+- `.pi/prompts/review.md` — AI prompt template for code review with checklist
+- `VERSION` file — single source of truth for version number
+- `.gitattributes` — consistent line endings (LF) and diff settings
+- `.githooks/pre-commit` — Biome check on staged files before each commit
+- `.githooks/commit-msg` — Enforce conventional commit format on each commit
+- `prepare` script — auto-configures git hooks path on `npm install`
+- `typecheck` script — `tsc --noEmit` for TypeScript validation
+- `check:all` script — runs both Biome check and typecheck
+- `lint-staged` config in package.json for pre-commit checks
+
+### Changed
+- **CI workflow**: renamed from `test.yml`, now with `concurrency` group and `cancel-in-progress: true`
+- **CI split into two jobs**: `quality` (lint + typecheck) and `test` (unit tests on matrix)
+- **CI matrix**: expanded to `os: [ubuntu-latest, macos-latest]` × `node: [20, 22]`
+- **release.yml**: added tag-version verification, pre-release npm tag detection, `make_latest: true`
+- `test:all` script now runs `check:all` (lint + format + typecheck) before tests
+- README CI badge fixed to point to `test.yml` instead of non-existent `ci.yml`
+- `.gitignore` expanded: added IDE files, logs, `.tgz`, coverage, `ideal-git-workflow.md`
+- Fixed TypeScript `typeof theme` scoping error in index.ts
+
+## [1.1.1] - 2026-06-11
+
+### Added
+
+- Separate `test.yml` (push/PR) and `release.yml` (tag + workflow_dispatch) CI/CD pipelines
+- `CHANGELOG.md` following Keep a Changelog format
+- `README.ru.md` — Russian language documentation
+- `workflow_dispatch` trigger for manual releases
+- `npm publish --provenance` for supply chain security
+
+### Changed
+
+- Split monolithic CI/CD into focused workflows (test quality vs. release)
+- README installation order: npm install first, manual copy second
+- Updated `.gitignore` to exclude `dist/` and `.env`
+- Cleaner package.json scripts (`npm test` = only tests, `npm run test:all` = lint + tests)
+
+### Fixed
+
+- Biome linter warnings (non-null assertions → type casts)
+- Message renderer cognitive complexity
+
+## [1.1.0] - 2026-06-11
+
+### Added
+
+- 48 unit tests covering all pure functions
+- Biome linter + strict TypeScript configuration
+- GitHub Actions CI/CD pipeline
+
+### Changed
+
+- Split README into English (`README.md`) and Russian (`README.ru.md`)
+- Simplified message renderer to reduce cognitive complexity
+
+### Fixed
+
+- Non-null assertion warnings in `parseTokenBudget` and `parseMaxAutoTurns`
+
+## [1.0.1] - 2026-06-11
+
+### Added
+
+- Initial npm publish
+
+## [1.0.0] - 2026-06-11
+
+### Added
+
+- `/goal <objective> [--tokens N] [--max-turns N]` command
+- `get_goal` and `update_goal` tools for the agent
+- Auto-continuation loop with no-progress detection
+- Evidence-based completion (evidence/blocker required)
+- Token budget tracking with auto-pause
+- User input suspends auto-continuation
+- Session entry persistence (survives reload, compaction, tree navigation)
+- Footer status bar
+- Bilingual README (English + Russian)

package/README.md

@@ -2,7 +2,7 @@
 <p align="center">
   <img src="https://img.shields.io/badge/pi-extension-8B5CF6?style=flat-square&logo=pi-hole&logoColor=white" alt="pi extension">
   <img src="https://img.shields.io/npm/v/pi-goal-pro?style=flat-square&color=cb3837" alt="npm">
-  <img src="https://img.shields.io/github/actions/workflow/status/izzzzzi/pi-goal-pro/ci.yml?style=flat-square&branch=main" alt="CI">
+  <img src="https://img.shields.io/github/actions/workflow/status/izzzzzi/pi-goal-pro/test.yml?style=flat-square&branch=main" alt="CI">
   <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT">
 </p>
 
@@ -22,15 +22,18 @@ Then walk away. The agent keeps going. When it's done, it reports with evidence.
 
 ## Installation
 
+### Via npm (recommended)
+
 ```bash
-mkdir -p ~/.pi/agent/extensions/pi-goal-pro
-# Copy the extension file:
-cp ./index.ts ~/.pi/agent/extensions/pi-goal-pro/
+pi install npm:pi-goal-pro
+/reload
 ```
 
-Then reload Pi:
+### Manual
 
-```
+```bash
+mkdir -p ~/.pi/agent/extensions/pi-goal-pro
+cp ./index.ts ~/.pi/agent/extensions/pi-goal-pro/
 /reload
 ```
 
@@ -283,116 +286,3 @@ Inspired by and building upon:
 ## License
 
 MIT
-
----
-
-# pi-goal-pro 🎯
-
-> Персистентные автономные цели для [Pi](https://pi.dev) — с детекцией отсутствия прогресса, завершением на основе доказательств, бюджетом токенов и автопродолжением.
-
-Задай долгоживущую цель — и агент будет работать автономно, пока не закончит, не будет приостановлен или не упрётся в ограничение. Без необходимости повторять промпт каждый turn.
-
-```bash
-/goal Переписать auth модуль на JWT с нормальной обработкой ошибок
-```
-
-Можно отойти от клавиатуры. Агент продолжает сам. Когда закончит — отчитается с доказательствами.
-
----
-
-## Установка
-
-```bash
-mkdir -p ~/.pi/agent/extensions/pi-goal-pro
-# Скопировать файл расширения:
-cp ./index.ts ~/.pi/agent/extensions/pi-goal-pro/
-```
-
-Перезагрузить Pi:
-
-```
-/reload
-```
-
-Проверить что загрузилось:
-
-```
-/goal status
-```
-
----
-
-## Быстрый старт
-
-Задай цель — агент начнёт работать:
-
-```text
-/goal Добавить retry логику в API клиент с экспоненциальной задержкой
-```
-
-Агент начинает немедленно. Статус в футере:
-
-```
-🎯 goal active (1.2K/50K)    ← статус в футере
-```
-
-Управление жизненным циклом:
-
-```text
-/goal status        # Показать текущее состояние
-/goal pause         # Приостановить активную цель
-/goal resume        # Возобновить приостановленную
-/goal clear         # Удалить все цели
-```
-
----
-
-## Инструменты агента
-
-Когда цель активна, агент получает два инструмента:
-
-**`get_goal`** — прочитать состояние цели.
-
-**`update_goal`** — завершить цель (с доказательствами) или признать недостижимой (с причиной):
-
-```typescript
-// Завершено — нужно подтверждение
-update_goal({
-  status: "complete",
-  evidence: "JWT middleware реализован, 12 тестов проходят, CI без регрессий"
-})
-
-// Недостижимо — нужно объяснение
-update_goal({
-  status: "unmet",
-  blocker: "Заблокировано решением по JWT библиотеке — ожидание security review"
-})
-```
-
----
-
-## Как это работает
-
-Состояние цели хранится в session entry (custom type `pi-goal-pro`). Оно переживает:
-- Перезагрузку сессии (`/reload`)
-- Компактизацию (compaction)
-- Навигацию по дереву сессии (`/tree`)
-- Возобновление сессии
-
-Состояние привязано к ветке — при переходе на другую ветку восстанавливается состояние целей для этой ветки.
-
----
-
-## Философия дизайна
-
-1. **Пользователь владеет целью** — Агент не может молча изменить objective.
-2. **Доказательства перед завершением** — Агент должен верифицировать по реальным артефактам.
-3. **Никаких бесконечных циклов** — Детекция отсутствия прогресса, лимит turn-ов и бюджет токенов.
-4. **Ввод пользователя приостанавливает** — Когда ты печатаешь, автопродолжение ставится на паузу.
-5. **Состояние привязано к ветке** — `/tree` в другую точку восстанавливает цели этой точки.
-
----
-
-## Лицензия
-
-MIT

package/README.ru.md

@@ -0,0 +1,252 @@
+
+<p align="center">
+  <img src="https://img.shields.io/badge/pi-extension-8B5CF6?style=flat-square&logo=pi-hole&logoColor=white" alt="pi extension">
+  <img src="https://img.shields.io/npm/v/pi-goal-pro?style=flat-square&color=cb3837" alt="npm">
+  <img src="https://img.shields.io/github/actions/workflow/status/izzzzzi/pi-goal-pro/ci.yml?style=flat-square&branch=main" alt="CI">
+  <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT">
+</p>
+
+# pi-goal-pro 🎯
+
+> Персистентные автономные цели для [Pi](https://pi.dev) — с детекцией отсутствия прогресса, завершением на основе доказательств, бюджетом токенов и автопродолжением.
+
+Задай долгоживущую цель — и агент будет работать автономно, пока не закончит, не будет приостановлен или не упрётся в ограничение. Без необходимости повторять промпт каждый turn.
+
+```bash
+/goal Переписать auth модуль на JWT с нормальной обработкой ошибок
+```
+
+Можно отойти от клавиатуры. Агент продолжает сам. Когда закончит — отчитается с доказательствами.
+
+---
+
+## Установка
+
+```bash
+pi install npm:pi-goal-pro
+```
+
+Или вручную:
+
+```bash
+mkdir -p ~/.pi/agent/extensions/pi-goal-pro
+cp ./index.ts ~/.pi/agent/extensions/pi-goal-pro/
+```
+
+Перезагрузить Pi:
+
+```
+/reload
+```
+
+Проверить что загрузилось:
+
+```
+/goal status
+```
+
+---
+
+## Быстрый старт
+
+Задай цель — агент начнёт работать:
+
+```text
+/goal Добавить retry логику в API клиент с экспоненциальной задержкой
+```
+
+Агент начинает немедленно. Статус в футере:
+
+```
+🎯 goal active (1.2K/50K)    ← статус в футере
+```
+
+Управление жизненным циклом:
+
+```text
+/goal status        # Показать текущее состояние
+/goal pause         # Приостановить активную цель
+/goal resume        # Возобновить приостановленную
+/goal clear         # Удалить все цели
+```
+
+---
+
+## Возможности
+
+### 🎯 Установка цели
+
+```text
+/goal Переписать auth модуль
+
+# С бюджетом токенов (автопауза при превышении):
+/goal Переписать auth модуль --tokens 100k
+
+# С лимитом авто-продолжений:
+/goal Переписать auth модуль --max-turns 10
+```
+
+### 🤖 Инструменты агента
+
+Когда цель активна, агент получает два инструмента:
+
+**`get_goal`** — прочитать состояние цели:
+
+```json
+{
+  "active": {
+    "objective": "Переписать auth модуль на JWT",
+    "status": "active",
+    "tokens_used": 12400,
+    "token_budget": 50000,
+    "remaining_tokens": 37600,
+    "time_used_seconds": 89,
+    "auto_turns": 3,
+    "max_auto_turns": 25
+  }
+}
+```
+
+**`update_goal`** — завершить цель или признать недостижимой:
+
+```typescript
+// Завершено — нужно подтверждение
+update_goal({
+  status: "complete",
+  evidence: "JWT middleware реализован, 12 тестов проходят, CI без регрессий"
+})
+
+// Недостижимо — нужно объяснение
+update_goal({
+  status: "unmet",
+  blocker: "Заблокировано решением по JWT библиотеке — ожидание security review"
+})
+```
+
+### 🔄 Автопродолжение
+
+После каждого turn агента расширение автоматически отправляет continuation prompt, если:
+- Цель всё ещё `active`
+- Предыдущий turn был goal-driven
+- Пользователь ничего не вводил (ввод приостанавливает автопродолжение)
+- Не достигнуты лимиты
+
+### 🛡️ Детекция отсутствия прогресса
+
+Если агент генерирует очень мало выходных токенов (по умолчанию <50) 2 раза подряд, цель автоматически приостанавливается:
+
+```
+⏸ Goal paused (no progress for 2 turns). Use /goal resume to continue.
+```
+
+Это предотвращает бесконечные циклы, когда агент просто подтверждает получение без реального прогресса.
+
+### 💰 Бюджет токенов
+
+Установи бюджет с `--tokens`:
+
+```text
+/goal Написать документацию для всех API эндпоинтов --tokens 100k
+```
+
+Когда бюджет исчерпан, цель приостанавливается с wrap-up промптом — агент подводит итог.
+
+### 📋 Завершение с доказательствами
+
+Агент обязан предоставить конкретные доказательства перед отметкой цели как выполненной. Это предотвращает преждевременные "done" и гарантирует верификацию по реальным файлам, тестам и выводам команд.
+
+---
+
+## Команды
+
+| Команда | Описание |
+|---------|----------|
+| `/goal <objective>` | Установить новую цель |
+| `/goal <text> --tokens N` | Цель с бюджетом токенов |
+| `/goal <text> --max-turns N` | Цель с лимитом авто-продолжений |
+| `/goal status` | Показать состояние |
+| `/goal pause` | Приостановить |
+| `/goal resume` | Возобновить |
+| `/goal clear` | Удалить все |
+| `/goal help` | Справка |
+
+---
+
+## Как это работает
+
+```
+/goal Переписать auth модуль
+        │
+        ▼
+  ✓ Цель создана, сохранена в session entry
+  ✓ Агент получил get_goal + update_goal
+  ✓ Первое продолжение запущено немедленно
+        │
+        ▼
+  ┌── Цикл автопродолжения ───────────────────┐
+  │                                           │
+  │  turn_start → turn_end → agent_end        │
+  │                              │            │
+  │                    ┌─────────┴─────────┐  │
+  │                    │ Цель активна?     │  │
+  │                    │ Нет прогресса?    │  │
+  │                    │ Пользователь ввёл?│  │
+  │                    │ Бюджет исчерпан?  │  │
+  │                    │ Лимит turn-ов?    │  │
+  │                    └─────────┬─────────┘  │
+  │                              │            │
+  │                    ┌─────────┴──────────┐ │
+  │                    │ Да → continuation  │ │
+  │                    │ Нет → stop/pause   │ │
+  │                    └────────────────────┘ │
+  │                                           │
+  └───────────────────────────────────────────┘
+        │
+        ▼
+  Агент вызывает update_goal({ status: "complete", evidence })
+  → Цель архивирована, агент остановлен
+```
+
+### Сохранение состояния
+
+Состояние цели хранится в session entry (custom type `pi-goal-pro`). Оно переживает:
+- Перезагрузку сессии (`/reload`)
+- Компактизацию (compaction)
+- Навигацию по дереву сессии (`/tree`)
+- Возобновление сессии
+
+Состояние привязано к ветке — при переходе на другую ветку восстанавливается состояние целей для этой ветки.
+
+---
+
+## Философия дизайна
+
+1. **Пользователь владеет целью** — Агент не может молча изменить objective.
+2. **Доказательства перед завершением** — Агент должен верифицировать по реальным артефактам.
+3. **Никаких бесконечных циклов** — Детекция отсутствия прогресса, лимит turn-ов и бюджет токенов.
+4. **Ввод пользователя приостанавливает** — Когда ты печатаешь, автопродолжение ставится на паузу.
+5. **Состояние привязано к ветке** — `/tree` в другую точку восстанавливает цели этой точки.
+
+---
+
+## Разработка
+
+Расширение в одном файле — не требует сборки. Правишь `index.ts`, затем `/reload`.
+
+Запуск без установки:
+
+```bash
+pi -e ~/.pi/agent/extensions/pi-goal-pro/index.ts
+```
+
+Тесты:
+
+```bash
+node --test tests/
+```
+
+---
+
+## Лицензия
+
+MIT

package/index.ts

@@ -691,27 +691,27 @@ Do not call update_goal unless the goal is actually complete.`;
 
 	// ── Message renderer for goal events ───────────────────────────────
 
-	const GOAL_KIND_LABELS: Record<string, (th: typeof theme) => string> = {
-		active: (th) => th.fg('accent', 'active'),
-		continuation: (th) => th.fg('muted', 'continuing'),
-		paused: (th) => th.fg('warning', 'paused'),
-		resumed: (th) => th.fg('accent', 'resumed'),
-		cleared: (th) => th.fg('dim', 'cleared'),
-		budget_limited: (th) => th.fg('warning', 'budget'),
-		complete: (th) => th.fg('success', 'achieved'),
-		unmet: (th) => th.fg('error', 'unmet'),
-	};
-
 	pi.registerMessageRenderer(`${GOAL_STORAGE_TYPE}:event`, (message, options, theme) => {
 		const details = message.details as GoalEvent | undefined;
 		const kind = details?.kind ?? 'continuation';
 		const state = details?.goal ?? null;
 
+		const goalKindLabels: Record<string, (th: typeof theme) => string> = {
+			active: (th) => th.fg('accent', 'active'),
+			continuation: (th) => th.fg('muted', 'continuing'),
+			paused: (th) => th.fg('warning', 'paused'),
+			resumed: (th) => th.fg('accent', 'resumed'),
+			cleared: (th) => th.fg('dim', 'cleared'),
+			budget_limited: (th) => th.fg('warning', 'budget'),
+			complete: (th) => th.fg('success', 'achieved'),
+			unmet: (th) => th.fg('error', 'unmet'),
+		};
+
 		const renderGoalEvent = (_width: number): string[] => {
 			const lines: string[] = [];
 			const isExpanded = options.expanded;
 			const prefix = theme.fg('accent', theme.bold('Goal'));
-			const kindLabel = (GOAL_KIND_LABELS[kind] ?? ((th: typeof theme) => th.fg('text', kind)))(theme);
+			const kindLabel = (goalKindLabels[kind] ?? ((th: typeof theme) => th.fg('text', kind)))(theme);
 			const statusText = theme.fg('dim', isExpanded ? '' : '(ctrl+o to expand)');
 
 			lines.push(`${prefix} ${kindLabel} ${!isExpanded ? statusText : ''}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-goal-pro",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Persistent autonomous goals for Pi — with no-progress detection, evidence-based completion, token budgets, and auto-continuation",
   "type": "module",
   "main": "./index.ts",
@@ -8,6 +8,8 @@
   "files": [
     "index.ts",
     "README.md",
+    "README.ru.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "keywords": [
@@ -53,11 +55,19 @@
     "tsx": "^4.0.0"
   },
   "scripts": {
-    "test": "npm run check && npm run test:unit",
+    "test": "npm run test:unit",
     "test:unit": "tsx --test tests/index.test.ts",
+    "test:all": "npm run check:all && npm run test:unit",
+    "lint": "biome lint .",
     "check": "biome check .",
+    "check:all": "npm run check && npm run typecheck",
+    "typecheck": "tsc --noEmit",
     "format": "biome format --write .",
-    "lint": "biome lint .",
+    "prepare": "git config core.hooksPath .githooks",
     "dev": "pi -e ./index.ts"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": ["npx @biomejs/biome check --write", "npx tsc --noEmit --pretty"],
+    "*.{json,md,yaml}": ["npx @biomejs/biome format --write"]
   }
 }