@matteai/stma 0.2.1

package/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0 (ELv2)
+
+Copyright (c) 2026 Matte AI LLC
+
+**Acceptance**
+
+By using the software, you agree to all of the terms and conditions below.
+
+**Copyright License**
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+**Limitations**
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor's trademarks is subject
+to applicable law.
+
+**Patents**
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+**Notices**
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+**No Other Rights**
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+**Termination**
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+**No Liability**
+
+As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.
+
+**Definitions**
+
+The "licensor" is the entity offering these terms, and the "software" is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+"you" refers to the individual or entity agreeing to these terms.
+
+"your company" is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+"control" means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+"your licenses" are all the licenses granted to you for the software under
+these terms.
+
+"use" means anything you do with the software requiring one of your licenses.
+
+"trademark" means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,69 @@
+# stma
+
+CLI for **STMA (Speak to my Agent)** — a vendor-neutral control plane for a team's coding
+agents. It makes agent work attributable and safe across humans, repositories and client
+vendors: run lifecycle, leased work claims with a deterministic conflict radar, canonical
+team/project policy with drift receipts, and environment preflight.
+
+Works with a hosted STMA deployment or your own self-hosted one
+([Rheasus/stma](https://github.com/Rheasus/stma)).
+
+## Install
+
+```bash
+npm install -g stma
+# or run it without installing
+npx stma --help
+```
+
+## Configure
+
+The CLI reads two environment variables and never writes your token to disk:
+
+```bash
+export STMA_URL=https://your-deployment.example.com
+export STMA_TOKEN=stma_...      # personal access token from the dashboard
+```
+
+PowerShell uses `$env:STMA_URL=...` / `$env:STMA_TOKEN=...`.
+
+## Common commands
+
+```bash
+stma agent register --name alice-codex --client codex
+stma run start --team acme --project payments --task PAY-142 \
+  --scope path:src/payments:write --scope migration:payments-db:write
+stma run heartbeat
+stma run finish
+
+stma env baseline --team acme --project payments     # owner records the golden environment
+stma env preflight --team acme --project payments    # compare this machine against it
+stma policy publish --team acme --project payments --file .stma/policy.json
+stma policy pull --team acme --project payments --apply
+
+stma run exec --team acme --project payments -- npm test   # wrap any command in a run
+```
+
+## Native lifecycle adapters
+
+Install merge-safe project hooks so runs start, heartbeat and finish automatically. The
+install is a dry run by default — review it, then re-run with `--apply`:
+
+```bash
+stma adapter install --target claude-code --team acme --project payments --name alice-claude
+stma adapter install --target claude-code --team acme --project payments --name alice-claude --apply
+```
+
+Targets: `claude-code`, `codex`, `cursor`. Existing hooks in your client config are
+preserved; only STMA's own entries are replaced. Lifecycle events are queued in a bounded
+local outbox when the server is unreachable.
+
+## Privacy
+
+Environment snapshots carry tool versions, lockfile hashes and environment variable
+**names** — never values, never file contents. Device identity is a one-way hash; your
+hostname and username are not sent.
+
+## License
+
+[Elastic License 2.0](./LICENSE) — © 2026 Matte AI LLC.