# WorkJinn V20

WorkJinn is an action-driven expert-board workflow application for planning,
executing, testing, reviewing, and continuing software/project work with local
and cloud AI providers.

## What Is New In V20

- New help topic **Locking and Recovery** that explains the project lock file,
  the 30-minute auto-clear threshold, and the manual clear command.
- New CLI flag `--force-clear-autopilot-lock` for unattended and scripted use.
- New CLI stage `--stage publish` mirrors the produced manuscript, source
  files, and notes to the project root without running any other stage.
- Dashboard Yes/No dialog for active autopilot locks under 30 minutes; locks
  older than 30 minutes are auto-cleared on the next Start.
- `Build\WorkJinn.exe` and the project-root `WorkJinn.exe` are kept in sync
  after every build, so a project-root shortcut never runs a stale binary.
- Optional foreword for book projects: new `--foreword` / `--no-foreword`
  CLI flag and a Book Wizard checkbox. The foreword is written as
  `Chapter_00.txt` and is fully persisted in `IncludeForeword=` of the
  project state.
- Persisted chapter count: the wizard now stores `TargetChapters=N` in the
  project state, so book recovery does not depend on text-parsing the goal.
- Gap-agnostic book recovery: the autopilot always picks the first missing
  chapter in the configured range, so any chapter can be missing and the
  loop fills them in numeric order.
- New help topic: **Book Chapter Options** covers the foreword, chapter
  count, and the recovery rule.
- **Post-run summary modal**: when the dashboard autopilot finishes
  (goal complete, max cycles, board blocked, or autonomous retry), WorkJinn
  shows a single messagebox that reports the decision, the per-chapter
  cleanliness and word/character evidence (for book projects), and the
  location of the project folder, `Chapters\`, `Notes\`, the final report,
  and the run log. Clicking **Yes** opens the project folder in Windows
  Explorer; **No** stays on the dashboard.

## Start

Run `WorkJinn.exe` from this folder. Open `WorkJinn.chm` for the complete help
file. `Txt2Book.exe` is included as a companion utility for private use.

On first run, WorkJinn creates its local configuration, logs, model caches, and
target workspace folders beside the executable. Provider API keys and endpoint
settings are stored locally on the target system and are not shipped in this
release package.

## Included Files

- `WorkJinn.exe` - application executable
- `Txt2Book.exe` - companion text-to-book utility, free for private use
- `WorkJinn.chm` - compiled help
- `README.md` - release, legal, and copyright notes
- `SHA256SUMS.txt` - package file hashes
- `version.txt` - plain version string for web display

## Legal And Copyright

Copyright (c) 2026. All rights reserved by the WorkJinn copyright holder.

Txt2Book.exe is included with this package as a companion utility. It is
copyrighted by the same copyright holder and may be used free of charge for
private, non-commercial use. Redistribution, commercial use, resale, or
repackaging require separate permission from the copyright holder.

WorkJinn may call third-party or local AI providers configured by the user.
Provider availability, model output, pricing, latency, data handling, and
licensing terms are controlled by those providers. The user is responsible for
checking generated or modified content before use, publication, redistribution,
or deployment.

This release contains no provider API keys. Do not redistribute local
configuration files, logs, target workspaces, provider outputs, or secrets.

This software is provided without warranty. Use it only where you can review and
accept the resulting files, commands, and provider-generated output.

