@plurnk/plurnk-service 0.4.0 → 0.6.0

package/bin/plurnk-service.js

@@ -7,7 +7,8 @@ import { fileURLToPath } from "node:url";
 import { dirname, resolve } from "node:path";
 import Daemon from "../src/server/Daemon.ts";
 import { parseEnvExample, formatFlagsHelp } from "../src/core/EnvFlags.ts";
-import { loadActiveProvider, resolveActiveAlias } from "../src/core/ProviderRegistry.ts";
+import { loadActiveProvider } from "../src/core/ProviderInstantiate.ts";
+import { resolveActiveAlias } from "@plurnk/plurnk-providers";
 
 const die = (code, message) => {
     process.stderr.write(`${message}\n`);

package/dist/core/ChannelWrite.d.ts

@@ -17,6 +17,11 @@ export interface WakeRunPayload {
     summary: string;
 }
 export type WakeRunNotify = (payload: WakeRunPayload) => void;
+export interface TelemetryEventPayload {
+    loopId: number;
+    event: object;
+}
+export type TelemetryEventNotify = (sessionId: number, payload: TelemetryEventPayload) => void;
 export declare const appendToChannel: (db: Db, { entryId, channel, chunk, notify }: {
     entryId: number;
     channel: string;

package/dist/core/ChannelWrite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChannelWrite.d.ts","sourceRoot":"","sources":["../../src/core/ChannelWrite.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,EAAE,EAAc,MAAM,SAAS,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAQvF,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAe9D,eAAO,MAAM,eAAe,GACxB,IAAI,EAAE,EACN,qCAAqC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,KACrH,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF,eAAO,MAAM,eAAe,GACxB,IAAI,EAAE,EACN,qCAAqC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,KAC3H,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF,eAAO,MAAM,gBAAgB,GACzB,IAAI,EAAE,EACN,oCAAoC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KACvG,OAAO,CAAC,MAAM,CAIhB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC1B,IAAI,EAAE,EACN,4BAA4B;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KACvE,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAC/B,IAAI,EAAE,EACN,oBAAoB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KACvD,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAG/D,CAAC"}
+{"version":3,"file":"ChannelWrite.d.ts","sourceRoot":"","sources":["../../src/core/ChannelWrite.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,EAAE,EAAc,MAAM,SAAS,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAQvF,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;AAQ9D,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAe/F,eAAO,MAAM,eAAe,GACxB,IAAI,EAAE,EACN,qCAAqC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,KACrH,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF,eAAO,MAAM,eAAe,GACxB,IAAI,EAAE,EACN,qCAAqC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,KAC3H,OAAO,CAAC,IAAI,CAOd,CAAC;AAEF,eAAO,MAAM,gBAAgB,GACzB,IAAI,EAAE,EACN,oCAAoC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KACvG,OAAO,CAAC,MAAM,CAIhB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC1B,IAAI,EAAE,EACN,4BAA4B;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KACvE,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAC/B,IAAI,EAAE,EACN,oBAAoB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KACvD,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAG/D,CAAC"}

package/dist/core/ChannelWrite.js.map

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

package/dist/core/Engine.d.ts

@@ -3,13 +3,13 @@ import type SchemeRegistry from "./SchemeRegistry.ts";
 import { Mimetypes } from "@plurnk/plurnk-mimetypes";
 import type { Db } from "./Db.ts";
 import type { LoopFlags } from "./scheme-types.ts";
-import type { StreamEventNotify, WakeRunNotify } from "./ChannelWrite.ts";
+import type { StreamEventNotify, TelemetryEventNotify, WakeRunNotify } from "./ChannelWrite.ts";
 type Origin = "model" | "client" | "system" | "plugin";
 type ChatMessage = {
     role: "system" | "user" | "assistant";
     content: string;
 };
-import type { Provider } from "./ProviderRegistry.ts";
+import type { Provider } from "@plurnk/plurnk-providers";
 type DispatchContext = {
     statement: PlurnkStatement;
     sessionId: number;
@@ -56,17 +56,19 @@ export declare const detectCycle: (history: ReadonlyArray<string>, minCycles: nu
 };
 export default class Engine {
     #private;
-    constructor({ db, schemes, mimetypes, streamEventNotify, wakeRunNotify }: {
+    constructor({ db, schemes, mimetypes, streamEventNotify, wakeRunNotify, telemetryEventNotify }: {
         db: Db;
         schemes: SchemeRegistry;
         mimetypes?: Mimetypes;
         streamEventNotify?: StreamEventNotify;
         wakeRunNotify?: WakeRunNotify;
+        telemetryEventNotify?: TelemetryEventNotify;
     });
-    runLoop({ provider, messages, persona, sessionId, runId, loopId, maxTurns, maxStrikes, minCycles, maxCyclePeriod, origin, signal, onDispatch, }: {
+    runLoop({ provider, messages, persona, requirements, sessionId, runId, loopId, maxTurns, maxStrikes, minCycles, maxCyclePeriod, origin, signal, onDispatch, }: {
         provider: Provider;
         messages: ChatMessage[];
         persona?: string;
+        requirements?: string;
         sessionId: number;
         runId: number;
         loopId: number;
@@ -83,10 +85,11 @@ export default class Engine {
         hitMaxTurns: boolean;
         reason: "max_turns" | "strike_threshold" | "external" | null;
     }>;
-    runTurn({ provider, messages, persona, sessionId, runId, loopId, origin, signal, onDispatch, turnNumber, maxTurns, }: {
+    runTurn({ provider, messages, persona, requirements, sessionId, runId, loopId, origin, signal, onDispatch, turnNumber, maxTurns, }: {
         provider: Provider;
         messages: ChatMessage[];
         persona?: string;
+        requirements?: string;
         sessionId: number;
         runId: number;
         loopId: number;

package/dist/core/Engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Engine.d.ts","sourceRoot":"","sources":["../../src/core/Engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Engine.d.ts","sourceRoot":"","sources":["../../src/core/Engine.ts"],"names":[],"mappings":"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"}

package/dist/core/Engine.js

@@ -1,18 +1,18 @@
-import { PlurnkParser } from "@plurnk/plurnk-grammar";
+import { PlurnkParser, PlurnkParseError } from "@plurnk/plurnk-grammar";
 import { Mimetypes, emptyRegistry } from "@plurnk/plurnk-mimetypes";
 import { writeEntry } from "../schemes/_entry-crud.js";
 import { DEFAULT_LOOP_FLAGS } from "./scheme-types.js";
-import { sliceLinesRaw } from "./line-marker.js";
-import { isBinaryMimetype } from "./mimetype-binary.js";
+import { sliceLinesRaw, isBinaryMimetype } from "@plurnk/plurnk-schemes";
 // Plain JS module shared with bin/digest.js so wire projection and
 // digest projection are structurally one function. tsconfig.build.json
 // has allowJs:true so this gets copied through to dist/.
 import { packetToWireMessages } from "./packet-wire.js";
-// SCHEMES.md §8: writer must be in target scheme's manifest.writableBy.
+// SPEC §3.6: writer must be in target scheme's manifest.writableBy.
 // SHOW/HIDE/READ/FIND are not gated — they touch visibility metadata or read.
 const MUTATING_OPS = new Set(["EDIT", "SEND", "COPY", "MOVE", "EXEC"]);
 const DEFAULT_PREVIEW_BUDGET = 256;
 const DEFAULT_MAX_STRIKES = 3;
+const DEFAULT_MAX_COMMANDS = 99;
 const readBudget = () => {
     const raw = process.env.PLURNK_ENTRY_SIZE_DEFAULT_TOKENS;
     if (raw === undefined || raw.length === 0)
@@ -31,8 +31,17 @@ const readMaxStrikes = () => {
         return DEFAULT_MAX_STRIKES;
     return n;
 };
+const readMaxCommands = () => {
+    const raw = process.env.PLURNK_MAX_COMMANDS;
+    if (raw === undefined || raw.length === 0)
+        return DEFAULT_MAX_COMMANDS;
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 1)
+        return DEFAULT_MAX_COMMANDS;
+    return n;
+};
 // Resolution timeout — proposed entries auto-cancel if nothing arrives
-// within this window. Per AGENTS.md §Phase E.2.
+// within this window. SPEC.md §0.5 (proposal lifecycle) + §13.5 (loop.resolve).
 const PROPOSAL_TIMEOUT_DEFAULT_MS = 300000;
 const readProposalTimeoutMs = () => {
     const raw = process.env.PLURNK_PROPOSAL_TIMEOUT_MS;
@@ -166,11 +175,10 @@ export default class Engine {
     // rails (cycle detection #39, etc.) — read and reset at end of each turn.
     // `history` holds per-turn fingerprints for rail #39 cycle detection.
     #strikeState = new Map();
-    // Proposal lifecycle (task #42): pending dispatch pauses waiting for
-    // resolution. Engine.runTurn awaits the promise when a scheme returns
-    // status 202; Engine.resolveProposal feeds the resolution back in. Map
-    // is per-log-entry-id; entries clear on resolution. See AGENTS.md
-    // §Phase E for the broader lifecycle plan.
+    // Proposal lifecycle: pending dispatch pauses waiting for resolution.
+    // Engine.runTurn awaits the promise when a scheme returns status 202;
+    // Engine.resolveProposal feeds the resolution back in. Map is per-log-
+    // entry-id; entries clear on resolution. SPEC.md §0.5 + §13.5 (loop.resolve).
     #pendingProposals = new Map();
     // External observers of proposal lifecycle events. Daemon subscribes
     // here to push `loop/proposal` notifications when an entry enters
@@ -186,11 +194,18 @@ export default class Engine {
     #loopAborts = new Map();
     #streamEventNotify;
     #wakeRunNotify;
-    constructor({ db, schemes, mimetypes, streamEventNotify, wakeRunNotify }) {
+    // Telemetry event fan-out: every TelemetryEvent pushed to the loop's
+    // buffer is also broadcast live to the connected client(s) on the
+    // session. Without this, the client sees `loop/terminated` with a
+    // status code but has no way to surface why the loop degraded.
+    // Per-grammar 0.17.0 protocol — see SPEC §15.1.
+    #telemetryEventNotify;
+    constructor({ db, schemes, mimetypes, streamEventNotify, wakeRunNotify, telemetryEventNotify }) {
         this.#db = db;
         this.#schemes = schemes;
         this.#streamEventNotify = streamEventNotify;
         this.#wakeRunNotify = wakeRunNotify;
+        this.#telemetryEventNotify = telemetryEventNotify;
         // Default to empty discovery — standalone Engine construction (in
         // tests) gets no handlers, and content flows through the framework's
         // raw-content fitContent fallback. Daemon-managed Engine receives a
@@ -200,12 +215,16 @@ export default class Engine {
         });
         this.#previewBudget = readBudget();
     }
-    #pushTelemetry(loopId, error) {
+    #pushTelemetry(sessionId, loopId, event) {
         const existing = this.#telemetryBuffer.get(loopId);
         if (existing === undefined)
-            this.#telemetryBuffer.set(loopId, [error]);
+            this.#telemetryBuffer.set(loopId, [event]);
         else
-            existing.push(error);
+            existing.push(event);
+        // Live fan-out: client sees the event the moment it lands in the
+        // model's buffer (not at the next packet build). Same envelope on
+        // both sides per the grammar 0.17.0 TelemetryEvent protocol.
+        this.#telemetryEventNotify?.(sessionId, { loopId, event });
     }
     #drainTelemetry(loopId) {
         const buf = this.#telemetryBuffer.get(loopId);
@@ -214,7 +233,28 @@ export default class Engine {
         this.#telemetryBuffer.delete(loopId);
         return buf;
     }
-    async runLoop({ provider, messages, persona = "", sessionId, runId, loopId, maxTurns = 50, maxStrikes = readMaxStrikes(), minCycles = readPositiveInt("PLURNK_MIN_CYCLES", DEFAULT_MIN_CYCLES), maxCyclePeriod = readPositiveInt("PLURNK_MAX_CYCLE_PERIOD", DEFAULT_MAX_CYCLE_PERIOD), origin = "model", signal, onDispatch, }) {
+    // Pull a ±windowLines context block around `targetLine` (1-based) from
+    // `content`, formatted with N:\t prefixes — same shape the model
+    // already knows from READ output and numbered Index entries. Used to
+    // give parse_error telemetry concrete locality: the model sees what
+    // it wrote on the offending line, not just an abstract error message.
+    //
+    // Lenient: targetLine ≤ 0 clamps to 1; targetLine beyond content
+    // returns whatever overlap exists; empty content returns "".
+    #extractSnippet(content, targetLine, windowLines) {
+        if (content.length === 0)
+            return "";
+        const lines = content.split("\n");
+        const target = Math.max(1, targetLine);
+        const start = Math.max(1, target - windowLines);
+        const end = Math.min(lines.length, target + windowLines);
+        const slice = [];
+        for (let i = start; i <= end; i++) {
+            slice.push(`${i}:\t${lines[i - 1] ?? ""}`);
+        }
+        return slice.join("\n");
+    }
+    async runLoop({ provider, messages, persona = "", requirements = "", sessionId, runId, loopId, maxTurns = 50, maxStrikes = readMaxStrikes(), minCycles = readPositiveInt("PLURNK_MIN_CYCLES", DEFAULT_MIN_CYCLES), maxCyclePeriod = readPositiveInt("PLURNK_MAX_CYCLE_PERIOD", DEFAULT_MAX_CYCLE_PERIOD), origin = "model", signal, onDispatch, }) {
         const turnIds = [];
         const suddenDeathThreshold = maxTurns - maxStrikes;
         // Per-loop AbortController for scheme-side cancellation propagation.
@@ -261,25 +301,23 @@ export default class Engine {
                 return { turnIds, finalStatus: 499, hitMaxTurns: true, reason: "max_turns" };
             }
             const turn = await this.runTurn({
-                provider, messages, persona, sessionId, runId, loopId, origin, signal, onDispatch,
+                provider, messages, persona, requirements, sessionId, runId, loopId, origin, signal, onDispatch,
                 turnNumber: turnIds.length + 1, maxTurns,
             });
             turnIds.push(turn.turnId);
             // Rail #39: cycle detection. Push this turn's fingerprint to
             // history, scan for repetition patterns. Detection bumps
-            // turnErrors so the strike system handles abandonment naturally.
+            // turnErrors so the strike system handles abandonment
+            // naturally — same internal-only role rummy gave it
+            // (plugins/error/error.js#verdict). Intentionally NOT a
+            // model-facing telemetry kind: model sees the strike pile-up
+            // (which IS the actionable signal); cycle is the engine's
+            // reason for treating the turn as a failure, not its own alert.
             const state = this.#strikeState.get(loopId) ?? { streak: 0, turnErrors: 0, history: [] };
             state.history.push(turn.fingerprint);
             const cycle = detectCycle(state.history, minCycles, maxCyclePeriod);
-            if (cycle.detected) {
+            if (cycle.detected)
                 state.turnErrors++;
-                this.#pushTelemetry(loopId, {
-                    kind: "cycle",
-                    period: cycle.period,
-                    cycles: cycle.cycles,
-                    message: "Loop detected",
-                });
-            }
             this.#strikeState.set(loopId, state);
             // Rail #38: strike accounting. Three sources strike a turn:
             //  1. recordedFailed — any action-entry at hard failure status
@@ -287,19 +325,19 @@ export default class Engine {
             //  2. noOps — turn.status === TURN_STATUS_NO_OPS (per #41).
             //  3. turnErrors — externally bumped by per-turn rails (#39 cycle).
             // Struck → streak++; clean → streak = 0. Threshold → abandon.
+            // Strike accounting is engine-internal bookkeeping. Per rummy
+            // precedent (plugins/error/error.js#verdict) and SPEC §15.1
+            // policy: model sees errors that happened (parse_error,
+            // action_failure), never the engine's accounting about them
+            // (strike counts, cycle detection, sudden-death threshold).
+            // Surfacing internal state to the model creates a gamification
+            // surface — model optimizes for engine metrics rather than
+            // task progress.
             const recordedFailed = turn.statuses.some((s) => s >= 400 && !SOFT_FAILURE_STATUSES.has(s));
             const noOps = turn.status === TURN_STATUS_NO_OPS;
             const struck = noOps || recordedFailed || state.turnErrors > 0;
             if (struck) {
                 state.streak++;
-                const reason = noOps ? "no_ops" : recordedFailed ? "recorded_failure" : "rail";
-                this.#pushTelemetry(loopId, {
-                    kind: "strike",
-                    streak: state.streak,
-                    maxStrikes,
-                    reason,
-                    message: `strike ${state.streak}/${maxStrikes} (${reason}); ${maxStrikes - state.streak} before abandonment`,
-                });
                 if (state.streak >= maxStrikes) {
                     await this.#db.engine_loop_cancel.run({ loop_id: loopId });
                     cleanup("forceful", "strike_threshold");
@@ -311,20 +349,15 @@ export default class Engine {
             }
             state.turnErrors = 0;
             this.#strikeState.set(loopId, state);
-            // Rail #40: sudden-death soft warning. When the loop enters the
-            // last maxStrikes-sized window before maxTurns, push a warning
-            // each turn so the model can wrap up before the hard cancel.
-            // Soft: no strike, no loop-status change. SPEC §15.1.
+            // Sudden-death threshold is engine-internal — abandonment
+            // happens at maxTurns regardless. Per gamification policy:
+            // we don't warn the model that it's nearing our limit.
             if (turnIds.length >= suddenDeathThreshold && turnIds.length < maxTurns) {
-                this.#pushTelemetry(loopId, {
-                    kind: "sudden_death",
-                    message: `${turnIds.length} of ${maxTurns}`,
-                    remaining: maxTurns - turnIds.length,
-                });
+                // Threshold tripped; engine bookkeeping only.
             }
         }
     }
-    async runTurn({ provider, messages, persona = "", sessionId, runId, loopId, origin = "model", signal, onDispatch, turnNumber = 1, maxTurns = 50, }) {
+    async runTurn({ provider, messages, persona = "", requirements = "", sessionId, runId, loopId, origin = "model", signal, onDispatch, turnNumber = 1, maxTurns = 50, }) {
         // === Turn-as-container model ===
         //
         // Turn rows are created at runTurn OPEN (status=102, placeholder
@@ -380,8 +413,8 @@ export default class Engine {
         // queries log_entries scoped to the run — the prompt entry just
         // written (if turn 1) is part of that query result.
         const requestPacket = await this.#buildRequestPacket({
-            initialMessages: messages, persona, runId, loopId,
-            turnNumber, currentTurnSeq: seq, maxTurns, provider,
+            initialMessages: messages, persona, requirements, runId, loopId,
+            currentTurnSeq: seq, provider,
         });
         const modelMessages = this.#packetToWireMessages(requestPacket);
         const response = await provider.generate({ messages: modelMessages, signal });
@@ -395,8 +428,23 @@ export default class Engine {
         // body starting with `//` being interpreted as xpath) silently
         // drop, the model sees zero ops dispatched, strike-rail fires,
         // model has no feedback on WHY its emission didn't take effect.
-        for (const message of parseErrors ?? []) {
-            this.#pushTelemetry(loopId, { kind: "parse_error", message });
+        //
+        // Envelope per @plurnk/plurnk-grammar 0.17.0 TelemetryEvent:
+        //   { source, kind, message, position: { type: "content-offset", line, column } }
+        // Plus a `snippet` field (additionalProperties) carrying ±N lines
+        // of the assistant's own content around the error line. Without
+        // the snippet, the model sees "invalid xpath at 1:0" but can't
+        // connect that to what IT wrote — and tends to regenerate the
+        // same broken emission. See edit-todo demo for the canonical case.
+        for (const { message, line, column, source } of parseErrors ?? []) {
+            this.#pushTelemetry(sessionId, loopId, {
+                source: "grammar",
+                kind: "parse_error",
+                message,
+                position: { type: "content-offset", line, column },
+                snippet: this.#extractSnippet(packetAssistant.content, line, 2),
+                parserSource: source,
+            });
         }
         const opsCount = packetAssistant.ops.length;
         const sendOp = packetAssistant.ops.findLast((op) => op.op === "SEND" && typeof op.signal === "number");
@@ -422,8 +470,19 @@ export default class Engine {
         });
         // Dispatch model ops starting at nextActionIndex (continues the
         // turn's running counter after any pre-model writes).
+        //
+        // Max-commands cap: a single emission with more than `maxCommands`
+        // ops is the runaway-loop fingerprint observed in pathological cases
+        // (html-attrs demo: 635 ops in one turn). Cap dispatches at the
+        // configured limit; overflow ops are dropped without per-op log
+        // entries (avoids bloating forensics with hundreds of identical refusals)
+        // and the model gets a single telemetry signal next packet so it knows
+        // its emission was truncated.
+        const maxCommands = readMaxCommands();
+        const opsToDispatch = packetAssistant.ops.slice(0, maxCommands);
+        const droppedCount = opsCount - opsToDispatch.length;
         const statuses = [];
-        for (const [i, statement] of packetAssistant.ops.entries()) {
+        for (const [i, statement] of opsToDispatch.entries()) {
             const result = await this.dispatch({
                 statement, sessionId, runId, loopId, turnId,
                 sequence: nextActionIndex + i,
@@ -431,23 +490,30 @@ export default class Engine {
             });
             statuses.push(result.status);
         }
-        if (opsCount === 0) {
-            // Rail #41 (revised): per-turn requirement is "emit at least one
-            // op." Zero ops = actionless failure. SEND specifically is not
-            // required — any of the 9 grammar ops satisfies. Pushed AFTER
-            // #buildPacket so this turn's drain doesn't consume it.
-            this.#pushTelemetry(loopId, {
-                kind: "no_ops",
-                message: "turn ended without emitting any op; emit at least one operation per turn",
+        // max_commands_exceeded IS model-facing: dropped ops are things
+        // the model emitted that didn't run — it needs to know. Engine
+        // bookkeeping (the cap value, our threshold reasoning) stays
+        // internal; only the facts of what happened are reported.
+        if (droppedCount > 0) {
+            this.#pushTelemetry(sessionId, loopId, {
+                source: "engine:rail",
+                kind: "max_commands_exceeded",
+                emitted: opsCount,
+                dropped: droppedCount,
             });
         }
+        // Zero ops is NOT an error to report — the model knows it emitted
+        // nothing. Strike accounting (engine-internal) treats it as a
+        // struck turn; the model just sees an empty packet next turn.
+        // Per SPEC §15.1 gamification policy.
         return { turnId, status: turnStatus, statuses, fingerprint: fingerprintTurn(packetAssistant.ops) };
     }
     // Split the wire-level ProviderResponse into the two destinations:
     // packet.assistant gets the model's emission (content, ops, reasoning);
     // Turn columns get the call-metadata (usage, finishReason, model).
-    // PROVIDERS.md §3.3 text-fragment scraping policy lives here — engine
-    // owns the parse and the scraping rule, providers stay grammar-unaware.
+    // SPEC §2.1 / plurnk-providers#1: text-fragment scraping policy lives
+    // here — engine owns the parse and the scraping rule, providers stay
+    // grammar-unaware.
     //
     // Test-fixture escape hatch: the Mock provider may pre-supply `ops` on
     // its assistant payload to skip the parse roundtrip. The wire Provider
@@ -458,6 +524,10 @@ export default class Engine {
         const preParsedOps = assistant.ops;
         const ops = [];
         const textFragments = [];
+        // Full PlurnkParseError context (line/column/source) is preserved
+        // here so runTurn can build TelemetryEvent envelopes per the
+        // grammar 0.17.0 protocol — model needs position info to locate
+        // its own offending content on the next turn.
         const parseErrors = [];
         if (preParsedOps !== undefined) {
             ops.push(...preParsedOps);
@@ -474,8 +544,13 @@ export default class Engine {
                 }
                 else if (item.kind === "error") {
                     const err = item.error;
-                    const msg = (err && typeof err.message === "string") ? err.message : "parse error";
-                    parseErrors.push(msg);
+                    if (err instanceof PlurnkParseError) {
+                        parseErrors.push({ message: err.message, line: err.line, column: err.column, source: err.source });
+                    }
+                    else {
+                        const msg = err?.message ?? "parse error";
+                        parseErrors.push({ message: msg, line: 0, column: 0, source: "parser" });
+                    }
                 }
             }
         }
@@ -493,10 +568,7 @@ export default class Engine {
     // and §user) BEFORE the provider call. The same packet object is then
     // completed with assistant + assistantRaw after the model responds, so
     // the stored packet and the wire payload share one source of truth.
-    // Per Packet.json: user.prompt is "Copy of loop.prompt — never null on
-    // a continuation turn"; the turn-N-of-M continuation marker rides on
-    // user.system_requirements (per-turn rules), NOT a mutated prompt.
-    async #buildRequestPacket({ initialMessages, persona: defaultPersona, runId, loopId, turnNumber, currentTurnSeq, maxTurns, provider, }) {
+    async #buildRequestPacket({ initialMessages, persona: defaultPersona, requirements, runId, loopId, currentTurnSeq, provider, }) {
         const byRole = (role) => initialMessages.filter((m) => m.role === role).map((m) => m.content).join("\n\n");
         const system_definition = byRole("system");
         // user.prompt sources from the loop's most recent prompt entry first
@@ -516,13 +588,6 @@ export default class Engine {
         const index = await this.#buildIndex(runId, loopId);
         const log = await this.#buildLog(runId);
         const telemetryErrors = await this.#buildTelemetryErrors(loopId, currentTurnSeq);
-        // Rummy AgentLoop.js #buildContinuationPrompt: literally
-        // `Turn ${turn}/${maxTurns}`. That's the whole string. The model
-        // can read the action log to see what it already did; it does
-        // not need editorial instructions from us about not repeating.
-        const system_requirements = turnNumber > 1
-            ? `Turn ${turnNumber}/${maxTurns}`
-            : "";
         // Per-section render-cost subtotals via provider's tokenizer.
         // Engine approximates each section by tokenizing its serialized
         // form — wire-payload tokens may differ slightly because chat-
@@ -533,13 +598,13 @@ export default class Engine {
             provider.countTokens(JSON.stringify(index)) +
             provider.countTokens(JSON.stringify(log));
         // user.telemetry.budget — shimmed with section-aggregate table.
-        // Real per-scheme breakdown is on AGENTS.md TODO (provider doesn't
-        // yet expose getContextSize; user-side token count is below).
-        const budget = this.#renderBudgetShim(systemTokens, provider, prompt, system_requirements, telemetryErrors);
+        // Real per-scheme breakdown is the tokenomics chapter (SPEC.md §14.2);
+        // depends on provider.getContextSize and write-time per-row tokens.
+        const budget = this.#renderBudgetShim(systemTokens, provider, prompt, telemetryErrors);
         const userTokens = provider.countTokens(prompt) +
-            provider.countTokens(system_requirements) +
             provider.countTokens(JSON.stringify(telemetryErrors)) +
-            provider.countTokens(budget);
+            provider.countTokens(budget) +
+            provider.countTokens(requirements);
         return {
             system: {
                 tokens: systemTokens,
@@ -552,20 +617,19 @@ export default class Engine {
                 tokens: userTokens,
                 prompt,
                 telemetry: { budget, errors: telemetryErrors },
-                system_requirements,
+                system_requirements: requirements,
             },
         };
     }
-    // user.telemetry.budget — SHIM. Per AGENTS.md §Open: real per-scheme
-    // breakdown + context-window "free/percent-of-total" awaits provider
-    // contract additions (getContextSize). Until then, render the section-
-    // aggregate counts we already compute so the wire's `# Plurnk System
-    // Budget` section is non-empty for picking-apart purposes.
-    #renderBudgetShim(systemTokens, provider, prompt, system_requirements, telemetryErrors) {
+    // user.telemetry.budget — SHIM. Real per-scheme breakdown +
+    // context-window "free/percent-of-total" is SPEC.md §14.2; depends on
+    // provider.getContextSize and write-time per-row tokens. Until then,
+    // render the section-aggregate counts we already compute so the wire's
+    // `# Plurnk System Budget` section is non-empty for picking-apart purposes.
+    #renderBudgetShim(systemTokens, provider, prompt, telemetryErrors) {
         const userPromptTokens = provider.countTokens(prompt);
-        const userReqTokens = provider.countTokens(system_requirements);
         const userErrTokens = provider.countTokens(JSON.stringify(telemetryErrors));
-        const userTokens = userPromptTokens + userReqTokens + userErrTokens;
+        const userTokens = userPromptTokens + userErrTokens;
         const total = systemTokens + userTokens;
         const pct = (n) => total === 0 ? "0.0%" : `${((n / total) * 100).toFixed(1)}%`;
         return [
@@ -618,7 +682,7 @@ export default class Engine {
                 op: r.op,
                 target,
                 status: r.status_rx,
-                message: typeof parsedRx === "object" && parsedRx !== null && "error" in parsedRx
+                error: typeof parsedRx === "object" && parsedRx !== null && "error" in parsedRx
                     ? parsedRx.error
                     : typeof parsedRx === "string" ? parsedRx : "",
             };
@@ -738,7 +802,7 @@ export default class Engine {
             result = denial;
         }
         else {
-            // SCHEMES.md §7.1 / §8: action-entry-as-outcome. Scheme-handler
+            // SPEC §3.6 + plurnk-schemes#1: action-entry-as-outcome. Scheme-handler
             // exceptions become the action-entry's outcome (status 500), not a
             // thrown bubble. The log_entry is the durable record; engine never
             // skips it. Logging failures (#writeLog throws) are NOT caught —
@@ -773,13 +837,13 @@ export default class Engine {
         }
         const logEntryId = await this.#writeLog({ statement, result, runId, loopId, turnId, sequence, origin });
         onDispatch?.(logEntryId);
-        // Proposal lifecycle (task #42, AGENTS.md §Phase E). When a scheme
-        // returns status 202, the entry is written as state='proposed';
+        // Proposal lifecycle (SPEC.md §0.5 + §13.5 loop.resolve). When a
+        // scheme returns status 202, the entry is written as state='proposed';
         // dispatch then PAUSES on a per-entry waiter until resolution
         // arrives via Engine.resolveProposal (from the loop/resolve RPC,
-        // YOLO listener, or timeout — Phase E.2/E.3 work). The post-
-        // resolution status replaces 202 in the result the caller sees,
-        // so runTurn never branches on a pending state.
+        // YOLO listener, or timeout). The post-resolution status replaces
+        // 202 in the result the caller sees, so runTurn never branches on
+        // a pending state.
         if (result.status === 202) {
             // Register the resolution waiter SYNCHRONOUSLY before any await
             // yields. A same-tick resolveProposal() (e.g. from a test that
@@ -1007,8 +1071,8 @@ export default class Engine {
         });
         return { status, outcome, body: resolution.body };
     }
-    // SCHEMES.md §8 {§8-writable-by-enforcement}: engine rejects writes whose
-    // origin is outside the target scheme's manifest.writableBy.
+    // SPEC §3.6: engine rejects writes whose origin is outside the target
+    // scheme's manifest.writableBy.
     // - Read-side ops (READ, FIND, SHOW, HIDE) are not gated.
     // - SEND broadcast (path=null) has no target scheme; not gated.
     // - COPY: dst scheme writableBy applies.
@@ -1154,8 +1218,8 @@ export default class Engine {
                 return { status: 415, error: `mimetype mismatch on channel '${channelName}': ${channelData.mimetype} vs ${expectedMimetype}` };
             }
         }
-        // `<L>` source range slicing per AGENTS.md "Resolved ambiguities" §4
-        // (symmetric with READ `<L>` — source range, no line-number prefix).
+        // `<L>` source range slicing per SPEC.md §16.9 (symmetric with READ
+        // `<L>` — source range, no line-number prefix).
         // Applied to every channel of the source entry. Binary channels return
         // 415 since line semantics don't apply.
         const lineMarker = statement.lineMarker ?? null;
@@ -1225,9 +1289,36 @@ export default class Engine {
         // consumes on accept. All other statuses are terminal — state =
         // 'resolved' for the common case.
         const isProposed = result.status === 202;
-        const attrs = (result.attrs !== undefined && result.attrs !== null)
-            ? JSON.stringify(result.attrs)
-            : "{}";
+        let attrsObj = (result.attrs !== undefined && result.attrs !== null)
+            ? { ...result.attrs }
+            : {};
+        // EXEC pathname is coordinate-based — the stream entry lives at
+        // exec://<loop_seq>/<turn_seq>/<sequence>/EXEC, mirroring the log
+        // row's own URI at log://<...>/EXEC. The model can correlate the
+        // log meta to its stream output by structural parallelism — no
+        // random slug injection. Coordinate is resolved here because both
+        // log row write and applyResolution need it.
+        if (statement.op === "EXEC") {
+            const seqs = await this.#db.engine_loop_turn_seqs.get({
+                loop_id: loopId, turn_id: turnId,
+            });
+            if (seqs === undefined)
+                throw new Error(`Engine.#writeLog: loop_turn_seqs returned no row for loop=${loopId} turn=${turnId}`);
+            const coordPathname = `${seqs.loop_seq}/${seqs.turn_seq}/${sequence}/EXEC`;
+            target.scheme = "exec";
+            target.pathname = coordPathname;
+            attrsObj.pathname = coordPathname;
+            // Mutate the in-memory result.attrs too: the dispatch path
+            // hands originalResult.attrs to handler.applyResolution after
+            // proposal accept (see #acceptResolution). Both views — the
+            // stored row AND the in-memory proposal — need the same
+            // coordinate-based pathname so applyResolution writes the
+            // entry at exec://<coord>/EXEC.
+            if (result.attrs !== undefined && result.attrs !== null) {
+                result.attrs.pathname = coordPathname;
+            }
+        }
+        const attrs = JSON.stringify(attrsObj);
         const row = await this.#db.engine_insert_log_entry.get({
             run_id: runId,
             loop_id: loopId,