@rubytech/create-sitedesk-code 0.1.573 → 0.1.574

package/payload/platform/services/claude-session-manager/dist/quote-print-census.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-print-census.js","sourceRoot":"","sources":["../src/quote-print-census.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,kFAAkF;AAClF,qCAAqC;AACrC,EAAE;AACF,+EAA+E;AAC/E,iFAAiF;AACjF,iFAAiF;AACjF,oEAAoE;AACpE,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,8CAA8C;AAE9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACzE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAEzC,MAAM,CAAC,MAAM,GAAG,GAAG,sBAAsB,CAAA;AAEzC;;;;;;;;;;4DAU4D;AAC5D,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAA;AAW5D;yEACyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,CAAoB;IACpD,OAAO,CACL,GAAG,GAAG,YAAY,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,IAAI,eAAe,CAAC,CAAC,UAAU,GAAG;QACxE,sBAAsB,CAAC,CAAC,kBAAkB,oBAAoB,CAAC,CAAC,eAAe,GAAG;QAClF,cAAc,CAAC,CAAC,UAAU,EAAE,CAC7B,CAAA;AACH,CAAC;AAED;;;;;0EAK0E;AAC1E,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CACzB,4GAA4G,CAC7G,CAAA;IACD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,EAAE,GAAG,CAAC,CAAA;QACV,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;YACvC,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM;gBAAE,EAAE,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ,CAAC,4DAA4D;QACvE,CAAC;QACD,IAAI,EAAE,GAAG,iBAAiB;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC1C,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAUD;;;;;;;;2BAQ2B;AAC3B,SAAS,cAAc,CAAC,QAAgB;IACtC,OAAO,KAAK,EAAE,GAAW,EAAE,GAAW,EAAmB,EAAE;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;YAC9B,eAAe,EAAE,aAAa;YAC9B,SAAS,EAAE,+CAA+C;YAC1D,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE;SAC1B,CAAC,CAAA;QACF,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;QAC9B,OAAO,GAAG,CAAC,OAAO,CAAA;QAClB,OAAO,GAAG,CAAC,kCAAkC,CAAA;QAC7C,OAAO,GAAG,CAAC,WAAW,CAAA;QACtB,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE;YAC9C,GAAG;YACH,GAAG;YACH,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,MAAM;SAChB,CAAC,CAAA;QACF,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAA;QAChC,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAA;YACtC,OAAO,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,yEAAyE;YACzE,4BAA4B;YAC5B,MAAM,CAAC,GAAG,GAA6C,CAAA;YACvD,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA;QACxD,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,SAAS,UAAU,CAAC,YAAoB;IACtC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5C,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC,CAClD,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;2BAE2B;AAC3B,SAAS,UAAU,CAAC,GAAW,EAAE,GAAW,EAAE,KAAa;IACzD,IAAI,OAAiB,CAAA;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;IACD,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACtB,IAAI,KAAK,GAAG,KAAK,CAAA;QACjB,IAAI,CAAC;YACH,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAA;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,KAAK,GAAG,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAA;QAC3D,CAAC;aAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACb,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;sCAGsC;AACtC,SAAS,WAAW,CAClB,UAAkB,EAClB,MAAyB;IAEzB,MAAM,MAAM,GAAG,iCAAiC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC5E,MAAM,QAAQ,GAAG,6BAA6B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IAC1E,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,UAAU,IAAI,CAAC,CAAA;QACtB,OAAM;IACR,CAAC;IACD,IAAI,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,UAAU,IAAI,CAAC,CAAA;QACtB,OAAM;IACR,CAAC;IACD,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACpD,IAAI,OAAO;QAAE,MAAM,CAAC,kBAAkB,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5D,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAChD,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC/C,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACjD,IAAI,IAAI,IAAI,KAAK,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,MAAM,CAAC,eAAe,IAAI,CAAC,CAAA;IAC7B,CAAC;AACH,CAAC;AAED;;oDAEoD;AACpD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAqB;IAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAC7D,MAAM,MAAM,GAAsB;QAChC,OAAO,EAAE,CAAC;QACV,IAAI,EAAE,CAAC;QACP,UAAU,EAAE,CAAC;QACb,kBAAkB,EAAE,CAAC;QACrB,eAAe,EAAE,CAAC;QAClB,UAAU,EAAE,CAAC;KACd,CAAA;IAED,KAAK,MAAM,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,OAAO,IAAI,CAAC,CAAA;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;QAExC,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,CAAC,IAAI,IAAI,CAAC,CAAA;YAChB,IAAI,MAAM,GAAG,EAAE,CAAA;YACf,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;YACnC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,UAAU,IAAI,CAAC,CAAA;gBACtB,SAAQ;YACV,CAAC;YACD,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC7B,CAAC;QAED,MAAM,IAAI,GAAG;YACX,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7D,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;SACzD,CAAA;QACD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,GAAW,CAAA;YACf,IAAI,CAAC;gBACH,GAAG,GAAG,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,UAAU,IAAI,CAAC,CAAA;gBACtB,SAAQ;YACV,CAAC;YACD,MAAM,CAAC,UAAU,IAAI,CAAC,CAAA;YACtB,MAAM,CAAC,eAAe,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;QAC3D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAA;IACtC,OAAO,MAAM,CAAA;AACf,CAAC;AAOD;;;gEAGgE;AAChE,MAAM,UAAU,iBAAiB,CAAC,IAA8C;IAC9E,IAAI,KAAK,GAA0B,IAAI,CAAA;IACvC,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,OAAO;QACL,KAAK;YACH,IAAI,KAAK;gBAAE,OAAM;YACjB,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;gBACvB,IAAI,OAAO;oBAAE,OAAM;gBACnB,OAAO,GAAG,IAAI,CAAA;gBACd,KAAK,kBAAkB,CAAC,IAAI,CAAC;qBAC1B,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;oBACtB,IAAI,CAAC,MAAM,CACT,GAAG,GAAG,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACpF,CAAA;gBACH,CAAC,CAAC;qBACD,OAAO,CAAC,GAAG,EAAE;oBACZ,OAAO,GAAG,KAAK,CAAA;gBACjB,CAAC,CAAC,CAAA;YACN,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;YACnB,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU;gBAAE,KAAK,CAAC,KAAK,EAAE,CAAA;QACtD,CAAC;QACD,IAAI;YACF,IAAI,KAAK,EAAE,CAAC;gBACV,aAAa,CAAC,KAAK,CAAC,CAAA;gBACpB,KAAK,GAAG,IAAI,CAAA;YACd,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/payload/platform/services/claude-session-manager/dist/specialist-census.d.ts

@@ -0,0 +1,92 @@
+export declare const WINDOW_MS: number;
+export type Logger = (line: string) => void;
+export interface TranscriptEvent {
+    /** Epoch ms from the record's own `timestamp`, so the window is per-record
+     *  rather than per-file. A transcript appended to over days holds events on
+     *  both sides of the boundary. */
+    ts: number;
+    kind: 'dispatch' | 'bypass';
+    /** Dispatch: the `tool_use` id, resolved to an agent type later. Bypass: the
+     *  tool name. */
+    key: string;
+}
+/** Dispatches and gated calls in one transcript.
+ *
+ *  The input is the PARENT session transcript, which is the main conversation by
+ *  construction: Task 2469 measured all 41,456 records of one parent as
+ *  `isSidechain: false`, carrying none of a subagent's tool calls. So a
+ *  specialist's own use of its own tool can never be counted as a bypass here.
+ *
+ *  A line that will not parse yields nothing rather than throwing: the corpus
+ *  carries partial trailing writes, and one bad line must not abort the
+ *  transcript it sits in.
+ *
+ *  A dispatch with no `tool_use` id is skipped rather than counted: it cannot be
+ *  attributed to a specialist, and an unattributable dispatch counted as a
+ *  success is exactly the false green this task exists to remove. */
+export declare function scanTranscript(lines: Iterable<string>, gated: ReadonlySet<string>): TranscriptEvent[];
+/** The two counts over one window.
+ *
+ *  A dispatch counts only when its agent type names one of the account's own
+ *  specialists. A dispatch to a shipped specialist is not evidence that the
+ *  account's own clerks are being used, and an id that resolves to nothing is
+ *  not counted either: "we could not tell who ran" is not "the account's
+ *  specialist ran". */
+export declare function countWindow(events: readonly TranscriptEvent[], agentTypeById: ReadonlyMap<string, string>, authoredNames: ReadonlySet<string>, sinceMs: number): {
+    dispatched: number;
+    bypassed: number;
+};
+/** The every-tick line. `declared>0 dispatched7d=0` is the alarm; `bypassed7d=0`
+ *  with `dispatched7d>0` is the healthy state. Emitted including all-zero, so
+ *  the line's presence proves the check ran. */
+export declare function formatCensus(p: {
+    accountId8: string;
+    declared: number;
+    dispatched7d: number;
+    bypassed7d: number;
+}): string;
+/** The error path, deliberately carrying NO counts. Reporting `declared=0` when
+ *  the card set could not be read would assert something never measured, and
+ *  would be indistinguishable from an account that genuinely has none. Task 2469
+ *  applied the same rule to `op=agent-registry-resolution`. */
+export declare function formatCensusDegraded(p: {
+    accountId8: string;
+    reason: string;
+}): string;
+export interface CensusAccount {
+    accountId: string;
+    accountDir: string;
+}
+export interface CensusTranscript {
+    path: string;
+    sessionId: string;
+    mtimeMs: number;
+}
+export interface ResolvedGating {
+    declared: number;
+    authoredNames: ReadonlySet<string>;
+    gated: ReadonlySet<string>;
+}
+export interface SpecialistCensusDeps {
+    intervalMs: number;
+    logger: Logger;
+    now(): number;
+    listAccounts(): readonly CensusAccount[];
+    /** May throw; a throw is the degraded path for that ACCOUNT and never for the
+     *  run, so one unreadable account does not cost every other account its line. */
+    resolveGated(accountDir: string): ResolvedGating;
+    /** May throw; same rule as `resolveGated`. */
+    listTranscripts(accountDir: string): readonly CensusTranscript[];
+    readLines(path: string): Iterable<string>;
+    /** `tool_use` id to the agent type it spawned, read from that session's
+     *  `subagents/agent-<id>.meta.json` files. Task 2469 established that sibling
+     *  meta as the only surface tying a subagent run to its type. */
+    readAgentTypes(accountDir: string, sessionId: string): ReadonlyMap<string, string>;
+}
+export interface SpecialistCensus {
+    start(): void;
+    stop(): void;
+    tickOnce(): void;
+}
+export declare function createSpecialistCensus(deps: SpecialistCensusDeps): SpecialistCensus;
+//# sourceMappingURL=specialist-census.d.ts.map

package/payload/platform/services/claude-session-manager/dist/specialist-census.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-census.d.ts","sourceRoot":"","sources":["../src/specialist-census.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,SAAS,QAA0B,CAAA;AAEhD,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;AAS3C,MAAM,WAAW,eAAe;IAC9B;;sCAEkC;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAA;IAC3B;qBACiB;IACjB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;;;;;;;qEAaqE;AACrE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,GACzB,eAAe,EAAE,CA6BnB;AAED;;;;;;uBAMuB;AACvB,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1C,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,EAClC,OAAO,EAAE,MAAM,GACd;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAa1C;AAED;;gDAEgD;AAChD,wBAAgB,YAAY,CAAC,CAAC,EAAE;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACnB,GAAG,MAAM,CAGT;AAED;;;+DAG+D;AAC/D,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEtF;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAClC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,IAAI,MAAM,CAAA;IACb,YAAY,IAAI,SAAS,aAAa,EAAE,CAAA;IACxC;qFACiF;IACjF,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAAA;IAChD,8CAA8C;IAC9C,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,gBAAgB,EAAE,CAAA;IAChE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;IACzC;;qEAEiE;IACjE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnF;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,IAAI,CAAA;IACZ,QAAQ,IAAI,IAAI,CAAA;CACjB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CAoHnF"}

package/payload/platform/services/claude-session-manager/dist/specialist-census.js

@@ -0,0 +1,227 @@
+// Task 2244 — an account's own specialists are present, and nothing dispatches
+// them.
+//
+// Skipped delegation writes no record: the inline draft logs an ordinary
+// success, so no log line carries the fault and no re-run reproduces it. On
+// account 2078cb54 four authored clerks owned email, works orders, invoices and
+// quotes while the admin produced all of them inline — zero dispatches against
+// 472 direct `email-draft` calls, for three days, found by the operator rather
+// than by the platform. Only a standing check that reports on a QUIET account
+// can see that state, which is why the line is emitted including all-zero.
+//
+// This is a fourth signal beside three that cannot answer it. The registry
+// reconcile (`account-agent-registry.ts`) says a specialist CAN be reached. The
+// roster census says it is advertised and resolvable. The preference audit
+// (`specialist-preference-audit.ts`) says the RIGHT specialist wrote an owned
+// artefact. None of them counts a dispatch.
+//
+// Shape mirrors specialist-preference-audit.ts: pure scanners, selector and
+// formatters, plus an impure factory whose setInterval is unref'd and whose
+// readers are injected.
+const TAG = '[specialist-census]';
+export const WINDOW_MS = 7 * 24 * 60 * 60 * 1000;
+/** The dispatch tool has carried two names across CLI versions, and both are
+ *  present in the corpus on disk: the current CLI writes `"name":"Agent"`, and
+ *  Task 2237 recorded `"name":"Task"` on the same install. Counting one is how a
+ *  brittle grep reads as a real zero — the trap that task documented when it
+ *  validated its own count against a tool it knew had run. */
+const DISPATCH_TOOLS = new Set(['Agent', 'Task']);
+/** Dispatches and gated calls in one transcript.
+ *
+ *  The input is the PARENT session transcript, which is the main conversation by
+ *  construction: Task 2469 measured all 41,456 records of one parent as
+ *  `isSidechain: false`, carrying none of a subagent's tool calls. So a
+ *  specialist's own use of its own tool can never be counted as a bypass here.
+ *
+ *  A line that will not parse yields nothing rather than throwing: the corpus
+ *  carries partial trailing writes, and one bad line must not abort the
+ *  transcript it sits in.
+ *
+ *  A dispatch with no `tool_use` id is skipped rather than counted: it cannot be
+ *  attributed to a specialist, and an unattributable dispatch counted as a
+ *  success is exactly the false green this task exists to remove. */
+export function scanTranscript(lines, gated) {
+    const out = [];
+    for (const line of lines) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const record = parsed;
+        if (typeof record.timestamp !== 'string')
+            continue;
+        const ts = Date.parse(record.timestamp);
+        if (Number.isNaN(ts))
+            continue;
+        const content = record.message?.content;
+        if (!Array.isArray(content))
+            continue;
+        for (const block of content) {
+            if (!block || typeof block !== 'object')
+                continue;
+            const b = block;
+            if (b.type !== 'tool_use' || typeof b.name !== 'string')
+                continue;
+            if (DISPATCH_TOOLS.has(b.name)) {
+                if (typeof b.id === 'string' && b.id.length > 0) {
+                    out.push({ ts, kind: 'dispatch', key: b.id });
+                }
+                continue;
+            }
+            if (gated.has(b.name))
+                out.push({ ts, kind: 'bypass', key: b.name });
+        }
+    }
+    return out;
+}
+/** The two counts over one window.
+ *
+ *  A dispatch counts only when its agent type names one of the account's own
+ *  specialists. A dispatch to a shipped specialist is not evidence that the
+ *  account's own clerks are being used, and an id that resolves to nothing is
+ *  not counted either: "we could not tell who ran" is not "the account's
+ *  specialist ran". */
+export function countWindow(events, agentTypeById, authoredNames, sinceMs) {
+    let dispatched = 0;
+    let bypassed = 0;
+    for (const event of events) {
+        if (event.ts < sinceMs)
+            continue;
+        if (event.kind === 'bypass') {
+            bypassed++;
+            continue;
+        }
+        const agentType = agentTypeById.get(event.key);
+        if (agentType !== undefined && authoredNames.has(agentType))
+            dispatched++;
+    }
+    return { dispatched, bypassed };
+}
+/** The every-tick line. `declared>0 dispatched7d=0` is the alarm; `bypassed7d=0`
+ *  with `dispatched7d>0` is the healthy state. Emitted including all-zero, so
+ *  the line's presence proves the check ran. */
+export function formatCensus(p) {
+    return `${TAG} account=${p.accountId8} declared=${p.declared}` +
+        ` dispatched7d=${p.dispatched7d} bypassed7d=${p.bypassed7d}`;
+}
+/** The error path, deliberately carrying NO counts. Reporting `declared=0` when
+ *  the card set could not be read would assert something never measured, and
+ *  would be indistinguishable from an account that genuinely has none. Task 2469
+ *  applied the same rule to `op=agent-registry-resolution`. */
+export function formatCensusDegraded(p) {
+    return `${TAG} account=${p.accountId8} op=degraded reason=${p.reason}`;
+}
+export function createSpecialistCensus(deps) {
+    /** transcript path -> the events found in it, at that mtime and under that
+     *  gated set.
+     *
+     *  Events rather than counts, because the window moves every tick while the
+     *  file does not: a cached count would freeze at the window in force when the
+     *  file was last read, and an account that went quiet would keep reporting the
+     *  activity it had a fortnight ago.
+     *
+     *  Keyed on the gated set as well as the mtime, because the gated set is not a
+     *  property of the transcript. Authoring a specialist widens it while every
+     *  existing file keeps its mtime, so an mtime-only cache would keep reporting
+     *  the counts of the narrower set and the new clerk's tools would read as
+     *  never bypassed on the day it was created. A transcript is re-read only when
+     *  one of the two moves, so a steady state still costs one stat per file. */
+    const seen = new Map();
+    let timer = null;
+    /** A stable identity for a gated set, so a cache hit can prove the events were
+     *  scanned under the set in force now. */
+    function gatingKeyFor(gated) {
+        return Array.from(gated).sort().join(',');
+    }
+    function tickOnce() {
+        const sinceMs = deps.now() - WINDOW_MS;
+        const live = new Set();
+        for (const account of deps.listAccounts()) {
+            const accountId8 = account.accountId.slice(0, 8);
+            let gating;
+            let transcripts;
+            try {
+                gating = deps.resolveGated(account.accountDir);
+                transcripts = deps.listTranscripts(account.accountDir);
+            }
+            catch (err) {
+                deps.logger(formatCensusDegraded({
+                    accountId8,
+                    reason: err instanceof Error ? err.message : String(err),
+                }));
+                continue;
+            }
+            const gatingKey = gatingKeyFor(gating.gated);
+            let dispatched7d = 0;
+            let bypassed7d = 0;
+            for (const transcript of transcripts) {
+                live.add(transcript.path);
+                const prior = seen.get(transcript.path);
+                let events;
+                if (prior && prior.mtimeMs === transcript.mtimeMs && prior.gatingKey === gatingKey) {
+                    events = prior.events;
+                }
+                else {
+                    try {
+                        events = scanTranscript(deps.readLines(transcript.path), gating.gated);
+                    }
+                    catch {
+                        // A transcript that cannot be read contributes nothing and is not
+                        // cached, so the next tick retries it. It does not degrade the
+                        // account: every other transcript still carries real counts.
+                        continue;
+                    }
+                    seen.set(transcript.path, { mtimeMs: transcript.mtimeMs, gatingKey, events });
+                }
+                let agentTypes = new Map();
+                if (events.some((e) => e.kind === 'dispatch')) {
+                    try {
+                        agentTypes = deps.readAgentTypes(account.accountDir, transcript.sessionId);
+                    }
+                    catch {
+                        // Unresolved dispatches are not counted, which countWindow already
+                        // enforces. Never counted as a success.
+                        agentTypes = new Map();
+                    }
+                }
+                const counted = countWindow(events, agentTypes, gating.authoredNames, sinceMs);
+                dispatched7d += counted.dispatched;
+                bypassed7d += counted.bypassed;
+            }
+            deps.logger(formatCensus({ accountId8, declared: gating.declared, dispatched7d, bypassed7d }));
+        }
+        // Drop transcripts that have gone, so the cache describes what is on disk now
+        // rather than growing for the life of a process that runs for weeks.
+        for (const path of Array.from(seen.keys()))
+            if (!live.has(path))
+                seen.delete(path);
+    }
+    return {
+        tickOnce,
+        start() {
+            if (timer)
+                return;
+            timer = setInterval(() => {
+                try {
+                    tickOnce();
+                }
+                catch (err) {
+                    deps.logger(`${TAG} op=tick-failed message=${err instanceof Error ? err.message : String(err)}`);
+                }
+            }, deps.intervalMs);
+            if (typeof timer.unref === 'function')
+                timer.unref();
+            deps.logger(`${TAG} op=started intervalMs=${deps.intervalMs}`);
+        },
+        stop() {
+            if (timer) {
+                clearInterval(timer);
+                timer = null;
+            }
+        },
+    };
+}
+//# sourceMappingURL=specialist-census.js.map

package/payload/platform/services/claude-session-manager/dist/specialist-census.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-census.js","sourceRoot":"","sources":["../src/specialist-census.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,QAAQ;AACR,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,gFAAgF;AAChF,+EAA+E;AAC/E,+EAA+E;AAC/E,8EAA8E;AAC9E,2EAA2E;AAC3E,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;AAChF,2EAA2E;AAC3E,8EAA8E;AAC9E,4CAA4C;AAC5C,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,wBAAwB;AAExB,MAAM,GAAG,GAAG,qBAAqB,CAAA;AAEjC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAIhD;;;;8DAI8D;AAC9D,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;AAatE;;;;;;;;;;;;;qEAaqE;AACrE,MAAM,UAAU,cAAc,CAC5B,KAAuB,EACvB,KAA0B;IAE1B,MAAM,GAAG,GAAsB,EAAE,CAAA;IACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAe,CAAA;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;QACD,MAAM,MAAM,GAAG,MAAkE,CAAA;QACjF,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YAAE,SAAQ;QAClD,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACvC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,SAAQ;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAA;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAQ;QACrC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,SAAQ;YACjD,MAAM,CAAC,GAAG,KAAsD,CAAA;YAChE,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAQ;YACjE,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChD,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;gBAC/C,CAAC;gBACD,SAAQ;YACV,CAAC;YACD,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;QACtE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;uBAMuB;AACvB,MAAM,UAAU,WAAW,CACzB,MAAkC,EAClC,aAA0C,EAC1C,aAAkC,EAClC,OAAe;IAEf,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,EAAE,GAAG,OAAO;YAAE,SAAQ;QAChC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5B,QAAQ,EAAE,CAAA;YACV,SAAQ;QACV,CAAC;QACD,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC9C,IAAI,SAAS,KAAK,SAAS,IAAI,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,UAAU,EAAE,CAAA;IAC3E,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAA;AACjC,CAAC;AAED;;gDAEgD;AAChD,MAAM,UAAU,YAAY,CAAC,CAK5B;IACC,OAAO,GAAG,GAAG,YAAY,CAAC,CAAC,UAAU,aAAa,CAAC,CAAC,QAAQ,EAAE;QAC5D,iBAAiB,CAAC,CAAC,YAAY,eAAe,CAAC,CAAC,UAAU,EAAE,CAAA;AAChE,CAAC;AAED;;;+DAG+D;AAC/D,MAAM,UAAU,oBAAoB,CAAC,CAAyC;IAC5E,OAAO,GAAG,GAAG,YAAY,CAAC,CAAC,UAAU,uBAAuB,CAAC,CAAC,MAAM,EAAE,CAAA;AACxE,CAAC;AA0CD,MAAM,UAAU,sBAAsB,CAAC,IAA0B;IAC/D;;;;;;;;;;;;;iFAa6E;IAC7E,MAAM,IAAI,GAAG,IAAI,GAAG,EAA6E,CAAA;IACjG,IAAI,KAAK,GAA0B,IAAI,CAAA;IAEvC;8CAC0C;IAC1C,SAAS,YAAY,CAAC,KAA0B;QAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC3C,CAAC;IAED,SAAS,QAAQ;QACf,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;QACtC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;QAE9B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;YAEhD,IAAI,MAAsB,CAAA;YAC1B,IAAI,WAAwC,CAAA;YAC5C,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;gBAC9C,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;YACxD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CACT,oBAAoB,CAAC;oBACnB,UAAU;oBACV,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACzD,CAAC,CACH,CAAA;gBACD,SAAQ;YACV,CAAC;YAED,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAC5C,IAAI,YAAY,GAAG,CAAC,CAAA;YACpB,IAAI,UAAU,GAAG,CAAC,CAAA;YAClB,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;gBACzB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;gBACvC,IAAI,MAAyB,CAAA;gBAC7B,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,UAAU,CAAC,OAAO,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;oBACnF,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;gBACvB,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC;wBACH,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;oBACxE,CAAC;oBAAC,MAAM,CAAC;wBACP,kEAAkE;wBAClE,+DAA+D;wBAC/D,6DAA6D;wBAC7D,SAAQ;oBACV,CAAC;oBACD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAA;gBAC/E,CAAC;gBAED,IAAI,UAAU,GAAgC,IAAI,GAAG,EAAE,CAAA;gBACvD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE,CAAC;oBAC9C,IAAI,CAAC;wBACH,UAAU,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;oBAC5E,CAAC;oBAAC,MAAM,CAAC;wBACP,mEAAmE;wBACnE,wCAAwC;wBACxC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAA;oBACxB,CAAC;gBACH,CAAC;gBAED,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;gBAC9E,YAAY,IAAI,OAAO,CAAC,UAAU,CAAA;gBAClC,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAA;YAChC,CAAC;YAED,IAAI,CAAC,MAAM,CACT,YAAY,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAClF,CAAA;QACH,CAAC;QAED,8EAA8E;QAC9E,qEAAqE;QACrE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACpF,CAAC;IAED,OAAO;QACL,QAAQ;QACR,KAAK;YACH,IAAI,KAAK;gBAAE,OAAM;YACjB,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;gBACvB,IAAI,CAAC;oBACH,QAAQ,EAAE,CAAA;gBACZ,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,CAAC,MAAM,CACT,GAAG,GAAG,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACpF,CAAA;gBACH,CAAC;YACH,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;YACnB,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU;gBAAE,KAAK,CAAC,KAAK,EAAE,CAAA;YACpD,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,0BAA0B,IAAI,CAAC,UAAU,EAAE,CAAC,CAAA;QAChE,CAAC;QACD,IAAI;YACF,IAAI,KAAK,EAAE,CAAC;gBACV,aAAa,CAAC,KAAK,CAAC,CAAA;gBACpB,KAAK,GAAG,IAAI,CAAA;YACd,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/payload/platform/templates/account-settings.json

@@ -11,7 +11,8 @@
         "hooks": [
           { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/archive-ingest-surface-gate.sh" },
           { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/fs-schema-guard.sh" },
-          { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/quote-path-write-gate.sh" }
+          { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/quote-path-write-gate.sh" },
+          { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/html-structure-gate.sh" }
         ]
       },
       {
@@ -19,7 +20,8 @@
         "hooks": [
           { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/archive-ingest-surface-gate.sh" },
           { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/fs-schema-guard.sh" },
-          { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/quote-path-write-gate.sh" }
+          { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/quote-path-write-gate.sh" },
+          { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/html-structure-gate.sh" }
         ]
       },
       {
@@ -27,7 +29,8 @@
         "hooks": [
           { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/archive-ingest-surface-gate.sh" },
           { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/fs-schema-guard.sh" },
-          { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/quote-path-write-gate.sh" }
+          { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/quote-path-write-gate.sh" },
+          { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/html-structure-gate.sh" }
         ]
       },
       {
@@ -50,7 +53,8 @@
       {
         "hooks": [
           { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/archive-ingest-surface-gate.sh" },
-          { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/public-tool-surface.sh" }
+          { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/public-tool-surface.sh" },
+          { "type": "command", "command": "bash $PLATFORM_ROOT/plugins/admin/hooks/specialist-dispatch-gate.sh" }
         ]
       },
       {

package/payload/premium-plugins/sitedesk/plugins/sitedesk-job/skills/quotation/references/quote-generation.md

@@ -59,6 +59,13 @@ client quote (see `references/verification.md`, "Verifying the issued document c
 - **`data-doc-header`** on the header block, so the tool can hold it to the account's declared canonical
   header template at `quoting/templates/header.html` (verbatim, structure and embedded logo data). The
   template is a fixed-path opt-in: when the account declares none the header check is skipped.
+  **The header block carries its own `<style>` element and is spliced into the body, never inside an
+  existing `<style>`.** A browser parses style content as raw text, so a second `<style>` opened inside
+  an open one does not nest: the first `</style>` closes the outer element, everything after it becomes
+  body content and renders as visible text above the header, and the rule immediately after the stray
+  opener is eaten as part of an invalid selector. Either put the block in the body as its own element,
+  or merge its rules into the one already open. A write that would produce the nested shape is refused
+  at the write, and any such document already on disk is reported on the standing census tick.
 - **`data-doc-terms`** on the standing-terms section, so the tool asserts it carries no above-normal
   weight (no `<b>`/`<strong>`, no inline `font-weight` of bold, bolder, or 500 to 900). No terms marker,
   no check.
@@ -91,10 +98,16 @@ The tool produces **HTML, not PDF**. Print each returned path to PDF with the `b
 final step: `browser-navigate` to its `file://` URL, then `browser-pdf-save` to a `.pdf` alongside it,
 confirming a non-zero byte count. A Workflow chains `quote-engine-run`, then `quote-render`, then one
 `browser` `browser-pdf-save` step per document. A **PostToolUse gate on `browser-pdf-save`** then holds
-the printed client-quote PDF to its two PDF-only conformance checks: its `/URI` count is at least the
-source HTML's absolute-link count, and every embedded `https://` link answers 200. A failure blocks the
-print with `[quote-render] op=bypass reason=pdf-link-conformance`, so a link-stripped or dead-link PDF
-is not sent.
+the printed PDF to the conformance checks that can only be made once the PDF exists. Two are about
+links on a gated client quote: its `/URI` count is at least the source HTML's absolute-link count, and
+every embedded `https://` link answers 200; a failure blocks the print with
+`[quote-render] op=bypass reason=pdf-link-conformance`, so a link-stripped or dead-link PDF is not
+sent. Two are about page chrome, and apply to **any** printed document that declares the thing they
+check, receipt or no receipt, because a template-seeded document never passes through `quote-render`
+at all: a running header must appear on every physical page when a text margin box is declared
+(`reason=pdf-header-conformance`), and the header's image must render no wider than a third of the
+page when an image margin box is declared (`reason=pdf-header-image-geometry`). Both page-chrome
+faults are reported on the same print, so fixing one does not hide the other.
 
 ## The three documents
 
@@ -185,6 +198,12 @@ the document:
 
 - page-level chrome — a running header or footer and page numbers — via `@page` margin boxes, never
   absolutely-positioned elements that drift across pages;
+- an image used as a margin box's `content: url(...)` **pre-sized to the box**. The renderer paints
+  such an image at its own intrinsic pixel size, one image pixel to one CSS pixel at 96 pixels per
+  inch, and does **not** scale it down to the `width`/`height` the box declares. A full-resolution
+  logo therefore covers most of the page on every page the box paints, whatever the box says: a
+  700-pixel-wide asset renders 525 points wide on a 595-point A4 page, against a declared box of 34
+  millimetres. Make a derivative at the size the box expects and point the box at that;
 - `print-color-adjust: exact` on coloured fills, so the operator's brand fills survive print. The
   renderer prints backgrounds, but make the intent explicit rather than relying on the default.
 

package/payload/server/public/operator.html

@@ -22,8 +22,8 @@
   <link rel="modulepreload" crossorigin href="/assets/wrench-D4ufQG6C.js">
   <link rel="modulepreload" crossorigin href="/assets/page-BbBCu9iP.js">
   <link rel="stylesheet" crossorigin href="/assets/jsx-runtime-DxsQ5Y-z.css">
-  <link rel="stylesheet" crossorigin href="/assets/useMediaQuery-DXAuc8G-.css">
   <link rel="stylesheet" crossorigin href="/assets/AdminLoginScreens-CWMpccrR.css">
+  <link rel="stylesheet" crossorigin href="/assets/useMediaQuery-DXAuc8G-.css">
   <link rel="stylesheet" href="/brand-defaults.css">
 </head>
 <body>