atsys 0.2.0__tar.gz

atsys-0.2.0/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

atsys-0.2.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include pyproject.toml setup.py python/README.md
+recursive-include python/atsys *.py
+recursive-include python/atsys/resources *
+recursive-include python/atsys/_runtime *
+global-exclude __pycache__ *.py[cod] .DS_Store .env .env.*

atsys-0.2.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: atsys
+Version: 0.2.0
+Summary: Durable coding-task supervision with Codex 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
+Dynamic: license-file
+
+# AtSys
+
+Installable supervision for general coding work: features, bug fixes, refactors, tests, builds, migrations and scripts.
+
+```sh
+pip install atsys
+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 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.
+
+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.

atsys-0.2.0/README.md

@@ -0,0 +1,131 @@
+# AtSys
+
+A local control plane for **any coding work you delegate**: implementing features, fixing bugs, refactoring, testing, building, migrating, reviewing, or running scripts. AtSys keeps the task, automation, observation, recovery policy, and escalation visible after the originating Codex conversation or terminal closes.
+
+The benchmark failure motivated this project; benchmarks are not its domain model.
+
+![AtSys managed tasks](docs/screenshots/tasks-live-desktop.png)
+
+## Start
+
+Install the locally built Python release (Python 3.10+):
+
+```sh
+pip install /path/to/atsys/release/atsys-0.2.0-py3-none-any.whl
+cd /path/to/your/project
+atsys init
+```
+
+Then open Codex in that repository and say:
+
+```text
+$atsys Implement [my objective], preserving unrelated changes and verifying [acceptance criteria].
+```
+
+The packaged skill handles repository inspection, planning, task configuration, independent validation, two bounded retries, supervisor/repair policy, watchdog checks and verified handoff to a separate worker. You provide the objective and constraints. No pasted setup prompt or absolute AtSys checkout path is needed. Reopen Codex if it was already running when the skill was installed.
+
+`atsys init` installs the project skill, starts the macOS watchdog service and launches the bundled dashboard. `atsys ui` opens it again; `atsys task list` shows managed work. The dashboard starts at **http://127.0.0.1:4310**, choosing another free port if a different instance is there. Always use the reported URL. Installed state lives in `~/.local/share/atsys`, independent of the package and repository. `ATSYS_DATA_DIR` overrides it.
+
+The wheel includes the backend and dashboard; its Python dependency supplies Node 24. No npm or source checkout is required at runtime. Codex CLI and its existing login are needed for Codex workers, supervisors and repairs. The 0.2.0 artifacts are built locally; this change has **not** been published to PyPI. After publication the installation command becomes `pip install atsys`. See [packaging, verification and release instructions](docs/PACKAGING.md).
+
+## Develop AtSys from source
+
+Node 22.16+ and npm are required for development.
+
+```sh
+npm install
+npm run dev
+```
+
+Open **http://127.0.0.1:5173**. For a built application, run `npm run build` then `npm start` and open **http://127.0.0.1:4310**. `ATSYS_PORT` and `ATSYS_DATA_DIR` override the local API port and private data directory.
+
+The primary **Managed tasks** page runs real workloads. The older resource-console screens are explicitly grouped as samples. No Docker, Kubernetes, AtMem, or AtFlows is required.
+
+## Delegate work
+
+Use **New managed task** to configure:
+
+- Objective, project directory, execution plan and constraints.
+- A Codex coding worker (model and reasoning effort), or explicit command arguments.
+- An independent acceptance command: tests, builds, lint, custom assertions, or any executable check. Required artifact paths are optional and their contents are hashed.
+- Attempt deadlines, total task lifetime, runner heartbeat deadline, output inactivity window, and optional application progress file.
+- Notify-only, bounded restart, or automatic Codex supervision. Optional repair permission launches a separate bounded Codex worker with workspace-write access.
+- Retry delay/limits, supervisor model/effort/call limit/deadline, and repair deadline.
+
+AtSys launches the worker, checks it, and runs the independent validator. Failed execution or validation opens an incident. The supervisor diagnoses read-only and proposes restart, repair, or human escalation. Deterministic policy decides whether the action is permitted. A repair never bypasses the configured acceptance command.
+
+**Run recovery drill** exercises a harmless local task that deliberately fails once, saves progress, resumes, and validates its result. It does not invoke a paid model or touch other projects.
+
+## CLI from Codex or your terminal
+
+```sh
+# Submit a coding task and immediately return to the caller.
+npm run atsys -- run --project /absolute/repo --worker codex \
+  --objective "Implement the requested feature, preserving unrelated changes" \
+  --validation '["npm","test"]'
+
+# Supervise an existing command.
+npm run atsys -- run --project /absolute/repo --name "Build and check" \
+  --recovery restart --timeout 1800 -- npm run build
+
+# Full configuration (missing fields receive documented defaults).
+npm run atsys -- task submit --config examples/coding-task.json
+npm run atsys -- task list
+npm run atsys -- task show task-ID
+npm run atsys -- task stop task-ID
+npm run atsys -- task retry task-ID
+```
+
+Update the example's working directory and objective before submitting it. JSON argv is passed directly with `shell:false`; use an explicit shell executable only when your task requires one. Generic commands run as your local user. Exit-code validation is available when sufficient; a custom independent acceptance command is preferred for coding changes. Benchmark JSON remains an optional specialized validator.
+
+`run` and `task submit` persist work and exit. `run --attached` retains the original terminal-owned executor for compatibility. `status`/`stop run-ID` refer to the older sample/basic-run store; `task list`/`task stop task-ID` refer to managed work.
+
+## Make the watchdog durable
+
+```sh
+npm run atsys -- service install
+npm run atsys -- service status
+```
+
+On macOS, this installs a **current-user LaunchAgent** with KeepAlive and login startup. You can also manage it from **Service & Telegram**. The dashboard/API and CLI are not execution owners. Detached runners survive their closure; the OS service restarts a dead watchdog and reconciles existing attempts.
+
+```sh
+npm run atsys -- service uninstall
+```
+
+Removal disables OS restart protection and leaves a detached watchdog for existing work. Stop individual tasks explicitly before removing their execution environment. Other POSIX platforms can run `node --import tsx server/operations/daemon.ts /absolute/data-directory` under their own service manager; built-in installation currently targets macOS.
+
+A sleeping or powered-off computer cannot execute tasks or send alerts. Use an always-on host for continuous operation; remote access itself is not implemented.
+
+## Telegram
+
+Open **Service & Telegram**, enter a bot token and chat ID, enable the desired event types, save, and explicitly send a test notification. Start a conversation with the bot first. Notifications use a persistent outbox with bounded retries and visible delivery outcomes.
+
+The token is stored separately in a mode-0600 private file and is never returned by the API. Telegram is outbound notification only; it cannot authorize recovery. Delivery is at-least-once: a crash after Telegram accepted a message but before the receipt is saved can produce a duplicate. No notifications are sent until configured and enabled.
+
+## What is durable, and what is bounded
+
+Operational state lives in the data directory's `operations.sqlite` (`~/.local/share/atsys` for pip installs; `.atsys` for source development), with transactional task/attempt/event/outbox changes. Each attempt has a configuration snapshot and process identity. Watchdog ownership is fenced by a durable lease. Runner heartbeats and application progress are distinct. Output inactivity is an optional heuristic, not proof of task progress. Attempts keep up to 32 KB of redacted output; tasks keep the latest 500 events. Full retention/export is future work.
+
+Completion requires the declared check, not an agent's claim. Generic artifact checks prove presence and record content digests; they do not by themselves prove semantic correctness or freshness. The optional benchmark adapter also checks freshness and its result schema. Application checkpoint recovery uses declared resume arguments; arbitrary side effects and native Codex session resume are not automatically reconstructed. Retry-safe commands/checkpoints remain part of task configuration.
+
+Codex uses the installed CLI and native login. No provider authentication files are read by AtSys. Model costs are currently unknown and dollar budgets are not enforced for managed tasks; attempt, call, and time limits are enforced. Generic commands are trusted code. This is a single-user loopback application, not an authenticated team server or sandbox for hostile workloads.
+
+## Verify and review
+
+```sh
+npm test
+npm run typecheck
+npm run build
+npx playwright install chromium
+npm run test:e2e
+npm run format:check
+```
+
+- [Active packaging specification](specs/003-python-package/spec.md), [plan](specs/003-python-package/plan.md), [tasks](specs/003-python-package/tasks.md)
+- [Durable supervision specification](specs/002-durable-task-supervision/spec.md), [plan](specs/002-durable-task-supervision/plan.md), [tasks](specs/002-durable-task-supervision/tasks.md)
+- [Constitution](.specify/memory/constitution.md), [original console specification](specs/001-supervision-console/spec.md)
+- [Architecture](docs/ARCHITECTURE.md), [verification report](docs/IMPLEMENTATION.md), [remaining work](docs/ROADMAP.md)
+- [Build versus reuse assessment](docs/BUILD-VS-REUSE.md)
+
+GitHub Spec Kit is initialized with the Codex integration. The UI reuses Headlamp's adapted StatusLabel and resource-console patterns, with upstream [license](src/vendor/headlamp/LICENSE), [NOTICE](src/vendor/headlamp/NOTICE), and [attribution](docs/headlamp-research.md) retained. Local fonts include their licenses. The original project brief and existing environment file are preserved; credentials and runtime state are excluded from Git.

atsys-0.2.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "atsys"
+version = "0.2.0"
+description = "Durable coding-task supervision with Codex integration and a local web dashboard"
+readme = "python/README.md"
+requires-python = ">=3.10"
+license = "Apache-2.0"
+license-files = ["LICENSE"]
+dependencies = ["nodejs-wheel-binaries>=24,<25"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: MacOS",
+  "Operating System :: POSIX :: Linux",
+  "Topic :: Software Development",
+]
+
+[project.scripts]
+atsys = "atsys.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/aetna000/atsys"
+Repository = "https://github.com/aetna000/atsys"
+Issues = "https://github.com/aetna000/atsys/issues"
+
+[tool.setuptools]
+package-dir = {"" = "python"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["python"]
+include = ["atsys*"]

atsys-0.2.0/python/README.md

@@ -0,0 +1,33 @@
+# AtSys
+
+Installable supervision for general coding work: features, bug fixes, refactors, tests, builds, migrations and scripts.
+
+```sh
+pip install atsys
+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 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.
+
+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.

atsys-0.2.0/python/atsys/__init__.py

@@ -0,0 +1,2 @@
+"""AtSys: installed command and bundled task supervision runtime."""
+__version__ = "0.2.0"

atsys-0.2.0/python/atsys/__main__.py

@@ -0,0 +1,2 @@
+from .cli import main
+raise SystemExit(main())