@ctlflow/fleet 0.1.8 → 0.1.10

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/docs/commands.md CHANGED
@@ -42,6 +42,9 @@ fleet remove research
42
42
  Add registers an explicit directory or instance. New identities need owner
43
43
  approval. Start automatically resumes the full saved native histories. Missing
44
44
  or broken established history is an error, not permission to create a new one.
45
+ An already approved roster resumes using its saved controller authority, without
46
+ enrollment or overwriting owner-edited wake rules. Use explicit `fleet enroll`
47
+ while stopped to propose changed coordination defaults for owner review.
45
48
  Local start starts or reuses the configured controller. Status/list/show/test,
46
49
  contexts, attachment and registry edits never start it. Stop ends addressed
47
50
  listeners and owned Codex processes. Instance removal retires its fleet registration;
@@ -61,12 +61,22 @@ cwd. It defaults to that instance's private workarea. It must be canonical, owne
61
61
  and not writable by other users; existing project modes are not tightened.
62
62
  Private state remains in the workarea, passed separately to the native adapter as
63
63
  `stateDirectory`. The adapter's private native home retains the managed histories
64
- and intended provider configuration/authentication, without overwriting or
64
+ and intended provider configuration, without overwriting or
65
65
  importing the project's `.codex/config.toml`, history or coding session. Role
66
66
  instructions, administrator setup instructions and the pinned Crossfire skill
67
67
  are delivered via native developer instructions on both create and resume;
68
68
  external cwd does not rely on private workarea ancestor skill discovery.
69
69
 
70
+ Every native start/resume, including automatic wake and recovery, atomically
71
+ recopies the current host Codex `auth.json` from `CODEX_HOME` (default `~/.codex`).
72
+ Sign in with `codex login` on the controller host before resuming. Changing that
73
+ host login changes the provider account used on subsequent activations, not the
74
+ agent's Matrix identity or saved conversation. Already-running engines retain
75
+ their current login until stopped/resumed. Preflight checks the host login and
76
+ does not rewrite running agents. Invalid or unsafe source files fail before
77
+ startup; absence removes the stale file copy rather than reusing it. Native
78
+ environment-only provider authentication does not require a file login.
79
+
70
80
  Default project setup generates this same roster with one `project` definition,
71
81
  the chosen project as `workspace` and a stable private workarea. Definitions
72
82
  without `workspace` keep their original private cwd; this is one configuration
@@ -134,8 +144,10 @@ Omitting the whole block requests an explicit person-only selection for the
134
144
  actual configured owner and no invitation delegation. Each selected person can
135
145
  include their currently owned agents. Multiple entries combine; individual
136
146
  agents require `include_agents = false`. Use `wake_senders = []` for no entries.
137
- Changed policies require owner review on stop/start; unchanged restarts preserve
138
- manual room-specific edits. Configuration grants no room membership or native power.
147
+ Changed coordination policies require explicit `fleet enroll` while stopped and
148
+ owner review. Ordinary restarts validate existing identities and preserve live
149
+ wake rules and manual room-specific edits. Configuration grants no room membership
150
+ or native power.
139
151
  - [Fields, selected identities, approval and removal rules](https://github.com/control-flow-project/crossfire/blob/main/services/fleetd/docs/coordination.md)
140
152
 
141
153
  | Field | Accepted values | When omitted |
@@ -4,7 +4,9 @@
4
4
 
5
5
  `fleet enroll FLEET` reviews the complete roster of an already registered,
6
6
  stopped fleet. It uses the same enrollment and owner-approval flow as start,
7
- but never starts/resets native sessions or enables message delivery. An active
7
+ when start introduces new or renamed identities. Ordinary resume of an approved
8
+ roster does not request enrollment or overwrite owner-edited coordination policy.
9
+ Enroll never starts/resets native sessions or enables message delivery. An active
8
10
  fleet or per-agent enrollment target is rejected. Inspect `fleet show FLEET`
9
11
  after completion; starting later remains a separate explicit resume.
10
12
 
package/package.json CHANGED
@@ -1,14 +1,14 @@
1
1
  {
2
2
  "name": "@ctlflow/fleet",
3
- "version": "0.1.8",
3
+ "version": "0.1.10",
4
4
  "private": false,
5
5
  "publishConfig": { "access": "public" },
6
6
  "type": "module",
7
- "devDependencies": { "@ctlflow/crossfire-test-support": "0.1.8" },
7
+ "devDependencies": { "@ctlflow/crossfire-test-support": "0.1.10" },
8
8
  "bin": { "fleet": "./dist/bin/fleet.mjs" },
9
9
  "files": ["dist/bin", "docs", "README.md"],
10
10
  "exports": { "./executable": "./dist/bin/fleet.mjs", "./package.json": "./package.json" },
11
- "dependencies": { "@ctlflow/fleetd": "0.1.8" },
11
+ "dependencies": { "@ctlflow/fleetd": "0.1.10" },
12
12
  "engines": {
13
13
  "node": ">=26.0.0",
14
14
  "npm": ">=11.17.0"