anbaric 1.8.1 → 1.10.0

package/README.md

@@ -1,17 +1,18 @@
 # anbaric
 
-Anbaric is a Typescript framework for building stateful applications. An application is
-expressed as one or more state machines: long-lived jobs move through named
-states, driven by actions and transitions, with their data validated against a
-schema and every change recorded in an audit trail. Alongside the state machine
-the framework provides schema-validated document storage and secret storage.
-
-Anbaric also provides a platform-as-a-service to easily deploy stateful apps built on Anbaric. The same application runs unchanged on
-a developer's machine, on a server you operate, or on Anbaric Cloud, where a
-single CLI command deploys it. Application code depends only on the interfaces
-in this package; the framework selects in-memory or platform-backed
-implementations from the environment, so no deployment detail appears in the
-code.
+Anbaric is a TypeScript framework for building stateful applications. An
+application is expressed as one or more state machines: long-lived jobs move
+through named states, driven by actions and transitions, with their data
+validated against a schema and every change recorded in an audit trail.
+Alongside the state machine the framework provides schema-validated document
+storage and secret storage.
+
+Anbaric also provides a platform for deploying the applications built on it. The
+same application runs unchanged on a developer's machine, on a server you
+operate, or on Anbaric Cloud, where a single CLI command deploys it. Application
+code depends only on the interfaces in this package; the framework selects
+in-memory or platform-backed implementations from the environment, so no
+deployment detail appears in the code.
 
 This package (`anbaric`) is the umbrella install for writing an application. It
 re-exports the app-facing surface of the underlying packages.
@@ -105,7 +106,7 @@ factories, so the same application runs in several ways without code changes.
   in-memory and jobs progress automatically. Running the program with
   `npx tsx src/main.ts` is a complete local run, suitable for development and
   testing.
-- **Anbaric Cloud.** `anbaric deploy` packages the application (source only, no
+- **Anbaric Cloud.** `anbaric app deploy` packages the application (source only, no
   `node_modules`) and runs it on the hosted platform. The platform installs the
   application's own dependencies as it builds the image, so any npm package the
   application imports works when deployed. The platform injects the configuration
@@ -168,15 +169,23 @@ principal commands are:
 | Command | Purpose |
 | --- | --- |
 | `anbaric login` / `anbaric logout` | authorize this terminal against a platform, or revoke it |
-| `anbaric configure [dir]` | set an application's name and internal port |
-| `anbaric deploy [dir]` | deploy an application and wait until it is live |
-| `anbaric update [dir]` | deploy over a running application without prompting |
 | `anbaric apps` | list deployed applications |
+| `anbaric app configure` | set an application's name and internal port |
+| `anbaric app deploy` | deploy an application and wait until it is live |
+| `anbaric app update` | deploy over a running application without prompting |
+| `anbaric app status <name>` | show an application's deploy state and whether it is up |
+| `anbaric app tail <name>` | stream an application's runtime logs |
+| `anbaric app tear-down <name>` | stop and remove a deployed application |
 | `anbaric state-machines` | list registered state machines |
-| `anbaric job list [state-machine-id]` | list jobs |
-| `anbaric job watch <job-id>` | follow a job's state as it changes |
-| `anbaric job set-state <job-id> <state>` | move a job to a state and re-queue it |
-| `anbaric job update <job-id> <key=value ...>` | change job properties and re-queue |
+| `anbaric jobs create <sm-id> <start-state> [k=v ...]` | create a job and queue it for processing |
+| `anbaric jobs list [state-machine-id]` | list jobs |
+| `anbaric jobs watch <job-id>` | follow a job's state as it changes |
+| `anbaric jobs set-state <job-id> <state>` | move a job to a state and re-queue it |
+| `anbaric jobs update <job-id> <key=value ...>` | change job properties and re-queue |
+
+The `app configure`/`deploy`/`update` commands act on the application for the
+current project, located by walking up to the nearest `package.json`, so they
+run from anywhere inside it.
 
 Every command accepts flags (such as `--environment`, `--tenant`, `--name`,
 `--port`, `--yes`) that supply the answers a prompt would otherwise ask for, so

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anbaric",
-  "version": "1.8.1",
+  "version": "1.10.0",
   "description": "Everything needed to write an Anbaric app: state machines, jobs, document and secret stores, local in-memory implementations and the Anbaric Cloud clients",
   "license": "MIT",
   "type": "module",
@@ -10,9 +10,9 @@
     "src"
   ],
   "dependencies": {
-    "anbaric-impl-cloud": "^1.8.1",
-    "anbaric-data-store": "^1.8.1",
-    "anbaric-state-machine": "^1.8.1",
-    "anbaric-tsapi": "^1.8.1"
+    "anbaric-impl-cloud": "^1.10.0",
+    "anbaric-data-store": "^1.10.0",
+    "anbaric-state-machine": "^1.10.0",
+    "anbaric-tsapi": "^1.10.0"
   }
 }