wicked-crew 0.15.3 → 0.15.4

package/dist/api/seat-work-default.d.ts

@@ -0,0 +1,22 @@
+import type { HealthWarning } from 'wicked-crew-api-types';
+/** The engine's built-in seat keys (wicked-council `registry::builtin`). */
+export declare const BUILTIN_SEAT_KEYS: readonly string[];
+export declare const SEAT_WORK_DEFAULT_KIND = "seat.work_default";
+/** What the overlay says about one seat's roles, after folding every record with its key. */
+export interface OverlaySeatRoles {
+    key: string;
+    /** The last value a record wrote; `undefined` when none wrote the flag. */
+    enabled_for_council: boolean | undefined;
+    /** Some record with this key writes `seat_eligible_for_work` (true or false). */
+    work_flag_written: boolean;
+}
+export declare function isBuiltinSeat(key: string): boolean;
+/** The overlay's seats, in first-appearance order, each folded over its records. Throws on a
+ *  malformed file (the caller treats that as "nothing to say"). */
+export declare function readOverlaySeatRoles(text: string): OverlaySeatRoles[];
+/** One `seat.work_default` warning per custom seat that is council-off with no work flag written. */
+export declare function seatWorkDefaultWarnings(seats: readonly OverlaySeatRoles[]): HealthWarning[];
+/** The warnings for the overlay the engine reads now. Re-read when the file changes (one `stat` per
+ *  call otherwise), so an edit is reported without a restart; none when there is no overlay. */
+export declare function seatWorkDefaultNow(env?: NodeJS.ProcessEnv): HealthWarning[];
+//# sourceMappingURL=seat-work-default.d.ts.map

package/dist/api/seat-work-default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-work-default.d.ts","sourceRoot":"","sources":["../../src/api/seat-work-default.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAA4D,CAAC;AAE5G,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAE1D,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,mBAAmB,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,iFAAiF;IACjF,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;mEACmE;AACnE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAiBrE;AAED,qGAAqG;AACrG,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,aAAa,EAAE,CAa3F;AAID;gGACgG;AAChG,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,aAAa,EAAE,CAmBxF"}

package/dist/api/seat-work-default.js

@@ -0,0 +1,91 @@
+// crew 0.15.2 (#916, wicked-core#572) read a seat's two roles separately: `enabled_for_council` (may
+// cast a council ballot) and `seat_eligible_for_work` (may be seated for work, engine default TRUE).
+// Before it, crew read `enabled_for_council = false` as "off both". So an operator's CUSTOM seat
+// written `enabled_for_council = false` with no work flag (a chat-only or helper seat) silently
+// became work-eligible on upgrade, and the engine may now seat it on a unit, for example as the
+// distinct evaluator of a review. This module names each such seat once, on `GET /health.warnings`
+// (`seat.work_default`), `GET /diagnostics.seatGovernance.roleFindings` and `wicked-crew status`.
+//
+// Only the operator's overlay can say whether the key was WRITTEN: the engine's merged roster has
+// already filled the default. So this parses the overlay file itself, the one the engine loads
+// (`seatRosterFile`), and folds its `[[cli]]` records by the engine's own rules
+// (wicked-council `registry::load`): a record whose key matches an earlier one (a built-in or a
+// previous record) inherits that record's `false` for a flag it omits. An unreadable or malformed
+// file yields no finding (the engine reports a malformed overlay itself).
+//
+// Built-in seats never warn: a record whose key is EXACTLY a built-in's overrides it, and an omitted
+// flag inherits the built-in's value, so its standing did not change. Keys match exactly, as in the
+// engine: `agy#2` in the overlay is a new custom seat, not agy.
+import { readFileSync, statSync } from 'node:fs';
+import { parse } from 'smol-toml';
+import { seatRosterFile } from './diagnostics.js';
+/** The engine's built-in seat keys (wicked-council `registry::builtin`). */
+export const BUILTIN_SEAT_KEYS = ['claude', 'agy', 'codex', 'pi', 'copilot', 'opencode'];
+export const SEAT_WORK_DEFAULT_KIND = 'seat.work_default';
+export function isBuiltinSeat(key) {
+    return BUILTIN_SEAT_KEYS.includes(key);
+}
+/** The overlay's seats, in first-appearance order, each folded over its records. Throws on a
+ *  malformed file (the caller treats that as "nothing to say"). */
+export function readOverlaySeatRoles(text) {
+    const doc = parse(text);
+    const records = Array.isArray(doc.cli) ? doc.cli : [];
+    const byKey = new Map();
+    for (const raw of records) {
+        if (raw === null || typeof raw !== 'object')
+            continue;
+        const r = raw;
+        if (typeof r['key'] !== 'string')
+            continue;
+        const prev = byKey.get(r['key']);
+        const council = typeof r['enabled_for_council'] === 'boolean' ? r['enabled_for_council'] : prev?.enabled_for_council;
+        byKey.set(r['key'], {
+            key: r['key'],
+            enabled_for_council: council,
+            work_flag_written: (prev?.work_flag_written ?? false) || typeof r['seat_eligible_for_work'] === 'boolean',
+        });
+    }
+    return [...byKey.values()];
+}
+/** One `seat.work_default` warning per custom seat that is council-off with no work flag written. */
+export function seatWorkDefaultWarnings(seats) {
+    const out = [];
+    for (const r of seats) {
+        if (isBuiltinSeat(r.key) || r.enabled_for_council !== false || r.work_flag_written)
+            continue;
+        out.push({
+            kind: SEAT_WORK_DEFAULT_KIND,
+            severity: 'warning',
+            message: `seat ${r.key} is not enabled for council but is now eligible for work (since crew 0.15.2 the two are separate); ` +
+                'set seat_eligible_for_work = false to keep it off work',
+        });
+    }
+    return out;
+}
+let cache = null;
+/** The warnings for the overlay the engine reads now. Re-read when the file changes (one `stat` per
+ *  call otherwise), so an edit is reported without a restart; none when there is no overlay. */
+export function seatWorkDefaultNow(env = process.env) {
+    const file = seatRosterFile(env);
+    if (file === null || !file.present)
+        return [];
+    try {
+        const st = statSync(file.path);
+        if (cache !== null && cache.path === file.path && cache.mtimeMs === st.mtimeMs && cache.size === st.size) {
+            return cache.warnings;
+        }
+        let warnings;
+        try {
+            warnings = seatWorkDefaultWarnings(readOverlaySeatRoles(readFileSync(file.path, 'utf8')));
+        }
+        catch {
+            warnings = []; // malformed: the engine reports the overlay itself; not re-parsed until it changes
+        }
+        cache = { path: file.path, mtimeMs: st.mtimeMs, size: st.size, warnings };
+        return warnings;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=seat-work-default.js.map

package/dist/api/seat-work-default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seat-work-default.js","sourceRoot":"","sources":["../../src/api/seat-work-default.ts"],"names":[],"mappings":"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"}