spielos 6.2.0__tar.gz

spielos-6.2.0/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Shayan Spiel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

spielos-6.2.0/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: spielos
+Version: 6.2.0
+Summary: SpielOS: one durable Goal loop, Departments, approvals, evidence, and evals for operating AI work as a company system.
+Author: Shayan Spiel
+License: MIT
+Project-URL: Homepage, https://spielos.xyz
+Keywords: ai-agents,agent-harness,company-runtime,spielos
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# SpielOS — the company harness
+
+One durable loop for operating AI work as a company system:
+
+```text
+GOAL -> OBSERVE -> DECIDE -> ACT -> EVALUATE
+          ^                            |
+          +----------------------------+
+```
+
+The runtime owns every Goal, Run, approval, evidence record, and notification.
+Departments are **Lego packages**: self-contained folders that supply business
+behavior and never create another loop. Codex, OpenCode, and humans are all
+clients of the same persisted state.
+
+## Install (one line)
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/ShayanSpiel/SpielOS/main/install.sh | sh
+```
+
+The installer checks Python 3.11+, installs `pipx` for you when it is missing
+(brew or pip — no manual steps), installs `spielos`, and — in an empty folder,
+no questions asked — runs the first-run init right there. In a folder that has
+content it asks first and never touches your files. Re-running the same
+command updates an existing install.
+
+Prefer to do it by hand?
+
+```sh
+pipx install "spielos @ git+https://github.com/ShayanSpiel/SpielOS.git" && spielos init
+```
+
+`spielos init` vendors a complete, self-contained harness home into the current
+directory — `.agents/company/` spine, `.spielos/` private state, OpenCode/Codex
+host adapters, `opencode.json`, `AGENTS.md`, gitignore — with zero runtime
+dependency on the installed package afterward. It verifies the new home runs
+before it reports success, and detects which host (OpenCode / Codex) you have.
+
+Interactive on a terminal: pick **full harness** (everything) or a
+**minimal appliance** (spine + one department). Scripted and CI runs stay
+deterministic: add `-y/--yes` to skip prompts, `--json` for a machine-readable
+receipt; exit code 0 means verified, 1 means failed with an actionable message.
+
+## Departments as products
+
+Every department is one extractable folder: behavior (`department.py`),
+workflows, evals, skills, templates, and tooling live together.
+
+```sh
+spielos department export outbound --out ./dist   # portable .sdep bundle
+spielos add ./outbound.sdep                        # install into a home
+spielos add ./outbound.sdep --force                # upgrade in place
+spielos init --minimal --department outbound       # single-department appliance
+```
+
+Bundles carry a checksummed manifest plus the department's skills. They never
+carry strategy, assets, credentials, or run state.
+
+## First-class workers
+
+Any workflow compiles into a bounded agent worker (no Director, no routing):
+
+```sh
+spielos agent compile outbound --workflow social-lead-research --name lead-researcher
+```
+
+Emits the OpenCode agent, Codex TOML, and roster entry from one WorkflowSpec.
+The worker runs only that workflow, produces only its declared evidence kinds,
+never edits files; approvals still park in the runtime.
+
+## Updating
+
+```sh
+pipx upgrade spielos   # new CLI
+spielos refresh        # re-vendor spine + hosts into an existing home;
+                       # preserves strategy/, assets/, departments/, .spielos/
+```
+
+## Layout
+
+```text
+company/            Python package: runtime spine, evals, connections, CLI
+  skills/           operator methods (director, department-runner, …)
+  departments/      LEGO SHELF — each folder is an extractable product
+    _shared/        cross-department contract + shared methods
+    <id>/skills/    department-owned methods
+    design/tools/   render/TTS tooling · design/tokens/ brand tokens
+hosts/              adapter sources vendored into homes by init
+tests/              → company/tests/ (in-package)
+docs/               architecture notes
+.spielos/           private runtime state (gitignored; exists only when this
+                    checkout itself operates as a live company home)
+```
+
+Authority for architecture, vocabulary, pursuit semantics, safety rules, and
+the owner doctrine: `company/README.md`.

spielos-6.2.0/README.md

@@ -0,0 +1,97 @@
+# SpielOS — the company harness
+
+One durable loop for operating AI work as a company system:
+
+```text
+GOAL -> OBSERVE -> DECIDE -> ACT -> EVALUATE
+          ^                            |
+          +----------------------------+
+```
+
+The runtime owns every Goal, Run, approval, evidence record, and notification.
+Departments are **Lego packages**: self-contained folders that supply business
+behavior and never create another loop. Codex, OpenCode, and humans are all
+clients of the same persisted state.
+
+## Install (one line)
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/ShayanSpiel/SpielOS/main/install.sh | sh
+```
+
+The installer checks Python 3.11+, installs `pipx` for you when it is missing
+(brew or pip — no manual steps), installs `spielos`, and — in an empty folder,
+no questions asked — runs the first-run init right there. In a folder that has
+content it asks first and never touches your files. Re-running the same
+command updates an existing install.
+
+Prefer to do it by hand?
+
+```sh
+pipx install "spielos @ git+https://github.com/ShayanSpiel/SpielOS.git" && spielos init
+```
+
+`spielos init` vendors a complete, self-contained harness home into the current
+directory — `.agents/company/` spine, `.spielos/` private state, OpenCode/Codex
+host adapters, `opencode.json`, `AGENTS.md`, gitignore — with zero runtime
+dependency on the installed package afterward. It verifies the new home runs
+before it reports success, and detects which host (OpenCode / Codex) you have.
+
+Interactive on a terminal: pick **full harness** (everything) or a
+**minimal appliance** (spine + one department). Scripted and CI runs stay
+deterministic: add `-y/--yes` to skip prompts, `--json` for a machine-readable
+receipt; exit code 0 means verified, 1 means failed with an actionable message.
+
+## Departments as products
+
+Every department is one extractable folder: behavior (`department.py`),
+workflows, evals, skills, templates, and tooling live together.
+
+```sh
+spielos department export outbound --out ./dist   # portable .sdep bundle
+spielos add ./outbound.sdep                        # install into a home
+spielos add ./outbound.sdep --force                # upgrade in place
+spielos init --minimal --department outbound       # single-department appliance
+```
+
+Bundles carry a checksummed manifest plus the department's skills. They never
+carry strategy, assets, credentials, or run state.
+
+## First-class workers
+
+Any workflow compiles into a bounded agent worker (no Director, no routing):
+
+```sh
+spielos agent compile outbound --workflow social-lead-research --name lead-researcher
+```
+
+Emits the OpenCode agent, Codex TOML, and roster entry from one WorkflowSpec.
+The worker runs only that workflow, produces only its declared evidence kinds,
+never edits files; approvals still park in the runtime.
+
+## Updating
+
+```sh
+pipx upgrade spielos   # new CLI
+spielos refresh        # re-vendor spine + hosts into an existing home;
+                       # preserves strategy/, assets/, departments/, .spielos/
+```
+
+## Layout
+
+```text
+company/            Python package: runtime spine, evals, connections, CLI
+  skills/           operator methods (director, department-runner, …)
+  departments/      LEGO SHELF — each folder is an extractable product
+    _shared/        cross-department contract + shared methods
+    <id>/skills/    department-owned methods
+    design/tools/   render/TTS tooling · design/tokens/ brand tokens
+hosts/              adapter sources vendored into homes by init
+tests/              → company/tests/ (in-package)
+docs/               architecture notes
+.spielos/           private runtime state (gitignored; exists only when this
+                    checkout itself operates as a live company home)
+```
+
+Authority for architecture, vocabulary, pursuit semantics, safety rules, and
+the owner doctrine: `company/README.md`.