openplanr 2.2640.9 → 2.2641.1

package/lib/host-packages/openai/openplanr/runtime/design/scripts/design-review.mjs

@@ -52,6 +52,10 @@ import {
   readJson,
   reviewDigest
 } from "./design-shared-artifact-support-dependencies-design-support-protocol-contracts-3d9b1a86.mjs";
+import {
+  CLI_COMMAND,
+  PLANNING_FOLDER
+} from "./design-owner-custody.mjs";
 import {
   planrHome
 } from "./design-runtime-home.mjs";
@@ -410,8 +414,8 @@ ${fence}`;
 var { createDesignReviewExport, serializeDesignReviewExport } = reviewExportTools();
 
 // packages/design/lib/design/review.mjs
-import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
-import { dirname as dirname4, join as join4, relative, resolve as resolve3 } from "node:path";
+import { existsSync as existsSync5, readFileSync as readFileSync4 } from "node:fs";
+import { dirname as dirname4, join as join5, relative, resolve as resolve3 } from "node:path";
 
 // packages/artifact/lib/artifact/review-server.mjs
 import { existsSync, lstatSync, readdirSync, readFileSync, rmSync } from "node:fs";
@@ -1456,7 +1460,7 @@ function readReviewServerState(path) {
     throw artifactError(
       ARTIFACT_ERROR_CODES.LOOPBACK_STATE,
       "Local Studio owner state is unsafe or malformed. The original record was preserved.",
-      "Run planr doctor and recover the owner record before starting or stopping this service."
+      `Run ${CLI_COMMAND} doctor and recover the owner record before starting or stopping this service.`
     );
   }
 }
@@ -1533,6 +1537,34 @@ async function stopArtifactReviewServer(instanceId, { env = process.env, fetchIm
   return controlRequest({ state }, "/internal/v1/shutdown", { method: "POST", fetchImpl });
 }
 
+// packages/protocol/src/planning-folder.mjs
+import { existsSync as existsSync2, readdirSync as readdirSync2, statSync } from "node:fs";
+import { join as join2 } from "node:path";
+var FOREIGN_FILES = Object.freeze(["planr.config.json", "board.html"]);
+var GOAL_DIRECTORIES = Object.freeze(["tasks", "plans"]);
+var isDirectory = (path) => existsSync2(path) && statSync(path).isDirectory();
+function foreignPlanningFolderSigns(projectRoot2) {
+  const folder = join2(projectRoot2, PLANNING_FOLDER);
+  if (!isDirectory(folder) || existsSync2(join2(folder, "config.json"))) return [];
+  const signs = FOREIGN_FILES.filter((name) => existsSync2(join2(folder, name)));
+  for (const name of GOAL_DIRECTORIES) {
+    const directory = join2(folder, name);
+    if (isDirectory(directory) && readdirSync2(directory).some((entry) => entry.endsWith("-goal.md")))
+      signs.push(`*-goal.md files in ${name}`);
+  }
+  return signs;
+}
+function planningFolderConflict(projectRoot2) {
+  const signs = foreignPlanningFolderSigns(projectRoot2);
+  if (signs.length === 0) return null;
+  return Object.freeze({
+    code: "E_PLANNING_FOLDER_FOREIGN",
+    problem: `The ${PLANNING_FOLDER} folder in this project wasn't created by OpenPlanr: it has ${signs.join(", ")} and no OpenPlanr config.json. OpenPlanr wrote nothing there.`,
+    fix: `Move or rename that folder, or use ${CLI_COMMAND} in a project without it, then retry.`,
+    signs: Object.freeze(signs)
+  });
+}
+
 // packages/design/lib/design/design-plan-handoff.mjs
 var clone = (value) => JSON.parse(canonicalizeJson(value));
 function prepareDesignPlanHandoff(handoff, { subject } = {}) {
@@ -1571,7 +1603,7 @@ function prepareDesignPlanHandoff(handoff, { subject } = {}) {
 // packages/design/lib/design/implementation-handoff.mjs
 import { createHash, randomUUID } from "node:crypto";
 import {
-  existsSync as existsSync2,
+  existsSync as existsSync3,
   mkdirSync,
   readFileSync as readFileSync2,
   realpathSync,
@@ -1579,7 +1611,7 @@ import {
   rmSync as rmSync2,
   writeFileSync
 } from "node:fs";
-import { dirname as dirname2, join as join2, resolve as resolve2, sep } from "node:path";
+import { dirname as dirname2, join as join3, resolve as resolve2, sep } from "node:path";
 
 // packages/design/lib/design/implementation-handoff-markdown.mjs
 var line = (value) => String(value).replaceAll("\r\n", "\n").replaceAll("\r", "\n").trim().replaceAll("\n", " ").replace(/([\\`*_[\]<>#|])/gu, "\\$1");
@@ -1832,19 +1864,19 @@ function createRepositorySourceResolver(root) {
   };
 }
 function implementationHandoffPaths(root) {
-  const directory = join2(resolve2(root), "implementation-handoff");
+  const directory = join3(resolve2(root), "implementation-handoff");
   return Object.freeze({
     directory,
-    draftJson: join2(directory, "draft.json"),
-    draftMarkdown: join2(directory, "draft.md"),
-    journal: join2(directory, "draft-publication.json"),
-    current: join2(directory, "current.json"),
-    history: join2(directory, "versions")
+    draftJson: join3(directory, "draft.json"),
+    draftMarkdown: join3(directory, "draft.md"),
+    journal: join3(directory, "draft-publication.json"),
+    current: join3(directory, "current.json"),
+    history: join3(directory, "versions")
   });
 }
 function recoverImplementationHandoffDraft(root) {
   const paths = implementationHandoffPaths(root);
-  if (!existsSync2(paths.journal)) return false;
+  if (!existsSync3(paths.journal)) return false;
   const journal = JSON.parse(readFileSync2(paths.journal, "utf8"));
   const value = assertImplementationHandoffProjection(journal.package);
   if (journal.markdown !== value.markdown)
@@ -1857,14 +1889,14 @@ function recoverImplementationHandoffDraft(root) {
 function readImplementationHandoffDraft(root, { allowMissing = true } = {}) {
   const paths = implementationHandoffPaths(root);
   recoverImplementationHandoffDraft(root);
-  if (!existsSync2(paths.draftJson)) {
+  if (!existsSync3(paths.draftJson)) {
     if (allowMissing) return null;
     throw new Error("No implementation handoff draft exists.");
   }
   const value = assertImplementationHandoffProjection(
     JSON.parse(readFileSync2(paths.draftJson, "utf8"))
   );
-  if (!existsSync2(paths.draftMarkdown))
+  if (!existsSync3(paths.draftMarkdown))
     throw new Error("Implementation handoff Markdown is missing.");
   if (readFileSync2(paths.draftMarkdown, "utf8") !== value.markdown)
     throw new Error("Implementation handoff JSON and Markdown projections differ.");
@@ -1899,15 +1931,15 @@ function importImplementationHandoffPackage(input, { resolveSource } = {}) {
 // packages/design/lib/design/implementation-handoff-approval.mjs
 import { createHash as createHash2, randomUUID as randomUUID2 } from "node:crypto";
 import {
-  existsSync as existsSync3,
+  existsSync as existsSync4,
   mkdirSync as mkdirSync2,
-  readdirSync as readdirSync2,
+  readdirSync as readdirSync3,
   readFileSync as readFileSync3,
   renameSync as renameSync2,
   rmSync as rmSync3,
   writeFileSync as writeFileSync2
 } from "node:fs";
-import { dirname as dirname3, join as join3 } from "node:path";
+import { dirname as dirname3, join as join4 } from "node:path";
 var DIGEST2 = /^sha256:[a-f0-9]{64}$/u;
 var ID = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/u;
 var APPROVE_CAPABILITY = "design:implementation-handoff:approve";
@@ -1996,20 +2028,20 @@ function implementationHandoffApprovalPaths(root) {
   const base = implementationHandoffPaths(root);
   return Object.freeze({
     ...base,
-    events: join3(base.directory, "events"),
-    journal: join3(base.directory, "lifecycle-publication.json")
+    events: join4(base.directory, "events"),
+    journal: join4(base.directory, "lifecycle-publication.json")
   });
 }
 function archivePaths(root, value) {
-  const directory = join3(implementationHandoffPaths(root).history, packageKey(value));
+  const directory = join4(implementationHandoffPaths(root).history, packageKey(value));
   return {
     directory,
-    json: join3(directory, "handoff.json"),
-    markdown: join3(directory, "handoff.md")
+    json: join4(directory, "handoff.json"),
+    markdown: join4(directory, "handoff.md")
   };
 }
 function eventPath(root, requestId) {
-  return join3(implementationHandoffApprovalPaths(root).events, `${requestKey(requestId)}.json`);
+  return join4(implementationHandoffApprovalPaths(root).events, `${requestKey(requestId)}.json`);
 }
 function readJson2(path, fallback = void 0) {
   try {
@@ -2043,13 +2075,13 @@ function pointerFor(value, status, eventId, extra = {}) {
 }
 function writeLifecycleJournal(root, journal) {
   const paths = implementationHandoffApprovalPaths(root);
-  if (existsSync3(paths.journal)) recoverImplementationHandoffApproval(root);
+  if (existsSync4(paths.journal)) recoverImplementationHandoffApproval(root);
   atomicText2(paths.journal, jsonBytes2(journal));
   return recoverImplementationHandoffApproval(root);
 }
 function recoverImplementationHandoffApproval(root) {
   const paths = implementationHandoffApprovalPaths(root);
-  if (!existsSync3(paths.journal)) return false;
+  if (!existsSync4(paths.journal)) return false;
   const journal = readJson2(paths.journal);
   if (journal.kind !== "openplanr-design-implementation-handoff-lifecycle-publication" || journal.schemaVersion !== "1.0.0")
     throw new TypeError("The implementation handoff lifecycle journal is invalid.");
@@ -2080,16 +2112,16 @@ function readImplementationHandoffVersion(root, identity) {
 function listImplementationHandoffHistory(root) {
   recoverImplementationHandoffApproval(root);
   const directory = implementationHandoffPaths(root).history;
-  if (!existsSync3(directory)) return [];
-  return readdirSync2(directory, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map(
-    (entry) => assertImplementationHandoffProjection(readJson2(join3(directory, entry.name, "handoff.json")))
+  if (!existsSync4(directory)) return [];
+  return readdirSync3(directory, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map(
+    (entry) => assertImplementationHandoffProjection(readJson2(join4(directory, entry.name, "handoff.json")))
   ).sort((left, right) => left.version - right.version || left.id.localeCompare(right.id));
 }
 function readImplementationHandoffLifecycle(root) {
   recoverImplementationHandoffApproval(root);
   const paths = implementationHandoffApprovalPaths(root);
   const current = readJson2(paths.current, null);
-  const events = existsSync3(paths.events) ? readdirSync2(paths.events).filter((name) => name.endsWith(".json")).map((name) => readJson2(join3(paths.events, name))).sort(
+  const events = existsSync4(paths.events) ? readdirSync3(paths.events).filter((name) => name.endsWith(".json")).map((name) => readJson2(join4(paths.events, name))).sort(
     (left, right) => left.at.localeCompare(right.at) || left.eventId.localeCompare(right.eventId)
   ) : [];
   return Object.freeze({ current, history: listImplementationHandoffHistory(root), events });
@@ -2561,7 +2593,7 @@ function validateState(value, current) {
 function projectRoot(root) {
   let candidate = root;
   while (true) {
-    if (existsSync4(join4(candidate, ".planr")) || existsSync4(join4(candidate, ".git")))
+    if (existsSync5(join5(candidate, PLANNING_FOLDER)) || existsSync5(join5(candidate, ".git")))
       return candidate;
     const parent = dirname4(candidate);
     if (parent === candidate) return root;
@@ -2606,7 +2638,7 @@ function proposeImplementationPackage(file, env) {
       designSpecPath(current.root),
       ...(current.sourceFiles ?? []).map((path) => resolve3(current.root, path))
     ])
-  ].filter((path) => existsSync4(path));
+  ].filter((path) => existsSync5(path));
   const sources = paths.map((path, index) => {
     const logicalPath = relative(repository, path).replaceAll("\\", "/");
     const extension = logicalPath.split(".").pop()?.toLowerCase();
@@ -2652,7 +2684,10 @@ function proposeImplementationPackage(file, env) {
   };
 }
 async function persistDesignTaste(current, state) {
-  const path = join4(projectRoot(current.root), ".planr/design-system/taste.json");
+  const root = projectRoot(current.root);
+  const conflict = planningFolderConflict(root);
+  if (conflict) throw new PipelineError(conflict.code, conflict.problem, conflict.fix);
+  const path = join5(root, `${PLANNING_FOLDER}/design-system/taste.json`);
   const release = await acquireStartLock(`${path}.lock`);
   try {
     const taste = readJson(path, { designs: {} });
@@ -2693,7 +2728,7 @@ async function saveDesignState(file, { state, revision, stateVersion }) {
     throw Object.assign(new Error("The design changed. Reload before saving feedback."), {
       statusCode: 409
     });
-  const path = join4(current.root, ".design/studio-state.json");
+  const path = join5(current.root, ".design/studio-state.json");
   const release = await acquireStartLock(`${path}.lock`);
   try {
     current = currentDesign(file);
@@ -2731,7 +2766,7 @@ var readBody = async (req) => JSON.parse(await readRequestBody(req, { maxBytes:
 var readImplementationBody = async (req) => JSON.parse(await readRequestBody(req, { maxBytes: 5 * 1024 * 1024, encoding: "utf8" }));
 async function startDesignReview(file, options = {}) {
   const { root } = currentDesign(file);
-  const release = await acquireStartLock(join4(root, ".design/start.lock"));
+  const release = await acquireStartLock(join5(root, ".design/start.lock"));
   try {
     return await startDesignReviewUnlocked(file, options);
   } finally {
@@ -2752,7 +2787,7 @@ async function startDesignReviewUnlocked(file, {
   let current = currentDesign(file);
   const applyInitialView = async () => {
     if (view === void 0) return;
-    const saved = readJson(join4(current.root, ".design/studio-state.json"), {
+    const saved = readJson(join5(current.root, ".design/studio-state.json"), {
       state: {},
       stateVersion: 0
     });
@@ -2762,7 +2797,7 @@ async function startDesignReviewUnlocked(file, {
       state: { ...saved.state, view }
     });
   };
-  const stateFile = join4(current.root, ".design/server.json");
+  const stateFile = join5(current.root, ".design/server.json");
   const old = readJson(stateFile, null);
   const services = (await listArtifactReviewServers({ env, fetchImpl })).filter(
     (service) => service.kind === "design" && service.projectRoot === current.root
@@ -2839,7 +2874,7 @@ async function startDesignReviewUnlocked(file, {
       session.designRevision = current.revision;
     },
     renderDocument({ model, base }) {
-      const state = readJson(join4(current.root, ".design/studio-state.json"), {
+      const state = readJson(join5(current.root, ".design/studio-state.json"), {
         state: {}
       }).state;
       const stalePins = readDesignFeedback(file, env).pins.filter((pin) => pin.stale);
@@ -2892,7 +2927,7 @@ ${renderArtifactParentRuntime({ ...options, adapterRuntimeUrl: `${base}api/desig
           respond(res, 200, readDesignHandoff(file, { env }));
         } else if (route === "design-implementation-handoff" && req.method === "GET") {
           const design = currentDesign(file);
-          const unlock = await acquireStartLock(join4(design.root, ".design/render.lock"));
+          const unlock = await acquireStartLock(join5(design.root, ".design/render.lock"));
           try {
             const root = dirname4(designSpecPath(design.root));
             let proposal = null;
@@ -2938,7 +2973,7 @@ ${renderArtifactParentRuntime({ ...options, adapterRuntimeUrl: `${base}api/desig
             ].includes(input.action))
               throw new Error("Unknown implementation package action.");
             const initial = currentDesign(file);
-            const unlock = await acquireStartLock(join4(initial.root, ".design/render.lock"));
+            const unlock = await acquireStartLock(join5(initial.root, ".design/render.lock"));
             try {
               const design = currentDesign(file);
               const root = dirname4(designSpecPath(design.root));
@@ -3103,7 +3138,7 @@ ${renderArtifactParentRuntime({ ...options, adapterRuntimeUrl: `${base}api/desig
           else if (action === "recovery")
             result = await exportDesignShareRecovery(file, {
               ...options,
-              output: join4(
+              output: join5(
                 env.HOME ?? process.env.HOME,
                 "Downloads",
                 `openplanr-design-recovery-${Date.now()}.json`
@@ -3112,7 +3147,7 @@ ${renderArtifactParentRuntime({ ...options, adapterRuntimeUrl: `${base}api/desig
           else result = await manageDesignShare(file, action, options);
           respond(res, 200, result);
         } else if (route === "design-status" && req.method === "GET") {
-          const ready = readJson(join4(current.root, ".design/browser-ready.json"), null);
+          const ready = readJson(join5(current.root, ".design/browser-ready.json"), null);
           respond(res, 200, {
             ok: true,
             documentId: current.document.id,
@@ -3123,7 +3158,7 @@ ${renderArtifactParentRuntime({ ...options, adapterRuntimeUrl: `${base}api/desig
           });
         } else if (route === "design-state" && req.method === "GET") {
           respond(res, 200, {
-            ...readJson(join4(current.root, ".design/studio-state.json"), {
+            ...readJson(join5(current.root, ".design/studio-state.json"), {
               state: {},
               stateVersion: 0
             }),
@@ -3136,7 +3171,7 @@ ${renderArtifactParentRuntime({ ...options, adapterRuntimeUrl: `${base}api/desig
           const loadedArtifacts = new Set(Array.isArray(value?.artifacts) ? value.artifacts : []);
           if (value.revision !== current.revision || value.status !== "ready" || !Array.isArray(value.artifacts) || value.artifacts.length === 0 || loadedArtifacts.size !== value.artifacts.length || value.artifacts.some((id) => !current.entries.some((entry) => entry.artifactId === id)))
             throw new Error("Browser readiness must identify loaded design artboards.");
-          atomicJson(join4(current.root, ".design/browser-ready.json"), {
+          atomicJson(join5(current.root, ".design/browser-ready.json"), {
             status: "ready",
             revision: current.revision,
             artifacts: value.artifacts,
@@ -3145,7 +3180,7 @@ ${renderArtifactParentRuntime({ ...options, adapterRuntimeUrl: `${base}api/desig
           });
           respond(res, 200, { ok: true });
         } else if (route === "design-export" && req.method === "GET") {
-          const state = readJson(join4(current.root, ".design/studio-state.json"), {
+          const state = readJson(join5(current.root, ".design/studio-state.json"), {
             state: {}
           }).state;
           res.writeHead(200, {
@@ -3269,8 +3304,8 @@ async function resolveDesignPins(file, { pinIds, summary, env = process.env }) {
         "One or more requested pins do not exist."
       );
     writeArtifactReviewState(path, createReviewLedger({ ...ledger, reviews: revisions }));
-    const history = readJson(join4(current.root, ".design/review-history.json"), []);
-    atomicJson(join4(current.root, ".design/review-history.json"), [
+    const history = readJson(join5(current.root, ".design/review-history.json"), []);
+    atomicJson(join5(current.root, ".design/review-history.json"), [
       ...history,
       {
         revision: current.revision,

package/lib/host-packages/openai/openplanr/runtime/design/scripts/design-share.mjs

@@ -20,6 +20,7 @@ import {
   createChunkedWorkspaceClient
 } from "./design-chunked-workspace-client.mjs";
 import {
+  PLANNING_FOLDER,
   ensurePrivateDirectory,
   readCustody,
   writeCustody
@@ -80,7 +81,7 @@ function custodyLocation(file, options = {}, { allowMissing = false } = {}) {
   const root = resolve(options.custodyRoot ?? join(planrHome(env), "design-shares"));
   let project = current.root;
   for (let candidate = current.root; dirname(candidate) !== candidate; candidate = dirname(candidate)) {
-    if (existsSync(join(candidate, ".git")) || existsSync(join(candidate, ".planr"))) {
+    if (existsSync(join(candidate, ".git")) || existsSync(join(candidate, PLANNING_FOLDER))) {
       project = candidate;
       break;
     }
@@ -684,7 +685,7 @@ function inside(base, candidate) {
   return rel === "" || !rel.startsWith("..") && !isAbsolute2(rel);
 }
 function parseablePlanrConfig(root) {
-  const path = join2(root, ".planr", "config.json");
+  const path = join2(root, PLANNING_FOLDER, "config.json");
   if (!existsSync3(path)) return false;
   try {
     if (lstatSync2(path).isSymbolicLink()) return false;
@@ -813,7 +814,11 @@ function resolveArtifactReviewDestination({
   }
   const projectRoot = findArtifactProjectRoot(cwd, { env });
   if (projectRoot) {
-    const directory2 = assertSafeDestination(projectRoot, [".planr", "artifacts", artifactId]);
+    const directory2 = assertSafeDestination(projectRoot, [
+      PLANNING_FOLDER,
+      "artifacts",
+      artifactId
+    ]);
     return Object.freeze({
       kind: "project",
       artifactId,
@@ -1799,7 +1804,7 @@ async function importDesignShareRecovery(file, { input, ...options } = {}) {
       const pending = custody.pendingCreate ?? custody.pendingMutation.body;
       const destination = join3(root, "uploads", custody.id, pending.operationId);
       if (existsSync4(destination)) {
-        const { spoolChunkReader: spoolChunkReader2 } = await import("./design-runtime-support-5cb7531bede8.mjs");
+        const { spoolChunkReader: spoolChunkReader2 } = await import("./design-runtime-support-336900df0d39.mjs");
         const reader = spoolChunkReader2(destination, pending);
         for (const part of pending.manifest.chunks) await reader(part.index);
       } else await copyUploadSpool(custody, destination);

package/lib/host-packages/openai/openplanr/runtime/design/scripts/runtime/packages/artifact/lib/artifact/ui/studio-shell.css

@@ -1,2 +1,2 @@
 /* generated by scripts/typescript/compile-sources.mjs from studio-shell.source.css */
-.studio-toolbar{min-width:0;min-height:54px;gap:12px;font:400 13px / 1.4 var(--planr-font-body, "DM Sans", sans-serif);box-sizing:border-box;display:flex;align-items:center;flex-wrap:nowrap;padding:0 16px;width:100%}.studio-toolbar .planr-brand{display:flex;align-items:center;gap:8px;min-width:0;flex:1}.studio-toolbar .planr-mark{display:inline-flex;flex:none;width:28px;height:28px;color:var(--planr-color-primary)}.studio-toolbar .planr-mark svg{display:block;width:100%;height:100%}.studio-toolbar .design-wordmark{font-weight:500;white-space:nowrap;font-size:13px;color:var(--planr-color-text)}.studio-toolbar .design-wordmark>span{font-weight:600;color:var(--planr-color-primary)}.studio-toolbar .planr-title-block{display:flex;align-items:center;gap:7px;min-width:0}.studio-chrome-mount,.studio-panel-mount{display:contents}.studio-toolbar-leading,.studio-toolbar-trailing{min-width:0;display:flex;align-items:center;gap:8px}.studio-toolbar-leading{flex:1}.studio-toolbar-trailing{justify-content:flex-end}.studio-identity{min-width:0}.studio-toolbar .planr-title-block strong{max-width:min(25vw,300px)}.studio-subtitle,.studio-hierarchy{display:block;overflow:hidden;color:var(--planr-color-text-muted);font-size:10px;text-overflow:ellipsis;white-space:nowrap}.studio-hierarchy a{color:inherit}.studio-type-badge{display:inline-flex;flex:none;align-items:center;padding:2px 5px;border:1px solid var(--planr-color-rule);border-radius:var(--planr-radius-small, 5px);color:var(--planr-color-text-muted);font:500 10px / 1.2 var(--planr-font-body);white-space:nowrap}.studio-button,.studio-menu-content,.studio-tooltip,.studio-panel-dialog{border:1px solid var(--planr-color-rule);background:var(--planr-color-panel);color:var(--planr-color-text)}.studio-button{min-height:32px;display:inline-flex;justify-content:center;align-items:center;gap:6px;border-radius:var(--planr-radius-medium, 8px);padding:0 9px;font:500 13px / 1 var(--planr-font-body);cursor:pointer}.studio-button-ghost{background:transparent;border-color:transparent}.studio-button-primary{background:var(--planr-color-primary);border-color:var(--planr-color-primary);color:var(--planr-color-background)}.studio-button:not(:disabled):hover,.studio-button[aria-pressed=true],.studio-button[aria-expanded=true]{background:var(--planr-color-raised);color:var(--planr-color-primary)}.studio-button:disabled,.studio-menu-item[data-disabled]{opacity:0.45;cursor:not-allowed}.studio-button:focus-visible,.studio-menu-item:focus-visible{outline:2px solid var(--planr-color-primary);outline-offset:2px}.studio-menu{display:inline-flex}.studio-menu-content{min-width:180px;max-width:min(320px,calc(100vw - 16px));max-height:var(--radix-dropdown-menu-content-available-height);overflow-y:auto;padding:5px;z-index:160;border-radius:var(--planr-radius-medium, 8px);box-shadow:0 12px 30px color-mix(in srgb,var(--planr-color-background) 60%,transparent)}.studio-menu-item{width:100%;min-height:34px;padding:8px 10px;display:flex;align-items:center;text-align:left;border:0;border-radius:var(--planr-radius-small, 5px);background:transparent;color:inherit;font:500 13px / 1.3 var(--planr-font-body);cursor:pointer}.studio-menu-item[data-highlighted]{background:var(--planr-color-raised);outline:none;color:var(--planr-color-primary)}.studio-menu-group-start{border-top:1px solid var(--planr-color-rule);border-radius:0}.studio-tooltip{z-index:180;padding:6px 8px;border-radius:var(--planr-radius-small, 5px);font:12px / 1.4 var(--planr-font-body)}.studio-status{min-width:0;display:inline-flex;align-items:center;gap:4px;color:var(--planr-color-text-muted);font:10px / 1.3 var(--planr-font-body)}.studio-status[data-tone=error]{color:var(--planr-color-danger)}.studio-status .studio-button{width:24px;min-height:24px;padding:0}.studio-panel-overlay{position:absolute;inset:0;z-index:170;background:color-mix(in srgb,var(--planr-color-background) 72%,transparent)}.studio-panel-dialog{position:absolute;top:env(safe-area-inset-top,0px);bottom:env(safe-area-inset-bottom,0px);z-index:180;width:min(350px,calc(100% - 32px));box-shadow:0 8px 30px color-mix(in srgb,var(--planr-color-background) 50%,transparent)}.studio-panel-left{left:0}.studio-panel-right{right:0}.studio-panel-close{position:absolute;right:8px;top:8px;z-index:2;width:32px}.studio-panel-content{height:100%;min-height:0}.studio-panel-dialog .design-navigator,.studio-panel-dialog .planr-review-rail,.studio-panel-dialog .diagram-outline{position:static!important;width:100%!important;height:100%!important;max-height:100%!important;transform:none!important;overflow-y:auto;padding-top:42px;border:0}@media(max-width:680px){.studio-toolbar{gap:6px;padding-inline:8px}.studio-toolbar .planr-title-block strong{max-width:30vw}.studio-toolbar .design-wordmark{display:none}.studio-toolbar .design-button-label{display:none}.studio-toolbar .studio-status{max-width:90px}.studio-button{min-height:36px;padding-inline:8px}}.planr-shell[data-studio-framework=react]{--planr-toolbar-height: 60px;grid-template-rows:auto minmax(0,1fr)}.planr-shell[data-studio-framework=react] :is(.design-toolbar,.diagram-toolbar){display:flex;grid-template-columns:none;flex-wrap:wrap;min-height:var(--planr-toolbar-height);height:auto;padding-block:4px;overflow:visible}.planr-shell[data-studio-framework=react] .planr-brand{display:flex;gap:8px;max-width:none;min-width:min-content}.planr-shell[data-studio-framework=react] .studio-toolbar-leading{flex:1;min-width:min-content}.planr-shell[data-studio-framework=react] .studio-toolbar-trailing{flex:0 0 auto;flex-wrap:wrap;max-width:100%}.planr-shell[data-studio-framework=react] .design-toolbar .design-view-picker{display:inline-flex;width:auto;margin:0;border:0}.planr-shell[data-studio-framework=react] .design-export>button{display:inline-flex;width:auto;padding:0 9px}.planr-shell[data-studio-framework=react] .studio-menu-content{position:relative}.planr-shell[data-studio-framework=react] .planr-title-block{display:flex}.planr-shell[data-studio-framework=react]>.planr-workspace{position:relative}@media(max-width:680px){.planr-shell[data-studio-framework=react] .studio-toolbar.planr-toolbar{gap:2px;padding-inline:4px}.planr-shell[data-studio-framework=react] .studio-toolbar-leading,.planr-shell[data-studio-framework=react] .studio-toolbar-trailing{gap:2px}.planr-shell[data-studio-framework=react] .planr-brand{overflow:hidden}.planr-shell[data-studio-framework=react] .studio-identity{display:block;overflow:hidden}.planr-shell[data-studio-framework=react] .planr-mark{width:22px;height:22px}.planr-shell[data-studio-framework=react] .design-view-picker{height:52px;gap:0}.planr-shell[data-studio-framework=react] .design-view-picker button{width:44px;height:100%;padding:0}.planr-shell[data-studio-framework=react] .studio-button{min-width:44px;min-height:44px}.planr-shell[data-studio-framework=react] :is(.design-save-state,.design-preview-state){display:none}.planr-shell[data-studio-framework=react] :is(.design-export,.diagram-export)>button{font-size:0;width:44px;padding:0}.planr-shell[data-studio-framework=react] :is(.design-export,.diagram-export)>button span{font-size:16px}}@media(max-width:960px){.planr-shell[data-studio-framework=react] .design-wordmark{display:none}.planr-shell[data-studio-framework=react] .planr-workspace>:is(.design-navigator,.planr-review-rail){top:0;max-height:100%}}@media(max-width:1240px){.planr-shell[data-studio-framework=react] .planr-title-block{flex-direction:column;align-items:flex-start;gap:1px}.planr-shell[data-studio-framework=react] .planr-title-block strong{max-width:100%;line-height:1.1}.planr-shell[data-studio-framework=react] .design-preview-state{max-width:48px;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}}.planr-diagram-editor[data-studio-framework=react]{--de-bar-height: 60px;grid-template-rows:auto minmax(0,1fr)}.planr-diagram-editor[data-studio-framework=react] .de-bar{display:block;padding:0;height:auto;overflow:visible;border-bottom:0}.planr-diagram-editor[data-studio-framework=react] .studio-toolbar{min-height:60px;height:auto;flex-wrap:wrap;padding:4px 16px;border:0;border-bottom:1px solid var(--de-rule);background:var(--de-panel)}.planr-diagram-editor[data-studio-framework=react] .studio-toolbar-leading{flex:1;min-width:min-content}.planr-diagram-editor[data-studio-framework=react] .studio-toolbar :is(.de-command-group,.studio-toolbar-trailing){flex:none}.planr-diagram-editor[data-studio-framework=react] .planr-brand{min-width:min-content;overflow:hidden}.planr-diagram-editor[data-studio-framework=react] .de-title{max-width:25vw;line-height:1.35}.planr-diagram-editor[data-studio-framework=react] .studio-subtitle .de-subtitle{line-height:1.3}.planr-diagram-editor[data-studio-framework=react] .de-alert{grid-row:2;top:var(--de-space-3)}.planr-diagram-editor[data-studio-framework=react][data-layout~=drawer] .design-wordmark,.planr-diagram-editor[data-studio-framework=react][data-layout~=drawer] .studio-subtitle{display:none}.planr-diagram-editor[data-studio-framework=react][data-layout~=drawer] .planr-title-block{flex-direction:column;align-items:flex-start;gap:1px}.planr-diagram-editor[data-studio-framework=react][data-layout~=compact] .studio-toolbar{padding:4px 8px;gap:8px}.planr-diagram-editor[data-studio-framework=react][data-layout~=compact] .studio-toolbar-trailing{gap:4px}.planr-diagram-editor[data-studio-framework=react][data-layout~=compact] .studio-menu:has([data-studio-palette-menu]){display:none}.planr-diagram-editor[data-studio-framework=react][data-layout~=compact] .de-more-menu{top:calc(100% + var(--de-space-2))}[data-studio-framework=react]{position:relative}[data-studio-framework=react] .studio-toolbar .studio-type-badge{display:inline-flex}[data-studio-framework=react] .studio-identity{flex:1;min-width:min-content}[data-studio-framework=react] .studio-toolbar .planr-title-block strong{contain:inline-size;display:block;align-self:stretch;width:auto;min-width:0;flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}[data-studio-framework=react] .studio-subtitle{contain:inline-size}[data-studio-framework=react]:has(.studio-panel-dialog) [data-planr-close-feedback],[data-studio-framework=react]:has(.studio-panel-dialog) .planr-review-rail [data-planr-close-feedback]{display:none}.studio-panel-dialog .design-nav-close,.studio-panel-dialog .studio-panel-content .planr-review-rail [data-planr-close-feedback]{display:none}.studio-preserved-control{display:contents}.studio-toolbar fieldset.planr-segment{margin:0;padding:0;min-inline-size:0}.diagram-shell[data-present=true] .studio-toolbar-trailing>:not([data-action=present]):not(.studio-menu){display:none}.diagram-shell[data-studio-framework=react] .diagram-presentation-nav button{color:var(--planr-color-text);background:var(--planr-color-panel)}.diagram-shell[data-studio-framework=react] .diagram-presentation-nav button:enabled:hover{background:var(--planr-color-raised)}@media(max-width:680px){.studio-panel-close{width:44px;min-height:44px}}@media(max-width:700px){.diagram-shell[data-present=true] .studio-toolbar-leading{flex:none}.diagram-shell[data-present=true] .diagram-presentation-nav{min-width:0;flex:1;gap:4px}.diagram-shell[data-present=true] .diagram-presentation-nav>div{min-width:0}}@media(min-width:681px)and (max-width:960px){.diagram-shell[data-studio-framework=react] .studio-toolbar-trailing{gap:4px}}@media(max-width:480px){.studio-toolbar .planr-mark{display:none}}
+.studio-toolbar{min-width:0;min-height:54px;gap:12px;font:400 13px / 1.4 var(--planr-font-body, "DM Sans", sans-serif);box-sizing:border-box;display:flex;align-items:center;flex-wrap:nowrap;padding:0 16px;width:100%}.studio-toolbar .planr-brand{display:flex;align-items:center;gap:8px;min-width:0;flex:1}.studio-toolbar .planr-mark{display:inline-flex;flex:none;width:28px;height:28px;color:var(--planr-color-primary)}.studio-toolbar .planr-mark svg{display:block;width:100%;height:100%}.studio-toolbar .design-wordmark{font-weight:500;white-space:nowrap;font-size:13px;color:var(--planr-color-text)}.studio-toolbar .design-wordmark>span{font-weight:600;color:var(--planr-color-primary)}.studio-toolbar .planr-title-block{display:flex;align-items:center;gap:7px;min-width:0}.studio-chrome-mount,.studio-panel-mount{display:contents}.studio-toolbar-leading,.studio-toolbar-trailing{min-width:0;display:flex;align-items:center;gap:8px}.studio-toolbar-leading{flex:1}.studio-toolbar-trailing{justify-content:flex-end}.studio-identity{min-width:0}.studio-toolbar .planr-title-block strong{max-width:min(25vw,300px)}.studio-subtitle,.studio-hierarchy{display:block;overflow:hidden;color:var(--planr-color-text-muted);font-size:10px;text-overflow:ellipsis;white-space:nowrap}.studio-hierarchy a{color:inherit}.studio-type-badge{display:inline-flex;flex:none;align-items:center;padding:2px 5px;border:1px solid var(--planr-color-rule);border-radius:var(--planr-radius-small, 5px);color:var(--planr-color-text-muted);font:500 10px / 1.2 var(--planr-font-body);white-space:nowrap}.studio-button,.studio-menu-content,.studio-tooltip,.studio-panel-dialog{border:1px solid var(--planr-color-rule);background:var(--planr-color-panel);color:var(--planr-color-text)}.studio-button{min-height:32px;display:inline-flex;justify-content:center;align-items:center;gap:6px;border-radius:var(--planr-radius-medium, 8px);padding:0 9px;font:500 13px / 1 var(--planr-font-body);cursor:pointer}.studio-button-ghost{background:transparent;border-color:transparent}.studio-button-primary{background:var(--planr-color-primary);border-color:var(--planr-color-primary);color:var(--planr-color-background)}.studio-button:not(:disabled):hover,.studio-button[aria-pressed=true],.studio-button[aria-expanded=true]{background:var(--planr-color-raised);color:var(--planr-color-primary)}.studio-button:disabled,.studio-menu-item[data-disabled]{opacity:0.45;cursor:not-allowed}.studio-button:focus-visible,.studio-menu-item:focus-visible{outline:2px solid var(--planr-color-primary);outline-offset:2px}.studio-menu{display:inline-flex}.studio-menu-content{min-width:180px;max-width:min(320px,calc(100vw - 16px));max-height:var(--radix-dropdown-menu-content-available-height);overflow-y:auto;padding:5px;z-index:160;border-radius:var(--planr-radius-medium, 8px);box-shadow:0 12px 30px color-mix(in srgb,var(--planr-color-background) 60%,transparent)}.studio-menu-item{width:100%;min-height:34px;padding:8px 10px;display:flex;align-items:center;text-align:left;border:0;border-radius:var(--planr-radius-small, 5px);background:transparent;color:inherit;font:500 13px / 1.3 var(--planr-font-body);cursor:pointer}.studio-menu-item[data-highlighted]{background:var(--planr-color-raised);outline:none;color:var(--planr-color-primary)}.studio-menu-group-start{border-top:1px solid var(--planr-color-rule);border-radius:0}.studio-tooltip{z-index:180;padding:6px 8px;border-radius:var(--planr-radius-small, 5px);font:12px / 1.4 var(--planr-font-body)}.studio-status{min-width:0;display:inline-flex;align-items:center;gap:4px;color:var(--planr-color-text-muted);font:10px / 1.3 var(--planr-font-body)}.studio-status[data-tone=error]{color:var(--planr-color-danger)}.studio-status .studio-button{width:24px;min-height:24px;padding:0}.studio-panel-overlay{position:absolute;inset:0;z-index:170;background:color-mix(in srgb,var(--planr-color-background) 72%,transparent)}.studio-panel-dialog{position:absolute;top:env(safe-area-inset-top,0px);bottom:env(safe-area-inset-bottom,0px);z-index:180;width:min(350px,calc(100% - 32px));box-shadow:0 8px 30px color-mix(in srgb,var(--planr-color-background) 50%,transparent)}.studio-panel-left{left:0}.studio-panel-right{right:0}.studio-panel-close{position:absolute;right:8px;top:8px;z-index:2;width:32px}.studio-panel-content{height:100%;min-height:0}.studio-panel-dialog .design-navigator,.studio-panel-dialog .planr-review-rail,.studio-panel-dialog .diagram-outline{position:static!important;width:100%!important;height:100%!important;max-height:100%!important;transform:none!important;overflow-y:auto;padding-top:42px;border:0}@media(max-width:680px){.studio-toolbar{gap:6px;padding-inline:8px}.studio-toolbar .planr-title-block strong{max-width:30vw}.studio-toolbar .design-wordmark{display:none}.studio-toolbar .design-button-label{display:none}.studio-toolbar .studio-status{max-width:90px}.studio-button{min-height:36px;padding-inline:8px}}.planr-shell[data-studio-framework=react]{--planr-toolbar-height: 60px;grid-template-rows:auto minmax(0,1fr)}.planr-shell[data-studio-framework=react] :is(.design-toolbar,.diagram-toolbar){display:flex;grid-template-columns:none;flex-wrap:wrap;min-height:var(--planr-toolbar-height);height:auto;padding-block:4px;overflow:visible}.planr-shell[data-studio-framework=react] .planr-brand{display:flex;gap:8px;max-width:none;min-width:min-content}.planr-shell[data-studio-framework=react] .studio-toolbar-leading{flex:1;min-width:min-content}.planr-shell[data-studio-framework=react] .studio-toolbar-trailing{flex:0 0 auto;flex-wrap:wrap;max-width:100%}.planr-shell[data-studio-framework=react] .design-toolbar .design-view-picker{display:inline-flex;width:auto;margin:0;border:0}.planr-shell[data-studio-framework=react] .design-export>button{display:inline-flex;width:auto;padding:0 9px}.planr-shell[data-studio-framework=react] .studio-menu-content{position:relative}.planr-shell[data-studio-framework=react] .planr-title-block{display:flex}.planr-shell[data-studio-framework=react]>.planr-workspace{position:relative}@media(max-width:680px){.planr-shell[data-studio-framework=react] .studio-toolbar.planr-toolbar{gap:2px;padding-inline:4px}.planr-shell[data-studio-framework=react] .studio-toolbar-leading,.planr-shell[data-studio-framework=react] .studio-toolbar-trailing{gap:2px}.planr-shell[data-studio-framework=react] .planr-brand{overflow:hidden}.planr-shell[data-studio-framework=react] .studio-identity{display:block;overflow:hidden}.planr-shell[data-studio-framework=react] .planr-mark{width:22px;height:22px}.planr-shell[data-studio-framework=react] .design-view-picker{height:44px;gap:0}.planr-shell[data-studio-framework=react] .design-view-picker button{width:44px;height:100%;padding:0}.planr-shell[data-studio-framework=react] .studio-button{min-width:44px;min-height:44px}.planr-shell[data-studio-framework=react] :is(.design-save-state,.design-preview-state){display:none}.planr-shell[data-studio-framework=react] :is(.design-export,.diagram-export)>button{font-size:0;width:44px;padding:0}.planr-shell[data-studio-framework=react] :is(.design-export,.diagram-export)>button span{font-size:16px}}@media(max-width:960px){.planr-shell[data-studio-framework=react] .design-wordmark{display:none}.planr-shell[data-studio-framework=react] .planr-workspace>:is(.design-navigator,.planr-review-rail){top:0;max-height:100%}}@media(max-width:1240px){.planr-shell[data-studio-framework=react] .planr-title-block{flex-direction:column;align-items:flex-start;gap:1px}.planr-shell[data-studio-framework=react] .planr-title-block strong{max-width:100%;line-height:1.1}.planr-shell[data-studio-framework=react] .design-preview-state{max-width:48px;overflow:hidden;white-space:nowrap;text-overflow:ellipsis}}.planr-diagram-editor[data-studio-framework=react]{--de-bar-height: 60px;grid-template-rows:auto minmax(0,1fr)}.planr-diagram-editor[data-studio-framework=react] .de-bar{display:block;padding:0;height:auto;overflow:visible;border-bottom:0}.planr-diagram-editor[data-studio-framework=react] .studio-toolbar{min-height:60px;height:auto;flex-wrap:wrap;padding:4px 16px;border:0;border-bottom:1px solid var(--de-rule);background:var(--de-panel)}.planr-diagram-editor[data-studio-framework=react] .studio-toolbar-leading{flex:1;min-width:min-content}.planr-diagram-editor[data-studio-framework=react] .studio-toolbar :is(.de-command-group,.studio-toolbar-trailing){flex:none}.planr-diagram-editor[data-studio-framework=react] .planr-brand{min-width:min-content;overflow:hidden}.planr-diagram-editor[data-studio-framework=react] .de-title{max-width:25vw;line-height:1.35}.planr-diagram-editor[data-studio-framework=react] .studio-subtitle .de-subtitle{line-height:1.3}.planr-diagram-editor[data-studio-framework=react] .de-alert{grid-row:2;top:var(--de-space-3)}.planr-diagram-editor[data-studio-framework=react][data-layout~=drawer] .design-wordmark,.planr-diagram-editor[data-studio-framework=react][data-layout~=drawer] .studio-subtitle{display:none}.planr-diagram-editor[data-studio-framework=react][data-layout~=drawer] .planr-title-block{flex-direction:column;align-items:flex-start;gap:1px}.planr-diagram-editor[data-studio-framework=react][data-layout~=compact] .studio-toolbar{padding:4px 8px;gap:8px}.planr-diagram-editor[data-studio-framework=react][data-layout~=compact] .studio-toolbar-trailing{gap:4px}.planr-diagram-editor[data-studio-framework=react][data-layout~=compact] .studio-menu:has([data-studio-palette-menu]){display:none}.planr-diagram-editor[data-studio-framework=react][data-layout~=compact] .de-more-menu{top:calc(100% + var(--de-space-2))}[data-studio-framework=react]{position:relative}[data-studio-framework=react] .studio-toolbar .studio-type-badge{display:inline-flex}[data-studio-framework=react] .studio-identity{flex:1;min-width:min-content}[data-studio-framework=react] .studio-toolbar .planr-title-block strong{contain:inline-size;display:block;align-self:stretch;width:auto;min-width:0;flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}[data-studio-framework=react] .studio-subtitle{contain:inline-size}[data-studio-framework=react]:has(.studio-panel-dialog) [data-planr-close-feedback],[data-studio-framework=react]:has(.studio-panel-dialog) .planr-review-rail [data-planr-close-feedback]{display:none}.studio-panel-dialog .design-nav-close,.studio-panel-dialog .studio-panel-content .planr-review-rail [data-planr-close-feedback]{display:none}.studio-preserved-control{display:contents}.studio-toolbar fieldset.planr-segment{margin:0;padding:0;min-inline-size:0}.diagram-shell[data-present=true] .studio-toolbar-trailing>:not([data-action=present]):not(.studio-menu){display:none}.diagram-shell[data-studio-framework=react] .diagram-presentation-nav button{color:var(--planr-color-text);background:var(--planr-color-panel)}.diagram-shell[data-studio-framework=react] .diagram-presentation-nav button:enabled:hover{background:var(--planr-color-raised)}@media(max-width:680px){.studio-panel-close{width:44px;min-height:44px}}@media(max-width:700px){.diagram-shell[data-present=true] .studio-toolbar-leading{flex:none}.diagram-shell[data-present=true] .diagram-presentation-nav{min-width:0;flex:1;gap:4px}.diagram-shell[data-present=true] .diagram-presentation-nav>div{min-width:0}}@media(min-width:681px)and (max-width:960px){.diagram-shell[data-studio-framework=react] .studio-toolbar-trailing{gap:4px}}@media(max-width:480px){.studio-toolbar .planr-mark{display:none}}

package/lib/host-packages/openai/openplanr/runtime/design/scripts/runtime/packages/design/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/design",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "private": true,
   "type": "module",
   "description": "Canonical OpenPlanr design helpers and design-loop engine",
@@ -46,8 +46,8 @@
     "node": ">=20.19.0"
   },
   "dependencies": {
-    "@openplanr/artifact": "0.6.2",
-    "@openplanr/protocol": "0.10.1"
+    "@openplanr/artifact": "0.6.4",
+    "@openplanr/protocol": "0.10.2"
   },
   "scripts": {
     "test": "node --test --test-concurrency=2 tests/*.test.mjs",

package/lib/host-packages/openai/openplanr/runtime/design/scripts/runtime/packages/design/templates/studio/studio.css

@@ -62,14 +62,14 @@
  background: var(--planr-color-raised); color:var(--planr-color-primary);
 }
 .design-view-picker {
- align-self:stretch; height:auto; gap:8px; padding:0; border:0; border-radius:0; background:transparent;
+ align-self:center; height:32px; gap:8px; padding:0; border:0; border-radius:0; background:transparent;
 }
 .design-view-picker button {
- position:relative; display:flex; align-items:center; gap:7px; height:100%; padding:0 10px; border-radius:0;
+ position:relative; display:flex; align-items:center; gap:7px; height:100%; padding:0 10px; border-radius:6px;
  font-size:12px; font-weight:550;
 }
 .design-view-picker button[aria-pressed="true"], .design-view-picker button:not(:disabled):hover {
- background:transparent; color:var(--planr-color-text);
+ background:var(--planr-color-raised); color:var(--planr-color-text);
 }
 .design-view-picker button[aria-pressed="true"]::after {
  content:""; position:absolute; bottom:0; left:10px; right:10px; height:2px; background:var(--planr-color-primary);

package/lib/host-packages/openai/openplanr/runtime/design/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",
@@ -27,6 +27,14 @@
       "types": "./src/semver.d.mts",
       "import": "./src/semver.mjs"
     },
+    "./names": {
+      "types": "./src/names.d.mts",
+      "import": "./src/names.mjs"
+    },
+    "./planning-folder": {
+      "types": "./src/planning-folder.d.mts",
+      "import": "./src/planning-folder.mjs"
+    },
     "./contracts": {
       "types": "./src/contracts.d.mts",
       "import": "./src/contracts.mjs"

package/lib/host-packages/openai/openplanr/runtime/plan/scripts/design.mjs

@@ -1671,6 +1671,9 @@ import {
 import { homedir as homedir2 } from "node:os";
 import { dirname as dirname3, isAbsolute, join as join4, relative, resolve as resolve3 } from "node:path";
 
+// packages/protocol/src/names.mjs
+var PLANNING_FOLDER = ".planr";
+
 // packages/artifact/lib/artifact/internal/feedback.mjs
 var FEEDBACK_FILE = "feedback.json";
 
@@ -1839,7 +1842,7 @@ function inside(base, candidate) {
   return rel === "" || !rel.startsWith("..") && !isAbsolute(rel);
 }
 function parseablePlanrConfig(root) {
-  const path = join4(root, ".planr", "config.json");
+  const path = join4(root, PLANNING_FOLDER, "config.json");
   if (!existsSync2(path)) return false;
   try {
     if (lstatSync3(path).isSymbolicLink()) return false;
@@ -1968,7 +1971,11 @@ function resolveArtifactReviewDestination({
   }
   const projectRoot = findArtifactProjectRoot(cwd, { env });
   if (projectRoot) {
-    const directory2 = assertSafeDestination(projectRoot, [".planr", "artifacts", artifactId]);
+    const directory2 = assertSafeDestination(projectRoot, [
+      PLANNING_FOLDER,
+      "artifacts",
+      artifactId
+    ]);
     return Object.freeze({
       kind: "project",
       artifactId,
@@ -2533,7 +2540,7 @@ function custodyLocation(file, options = {}, { allowMissing = false } = {}) {
   const root = resolve5(options.custodyRoot ?? join7(planrHome(env), "design-shares"));
   let project = current.root;
   for (let candidate = current.root; dirname5(candidate) !== candidate; candidate = dirname5(candidate)) {
-    if (existsSync4(join7(candidate, ".git")) || existsSync4(join7(candidate, ".planr"))) {
+    if (existsSync4(join7(candidate, ".git")) || existsSync4(join7(candidate, PLANNING_FOLDER))) {
       project = candidate;
       break;
     }

package/lib/host-packages/openai/openplanr/runtime/plan/scripts/runtime/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openplanr/protocol",
-  "version": "0.10.1",
+  "version": "0.10.2",
   "type": "module",
   "description": "Canonical OpenPlanr schemas, registries, typed errors, and portable contract validation",
   "license": "MIT",
@@ -27,6 +27,14 @@
       "types": "./src/semver.d.mts",
       "import": "./src/semver.mjs"
     },
+    "./names": {
+      "types": "./src/names.d.mts",
+      "import": "./src/names.mjs"
+    },
+    "./planning-folder": {
+      "types": "./src/planning-folder.d.mts",
+      "import": "./src/planning-folder.mjs"
+    },
     "./contracts": {
       "types": "./src/contracts.d.mts",
       "import": "./src/contracts.mjs"

package/lib/host-packages/openai/openplanr/skills/artifact/SKILL.md

@@ -6,23 +6,23 @@ license: MIT
 
 # OpenPlanr Artifact
 
-Use the deterministic `planr artifact` utility when it is installed. Never
+Use the deterministic `openplanr artifact` utility when it is installed. Never
 relaunch the active coding agent from inside this skill.
 
-1. For local review, run `planr artifact <file>` or
-   `planr artifact open <file>`. Use `--no-open --json` in headless sessions.
+1. For local review, run `openplanr artifact <file>` or
+   `openplanr artifact open <file>`. Use `--no-open --json` in headless sessions.
    Generic artifacts default to the edge-to-edge `document` presentation. Use
    `--presentation canvas` only for an explicitly spatial or zoomable review,
    or `--presentation document` to force the reading surface.
 2. For a diagram manifest or authored bundle, read
-   [diagram-sharing.md](references/diagram-sharing.md). `planr artifact share
+   [diagram-sharing.md](references/diagram-sharing.md). `openplanr artifact share
    <manifest-or-bundle>` creates a native permanent encrypted review with a stable
    URL and a separately entered access token. Use the local **Share diagram**
-   dialog to copy it. Publish only an explicitly requested update with `planr
-   artifact publish <manifest-or-bundle>`; synchronize feedback with `planr
+   dialog to copy it. Publish only an explicitly requested update with `openplanr
+   artifact publish <manifest-or-bundle>`; synchronize feedback with `openplanr
    artifact sync <manifest-or-bundle>`. Verify the actual shared native canvas,
    fonts and source revision before describing the hosted result as verified.
-   Sharing is always explicit. Run `planr artifact share <file>` only after the
+   Sharing is always explicit. Run `openplanr artifact share <file>` only after the
    user asks to share. Before sharing or publishing a design document, read
    [design-sharing.md](references/design-sharing.md) and author or refresh its
    sibling `review-context.json` in this active host session. Ground the welcome
@@ -33,20 +33,20 @@ relaunch the active coding agent from inside this skill.
    token. Owner credentials save privately outside the project; copy the reviewer
    token through the studio's Share dialog, never put it in a URL or ordinary
    command output. Publish an explicitly requested update with
-   `planr artifact publish <design-document.json>`; synchronize reviewer feedback
-   with `planr artifact sync <design-document.json>`. Hosted sharing requires the
+   `openplanr artifact publish <design-document.json>`; synchronize reviewer feedback
+   with `openplanr artifact sync <design-document.json>`. Hosted sharing requires the
    configured compatible service. An unavailable service must be reported, not
    described as a successful share. Generic HTML retains its existing expiring
    live-room and `--snapshot` fragment/short-link behavior; reviewer, owner-verdict,
    and management authority remain separate.
-3. For returned feedback, run `planr artifact import <review-url>`. Do not add
+3. For returned feedback, run `openplanr artifact import <review-url>`. Do not add
    `--allow-stale` by default. Show the stale-review preview and, when the user
    has not already chosen, use the host's native question UI to offer import or
    skip.
 4. Export a completed local session with
-   `planr artifact export <session-id> --format json|markdown`.
+   `openplanr artifact export <session-id> --format json|markdown`.
 5. If the pipeline package is unavailable, report the exact corrective command
-   printed by `planr`; do not bypass the runtime lock or managed state.
+   printed by `openplanr`; do not bypass the runtime lock or managed state.
 
 Local review is loopback-only. Opening, approving, finishing, or importing an
 artifact never publishes it automatically.