pi-goal-pro 1.0.1 → 1.1.1

package/CHANGELOG.md

@@ -0,0 +1,67 @@
+# 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).
+
+## [Unreleased]
+
+## [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

@@ -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

@@ -22,7 +22,6 @@
 
 import { StringEnum } from '@earendil-works/pi-ai';
 import type { ExtensionAPI, ExtensionContext } from '@earendil-works/pi-coding-agent';
-import { matchesKey } from '@earendil-works/pi-tui';
 import { Type } from 'typebox';
 
 // ─── Types ───────────────────────────────────────────────────────────────
@@ -119,7 +118,7 @@ function parseTokenBudget(input: string): { objective: string; tokenBudget: numb
 	if (!Number.isFinite(num) || num <= 0) return { objective: input.trim(), tokenBudget: null };
 	const mult = m[2]?.toLowerCase() === 'm' ? 1_000_000 : m[2]?.toLowerCase() === 'k' ? 1_000 : 1;
 	const budget = Math.round(num * mult);
-	const idx = m.index!;
+	const idx = m.index as number;
 	const objective = (input.slice(0, idx) + input.slice(idx + m[0].length)).trim();
 	return { objective, tokenBudget: budget };
 }
@@ -129,7 +128,7 @@ function parseMaxAutoTurns(input: string): { rest: string; maxAutoTurns: number
 	if (!m) return { rest: input.trim(), maxAutoTurns: null };
 	const turns = Number.parseInt(m[1], 10);
 	if (!Number.isFinite(turns) || turns <= 0) return { rest: input.trim(), maxAutoTurns: null };
-	const idx = m.index!;
+	const idx = m.index as number;
 	const rest = (input.slice(0, idx) + input.slice(idx + m[0].length)).trim();
 	return { rest, maxAutoTurns: turns };
 }
@@ -692,65 +691,50 @@ 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 box = new (class {
-			private children: import('@earendil-works/pi-tui').Component[] = [];
-
-			render(_width: number): string[] {
-				const lines: string[] = [];
-				const isExpanded = options.expanded;
-				const prefix = theme.fg('accent', theme.bold('Goal'));
-				const kindLabel = this.kindLabel(kind, theme);
-				const statusText = theme.fg('dim', isExpanded ? '' : '(ctrl+o to expand)');
-
-				lines.push(`${prefix} ${kindLabel} ${!isExpanded ? statusText : ''}`);
-
-				if (isExpanded && state) {
-					lines.push(`${theme.fg('dim', '  Status: ')}${theme.fg('text', kind)}`);
-					lines.push(`${theme.fg('dim', '  Goal: ')}${theme.fg('text', state.objective)}`);
-					if (state.completionEvidence) {
-						lines.push(`${theme.fg('dim', '  Evidence: ')}${theme.fg('success', state.completionEvidence)}`);
-					}
-					if (state.blocker) {
-						lines.push(`${theme.fg('dim', '  Blocker: ')}${theme.fg('warning', state.blocker)}`);
-					}
-					const usage = state.tokenBudget
-						? `${formatTokens(state.tokensUsed)}/${formatTokens(state.tokenBudget)}`
-						: formatDuration(state.timeUsedMs);
-					lines.push(`${theme.fg('dim', '  Usage: ')}${theme.fg('text', usage)}`);
-				}
-
-				return lines;
-			}
+		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 statusText = theme.fg('dim', isExpanded ? '' : '(ctrl+o to expand)');
 
-			invalidate(): void {}
+			lines.push(`${prefix} ${kindLabel} ${!isExpanded ? statusText : ''}`);
 
-			handleInput?(data: string): void {
-				if (matchesKey(data, 'escape') || matchesKey(data, 'ctrl+c')) {
-					// no-op, let parent handle
+			if (isExpanded && state) {
+				lines.push(`${theme.fg('dim', '  Status: ')}${theme.fg('text', kind)}`);
+				lines.push(`${theme.fg('dim', '  Goal: ')}${theme.fg('text', state.objective)}`);
+				if (state.completionEvidence) {
+					lines.push(`${theme.fg('dim', '  Evidence: ')}${theme.fg('success', state.completionEvidence)}`);
 				}
+				if (state.blocker) {
+					lines.push(`${theme.fg('dim', '  Blocker: ')}${theme.fg('warning', state.blocker)}`);
+				}
+				const usage = state.tokenBudget
+					? `${formatTokens(state.tokensUsed)}/${formatTokens(state.tokenBudget)}`
+					: formatDuration(state.timeUsedMs);
+				lines.push(`${theme.fg('dim', '  Usage: ')}${theme.fg('text', usage)}`);
 			}
 
-			private kindLabel(k: string, th: typeof theme): string {
-				const labels: Record<string, string> = {
-					active: th.fg('accent', 'active'),
-					continuation: th.fg('muted', 'continuing'),
-					paused: th.fg('warning', 'paused'),
-					resumed: th.fg('accent', 'resumed'),
-					cleared: th.fg('dim', 'cleared'),
-					budget_limited: th.fg('warning', 'budget'),
-					complete: th.fg('success', 'achieved'),
-					unmet: th.fg('error', 'unmet'),
-				};
-				return labels[k] ?? k;
-			}
-		})();
+			return lines;
+		};
 
-		return box;
+		return { render: renderGoalEvent, invalidate: () => {} };
 	});
 
 	// ── Commands ───────────────────────────────────────────────────────

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-goal-pro",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "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,12 @@
     "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 lint && npm run test:unit",
+    "lint": "biome lint .",
     "check": "biome check .",
     "format": "biome format --write .",
-    "lint": "biome lint .",
     "dev": "pi -e ./index.ts"
   }
 }