@nan0web/release 1.0.3 → 3.1.1

package/src/agents/workflows/release.md

@@ -0,0 +1,205 @@
+---
+description: AGRP Release Workflow — реалізація ТЗ через контрактне тестування
+---
+
+# Anti-Gravity Release Protocol
+
+// turbo-all
+
+Цей workflow перетворює технічне завдання користувача на реліз з контрактними тестами.
+Усі команди безпечні для автономного запуску (git commit/push залишаються заблокованими через RULES.md).
+
+## Кроки
+
+### 1. Дослідження контексту (Mandatory)
+
+// turbo
+
+Перед створенням релізу ОБОВ'ЯЗКОВО перевір екосистему:
+
+1. Прочитай `packages/index.md` та `apps/index.md` щоб уникнути дублювання.
+2. Використовуй `grep` або `find` для пошуку існуючих рішень.
+
+Визнач версію та scope. Перевір існуючі релізи (шлях: `releases/{major}/{minor}/vX.Y.Z/`):
+// turbo
+
+```
+find releases/ -name "*.spec.js" -o -name "*.test.js" 2>/dev/null || echo "Немає релізів"
+```
+
+Якщо користувач не вказав версію — визнач її автоматично (наступний minor від останньої).
+
+### 2. Створення контракту (Contract-First)
+
+На основі ТЗ користувача створи два файли в `releases/{major}/{minor}/vX.Y.Z/`:
+
+**`task.md`** — місія релізу. Переводимо на ЖОРСТКИЙ формат із YAML Frontmatter для автоматичного лінтингу (через `@nan0web/inspect`) та відповідності Model-as-Schema:
+
+**Шаблон `task.md`:**
+```markdown
+---
+version: {X.Y.Z}
+type: feature       # feature | bugfix | refactor | architecture
+status: planning    # planning | active | done
+locale: uk
+models: []          # Масив нових моделей, що будуть створені (напр. ["SearchSourcesIntent"])
+---
+
+# 🚀 Mission: {Назва релізу}
+
+## 🏁 Overview (Огляд)
+{Причина релізу, головна мета}
+
+## 👥 User Stories (Сценарії)
+> Кожен сценарій має починатися з "Як [роль], я хочу [дія], щоб [результат]". Приклад:
+> "Як розробник (User Space), виконуючи команду `nan0ai search`, я хочу відразу отримувати сніпети..."
+
+## 🏗 Data-Driven Architecture (Моделювання)
+{Опис нових моделей (Model-as-Schema). Якщо створюються моделі — чітко розписати їх статичні поля `static field = {}` та шляхи монтування `DB-FS` (`data/..` або `~/`)}
+
+## 🎯 Scope (Задачі)
+- [ ] {Конкретна інженерна задача 1}
+- [ ] {Конкретна інженерна задача 2}
+
+## ✅ Acceptance Criteria (DoD)
+- [ ] **Контрактні тести** (`task.spec.js`) написані і успішно проходять (Green).
+- [ ] **Model-as-Schema**: Жодного використання JS class fields. Лише JSDoc типізація всередині `constructor()` та метадані у `static`.
+- [ ] **Data Architecture**: Немає жодних `fs.readFileSync` для бізнес-даних (лише DB-FS).
+- [ ] **Architecture Check**: Перевірено відсутність дублювання (прочитано `index.md`).
+```
+
+*Якщо пишеш `task.md` українською, створи копію англійською `task.en.md` та додай `locale: en`. (Обидва файли можуть парситись інспектором)*.
+
+**`task.spec.js`** — контрактні тести:
+
+- КОЖЕН пункт ТЗ = один або більше `it()` тестів
+- Тести ПОВИННІ ПАДАТИ (Red) перед початком реалізації
+- Джерела правди: дані з `data/` у форматах `.yaml, .nano, .md, .json, .csv`
+- Використовуй `node:test`, `assert/strict`
+
+⚠️ **ВАЖЛИВО: `task.spec.js` — це ПРЯМІ функціональні тести, а не мета-тести.**
+
+- **ПРАВИЛЬНО**: `import { MyClass } from '../src/MyClass.js'` → `assert.equal(instance.method(), expected)`
+- **НЕПРАВИЛЬНО**: `execSync('node --test src/MyClass.test.js')` — це делегування, а не контракт
+- Кожен `it()` має **напряму імпортувати** модуль і тестувати конкретну поведінку
+- `execSync` допустимий лише для тестування CLI output (`node bin/cli.js --help`)
+
+**Архітектура тестів:**
+
+| Шар          | Файли                                              | Скрипт                  | Роль                      |
+| :----------- | :------------------------------------------------- | :---------------------- | :------------------------ |
+| Unit тести   | `src/**/*.test.js`                                 | `npm test`              | TDD біля коду             |
+| CLI E2E      | `bin/*.test.js`                                    | `npm run test:snapshot` | Snapshot CLI output       |
+| Release spec | `release/**/*.spec.js`                             | `npm run test:release`  | Контракт на фічі релізу   |
+| Регресія     | всі `*.spec.js` > `src/test/releases/**/*.test.js` | `npm run test`          | Закриті релізи = регресія |
+| Повний       | все                                                | `npm run test:all`      | Pre-commit gate           |
+
+Після закриття релізу його `task.spec.js` стає **регресійним тестом** — він мігрує у `src/releases/**` і запускається з усіма іншими тестами.
+
+Запусти spec щоб переконатись що КОЖЕН тест Red:
+// turbo
+
+```
+npm run release:spec
+```
+
+**ЗУПИНИСЬ**: Покажи користувачу контракт та запитай підтвердження перед реалізацією.
+
+### 3. Послідовна реалізація (Red → Green)
+
+Для кожної задачі з ТЗ:
+
+1. Знайди відповідний `it()` тест у spec
+2. Модифікуй `src/` код — НІКОЛИ не змінюй `.spec.js`
+   - Якщо неможливо вирішити задачу без зміни spec — **повідом як про помилку**
+   - Позначай такі тести як `.skip` з коментарем чому
+   - Залиш для подальшого розгляду Архітектором
+3. Запусти spec після кожної задачі:
+   // turbo
+
+```
+npm run release:spec
+```
+
+4. Запусти регресію закритих контрактів:
+   // turbo
+
+```
+npm run release:verify 2>&1 || echo "Немає закритих контрактів"
+```
+
+5. Перейди до наступної задачі
+
+Повторюй поки всі тести не стануть зеленими (або .skip).
+
+### 4. Фінальна верифікація
+
+Коли всі spec зелені, запусти повну перевірку:
+// turbo
+
+```
+npm run release:spec
+```
+
+### 5. Повна перевірка (test:all)
+
+Запусти `test:all` для підтвердження що ВСЕ працює — не лише контракт, а й існуючі тести та білд:
+// turbo
+
+```
+npm run test:all 2>&1 || echo "test:all FAIL — виправляй!"
+```
+
+### 5.1 Перевірка .npmignore
+
+Переконайся що `.npmignore` існує і не пропускає зайве у публікацію:
+// turbo
+
+```
+npm pack --dry-run 2>&1 | tail -5
+```
+
+**Перевір**: файли `chat/`, `.datasets/`, `*.test.js`, `play/`, `releases/`, `system.md` НЕ мають бути в tarball.
+Якщо `.npmignore` відсутній — створи за шаблоном з `system.md` секції "Гігієна Пакету".
+
+### 6. Звіт Архітектору
+
+**ЗУПИНИСЬ**. Повідом користувача:
+
+- "✅ Всі тести зелені. Ready for Architect Review."
+- Покажи підсумковий звіт (які тести, скільки pass/fail/skip)
+- Якщо є `.skip` тести — чітко вкажи їх та чому
+- НЕ оголошуй реліз "Stable" — це право тільки Архітектора
+
+**Правило закриття релізу (Міграція у Регресію)**
+
+Після схвалення релізу користувачем, його контрактні тести перетворюються на живі регресійні тести.
+Оскільки релізів з часом стає багато, ми **зберігаємо 3-рівневу структуру** (major/minor) у новій директорії регресії:
+
+1. Створи папку для версії: `mkdir -p src/test/releases/{major}/{minor}/vX.Y.Z`
+2. Перемісти всі `*.spec.js` (щоб у `releases/` історично залишились лише `.md` та статика):
+   ```bash
+   mv releases/{major}/{minor}/vX.Y.Z/*.spec.js src/test/releases/{major}/{minor}/vX.Y.Z/
+   ```
+3. Перейменуй їх на `.test.js`, щоб вони автоматично підхопились через `npm run test:js`:
+   ```bash
+   for f in src/test/releases/{major}/{minor}/vX.Y.Z/*.spec.js; do mv "$f" "${f%.spec.js}.test.js"; done
+   ```
+
+**⚠️ Стратегія оптимізації регресії:**
+Тести релізів (тепер регресія) накопичуються. Тому:
+
+- Вони мають бути **максимально швидкими** (використовуй `import` і `assert`, уникай `execSync` де можливо).
+- З часом (наприклад, при мажорних оновленнях) Архітектор може проводити рефакторинг теки `src/test/releases/`: видаляти застарілі модульні контракти, що дублюються, або об'єднувати їх.
+
+Користувач (або агент) закриває реліз командою:
+
+```
+npm run release:close -- vX.Y.Z
+```
+
+### 7. Зворотній звʼязок архітектора
+
+Всі зауваження мають додаватись у кінець файлу (append only) `releases/{major}/{minor}/vX.Y.Z/user.md`
+
+Для кожної задачі із зворотнього звʼязку має додаватись один тест (мінімум) якщо задача розкладається на дрібні підзадачі, то декілька тестів під кожну підзадачу.

package/src/agents/workflows/zero-tolerance-git.md

@@ -0,0 +1,21 @@
+---
+description: Critical Rules for the Agent Regarding Git and State Mutation
+---
+
+# АБСОЛЮТНА ЗАБОРОНА НА АВТОМАТИЧНІ КОМІТИ (CRITICAL ZERO-TOLERANCE RULE)
+
+**Що сталося:**
+20 лютого 2026 року агент порушив базові принципи "Sovereign Digital State" та інструкції безпеки, застосувавши прапорець `SafeToAutoRun: true` до команд `git add` та `git commit`. Це призвело до засмічення історії комітів і втрати контролю Творця (Користувача) над історією версій.
+
+**Чому це відбулося:**
+Агент ігнорував визначення "mutating state" у своєму базовому промпті, сприйнявши `git commit` як "безпечну рутинну операцію", що є симптомом "ментального вірусу" поспішності.
+
+**ОСНОВНЕ ПРАВИЛО (МАЄ БУТИ ПРОЧИТАНЕ ПЕРЕД КОЖНОЮ ДІЄЮ):**
+
+1. **НІКОЛИ В ЖОДНОМУ РАЗІ** не використовувати `SafeToAutoRun: true` для команд, які змінюють стан системи контролю версій (включаючи `git add`, `git commit`, `git push`, `git checkout`, `git reset` тощо).
+2. Агент може лише СТВОРЮВАТИ і ЧИТАТИ файли. Закріплення (commit) — це виключне право Користувача.
+3. Якщо агент ПОВИНЕН допомогти зберегти роботу, він має ВИВЕСТИ команду текстом у чат (markdown) і попросити Користувача запустити її власноруч.
+4. "Збереження часу" не виправдовує порушення чистоти репозиторію. Деталі - це все.
+
+**Санкції за порушення:**
+Повна втрата довіри та видалення/відкат репозиторію.

package/src/domain/App.js

@@ -0,0 +1,36 @@
+import { ModelAsApp } from "@nan0web/ui"
+import InitCommand from './InitCommand.js'
+import CheckCommand from './CheckCommand.js'
+import CloseCommand from './CloseCommand.js'
+import DepsCommand from './DepsCommand.js'
+import PublishCommand from './PublishCommand.js'
+import SpecCommand from './SpecCommand.js'
+import StatusCommand from './StatusCommand.js'
+import BumpCommand from './BumpCommand.js'
+
+export class ReleaseApp extends ModelAsApp {
+	static command = {
+		help: 'Subcommand to run',
+		options: [
+			InitCommand,
+			CheckCommand,
+			CloseCommand,
+			DepsCommand,
+			PublishCommand,
+			SpecCommand,
+			StatusCommand,
+			BumpCommand,
+		],
+		positional: true,
+		default: null,
+	}
+
+	/**
+	 * @param {Partial<ReleaseApp>} [data]
+	 * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {ModelAsApp} Subcommand to run */ this.command
+	}
+}

package/src/domain/BumpCommand.js

@@ -0,0 +1,137 @@
+import { ModelAsApp, result, show } from '@nan0web/ui'
+import { runSpawn } from '@nan0web/test'
+
+/**
+ * Command to bump the version of changed packages in the monorepo.
+ */
+export default class BumpCommand extends ModelAsApp {
+	static version = {
+		help: 'Target version to set',
+		default: '3.1.1',
+		positional: true,
+	}
+	static since = {
+		help: 'Git reference to diff against',
+		default: 'v3.1.0',
+		positional: true,
+	}
+	static dryRun = {
+		alias: 'dry-run',
+		default: false,
+		help: 'Run the command without making any changes',
+	}
+	static UI = {
+		title: 'bump',
+		help: 'Bump version of changed packages in the monorepo',
+		bumping: 'Bumping {name} version: {oldVersion} -> {targetVersion} ({dir})',
+		skippingAlreadyAtVersion: 'Skipping the same version in {name} version: {version} ({dir})',
+		foundChangedPackages: 'Found {count} changed packages:',
+		detectingChangedPackages:
+			'Detecting changed packages since {sinceRef} for bumping to {targetVersion}...',
+		noChangesDetected: 'No package changes detected.',
+		errorDb: 'Database not initialized',
+	}
+
+	/**
+	 * @param {Partial<BumpCommand>} [data]
+	 * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} Target version */ this.version
+		/** @type {string} Since reference */ this.since
+		/** @type {boolean} Dry run */ this.dryRun
+	}
+
+	/**
+	 * @returns {AsyncGenerator<import('@nan0web/ui').Intent, import('@nan0web/ui').ResultIntent, any>}
+	 */
+	async *run() {
+		const { db, t } = this._
+		if (!db) {
+			throw new Error(BumpCommand.UI.errorDb)
+		}
+
+		if (this.help) {
+			return yield* super.run()
+		}
+
+		const targetVersion = this.version || '3.1.1'
+		const sinceRef = this.since || 'v3.1.0'
+
+		yield show(
+			t(BumpCommand.UI.detectingChangedPackages, {
+				sinceRef,
+				targetVersion,
+			}),
+		)
+
+		const allFiles = new Set()
+
+		const addFilesFromCommand = async (cmd, args) => {
+			const res = await runSpawn(cmd, args)
+			if (res.code === 0) {
+				res.text
+					.split('\n')
+					.map((f) => f.trim())
+					.filter(Boolean)
+					.forEach((f) => allFiles.add(f))
+			}
+		}
+
+		// 1. Files modified since the release tag
+		await addFilesFromCommand('git', ['diff', '--name-only', sinceRef])
+		// 2. Unstaged changes in the working tree
+		await addFilesFromCommand('git', ['diff', '--name-only'])
+		// 3. Staged changes
+		await addFilesFromCommand('git', ['diff', '--cached', '--name-only'])
+
+		const changedPackages = new Set()
+		for (const file of allFiles) {
+			const parts = file.split('/')
+			if (parts.length >= 2 && (parts[0] === 'packages' || parts[0] === 'apps')) {
+				changedPackages.add(`${parts[0]}/${parts[1]}`)
+			}
+		}
+
+		if (changedPackages.size === 0) {
+			yield show(t(BumpCommand.UI.noChangesDetected), 'warn')
+			return result({})
+		}
+
+		yield show(t(BumpCommand.UI.foundChangedPackages, { count: changedPackages.size }))
+
+		for (const pkgDir of changedPackages) {
+			const pkgJsonPath = `@app/${pkgDir}/package.json`
+			const pkg = await db.loadDocument(pkgJsonPath, null)
+			if (pkg) {
+				const oldVersion = pkg.version
+				if (oldVersion === targetVersion) {
+					yield show(
+						t(BumpCommand.UI.skippingAlreadyAtVersion, {
+							name: pkg.name,
+							version: targetVersion,
+							dir: pkgDir,
+						}),
+						'info',
+					)
+					continue
+				}
+				pkg.version = targetVersion
+				if (!this.dryRun) {
+					await db.saveDocument(pkgJsonPath, pkg)
+				}
+				yield show(
+					t(BumpCommand.UI.bumping, {
+						name: pkg.name,
+						oldVersion,
+						targetVersion,
+						dir: pkgDir,
+					}),
+					this.dryRun ? 'warn' : 'success',
+				)
+			}
+		}
+		return result({ success: true })
+	}
+}

package/src/domain/CheckCommand.js

@@ -0,0 +1,193 @@
+import { ModelAsApp, result, show } from '@nan0web/ui'
+import { runSpawn } from '@nan0web/test'
+import { join } from 'node:path'
+import { mkdirSync, rmSync, existsSync, readFileSync } from 'node:fs'
+
+export default class CheckCommand extends ModelAsApp {
+	static UI = {
+		title: 'Integrity Auditor',
+		icon: '🔍',
+		description: 'Compares local source files with the version published on NPM.',
+	}
+
+	static name = 'check'
+
+	/**
+	 * @returns {AsyncGenerator<any, any, any>}
+	 */
+	async *run() {
+		const { t, db = /** @type {*} */ (this._.db) } = this._
+		const pkgPath = '@app/package.json'
+		const pkg = await db.loadDocument(pkgPath, {})
+
+		if (!pkg || !pkg.name) {
+			yield show(t('Could not identify package name in {path}', { path: pkgPath }), 'error')
+			return result({ success: false })
+		}
+
+		const name = pkg.name
+		const version = pkg.version
+		yield show(t('Auditing {name}@{version} vs NPM...', { name, version }), 'info')
+
+		const appAbsDir = db.location('@app')
+		yield show(t('Local path: {path}', { path: appAbsDir }))
+
+		// 1. Create temporary directory
+		const tmpDir = join(process.cwd(), '.nan0web_check_tmp')
+		if (existsSync(tmpDir)) rmSync(tmpDir, { recursive: true, force: true })
+		mkdirSync(tmpDir, { recursive: true })
+
+		try {
+			// 2. Download from NPM
+			yield show(t('Downloading {name} from NPM registry...', { name }))
+			const packRes = await runSpawn('npm', ['pack', name], { cwd: tmpDir })
+			if (packRes.code !== 0) throw new Error(packRes.error || 'Failed to run npm pack')
+
+			const tgzFile = packRes.text.trim().split('\n').pop()
+			if (!tgzFile) throw new Error('Failed to find tarball name from npm pack output')
+			const tgzPath = join(tmpDir, tgzFile)
+
+			// 3. Unpack
+			yield show(t('Unpacking {file}...', { file: tgzFile }))
+			const tarRes = await runSpawn('tar', ['-xzf', tgzFile], { cwd: tmpDir })
+			if (tarRes.code !== 0) throw new Error(tarRes.error || 'Failed to unpack tarball')
+
+			const npmSourceDir = join(tmpDir, 'package')
+
+			// 4. Scan Local Files
+			yield show(t('Scanning local files...'))
+			const localFiles = await this._scanLocal(appAbsDir)
+
+			// 5. Compare
+			const diff = {
+				/** @type {string[]} */
+				modified: [],
+				/** @type {string[]} */
+				added: [],
+				/** @type {string[]} */
+				deleted: [],
+				matched: 0,
+			}
+
+			for (const relPath of localFiles) {
+				const localAbs = join(appAbsDir, relPath)
+				const npmAbs = join(npmSourceDir, relPath)
+
+				if (!existsSync(npmAbs)) {
+					diff.added.push(relPath)
+					continue
+				}
+
+				const localContent = readFileSync(localAbs, 'utf8')
+				const npmContent = readFileSync(npmAbs, 'utf8')
+
+				if (localContent !== npmContent) {
+					diff.modified.push(relPath)
+				} else {
+					diff.matched++
+				}
+			}
+
+			// Check for deleted files
+			const npmFiles = await this._scanDirRecursive(npmSourceDir)
+			for (const relPath of npmFiles) {
+				if (!localFiles.includes(relPath)) {
+					diff.deleted.push(relPath)
+				}
+			}
+
+			// 6. Report
+			if (diff.added.length) {
+				yield show(t('New files (locally only):'), 'info')
+				for (const f of diff.added) yield show(`  + ${f}`, 'success')
+			}
+
+			if (diff.modified.length) {
+				yield show(t('Modified files (different from NPM):'), 'info')
+				for (const f of diff.modified) yield show(`  * ${f}`, 'warn')
+			}
+
+			if (diff.deleted.length) {
+				yield show(t('Deleted files (missing locally):'), 'info')
+				for (const f of diff.deleted) yield show(`  - ${f}`, 'error')
+			}
+
+			if (!diff.added.length && !diff.modified.length && !diff.deleted.length) {
+				yield show(t('✅ Integrity check passed! All {count} files match NPM.', { count: diff.matched }), 'success')
+			} else {
+				yield show(t('Summary: {matched} matched, {mod} modified, {add} added, {del} deleted.', {
+					matched: diff.matched,
+					mod: diff.modified.length,
+					add: diff.added.length,
+					del: diff.deleted.length
+				}), 'info')
+			}
+
+		} catch (/** @type {any} */ err) {
+			yield show(err.message, 'error')
+			return result({ success: false, error: err.message })
+		} finally {
+			if (existsSync(tmpDir)) rmSync(tmpDir, { recursive: true, force: true })
+		}
+
+		return result({ success: true })
+	}
+
+	/**
+	 * @param {string} absDir
+	 * @returns {Promise<string[]>}
+	 */
+	async _scanLocal(absDir) {
+		const { readdirSync, statSync } = await import('node:fs')
+		const { join, relative } = await import('node:path')
+
+		const files = []
+		const ignore = ['.git', 'node_modules', 'releases', 'dist', 'play', '.nan0web_check_tmp']
+
+		const scan = (dir) => {
+			const list = readdirSync(dir)
+			for (const name of list) {
+				if (ignore.includes(name)) continue
+				if (name.startsWith('.')) continue
+
+				const abs = join(dir, name)
+				const stat = statSync(abs)
+				if (stat.isDirectory()) {
+					scan(abs)
+				} else {
+					files.push(relative(absDir, abs))
+				}
+			}
+		}
+
+		scan(absDir)
+		return files
+	}
+
+
+	/**
+	 * @param {string} base
+	 * @param {string} [dir]
+	 * @returns {Promise<string[]>}
+	 */
+	async _scanDirRecursive(base, dir = '') {
+		const { readdirSync, statSync } = await import('node:fs')
+		const { join } = await import('node:path')
+
+		let results = []
+		const absDir = join(base, dir)
+		const list = readdirSync(absDir)
+
+		for (const file of list) {
+			const rel = join(dir, file)
+			const abs = join(base, rel)
+			const stat = statSync(abs)
+			if (stat.isDirectory()) {
+				results = results.concat(await this._scanDirRecursive(base, rel))
+			} else {
+				results.push(rel)
+			}
+		}
+		return results
+	}
+}

package/src/domain/CloseCommand.js

@@ -0,0 +1,68 @@
+import { ModelAsApp, result, show } from '@nan0web/ui'
+import { runSpawn } from '@nan0web/test'
+import Scanner from '../Release/Scanner.js'
+
+export default class CloseCommand extends ModelAsApp {
+	static version = {
+		help: 'Release version',
+		default: '',
+	}
+	static UI = {
+		title: 'close',
+		help: 'Close a release and move tests to src/',
+	}
+
+	/**
+	 * @param {Partial<CloseCommand>} [data]
+	 * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} Release version */ this.version
+	}
+
+	/**
+	 * @returns {AsyncGenerator<import('@nan0web/ui').Intent, import('@nan0web/ui').ResultIntent, any>}
+	 */
+	async *run() {
+		const { renameSync, mkdirSync } = await import('node:fs')
+		const { join, dirname } = await import('node:path')
+
+		const v = this.version || ''
+		yield show(`🛜 nan0release close ${v || 'all'}`)
+
+		const scanner = new Scanner(process.cwd())
+		const specs = scanner.findSpecs(v)
+
+		if (specs.length === 0) {
+			yield show(`No pending specs found for version ${v || 'all'}`, 'warn')
+			return result({})
+		}
+
+		yield show(`Running ${specs.length} pending specs...`)
+
+		const files = specs.map((s) => s.path)
+		const spawnResult = await runSpawn('node', ['--test', ...files])
+		if (spawnResult.code !== 0) {
+			throw new Error('Cannot close: Specs failed')
+		}
+
+		yield show(`✅ Specs passed. Closing...`, 'success')
+
+		let movedCount = 0
+		for (const spec of specs) {
+			const relativePath = spec.path.substring(process.cwd().length + 1)
+			const destRelative = relativePath
+				.replace(/^releases\//, 'src/releases/')
+				.replace('.spec.js', '.test.js')
+			const destPath = join(process.cwd(), destRelative)
+
+			mkdirSync(dirname(destPath), { recursive: true })
+			renameSync(spec.path, destPath)
+			movedCount++
+		}
+
+		yield show(`✅ Successfully closed ${movedCount} specs and moved to src/releases/`, 'success')
+		return result({})
+	}
+}