@atlasharness/atlasweb 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,52 @@
1
- # Temporary Holding Version
1
+ # @atlasharness/atlasweb
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ AtlasWeb shell — the unified Web platform front-end for the Atlas product
4
+ family (AtlasCode / AtlasOffice / AtlasComic). This package ships the built,
5
+ read-only Code view bundle: session list, conversation replay, search, and
6
+ live follow over the [AtlasCode](https://www.npmjs.com/package/@atlasharness/atlascode)
7
+ web-session runtime.
8
+
9
+ ## What's inside
10
+
11
+ `dist/` — a static single-page bundle (vite 6, React 18, es2022 target):
12
+
13
+ - `index.html` + hashed JS/CSS assets; no server-side code.
14
+ - Read-only by contract: no composer, approval, or message-submit surface
15
+ (enforced by the repository's readonly-lexicon gate).
16
+
17
+ ## Serving
18
+
19
+ One command serves both the UI and the session API on the same origin: the
20
+ repository's web-host launcher takes `--static` pointing at this bundle's
21
+ `dist/` directory (from the installed npm package or a local build):
22
+
23
+ ```sh
24
+ # from the paired AtlasWeb repository checkout
25
+ bun packages/web-host/src/launchCli.ts --port 8940 \
26
+ --static node_modules/@atlasharness/atlasweb/dist \
27
+ --scope main=<scope-dir>
28
+ # <scope-dir> is the AtlasCode session storage dir for your project,
29
+ # e.g. ~/.atlas/projects/-home-vince-projects-atlascode (cwd with '/' → '-').
30
+ ```
31
+
32
+ It prints one ready line with a single-use launch `token`. Open
33
+ `http://127.0.0.1:<port>/?token=<token>`; the app redeems it against the
34
+ host (HttpOnly cookie) and strips it from the address bar. Browsers boot the
35
+ UI without credentials — the static face sits in front of the auth gate and
36
+ API calls ride the ambient cookie.
37
+
38
+ `--static` is optional: without it the host serves only the API (pair with
39
+ any static file server / reverse proxy for the UI). The launcher itself is
40
+ part of this repository (`packages/web-host`) and is not yet published as a
41
+ standalone binary.
42
+
43
+ ## Versioning
44
+
45
+ `0.1.x` tracks the AtlasWeb shell foundation wave (T6-A). The package is
46
+ built from the paired AtlasWeb repository; versions are release-contract
47
+ pins paired against the AtlasCode carrier (`@atlasharness/atlascode`).
48
+
49
+ ## License
50
+
51
+ MIT — see the repository for third-party notices (dsh baseline, vendored
52
+ Cordis).