@timurproko/a1 0.2.1-dev.603 → 0.2.1-dev.606
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 +22 -18
- package/dist/cli/package-messages.js +2 -2
- package/dist/native/darwin-arm64/manifest.json +1 -1
- package/dist/native/linux-x64/manifest.json +1 -1
- package/dist/native/win32-x64/manifest.json +2 -2
- package/dist/native/win32-x64/process-guardian.exe +0 -0
- package/docs/ci-release-runbook.md +2 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -3,14 +3,17 @@
|
|
|
3
3
|
## Install
|
|
4
4
|
|
|
5
5
|
```sh
|
|
6
|
-
#
|
|
6
|
+
# release
|
|
7
7
|
npx -y @timurproko/a1-install
|
|
8
8
|
|
|
9
|
-
#
|
|
9
|
+
# develop
|
|
10
10
|
npx -y @timurproko/a1-install --develop
|
|
11
11
|
|
|
12
|
-
#
|
|
13
|
-
npx -y @timurproko/a1-install --
|
|
12
|
+
# preview number
|
|
13
|
+
npx -y @timurproko/a1-install --develop 107
|
|
14
|
+
|
|
15
|
+
# exact preview
|
|
16
|
+
npx -y @timurproko/a1-install --develop 0.1.8-dev.107
|
|
14
17
|
```
|
|
15
18
|
|
|
16
19
|
The installer keeps npm's dependency transcript out of the normal terminal output,
|
|
@@ -18,12 +21,13 @@ shows one progress row, activates the installed release, and verifies the comman
|
|
|
18
21
|
before reporting success. The shorter `npx @timurproko/a1-install` form also works,
|
|
19
22
|
but npm may ask for first-use confirmation; `-y` avoids that prompt.
|
|
20
23
|
|
|
21
|
-
Direct npm installation remains available as a fallback or manual recovery path
|
|
24
|
+
Direct npm installation remains available as a fallback or manual recovery path.
|
|
25
|
+
npm's `latest` tag carries the release and `next` carries develop:
|
|
22
26
|
|
|
23
27
|
```sh
|
|
24
|
-
npm install -g @timurproko/a1@latest
|
|
25
|
-
npm install -g @timurproko/a1@next
|
|
26
|
-
npm install -g @timurproko/a1@0.1.8-dev.107
|
|
28
|
+
npm install -g @timurproko/a1@latest # release
|
|
29
|
+
npm install -g @timurproko/a1@next # develop
|
|
30
|
+
npm install -g @timurproko/a1@0.1.8-dev.107 # exact preview
|
|
27
31
|
```
|
|
28
32
|
|
|
29
33
|
## Use
|
|
@@ -32,19 +36,19 @@ npm install -g @timurproko/a1@0.1.8-dev.107
|
|
|
32
36
|
a1 # launch A1 (profile: ~/.a1/agent)
|
|
33
37
|
a1 help # show all commands
|
|
34
38
|
a1 version # show the version
|
|
35
|
-
a1 update # install the
|
|
36
|
-
a1 update --develop # install
|
|
37
|
-
a1 update --develop 107 # install
|
|
39
|
+
a1 update # install the release
|
|
40
|
+
a1 update --develop # install develop
|
|
41
|
+
a1 update --develop 107 # install preview 107
|
|
38
42
|
a1 update --develop 0.1.8-dev.107 # install that exact preview
|
|
39
43
|
a1 update --models # refresh A1's model catalogs
|
|
40
44
|
a1 update --extensions # update every installed package
|
|
41
45
|
a1 update npm:pi-mcp-adapter # update one package
|
|
42
46
|
```
|
|
43
47
|
|
|
44
|
-
|
|
45
|
-
current
|
|
48
|
+
Release builds print only their installed version. Develop builds also show the
|
|
49
|
+
current develop and release channel versions.
|
|
46
50
|
|
|
47
|
-
|
|
51
|
+
Develop previews add the Pi comparison profile; release builds do not carry it.
|
|
48
52
|
|
|
49
53
|
```sh
|
|
50
54
|
a1 pi # vanilla Pi oracle: ~/.pi/agent
|
|
@@ -88,8 +92,8 @@ fails by name instead of inside a resolver or Cargo.
|
|
|
88
92
|
npm run doctor # report Node, npm, git, Rust, and dependency readiness
|
|
89
93
|
npm ci # install exact locked dependencies
|
|
90
94
|
npm run build # compile TypeScript and the process guardian into dist
|
|
91
|
-
npm start # build and launch a
|
|
92
|
-
npm run start:pi # build and launch a
|
|
95
|
+
npm start # build and launch a source `a1`
|
|
96
|
+
npm run start:pi # build and launch a source `a1 pi`
|
|
93
97
|
npm run test:fast # typecheck + fast suite (alias: npm test)
|
|
94
98
|
npm run test:full # complete non-physical suite
|
|
95
99
|
```
|
|
@@ -104,7 +108,7 @@ Create every task worktree at `{working-dir}/.worktrees/<task-id>`, where
|
|
|
104
108
|
Two channels, both published by CI from the exact bytes it validated — never from
|
|
105
109
|
a workstation.
|
|
106
110
|
|
|
107
|
-
###
|
|
111
|
+
### Develop previews
|
|
108
112
|
|
|
109
113
|
A preview is `<major.minor.patch>-dev.<pull-request number>`, e.g. `0.1.8-dev.107`.
|
|
110
114
|
The nightly run (`03:17 UTC`) verifies current `origin/develop` and publishes only
|
|
@@ -125,7 +129,7 @@ a1 update --develop 107 # install preview 107
|
|
|
125
129
|
a1 update --develop 0.1.8-dev.107 # install that exact full preview version
|
|
126
130
|
```
|
|
127
131
|
|
|
128
|
-
###
|
|
132
|
+
### Release
|
|
129
133
|
|
|
130
134
|
```sh
|
|
131
135
|
npm run release -- patch # 0.1.8-dev -> 0.1.8
|
|
@@ -70,11 +70,11 @@ Examples:
|
|
|
70
70
|
return header + `${namespace === "direct" ? "Update A1, installed packages, or model catalogs." : "Update installed packages or model catalogs."}
|
|
71
71
|
|
|
72
72
|
Options:
|
|
73
|
-
${namespace === "direct" ? " --develop [target] Update to
|
|
73
|
+
${namespace === "direct" ? " --develop [target] Update to develop or one preview\n" : ""} --extensions Update installed packages only
|
|
74
74
|
--models Refresh model catalogs only
|
|
75
75
|
|
|
76
76
|
Short forms:
|
|
77
|
-
${namespace === "direct" ? ` ${command} update Update A1 to the
|
|
77
|
+
${namespace === "direct" ? ` ${command} update Update A1 to the release\n ${command} update --develop Update A1 to develop\n` : ""} ${command} update --extensions Update installed packages only
|
|
78
78
|
${command} update --models Refresh model catalogs only
|
|
79
79
|
${command} update <source> Update one package
|
|
80
80
|
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
"platform": "darwin",
|
|
6
6
|
"architecture": "arm64",
|
|
7
7
|
"capability": "supported",
|
|
8
|
-
"builtAt": "2026-09-
|
|
8
|
+
"builtAt": "2026-09-27T19:27:10.532Z",
|
|
9
9
|
"artifact": {
|
|
10
10
|
"filename": "process-guardian",
|
|
11
11
|
"sha256": "9db1726bbe3fc2e8292f2ead1e7e9d0fd4d7d0dc9217b372582bf354b0f565dc",
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
"platform": "linux",
|
|
6
6
|
"architecture": "x64",
|
|
7
7
|
"capability": "supported",
|
|
8
|
-
"builtAt": "2026-09-
|
|
8
|
+
"builtAt": "2026-09-27T19:26:57.414Z",
|
|
9
9
|
"artifact": {
|
|
10
10
|
"filename": "process-guardian",
|
|
11
11
|
"sha256": "d8cda6b0c7cb36c0cc41e90802aceebf6c02eaebbc08a83d7d963d2e918dbd7a",
|
|
@@ -5,10 +5,10 @@
|
|
|
5
5
|
"platform": "win32",
|
|
6
6
|
"architecture": "x64",
|
|
7
7
|
"capability": "supported",
|
|
8
|
-
"builtAt": "2026-09-
|
|
8
|
+
"builtAt": "2026-09-27T19:27:41.733Z",
|
|
9
9
|
"artifact": {
|
|
10
10
|
"filename": "process-guardian.exe",
|
|
11
|
-
"sha256": "
|
|
11
|
+
"sha256": "baeef67351af8695e595c63bdc7ac93ac4f1651497c6f4fcbcbf39886115bc4b",
|
|
12
12
|
"size": 178176
|
|
13
13
|
},
|
|
14
14
|
"provenance": {
|
|
Binary file
|
|
@@ -187,7 +187,8 @@ Users install previews with public `develop` terminology:
|
|
|
187
187
|
|
|
188
188
|
```sh
|
|
189
189
|
npx -y @timurproko/a1-install --develop
|
|
190
|
-
npx -y @timurproko/a1-install --
|
|
190
|
+
npx -y @timurproko/a1-install --develop 107
|
|
191
|
+
npx -y @timurproko/a1-install --develop 0.1.8-dev.107
|
|
191
192
|
a1 update --develop # update an existing installation
|
|
192
193
|
a1 update --develop 107 # numbered preview
|
|
193
194
|
a1 update --develop 0.1.8-dev.107 # exact full preview version
|
package/package.json
CHANGED