@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.
Files changed (183) hide show
  1. package/build/Release/darwin-arm64/build.json +21 -0
  2. package/build/Release/darwin-arm64/process.node +0 -0
  3. package/build/Release/darwin-x64/build.json +21 -0
  4. package/build/Release/darwin-x64/process.node +0 -0
  5. package/build/Release/win32-arm64/build.json +7 -5
  6. package/build/Release/win32-arm64/creation.node +0 -0
  7. package/build/Release/win32-x64/build.json +7 -5
  8. package/build/Release/win32-x64/creation.node +0 -0
  9. package/dist/agent-grants.d.ts +21 -0
  10. package/dist/agent-grants.d.ts.map +1 -0
  11. package/dist/agent-grants.js +21 -0
  12. package/dist/agent-grants.js.map +1 -0
  13. package/dist/auth-paths.d.ts +34 -0
  14. package/dist/auth-paths.d.ts.map +1 -1
  15. package/dist/auth-paths.js +99 -3
  16. package/dist/auth-paths.js.map +1 -1
  17. package/dist/broker-display.d.ts +12 -0
  18. package/dist/broker-display.d.ts.map +1 -1
  19. package/dist/broker-display.js +14 -0
  20. package/dist/broker-display.js.map +1 -1
  21. package/dist/connect.d.ts +21 -7
  22. package/dist/connect.d.ts.map +1 -1
  23. package/dist/connect.js +152 -22
  24. package/dist/connect.js.map +1 -1
  25. package/dist/control-target.d.ts.map +1 -1
  26. package/dist/control-target.js +12 -10
  27. package/dist/control-target.js.map +1 -1
  28. package/dist/cotal-config.d.ts +7 -0
  29. package/dist/cotal-config.d.ts.map +1 -1
  30. package/dist/cotal-config.js +29 -2
  31. package/dist/cotal-config.js.map +1 -1
  32. package/dist/cotal-home.d.ts +23 -0
  33. package/dist/cotal-home.d.ts.map +1 -0
  34. package/dist/cotal-home.js +36 -0
  35. package/dist/cotal-home.js.map +1 -0
  36. package/dist/credential-actions.d.ts +17 -3
  37. package/dist/credential-actions.d.ts.map +1 -1
  38. package/dist/credential-actions.js +62 -10
  39. package/dist/credential-actions.js.map +1 -1
  40. package/dist/darwin-process.d.ts +20 -0
  41. package/dist/darwin-process.d.ts.map +1 -0
  42. package/dist/darwin-process.js +24 -0
  43. package/dist/darwin-process.js.map +1 -0
  44. package/dist/deprecated-daemon-entries.d.ts +3 -0
  45. package/dist/deprecated-daemon-entries.d.ts.map +1 -1
  46. package/dist/deprecated-daemon-entries.js +6 -1
  47. package/dist/deprecated-daemon-entries.js.map +1 -1
  48. package/dist/extensions.d.ts +4 -2
  49. package/dist/extensions.d.ts.map +1 -1
  50. package/dist/extensions.js +7 -2
  51. package/dist/extensions.js.map +1 -1
  52. package/dist/flags.d.ts +2 -0
  53. package/dist/flags.d.ts.map +1 -1
  54. package/dist/flags.js +1 -1
  55. package/dist/flags.js.map +1 -1
  56. package/dist/index.d.ts +9 -1
  57. package/dist/index.d.ts.map +1 -1
  58. package/dist/index.js +9 -1
  59. package/dist/index.js.map +1 -1
  60. package/dist/join-target.d.ts +3 -1
  61. package/dist/join-target.d.ts.map +1 -1
  62. package/dist/join-target.js +15 -3
  63. package/dist/join-target.js.map +1 -1
  64. package/dist/maintenance.d.ts +61 -2
  65. package/dist/maintenance.d.ts.map +1 -1
  66. package/dist/maintenance.js +153 -14
  67. package/dist/maintenance.js.map +1 -1
  68. package/dist/manager-name.d.ts +15 -0
  69. package/dist/manager-name.d.ts.map +1 -0
  70. package/dist/manager-name.js +54 -0
  71. package/dist/manager-name.js.map +1 -0
  72. package/dist/mesh-registry.d.ts +39 -35
  73. package/dist/mesh-registry.d.ts.map +1 -1
  74. package/dist/mesh-registry.js +57 -36
  75. package/dist/mesh-registry.js.map +1 -1
  76. package/dist/mesh-target.d.ts +120 -3
  77. package/dist/mesh-target.d.ts.map +1 -1
  78. package/dist/mesh-target.js +319 -48
  79. package/dist/mesh-target.js.map +1 -1
  80. package/dist/official-connectors.d.ts +3 -0
  81. package/dist/official-connectors.d.ts.map +1 -1
  82. package/dist/official-connectors.js +5 -0
  83. package/dist/official-connectors.js.map +1 -1
  84. package/dist/output.d.ts +34 -6
  85. package/dist/output.d.ts.map +1 -1
  86. package/dist/output.js +38 -5
  87. package/dist/output.js.map +1 -1
  88. package/dist/pid.d.ts +42 -7
  89. package/dist/pid.d.ts.map +1 -1
  90. package/dist/pid.js +196 -27
  91. package/dist/pid.js.map +1 -1
  92. package/dist/preferences.d.ts +25 -3
  93. package/dist/preferences.d.ts.map +1 -1
  94. package/dist/preferences.js +77 -14
  95. package/dist/preferences.js.map +1 -1
  96. package/dist/preflight.d.ts +17 -5
  97. package/dist/preflight.d.ts.map +1 -1
  98. package/dist/preflight.js +22 -32
  99. package/dist/preflight.js.map +1 -1
  100. package/dist/prepared-spaces.d.ts +20 -2
  101. package/dist/prepared-spaces.d.ts.map +1 -1
  102. package/dist/prepared-spaces.js +90 -15
  103. package/dist/prepared-spaces.js.map +1 -1
  104. package/dist/present.d.ts +2 -12
  105. package/dist/present.d.ts.map +1 -1
  106. package/dist/present.js +24 -40
  107. package/dist/present.js.map +1 -1
  108. package/dist/protected-records.d.ts +22 -3
  109. package/dist/protected-records.d.ts.map +1 -1
  110. package/dist/protected-records.js +198 -27
  111. package/dist/protected-records.js.map +1 -1
  112. package/dist/registration-policy.d.ts +2 -1
  113. package/dist/registration-policy.d.ts.map +1 -1
  114. package/dist/render.d.ts +2 -1
  115. package/dist/render.d.ts.map +1 -1
  116. package/dist/render.js +42 -11
  117. package/dist/render.js.map +1 -1
  118. package/dist/renewal.d.ts +4 -0
  119. package/dist/renewal.d.ts.map +1 -1
  120. package/dist/renewal.js +20 -1
  121. package/dist/renewal.js.map +1 -1
  122. package/dist/service-adapter.d.ts +1 -2
  123. package/dist/service-adapter.d.ts.map +1 -1
  124. package/dist/service-adapter.js +9 -4
  125. package/dist/service-adapter.js.map +1 -1
  126. package/dist/service-custody.js +2 -2
  127. package/dist/service-custody.js.map +1 -1
  128. package/dist/service-definition.d.ts +3 -0
  129. package/dist/service-definition.d.ts.map +1 -1
  130. package/dist/service-definition.js +56 -2
  131. package/dist/service-definition.js.map +1 -1
  132. package/dist/service-definition.schema.json +2 -1
  133. package/dist/service-identity.js +4 -4
  134. package/dist/service-identity.js.map +1 -1
  135. package/dist/service-stop.js +3 -3
  136. package/dist/service-stop.js.map +1 -1
  137. package/dist/service-target.d.ts.map +1 -1
  138. package/dist/service-target.js +9 -2
  139. package/dist/service-target.js.map +1 -1
  140. package/dist/signer-export.d.ts +1 -0
  141. package/dist/signer-export.d.ts.map +1 -1
  142. package/dist/signer-export.js +20 -4
  143. package/dist/signer-export.js.map +1 -1
  144. package/dist/space-streams.d.ts +18 -0
  145. package/dist/space-streams.d.ts.map +1 -0
  146. package/dist/space-streams.js +41 -0
  147. package/dist/space-streams.js.map +1 -0
  148. package/dist/space.d.ts +5 -0
  149. package/dist/space.d.ts.map +1 -1
  150. package/dist/space.js +5 -0
  151. package/dist/space.js.map +1 -1
  152. package/dist/store-entries.d.ts +6 -0
  153. package/dist/store-entries.d.ts.map +1 -0
  154. package/dist/store-entries.js +17 -0
  155. package/dist/store-entries.js.map +1 -0
  156. package/dist/system-rotation.d.ts +3 -1
  157. package/dist/system-rotation.d.ts.map +1 -1
  158. package/dist/system-rotation.js +19 -4
  159. package/dist/system-rotation.js.map +1 -1
  160. package/dist/text-wrap.d.ts +18 -0
  161. package/dist/text-wrap.d.ts.map +1 -0
  162. package/dist/text-wrap.js +60 -0
  163. package/dist/text-wrap.js.map +1 -0
  164. package/dist/win32-custodian.d.ts +2 -0
  165. package/dist/win32-custodian.d.ts.map +1 -0
  166. package/dist/win32-custodian.js +85 -0
  167. package/dist/win32-custodian.js.map +1 -0
  168. package/dist/win32-custody.d.ts +57 -0
  169. package/dist/win32-custody.d.ts.map +1 -0
  170. package/dist/win32-custody.js +220 -0
  171. package/dist/win32-custody.js.map +1 -0
  172. package/dist/win32-process.d.ts +38 -0
  173. package/dist/win32-process.d.ts.map +1 -1
  174. package/dist/win32-process.js +63 -5
  175. package/dist/win32-process.js.map +1 -1
  176. package/native/README.md +6 -4
  177. package/native/darwin-process.c +173 -0
  178. package/native/win32-process.c +317 -14
  179. package/native/win32-system-id.cpp +32 -0
  180. package/package.json +2 -2
  181. package/scripts/assert-shipped-natives.mjs +3 -3
  182. package/scripts/build-native.mjs +46 -26
  183. package/scripts/native-contract.mjs +36 -16
@@ -1 +1 @@
1
- {"version":3,"file":"official-connectors.js","sourceRoot":"","sources":["../src/official-connectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAqC;IACnE,MAAM,EAAE,iCAAiC;IACzC,QAAQ,EAAE,8BAA8B;IACxC,KAAK,EAAE,2BAA2B;IAClC,MAAM,EAAE,4BAA4B;IACpC,KAAK,EAAE,2BAA2B;IAClC,EAAE,EAAE,cAAc;CACnB,CAAC;AAkBF,MAAM,CAAC,MAAM,iBAAiB,GAA8C;IAC1E,GAAI,MAAM,CAAC,WAAW,CACpB,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAC/F;IACrC,GAAG,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,CAAC,eAAe,CAAC,EAAE;CAC1F,CAAC;AAEF,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACrF,CAAC;AAED;;8EAE8E;AAC9E,MAAM,UAAU,sBAAsB,CAAC,GAAW,EAAE,QAAkE;IACpH,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC;IACjG,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACvF,OAAO,gCAAgC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,mCAAmC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,0CAA0C,CAAC;AAC5J,CAAC;AAED,sGAAsG;AACtG,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAE1C;kFACkF;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAsB,CAAC,OAAO,CAAC,CAAC;AAErE;mGACmG;AACnG,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,GAAG,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,GAAG;QACR,CAAC,CAAC,iBAAiB,IAAI,6CAA6C,GAAG,IAAI;QAC3E,CAAC,CAAC,iBAAiB,IAAI,qFAAqF,CAAC;AACjH,CAAC"}
1
+ {"version":3,"file":"official-connectors.js","sourceRoot":"","sources":["../src/official-connectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAqC;IACnE,MAAM,EAAE,iCAAiC;IACzC,QAAQ,EAAE,8BAA8B;IACxC,KAAK,EAAE,2BAA2B;IAClC,MAAM,EAAE,4BAA4B;IACpC,KAAK,EAAE,2BAA2B;IAClC,EAAE,EAAE,cAAc;CACnB,CAAC;AAkBF,MAAM,CAAC,MAAM,iBAAiB,GAA8C;IAC1E,GAAI,MAAM,CAAC,WAAW,CACpB,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAC/F;IACrC,GAAG,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,CAAC,eAAe,CAAC,EAAE;CAC1F,CAAC;AAEF,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AACrF,CAAC;AAED;;8EAE8E;AAC9E,MAAM,UAAU,sBAAsB,CAAC,GAAW,EAAE,QAAkE;IACpH,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC;IACjG,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACvF,OAAO,gCAAgC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,mCAAmC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,0CAA0C,CAAC;AAC5J,CAAC;AAED,sGAAsG;AACtG,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAE1C;kFACkF;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAsB,CAAC,OAAO,CAAC,CAAC;AAErE;mGACmG;AACnG,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,GAAG,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,GAAG;QACR,CAAC,CAAC,iBAAiB,IAAI,6CAA6C,GAAG,IAAI;QAC3E,CAAC,CAAC,iBAAiB,IAAI,qFAAqF,CAAC;AACjH,CAAC;AAED;yFACyF;AACzF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,uFAAuF,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACjH,CAAC"}
package/dist/output.d.ts CHANGED
@@ -10,6 +10,9 @@ import type { FlagSpec, OutputMode } from "@cotal-ai/core";
10
10
  export type Outcome = "ok" | "no-op" | "refused" | "failed" | "partial" | "unknown";
11
11
  /** How much of the read scope the result covers. It says nothing about whether the work succeeded. */
12
12
  export type Completeness = "complete" | "partial" | "not-checked";
13
+ /** The most characters of an argument a message repeats through `boundedValue`: as many as the longest
14
+ * name a command accepts, so a value of valid length is shown whole. */
15
+ export declare const SHOWN_VALUE_MAX = 128;
13
16
  /** Refusals of the declared input, before any effect: exit 1. */
14
17
  export declare const USAGE_CODES: readonly ["USAGE_INVALID", "SCHEMA_INVALID"];
15
18
  /** Refusals at a known boundary before any effect: exit 2. Denial, absence and outage stay distinct. */
@@ -64,32 +67,57 @@ export declare class CommandFailure extends Error {
64
67
  readonly native?: NativeCause;
65
68
  readonly target: unknown;
66
69
  readonly changed?: readonly unknown[];
70
+ /** The message and remedy are the whole fix, as for a missing `--yes`, so a usage refusal prints
71
+ * them without the command's help. */
72
+ readonly selfContained?: true;
67
73
  constructor(outcome: Exclude<Outcome, "ok" | "no-op">, code: ErrorCode, message: string, opts?: {
68
74
  remedy?: string;
69
75
  native?: NativeCause;
70
76
  target?: unknown;
71
77
  changed?: readonly unknown[];
72
78
  cause?: unknown;
79
+ selfContained?: true;
73
80
  });
74
81
  /** The error detail an envelope carries. */
75
82
  detail(): ErrorDetail;
76
83
  }
84
+ /** A usage refusal for a missing `--yes` outside an interactive terminal. Its remedy names the
85
+ * confirmed or previewed command, so it prints without the command's help. */
86
+ export declare class ConfirmationRequired extends CommandFailure {
87
+ constructor(message: string, opts: {
88
+ remedy: string;
89
+ target?: unknown;
90
+ });
91
+ }
77
92
  export declare function isCommandFailure(e: unknown): e is CommandFailure;
78
- /** The space one command run resolved, as {@link recordOperationSpace} set it, and the warnings
79
- * {@link recordOperationWarning} recorded. */
93
+ /** The space one command run resolved, as {@link recordOperationSpace} set it, the note
94
+ * {@link recordOperationSpaceNote} recorded on how it was chosen, and the warnings
95
+ * {@link recordOperationWarning} recorded. `quiet` keeps those warnings off stderr. */
80
96
  export interface OperationScope {
81
97
  space?: string;
98
+ spaceNote?: {
99
+ space: string;
100
+ text: string;
101
+ };
82
102
  warnings?: OutputWarning[];
103
+ quiet?: boolean;
83
104
  }
84
- /** Run one command inside `scope`, so the space it records there is readable after it throws. */
85
- export declare function runOperation<T>(scope: OperationScope, body: () => Promise<T>): Promise<T>;
105
+ /** Run `body` inside `scope`: one command, so the space it records there is readable after it
106
+ * throws, or the rendering of that command's failure, which then reads what the run recorded. */
107
+ export declare function runOperation<T>(scope: OperationScope, body: () => T): T;
86
108
  /** Record the one space this command's operation resolved, as soon as it is resolved. A command
87
109
  * that works across spaces, or on none, never calls this. Outside {@link runOperation} it does
88
110
  * nothing. */
89
111
  export declare function recordOperationSpace(space: string): void;
112
+ /** Record how this command's operation chose `space`, for its `Mesh:` heading to show under the
113
+ * name. Outside {@link runOperation} it does nothing. */
114
+ export declare function recordOperationSpaceNote(space: string, text: string): void;
115
+ /** The note this run recorded for `space`, if any. */
116
+ export declare function operationSpaceNote(space: string): string | undefined;
90
117
  /** Record a warning about what this command's operation resolved. It is printed on stderr at once,
91
- * before the command acts on it, and every envelope of the run carries it. A warning already
92
- * recorded in this run is not repeated. Outside {@link runOperation} it does nothing. */
118
+ * before the command acts on it, unless the scope is quiet, and every envelope of the run carries it.
119
+ * A warning already recorded in this run is not repeated. Outside {@link runOperation} it does
120
+ * nothing. */
93
121
  export declare function recordOperationWarning(warning: OutputWarning): void;
94
122
  /** The warnings this command run recorded so far, none outside {@link runOperation}. */
95
123
  export declare function operationWarnings(): readonly OutputWarning[];
@@ -1 +1 @@
1
- {"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"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"}
package/dist/output.js CHANGED
@@ -1,4 +1,8 @@
1
1
  import { AsyncLocalStorage } from "node:async_hooks";
2
+ import { terminalWidth, wrapWords } from "./text-wrap.js";
3
+ /** The most characters of an argument a message repeats through `boundedValue`: as many as the longest
4
+ * name a command accepts, so a value of valid length is shown whole. */
5
+ export const SHOWN_VALUE_MAX = 128;
2
6
  /** Refusals of the declared input, before any effect: exit 1. */
3
7
  export const USAGE_CODES = ["USAGE_INVALID", "SCHEMA_INVALID"];
4
8
  /** Refusals at a known boundary before any effect: exit 2. Denial, absence and outage stay distinct. */
@@ -58,6 +62,9 @@ export class CommandFailure extends Error {
58
62
  native;
59
63
  target;
60
64
  changed;
65
+ /** The message and remedy are the whole fix, as for a missing `--yes`, so a usage refusal prints
66
+ * them without the command's help. */
67
+ selfContained;
61
68
  constructor(outcome, code, message, opts = {}) {
62
69
  super(message, opts.cause === undefined ? undefined : { cause: opts.cause });
63
70
  const problem = outcomeCodeProblem(outcome, code);
@@ -70,6 +77,7 @@ export class CommandFailure extends Error {
70
77
  this.native = opts.native;
71
78
  this.target = opts.target ?? null;
72
79
  this.changed = opts.changed;
80
+ this.selfContained = opts.selfContained;
73
81
  }
74
82
  /** The error detail an envelope carries. */
75
83
  detail() {
@@ -81,12 +89,20 @@ export class CommandFailure extends Error {
81
89
  };
82
90
  }
83
91
  }
92
+ /** A usage refusal for a missing `--yes` outside an interactive terminal. Its remedy names the
93
+ * confirmed or previewed command, so it prints without the command's help. */
94
+ export class ConfirmationRequired extends CommandFailure {
95
+ constructor(message, opts) {
96
+ super("refused", "USAGE_INVALID", message, { ...opts, selfContained: true });
97
+ }
98
+ }
84
99
  export function isCommandFailure(e) {
85
100
  return typeof e === "object" && e !== null && e[FAILURE_BRAND] === true;
86
101
  }
87
102
  // Kept on a global key so two copies of this module share one scope, as the failure brand does.
88
103
  const operationScope = (globalThis[Symbol.for("cotal.operationScope")] ??= new AsyncLocalStorage());
89
- /** Run one command inside `scope`, so the space it records there is readable after it throws. */
104
+ /** Run `body` inside `scope`: one command, so the space it records there is readable after it
105
+ * throws, or the rendering of that command's failure, which then reads what the run recorded. */
90
106
  export function runOperation(scope, body) {
91
107
  return operationScope.run(scope, body);
92
108
  }
@@ -98,15 +114,32 @@ export function recordOperationSpace(space) {
98
114
  if (scope)
99
115
  scope.space = space;
100
116
  }
117
+ /** Record how this command's operation chose `space`, for its `Mesh:` heading to show under the
118
+ * name. Outside {@link runOperation} it does nothing. */
119
+ export function recordOperationSpaceNote(space, text) {
120
+ const scope = operationScope.getStore();
121
+ if (scope)
122
+ scope.spaceNote = { space, text };
123
+ }
124
+ /** The note this run recorded for `space`, if any. */
125
+ export function operationSpaceNote(space) {
126
+ const note = operationScope.getStore()?.spaceNote;
127
+ return note?.space === space ? note.text : undefined;
128
+ }
101
129
  /** Record a warning about what this command's operation resolved. It is printed on stderr at once,
102
- * before the command acts on it, and every envelope of the run carries it. A warning already
103
- * recorded in this run is not repeated. Outside {@link runOperation} it does nothing. */
130
+ * before the command acts on it, unless the scope is quiet, and every envelope of the run carries it.
131
+ * A warning already recorded in this run is not repeated. Outside {@link runOperation} it does
132
+ * nothing. */
104
133
  export function recordOperationWarning(warning) {
105
134
  const scope = operationScope.getStore();
106
135
  if (!scope || scope.warnings?.some((w) => w.code === warning.code && w.message === warning.message))
107
136
  return;
108
137
  (scope.warnings ??= []).push(warning);
109
- process.stderr.write(`! ${warning.message}\n`);
138
+ if (scope.quiet)
139
+ return;
140
+ // Wrapped to the terminal like the report it precedes, each continuation line under the text.
141
+ const lines = wrapWords(warning.message, terminalWidth(process.stderr) - 2);
142
+ process.stderr.write(`${lines.map((line, i) => `${i === 0 ? "!" : " "} ${line}`).join("\n")}\n`);
110
143
  }
111
144
  /** The warnings this command run recorded so far, none outside {@link runOperation}. */
112
145
  export function operationWarnings() {
@@ -120,7 +153,7 @@ export function inOperationSpace(failure, space) {
120
153
  if (space === undefined || target !== null && (typeof target !== "object" || Array.isArray(target) || Object.hasOwn(target, "space")))
121
154
  return failure;
122
155
  const fields = target === null ? {} : target;
123
- const placed = new CommandFailure(failure.outcome, failure.code, failure.message, { remedy: failure.remedy, native: failure.native, changed: failure.changed, target: { space, ...fields }, cause: failure.cause });
156
+ const placed = new CommandFailure(failure.outcome, failure.code, failure.message, { remedy: failure.remedy, native: failure.native, changed: failure.changed, target: { space, ...fields }, cause: failure.cause, selfContained: failure.selfContained });
124
157
  placed.stack = failure.stack;
125
158
  return placed;
126
159
  }
@@ -1 +1 @@
1
- {"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"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"}
package/dist/pid.d.ts CHANGED
@@ -17,6 +17,7 @@
17
17
  * BY CONSTRUCTION, not by oversight; if they need this contract, the fix is a shared local-process
18
18
  * module they may depend on, never a core export.
19
19
  */
20
+ import { type DarwinProcessBinding } from "./darwin-process.js";
20
21
  /** A Node/POSIX-signalable pid: a positive INTEGER within the signed 32-bit range `process.kill`
21
22
  * accepts (it throws `ERR_INVALID_ARG_TYPE`/`ERR_OUT_OF_RANGE` outside it). Anything else -
22
23
  * fractional, non-numeric, non-positive, oversized - is undefined: UNATTRIBUTABLE, never a pid to
@@ -51,6 +52,23 @@ export type LivenessProbe = (pid: number) => "alive" | "dead" | "unknown";
51
52
  * false-up. Reviewed against a repro that wedged three control-plane retries against an
52
53
  * unreachable manager. */
53
54
  export declare function probeLiveness(pid: number): "alive" | "dead" | "unknown";
55
+ /** Whether `pid` is stopped by a signal such as SIGSTOP, read from its `/proc` state, or on macOS from
56
+ * its kernel entry. Elsewhere this is `false`, and callers keep their unanswered-broker path. */
57
+ export declare function processStopped(pid: number): boolean;
58
+ /** The stopped process of this account that holds the listening socket a loopback `server` dials,
59
+ * or `undefined`. A stopped broker still takes connections, because the kernel completes them, and
60
+ * never greets, so a dial waits out its whole budget. Linux reads `/proc/net/tcp{,6}` and the
61
+ * stopped processes' descriptors; elsewhere this is `undefined`. */
62
+ export declare function stoppedLoopbackListener(server: string): number | undefined;
63
+ /** Every process of this account that listens where a loopback `server` dials, so a report can name
64
+ * what holds an address. Linux only; elsewhere, and for a host that is not loopback, none. */
65
+ export declare function loopbackListeners(server: string): number[];
66
+ /** The process group `pid` belongs to, or `undefined` when it is gone or this is neither Linux nor
67
+ * macOS. A macOS read that fails throws, so a group stop never narrows to one process unnoticed. */
68
+ export declare function processGroupOf(pid: number): number | undefined;
69
+ /** The live processes in process group `pgid`. A zombie has exited and holds nothing, so it is not
70
+ * one. Linux and macOS; elsewhere none. A macOS read that fails throws rather than read as empty. */
71
+ export declare function processGroupMembers(pgid: number): number[];
54
72
  /** What was read about ONE pid's command line, three-valued for the same reason liveness is:
55
73
  * "it is something else" and "I could not look" are different facts and only the first may be
56
74
  * acted on. */
@@ -188,7 +206,8 @@ export declare function parseRecord(raw: string): ReadRecord;
188
206
  export declare function formatRecord(record: ProcessIdentityRecord): string;
189
207
  /**
190
208
  * The creation-identity token of a live pid: on Linux `/proc/<pid>/stat` field 22 (starttime —
191
- * ticks since boot, fixed for the life of the pid); on macOS/BSD `ps -o lstart=`; on Windows
209
+ * ticks since boot, fixed for the life of the pid); on macOS its start time in microseconds, through
210
+ * the shipped Node-API binding; on other BSDs `ps -o lstart=`; on Windows
192
211
  * the process creation FILETIME (GetProcessTimes through the shipped Node-API binding). A pid whose token is
193
212
  * `undefined` can still be recorded — the record then carries no start pin, and teardown warns that
194
213
  * it is proceeding without the identity check. That pid-only shape is for a record that predates
@@ -207,11 +226,18 @@ export declare function parseWin32CreationToken(raw: string): string | undefined
207
226
  * The reader parameter exercises validation off Windows; native suites execute the real binding.
208
227
  */
209
228
  export declare function win32ProcessCreationToken(pid: number, read?: ProcessStartTokenReader): string | undefined;
210
- /** Identity's start-token reader: POSIX uses the same `/proc`/`ps` implementation as the advisory
211
- * lock so launch and teardown cannot drift; win32 uses {@link win32ProcessCreationToken} instead
212
- * of the lock's `undefined`. `platform` is a parameter so the win32 branch is executable off
213
- * Windows: a mutation that returns `undefined` on win32 must redden without a Windows kernel. */
214
- export declare function identityStartToken(pid: number, platform?: string, win32?: ProcessStartTokenReader, posix?: ProcessStartTokenReader): string | undefined;
229
+ /**
230
+ * macOS start time in microseconds through the shipped Node-API binding. No subprocess is involved,
231
+ * and the second-precision `ps -o lstart=` text is not used. A process that cannot be read is
232
+ * unverified; a missing binding throws. The binding parameter exercises validation off macOS.
233
+ */
234
+ export declare function darwinProcessStartToken(pid: number, binding?: () => Pick<DarwinProcessBinding, "processInfo">): string | undefined;
235
+ /** Identity's start-token reader: Linux uses the same `/proc` implementation as the advisory lock so
236
+ * launch and teardown cannot drift; win32 uses {@link win32ProcessCreationToken} instead of the
237
+ * lock's `undefined`, and macOS {@link darwinProcessStartToken} instead of the lock's second-precision
238
+ * `ps` text. `platform` is a parameter so the win32 and macOS branches are executable elsewhere: a
239
+ * mutation that returns `undefined` there must redden without that kernel. */
240
+ export declare function identityStartToken(pid: number, platform?: string, win32?: ProcessStartTokenReader, posix?: ProcessStartTokenReader, darwin?: ProcessStartTokenReader): string | undefined;
215
241
  export declare function defaultStartToken(pid: number): string | undefined;
216
242
  /** The start token for a pid THIS PROCESS is about to record. Prefer the reader passed by the
217
243
  * caller (tests inject divergence), fall back to {@link defaultStartToken}. `undefined` (a
@@ -220,6 +246,10 @@ export declare function defaultStartToken(pid: number): string | undefined;
220
246
  export declare function identityRecord(pid: number, tokenAt?: ProcessStartTokenReader): ProcessIdentityRecord | {
221
247
  pid: number;
222
248
  };
249
+ /** The reader that verifies a recorded start token. A macOS pin written before the native reader holds
250
+ * `ps -o lstart=` text, which no microsecond token equals, so the default reader verifies it with that
251
+ * same `ps` reader and it keeps the guarantee it was written with. A reader the caller passes is used as given. */
252
+ export declare function startTokenReaderFor(token: string, tokenAt?: ProcessStartTokenReader, platform?: string): ProcessStartTokenReader;
223
253
  /** The verdict of {@link assertRecordIdentity}: does the live process behind `pid` still carry the
224
254
  * start this record pinned? `unreadable` is deliberately NOT a variant: the reader signature
225
255
  * returns `undefined` for "cannot look" and that folds into `unpinned` (refuse). This differs from
@@ -294,7 +324,9 @@ export interface RecordReplaceIo {
294
324
  * line. After `publish-pin`, the NEW complete record. No state is torn and none drops to the unpinned
295
325
  * legacy shape. A legacy old record (a pidfile with no pin) is carried as a {@link NO_START_TOKEN}
296
326
  * line, so it stays legacy until the commit. An old pin that is torn or has no line for the old pid
297
- * has nothing to carry, so until the commit it refuses as a torn pairing, as it already did.
327
+ * has nothing to carry, so until the commit it refuses as a torn pairing, as it already did. A
328
+ * pidfile that exists but cannot be read is not a first start: the publish throws before its first
329
+ * rename, leaving the record as it was.
298
330
  *
299
331
  * When `identityRecord` cannot establish a token (ps-less host, or a pid whose start could not be
300
332
  * read - same rule as {@link writeIdentityPin}), the new line carries {@link NO_START_TOKEN} and
@@ -322,6 +354,8 @@ export declare function writePidPair(pidfilePath: string, pid: number, opts?: {
322
354
  }): void;
323
355
  /** What {@link verifyIdentityPin} found for one pidfile. */
324
356
  export type PinVerdict = {
357
+ kind: "no-pid";
358
+ } | {
325
359
  kind: "legacy";
326
360
  } | {
327
361
  kind: "match";
@@ -344,6 +378,7 @@ export type PinVerdict = {
344
378
  /**
345
379
  * THE open-verify step every teardown runs BEFORE signalling (#969). Read the pidfile's bare pid,
346
380
  * then the sibling pin, and adjudicate the pairing:
381
+ * - no-pid -> no pid is recorded, so there is no process to verify or signal
347
382
  * - legacy -> the caller warns and signals for upgrade compatibility
348
383
  * - match -> safe to signal; the process behind the pid is the recorded one
349
384
  * - gone -> ESRCH-proven dead; the caller may clear the record
package/dist/pid.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"pid.d.ts","sourceRoot":"","sources":["../src/pid.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"pid.d.ts","sourceRoot":"","sources":["../src/pid.ts"],"names":[],"mappings":"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"}