@amalgm/apps 0.1.3-preview.34562094191 → 0.1.3-preview.34563878699

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
@@ -66,6 +66,8 @@ projection through public adapters; it does not replace product behavior. The
66
66
  active boundary is described in
67
67
  [docs/SHELL_INTEGRATION.md](./docs/SHELL_INTEGRATION.md). Supervisor ownership
68
68
  is defined in [docs/SUPERVISION.md](./docs/SUPERVISION.md).
69
+ What is proven and what remains is in [docs/STATUS.md](./docs/STATUS.md);
70
+ guidance for agents working here is in [AGENTS.md](./AGENTS.md).
69
71
 
70
72
  ## Verify
71
73
 
package/docs/STATUS.md ADDED
@@ -0,0 +1,60 @@
1
+ # Status
2
+
3
+ Last updated 2026-09-10.
4
+
5
+ ## Proven
6
+
7
+ amalgm-apps works on its own, as an SDK with a CLI and an MCP server on top.
8
+ It was tested on macOS with the real Design Canvas app, outside amalgm-shell.
9
+
10
+ - **All 16 commands work** from the CLI and as MCP tools: create, list, get,
11
+ update, delete, start, stop, deploy, rollback, versions, deployments, logs,
12
+ validate, routes, export, install.
13
+ - **Design Canvas runs as an Amalgm app.** `create` built it (npm install and a
14
+ UI build into an immutable release), started it, and it served on its port.
15
+ A design made through its own tool was saved in the app's data directory
16
+ and survived stop, start, deploy, and rollback.
17
+ - **Supervision works.** A killed app restarts by itself. A new owner (a new
18
+ MCP server) adopts the running app, and restarts it if it is killed.
19
+ - **Export and install work.** An exported app installed as a second app on
20
+ a free port with its own empty data.
21
+ - **Delete is clean.** No process, port, state file, or installed source is
22
+ left behind.
23
+ - `npm run verify` passes (45 tests) locally and in CI.
24
+
25
+ ## Fixed while testing
26
+
27
+ - **The CLI never exited** after create, start, or deploy. App output went
28
+ through pipes to the owner, which kept it alive; after a handoff the log had
29
+ no reader. Apps now write their own log through an inherited descriptor.
30
+ - **Install picked a busy port.** Allocation only checked its own database.
31
+ Each port is now proven free on the host (nothing answers on loopback).
32
+ - **A failed start did not say why.** The error now carries the log tail.
33
+
34
+ ## Cleaned up
35
+
36
+ Deleted the Engine-era importer, snake_case and `versionId` aliases, schema and
37
+ status migrations older than the first publish, unused options, internal
38
+ exports, and the Engine integration doc. The package index exports only the
39
+ SDK and its adapters.
40
+
41
+ ## Compared with the old Engine
42
+
43
+ The Engine gave agents 9 app tools: register, validate, list, routes,
44
+ redeploy, start, stop, connect DNS, disconnect DNS. It had no delete, get,
45
+ versions, deployment history, logs, or rollback for agents, and export and
46
+ install were internal to bundle sharing. Apps has 16 commands, identical on
47
+ the CLI and MCP.
48
+
49
+ ## Remains
50
+
51
+ - **Testing inside amalgm-shell.** The shell hosts Apps in the product. Still
52
+ to prove there: the shell boots Apps and adopts running apps, the CLI and MCP
53
+ work through the shell, the UI catalog lists apps, and a public
54
+ `*.apps.amalgm.ai` link opens the app. The preview machine needs a shell
55
+ build that carries this version of Apps.
56
+ - **Follow-ups in this repo:** move register and activation out of `apps.ts`
57
+ (it is near the line limit); delete the legacy `/artifacts` HTTP projection
58
+ once the UI reads `/apps`.
59
+ - **Outside this repo:** the shell's `bundle-apps.ts` duplicates the export and
60
+ install logic that `portable.ts` already provides.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@amalgm/apps",
3
- "version": "0.1.3-preview.34562094191",
3
+ "version": "0.1.3-preview.34563878699",
4
4
  "description": "Local-first, versioned application deployment for Amalgm.",
5
5
  "license": "UNLICENSED",
6
6
  "private": false,
@@ -89,11 +89,11 @@
89
89
  "package.json"
90
90
  ]
91
91
  },
92
- "gitHead": "62edf089a80bff8c4ac06371296846ff1b1e86a2",
92
+ "gitHead": "77d4afc1d914be0f6a68aee7dc8bf4d587f9218e",
93
93
  "amalgmSource": {
94
94
  "repository": "amalgm-inc/amalgm-apps",
95
95
  "branch": "preview",
96
- "commit": "62edf089a80bff8c4ac06371296846ff1b1e86a2",
97
- "occurrence": "34562094191"
96
+ "commit": "77d4afc1d914be0f6a68aee7dc8bf4d587f9218e",
97
+ "occurrence": "34563878699"
98
98
  }
99
99
  }