@wrongstack/core 0.302.2 → 0.305.0

package/dist/execution/one-shot-llm.d.ts

@@ -44,6 +44,11 @@ export declare class OneShotOrchestrator {
     private resolveSignal;
     /**
      * Build the fallback model chain from input + config + current target.
+     * Delegates to {@link FallbackProfileManager.resolveCandidates} — the
+     * shared constructor used by both the agent loop and the one-shot path,
+     * so both produce identical ordering, depth, and fromExplicitSource
+     * semantics.
+     *
      * The injected {@link OneShotOrchestratorOptions.fallbackProfileManager}
      * is the only allowed manager — OneShot never owns a private snapshot
      * so a live `ConfigStore` change reaches every call without rebuilding

package/dist/goal/index.js

@@ -342,6 +342,11 @@ var TaskTracker = class _TaskTracker {
     if (!this.graph) return false;
     const node = this.graph.nodes.get(id);
     if (!node) return false;
+    if (node.specRequirementId && this.graph.requiredRequirementIds?.includes(node.specRequirementId) && !Array.from(this.graph.nodes.values()).some(
+      (candidate) => candidate.id !== id && candidate.specRequirementId === node.specRequirementId
+    )) {
+      return false;
+    }
     this.graph.nodes.delete(id);
     this.graph.edges = this.graph.edges.filter((e) => e.from !== id && e.to !== id);
     this.graph.rootNodes = this.graph.rootNodes.filter((r) => r !== id);
@@ -2667,6 +2672,7 @@ var PhaseStore = class {
     return {
       id: graph.id,
       specId: graph.specId,
+      requiredRequirementIds: graph.requiredRequirementIds,
       title: graph.title,
       nodes: Array.from(graph.nodes.values()).map((n) => this.serializeTaskNode(n)),
       edges: graph.edges,
@@ -2735,6 +2741,7 @@ var PhaseStore = class {
     return {
       id: serialized.id,
       specId: serialized.specId,
+      requiredRequirementIds: serialized.requiredRequirementIds,
       title: serialized.title,
       nodes,
       edges: serialized.edges ?? [],

package/dist/hq/index.js

@@ -86,7 +86,7 @@ var MAX_HQ_KANBAN_BOARD_BYTES = 75e4;
 function isHqKanbanSnapshotPayload(value) {
   if (typeof value !== "object" || value === null) return false;
   const payload = value;
-  if (typeof payload.projectId !== "string" || payload.projectId.length === 0 || typeof payload.generatedAt !== "string" || !Number.isFinite(Date.parse(payload.generatedAt)) || !Array.isArray(payload.boards) || !Array.isArray(payload.tombstones) || payload.boards.length > MAX_HQ_KANBAN_BOARDS || payload.tombstones.length > MAX_HQ_KANBAN_BOARDS) {
+  if (typeof payload.projectId !== "string" || payload.projectId.length === 0 || typeof payload.generatedAt !== "string" || !Number.isFinite(Date.parse(payload.generatedAt)) || !Array.isArray(payload.boards) || !Array.isArray(payload.tombstones) || payload.boards.length > MAX_HQ_KANBAN_BOARDS || payload.tombstones.length > MAX_HQ_KANBAN_BOARDS || !isOptionalChunkOrdinal(payload.chunkIndex) || !isOptionalChunkOrdinal(payload.chunkCount)) {
     return false;
   }
   const seen = /* @__PURE__ */ new Set();
@@ -100,6 +100,9 @@ function isHqKanbanSnapshotPayload(value) {
   }
   return true;
 }
+function isOptionalChunkOrdinal(value) {
+  return value === void 0 || Number.isSafeInteger(value) && value >= 0;
+}
 function isBoardRecord(value) {
   if (typeof value !== "object" || value === null) return false;
   const record = value;
@@ -1140,12 +1143,11 @@ function redactHqValueInternal(value, options, preserveRawContentKeys) {
 function redactHqValue(value, options = {}) {
   return redactHqValueInternal(value, options, false);
 }
+function redactHqEventPayload(type, payload, options = {}) {
+  return redactHqValueInternal(payload, options, HQ_PROJECT_STATE_EVENT_TYPES.has(type));
+}
 function redactHqEvent(event, options = {}) {
-  const payload = redactHqValueInternal(
-    event.payload,
-    options,
-    HQ_PROJECT_STATE_EVENT_TYPES.has(event.type)
-  );
+  const payload = redactHqEventPayload(event.type, event.payload, options);
   const nextEvent = {
     ...event,
     payload: payload.value
@@ -1322,7 +1324,9 @@ function queuedFrameCoalesceKey(frame) {
   if (frame.type !== "client.event" || !frame.event.type.endsWith(".snapshot")) {
     return void 0;
   }
-  return [frame.event.type, frame.event.sessionId ?? "", frame.event.runId ?? ""].join("|");
+  const payload = frame.event.payload;
+  const chunk = typeof payload?.chunkIndex === "number" && Number.isFinite(payload.chunkIndex) ? String(payload.chunkIndex) : "";
+  return [frame.event.type, frame.event.sessionId ?? "", frame.event.runId ?? "", chunk].join("|");
 }
 function defaultSocketFactory(url) {
   const WebSocketCtor = globalThis.WebSocket;
@@ -1655,6 +1659,10 @@ var HqPublisher = class {
     if (bytes > this.maxQueuedBytes) {
       this.droppedFrames += 1;
       this.droppedBytes += bytes;
+      process.emitWarning(
+        `HQ telemetry frame of ${bytes} bytes exceeds the ${this.maxQueuedBytes}-byte offline queue cap and was dropped.`,
+        { code: "WRONGSTACK_HQ_FRAME_TOO_LARGE" }
+      );
       return;
     }
     if (coalesceKey !== void 0) {
@@ -5086,6 +5094,7 @@ export {
   HqSimpleLog,
   HqSnapshotStore,
   HqTimeseriesStore,
+  MAX_HQ_KANBAN_BOARD_BYTES,
   appendHqAuthAudit,
   assessHqExposure,
   buildTranscriptFromEvents,
@@ -5134,6 +5143,7 @@ export {
   readHqAuthFile,
   readHqRuntimeFileSync,
   redactHqEvent,
+  redactHqEventPayload,
   redactHqValue,
   resolveHqConfig,
   resolveHqConfigFromEnv,

package/dist/hq/protocol/kanban.d.ts

@@ -1,3 +1,12 @@
+/**
+ * Largest single board record HQ will accept, in bytes of serialized board JSON.
+ *
+ * Exported because the sender has to know it. `isHqKanbanSnapshotPayload`
+ * rejects the *whole* snapshot when one board is over the limit, and the
+ * rejection is silent from the sender's point of view — so a publisher that
+ * does not check this first can lose every board in the chunk, permanently.
+ */
+export declare const MAX_HQ_KANBAN_BOARD_BYTES = 750000;
 export interface HqKanbanBoardRecord {
     boardId: string;
     revision: number;
@@ -16,6 +25,18 @@ export interface HqKanbanSnapshotPayload {
     generatedAt: string;
     boards: HqKanbanBoardRecord[];
     tombstones: HqKanbanTombstone[];
+    /**
+     * Position of this payload within a multi-part publish, present only when the
+     * publish was split. It exists so the offline frame queue can tell chunks of
+     * one snapshot apart from successive versions of the same snapshot — coalesce
+     * on `chunkIndex`, not on the event type alone, or every chunk but the last
+     * is evicted before the socket reconnects.
+     *
+     * Receivers do not need it: chunks are independent record sets, and each
+     * record carries its own revision.
+     */
+    chunkIndex?: number | undefined;
+    chunkCount?: number | undefined;
 }
 /** Server-to-client snapshot after HQ has merged all known project writers. */
 export interface HqServerKanbanSnapshotMessage {

package/dist/hq/protocol.js

@@ -86,7 +86,7 @@ var MAX_HQ_KANBAN_BOARD_BYTES = 75e4;
 function isHqKanbanSnapshotPayload(value) {
   if (typeof value !== "object" || value === null) return false;
   const payload = value;
-  if (typeof payload.projectId !== "string" || payload.projectId.length === 0 || typeof payload.generatedAt !== "string" || !Number.isFinite(Date.parse(payload.generatedAt)) || !Array.isArray(payload.boards) || !Array.isArray(payload.tombstones) || payload.boards.length > MAX_HQ_KANBAN_BOARDS || payload.tombstones.length > MAX_HQ_KANBAN_BOARDS) {
+  if (typeof payload.projectId !== "string" || payload.projectId.length === 0 || typeof payload.generatedAt !== "string" || !Number.isFinite(Date.parse(payload.generatedAt)) || !Array.isArray(payload.boards) || !Array.isArray(payload.tombstones) || payload.boards.length > MAX_HQ_KANBAN_BOARDS || payload.tombstones.length > MAX_HQ_KANBAN_BOARDS || !isOptionalChunkOrdinal(payload.chunkIndex) || !isOptionalChunkOrdinal(payload.chunkCount)) {
     return false;
   }
   const seen = /* @__PURE__ */ new Set();
@@ -100,6 +100,9 @@ function isHqKanbanSnapshotPayload(value) {
   }
   return true;
 }
+function isOptionalChunkOrdinal(value) {
+  return value === void 0 || Number.isSafeInteger(value) && value >= 0;
+}
 function isBoardRecord(value) {
   if (typeof value !== "object" || value === null) return false;
   const record = value;
@@ -673,6 +676,7 @@ export {
   HQ_RESUME_GAP_MAX_ENVELOPES,
   HQ_RESUME_GAP_MAX_STALE_MS,
   HQ_TRANSCRIPT_TEXT_CAP,
+  MAX_HQ_KANBAN_BOARD_BYTES,
   createHqEventEnvelope,
   isHqGovernanceSnapshotPayload,
   isHqKanbanSnapshotPayload,

package/dist/hq/redaction.d.ts

@@ -25,6 +25,20 @@ export declare function tightenHqRedactionPolicy(publisherPolicy: HqRedactionPol
  */
 export declare function scrubAndTruncateHqPreview(value: unknown, maxLength?: number): string | undefined;
 export declare function redactHqValue<T>(value: T, options?: HqRedactOptions): HqRedactionResult<T>;
+/**
+ * Redact a payload exactly as it would be redacted when published under `type`.
+ *
+ * Exported because a sender sometimes needs to know what will go on the wire
+ * before it commits to sending — the Kanban→HQ sync measures a board against
+ * HQ's per-board byte limit, and HQ drops an over-limit frame without a reply.
+ * That measurement has to run the SAME transform as the send, because the
+ * event type decides whether raw-content keys survive: `kanban.snapshot` is a
+ * project-state event and keeps them, while the generic `redactHqValue` path
+ * replaces them with a short marker. Measuring through the generic path made
+ * the estimate smaller than reality, so an oversized board could pass the check
+ * and still be rejected — the exact silent loss the check exists to prevent.
+ */
+export declare function redactHqEventPayload<TPayload>(type: string, payload: TPayload, options?: HqRedactOptions): HqRedactionResult<TPayload>;
 export declare function redactHqEvent<TPayload>(event: HqEventEnvelope<TPayload>, options?: HqRedactOptions): HqRedactionResult<HqEventEnvelope<TPayload>>;
 export declare function summarizeHqToolArgs(value: unknown, options?: HqRedactOptions): unknown;
 //# sourceMappingURL=redaction.d.ts.map

package/dist/index.d.ts

@@ -60,6 +60,7 @@ export { runProviderWithRetry } from './core/provider-runner.js';
 export { buildQueuedMessagesBlock, consumeQueuedMessagesUpdate, peekQueuedMessages, setQueuedMessagesSnapshot, } from './core/queued-messages.js';
 export { extractRunEnv, type RunEnv } from './core/run-env.js';
 export { DefaultSystemPromptBuilder, type DefaultSystemPromptBuilderOptions, LAYER_1_IDENTITY, SYSTEM_BLOCK_SOURCE, type SystemBlockSource, } from './core/system-prompt-builder.js';
+export { type DomainGlossary, type DomainGlossaryOptions, makeDomainGlossaryContributor, renderDomainGlossary, } from './core/system-prompt-glossary.js';
 export * from './defaults/index.js';
 export { AutoCompactionMiddleware, type CompactorOptions, type CompactorStrategy, createStrategyCompactor, HybridCompactor, IntelligentCompactor, type IntelligentCompactorOptions, installSubagentAutoCompaction, SelectiveCompactor, type SelectiveCompactorOptions, type StrategyCompactorOptions, } from './defaults/index.js';
 export { type AutonomyBrainOptions, type BrainAutoRisk, type BrainLlmTarget, buildBrainUserMessage, completeBrainLlm, createAutonomyBrain, createTieredBrainArbiter, formatDecisionSummary, parseOptionDecision, type TieredBrainArbiterOptions, } from './execution/autonomy-brain.js';