Improve workflow kit validation and tests

Author: PEDZEO

.github/workflows/ci.yml

@@ -7,12 +7,13 @@ on:
 
 jobs:
   smoke:
-    name: Smoke (${{ matrix.os }})
+    name: Smoke (${{ matrix.os }}, py${{ matrix.python-version }})
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
 
     steps:
       - name: Checkout
@@ -21,11 +22,17 @@ jobs:
       - name: Setup Python
         uses: actions/setup-python@v5
         with:
-          python-version: "3.11"
+          python-version: ${{ matrix.python-version }}
 
       - name: Show Python version
         run: python --version
 
+      - name: Run unit tests
+        run: python -B -m unittest discover -s tests -v
+
+      - name: Bootstrap dry run
+        run: python tools/bootstrap.py --target bootstrap-test --dry-run
+
       - name: Validate workflow templates
         run: python tools/validate_workflow.py --memory-dir memory
 

.gitignore

@@ -24,3 +24,7 @@ Thumbs.db
 # Temporary test output
 tmp/
 bootstrap-test/
+*.generated.md
+*.tmp.*
+SCAN_EXPLANATION.md
+scan-summary.json

CHANGE_AREAS.md

@@ -1,47 +1,14 @@
 # CHANGE_AREAS.md
 
-Карта областей, чтобы быстро понимать, куда направлять агента и где возможны регрессии.
+Generated draft. Review and refine before using it for strict delegation.
 
 ## Areas
 
-- API
-  - Основные директории:
-  - Главные entrypoints:
-  - Основные риски:
-  - Типичные тесты:
-
-- UI
-  - Основные директории:
-  - Главные entrypoints:
-  - Основные риски:
-  - Типичные тесты:
-
-- Bot or handlers
-  - Основные директории:
-  - Главные entrypoints:
-  - Основные риски:
-  - Типичные тесты:
-
-- Data layer
-  - Основные директории:
-  - Главные entrypoints:
-  - Основные риски:
-  - Типичные тесты:
-
-- Auth
-  - Основные директории:
-  - Главные entrypoints:
-  - Основные риски:
-  - Типичные тесты:
-
-- Notifications
-  - Основные директории:
-  - Главные entrypoints:
-  - Основные риски:
-  - Типичные тесты:
+- No change areas detected automatically
 
 ## Delegation Rule
 
+- Confidence: low (No strong area hints found from directory names)
 - Один агент должен владеть одной зоной записи.
 - Если задача затрагивает две зоны, критический путь лучше держать локально.
 - Если зона не определена, сначала отправляй `explorer`.

CODEBASE_INDEX.md

@@ -4,46 +4,43 @@
 
 ## Project Summary
 
-- Project name:
-- Main purpose:
-- Primary language:
-- Frameworks:
-- Package manager:
-- Test runner:
+- Project name: codex-workflow-kit
+- Main purpose: Needs review
+- Primary language: Python
+- Frameworks: Needs review
+- Package manager: pip/pyproject
+- Test runner: Needs review
 
 ## Entry Points
 
-- App entry:
-- API entry:
-- Worker entry:
-- CLI entry:
+- tools/acceptance_check.py  (runtime entrypoint pattern, main function pattern)
+- tools/bootstrap.py  (runtime entrypoint pattern, main function pattern)
+- tools/close_task.py  (runtime entrypoint pattern, main function pattern)
+- tools/create_handoff.py  (runtime entrypoint pattern, main function pattern)
+- tools/explain_scan.py  (runtime entrypoint pattern, main function pattern)
+- tools/init_change_areas.py  (runtime entrypoint pattern, main function pattern)
+- tools/init_index.py  (runtime entrypoint pattern, main function pattern)
+- tools/refresh_index.py  (runtime entrypoint pattern, main function pattern)
 
 ## Main Directories
 
-- `src/`
-  - что находится здесь:
-- `server/`
-  - что находится здесь:
-- `bot/`
-  - что находится здесь:
+- `.github/`
+  - Needs review
+- `examples/`
+  - Needs review
+- `memory/`
+  - Needs review
+- `templates/`
+  - Needs review
 - `tests/`
-  - что находится здесь:
-- `scripts/`
-  - что находится здесь:
-- `docs/`
-  - что находится здесь:
-
-Удалить или заменить эти секции под реальный проект.
+  - Tests
+- `tools/`
+  - Automation and utility scripts
 
 ## Important Files
 
-- Main config:
-- Env example:
-- Dependency manifest:
-- Build config:
-- CI config:
-- Lint config:
-- Type config:
+- .github/workflows/ci.yml
+- pyproject.toml
 
 ## Key Flows
 
@@ -66,27 +63,37 @@
 
 ## Test Map
 
-- Fast smoke tests:
-- Feature tests:
-- Integration tests:
-- High-cost tests:
+- Test directories: tests
+- Detected test files: 1
+- Sample test files:
+- tests/test_workflow_tools.py
 
 ## Common Commands
 
-```powershell
-# install
-
-# test
+```text
+# codex-workflow-bootstrap
+tools.bootstrap:main
 
-# lint
+# codex-workflow-scan
+tools.scan_project:main
 
-# typecheck
+# codex-workflow-validate
+tools.validate_workflow:main
 
-# run app
+# codex-workflow-acceptance
+tools.acceptance_check:main
 ```
 
 ## Notes For Codex
 
 - Сначала смотри сюда, потом ищи по дереву.
 - Если структура проекта изменилась, обнови этот файл.
 - Не превращай индекс в длиннюю документацию.
+
+## CI Files
+
+- .github/workflows/ci.yml
+
+## Area Hints
+
+- No area hints detected automatically

README.en.md

@@ -179,6 +179,28 @@ Codex should operate like this:
 
 More details and command examples: [tools/README.md](tools/README.md)
 
+## Development Commands
+
+```powershell
+# run unit tests without writing .pyc files
+python -B -m unittest discover -s tests -v
+
+# validate the distributable memory templates
+python tools/validate_workflow.py --memory-dir memory
+
+# preview bootstrap output without writing files
+python tools/bootstrap.py --target bootstrap-test --dry-run
+
+# update an existing local install without resetting live memory
+python tools/bootstrap.py --target ..\my-project --force --skip-memory
+```
+
+`acceptance_check.py` can also run concrete checks when a task needs stricter closure:
+
+```powershell
+python tools/acceptance_check.py --scope --behavior --verification --regression --memory --require-current-task-updated --verification-command "python -B -m unittest discover -s tests -v"
+```
+
 ## Structure After Bootstrap
 
 ```text

README.md

@@ -187,6 +187,26 @@ python tools/bootstrap.py --target ..\my-project
 
 Подробности и примеры запуска: [tools/README.md](tools/README.md)
 
+## Команды разработки
+
+```powershell
+# unit-тесты без записи .pyc-файлов
+python -B -m unittest discover -s tests -v
+
+# проверка шаблонов памяти, которые распространяются с kit
+python tools/validate_workflow.py --memory-dir memory
+
+# предварительный просмотр bootstrap без записи файлов
+python tools/bootstrap.py --target bootstrap-test --dry-run
+
+# обновление локальной установки без сброса live memory
+python tools/bootstrap.py --target ..\my-project --force --skip-memory
+```
+
+```powershell
+python tools/acceptance_check.py --scope --behavior --verification --regression --memory --require-current-task-updated --verification-command "python -B -m unittest discover -s tests -v"
+```
+
 ## Структура после bootstrap
 
 После разворачивания mandatory core проект будет выглядеть примерно так:

TEST_INDEX.md

@@ -1,61 +1,51 @@
 # TEST_INDEX.md
 
-Нужен для быстрого выбора минимальной релевантной проверки.
+Generated draft. Review and refine before relying on it.
 
 ## Test Commands
 
-```powershell
-# unit
+```text
+# codex-workflow-bootstrap (other)
+tools.bootstrap:main
 
-# feature
+# codex-workflow-scan (other)
+tools.scan_project:main
 
-# integration
+# codex-workflow-validate (other)
+tools.validate_workflow:main
 
-# smoke
-
-# lint
-
-# typecheck
+# codex-workflow-acceptance (other)
+tools.acceptance_check:main
 ```
 
 ## Fast Tests
 
-- Команда:
-  - Что покрывает:
-  - Когда запускать:
-
-- Команда:
-  - Что покрывает:
-  - Когда запускать:
+- No fast test commands detected automatically
 
 ## Medium Tests
 
-- Команда:
-  - Что покрывает:
-  - Когда запускать:
+- No medium test commands detected automatically
 
 ## Expensive Tests
 
-- Команда:
-  - Что покрывает:
-  - Когда запускать:
-  - Когда не запускать без причины:
+- No expensive test commands detected automatically
 
 ## Feature Map
 
 - Auth:
-  - Тесты:
+  - Тесты: Needs review
 - API:
-  - Тесты:
+  - Тесты: Needs review
 - UI or bot:
-  - Тесты:
+  - Тесты: Needs review
 - Notifications:
-  - Тесты:
+  - Тесты: Needs review
 - Data layer:
-  - Тесты:
+  - Тесты: Needs review
 
 ## Notes For Codex
 
-- Сначала выбирай самый узкий достаточный набор тестов.
-- Если тестов нет, фиксируй это как риск.
-- Если есть дорогой набор тестов, не запускай его без причины.
+- Detected test directories: tests
+- Confidence: medium (Based on filename and directory heuristics)
+- If no commands were detected, inspect package scripts, Makefile, or project config manually.
+- Keep this file aligned with real verification practice.

pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "codex-workflow-kit"
+version = "0.1.0"
+description = "Strict workflow kit for Codex repository work."
+readme = "README.en.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+
+[project.scripts]
+codex-workflow-bootstrap = "tools.bootstrap:main"
+codex-workflow-scan = "tools.scan_project:main"
+codex-workflow-validate = "tools.validate_workflow:main"
+codex-workflow-acceptance = "tools.acceptance_check:main"
+
+[tool.setuptools]
+packages = ["tools"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["."]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"