@cotal-ai/workspace 0.100.2 → 0.101.1
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/build/Release/darwin-arm64/build.json +21 -0
- package/build/Release/darwin-arm64/process.node +0 -0
- package/build/Release/darwin-x64/build.json +21 -0
- package/build/Release/darwin-x64/process.node +0 -0
- package/build/Release/win32-arm64/build.json +7 -5
- package/build/Release/win32-arm64/creation.node +0 -0
- package/build/Release/win32-x64/build.json +7 -5
- package/build/Release/win32-x64/creation.node +0 -0
- package/dist/agent-grants.d.ts +21 -0
- package/dist/agent-grants.d.ts.map +1 -0
- package/dist/agent-grants.js +21 -0
- package/dist/agent-grants.js.map +1 -0
- package/dist/auth-paths.d.ts +34 -0
- package/dist/auth-paths.d.ts.map +1 -1
- package/dist/auth-paths.js +99 -3
- package/dist/auth-paths.js.map +1 -1
- package/dist/broker-display.d.ts +12 -0
- package/dist/broker-display.d.ts.map +1 -1
- package/dist/broker-display.js +14 -0
- package/dist/broker-display.js.map +1 -1
- package/dist/connect.d.ts +21 -7
- package/dist/connect.d.ts.map +1 -1
- package/dist/connect.js +152 -22
- package/dist/connect.js.map +1 -1
- package/dist/control-target.d.ts.map +1 -1
- package/dist/control-target.js +12 -10
- package/dist/control-target.js.map +1 -1
- package/dist/cotal-config.d.ts +7 -0
- package/dist/cotal-config.d.ts.map +1 -1
- package/dist/cotal-config.js +29 -2
- package/dist/cotal-config.js.map +1 -1
- package/dist/cotal-home.d.ts +23 -0
- package/dist/cotal-home.d.ts.map +1 -0
- package/dist/cotal-home.js +36 -0
- package/dist/cotal-home.js.map +1 -0
- package/dist/credential-actions.d.ts +17 -3
- package/dist/credential-actions.d.ts.map +1 -1
- package/dist/credential-actions.js +62 -10
- package/dist/credential-actions.js.map +1 -1
- package/dist/darwin-process.d.ts +20 -0
- package/dist/darwin-process.d.ts.map +1 -0
- package/dist/darwin-process.js +24 -0
- package/dist/darwin-process.js.map +1 -0
- package/dist/deprecated-daemon-entries.d.ts +3 -0
- package/dist/deprecated-daemon-entries.d.ts.map +1 -1
- package/dist/deprecated-daemon-entries.js +6 -1
- package/dist/deprecated-daemon-entries.js.map +1 -1
- package/dist/extensions.d.ts +4 -2
- package/dist/extensions.d.ts.map +1 -1
- package/dist/extensions.js +7 -2
- package/dist/extensions.js.map +1 -1
- package/dist/flags.d.ts +2 -0
- package/dist/flags.d.ts.map +1 -1
- package/dist/flags.js +1 -1
- package/dist/flags.js.map +1 -1
- package/dist/index.d.ts +9 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -1
- package/dist/index.js.map +1 -1
- package/dist/join-target.d.ts +3 -1
- package/dist/join-target.d.ts.map +1 -1
- package/dist/join-target.js +15 -3
- package/dist/join-target.js.map +1 -1
- package/dist/maintenance.d.ts +61 -2
- package/dist/maintenance.d.ts.map +1 -1
- package/dist/maintenance.js +153 -14
- package/dist/maintenance.js.map +1 -1
- package/dist/manager-name.d.ts +15 -0
- package/dist/manager-name.d.ts.map +1 -0
- package/dist/manager-name.js +54 -0
- package/dist/manager-name.js.map +1 -0
- package/dist/mesh-registry.d.ts +39 -35
- package/dist/mesh-registry.d.ts.map +1 -1
- package/dist/mesh-registry.js +57 -36
- package/dist/mesh-registry.js.map +1 -1
- package/dist/mesh-target.d.ts +120 -3
- package/dist/mesh-target.d.ts.map +1 -1
- package/dist/mesh-target.js +319 -48
- package/dist/mesh-target.js.map +1 -1
- package/dist/official-connectors.d.ts +3 -0
- package/dist/official-connectors.d.ts.map +1 -1
- package/dist/official-connectors.js +5 -0
- package/dist/official-connectors.js.map +1 -1
- package/dist/output.d.ts +34 -6
- package/dist/output.d.ts.map +1 -1
- package/dist/output.js +38 -5
- package/dist/output.js.map +1 -1
- package/dist/pid.d.ts +42 -7
- package/dist/pid.d.ts.map +1 -1
- package/dist/pid.js +196 -27
- package/dist/pid.js.map +1 -1
- package/dist/preferences.d.ts +25 -3
- package/dist/preferences.d.ts.map +1 -1
- package/dist/preferences.js +77 -14
- package/dist/preferences.js.map +1 -1
- package/dist/preflight.d.ts +17 -5
- package/dist/preflight.d.ts.map +1 -1
- package/dist/preflight.js +22 -32
- package/dist/preflight.js.map +1 -1
- package/dist/prepared-spaces.d.ts +20 -2
- package/dist/prepared-spaces.d.ts.map +1 -1
- package/dist/prepared-spaces.js +90 -15
- package/dist/prepared-spaces.js.map +1 -1
- package/dist/present.d.ts +2 -12
- package/dist/present.d.ts.map +1 -1
- package/dist/present.js +24 -40
- package/dist/present.js.map +1 -1
- package/dist/protected-records.d.ts +22 -3
- package/dist/protected-records.d.ts.map +1 -1
- package/dist/protected-records.js +198 -27
- package/dist/protected-records.js.map +1 -1
- package/dist/registration-policy.d.ts +2 -1
- package/dist/registration-policy.d.ts.map +1 -1
- package/dist/render.d.ts +2 -1
- package/dist/render.d.ts.map +1 -1
- package/dist/render.js +42 -11
- package/dist/render.js.map +1 -1
- package/dist/renewal.d.ts +4 -0
- package/dist/renewal.d.ts.map +1 -1
- package/dist/renewal.js +20 -1
- package/dist/renewal.js.map +1 -1
- package/dist/service-adapter.d.ts +1 -2
- package/dist/service-adapter.d.ts.map +1 -1
- package/dist/service-adapter.js +9 -4
- package/dist/service-adapter.js.map +1 -1
- package/dist/service-custody.js +2 -2
- package/dist/service-custody.js.map +1 -1
- package/dist/service-definition.d.ts +3 -0
- package/dist/service-definition.d.ts.map +1 -1
- package/dist/service-definition.js +56 -2
- package/dist/service-definition.js.map +1 -1
- package/dist/service-definition.schema.json +2 -1
- package/dist/service-identity.js +4 -4
- package/dist/service-identity.js.map +1 -1
- package/dist/service-stop.js +3 -3
- package/dist/service-stop.js.map +1 -1
- package/dist/service-target.d.ts.map +1 -1
- package/dist/service-target.js +9 -2
- package/dist/service-target.js.map +1 -1
- package/dist/signer-export.d.ts +1 -0
- package/dist/signer-export.d.ts.map +1 -1
- package/dist/signer-export.js +20 -4
- package/dist/signer-export.js.map +1 -1
- package/dist/space-streams.d.ts +18 -0
- package/dist/space-streams.d.ts.map +1 -0
- package/dist/space-streams.js +41 -0
- package/dist/space-streams.js.map +1 -0
- package/dist/space.d.ts +5 -0
- package/dist/space.d.ts.map +1 -1
- package/dist/space.js +5 -0
- package/dist/space.js.map +1 -1
- package/dist/store-entries.d.ts +6 -0
- package/dist/store-entries.d.ts.map +1 -0
- package/dist/store-entries.js +17 -0
- package/dist/store-entries.js.map +1 -0
- package/dist/system-rotation.d.ts +3 -1
- package/dist/system-rotation.d.ts.map +1 -1
- package/dist/system-rotation.js +19 -4
- package/dist/system-rotation.js.map +1 -1
- package/dist/text-wrap.d.ts +18 -0
- package/dist/text-wrap.d.ts.map +1 -0
- package/dist/text-wrap.js +60 -0
- package/dist/text-wrap.js.map +1 -0
- package/dist/win32-custodian.d.ts +2 -0
- package/dist/win32-custodian.d.ts.map +1 -0
- package/dist/win32-custodian.js +85 -0
- package/dist/win32-custodian.js.map +1 -0
- package/dist/win32-custody.d.ts +57 -0
- package/dist/win32-custody.d.ts.map +1 -0
- package/dist/win32-custody.js +220 -0
- package/dist/win32-custody.js.map +1 -0
- package/dist/win32-process.d.ts +38 -0
- package/dist/win32-process.d.ts.map +1 -1
- package/dist/win32-process.js +63 -5
- package/dist/win32-process.js.map +1 -1
- package/native/README.md +6 -4
- package/native/darwin-process.c +173 -0
- package/native/win32-process.c +317 -14
- package/native/win32-system-id.cpp +32 -0
- package/package.json +2 -2
- package/scripts/assert-shipped-natives.mjs +3 -3
- package/scripts/build-native.mjs +46 -26
- package/scripts/native-contract.mjs +36 -16
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { type LocalProcessContext } from "./local-process.js";
|
|
2
|
+
/** The name a manager started without one puts on its presence card. */
|
|
3
|
+
export declare const DEFAULT_MANAGER_NAME = "manager";
|
|
4
|
+
/** Where a root keeps the name of its manager for one space. The name belongs to the logical
|
|
5
|
+
* instance, which persists in the root across restarts, so a restart or a repair keeps it. */
|
|
6
|
+
export declare const MANAGER_NAME_RECORD = "manager.{space}.name.json";
|
|
7
|
+
/** Whether `value` has the shape of a manager instance id, which `--on` reads as an id. */
|
|
8
|
+
export declare function instanceIdShaped(value: string): boolean;
|
|
9
|
+
/** Check a manager name: the shared display-name rules, and not the shape of an instance id. */
|
|
10
|
+
export declare function assertManagerName(name: string): string;
|
|
11
|
+
/** The name recorded for this root's manager, or undefined when none was given. */
|
|
12
|
+
export declare function readManagerName(context: LocalProcessContext): string | undefined;
|
|
13
|
+
/** Record `name` as this root's manager name for the space. */
|
|
14
|
+
export declare function recordManagerName(context: LocalProcessContext, name: string): void;
|
|
15
|
+
//# sourceMappingURL=manager-name.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"manager-name.d.ts","sourceRoot":"","sources":["../src/manager-name.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAIzF,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C;+FAC+F;AAC/F,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAE/D,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,gGAAgG;AAChG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAUhF;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAElF"}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { assertLifecycleToken, assertValidName, writeSecretFileAtomic } from "@cotal-ai/core";
|
|
2
|
+
import { canonicalLocalProcessPath } from "./local-process.js";
|
|
3
|
+
import { CommandFailure } from "./output.js";
|
|
4
|
+
import { localRecordObject, localRecordText, readLocalRecordSource } from "./protected-records.js";
|
|
5
|
+
/** The name a manager started without one puts on its presence card. */
|
|
6
|
+
export const DEFAULT_MANAGER_NAME = "manager";
|
|
7
|
+
/** Where a root keeps the name of its manager for one space. The name belongs to the logical
|
|
8
|
+
* instance, which persists in the root across restarts, so a restart or a repair keeps it. */
|
|
9
|
+
export const MANAGER_NAME_RECORD = "manager.{space}.name.json";
|
|
10
|
+
/** Whether `value` has the shape of a manager instance id, which `--on` reads as an id. */
|
|
11
|
+
export function instanceIdShaped(value) {
|
|
12
|
+
try {
|
|
13
|
+
assertLifecycleToken(value);
|
|
14
|
+
return true;
|
|
15
|
+
}
|
|
16
|
+
catch {
|
|
17
|
+
return false;
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
/** Check a manager name: the shared display-name rules, and not the shape of an instance id. */
|
|
21
|
+
export function assertManagerName(name) {
|
|
22
|
+
try {
|
|
23
|
+
assertValidName(name);
|
|
24
|
+
}
|
|
25
|
+
catch (error) {
|
|
26
|
+
throw new CommandFailure("refused", "USAGE_INVALID", error.message.replace(/^invalid name/, "invalid manager name"));
|
|
27
|
+
}
|
|
28
|
+
if (instanceIdShaped(name))
|
|
29
|
+
throw new CommandFailure("refused", "USAGE_INVALID", `manager name "${name}" has the shape of an instance id, so --on would read it as one; choose a name that is not 26 to 32 lowercase letters and digits`);
|
|
30
|
+
return name;
|
|
31
|
+
}
|
|
32
|
+
/** The name recorded for this root's manager, or undefined when none was given. */
|
|
33
|
+
export function readManagerName(context) {
|
|
34
|
+
const path = canonicalLocalProcessPath(MANAGER_NAME_RECORD, context);
|
|
35
|
+
const bytes = readLocalRecordSource(path, 4096, true);
|
|
36
|
+
if (bytes === undefined)
|
|
37
|
+
return undefined;
|
|
38
|
+
let value;
|
|
39
|
+
try {
|
|
40
|
+
value = JSON.parse(bytes.toString("utf8"));
|
|
41
|
+
}
|
|
42
|
+
catch {
|
|
43
|
+
throw new CommandFailure("refused", "SCHEMA_INVALID", "the manager name record is not valid JSON", { target: { path } });
|
|
44
|
+
}
|
|
45
|
+
const record = localRecordObject(value, ["version", "name"]);
|
|
46
|
+
if (record.version !== 1)
|
|
47
|
+
throw new CommandFailure("refused", "SCHEMA_INVALID", "the manager name record has an unsupported version", { target: { path } });
|
|
48
|
+
return assertManagerName(localRecordText(record.name, 128));
|
|
49
|
+
}
|
|
50
|
+
/** Record `name` as this root's manager name for the space. */
|
|
51
|
+
export function recordManagerName(context, name) {
|
|
52
|
+
writeSecretFileAtomic(canonicalLocalProcessPath(MANAGER_NAME_RECORD, context), JSON.stringify({ version: 1, name: assertManagerName(name) }));
|
|
53
|
+
}
|
|
54
|
+
//# sourceMappingURL=manager-name.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"manager-name.js","sourceRoot":"","sources":["../src/manager-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EAAE,yBAAyB,EAA4B,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEnG,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE9C;+FAC+F;AAC/F,MAAM,CAAC,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AAE/D,2FAA2F;AAC3F,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,IAAI,CAAC;QAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC3E,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC;QAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAAC,CAAC;IAC9B,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,eAAe,EAAG,KAAe,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,sBAAsB,CAAC,CAAC,CAAC;IAAC,CAAC;IAClJ,IAAI,gBAAgB,CAAC,IAAI,CAAC;QACxB,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,eAAe,EAAE,iBAAiB,IAAI,kIAAkI,CAAC,CAAC;IAChN,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,MAAM,IAAI,GAAG,yBAAyB,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAAC,CAAC;IACnD,MAAM,CAAC;QAAC,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,gBAAgB,EAAE,2CAA2C,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAAC,CAAC;IACnI,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,gBAAgB,EAAE,oDAAoD,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC5J,OAAO,iBAAiB,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,iBAAiB,CAAC,OAA4B,EAAE,IAAY;IAC1E,qBAAqB,CAAC,yBAAyB,CAAC,mBAAmB,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAChJ,CAAC"}
|
package/dist/mesh-registry.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
export { homeCotalDir, userCotalDir } from "./cotal-home.js";
|
|
1
2
|
/**
|
|
2
3
|
* The registry of meshes this machine can reach, so a `cotal spawn` from *any* directory can find
|
|
3
4
|
* which mesh to join, with which creds and personas. One record per broker `cotal up` started here,
|
|
@@ -117,6 +118,10 @@ export interface MeshEntry {
|
|
|
117
118
|
* rather than reading agreement out of an address. Absent means no such acceptance was given,
|
|
118
119
|
* which is every record written before the flag existed. */
|
|
119
120
|
unencryptedOverlay?: boolean;
|
|
121
|
+
/** Present and true when `space add --force` wrote the record without checking the broker, so its
|
|
122
|
+
* `mode` is what the operator gave, not what the broker was seen to enforce. Absent means it was
|
|
123
|
+
* checked, or the record predates this field. */
|
|
124
|
+
unchecked?: boolean;
|
|
120
125
|
/** ISO timestamp of when the record was written. */
|
|
121
126
|
ts: string;
|
|
122
127
|
}
|
|
@@ -162,24 +167,9 @@ export interface UserAuthInfo {
|
|
|
162
167
|
* workstation layer owns this shape (core stays IdP-agnostic), so the boundary where an
|
|
163
168
|
* arbitrary provider's metadata enters the registry is checked here, fail-loud. */
|
|
164
169
|
export declare function assertUserAuthInfo(v: unknown): UserAuthInfo;
|
|
165
|
-
/**
|
|
166
|
-
*
|
|
167
|
-
|
|
168
|
-
* pointer, the onboard marker, prepared spaces (`prepared/`) and service records (`services/`)
|
|
169
|
-
* resolve under this directory. POSIX default `~/.cotal`; Windows `%LOCALAPPDATA%\Cotal`.
|
|
170
|
-
*
|
|
171
|
-
* WHAT IT DOES NOT ENFORCE: project-root state. `cotal up`, broker launch policy
|
|
172
|
-
* (`.cotal/broker-policy.json`), the NATS store, manager/delivery pidfiles, and auth material all
|
|
173
|
-
* resolve via {@link findCotalRoot} (walk up from cwd for a `.cotal/`). Setting only `COTAL_HOME`
|
|
174
|
-
* does not redirect those paths. A test or probe that sets `COTAL_HOME` and runs a real
|
|
175
|
-
* `cotal up` from a tree whose walked root is the operator home can still write live operator
|
|
176
|
-
* config. Sandbox the project root too (temp dir with its own `.cotal/`, and run the CLI with
|
|
177
|
-
* `cwd` there) — or you have sandboxed the registry label, not the launch surface. */
|
|
178
|
-
export declare function homeCotalDir(): string;
|
|
179
|
-
/** The OS user's own Cotal directory, which `COTAL_HOME` never redirects: POSIX `~/.cotal`, Windows
|
|
180
|
-
* `%LOCALAPPDATA%\Cotal`. Telemetry keeps its settings here, so every workspace one person runs
|
|
181
|
-
* under their own account shares one install id. */
|
|
182
|
-
export declare function userCotalDir(): string;
|
|
170
|
+
/** Why `COTAL_HOME` can hold no record, or undefined when it is unset, a directory, or not created
|
|
171
|
+
* yet. A file, or a path under one, can never be read or written as the machine-home dir. */
|
|
172
|
+
export declare function cotalHomeProblem(): string | undefined;
|
|
183
173
|
/** The variables {@link homeCotalDir} falls back to on `platform` when `COTAL_HOME` is unset:
|
|
184
174
|
* `homedir()` reads `HOME` on POSIX, and Windows reads `LOCALAPPDATA`, then `USERPROFILE`. */
|
|
185
175
|
export declare function homeCotalDirFallbacks(platform?: NodeJS.Platform): readonly string[];
|
|
@@ -200,28 +190,29 @@ export declare function removeMesh(space: string): void;
|
|
|
200
190
|
* can act on each removal before the next one. An empty batch touches nothing. */
|
|
201
191
|
export declare function removeMeshes(spaces: Iterable<string>): void;
|
|
202
192
|
/**
|
|
203
|
-
* Drop a
|
|
204
|
-
*
|
|
205
|
-
*
|
|
206
|
-
*
|
|
207
|
-
* rule and forgetting it at a single site is the whole failure. A `manual` record (`cotal meshes
|
|
208
|
-
* add`) is NEVER auto-pruned. An `up` record (and a pre-origin record, which is `up`) is kept on a
|
|
209
|
-
* liveness miss: the broker being down is a STATE the surfaces report (`offline`), not proof the
|
|
210
|
-
* operator no longer wants the root. A mismatch — credentials rejected, an open record whose
|
|
211
|
-
* broker now requires auth, or a root whose on-disk auth is now for a different space — still
|
|
212
|
-
* drops an `up` record, because connecting through it would mint against the wrong mesh. A sleeping
|
|
213
|
-
* laptop or a VPN blip must not unregister a perfectly healthy remote mesh (observed exactly once,
|
|
214
|
-
* and once was enough), and the same erasure of a stopped local stack is the existence denial this
|
|
215
|
-
* helper exists to prevent. `cotal meshes rm` / `cotal down` are how a kept record leaves.
|
|
193
|
+
* Drop a mismatched `up` record (including a pre-origin record). Returns whether it was removed.
|
|
194
|
+
* Call only after a credentials, mode, or on-disk space mismatch. A liveness miss is reported as
|
|
195
|
+
* `offline` without calling this helper. Manual and catalog records are never auto-pruned.
|
|
196
|
+
* Explicit removal belongs to {@link removeMesh} (`cotal meshes rm` / `cotal down`).
|
|
216
197
|
*/
|
|
217
|
-
export
|
|
218
|
-
export declare function pruneMesh(space: string, reason?: PruneReason): boolean;
|
|
198
|
+
export declare function pruneMesh(space: string): boolean;
|
|
219
199
|
/** Canonicalize a project root for comparison. A recorded root is whatever spelling `cotal up` was
|
|
220
200
|
* run under, so the same directory reaches us by several names: a symlinked root (macOS `/var` →
|
|
221
201
|
* `/private/var`) or, on Windows, an 8.3 short name (`C:\Users\RUNNER~1\…`) — `process.cwd()` keeps
|
|
222
202
|
* the short form there rather than expanding it. realpath collapses both. Falls back to `resolve`
|
|
223
203
|
* for a root that no longer exists on disk. */
|
|
224
204
|
export declare function canonicalRoot(p: string): string;
|
|
205
|
+
/** When this folder holds the records of `space`, started in `recordedRoot`, and was moved away from
|
|
206
|
+
* there: the sentence that says so and the way back. Only a folder whose stack journal names that
|
|
207
|
+
* root was moved from it. */
|
|
208
|
+
export declare function movedProject(space: string, recordedRoot: string): {
|
|
209
|
+
message: string;
|
|
210
|
+
remedy: string;
|
|
211
|
+
target: {
|
|
212
|
+
root: string;
|
|
213
|
+
recordedRoot: string;
|
|
214
|
+
};
|
|
215
|
+
} | undefined;
|
|
225
216
|
/** Every registry entry recorded for THIS project root, matched {@link canonicalRoot}-wise so a
|
|
226
217
|
* differently-spelled root still matches. The root is the only sound key for a local operation on
|
|
227
218
|
* an OPEN mesh, which has no auth material to resolve its space NAME from — that would fall back
|
|
@@ -234,7 +225,9 @@ export declare function meshesForRoot(root: string): MeshEntry[];
|
|
|
234
225
|
* or wiped (`cotal down` / `cotal clean all`), releasing the `current` pointer if it names one.
|
|
235
226
|
* `keep` names a space the caller records again as prepared, as a controller stack's `down` does:
|
|
236
227
|
* a selection naming it stays, so the next bare command refuses that stopped space rather than
|
|
237
|
-
* falling through to another one.
|
|
228
|
+
* falling through to another one. `retain` names a space whose registration stays, with a selection
|
|
229
|
+
* naming it, as a legacy `down` keeps one that {@link keepsRegistration}. Returns the removed space
|
|
230
|
+
* names.
|
|
238
231
|
*
|
|
239
232
|
* OPERATOR-REGISTERED entries are skipped. The root is shared, not owned: `cotal meshes add`
|
|
240
233
|
* defaults `--root` to the project you run it in, so registering a mesh that runs elsewhere from
|
|
@@ -243,7 +236,11 @@ export declare function meshesForRoot(root: string): MeshEntry[];
|
|
|
243
236
|
* rewrite what `up` wrote; nothing rewrites a hand-registered record). `cotal meshes rm` is how one
|
|
244
237
|
* of those leaves.
|
|
245
238
|
*/
|
|
246
|
-
export declare function removeMeshesByRoot(root: string, keep?: string): string[];
|
|
239
|
+
export declare function removeMeshesByRoot(root: string, keep?: string, retain?: string): string[];
|
|
240
|
+
/** Whether a stack's `down` keeps this registration: a space named after its own folder stays
|
|
241
|
+
* registered while stopped, so the name stays that folder's and another folder's bare `up` cannot
|
|
242
|
+
* take it. `space forget` frees it. */
|
|
243
|
+
export declare function keepsRegistration(entry: Pick<MeshEntry, "space" | "root">): boolean;
|
|
247
244
|
/** The entries this root actually RUNS — what a local teardown or wipe may act on. The complement
|
|
248
245
|
* of the skip in {@link removeMeshesByRoot}, exported so a caller that guards on "is this root's
|
|
249
246
|
* mesh still live" asks about its OWN mesh: a hand-registered record co-rooted here points at a
|
|
@@ -258,8 +255,15 @@ export declare class MeshRegistryError extends Error {
|
|
|
258
255
|
/** Brand for cross-package-safe detection, as {@link isMeshRegistryError} reads it. */
|
|
259
256
|
readonly brand = "cotal:workspace:mesh-registry-error";
|
|
260
257
|
readonly file: string;
|
|
258
|
+
/** A one-line account for a refusal, repeating no stored value, when calling the file an unreadable
|
|
259
|
+
* registry record would not fit. */
|
|
260
|
+
readonly summary?: string;
|
|
261
|
+
/** The step that clears it, when it is not the restore or remove a damaged record takes. */
|
|
262
|
+
readonly remedy?: string;
|
|
261
263
|
constructor(file: string, message: string, options?: {
|
|
262
264
|
cause?: unknown;
|
|
265
|
+
summary?: string;
|
|
266
|
+
remedy?: string;
|
|
263
267
|
});
|
|
264
268
|
}
|
|
265
269
|
/** Detect a {@link MeshRegistryError} without `instanceof`, which two installed copies of this
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mesh-registry.d.ts","sourceRoot":"","sources":["../src/mesh-registry.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"mesh-registry.d.ts","sourceRoot":"","sources":["../src/mesh-registry.ts"],"names":[],"mappings":"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"}
|
package/dist/mesh-registry.js
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
|
-
import { existsSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync } from "node:fs";
|
|
2
|
-
import {
|
|
3
|
-
import { isAbsolute, join, resolve } from "node:path";
|
|
1
|
+
import { existsSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync } from "node:fs";
|
|
2
|
+
import { basename, isAbsolute, join, resolve } from "node:path";
|
|
4
3
|
import { mkSecretDir, writeSecretFile } from "@cotal-ai/core";
|
|
5
|
-
import { spaceSegment } from "./auth-paths.js";
|
|
4
|
+
import { findCotalRoot, movedRootRemedy, spaceSegment, stackJournalRoot } from "./auth-paths.js";
|
|
5
|
+
import { homeCotalDir } from "./cotal-home.js";
|
|
6
|
+
import { prepareCotalHomeForWrite } from "./protected-records.js";
|
|
7
|
+
export { homeCotalDir, userCotalDir } from "./cotal-home.js";
|
|
6
8
|
/** Runtime-validate a provider's opaque `publicAuth` blob into a {@link UserAuthInfo} — the
|
|
7
9
|
* workstation layer owns this shape (core stays IdP-agnostic), so the boundary where an
|
|
8
10
|
* arbitrary provider's metadata enters the registry is checked here, fail-loud. */
|
|
@@ -36,31 +38,21 @@ export function assertUserAuthInfo(v) {
|
|
|
36
38
|
...(o.remote === true ? { remote: true } : {}),
|
|
37
39
|
...(o.sentinelCredsPath ? { sentinelCredsPath: o.sentinelCredsPath } : {}) };
|
|
38
40
|
}
|
|
39
|
-
/**
|
|
40
|
-
*
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
return process.env.COTAL_HOME;
|
|
55
|
-
return userCotalDir();
|
|
56
|
-
}
|
|
57
|
-
/** The OS user's own Cotal directory, which `COTAL_HOME` never redirects: POSIX `~/.cotal`, Windows
|
|
58
|
-
* `%LOCALAPPDATA%\Cotal`. Telemetry keeps its settings here, so every workspace one person runs
|
|
59
|
-
* under their own account shares one install id. */
|
|
60
|
-
export function userCotalDir() {
|
|
61
|
-
if (process.platform === "win32" && process.env.LOCALAPPDATA)
|
|
62
|
-
return join(process.env.LOCALAPPDATA, "Cotal");
|
|
63
|
-
return join(homedir(), ".cotal");
|
|
41
|
+
/** Why `COTAL_HOME` can hold no record, or undefined when it is unset, a directory, or not created
|
|
42
|
+
* yet. A file, or a path under one, can never be read or written as the machine-home dir. */
|
|
43
|
+
export function cotalHomeProblem() {
|
|
44
|
+
const home = process.env.COTAL_HOME;
|
|
45
|
+
if (!home)
|
|
46
|
+
return undefined;
|
|
47
|
+
try {
|
|
48
|
+
if (statSync(home).isDirectory())
|
|
49
|
+
return undefined;
|
|
50
|
+
}
|
|
51
|
+
catch (e) {
|
|
52
|
+
if (e.code !== "ENOTDIR")
|
|
53
|
+
return undefined;
|
|
54
|
+
}
|
|
55
|
+
return `COTAL_HOME ${home} is not a directory, so it can hold no Cotal records`;
|
|
64
56
|
}
|
|
65
57
|
/** The variables {@link homeCotalDir} falls back to on `platform` when `COTAL_HOME` is unset:
|
|
66
58
|
* `homedir()` reads `HOME` on POSIX, and Windows reads `LOCALAPPDATA`, then `USERPROFILE`. */
|
|
@@ -144,6 +136,7 @@ export function recordMeshes(entries) {
|
|
|
144
136
|
// The filenames in here ARE the space names, so a world-traversable dir would leak them to other
|
|
145
137
|
// local users even though the file contents are private. Keep the dir readable only by us
|
|
146
138
|
// (0700 POSIX / hardened ACL win32).
|
|
139
|
+
prepareCotalHomeForWrite();
|
|
147
140
|
mkSecretDir(meshesDir());
|
|
148
141
|
const file = meshFile(m.space);
|
|
149
142
|
// Per-process temp name so two concurrent `up`s for the same space can't stomp each other's
|
|
@@ -170,12 +163,16 @@ export function removeMeshes(spaces) {
|
|
|
170
163
|
removeLegacyMeshFiles([space], (legacy ??= legacyMeshFiles())); // else a pre-hex record would resurrect the mesh in every listing
|
|
171
164
|
}
|
|
172
165
|
}
|
|
173
|
-
|
|
166
|
+
/**
|
|
167
|
+
* Drop a mismatched `up` record (including a pre-origin record). Returns whether it was removed.
|
|
168
|
+
* Call only after a credentials, mode, or on-disk space mismatch. A liveness miss is reported as
|
|
169
|
+
* `offline` without calling this helper. Manual and catalog records are never auto-pruned.
|
|
170
|
+
* Explicit removal belongs to {@link removeMesh} (`cotal meshes rm` / `cotal down`).
|
|
171
|
+
*/
|
|
172
|
+
export function pruneMesh(space) {
|
|
174
173
|
const m = findMesh(space);
|
|
175
174
|
if (!m || m.origin === "manual" || m.origin === "catalog")
|
|
176
175
|
return false;
|
|
177
|
-
if (reason === "gone")
|
|
178
|
-
return false;
|
|
179
176
|
removeMesh(space);
|
|
180
177
|
return true;
|
|
181
178
|
}
|
|
@@ -192,6 +189,15 @@ export function canonicalRoot(p) {
|
|
|
192
189
|
return resolve(p);
|
|
193
190
|
}
|
|
194
191
|
}
|
|
192
|
+
/** When this folder holds the records of `space`, started in `recordedRoot`, and was moved away from
|
|
193
|
+
* there: the sentence that says so and the way back. Only a folder whose stack journal names that
|
|
194
|
+
* root was moved from it. */
|
|
195
|
+
export function movedProject(space, recordedRoot) {
|
|
196
|
+
const here = findCotalRoot();
|
|
197
|
+
if (canonicalRoot(here) === canonicalRoot(recordedRoot) || stackJournalRoot(here) !== recordedRoot)
|
|
198
|
+
return undefined;
|
|
199
|
+
return { message: `mesh "${space}" was started in ${recordedRoot}, and this folder ${here} holds its records, so this folder was moved from there`, remedy: movedRootRemedy(recordedRoot), target: { root: here, recordedRoot } };
|
|
200
|
+
}
|
|
195
201
|
/** Every registry entry recorded for THIS project root, matched {@link canonicalRoot}-wise so a
|
|
196
202
|
* differently-spelled root still matches. The root is the only sound key for a local operation on
|
|
197
203
|
* an OPEN mesh, which has no auth material to resolve its space NAME from — that would fall back
|
|
@@ -221,7 +227,9 @@ function removeMeshesReleasingCurrent(spaces, keep) {
|
|
|
221
227
|
* or wiped (`cotal down` / `cotal clean all`), releasing the `current` pointer if it names one.
|
|
222
228
|
* `keep` names a space the caller records again as prepared, as a controller stack's `down` does:
|
|
223
229
|
* a selection naming it stays, so the next bare command refuses that stopped space rather than
|
|
224
|
-
* falling through to another one.
|
|
230
|
+
* falling through to another one. `retain` names a space whose registration stays, with a selection
|
|
231
|
+
* naming it, as a legacy `down` keeps one that {@link keepsRegistration}. Returns the removed space
|
|
232
|
+
* names.
|
|
225
233
|
*
|
|
226
234
|
* OPERATOR-REGISTERED entries are skipped. The root is shared, not owned: `cotal meshes add`
|
|
227
235
|
* defaults `--root` to the project you run it in, so registering a mesh that runs elsewhere from
|
|
@@ -230,11 +238,17 @@ function removeMeshesReleasingCurrent(spaces, keep) {
|
|
|
230
238
|
* rewrite what `up` wrote; nothing rewrites a hand-registered record). `cotal meshes rm` is how one
|
|
231
239
|
* of those leaves.
|
|
232
240
|
*/
|
|
233
|
-
export function removeMeshesByRoot(root, keep) {
|
|
234
|
-
const removed = localMeshesForRoot(root).map((m) => m.space);
|
|
241
|
+
export function removeMeshesByRoot(root, keep, retain) {
|
|
242
|
+
const removed = localMeshesForRoot(root).map((m) => m.space).filter((space) => space !== retain);
|
|
235
243
|
removeMeshesReleasingCurrent(removed, keep);
|
|
236
244
|
return removed;
|
|
237
245
|
}
|
|
246
|
+
/** Whether a stack's `down` keeps this registration: a space named after its own folder stays
|
|
247
|
+
* registered while stopped, so the name stays that folder's and another folder's bare `up` cannot
|
|
248
|
+
* take it. `space forget` frees it. */
|
|
249
|
+
export function keepsRegistration(entry) {
|
|
250
|
+
return entry.space === basename(canonicalRoot(entry.root));
|
|
251
|
+
}
|
|
238
252
|
/** The entries this root actually RUNS — what a local teardown or wipe may act on. The complement
|
|
239
253
|
* of the skip in {@link removeMeshesByRoot}, exported so a caller that guards on "is this root's
|
|
240
254
|
* mesh still live" asks about its OWN mesh: a hand-registered record co-rooted here points at a
|
|
@@ -268,10 +282,17 @@ export class MeshRegistryError extends Error {
|
|
|
268
282
|
/** Brand for cross-package-safe detection, as {@link isMeshRegistryError} reads it. */
|
|
269
283
|
brand = MESH_REGISTRY_ERROR;
|
|
270
284
|
file;
|
|
285
|
+
/** A one-line account for a refusal, repeating no stored value, when calling the file an unreadable
|
|
286
|
+
* registry record would not fit. */
|
|
287
|
+
summary;
|
|
288
|
+
/** The step that clears it, when it is not the restore or remove a damaged record takes. */
|
|
289
|
+
remedy;
|
|
271
290
|
constructor(file, message, options) {
|
|
272
291
|
super(message, options);
|
|
273
292
|
this.name = "MeshRegistryError";
|
|
274
293
|
this.file = file;
|
|
294
|
+
this.summary = options?.summary;
|
|
295
|
+
this.remedy = options?.remedy;
|
|
275
296
|
}
|
|
276
297
|
}
|
|
277
298
|
/** Detect a {@link MeshRegistryError} without `instanceof`, which two installed copies of this
|
|
@@ -409,7 +430,7 @@ export function readCurrent() {
|
|
|
409
430
|
return space;
|
|
410
431
|
}
|
|
411
432
|
export function setCurrent(space) {
|
|
412
|
-
|
|
433
|
+
prepareCotalHomeForWrite();
|
|
413
434
|
writeSecretFile(currentFile(), space);
|
|
414
435
|
}
|
|
415
436
|
export function clearCurrent() {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mesh-registry.js","sourceRoot":"","sources":["../src/mesh-registry.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"mesh-registry.js","sourceRoot":"","sources":["../src/mesh-registry.ts"],"names":[],"mappings":"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"}
|
package/dist/mesh-target.d.ts
CHANGED
|
@@ -35,6 +35,10 @@ export interface MeshTarget {
|
|
|
35
35
|
* the broker is down: an `up` mesh is restarted with `cotal up`, a `manual` one runs somewhere
|
|
36
36
|
* this machine does not control (so the local remedy is `cotal meshes rm`, not `cotal up`). */
|
|
37
37
|
origin?: MeshEntry["origin"];
|
|
38
|
+
/** For a broker address `--server` supplied: the address this machine records for the target's
|
|
39
|
+
* space, when it records one for this root. A probe of another address says nothing about that
|
|
40
|
+
* space's mesh, and surfaces read this to say which address did not answer. */
|
|
41
|
+
recordedServer?: string;
|
|
38
42
|
/** `<root>/.cotal/agents` — the persona catalog for this mesh. */
|
|
39
43
|
personaRoot: string;
|
|
40
44
|
/** For `local-space`: the root's `.cotal/` holds records but names no space, as after `space
|
|
@@ -100,9 +104,32 @@ export interface MeshTargetErrorDetails {
|
|
|
100
104
|
stackSpace?: string;
|
|
101
105
|
/** For `not-started`: the Cotal home in use, when the root's stack runs under another one. */
|
|
102
106
|
home?: string;
|
|
107
|
+
/** For `not-started` on a stack root whose journal another folder recorded, as a copy or a moved
|
|
108
|
+
* folder keeps it: that folder. */
|
|
109
|
+
recordedRoot?: string;
|
|
110
|
+
/** For `not-started` in a folder whose stack journal another folder recorded: the next step that
|
|
111
|
+
* `up` and `down` name there too, from {@link stackElsewhereRemedy}. */
|
|
112
|
+
stackRemedy?: string;
|
|
103
113
|
/** For `not-started` on a prepared space: its root no longer exists, so `up` cannot start it there. */
|
|
104
114
|
rootMissing?: boolean;
|
|
115
|
+
/** For `not-started` on a root with no registration: `server` is the broker its last start
|
|
116
|
+
* configured, which a bare `cotal up` there starts again. */
|
|
117
|
+
lastRun?: boolean;
|
|
118
|
+
/** For `not-started` on a prepared space whose controller stack launched a member and was
|
|
119
|
+
* stopped: its last recorded operation, and the file store cap it recorded, if any. */
|
|
120
|
+
stopped?: {
|
|
121
|
+
operation: string;
|
|
122
|
+
outcome: string;
|
|
123
|
+
storeCap?: number;
|
|
124
|
+
};
|
|
125
|
+
/** For `not-started` on a prepared space: the last whole-stack operation its root's stack journal
|
|
126
|
+
* records for it with no outcome, which `cotal status` there names the way out of. */
|
|
127
|
+
unsettled?: "up" | "down";
|
|
105
128
|
}
|
|
129
|
+
/** The smallest JetStream file store cap a stack starts on: the bytes the space's membership bucket
|
|
130
|
+
* reserves, plus one. nats-server creates a stream with no byte limit only while at least one byte
|
|
131
|
+
* of the cap is unreserved, so a cap equal to the reservation fails every later stream with 10047. */
|
|
132
|
+
export declare const MIN_FILE_STORE: number;
|
|
106
133
|
/**
|
|
107
134
|
* A typed mesh-target resolution failure. `message` is **log/dev-safe and command-agnostic** — never
|
|
108
135
|
* the canonical product copy (that's {@link renderWorkspaceError}'s job; don't let `message` become
|
|
@@ -125,6 +152,33 @@ export declare function targetFromEntry(m: MeshEntry, server: string, source: Me
|
|
|
125
152
|
/** A `.cotal/` that a user actually created here — not the machine-home dir the cwd walk-up lands on
|
|
126
153
|
* from outside any project (which has no space, just the daemon's pid/onboard files). */
|
|
127
154
|
export declare function isGenuineSpace(root: string): boolean;
|
|
155
|
+
/** What the root a space was prepared in records about its stack, as a command that targets it
|
|
156
|
+
* reports it: `unsettled` when the last whole-stack `up` or `down` recorded no outcome, `stopped`
|
|
157
|
+
* once a stack that launched a member recorded one, else `prepared`. `lastOperation` names that
|
|
158
|
+
* operation and how it ended, such as `cotal down, completed`. */
|
|
159
|
+
export type PreparedLifecycle = {
|
|
160
|
+
state: "prepared";
|
|
161
|
+
lastOperation: null;
|
|
162
|
+
} | {
|
|
163
|
+
state: "stopped";
|
|
164
|
+
lastOperation: string;
|
|
165
|
+
stopped: NonNullable<MeshTargetErrorDetails["stopped"]>;
|
|
166
|
+
} | {
|
|
167
|
+
state: "unsettled";
|
|
168
|
+
lastOperation: string;
|
|
169
|
+
unsettled: "up" | "down";
|
|
170
|
+
stopped?: NonNullable<MeshTargetErrorDetails["stopped"]>;
|
|
171
|
+
};
|
|
172
|
+
/** {@link PreparedLifecycle} for `space`, prepared at `root`. */
|
|
173
|
+
export declare function preparedLifecycle(root: string, space: string): PreparedLifecycle;
|
|
174
|
+
/** The last operation and recorded store cap of `space`'s controller stack at `root`, when its
|
|
175
|
+
* journal names a member it launched. Undefined for a stack that never launched one, or a journal
|
|
176
|
+
* this read cannot use; the commands that act on the journal check it fully. */
|
|
177
|
+
export declare function stoppedStack(root: string, space: string): MeshTargetErrorDetails["stopped"];
|
|
178
|
+
/** The last whole-stack `up` or `down` that `root`'s own stack journal records for `space` with no
|
|
179
|
+
* outcome, as one cut off before it recorded one leaves it. Such a stack is not stopped, whatever
|
|
180
|
+
* members it launched. */
|
|
181
|
+
export declare function unsettledStackOperation(root: string, space: string): "up" | "down" | undefined;
|
|
128
182
|
/** Whether `root`'s stack journal names member instances of which this Cotal home holds no record,
|
|
129
183
|
* while a manager or delivery record under the root fronts a live process: the stack runs under
|
|
130
184
|
* another `COTAL_HOME`, whose registration and service records this one cannot see. A journal that
|
|
@@ -133,13 +187,76 @@ export declare function stackRunsUnderOtherHome(root: string, journal: {
|
|
|
133
187
|
space?: unknown;
|
|
134
188
|
members?: unknown;
|
|
135
189
|
}): boolean;
|
|
190
|
+
/** Whether `root`'s `.cotal` is a link to the `.cotal` directory of `holder`, whose stack journal was
|
|
191
|
+
* recorded at `root`: `root`'s own records, moved to `holder` and linked back. Through the link both
|
|
192
|
+
* folders seem to hold the journal, so each would name the other as the place to run from. */
|
|
193
|
+
export declare function recordsMovedTo(root: string, holder: string): boolean;
|
|
194
|
+
/** The way back for records moved from `root` to `holder` and linked back ({@link recordsMovedTo}):
|
|
195
|
+
* the link replaced by the directory it leads to. Nothing here moves them. */
|
|
196
|
+
export declare function moveRecordsBack(root: string, holder: string): string;
|
|
197
|
+
/** Why `space create --adopt` may not take over a stack journal another folder recorded. */
|
|
198
|
+
export interface StackAdoptionBlock {
|
|
199
|
+
kind: "link" | "copy" | "known" | "recorded";
|
|
200
|
+
message: string;
|
|
201
|
+
remedy: string;
|
|
202
|
+
}
|
|
203
|
+
/** Why `space create --adopt` may not take over, at `root`, the stack journal that `recordedRoot`
|
|
204
|
+
* recorded for `space` with these members: this folder's `.cotal` links to another's, the recorded
|
|
205
|
+
* root still holds the journal, this home records one of its member instances, or the space is
|
|
206
|
+
* prepared or registered on this machine. Undefined when it may. */
|
|
207
|
+
export declare function stackAdoptionBlock(root: string, recordedRoot: string, space: string, members: unknown): StackAdoptionBlock | undefined;
|
|
208
|
+
/** The next step in `root`, whose stack journal `recordedRoot` recorded for `space`, which every
|
|
209
|
+
* command run there names. A linked `.cotal`, and a copy whose recorded folder still holds the
|
|
210
|
+
* journal, use the stack from there. A moved folder moves back when this machine records its stack
|
|
211
|
+
* or its space, and is adopted with `space create --adopt` when it records neither, because moving
|
|
212
|
+
* it back would then not start it. A recorded path that `cotal up` refuses is never the way back. */
|
|
213
|
+
export declare function stackElsewhereRemedy(root: string, recordedRoot: string, space: string, members: unknown): string;
|
|
214
|
+
/** Whether the root holds a broker account, readable or not. */
|
|
215
|
+
export declare function rootHoldsAccount(root: string): boolean;
|
|
216
|
+
/** The broker this root's last start rendered: `.cotal/auth/server.conf` in static auth when the root
|
|
217
|
+
* holds an account, else `.cotal/server-open.conf` in open mode. Undefined when neither names one.
|
|
218
|
+
* A legacy `down` drops the registration that kept the root's broker address, or keeps one that
|
|
219
|
+
* only holds the name of a space named after its folder, and this file outlives it. */
|
|
220
|
+
export declare function retainedLegacyBroker(root: string): {
|
|
221
|
+
server: string;
|
|
222
|
+
open: boolean;
|
|
223
|
+
} | undefined;
|
|
224
|
+
/** Say under the run's `Mesh:` heading that `space` is this folder's and the selection `current`
|
|
225
|
+
* applies outside the folder. */
|
|
226
|
+
export declare function noteFolderSpace(space: string, current: string): void;
|
|
227
|
+
/** The one space registered or prepared at the root of the project folder `cwd` is in, which a
|
|
228
|
+
* command without `--space` targets there. Undefined outside a project and where the root has none
|
|
229
|
+
* or several. */
|
|
230
|
+
export declare function folderSpace(cwd: string): string | undefined;
|
|
231
|
+
/** The space a command without `--space` targets in the project folder `cwd` is in when that is not
|
|
232
|
+
* the selection `current`: the root's one registered or prepared space. Undefined with nothing
|
|
233
|
+
* selected, outside a project, and where the selection is the target. */
|
|
234
|
+
export declare function folderSpaceOverSelection(cwd: string, current: string | null): string | undefined;
|
|
235
|
+
/**
|
|
236
|
+
* The space a `--creds` command that names neither `--space` nor `--server` addresses, in
|
|
237
|
+
* {@link resolveMeshTarget}'s order: the selected space, unless this folder's project has one other
|
|
238
|
+
* space, else the space this folder's project is registered, set up or prepared as. `undefined`
|
|
239
|
+
* leaves the caller's default. It reads no trust, because the credential is the caller's own, and it
|
|
240
|
+
* never takes the only running space, because a credential goes only to a broker the caller paired
|
|
241
|
+
* it with.
|
|
242
|
+
*/
|
|
243
|
+
export declare function credsSpace(cwd: string): {
|
|
244
|
+
space: string;
|
|
245
|
+
selected: boolean;
|
|
246
|
+
} | undefined;
|
|
247
|
+
/** Whether {@link resolveMeshTarget} reads liveness (`flags.offline`) for `flags` at `cwd`. A named
|
|
248
|
+
* `--space`, the selection where it is the target, and a registration of this project's root each
|
|
249
|
+
* pick the target without it, so a caller that sweeps the recorded brokers first has nothing to
|
|
250
|
+
* probe then. It follows the same precedence and records nothing. */
|
|
251
|
+
export declare function resolveReadsLiveness(cwd: string, flags?: ResolveFlags): boolean;
|
|
136
252
|
/**
|
|
137
253
|
* Resolve the mesh target by precedence (first match wins):
|
|
138
254
|
* 1. `--space` — registry lookup (errors if that space isn't running).
|
|
139
255
|
* 2. `--server` — registry entry on that server (for creds/personas), else the local project.
|
|
140
|
-
* 3. The `current` selected by `cotal use`,
|
|
141
|
-
*
|
|
142
|
-
*
|
|
256
|
+
* 3. The `current` selected by `cotal use`, except inside a project whose root has one space other
|
|
257
|
+
* than it, where step 4 applies. It stays the target when its broker is down, and a selection
|
|
258
|
+
* that names no registration refuses rather than reaching another mesh. Inside a project whose
|
|
259
|
+
* root has several spaces, none of them the selection, the run warns first.
|
|
143
260
|
* 4. A genuine local project (`cwd` walks up to a real `.cotal/`).
|
|
144
261
|
* 5. The registry's *running* meshes: 0 ⇒ error; 1 ⇒ use it; N ⇒ error naming
|
|
145
262
|
* each + its root. `flags.offline` (from a sweep) is excluded here; a named `--space` and
|