@rulvar/planner 1.1.0 → 1.2.0

package/dist/{compile-CfWgGVyz.js → compile-BtCY9wfO.js}

@@ -1,7 +1,7 @@
 import { ScriptRejected } from "@rulvar/core";
 //#region src/compile.ts
 /**
-* The exact curated sandbox global set, in docs order (docs/06, 8.2).
+* The exact curated sandbox global set, in canonical order.
 * The worker binds the ctx methods as bare globals under these names and
 * the API card teaches exactly this list.
 */
@@ -165,11 +165,11 @@ function scanImports(source, blanked, allowImports) {
 	return diagnostics;
 }
 /**
-* Validates and compiles planner-generated source into a CompiledWorkflow
-* (docs/06, 8.3). The source is an async function body over the sandbox
+* Validates and compiles planner-generated source into a CompiledWorkflow.
+* The source is an async function body over the sandbox
 * globals; its `return` value is the workflow result. The compiled form is
 * pure data (the source is evaluated only inside the worker sandbox);
-* machine scripts run under errorPolicy 'lenient' (docs/06, Appendix A).
+* machine scripts run under errorPolicy 'lenient'.
 */
 function compileScript(source, o) {
 	const allowImports = o?.allowImports ?? [];

package/dist/index.d.ts

@@ -2,12 +2,12 @@ import { CompiledWorkflow, Ctx, Engine, InMemoryStore, JournalEntry, Json, Model
 
 //#region src/compile.d.ts
 /**
-* The exact curated sandbox global set, in docs order (docs/06, 8.2).
+* The exact curated sandbox global set, in canonical order.
 * The worker binds the ctx methods as bare globals under these names and
 * the API card teaches exactly this list.
 */
 declare const SANDBOX_GLOBALS: readonly string[];
-/** One machine-readable compileScript diagnostic (docs/02, ScriptRejected row). */
+/** One machine-readable compileScript diagnostic (carried by ScriptRejected). */
 interface ScriptDiagnostic {
   ruleId: string;
   message: string;
@@ -19,11 +19,11 @@ interface CompileScriptOptions {
   allowImports?: string[];
 }
 /**
-* Validates and compiles planner-generated source into a CompiledWorkflow
-* (docs/06, 8.3). The source is an async function body over the sandbox
+* Validates and compiles planner-generated source into a CompiledWorkflow.
+* The source is an async function body over the sandbox
 * globals; its `return` value is the workflow result. The compiled form is
 * pure data (the source is evaluated only inside the worker sandbox);
-* machine scripts run under errorPolicy 'lenient' (docs/06, Appendix A).
+* machine scripts run under errorPolicy 'lenient'.
 */
 declare function compileScript(source: string, o?: CompileScriptOptions): CompiledWorkflow;
 /** Typed accessor for the diagnostics carried on a ScriptRejected. */
@@ -56,7 +56,7 @@ interface PlanResult {
   /** Diagnostics of the ACCEPTED draft: advisories only, never errors. */
   lint: PlanDiagnostic[];
 }
-/** The deterministic planner runId: one goal, one journal (docs/06, 9.2). */
+/** The deterministic planner runId: one goal, one journal. */
 declare function planRunIdOf(goal: string): string;
 /**
 * The model may fence the script; the extractor takes the first fenced
@@ -76,7 +76,7 @@ declare function lintScript(source: string): {
 };
 declare function plan(engine: Engine, goal: string, o?: PlanOptions): Promise<PlanResult>;
 /**
-* plan-then-run in one call (docs/06, section 9; amended during M6-T05:
+* plan-then-run in one call (amended during M6-T05:
 * the composition is async because planning itself is a run).
 */
 declare function runPlanned(engine: Engine, goal: string, args?: Json): Promise<RunHandle<unknown>>;
@@ -141,7 +141,7 @@ interface WorkerSandboxRunnerOptions {
   */
   workerUrl?: URL;
 }
-/** Accepts CompiledWorkflow ONLY: feeding a closure is a type error (docs/06, 8). */
+/** Accepts CompiledWorkflow ONLY: feeding a closure is a type error. */
 declare class WorkerSandboxRunner implements ScriptRunner {
   private readonly timeoutMs;
   private readonly memoryMb;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as compileScript, r as scriptDiagnosticsOf, t as SANDBOX_GLOBALS } from "./compile-CfWgGVyz.js";
+import { n as compileScript, r as scriptDiagnosticsOf, t as SANDBOX_GLOBALS } from "./compile-BtCY9wfO.js";
 import { ConfigError, InMemoryStore, SandboxError, ScriptRejected, createEngine, createSandboxBridge, defineWorkflow, toJournalValue } from "@rulvar/core";
 import { createHash } from "node:crypto";
 import { Linter } from "eslint";
@@ -7,7 +7,7 @@ import { MessageChannel, Worker } from "node:worker_threads";
 //#region src/api-card.ts
 /**
 * The API card (M6-T04): teaches the planner model EXACTLY the sandbox
-* dialect and global set (docs/06, sections 8.2 and 8.3). The card is a
+* dialect and global set. The card is a
 * pure constant, byte-stable across runs; plan() (M6-T05) composes it
 * with profileCard(registry) and the goal. The usage examples are
 * distilled from the runnable examples/ corpus (M5-T09).
@@ -61,7 +61,7 @@ function apiCard() {
 //#region src/plan.ts
 /**
 * The plan agent and the self-repair loop (M6-T05): mode (b), the
-* flagship hybrid (docs/06, section 9.2). plan() asks a planner model
+* flagship hybrid. plan() asks a planner model
 * (role 'plan') to write a script against the API card and the profile
 * card, lints it with eslint-plugin-rulvar, self-repairs up to
 * repairRounds rounds from the JSON diagnostics, and compiles the
@@ -72,7 +72,7 @@ function apiCard() {
 * against the same store REPLAYS the unchanged prefix for free
 * (invariant I1; the M6-T05 acceptance).
 */
-/** The deterministic planner runId: one goal, one journal (docs/06, 9.2). */
+/** The deterministic planner runId: one goal, one journal. */
 function planRunIdOf(goal) {
 	return `plan-${createHash("sha256").update(goal, "utf8").digest("hex").slice(0, 24)}`;
 }
@@ -205,7 +205,7 @@ async function plan(engine, goal, o) {
 	};
 }
 /**
-* plan-then-run in one call (docs/06, section 9; amended during M6-T05:
+* plan-then-run in one call (amended during M6-T05:
 * the composition is async because planning itself is a run).
 */
 async function runPlanned(engine, goal, args) {
@@ -218,19 +218,19 @@ async function runPlanned(engine, goal, args) {
 * WorkerSandboxRunner (M6-T02): the mandatory runner for machine-generated
 * scripts, mode (b). Owns the worker lifecycle and the dedicated
 * MessageChannel; every primitive call is served by the core sandbox
-* bridge against the canonical run ctx (docs/06, 8.2).
+* bridge against the canonical run ctx.
 *
 * Port lifecycle: one channel per run; the worker end rides the init
 * transfer list; the host end is referenced while the worker computes and
 * unreferenced while every worker frame is blocked on a host call, so a
-* suspended run lets the process exit (docs/06, 2.7) and a computing
+* suspended run lets the process exit and a computing
 * worker keeps it alive. Breaching timeoutMs or memoryMb terminates the
 * worker and the run completes with outcome 'error' carrying the typed
-* SandboxError (docs/02, error taxonomy).
+* SandboxError.
 */
 const DEFAULT_SANDBOX_TIMEOUT_MS = 3e5;
 const DEFAULT_SANDBOX_MEMORY_MB = 512;
-/** Accepts CompiledWorkflow ONLY: feeding a closure is a type error (docs/06, 8). */
+/** Accepts CompiledWorkflow ONLY: feeding a closure is a type error. */
 var WorkerSandboxRunner = class {
 	timeoutMs;
 	memoryMb;

package/dist/sandbox-worker.js

@@ -1,4 +1,4 @@
-import { t as SANDBOX_GLOBALS } from "./compile-CfWgGVyz.js";
+import { t as SANDBOX_GLOBALS } from "./compile-BtCY9wfO.js";
 import { NonSerializableValueError, toJournalValue } from "@rulvar/core";
 import { createHash } from "node:crypto";
 import { parentPort } from "node:worker_threads";
@@ -8,7 +8,7 @@ import { AsyncLocalStorage } from "node:async_hooks";
 * The worker half of the sandbox contract (M6-T02): evaluates a
 * CompiledWorkflow source inside a worker_threads realm with the curated
 * global scope and proxies every primitive call as JSON-RPC over the
-* dedicated MessagePort to the host bridge (docs/06, 8.2).
+* dedicated MessagePort to the host bridge.
 *
 * Determinism: now, random, uuid, and the Date.now/Math.random realm
 * replacements all draw from ONE seeded stream (seed = sha256(runId)), so

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/planner",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "rulvar flagship hybrid mode: plan agent, compileScript, WorkerSandboxRunner, self-repair loop.",
   "type": "module",
   "license": "Apache-2.0",
@@ -23,14 +23,14 @@
   },
   "dependencies": {
     "eslint": "^9.39.4",
-    "@rulvar/core": "1.1.0",
-    "eslint-plugin-rulvar": "1.1.0"
+    "@rulvar/core": "1.2.0",
+    "eslint-plugin-rulvar": "1.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.0",
     "tsdown": "^0.22.3",
     "typescript": "~6.0.3",
-    "@rulvar/testing": "1.1.0"
+    "@rulvar/testing": "1.2.0"
   },
   "repository": {
     "type": "git",