@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 +2 -0
- package/docs/STATUS.md +60 -0
- package/package.json +4 -4
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.
|
|
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": "
|
|
92
|
+
"gitHead": "77d4afc1d914be0f6a68aee7dc8bf4d587f9218e",
|
|
93
93
|
"amalgmSource": {
|
|
94
94
|
"repository": "amalgm-inc/amalgm-apps",
|
|
95
95
|
"branch": "preview",
|
|
96
|
-
"commit": "
|
|
97
|
-
"occurrence": "
|
|
96
|
+
"commit": "77d4afc1d914be0f6a68aee7dc8bf4d587f9218e",
|
|
97
|
+
"occurrence": "34563878699"
|
|
98
98
|
}
|
|
99
99
|
}
|