@ouro.bot/cli 0.1.0-alpha.197 → 0.1.0-alpha.199

package/changelog.json

@@ -1,6 +1,12 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.199",
+      "changes": [
+        "refactor: rename wake packet to start-of-turn packet across codebase (types, modules, events, tests)"
+      ]
+    },
     {
       "version": "0.1.0-alpha.197",
       "changes": [

package/dist/heart/active-work.js

@@ -670,7 +670,7 @@ function formatActiveWorkFrame(frame, options) {
             // Enriched obligation data (with resumeHint, stalenessClass, waitingOn) is rendered elsewhere.
             // Avoid duplicating the full list — just anchor the count here.
             lines.push("");
-            lines.push(`return obligations: ${openCount} active (canonical details in **Owed** section of wake packet)`);
+            lines.push(`return obligations: ${openCount} active (canonical details in **Owed** section of start-of-turn packet)`);
         }
         else if (openCount > 0) {
             lines.push("");

package/dist/heart/{wake-packet.js → start-of-turn-packet.js}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildWakePacket = buildWakePacket;
-exports.renderWakePacket = renderWakePacket;
-exports.renderCompactWakePacket = renderCompactWakePacket;
+exports.buildStartOfTurnPacket = buildStartOfTurnPacket;
+exports.renderStartOfTurnPacket = renderStartOfTurnPacket;
+exports.renderCompactStartOfTurnPacket = renderCompactStartOfTurnPacket;
 const runtime_1 = require("../nerves/runtime");
 const tempo_1 = require("./tempo");
 function estimateTokens(text) {
@@ -87,7 +87,7 @@ function buildResumeHint(view, obligations) {
         return "";
     return hints.join("; ");
 }
-function buildWakePacket(view, opts) {
+function buildStartOfTurnPacket(view, opts) {
     const tempo = view.tempo;
     const tokenBudget = tempo_1.TEMPO_BUDGETS[tempo];
     const effectiveObligations = opts?.canonicalObligations ? opts.canonicalObligations.all : view.activeObligations;
@@ -103,8 +103,8 @@ function buildWakePacket(view, opts) {
     };
     (0, runtime_1.emitNervesEvent)({
         component: "heart",
-        event: "heart.wake_packet_built",
-        message: `wake packet built: tempo=${tempo}`,
+        event: "heart.start_of_turn_packet_built",
+        message: `start-of-turn packet built: tempo=${tempo}`,
         meta: {
             tempo,
             plotLineTokens: estimateTokens(packet.plotLine),
@@ -117,13 +117,13 @@ function buildWakePacket(view, opts) {
     return packet;
 }
 /**
- * Renders a wake packet to prompt text, respecting token budget.
+ * Renders a start-of-turn packet to prompt text, respecting token budget.
  * Truncation priority (last truncated first):
  *   resumeHint (PROTECTED) > obligations > cares > plotLine > presence
  * So presence is truncated first, then plotLine, then cares, then obligations.
  * resumeHint is never truncated.
  */
-function renderWakePacket(packet) {
+function renderStartOfTurnPacket(packet) {
     const budget = packet.tokenBudget;
     // Assemble sections in priority order (highest priority first for budget allocation)
     // Each section is { label, content, priority } where lower priority number = truncated first
@@ -137,8 +137,8 @@ function renderWakePacket(packet) {
     if (sections.length === 0) {
         (0, runtime_1.emitNervesEvent)({
             component: "heart",
-            event: "heart.wake_packet_rendered",
-            message: "wake packet rendered: empty",
+            event: "heart.start_of_turn_packet_rendered",
+            message: "start-of-turn packet rendered: empty",
             meta: { tokens: 0, tempo: packet.tempo },
         });
         return "";
@@ -167,8 +167,8 @@ function renderWakePacket(packet) {
     }
     (0, runtime_1.emitNervesEvent)({
         component: "heart",
-        event: "heart.wake_packet_rendered",
-        message: `wake packet rendered: ${tokens} tokens`,
+        event: "heart.start_of_turn_packet_rendered",
+        message: `start-of-turn packet rendered: ${tokens} tokens`,
         meta: { tokens, tempo: packet.tempo, sectionCount: sections.length },
     });
     return rendered;
@@ -200,7 +200,7 @@ function formatSections(sections) {
  * Ultra-compact version for coding context (max 200 tokens).
  * Just resumeHint + top obligation + top care, single-line bullets.
  */
-function renderCompactWakePacket(packet) {
+function renderCompactStartOfTurnPacket(packet) {
     const parts = [];
     if (packet.resumeHint) {
         parts.push(`next: ${packet.resumeHint}`);
@@ -220,8 +220,8 @@ function renderCompactWakePacket(packet) {
     const result = compact.length > maxChars ? compact.slice(0, maxChars) : compact;
     (0, runtime_1.emitNervesEvent)({
         component: "heart",
-        event: "heart.wake_packet_compact_rendered",
-        message: `compact wake packet: ${estimateTokens(result)} tokens`,
+        event: "heart.start_of_turn_packet_compact_rendered",
+        message: `compact start-of-turn packet: ${estimateTokens(result)} tokens`,
         meta: { tokens: estimateTokens(result) },
     });
     return result;

package/dist/mind/prompt.js

@@ -39,7 +39,7 @@ exports.bodyMapSection = bodyMapSection;
 exports.mcpToolsSection = mcpToolsSection;
 exports.runtimeInfoSection = runtimeInfoSection;
 exports.toolRestrictionSection = toolRestrictionSection;
-exports.wakePacketSection = wakePacketSection;
+exports.startOfTurnPacketSection = startOfTurnPacketSection;
 exports.centerOfGravitySteeringSection = centerOfGravitySteeringSection;
 exports.commitmentsSection = commitmentsSection;
 exports.delegationHintSection = delegationHintSection;
@@ -516,13 +516,13 @@ function bridgeContextSection(options) {
         return "";
     return bridgeContext.startsWith("## ") ? bridgeContext : `## active bridge work\n${bridgeContext}`;
 }
-function wakePacketSection(options) {
-    return options?.wakePacket ?? "";
+function startOfTurnPacketSection(options) {
+    return options?.startOfTurnPacket ?? "";
 }
 function activeWorkSection(options) {
     if (!options?.activeWorkFrame)
         return "";
-    return (0, active_work_1.formatActiveWorkFrame)(options.activeWorkFrame, { obligationDetailsRenderedElsewhere: !!options?.wakePacket });
+    return (0, active_work_1.formatActiveWorkFrame)(options.activeWorkFrame, { obligationDetailsRenderedElsewhere: !!options?.startOfTurnPacket });
 }
 function liveWorldStateSection(options) {
     if (!options?.activeWorkFrame)
@@ -544,8 +544,8 @@ function familyCrossSessionTruthSection(context, options) {
         return "";
     if (context?.friend?.trustLevel !== "family")
         return "";
-    // When wake packet is present, compress to one line
-    if (options?.wakePacket) {
+    // When start-of-turn packet is present, compress to one line
+    if (options?.startOfTurnPacket) {
         return "When family asks whole-self status, answer from the cross-session picture above.";
     }
     return `## cross-session truth
@@ -1070,7 +1070,7 @@ async function buildSystem(channel = "cli", options, context) {
         ] : []),
         // Group 7: dynamic state for this turn
         "# dynamic state for this turn",
-        wakePacketSection(options),
+        startOfTurnPacketSection(options),
         liveWorldStateSection(options),
         pendingMessagesSection(options),
         activeWorkSection(options),

package/dist/repertoire/coding/context-pack.js

@@ -224,7 +224,7 @@ function buildScopeContent(request, contextFiles, skills, agentName) {
         formatSkills(skills),
     ].join("\n");
 }
-function buildStateContent(request, contextKey, generatedAt, snapshot, existingSessions, agentName, identityPacket, activeWorkFrame, wakePacket) {
+function buildStateContent(request, contextKey, generatedAt, snapshot, existingSessions, agentName, identityPacket, activeWorkFrame, startOfTurnPacket) {
     const gitSection = snapshot.available
         ? [
             `repoRoot: ${snapshot.repoRoot ?? "unknown"}`,
@@ -241,7 +241,7 @@ function buildStateContent(request, contextKey, generatedAt, snapshot, existingS
         `agent: ${request.parentAgent ?? agentName}`,
         formatOrigin(request),
         `obligationId: ${request.obligationId ?? "none"}`,
-        ...(wakePacket ? ["", "## Continuity", wakePacket] : []),
+        ...(startOfTurnPacket ? ["", "## Continuity", startOfTurnPacket] : []),
         "",
         formatIdentitySection(identityPacket),
         "",
@@ -281,7 +281,7 @@ function prepareCodingContextPack(input, deps = {}) {
     const generatedAt = nowIso();
     const identityPacket = buildIdentityPacket(snapshot, input.request);
     const scopeContent = buildScopeContent(input.request, contextFiles, skills, agentName);
-    const stateContent = buildStateContent(input.request, contextKey, generatedAt, snapshot, existingSessions, agentName, identityPacket, input.activeWorkFrame, input.wakePacket || undefined);
+    const stateContent = buildStateContent(input.request, contextKey, generatedAt, snapshot, existingSessions, agentName, identityPacket, input.activeWorkFrame, input.startOfTurnPacket || undefined);
     mkdirSync(contextDir, { recursive: true });
     writeFileSync(scopeFile, `${scopeContent}\n`, "utf-8");
     writeFileSync(stateFile, `${stateContent}\n`, "utf-8");
@@ -310,7 +310,7 @@ function prepareCodingContextPack(input, deps = {}) {
 }
 /**
  * Emit a coding milestone episode when a session completes or blocks.
- * This is the outbound leg of the coding round-trip: compact wake packet goes IN,
+ * This is the outbound leg of the coding round-trip: compact start-of-turn packet goes IN,
  * episodes come BACK OUT.
  */
 function emitCodingEpisode(agentRoot, session, outcome) {

package/dist/senses/pipeline.js

@@ -61,7 +61,7 @@ const provider_ping_1 = require("../heart/provider-ping");
 const auth_flow_1 = require("../heart/daemon/auth-flow");
 const tempo_1 = require("../heart/tempo");
 const temporal_view_1 = require("../heart/temporal-view");
-const wake_packet_1 = require("../heart/wake-packet");
+const start_of_turn_packet_1 = require("../heart/start-of-turn-packet");
 const presence_1 = require("../heart/presence");
 const episodes_1 = require("../mind/episodes");
 const cares_1 = require("../heart/cares");
@@ -457,8 +457,8 @@ async function handleInboundTurn(input) {
     for (const msg of input.messages) {
         sessionMessages.push(msg);
     }
-    // Step 4b: Continuity pipeline — derive tempo, build wake packet, snapshot obligations
-    let renderedWakePacket;
+    // Step 4b: Continuity pipeline — derive tempo, build start-of-turn packet, snapshot obligations
+    let renderedStartOfTurnPacket;
     const preTurnObligationIds = new Set(pendingObligations.map((ob) => `${ob.id}:${ob.status}`));
     try {
         const agentRoot = (0, identity_1.getAgentRoot)();
@@ -485,15 +485,15 @@ async function handleInboundTurn(input) {
                 activeCares,
             },
         });
-        const wakePacket = (0, wake_packet_1.buildWakePacket)(temporalView, {
+        const startOfTurnPacket = (0, start_of_turn_packet_1.buildStartOfTurnPacket)(temporalView, {
             canonicalObligations: {
                 primary: activeWorkFrame.primaryObligation,
                 all: activeWorkFrame.pendingObligations,
             },
         });
-        renderedWakePacket = (0, wake_packet_1.renderWakePacket)(wakePacket);
-        if (!renderedWakePacket)
-            renderedWakePacket = undefined;
+        renderedStartOfTurnPacket = (0, start_of_turn_packet_1.renderStartOfTurnPacket)(startOfTurnPacket);
+        if (!renderedStartOfTurnPacket)
+            renderedStartOfTurnPacket = undefined;
         // Update self-presence
         const presence = (0, presence_1.derivePresence)(agentRoot, agentName, {
             activeSessions: sessionActivity.length + 1,
@@ -509,7 +509,7 @@ async function handleInboundTurn(input) {
             level: "warn",
             component: "senses",
             event: "senses.continuity_error",
-            message: "continuity pipeline failed, continuing without wake packet",
+            message: "continuity pipeline failed, continuing without start-of-turn packet",
             meta: { error: continuityError instanceof Error ? continuityError.message : String(continuityError) },
         });
     }
@@ -520,7 +520,7 @@ async function handleInboundTurn(input) {
         bridgeContext,
         activeWorkFrame,
         delegationDecision,
-        wakePacket: renderedWakePacket,
+        startOfTurnPacket: renderedStartOfTurnPacket,
         pendingMessages: pending.length > 0 ? pending.map((msg) => ({ from: msg.from, content: msg.content })) : undefined,
         currentSessionKey: currentSession.key,
         currentObligation,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.197",
+  "version": "0.1.0-alpha.199",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",