Metadata-Version: 2.4
Name: atsys
Version: 0.3.1b1
Summary: Durable coding-task supervision with Codex, Copilot and Claude integration and a local web dashboard
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/aetna000/atsys
Project-URL: Repository, https://github.com/aetna000/atsys
Project-URL: Issues, https://github.com/aetna000/atsys/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Software Development
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: nodejs-wheel-binaries<25,>=24
Requires-Dist: rich<15,>=13.9
Provides-Extra: atbot
Requires-Dist: atbots<0.3,>=0.2.0; extra == "atbot"
Dynamic: license-file

# AtSys

Installable supervision for general coding work: features, bug fixes, refactors, tests, builds, migrations and scripts.

```sh
pip install --upgrade atsys==0.3.0
cd /path/to/your/project
atsys init
```

Then open a Codex session in that repository and ask:

```text
$atsys Implement my feature, with tests, under automatic supervision.
```

The bundled skill teaches Codex to inspect the repository, prepare the task objective/plan and acceptance checks, configure bounded supervision/recovery, submit the task, and report a verified handoff. `atsys init` installs the repository skill, attaches the project, installs the macOS watchdog service, and starts the local dashboard. Existing source, AGENTS.md, Git hooks and provider credentials are preserved. Codex CLI and its native login must already be available for model-backed work.

```sh
atsys ui
atsys task list
atsys task status TASK_ID
atsys task watch TASK_ID
atsys doctor --config .atsys/tasks/task.json
atsys task show TASK_ID
atsys task stop TASK_ID
atsys service status
atsys task template --objective "My coding objective" --output .atsys/tasks/task.json
atsys task submit --config .atsys/tasks/task.json
```

The wheel contains the compiled backend and web assets. A Python dependency supplies Node 24; no npm install, development server, or source checkout is needed. State defaults to `~/.local/share/atsys`, overridable with `ATSYS_DATA_DIR`. Runtime state is never written into the installed package.

Version 0.2.1 adds setup checks and a private write/read pilot, progress-stall detection for newly configured Codex tasks, full recovery-plan handoff, readable status/watch/log commands and clearer dashboard phases. Watch is read-only; closing it does not stop the task. Existing task settings and evidence remain intact. Progress is worker-reported; only the independent validator establishes completion.

Tasks run independently of the terminal and dashboard. Codex diagnosis is read-only; separately authorized repair uses workspace-write. Completion requires the configured validator. Telegram is opt-in through the dashboard. Local sleep/power loss suspends work; generic commands run as the local user. Built-in OS service installation currently targets macOS; Linux requires a separately configured service manager. Windows process supervision is unsupported.

Use `atsys init --no-service --no-dashboard` for integration-only setup, `atsys integrate` to install just the Codex skill, and `atsys integrate --remove` to remove the unmodified managed skill. Reopen the Codex session if it was started before the skill was installed.

The 0.3.0b1 beta release adds project lifecycle callbacks (`atsys hooks run file.py:hooks`), native Codex tool/turn hooks and optional `atsys[atbot]` observers. Configure these in task `hooks`; run `atsys hooks events` for supported events. Native Codex hooks need normal `/hooks` trust review after `atsys hooks codex-install --config task.json`. Internal Codex model HTTP requests are not exposed.

The 0.3.0b1 beta UI exposes operational tasks and service/Telegram settings. Activity decodes structured logs, shows newest entries first across all attempts, and supports attempt/text filters and pause display. `atsys task logs ID` shows the same readable activity; the live monitor places the latest message near the top. Raw retained output remains available explicitly.

The 0.3.0b2 beta adds Rich terminal views and `atsys monitor` for
task selection. `atsys tasks` lists active/paused work; `atsys watch task ID`
opens a live view with p to pause/resume, s twice to stop and q to leave. Keys
1–5 switch overview, activity, history, hooks and recovery wiring. Direct commands
are `atsys task pause ID`, `atsys task resume ID` and `atsys task stop ID`.
Web task rows and details expose the same controls with stop confirmation.

Pause suspends owned local POSIX process groups and excludes operator pause from
AtSys deadlines; remote requests and provider timers may continue. It requires
the new watchdog and runners. Named milestones explain their source, while
existing count-only reports stay readable. Only the independent validator decides
completion. Closing a monitor leaves task execution running.

The 0.3.0b3 beta adds goal contracts, observer rationale, progress across retries
and automatic durable outcome reports. `atsys task report ID` shows the result,
acceptance evidence, remaining failures and available costs. Completing a workflow
does not mean every domain item passed. Reports are local and need no extra model
call. Existing direct configurations remain compatible; new skill intake clarifies
material unresolved decisions before launch. See the repository's
`docs/releases/v0.3.0b3.md` and `docs/GOAL-WORKFLOW.md` for upgrade and limits.


The 0.3.0 release adds GitHub Copilot CLI and Claude Code workers, supervisors and
bounded repairs alongside Codex. Run `atsys providers`, then
`atsys init --provider copilot` or `atsys init --provider claude` to install that
provider's project skill. Native CLIs and their existing logins are prerequisites.
Copilot/Claude worker and repair tasks require explicit `trustedLocalExecution`
permission; their local shell tools do not have Codex's OS sandbox guarantee.
Native callbacks have provider-specific event limits. See `docs/PROVIDERS.md` and
`docs/releases/v0.3.0.md`. Restart an owned idle watchdog with the upgraded
package before submitting new provider tasks; do not replace active runners.

## Capacity recovery beta

AtSys 0.3.1b1 adds opt-in capacity fallback for managed Codex, Claude Code and
Copilot workers. Install explicitly with `pip install --upgrade atsys==0.3.1b1`.
See `docs/releases/v0.3.1b1.md` and `docs/PROVIDERS.md` for configuration,
watchdog upgrade and limits.
