Metadata-Version: 2.4
Name: commensa
Version: 0.1.0rc10
Summary: Verified installer and stable command router for Commensa
Author: Commensa LLC
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://commensa.ai/
Project-URL: Documentation, https://commensa.ai/docs
Project-URL: Installation, https://commensa.ai/install
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Commensa bootstrap

This small public package installs verified Commensa releases and keeps one
stable `commensa` command in front of them. It does not contain the private
Report, Cockpit, Project X-Ray, commensa me tracking, or Commensa Manager
runtimes.

Install the free Core:

```bash
pipx install commensa
commensa install core
```

After purchasing an entitled product on `commensa.ai`, install the matching
capability. Commensa privately asks first for the secure access link in the
delivery email, then for the activation key. Neither belongs in a shell command.

```bash
commensa install report
commensa install cockpit
commensa install xray
commensa install me
```

For example, a new Report customer can use one shell line:

```bash
pipx install commensa && commensa install report
```

Approved Manager Early Access operators can install Manager into selected AI
interfaces:

```bash
commensa install manager --interface codex --interface claude-code
```

Verified members of an approved organization receive one individual,
revocable organization key. It installs all current paid capabilities without
placing the key in shell history:

```bash
commensa install organization --interface codex --interface claude-code
```

Update the public command and every installed entitled release with one command.
Manager users repeat the interfaces they want kept current:

```bash
commensa update --interface codex --interface claude-code
```

The updater exchanges the existing device credential for a short-lived release
grant. It does not retain the activation key or require the old checkout link.
It reports each detected runtime family with its observed before/after version
and whether it updated, verified the same release, skipped, or failed. The paid
runtime includes Core. An unknown version is reported explicitly rather than
inferred from the newest retained archive. Any skipped or failed product makes
the command exit nonzero; a Core update never counts as a Manager update.

Some older installations have capability records but no reusable registration.
These cannot obtain a protected update grant automatically. The updater preserves
their entitlement records and prints the normal reinstall command, for example:

```bash
commensa install manager --interface codex --interface claude-code
```

Enter the delivery-email access link and activation key only at the private
prompts. If those are unavailable, use [Commensa support](https://commensa.ai/support).
The updater does not invent or migrate credentials, and it does not bypass
protected download authorization. Release directories retained after removal
are diagnosed conservatively as detected installations; their active version
can be unknown. An installation verification is separate from confirmation that
the public bootstrap's pinned release is the newest published release.

Normal product commands continue through the verified local runtime:

```bash
commensa capabilities --json
commensa privacy --json
commensa doctor --json
```

## Current platform boundary

The release candidate supports the same command-line installation flow on
macOS, Linux, and native Windows 11. On Windows, `pipx` supplies the isolated
Python runtime and Commensa creates managed `.cmd` launchers; PowerShell or
Command Prompt can run the same `commensa install ...` commands. WSL remains a
separate Linux route.

The Windows route has automated contract coverage but still requires its first
acceptance pass on a physical Windows 11 x64 host before it can be described as
host-verified. It is not the separately signed Windows desktop installer.

This PyPI command is the normal customer installation route across supported
operating systems. Signed native applications may be added later as optional
one-click distribution, but they are not required for the product or for paid
licensing. The lower-level download and installer files remain protected
implementation and support infrastructure behind this command.
