@chankov/agent-fleet 0.0.2 → 0.0.3

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.
Files changed (47) hide show
  1. package/.claude/commands/doctor-agent-fleet.md +1 -1
  2. package/.claude/commands/setup-agent-fleet.md +4 -4
  3. package/.opencode/commands/af-doctor-agent-fleet.md +2 -0
  4. package/.opencode/commands/af-setup-agent-fleet.md +1 -1
  5. package/.pi/agents/peers.yaml +4 -0
  6. package/.pi/agents/teams.yaml +2 -2
  7. package/.pi/harnesses/agent-hub/README.md +57 -4
  8. package/.pi/harnesses/agent-hub/index.ts +236 -80
  9. package/.pi/harnesses/agent-hub/research-retention.js +34 -0
  10. package/.pi/harnesses/ask-user-remote/README.md +2 -0
  11. package/.pi/harnesses/coms/README.md +11 -0
  12. package/.pi/prompts/doctor-agent-fleet.md +1 -1
  13. package/.pi/prompts/setup-agent-fleet.md +4 -4
  14. package/README.md +102 -540
  15. package/agents/architect.md +1 -1
  16. package/agents/planner.md +1 -1
  17. package/agents/security-auditor.md +1 -1
  18. package/bin/snapshot-version.js +17 -1
  19. package/codex/CONDUCTOR.md +148 -0
  20. package/docs/ARCHITECTURE.md +165 -0
  21. package/docs/agent-fleet-setup.md +1 -0
  22. package/docs/claude-code-coms-bridge.md +10 -0
  23. package/docs/codex-remote-conductor.md +170 -0
  24. package/docs/coms-hermes-bridge.md +121 -0
  25. package/docs/getting-started.md +14 -0
  26. package/docs/npm-install.md +2 -0
  27. package/docs/pi-setup.md +2 -0
  28. package/hermes/README.md +48 -0
  29. package/hermes/skills/hub-conductor/SKILL.md +84 -0
  30. package/hermes/skills/hub-liaison/SKILL.md +84 -0
  31. package/justfile +100 -13
  32. package/package.json +10 -3
  33. package/scripts/codex-conductor.ts +41 -0
  34. package/scripts/codex-remote-control.ts +167 -0
  35. package/scripts/coms-cli.ts +311 -199
  36. package/scripts/coms-hermes-bridge.ts +2 -2
  37. package/scripts/lib/codex-conductor.ts +88 -0
  38. package/scripts/lib/codex-remote-control.ts +480 -0
  39. package/scripts/lib/coms-envelope.ts +51 -6
  40. package/scripts/lib/herdr-layout.ts +18 -3
  41. package/scripts/lib/hermes-bridge-core.ts +4 -4
  42. package/scripts/lib/team-project.ts +85 -1
  43. package/scripts/team-up.ts +77 -18
  44. package/skills/guided-workspace-setup/SKILL.md +123 -97
  45. package/skills/guided-workspace-setup/companion-manifest.json +33 -0
  46. package/skills/peer-coms/SKILL.md +9 -0
  47. package/systemd/user/agent-fleet-codex-remote-control.service.in +23 -0
@@ -0,0 +1,41 @@
1
+ #!/usr/bin/env node
2
+ // Experimental external Codex conductor wrapper. It exposes no lifecycle,
3
+ // pairing, authentication, Herdr, or scope-override functionality.
4
+
5
+ import { spawnSync } from "node:child_process";
6
+ import * as fs from "node:fs";
7
+ import * as path from "node:path";
8
+ import { fileURLToPath } from "node:url";
9
+
10
+ import { buildConductorCommand, conductorProcessEnv, loadConductorContext, parseConductorArgs } from "./lib/codex-conductor.ts";
11
+ import { lifecyclePaths } from "./lib/codex-remote-control.ts";
12
+
13
+ function main(): void {
14
+ // Parse flags before config or filesystem access, then bind all scope from
15
+ // the owned configuration and the dedicated writable scratch directory.
16
+ const operation = parseConductorArgs(process.argv.slice(2));
17
+ const checkoutRoot = fs.realpathSync(path.resolve(path.dirname(fileURLToPath(import.meta.url)), ".."));
18
+ const context = loadConductorContext({
19
+ configPath: lifecyclePaths().configPath,
20
+ cwd: process.cwd(),
21
+ checkoutRoot,
22
+ });
23
+ const result = spawnSync(process.execPath, [
24
+ "--experimental-strip-types",
25
+ path.join(context.repoRoot, "scripts", "coms-cli.ts"),
26
+ ...buildConductorCommand(context, operation),
27
+ ], {
28
+ cwd: context.conductorCwd,
29
+ stdio: "inherit",
30
+ env: conductorProcessEnv(context),
31
+ });
32
+ if (result.error) throw result.error;
33
+ process.exitCode = result.status ?? 1;
34
+ }
35
+
36
+ try {
37
+ main();
38
+ } catch (error) {
39
+ console.error(error instanceof Error ? error.message : String(error));
40
+ process.exitCode = 1;
41
+ }
@@ -0,0 +1,167 @@
1
+ #!/usr/bin/env node
2
+ // Repository-side lifecycle CLI. It never pairs automatically and exposes no
3
+ // health, PID, or transport assumptions.
4
+
5
+ import * as os from "node:os";
6
+ import * as path from "node:path";
7
+
8
+ import {
9
+ CONFIG_MARKER,
10
+ EMERGENCY_STOP_CONFIRMATION,
11
+ emergencySystemdStop,
12
+ lifecyclePaths,
13
+ loadOwnedConfig,
14
+ preflight,
15
+ restart,
16
+ setup,
17
+ start,
18
+ status,
19
+ stop,
20
+ systemRunner,
21
+ uninstall,
22
+ unitStart,
23
+ unitStop,
24
+ validateConfig,
25
+ type LifecycleConfig,
26
+ } from "./lib/codex-remote-control.ts";
27
+
28
+ type Flag = "config" | "codex-bin" | "repo-root" | "coms-dir" | "project" | "team" | "name" | "timeout" | "home" | "confirm" | "emergency-confirm";
29
+ const FLAGS = new Set<Flag>(["config", "codex-bin", "repo-root", "coms-dir", "project", "team", "name", "timeout", "home", "confirm", "emergency-confirm"]);
30
+
31
+ function fail(message: string): never { throw new Error(message); }
32
+
33
+ function parse(argv: string[]): { command: string; flags: Map<Flag, string> } {
34
+ const command = argv[0];
35
+ if (!command) fail("Usage: codex-remote-control <preflight|setup|reconfigure|setup-conductor|reconfigure-conductor|setup-pilot|reconfigure-pilot|pair|start|stop|emergency-stop|status|restart|recover|uninstall|control-pane|unit-start|unit-stop>");
36
+ const flags = new Map<Flag, string>();
37
+ for (let i = 1; i < argv.length; i++) {
38
+ const raw = argv[i];
39
+ if (!raw.startsWith("--")) fail(`Unexpected argument: ${raw}`);
40
+ const flag = raw.slice(2) as Flag;
41
+ if (!FLAGS.has(flag)) fail(`Unknown flag: ${raw}`);
42
+ if (flags.has(flag)) fail(`${raw} may only be provided once`);
43
+ const value = argv[++i];
44
+ if (!value || value.startsWith("--")) fail(`${raw} requires a value`);
45
+ flags.set(flag, value);
46
+ }
47
+ return { command, flags };
48
+ }
49
+
50
+ function required(flags: Map<Flag, string>, flag: Flag): string {
51
+ return flags.get(flag) ?? fail(`--${flag} is required`);
52
+ }
53
+
54
+ function runtimeDir(flags: Map<Flag, string>): string {
55
+ return lifecyclePaths(flags.get("home")).runtimeDir;
56
+ }
57
+
58
+ function configFromFlags(flags: Map<Flag, string>): LifecycleConfig {
59
+ return validateConfig({
60
+ marker: CONFIG_MARKER,
61
+ codexBin: required(flags, "codex-bin"),
62
+ repoRoot: required(flags, "repo-root"),
63
+ runtimeDir: runtimeDir(flags),
64
+ comsDir: required(flags, "coms-dir"),
65
+ project: required(flags, "project"),
66
+ team: required(flags, "team"),
67
+ name: required(flags, "name"),
68
+ timeoutMs: Number(required(flags, "timeout")),
69
+ });
70
+ }
71
+
72
+ function conductorConfigFromFlags(flags: Map<Flag, string>): LifecycleConfig {
73
+ const team = required(flags, "team");
74
+ const project = flags.get("project") ?? "default";
75
+ return validateConfig({
76
+ marker: CONFIG_MARKER,
77
+ codexBin: required(flags, "codex-bin"),
78
+ repoRoot: required(flags, "repo-root"),
79
+ runtimeDir: runtimeDir(flags),
80
+ comsDir: required(flags, "coms-dir"),
81
+ project,
82
+ team,
83
+ name: `codex-${team}-conductor`,
84
+ timeoutMs: Number(required(flags, "timeout")),
85
+ });
86
+ }
87
+
88
+ function configPath(flags: Map<Flag, string>): string {
89
+ return flags.get("config") ?? lifecyclePaths(flags.get("home")).configPath;
90
+ }
91
+
92
+ function configured(flags: Map<Flag, string>): LifecycleConfig {
93
+ return loadOwnedConfig(configPath(flags));
94
+ }
95
+
96
+ function pair(config: LifecycleConfig): void {
97
+ const checked = preflight(config);
98
+ const result = systemRunner(checked.codexBin, ["remote-control", "pair"], { stdio: "inherit" });
99
+ if (result.code !== 0) fail(`codex remote-control pair failed (${result.code})`);
100
+ }
101
+
102
+ function controlPane(): void {
103
+ console.log("Codex control pane: displaying requested systemd state only; this is not daemon health.");
104
+ const report = () => console.log(status());
105
+ report();
106
+ const timer = setInterval(report, 5_000);
107
+ const close = () => clearInterval(timer);
108
+ process.once("SIGINT", close);
109
+ process.once("SIGTERM", close);
110
+ }
111
+
112
+ function main(): void {
113
+ const { command, flags } = parse(process.argv.slice(2));
114
+ switch (command) {
115
+ case "preflight": {
116
+ const config = flags.has("repo-root") ? configFromFlags(flags) : validateConfig({
117
+ marker: CONFIG_MARKER,
118
+ codexBin: required(flags, "codex-bin"),
119
+ repoRoot: process.cwd(), runtimeDir: lifecyclePaths().runtimeDir, comsDir: path.join(os.homedir(), ".pi", "coms"),
120
+ project: "default", team: "codex", name: "codex", timeoutMs: 300_000,
121
+ });
122
+ preflight(config);
123
+ console.log("Codex 0.144.x remote-control start|stop|pair preflight passed");
124
+ return;
125
+ }
126
+ case "setup":
127
+ case "reconfigure":
128
+ case "setup-conductor":
129
+ case "reconfigure-conductor":
130
+ case "setup-pilot":
131
+ case "reconfigure-pilot": {
132
+ const scoped = command.endsWith("-conductor") || command.endsWith("-pilot");
133
+ const paths = setup(scoped ? conductorConfigFromFlags(flags) : configFromFlags(flags), systemRunner, {
134
+ home: flags.get("home"),
135
+ reconfigure: command.startsWith("reconfigure"),
136
+ });
137
+ console.log(`${command} complete: ${paths.unitPath}`);
138
+ return;
139
+ }
140
+ case "pair": pair(configured(flags)); return;
141
+ case "start": console.log(start(configured(flags))); return;
142
+ case "stop": console.log(stop(configured(flags))); return;
143
+ case "emergency-stop": console.log(emergencySystemdStop(configured(flags), systemRunner, required(flags, "confirm"))); return;
144
+ case "status": console.log(status()); return;
145
+ case "control-pane": controlPane(); return;
146
+ case "restart":
147
+ case "recover": console.log(restart(configured(flags), systemRunner, required(flags, "confirm"))); return;
148
+ case "uninstall": {
149
+ const paths = lifecyclePaths(flags.get("home"));
150
+ uninstall(paths, systemRunner, {
151
+ confirmation: required(flags, "confirm"),
152
+ emergencyConfirmation: flags.get("emergency-confirm") === EMERGENCY_STOP_CONFIRMATION ? EMERGENCY_STOP_CONFIRMATION : undefined,
153
+ });
154
+ return;
155
+ }
156
+ case "unit-start": unitStart(configured(flags)); return;
157
+ case "unit-stop": unitStop(configured(flags)); return;
158
+ default: fail(`Unknown command: ${command}`);
159
+ }
160
+ }
161
+
162
+ try {
163
+ main();
164
+ } catch (error) {
165
+ console.error(error instanceof Error ? error.message : String(error));
166
+ process.exitCode = 1;
167
+ }